229
230
@item --change-options @var{component}
230
231
Change the options of the component @var{component}.
233
@item --check-options @var{component}
234
Check the options for the component @var{component}.
232
236
@item --apply-defaults
233
237
Update all configuration files with values taken from the global
234
238
configuration file (usually @file{/etc/gnupg/gpgconf.conf}).
241
Lists the directories used by @command{gpgconf}. One directory is
242
listed per line, and each line consists of a colon-separated list where
243
the first field names the directory type (for example @code{sysconfdir})
244
and the second field contains the percent-escaped directory. Although
245
they are not directories, the socket file names used by
246
@command{gpg-agent} and @command{dirmngr} are printed as well. Note
247
that the socket file names and the @code{homedir} lines are the default
248
names and they may be overridden by command line switches.
236
250
@item --list-config [@var{filename}]
237
251
List the global configuration file in a colon separated format. If
238
252
@var{filename} is given, check that file instead.
259
273
Outputs additional information while running. Specifically, this
260
274
extends numerical field values by human-readable descriptions.
262
@c FIXME: Not yet supported.
265
@c Do not actually change anything. Useful together with
266
@c @code{--change-options} for testing purposes.
278
Do not actually change anything. This is currently only implemented
279
for @code{--change-options} and can be used for testing purposes.
530
543
dirmngr:Directory Manager:/usr/local/bin/dirmngr:0:0:
547
The command @w{@code{--check-options @var{component}}} will verify the
548
configuration file in the same manner as @code{--check-programs}, but
549
only for the component @var{component}.
534
552
@node Listing options
535
553
@subsection Listing options
678
696
@item sec key (36)
679
697
A @emph{string} that describes a certificate with a key by user ID,
680
698
key ID or fingerprint.
700
@item alias list (37)
701
A @emph{string} that describes an alias list, like the one used with
702
gpg's group option. The list consists of a key, an equal sign and space
683
706
More types will be added in the future. Please see the @var{alt-type}
768
791
option). Otherwise, the option will be set to the specified value.
795
The output of the command is the same as that of
796
@code{--check-options} for the modified configuration file.
773
800
To set the force option, which is of basic type @code{none (0)}:
985
1012
@command{gpg-preset-passphrase} is invoked this way:
988
gpg-preset-passphrase [options] [command] @var{keygrip}
1015
gpg-preset-passphrase [options] [command] @var{cacheid}
991
@var{keygrip} is a 40 character string of hexadecimal characters
992
identifying the key for which the passphrase should be set or cleared.
993
This keygrip is listed along with the key when running the command:
994
@code{gpgsm --dump-secret-keys}. One of the following command options
1018
@var{cacheid} is either a 40 character keygrip of hexadecimal
1019
characters identifying the key for which the passphrase should be set
1020
or cleared. The keygrip is listed along with the key when running the
1021
command: @code{gpgsm --dump-secret-keys}. Alternatively an arbitrary
1022
string may be used to identify a passphrase; it is suggested that such
1023
a string is prefixed with the name of the application (e.g
1027
One of the following command options must be given:
997
1029
@table @gnupgtabopt
1161
1194
substituted on the input if the @command{/subst} has been used.
1162
1195
Variables are referenced by prefixing the name with a dollr sign and
1163
1196
optionally include the name in curly braces. The rules for a valid name
1164
are idnetically to those of the standard bourne shell. This is not yet
1197
are identically to those of the standard bourne shell. This is not yet
1165
1198
enforced but may be in the future. When used with curly braces no
1166
1199
leading or trailing white space is allowed.
1255
1288
Run @var{prog} for inquiries matching @var{name} and pass the
1256
1289
entire line to it as command line arguments.
1291
@item /datafile @var{name}
1292
Write all data lines from the server to the file @var{name}. The file
1293
is opened for writing and created if it does not exists. An existsing
1294
file is first truncated to 0. The data written to the file fully
1295
decoded. Using a singel dash for @var{name} writes to stdout. The
1296
file is kept open until a new file is set using this command or this
1297
command is used without an argument.
1259
1300
Print all definitions
1486
1527
@include see-also-note.texi
1533
@c The original manpage on which this section is based was written
1534
@c by Colin Tuckley <colin@tuckley.org> and Daniel Leidert
1535
@c <daniel.leidert@wgdd.de> for the Debian distribution (but may be used by
1539
@section Encrypt or sign files into an archive
1541
.B gpg-zip \- Encrypt or sign files into an archive
1549
.I [ filename2, ... ]
1551
.I [ directory2, ... ]
1554
@mansect description
1555
@command{gpg-zip} encrypts or signs files into an archive. It is an
1556
gpg-ized tar using the same format as used by PGP's PGP Zip.
1560
@command{gpg-zip} is invoked this way:
1563
gpg-zip [options] @var{filename1} [@var{filename2}, ...] @var{directory} [@var{directory2}, ...]
1568
@command{gpg-zip} understands these options:
1575
Encrypt data. This option may be combined with @option{--symmetric} (for output that may be decrypted via a secret key or a passphrase).
1584
Encrypt with a symmetric cipher using a passphrase. The default
1585
symmetric cipher used is CAST5, but may be chosen with the
1586
@option{--cipher-algo} option to @command{gpg}.
1590
Make a signature. See @command{gpg}.
1592
@item --recipient @var{user}
1593
@itemx -r @var{user}
1595
Encrypt for user id @var{user}. See @command{gpg}.
1597
@item --local-user @var{user}
1598
@itemx -u @var{user}
1600
Use @var{user} as the key to sign with. See @command{gpg}.
1602
@item --list-archive
1603
@opindex list-archive
1604
List the contents of the specified archive.
1606
@item --output @var{file}
1607
@itemx -o @var{file}
1609
Write output to specified file @var{file}.
1611
@item --gpg @var{gpgcmd}
1613
Use the specified command @var{gpgcmd} instead of @command{gpg}.
1615
@item --gpg-args @var{args}
1617
Pass the specified options to @command{gpg}.
1619
@item --tar @var{tarcmd}
1621
Use the specified command @var{tarcmd} instead of @command{tar}.
1623
@item --tar-args @var{args}
1625
Pass the specified options to @command{tar}.
1629
Print version of the program and exit.
1633
Display a brief help page and exit.
1637
@mansect diagnostics
1639
The program returns 0 if everything was fine, 1 otherwise.
1649
Encrypt the contents of directory @file{mydocs} for user Bob to file
1653
gpg-zip --encrypt --output test1 --gpg-args -r Bob mydocs
1657
List the contents of archive @file{test1}:
1660
gpg-zip --list-archive test1
1669
@include see-also-note.texi