doc/invoke-gnutls-cli-debug.texi

   1 @node gnutls-cli-debug Invocation
   2 @section Invoking gnutls-cli-debug
   3 @pindex gnutls-cli-debug
   4 @ignore
   5 #  -*- buffer-read-only: t -*- vi: set ro:
   6 #
   7 # DO NOT EDIT THIS FILE   (invoke-gnutls-cli-debug.texi)
   8 #
   9 # It has been AutoGen-ed  May 29, 2014 at 07:10:27 PM by AutoGen 5.18.2
  10 # From the definitions    ../src/cli-debug-args.def
  11 # and the template file   agtexi-cmd.tpl
  12 @end ignore
  13
  14
  15 TLS debug client. It sets up multiple TLS connections to
  16 a server and queries its capabilities. It was created to assist in debugging
  17 GnuTLS, but it might be useful to extract a TLS server's capabilities.
  18 It connects to a TLS server, performs tests and print the server's
  19 capabilities. If called with the `-v' parameter more checks will be performed.
  20 Can be used to check for servers with special needs or bugs.
  21
  22 This section was generated by @strong{AutoGen},
  23 using the @code{agtexi-cmd} template and the option descriptions for the @code{gnutls-cli-debug} program.
  24 This software is released under the GNU General Public License, version 3 or later.
  25
  26
  27 @anchor{gnutls-cli-debug usage}
  28 @subheading gnutls-cli-debug help/usage (@option{--help})
  29 @cindex gnutls-cli-debug help
  30
  31 This is the automatically generated usage text for gnutls-cli-debug.
  32
  33 The text printed is the same whether selected with the @code{help} option
  34 (@option{--help}) or the @code{more-help} option (@option{--more-help}).  @code{more-help} will print
  35 the usage text by passing it through a pager program.
  36 @code{more-help} is disabled on platforms without a working
  37 @code{fork(2)} function.  The @code{PAGER} environment variable is
  38 used to select the program, defaulting to @file{more}.  Both will exit
  39 with a status code of 0.
  40
  41 @exampleindent 0
  42 @example
  43 gnutls-cli-debug - GnuTLS debug client
  44 Usage:  gnutls-cli-debug [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
  45
  46    -d, --debug=num            Enable debugging
  47                                 - it must be in the range:
  48                                   0 to 9999
  49    -V, --verbose              More verbose output
  50                                 - may appear multiple times
  51    -p, --port=num             The port to connect to
  52                                 - it must be in the range:
  53                                   0 to 65536
  54    -v, --version[=arg]        output version information and exit
  55    -h, --help                 display extended usage information and exit
  56    -!, --more-help            extended usage information passed thru pager
  57
  58 Options are specified by doubled hyphens and their name or by a single
  59 hyphen and the flag character.
  60 Operands and options may be intermixed.  They will be reordered.
  61
  62 TLS debug client.  It sets up multiple TLS connections to a server and
  63 queries its capabilities.  It was created to assist in debugging GnuTLS,
  64 but it might be useful to extract a TLS server's capabilities.  It connects
  65 to a TLS server, performs tests and print the server's capabilities.  If
  66 called with the `-v' parameter more checks will be performed.  Can be used
  67 to check for servers with special needs or bugs.
  68
  69 @end example
  70 @exampleindent 4
  71
  72 @anchor{gnutls-cli-debug debug}
  73 @subheading debug option (-d)
  74
  75 This is the ``enable debugging'' option.
  76 This option takes a number argument.
  77 Specifies the debug level.
  78 @anchor{gnutls-cli-debug exit status}
  79 @subheading gnutls-cli-debug exit status
  80
  81 One of the following exit values will be returned:
  82 @table @samp
  83 @item 0 (EXIT_SUCCESS)
  84 Successful program execution.
  85 @item 1 (EXIT_FAILURE)
  86 The operation failed or the command syntax was not valid.
  87 @end table
  88 @anchor{gnutls-cli-debug See Also}
  89 @subheading gnutls-cli-debug See Also
  90 gnutls-cli(1), gnutls-serv(1)
  91 @anchor{gnutls-cli-debug Examples}
  92 @subheading gnutls-cli-debug Examples
  93 @example
  94 $ ../src/gnutls-cli-debug localhost
  95 Resolving 'localhost'...
  96 Connecting to '127.0.0.1:443'...
  97 Checking for SSL 3.0 support... yes
  98 Checking whether %COMPAT is required... no
  99 Checking for TLS 1.0 support... yes
 100 Checking for TLS 1.1 support... no
 101 Checking fallback from TLS 1.1 to... TLS 1.0
 102 Checking for TLS 1.2 support... no
 103 Checking whether we need to disable TLS 1.0... N/A
 104 Checking for Safe renegotiation support... yes
 105 Checking for Safe renegotiation support (SCSV)... yes
 106 Checking for HTTPS server name... not checked
 107 Checking for version rollback bug in RSA PMS... no
 108 Checking for version rollback bug in Client Hello... no
 109 Checking whether the server ignores the RSA PMS version... no
 110 Checking whether the server can accept Hello Extensions... yes
 111 Checking whether the server can accept small records (512 bytes)... yes
 112 Checking whether the server can accept cipher suites not in SSL 3.0 spec... yes
 113 Checking whether the server can accept a bogus TLS record version in the client hello... yes
 114 Checking for certificate information... N/A
 115 Checking for trusted CAs... N/A
 116 Checking whether the server understands TLS closure alerts... partially
 117 Checking whether the server supports session resumption... yes
 118 Checking for export-grade ciphersuite support... no
 119 Checking RSA-export ciphersuite info... N/A
 120 Checking for anonymous authentication support... no
 121 Checking anonymous Diffie-Hellman group info... N/A
 122 Checking for ephemeral Diffie-Hellman support... no
 123 Checking ephemeral Diffie-Hellman group info... N/A
 124 Checking for ephemeral EC Diffie-Hellman support... yes
 125 Checking ephemeral EC Diffie-Hellman group info...
 126  Curve SECP256R1
 127 Checking for AES-GCM cipher support... no
 128 Checking for AES-CBC cipher support... yes
 129 Checking for CAMELLIA cipher support... no
 130 Checking for 3DES-CBC cipher support... yes
 131 Checking for ARCFOUR 128 cipher support... yes
 132 Checking for ARCFOUR 40 cipher support... no
 133 Checking for MD5 MAC support... yes
 134 Checking for SHA1 MAC support... yes
 135 Checking for SHA256 MAC support... no
 136 Checking for ZLIB compression support... no
 137 Checking for max record size... no
 138 Checking for OpenPGP authentication support... no
 139 @end example