Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
SYMCRYPTRUN(1)		       GNU Privacy Guard		SYMCRYPTRUN(1)

       symcryptrun - Call a simple symmetric encryption	tool

       symcryptrun  --class  class  --program program --keyfile	keyfile	[--de-
       crypt|--encrypt]	[inputfile]

       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 in-
       terface like gpg	is not doable.	symcryptrun provides  a	 solution:  It
       operates	 by calling the	external encryption/decryption module and pro-
       vides a passphrase for a	key using the standard pinentry	 based	mecha-
       nism through gpg-agent.

       Note,  that  symcryptrun	is only	available if GnuPG has been configured
       with '--enable-symcryptrun' at build time.

       For encryption, the plain text must be provided on STDIN	or as the  ar-
       gument inputfile, and the ciphertext will be output to STDOUT.  For de-
       cryption	vice versa.

       CLASS describes the calling conventions of  the	external  tool.	  Cur-
       rently  it  must	be given as 'confucius'.  PROGRAM is the full filename
       of that external	tool.

       For the class 'confucius' the option --keyfile is required; 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.

       Note, that gpg-agent must be running before starting symcryptrun.

       The following additional	options	may be used:


	      Output additional	information while running.


	      Try to be	as quiet as possible.

       --homedir dir
	      Set the name of the home directory to dir. If this option	is not
	      used,  the  home	directory  defaults to `~/.gnupg'.  It is only
	      recognized when given on the command line.   It  also  overrides
	      any  home	 directory  stated  through  the  environment variable
	      `GNUPGHOME' or (on W32 systems) by means of the  Registry	 entry

       --log-file file
	      Append  all logging output to file.  Default is to write logging
	      information to STDERR.

	      The possible exit	status codes of	symcryptrun are:


		      Some error occured.

		      No valid passphrase was provided.

		      The operation was	canceled by the	user.

       gpg(1), gpgsm(1), gpg-agent(1),

       The full	documentation for this tool is maintained as a Texinfo manual.
       If  GnuPG and the info program are properly installed at	your site, the

	 info gnupg

       should give you access to the complete manual including a  menu	struc-
       ture and	an index.

GnuPG 2.0.30			  2017-07-08			SYMCRYPTRUN(1)


Want to link to this manual page? Use this URL:

home | help