diff options
author | Werner Koch <wk@gnupg.org> | 2021-02-09 18:41:43 +0100 |
---|---|---|
committer | Werner Koch <wk@gnupg.org> | 2021-02-09 18:42:25 +0100 |
commit | 209b7113f3493bd829ec5c90275ff95a273d9dd4 (patch) | |
tree | d10fabdb0133451bd989def4ee5c11b3e7143b41 /doc | |
parent | gpg: Fix selection of key. (diff) | |
download | gnupg2-209b7113f3493bd829ec5c90275ff95a273d9dd4.tar.xz gnupg2-209b7113f3493bd829ec5c90275ff95a273d9dd4.zip |
tools: Remove the symcryptrun tool.
* tools/symcryptrun.c: Remove.
* tools/Makefile.am: Ditto.
* doc/tools.texi: Remove man page.
* configure.ac: Remove build option and tests used only by this tool.
* Makefile.am (AM_DISTCHECK_CONFIGURE_FLAGS): Do not build
symcryptrun.
--
symcryptrun is too ancient to be of any use and has not been tested in
many years. Thus we should not distribute it anymore.
Diffstat (limited to 'doc')
-rw-r--r-- | doc/Makefile.am | 2 | ||||
-rw-r--r-- | doc/tools.texi | 123 |
2 files changed, 1 insertions, 124 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am index 1ad86e5b7..cf5563142 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -96,7 +96,7 @@ myman_sources = gnupg7.texi gpg.texi gpgsm.texi gpg-agent.texi \ gpg-card.texi myman_pages = gpgsm.1 gpg-agent.1 dirmngr.8 scdaemon.1 \ watchgnupg.1 gpgconf.1 addgnupghome.8 gpg-preset-passphrase.1 \ - gpg-connect-agent.1 gpgparsemail.1 symcryptrun.1 gpgtar.1 \ + gpg-connect-agent.1 gpgparsemail.1 gpgtar.1 \ applygnupgdefaults.8 gpg-wks-client.1 gpg-wks-server.1 \ dirmngr-client.1 gpg-card.1 gpg-check-pattern.1 if USE_GPG2_HACK diff --git a/doc/tools.texi b/doc/tools.texi index 8eb77401e..c48ba4b4a 100644 --- a/doc/tools.texi +++ b/doc/tools.texi @@ -19,7 +19,6 @@ GnuPG comes with a couple of smaller tools: * gpg-connect-agent:: Communicate with a running agent. * dirmngr-client:: How to use the Dirmngr client tool. * gpgparsemail:: Parse a mail message into an annotated format -* symcryptrun:: Call a simple symmetric encryption tool. * gpgtar:: Encrypt or sign files into an archive. * gpg-check-pattern:: Check a passphrase on stdin against the patternfile. @end menu @@ -1842,128 +1841,6 @@ The @command{gpgparsemail} is a utility currently only useful for debugging. Run it with @code{--help} for usage information. - -@c -@c SYMCRYPTRUN -@c -@node symcryptrun -@section Call a simple symmetric encryption tool -@manpage symcryptrun.1 -@ifset manverb -.B symcryptrun -\- Call a simple symmetric encryption tool -@end ifset - -@mansect synopsis -@ifset manverb -.B symcryptrun -.B \-\-class -.I class -.B \-\-program -.I program -.B \-\-keyfile -.I keyfile -.RB [ --decrypt | --encrypt ] -.RI [ inputfile ] -@end ifset - -@mansect description -Sometimes simple encryption tools are already in use for a long time -and there might be a desire to integrate them into the GnuPG -framework. The protocols and encryption methods might be non-standard -or not even properly documented, so that a full-fledged encryption -tool with an interface like @command{gpg} is not doable. -@command{symcryptrun} provides a solution: It operates by calling the -external encryption/decryption module and provides a passphrase for a -key using the standard @command{pinentry} based mechanism through -@command{gpg-agent}. - -Note, that @command{symcryptrun} is only available if GnuPG has been -configured with @samp{--enable-symcryptrun} at build time. - -@menu -* Invoking symcryptrun:: List of all commands and options. -@end menu - -@manpause -@node Invoking symcryptrun -@subsection List of all commands and options - -@noindent -@command{symcryptrun} is invoked this way: - -@example -symcryptrun --class CLASS --program PROGRAM --keyfile KEYFILE - [--decrypt | --encrypt] [inputfile] -@end example -@mancont - -For encryption, the plain text must be provided on STDIN or as the -argument @var{inputfile}, and the ciphertext will be output to STDOUT. -For decryption vice versa. - -@var{CLASS} describes the calling conventions of the external tool. -Currently it must be given as @samp{confucius}. @var{PROGRAM} is -the full filename of that external tool. - -For the class @samp{confucius} the option @option{--keyfile} is -required; @var{keyfile} is the name of a file containing the secret key, -which may be protected by a passphrase. For detailed calling -conventions, see the source code. - -@noindent -Note, that @command{gpg-agent} must be running before starting -@command{symcryptrun}. - -@noindent -The following additional options may be used: - -@table @gnupgtabopt -@item -v -@itemx --verbose -@opindex verbose -Output additional information while running. - -@item -q -@item --quiet -@opindex q -@opindex quiet -Try to be as quiet as possible. - -@include opt-homedir.texi - - -@item --log-file @var{file} -@opindex log-file -Append all logging output to @var{file}. Use @file{socket://} to log -to socket. Default is to write logging information to STDERR. - -@end table - -@noindent -The possible exit status codes of @command{symcryptrun} are: - -@table @code -@item 0 - Success. -@item 1 - Some error occurred. -@item 2 - No valid passphrase was provided. -@item 3 - The operation was canceled by the user. - -@end table - -@mansect see also -@ifset isman -@command{gpg}(1), -@command{gpgsm}(1), -@command{gpg-agent}(1), -@end ifset -@include see-also-note.texi - - @c @c GPGTAR @c |