CDIST-TYPE__UNPACK(7) cdist CDIST-TYPE__UNPACK(7)

cdist-type__unpack - Unpack archives

Unpack .tar, .tgz, .tar.*, .7z, .bz2, .gz, .lzma, .xz, .rar and .zip archives. Archive type is detected by extension.

To achieve idempotency, checksum file will be created in target. See --sum-file parameter for details.

Depending on archive format file or directory to where archive contents will be written.

Override archive's checksum file in target. By default XXX.cdist__unpack_sum will be used, where XXX is source archive path. This file must be kept in target's persistent storage.
Tarball specific. See man tar for --strip-components.
Tarball sepcific. Append additional arguments to tar command. See man tar for possible arguments.

By default destination file will be overwritten. In case destination is directory, files from archive will be added to or overwritten in directory. This parameter moves existing destination to XXX.cdist__unpack_backup_YYY, where XXX is destination and YYY current UNIX timestamp.
Don't delete archive after unpacking.
Execute this command after unpack.

__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
# example usecase for --tar-* args
__unpack /root/strelaysrv.tar.gz \
    --preserve-archive \
    --destination /usr/local/bin \
    --tar-strip 1 \
    --tar-extra-args '--wildcards "*/strelaysrv"'


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

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.

ungleich GmbH 2021

September 26, 2023 7.0.0