gnutls-cli(1)						      General Commands Manual						     gnutls-cli(1)

NAME

       gnutls-cli - GnuTLS test client

SYNOPSIS

       gnutls-cli [options] hostname

DESCRIPTION

       Simple  client  program to set up a TLS connection to some other computer.  It sets up a TLS connection and forwards data from the standard
       input to the secured socket and vice versa.

OPTIONS

   Program control options
       -d, --debug LEVEL
	      Specify the debug level. Default is 1.

       -h, --help
	      Prints a short reminder of the command line options.

       -l, --list
	      Print a list of the supported algorithms and modes.

       -r, --resume
	      Connect, establish a session.  Connect again and resume this session.

       -s, --starttls
	      Connect, establish a plain session and start TLS when EOF or a SIGALRM is received.

       -v, --version
	      Prints the program's version number.

       -V, --verbose
	      More verbose output.

   TLS/SSL control options
       --priority PRIORITY STRING
	      TLS algorithms and protocols to enable.  You can use predefined sets of ciphersuites such as:

	      PERFORMANCE all the "secure" ciphersuites are enabled, limited to 128 bit ciphers and sorted by terms of speed performance.

	      NORMAL option enables all "secure" ciphersuites. The 256-bit ciphers are included as a fallback only.  The  ciphers  are	sorted	by
	      security margin.

	      SECURE128 flag enables all "secure" ciphersuites with ciphers up to 128 bits, sorted by security margin.

	      SECURE256 flag enables all "secure" ciphersuites including the 256 bit ciphers, sorted by security margin.

	      EXPORT all the ciphersuites are enabled, including the low-security 40 bit ciphers.

	      NONE nothing is enabled. This disables even protocols and compression methods.

	      Check the GnuTLS manual on section "Priority strings" for more information on allowed keywords.

	      Examples:

	      "NORMAL"

	      "NONE:+VERS-TLS-ALL:+MAC-ALL:+RSA:+AES-128-CBC:+SIGN-ALL:+COMP-NULL"

	      "NORMAL:-ARCFOUR-128" means normal ciphers except for ARCFOUR-128.

	      "SECURE:-VERS-SSL3.0:+COMP-DEFLATE" means that only secure ciphers are enabled, SSL3.0 is disabled, and libz compression enabled.

	       "NONE:+VERS-TLS-ALL:+AES-128-CBC:+RSA:+SHA1:+COMP-NULL:+SIGN-RSA-SHA1"

	      "NORMAL:%COMPAT" is the most compatible mode

       --crlf Send CR LF instead of LF.

       -f, --fingerprint
	      Send the openpgp fingerprint, instead of the key.

       -p, --port integer
	      The port to connect to.

       --ciphers cipher1 cipher2...
	      Ciphers to enable (use gnutls-cli --list to show the supported ciphers).

       --protocols protocol1 protocol2...
	      Protocols to enable (use gnutls-cli --list to show the supported protocols).

       --comp comp1 comp2...
	      Compression methods to enable (use gnutls-cli --list to show the supported methods).

       --macs mac1 mac2...
	      MACs to enable (use gnutls-cli --list to show the supported MACs).

       --kx kx1 kx2...
	      Key exchange methods to enable (use gnutls-cli --list to show the supported methods).

       --ctypes certType1 certType2...
	      Certificate types to enable (use gnutls-cli --list to show the supported types).

       --recordsize integer
	      The maximum record size to advertize.

       --disable-extensions
	      Disable all the TLS extensions.

       --print-cert
	      Print the certificate in PEM format.

       --insecure
	      Don't abort program if server certificates can't be validated.

   Certificate options
       --pgpcertfile FILE
	      PGP Public Key (certificate) file to use.

       --pgpkeyfile FILE
	      PGP Key file to use.

       --pgpkeyring FILE
	      PGP Key ring file to use.

       --pgptrustdb FILE
	      PGP trustdb file to use.

       --pgpsubkey HEX|auto2
	      PGP subkey to use.

       --srppasswd PASSWD
	      SRP password to use.

       --srpusername NAME
	      SRP username to use.

       --x509cafile FILE
	      Certificate file to use. This option accepts PKCS #11 URLs such as "pkcs11:token=xxx"

       --x509certfile FILE
	      X.509 Certificate file to use, or a PKCS #11 URL.

       --x509fmtder
	      Use DER format for certificates

       --x509keyfile FILE
	      X.509 key file or PKCS #11 URL to use.

       --x509crlfile FILE
	      X.509 CRL file to use.

       --pskusername NAME
	      PSK username to use.

       --pskkey KEY
	      PSK key (in hex) to use.

       --opaque-prf-input DATA
	      Use Opaque PRF Input DATA.

SEE ALSO

       gnutls-cli-debug(1), gnutls-serv(1)

AUTHOR

       Nikos Mavrogiannopoulos <nmav@gnutls.org> and others; see /usr/share/doc/gnutls-bin/AUTHORS for a complete list.

       This manual page was written by Ivo Timmermans <ivo@debian.org>, for the Debian GNU/Linux system (but may be used by others).

								 December 1st 2003						     gnutls-cli(1)