1
0
mirror of git://git.gnupg.org/gnupg.git synced 2024-06-17 00:39:50 +02:00

doc: Add warning note about not acting as an oracle to --batch.

--
This commit is contained in:
Werner Koch 2015-02-23 13:10:57 +01:00
parent e0c13ad5f2
commit 6186637cc9
No known key found for this signature in database
GPG Key ID: E3FDFF218E45B72B

View File

@ -949,12 +949,23 @@ Try to be as quiet as possible.
@opindex batch
@opindex no-batch
Use batch mode. Never ask, do not allow interactive commands.
@option{--no-batch} disables this option. Note that even with a
filename given on the command line, gpg might still need to read from
STDIN (in particular if gpg figures that the input is a
detached signature and no data file has been specified). Thus if you
do not want to feed data via STDIN, you should connect STDIN to
@file{/dev/null}.
@option{--no-batch} disables this option. This option is commonly
used for unattended operations.
WARNING: Unattended operation bears a higher risk of being exposed to
security attacks. In particular any unattended use of GnuPG which
involves the use of secret keys should take care not to provide an
decryption oracle. There are several standard pre-cautions against
being used as an oracle. For example never return detailed error
messages or any diagnostics printed by your software to the remote
site. Consult with an expert in case of doubt.
Note that even with a filename given on the command line, gpg might
still need to read from STDIN (in particular if gpg figures that the
input is a detached signature and no data file has been specified).
Thus if you do not want to feed data via STDIN, you should connect
STDIN to @file{/dev/null}.
@item --no-tty
@opindex no-tty