source

the URL from which to retrieve the source file. e.g.

cksum

the output of running the command: cksum $source-file e.g.:

$ echo foobar > /tmp/foobar
$ cksum /tmp/foobar
857691210 7 /tmp/foobar

If either checksum or file size has changed the file will be (re)fetched from the --source. The file name can be omitted and is ignored if given.

fetch-command

the command used to fetch the staged file using printf formatting. Where a single %s will be replaced with the value of the given --source parameter. The --fetch-command is expected to output the fetched file to stdout. Defaults to 'curl -s -L "%s"'.

group

see cdist-type__file

owner

see cdist-type__file

mode

see cdist-type__file

prepare-command

the optional command used to prepare or preprocess the staged file for later use by the file type. If given, it must be a string in printf formatting where a single %s will be replaced with the last segment (filename) of the value of the given --source parameter. It is executed in the same directory into which the fetched file has been saved. The --prepare-command is expected to output the final file to stdout.

So for example given a --source of https://example.com/my-zip.zip, and a --prepare-command of 'unzip -p "%s"', the code unzip -p "my-zip.zip" will be executed in the folder containing the downloaded file my-zip.zip. A more complex example might be --prepare-command 'tar -xz "%s"; cat path/from/archive'

stage-dir

the directory in which to store downloaded and prepared files. Defaults to '/var/tmp/cdist/__staged_file'

state

see cdist-type__file