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

6.9.4                                             Jan 27, 2022                           CDIST-TYPE__DOWNLOAD(7)