NAME

       cdist-type__download - Download a file

DESCRIPTION

       Destination ($__object_id) in target host must be persistent storage in order to calculate
       checksum and decide if file must be (re-)downloaded.

       By default type will try to use wget, curl or fetch.  If download happens in  target  (see
       --download) then type will fallback to (and install) wget.

       If    download    happens    in   local   machine,   then   environment   variables   like
       {http,https,ftp}_proxy etc can be used on cdist  execution  (http_proxy=foo  cdist  config
       ...).

REQUIRED PARAMETERS

       url    File's URL.

       sum    Checksum  of  file  going  to  be  downloaded.   By default output of cksum without
              filename is expected.  Other hash formats supported with prefixes: md5:, sha1:  and
              sha256:.

OPTIONAL PARAMETERS

       download
              If local (default), then download file to local storage and copy it to target host.
              If remote, then download happens in target.

       cmd-get
              Command used for downloading.  Command must output to stdout.   Parameter  will  be
              used for printf and must include only one format specification %s which will become
              URL.  For example: wget -O - '%s'.

       cmd-sum
              Command used for checksum calculation.  Command output  and  --sum  parameter  must
              match.   Parameter  will  be  used  for  printf  and  must  include only one format
              specification %s which will become destination.  For example:  md5sum  '%s'  |  awk
              '{print $1}'.

       onchange
              Execute this command after download.

EXAMPLES

          __directory /opt/cpma

          require='__directory/opt/cpma' \
              __download /opt/cpma/cnq3.zip \
                  --url https://cdn.playmorepromode.com/files/cnq3/cnq3-1.51.zip \
                  --sum md5:46da3021ca9eace277115ec9106c5b46

          require='__download/opt/cpma/cnq3.zip' \
              __unpack /opt/cpma/cnq3.zip \
                  --backup-destination \
                  --preserve-archive \
                  --destination /opt/cpma/server

AUTHORS

       Ander Punnar <ander-at-kvlt-dot-ee>

COPYING

       Copyright  (C) 2020 Ander Punnar. You can redistribute it and/or modify it under the terms
       of the GNU General Public License as published by the  Free  Software  Foundation,  either
       version 3 of the License, or (at your option) any later version.

COPYRIGHT

       ungleich GmbH 2020