1GPGTAR(1)                    GNU Privacy Guard 2.2                   GPGTAR(1)
2
3
4

NAME

6       gpgtar - Encrypt or sign files into an archive
7

SYNOPSIS

9       gpgtar  [options] filename1 [ filename2, ... ] directory1 [ directory2,
10       ... ]
11
12

DESCRIPTION

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

OPTIONS

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

EXAMPLES

147       Encrypt the contents  of  directory  ‘mydocs’  for  user  Bob  to  file
148test1’:
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

DIAGNOSTICS

160       The program returns 0 if everything was fine, 1 otherwise.
161
162
163

SEE ALSO

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.13                      2019-02-11                         GPGTAR(1)
Impressum