1GPGTAR(1) GNU Privacy Guard 2.2 GPGTAR(1)
2
3
4
6 gpgtar - Encrypt or sign files into an archive
7
9 gpgtar [options] filename1 [ filename2, ... ] directory1 [ directory2,
10 ... ]
11
12
14 gpgtar encrypts or signs files into an archive. It is an gpg-ized tar
15 using the same format as used by PGP's PGP Zip.
16
17
19 gpgtar understands these options:
20
21
22
23 --create
24 Put given files and directories into a vanilla ``ustar'' ar‐
25 chive.
26
27
28 --extract
29 Extract all files from a vanilla ``ustar'' archive.
30
31
32 --encrypt
33 -e Encrypt given files and directories into an archive. This
34 option may be combined with option --symmetric for an archive
35 that may be decrypted via a secret key or a passphrase.
36
37
38 --decrypt
39 -d Extract all files from an encrypted archive.
40
41
42 --sign
43 -s Make a signed archive from the given files and directories.
44 Thsi can be combined with option --encrypt to create a signed
45 and then encrypted archive.
46
47
48 --list-archive
49 -t List the contents of the specified archive.
50
51
52 --symmetric
53 -c Encrypt with a symmetric cipher using a passphrase. The default
54 symmetric cipher used is AES-128, but may be chosen with the
55 --cipher-algo option to gpg.
56
57
58 --recipient user
59 -r user
60 Encrypt for user id user. For details see gpg.
61
62
63 --local-user user
64 -u user
65 Use user as the key to sign with. For details see gpg.
66
67
68 --output file
69 -o file
70 Write the archive to the specified file file.
71
72
73 --verbose
74 -v Enable extra informational output.
75
76
77 --quiet
78 -q Try to be as quiet as possible.
79
80
81 --skip-crypto
82 Skip all crypto operations and create or extract vanilla
83 ``ustar'' archives.
84
85
86 --dry-run
87 Do not actually output the extracted files.
88
89
90 --directory dir
91 -C dir Extract the files into the directory dir. The default is to
92 take the directory name from the input filename. If no input
93 filename is known a directory named ‘GPGARCH’ is used.
94
95
96 --files-from file
97 -T file
98 Take the file names to work from the file file; one file per
99 line.
100
101
102 --null Modify option --files-from to use a binary nul instead of a
103 linefeed to separate file names.
104
105
106 --openpgp
107 This option has no effect becuase OpenPGP encryption and signing
108 is the default.
109
110
111 --cms This option is reserved and shall not be used. It will eventu‐
112 ally be used to encrypt or sign using the CMS protocol; but that
113 is not yet implemented.
114
115
116
117 --set-filename file
118 Use the last component of file as the output directory. The
119 default is to take the directory name from the input filename.
120 If no input filename is known a directory named ‘GPGARCH’ is
121 used. This option is deprecated in favor of option --directory.
122
123
124 --gpg gpgcmd
125 Use the specified command gpgcmd instead of gpg.
126
127
128 --gpg-args args
129 Pass the specified extra options to gpg.
130
131
132 --tar-args args
133 Assume args are standard options of the command tar and parse
134 them. The only supported tar options are "--directory",
135 "--files-from", and "--null" This is an obsolete options because
136 those supported tar options can also be given directly.
137
138
139 --version
140 Print version of the program and exit.
141
142
143 --help Display a brief help page and exit.
144
145
147 Encrypt the contents of directory ‘mydocs’ for user Bob to file
148 ‘test1’:
149
150 gpgtar --encrypt --output test1 -r Bob mydocs
151
152
153 List the contents of archive ‘test1’:
154
155 gpgtar --list-archive test1
156
157
158
160 The program returns 0 if everything was fine, 1 otherwise.
161
162
163
165 gpg(1), tar(1),
166
167 The full documentation for this tool is maintained as a Texinfo manual.
168 If GnuPG and the info program are properly installed at your site, the
169 command
170
171 info gnupg
172
173 should give you access to the complete manual including a menu struc‐
174 ture and an index.
175
176
177
178GnuPG 2.2.9 2018-06-12 GPGTAR(1)