1CDIST-TYPE__UNPACK(7)                cdist               CDIST-TYPE__UNPACK(7)
2
3
4

NAME

6       cdist-type__unpack - Unpack archives
7

DESCRIPTION

9       Unpack  .tar,  .tgz,  .tar.*, .7z, .bz2, .gz, .lzma, .xz, .rar and .zip
10       archives. Archive type is detected by extension.
11
12       To achieve idempotency, checksum file will be created  in  target.  See
13       --sum-file parameter for details.
14

REQUIRED PARAMETERS

16       destination
17              Depending  on  archive format file or directory to where archive
18              contents will be written.
19

OPTIONAL PARAMETERS

21       sum-file
22              Override  archive's  checksum  file  in   target.   By   default
23              XXX.cdist__unpack_sum  will be used, where XXX is source archive
24              path. This file must be kept in target's persistent storage.
25
26       tar-strip
27              Tarball specific. See man tar for --strip-components.
28
29       tar-extra-args
30              Tarball sepcific. Append additional arguments  to  tar  command.
31              See man tar for possible arguments.
32

OPTIONAL BOOLEAN PARAMETERS

34       backup-destination
35              By  default destination file will be overwritten. In case desti‐
36              nation is directory, files from archive  will  be  added  to  or
37              overwritten in directory. This parameter moves existing destina‐
38              tion to XXX.cdist__unpack_backup_YYY, where XXX  is  destination
39              and YYY current UNIX timestamp.
40
41       preserve-archive
42              Don't delete archive after unpacking.
43
44       onchange
45              Execute this command after unpack.
46

EXAMPLES

48          __directory /opt/cpma
49
50          require='__directory/opt/cpma' \
51              __download /opt/cpma/cnq3.zip \
52                  --url https://cdn.playmorepromode.com/files/cnq3/cnq3-1.51.zip \
53                  --sum md5:46da3021ca9eace277115ec9106c5b46
54
55          require='__download/opt/cpma/cnq3.zip' \
56              __unpack /opt/cpma/cnq3.zip \
57                  --backup-destination \
58                  --preserve-archive \
59                  --destination /opt/cpma/server
60
61          # example usecase for --tar-* args
62          __unpack /root/strelaysrv.tar.gz \
63              --preserve-archive \
64              --destination /usr/local/bin \
65              --tar-strip 1 \
66              --tar-extra-args '--wildcards "*/strelaysrv"'
67

AUTHORS

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

COPYING

72       Copyright  (C) 2020 Ander Punnar. You can redistribute it and/or modify
73       it under the terms of the GNU General Public License  as  published  by
74       the  Free  Software Foundation, either version 3 of the License, or (at
75       your option) any later version.
76
78       ungleich GmbH 2020
79
80
81
82
836.9.6                            Apr 20, 2021            CDIST-TYPE__UNPACK(7)
Impressum