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

FreeBSD Manual Pages

  
 
  

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

NAME
       symcryptrun - Call a simple symmetric encryption	tool

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

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 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:

       -v

       --verbose
	      Output additional	information while running.

       -q

       --quiet
	      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
	      HKCU\Software\GNU\GnuPG:HomeDir.

       --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:

       0
		      Success.

       1
		      Some error occured.

       2
		      No valid passphrase was provided.

       3
		      The operation was	canceled by the	user.

SEE ALSO
       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
       command

	 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)

NAME | SYNOPSIS | DESCRIPTION | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=symcryptrun&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help