1
0
mirror of git://git.gnupg.org/gnupg.git synced 2025-06-14 18:31:03 +02:00

* faq.raw: List years of copyright notice separately.

This commit is contained in:
Werner Koch 2003-05-01 14:25:08 +00:00
parent a6225ed998
commit 3a299b40f0
6 changed files with 145 additions and 150 deletions

View File

@ -1,3 +1,7 @@
2003-05-01 Werner Koch <wk@gnupg.org>
* faq.raw: List years of copyright notice separately.
2003-04-29 David Shaw <dshaw@jabberwocky.com> 2003-04-29 David Shaw <dshaw@jabberwocky.com>
* gpg.sgml: Some general language tweaks. Note default algo for * gpg.sgml: Some general language tweaks. Note default algo for

View File

@ -1295,7 +1295,7 @@ you could search in the mailing list archive.
[H hr] [H hr]
Copyright (C) 2000-2003 Free Software Foundation, Inc., Copyright (C) 2000, 2001, 2002, 2003 Free Software Foundation, Inc.,
59 Temple Place - Suite 330, Boston, MA 02111, USA 59 Temple Place - Suite 330, Boston, MA 02111, USA
Verbatim copying and distribution of this entire article is permitted in Verbatim copying and distribution of this entire article is permitted in

View File

@ -58,11 +58,11 @@
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<synopsis> <synopsis>
<command>gpg</> <command>gpg</command>
<optional>--homedir <parameter/name/</optional> <optional>--homedir <parameter/name/</optional>
<optional>--options <parameter/file/</optional> <optional>--options <parameter/file/</optional>
<optional><parameter/options/</optional> <optional><parameter/options/</optional>
<parameter>command</> <parameter>command</parameter>
<optional><parameter/args/</optional> <optional><parameter/args/</optional>
</synopsis> </synopsis>
</refsynopsisdiv> </refsynopsisdiv>
@ -1724,7 +1724,7 @@ option.
<term>--gpg-agent-info</term> <term>--gpg-agent-info</term>
<listitem><para> <listitem><para>
Override the value of the environment variable Override the value of the environment variable
<literal>GPG_AGENT_INFO</>. This is only used when --use-agent has been given <literal>GPG_AGENT_INFO</literal>. This is only used when --use-agent has been given
</para></listitem></varlistentry> </para></listitem></varlistentry>
@ -2133,7 +2133,7 @@ handy in case where an encrypted message contains a bogus key ID.
<term>--enable-special-filenames</term> <term>--enable-special-filenames</term>
<listitem><para> <listitem><para>
This options enables a mode in which filenames of the form This options enables a mode in which filenames of the form
<filename>-&#38;n</>, where n is a non-negative decimal number, <filename>-&#38;n</filename>, where n is a non-negative decimal number,
refer to the file descriptor n and not to a file with that name. refer to the file descriptor n and not to a file with that name.
</para></listitem></varlistentry> </para></listitem></varlistentry>

View File

@ -18,7 +18,7 @@
@end menu @end menu
@majorheading Name @majorheading Name
gpg ---- encryption and signing tool gpg ---- encryption and signing tool</>
@majorheading Synopsis @majorheading Synopsis
@ -51,8 +51,9 @@ Make a detached signature.
Encrypt data. This option may be combined with ---sign. Encrypt data. This option may be combined with ---sign.
@item -c, ---symmetric @item -c, ---symmetric
Encrypt with symmetric cipher only. Encrypt with a symmetric cipher using a passphrase. The default
This command asks for a passphrase. symmetric cipher used is CAST5, but may be chosen with the
---cipher-algo option.
@item ---store @item ---store
Store only (make a simple RFC1991 packet). Store only (make a simple RFC1991 packet).
@ -176,18 +177,22 @@ trust-db immediately and no save is required.
@item disable @item disable
@itemx enable @itemx enable
Disable or enable an entire key. A disabled key can normally not be used Disable or enable an entire key. A disabled key can not normally be
for encryption. used for encryption.
@item adduid @item adduid
Create an alternate user id. Create an alternate user id.
@item addphoto @item addphoto
Create a photographic user id. Create a photographic user id. This will prompt for a JPEG file that
will be embedded into the user ID.
@item deluid @item deluid
Delete a user id. Delete a user id.
@item revuid
Revoke a user id.
@item addkey @item addkey
Add a subkey to this key. Add a subkey to this key.
@ -337,7 +342,7 @@ a subkey or a signature, use the ---edit command.
@item ---desig-revoke @item ---desig-revoke
Generate a designated revocation certificate for a key. This allows a Generate a designated revocation certificate for a key. This allows a
user (with the permission of the keyholder) to revoke someone elses user (with the permission of the keyholder) to revoke someone else's
key. key.
@item ---export @code{names} @item ---export @code{names}
@ -395,29 +400,30 @@ will be joined together to create the search string for the keyserver.
Option ---keyserver must be used to give the name of this keyserver. Option ---keyserver must be used to give the name of this keyserver.
@item ---update-trustdb @item ---update-trustdb
Do trust DB maintenance. This command goes over all keys and builds Do trust database maintenance. This command iterates over all keys
the Web-of-Trust. This is an interactive command because it may has to and builds the Web-of-Trust. This is an interactive command because it
ask for the "ownertrust" values of keys. The user has to give an may have to ask for the "ownertrust" values for keys. The user has to
estimation in how far she trusts the owner of the displayed key to give an estimation of how far she trusts the owner of the displayed
correctly certify (sign) other keys. It does only ask for that value key to correctly certify (sign) other keys. GnuPG only asks for the
if it has not yet been assigned to a key. Using the edit menu, that ownertrust value if it has not yet been assigned to a key. Using the
value can be changed at any time later. ---edit-key menu, the assigned value can be changed at any time.
@item ---check-trustdb @item ---check-trustdb
Do trust DB maintenance without user interaction. Form time to time Do trust database maintenance without user interaction. From time to
the trust database must be updated so that expired keys and resulting time the trust database must be updated so that expired keys or
changes in the Web-of-Trust can be tracked. GnuPG tries to figure signatures and the resulting changes in the Web-of-Trust can be
when this is required and then does it implicitly; this command can be tracked. Normally, GnuPG will calculate when this is required and do
used to force such a check. The processing is identically to that of it automatically unless ---no-auto-check-trustdb is set. This command
---update-trustdb but it skips keys with a not yet defined "ownertrust". can be used to force a trust database check at any time. The
processing is identical to that of ---update-trustdb but it skips keys
with a not yet defined "ownertrust".
For use with cron jobs, this command can be used together with ---batch For use with cron jobs, this command can be used together with ---batch
in which case the check is only done when it is due. To force a run in which case the trust database check is done only if a check is
even in batch mode add the option ---yes. needed. To force a run even in batch mode add the option ---yes.
@item ---export-ownertrust @code{file} @item ---export-ownertrust
Store the ownertrust values into Send the ownertrust values to stdout. This is useful for backup
@code{file} (or stdin if not given). This is useful for backup
purposes as these values are the only ones which can't be re-created purposes as these values are the only ones which can't be re-created
from a corrupted trust DB. from a corrupted trust DB.
@ -454,8 +460,8 @@ of supported algorithms.
Print warranty information. Print warranty information.
@item -h, ---help @item -h, ---help
Print usage information. This is a really long list even though it doesn't list Print usage information. This is a really long list even though it
all options. doesn't list all options. For every option, consult this manual.
@end table @end table
@ -466,7 +472,8 @@ Long options can be put in an options file (default
not write the 2 dashes, but simply the name of the option and any not write the 2 dashes, but simply the name of the option and any
required arguments. Lines with a hash ('#') as the first required arguments. Lines with a hash ('#') as the first
non-white-space character are ignored. Commands may be put in this non-white-space character are ignored. Commands may be put in this
file too, but that does not make sense. file too, but that is not generally useful as the command will execute
automatically with every execution of gpg.
@code{gpg} recognizes these options: @code{gpg} recognizes these options:
@ -477,14 +484,14 @@ Create ASCII armored output.
@item -o, ---output @code{file} @item -o, ---output @code{file}
Write output to @code{file}. Write output to @code{file}.
@item ---no-mangle-dos-filenames @item ---mangle-dos-filenames
@itemx ---mangle-dos-filenames @itemx ---no-mangle-dos-filenames
The Windows version of GPG replaces the extension of an output The Windows version of GnuPG replaces the extension of an output
filename to avoid problems with filenames containing more than one filename to avoid problems with filenames containing more than one
dot. This is not necessary for newer Windows version and such dot. This is not necessary for newer Windows versions and so
---no-mangle-dos-filenames can be used to switch this feature off and ---no-mangle-dos-filenames can be used to switch this feature off and
have GPG append the new extension. This otion has no effect on have GnuPG append the new extension. This option has no effect on
non-windows platforms. non-Windows platforms.
@item -u, ---local-user @code{name} @item -u, ---local-user @code{name}
Use @code{name} as the user ID to sign. Use @code{name} as the user ID to sign.
@ -538,12 +545,12 @@ disables compression. Default is to use the default
compression level of zlib (normally 6). compression level of zlib (normally 6).
@item -t, ---textmode @item -t, ---textmode
Use canonical text mode. If -t (but not @itemx ---no-textmode
---textmode) is used together with armoring Use canonical text mode. ---no-textmode disables this option. If -t
and signing, this enables clearsigned messages. (but not ---textmode) is used together with armoring and signing, this
This kludge is needed for PGP compatibility; enables clearsigned messages. This kludge is needed for command-line
normally you would use ---sign or --clearsign compatibility with command-line versions of PGP; normally you would
to selected the type of the signature. use ---sign or --clearsign to select the type of the signature.
@item -n, ---dry-run @item -n, ---dry-run
Don't make any changes (this is not completely implemented). Don't make any changes (this is not completely implemented).
@ -552,18 +559,15 @@ Don't make any changes (this is not completely implemented).
Prompt before overwriting any files. Prompt before overwriting any files.
@item ---batch @item ---batch
Use batch mode. Never ask, do not allow interactive @itemx ---no-batch
commands. Use batch mode. Never ask, do not allow interactive commands.
---no-batch disables this option.
@item ---no-tty @item ---no-tty
Make sure that the TTY (terminal) is never used for any output. Make sure that the TTY (terminal) is never used for any output.
This option is needed in some cases because GnuPG sometimes prints This option is needed in some cases because GnuPG sometimes prints
warnings to the TTY if ---batch is used. warnings to the TTY if ---batch is used.
@item ---no-batch
Disable batch mode. This may be of use if ---batch
is enabled from an options file.
@item ---yes @item ---yes
Assume "yes" on most questions. Assume "yes" on most questions.
@ -707,10 +711,11 @@ Allow importing key signatures marked as "local". This is not
generally useful unless a shared keyring scheme is being used. generally useful unless a shared keyring scheme is being used.
Defaults to no. Defaults to no.
@item repair-hkp-subkey-bug @item repair-pks-subkey-bug
During import, attempt to repair the HKP keyserver mangling multiple During import, attempt to repair the damage caused by the PKS
subkeys bug. Note that this cannot completely repair the damaged key keyserver bug (pre version 0.9.6) that mangles keys with multiple
as some crucial data is removed by the keyserver, but it does at least subkeys. Note that this cannot completely repair the damaged key as
some crucial data is removed by the keyserver, but it does at least
give you back one subkey. Defaults to no for regular ---import and to give you back one subkey. Defaults to no for regular ---import and to
yes for keyserver ---recv-keys. yes for keyserver ---recv-keys.
@ -742,13 +747,11 @@ Include designated revoker information that was marked as
@end table @end table
@item ---show-photos @item ---show-photos
@itemx ---no-show-photos
Causes ---list-keys, --list-sigs, --list-public-keys, Causes ---list-keys, --list-sigs, --list-public-keys,
---list-secret-keys, and verifying a signature to also display the ---list-secret-keys, and verifying a signature to also display the
photo ID attached to the key, if any. photo ID attached to the key, if any. See also ---photo-viewer.
See also ---photo-viewer. ---no-show-photos disables this option.
@item ---no-show-photos
Resets the ---show-photos flag.
@item ---photo-viewer @code{string} @item ---photo-viewer @code{string}
This is the command line that should be run to view a photo ID. "%i" This is the command line that should be run to view a photo ID. "%i"
@ -855,6 +858,11 @@ be given in C syntax (e.g. 0x0042).
@item ---debug-all @item ---debug-all
Set all useful debugging flags. Set all useful debugging flags.
@item ---enable-progress-filter
Enable certain PROGRESS status outputs. This option allows frontends
to display a progress indicator while gpg is processing larger files.
There is a slight performance overhead using it.
@item ---status-fd @code{n} @item ---status-fd @code{n}
Write special status strings to the file descriptor @code{n}. Write special status strings to the file descriptor @code{n}.
See the file DETAILS in the documentation for a listing of them. See the file DETAILS in the documentation for a listing of them.
@ -869,13 +877,12 @@ needed to separate out the various subpackets from the stream
delivered to the file descriptor. delivered to the file descriptor.
@item ---sk-comments @item ---sk-comments
@itemx ---no-sk-comments
Include secret key comment packets when exporting secret keys. This Include secret key comment packets when exporting secret keys. This
is a GnuPG extension to the OpenPGP standard, and is off by default. is a GnuPG extension to the OpenPGP standard, and is off by default.
Please note that this has nothing to do with the comments in clear Please note that this has nothing to do with the comments in clear
text signatures or armor headers. text signatures or armor headers. ---no-sk-comments disables this
option.
@item ---no-sk-comments
Resets the ---sk-comments option.
@item ---no-comment @item ---no-comment
See ---sk-comments. This option is deprecated and may be removed soon. See ---sk-comments. This option is deprecated and may be removed soon.
@ -890,13 +897,10 @@ text signatures. Use this to overwrite a ---comment
from a config file. This option is now obsolete because there is no from a config file. This option is now obsolete because there is no
default comment string anymore. default comment string anymore.
@item ---no-version
Omit the version string in clear text signatures.
@item ---emit-version @item ---emit-version
Force to write the version string in clear text @itemx ---no-emit-version
signatures. Use this to overwrite a previous Force inclusion of the version string in ASCII armored output.
---no-version from a config file. ---no-emit-version disables this option.
@item ---sig-notation @code{name=value} @item ---sig-notation @code{name=value}
@itemx ---cert-notation @code{name=value} @itemx ---cert-notation @code{name=value}
@ -922,11 +926,10 @@ results in a single "%". %k, %K, and %f are only meaningful when
making a key signature (certification). making a key signature (certification).
@item ---show-notation @item ---show-notation
@itemx ---no-show-notation
Show signature notations in the ---list-sigs or --check-sigs listings Show signature notations in the ---list-sigs or --check-sigs listings
as well as when verifying a signature with a notation in it. as well as when verifying a signature with a notation in it.
---no-show-notation disables this option.
@item ---no-show-notation
Do not show signature notations.
@item ---sig-policy-url @code{string} @item ---sig-policy-url @code{string}
@itemx ---cert-policy-url @code{string} @itemx ---cert-policy-url @code{string}
@ -940,24 +943,22 @@ signatures. ---cert-policy-url sets a policy url for key signatures
The same %-expandos used for notation data are available here as well. The same %-expandos used for notation data are available here as well.
@item ---show-policy-url @item ---show-policy-url
@itemx ---no-show-policy-url
Show policy URLs in the ---list-sigs or --check-sigs listings as well Show policy URLs in the ---list-sigs or --check-sigs listings as well
as when verifying a signature with a policy URL in it. as when verifying a signature with a policy URL in it.
---no-show-policy-url disables this option.
@item ---no-show-policy-url
Do not show policy URLs.
@item ---set-filename @code{string} @item ---set-filename @code{string}
Use @code{string} as the name of file which is stored in Use @code{string} as the name of file which is stored in
messages. messages.
@item ---for-your-eyes-only @item ---for-your-eyes-only
@itemx ---no-for-your-eyes-only
Set the `for your eyes only' flag in the message. This causes GnuPG Set the `for your eyes only' flag in the message. This causes GnuPG
to refuse to save the file unless the ---output option is given, and to refuse to save the file unless the ---output option is given, and
PGP to use the "secure viewer" with a Tempest-resistant font to PGP to use the "secure viewer" with a Tempest-resistant font to
display the message. This option overrides ---set-filename. display the message. This option overrides ---set-filename.
---no-for-your-eyes-only disables this option.
@item ---no-for-your-eyes-only
Resets the ---for-your-eyes-only flag.
@item ---use-embedded-filename @item ---use-embedded-filename
Try to create a file with a name as embedded in the data. Try to create a file with a name as embedded in the data.
@ -1057,12 +1058,11 @@ However, due to the fact that the signature creation needs manual
interaction, this performance penalty does not matter in most settings. interaction, this performance penalty does not matter in most settings.
@item ---auto-check-trustdb @item ---auto-check-trustdb
@itemx ---no-auto-check-trustdb
If GnuPG feels that its information about the Web-of-Trust has to be If GnuPG feels that its information about the Web-of-Trust has to be
updated, it automatically runs the ---check-trustdb command updated, it automatically runs the ---check-trustdb command internally.
internally. This may be a time consuming process. This may be a time consuming process. ---no-auto-check-trustdb
disables this option.
@item ---no-auto-check-trustdb
Resets the ---auto-check-trustdb option.
@item ---throw-keyid @item ---throw-keyid
Do not put the keyid into encrypted packets. This option Do not put the keyid into encrypted packets. This option
@ -1080,11 +1080,12 @@ line, patch files don't have this. A special armor header
line tells GnuPG about this cleartext signature option. line tells GnuPG about this cleartext signature option.
@item ---escape-from-lines @item ---escape-from-lines
Because some mailers change lines starting with "From " @itemx ---no-escape-from-lines
to "<From " it is good to handle such lines in a special Because some mailers change lines starting with "From " to ">From
way when creating cleartext signatures. All other PGP " it is good to handle such lines in a special way when creating
versions do it this way too. This option is not enabled cleartext signatures to prevent the mail system from breaking the
by default because it would violate rfc2440. signature. Note that all other PGP versions do it this way too.
Enabled by default. ---no-escape-from-lines disables this option.
@item ---passphrase-fd @code{n} @item ---passphrase-fd @code{n}
Read the passphrase from file descriptor @code{n}. If you use Read the passphrase from file descriptor @code{n}. If you use
@ -1100,9 +1101,11 @@ together with ---status-fd. See the file doc/DETAILS in the source
distribution for details on how to use it. distribution for details on how to use it.
@item ---use-agent @item ---use-agent
@itemx ---no-use-agent
Try to use the GnuPG-Agent. Please note that this agent is still under Try to use the GnuPG-Agent. Please note that this agent is still under
development. With this option, GnuPG first tries to connect to the development. With this option, GnuPG first tries to connect to the
agent before it asks for a passphrase. agent before it asks for a passphrase. ---no-use-agent disables this
option.
@item ---gpg-agent-info @item ---gpg-agent-info
Override the value of the environment variable Override the value of the environment variable
@ -1112,6 +1115,7 @@ Override the value of the environment variable
Try to be more RFC1991 (PGP 2.x) compliant. Try to be more RFC1991 (PGP 2.x) compliant.
@item ---pgp2 @item ---pgp2
@itemx ---no-pgp2
Set up all options to be as PGP 2.x compliant as possible, and warn if Set up all options to be as PGP 2.x compliant as possible, and warn if
an action is taken (e.g. encrypting to a non-RSA key) that will create an action is taken (e.g. encrypting to a non-RSA key) that will create
a message that PGP 2.x will not be able to handle. Note that `PGP a message that PGP 2.x will not be able to handle. Note that `PGP
@ -1122,12 +1126,10 @@ This option implies `---rfc1991 --no-openpgp --disable-mdc
---no-force-v4-certs --no-comment --escape-from-lines --force-v3-sigs ---no-force-v4-certs --no-comment --escape-from-lines --force-v3-sigs
---no-ask-sig-expire --no-ask-cert-expire --cipher-algo IDEA ---no-ask-sig-expire --no-ask-cert-expire --cipher-algo IDEA
---digest-algo MD5 --compress-algo 1'. It also disables --textmode ---digest-algo MD5 --compress-algo 1'. It also disables --textmode
when encrypting. when encrypting. ---no-pgp2 disables this option.
@item ---no-pgp2
Resets the ---pgp2 option.
@item ---pgp6 @item ---pgp6
@itemx ---no-pgp6
Set up all options to be as PGP 6 compliant as possible. This Set up all options to be as PGP 6 compliant as possible. This
restricts you to the ciphers IDEA (if the IDEA plugin is installed), restricts you to the ciphers IDEA (if the IDEA plugin is installed),
3DES, and CAST5, the hashes MD5, SHA1 and RIPEMD160, and the 3DES, and CAST5, the hashes MD5, SHA1 and RIPEMD160, and the
@ -1136,58 +1138,52 @@ compression algorithms none and ZIP. This also disables
does not understand signatures made by signing subkeys. does not understand signatures made by signing subkeys.
This option implies `---disable-mdc --no-comment --escape-from-lines This option implies `---disable-mdc --no-comment --escape-from-lines
---force-v3-sigs --no-ask-sig-expire --compress-algo 1' ---force-v3-sigs --no-ask-sig-expire --compress-algo 1' --no-pgp6
disables this option.
@item ---no-pgp6
Resets the ---pgp6 option.
@item ---pgp7 @item ---pgp7
@itemx ---no-pgp7
Set up all options to be as PGP 7 compliant as possible. This is Set up all options to be as PGP 7 compliant as possible. This is
identical to ---pgp6 except that MDCs are not disabled, and the list of identical to ---pgp6 except that MDCs are not disabled, and the list of
allowable ciphers is expanded to add AES128, AES192, AES256, and allowable ciphers is expanded to add AES128, AES192, AES256, and
TWOFISH. TWOFISH. ---no-pgp7 disables this option.
@item ---no-pgp7
Resets the ---pgp7 option.
@item ---pgp8 @item ---pgp8
@itemx ---no-pgp8
Set up all options to be as PGP 8 compliant as possible. PGP 8 is a Set up all options to be as PGP 8 compliant as possible. PGP 8 is a
lot closer to the OpenPGP standard than previous versions of PGP, so lot closer to the OpenPGP standard than previous versions of PGP, so
all this does is disable ---throw-keyid and set --escape-from-lines and all this does is disable ---throw-keyid and set --escape-from-lines and
---compress-algo 1. The allowed algorithms list is the same as --pgp7. ---compress-algo 1. The allowed algorithms list is the same as --pgp7
with the addition of the SHA-256 digest algorithm. ---no-pgp8 disables
@item ---no-pgp8 this option.
Resets the ---pgp8 option.
@item ---openpgp @item ---openpgp
Reset all packet, cipher and digest options to OpenPGP behavior. Use Reset all packet, cipher and digest options to OpenPGP behavior. Use
this option to reset all previous options like ---rfc1991, this option to reset all previous options like ---rfc1991,
---force-v3-sigs, --s2k-*, --cipher-algo, --digest-algo and ---force-v3-sigs, --s2k-*, --cipher-algo, --digest-algo and
---compress-algo to OpenPGP compliant values. All PGP workarounds are ---compress-algo to OpenPGP compliant values. All PGP workarounds and
also disabled. ---pgpX modes are also disabled.
@item ---force-v3-sigs @item ---force-v3-sigs
@itemx ---no-force-v3-sigs
OpenPGP states that an implementation should generate v4 signatures OpenPGP states that an implementation should generate v4 signatures
but PGP versions 5 and higher only recognize v4 signatures on key but PGP versions 5 and higher only recognize v4 signatures on key
material. This option forces v3 signatures for signatures on data. material. This option forces v3 signatures for signatures on data.
Note that this option overrides ---ask-sig-expire, as v3 signatures Note that this option overrides ---ask-sig-expire, as v3 signatures
cannot have expiration dates. cannot have expiration dates. ---no-force-v3-sigs disables this
option.
@item ---no-force-v3-sigs
Reset the ---force-v3-sigs option.
@item ---force-v4-certs @item ---force-v4-certs
@itemx ---no-force-v4-certs
Always use v4 key signatures even on v3 keys. This option also Always use v4 key signatures even on v3 keys. This option also
changes the default hash algorithm for v3 RSA keys from MD5 to SHA-1. changes the default hash algorithm for v3 RSA keys from MD5 to SHA-1.
---no-force-v4-certs disables this option.
@item ---no-force-v4-certs
Reset the ---force-v4-certs option.
@item ---force-mdc @item ---force-mdc
Force the use of encryption with a modification detection code. This Force the use of encryption with a modification detection code. This
is always used with the newer ciphers (those with a blocksize greater is always used with the newer ciphers (those with a blocksize greater
than 64 bits), or if the recipient key has one of those ciphers as a than 64 bits), or if all of the recipient keys indicate MDC support in
preference. their feature flags.
@item ---disable-mdc @item ---disable-mdc
Disable the use of the modification detection code. Note that by Disable the use of the modification detection code. Note that by
@ -1195,12 +1191,10 @@ using this option, the encrypted message becomes vulnerable to a
message modification attack. message modification attack.
@item ---allow-non-selfsigned-uid @item ---allow-non-selfsigned-uid
@itemx ---no-allow-non-selfsigned-uid
Allow the import and use of keys with user IDs which are not Allow the import and use of keys with user IDs which are not
self-signed. This is not recommended, as a non self-signed user ID is self-signed. This is not recommended, as a non self-signed user ID is
trivial to forge. trivial to forge. ---no-allow-non-selfsigned-uid disables.
@item ---no-allow-non-selfsigned-uid
Reset the ---allow-non-selfsigned-uid option.
@item ---allow-freeform-uid @item ---allow-freeform-uid
Disable all checks on the form of the user ID while generating a new Disable all checks on the form of the user ID while generating a new
@ -1260,15 +1254,14 @@ slower random generation.
Reset verbose level to 0. Reset verbose level to 0.
@item ---no-greeting @item ---no-greeting
Suppress the initial copyright message but do not Suppress the initial copyright message.
enter batch mode.
@item ---no-secmem-warning @item ---no-secmem-warning
Suppress the warning about "using insecure memory". Suppress the warning about "using insecure memory".
@item ---no-permission-warning @item ---no-permission-warning
Suppress the warning about unsafe file permissions. Note that the Suppress the warning about unsafe file permissions. Note that the
file permission checks that GnuPG does are not intended to be file permission checks that GnuPG performs are not intended to be
authoritative, rather they simply warn about certain common permission authoritative, rather they simply warn about certain common permission
problems. Do not assume that the lack of a warning means that your problems. Do not assume that the lack of a warning means that your
system is secure. system is secure.
@ -1307,8 +1300,8 @@ can get a faster listing. The exact behaviour of this option may change
in future versions. in future versions.
@item ---fixed-list-mode @item ---fixed-list-mode
Do not merge user ID and primary key in ---with-colon listing mode and Do not merge primary user ID and primary key in ---with-colon listing
print all timestamps as seconds since 1970-01-01. mode and print all timestamps as seconds since 1970-01-01.
@item ---list-only @item ---list-only
Changes the behaviour of some commands. This is like ---dry-run but Changes the behaviour of some commands. This is like ---dry-run but
@ -1345,30 +1338,26 @@ content of an encrypted message; using this option you can do this without
handing out the secret key. handing out the secret key.
@item ---ask-sig-expire @item ---ask-sig-expire
@itemx ---no-ask-sig-expire
When making a data signature, prompt for an expiration time. If this When making a data signature, prompt for an expiration time. If this
option is not specified, the expiration time is "never". option is not specified, the expiration time is "never".
---no-ask-sig-expire disables this option.
@item ---no-ask-sig-expire
Resets the ---ask-sig-expire option.
@item ---ask-cert-expire @item ---ask-cert-expire
@itemx ---no-ask-cert-expire
When making a key signature, prompt for an expiration time. If this When making a key signature, prompt for an expiration time. If this
option is not specified, the expiration time is "never". option is not specified, the expiration time is "never".
---no-ask-cert-expire disables this option.
@item ---no-ask-cert-expire
Resets the ---ask-cert-expire option.
@item ---expert @item ---expert
@itemx ---no-expert
Allow the user to do certain nonsensical or "silly" things like Allow the user to do certain nonsensical or "silly" things like
signing an expired or revoked key, or certain potentially incompatible signing an expired or revoked key, or certain potentially incompatible
things like generating deprecated key types. This also disables things like generating deprecated key types. This also disables
certain warning messages about potentially incompatible actions. As certain warning messages about potentially incompatible actions. As
the name implies, this option is for experts only. If you don't fully the name implies, this option is for experts only. If you don't fully
understand the implications of what it allows you to do, leave this understand the implications of what it allows you to do, leave this
off. off. ---no-expert disables this option.
@item ---no-expert
Resets the ---expert option.
@item ---merge-only @item ---merge-only
Don't insert new keys into the keyrings while doing an import. Don't insert new keys into the keyrings while doing an import.
@ -1392,7 +1381,7 @@ Experimental use only.
@item ---group @code{name=value1 value2 value3 ...} @item ---group @code{name=value1 value2 value3 ...}
Sets up a named group, which is similar to aliases in email programs. Sets up a named group, which is similar to aliases in email programs.
Any time the group name is a receipient (-r or ---recipient), it will Any time the group name is a recipient (-r or ---recipient), it will
be expanded to the values specified. be expanded to the values specified.
The values are @code{key IDs} or fingerprints, but any key description The values are @code{key IDs} or fingerprints, but any key description
@ -1435,8 +1424,8 @@ menu.
@end table @end table
@majorheading How to specify a user ID @majorheading How to specify a user ID
There are different ways on how to specify a user ID to GnuPG; There are different ways to specify a user ID to GnuPG; here are some
here are some examples: examples:
@table @asis @table @asis
@item @item
@ -1607,15 +1596,17 @@ cannot be read by the intended recipient.
For example, as of this writing, no version of official PGP supports For example, as of this writing, no version of official PGP supports
the BLOWFISH cipher algorithm. If you use it, no PGP user will be the BLOWFISH cipher algorithm. If you use it, no PGP user will be
able to decrypt your message. The same thing applies to the ZLIB able to decrypt your message. The same thing applies to the ZLIB
compression algorithm. By default, GnuPG will do the right thing and compression algorithm. By default, GnuPG uses the OpenPGP preferences
create messages that are usable by any OpenPGP program. Only override system that will always do the right thing and create messages that
this safe default if you know what you are doing. are usable by all recipients, regardless of which OpenPGP program they
use. Only override this safe default if you know what you are doing.
If you absolutely must override the safe default, you are far better If you absolutely must override the safe default, or if the
off using the ---pgp2, --pgp6, or --pgp7 options. These options are preferences on a given key are invalid for some reason, you are far
safe as they do not force any particular algorithms in violation of better off using the ---pgp2, --pgp6, --pgp7, or --pgp8 options. These
OpenPGP, but rather reduce the available algorithms to a "PGP-safe" options are safe as they do not force any particular algorithms in
list. violation of OpenPGP, but rather reduce the available algorithms to a
"PGP-safe" list.
@majorheading BUGS @majorheading BUGS
On many systems this program should be installed as setuid(root). This On many systems this program should be installed as setuid(root). This

View File

@ -57,7 +57,7 @@
</refnamediv> </refnamediv>
<refsynopsisdiv> <refsynopsisdiv>
<synopsis> <synopsis>
<command>gpgv</> <command>gpgv</command>
<optional><parameter/options/</optional> <optional><parameter/options/</optional>
<optional><parameter/signed files/</optional> <optional><parameter/signed files/</optional>
</synopsis> </synopsis>

View File

@ -18,7 +18,7 @@
@end menu @end menu
@majorheading Name @majorheading Name
gpgv ---- signature verification tool gpgv ---- signature verification tool</>
@majorheading Synopsis @majorheading Synopsis