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:
parent
a6225ed998
commit
3a299b40f0
@ -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
|
||||||
|
@ -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
|
||||||
|
@ -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>-&n</>, where n is a non-negative decimal number,
|
<filename>-&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>
|
||||||
|
|
||||||
|
277
doc/gpg.texi
277
doc/gpg.texi
@ -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
|
||||||
|
@ -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>
|
||||||
|
@ -18,7 +18,7 @@
|
|||||||
@end menu
|
@end menu
|
||||||
|
|
||||||
@majorheading Name
|
@majorheading Name
|
||||||
gpgv ---- signature verification tool
|
gpgv ---- signature verification tool</>
|
||||||
|
|
||||||
@majorheading Synopsis
|
@majorheading Synopsis
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user