X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=doc%2Fman1%2Fs_client.pod;h=e2475ea0678fb72fc16bedb8bf2e6ab5f05d588f;hb=refs%2Ftags%2FOpenSSL_1_1_1d;hp=bbb86c2e22e6ca4efdb08bdea57a1aa8fa38552c;hpb=6437b802f19fb022da88f59cb3071ebdcd2838f6;p=oweals%2Fopenssl.git diff --git a/doc/man1/s_client.pod b/doc/man1/s_client.pod index bbb86c2e22..e2475ea067 100644 --- a/doc/man1/s_client.pod +++ b/doc/man1/s_client.pod @@ -2,6 +2,7 @@ =head1 NAME +openssl-s_client, s_client - SSL/TLS client program =head1 SYNOPSIS @@ -9,22 +10,35 @@ s_client - SSL/TLS client program B B [B<-help>] [B<-connect host:port>] +[B<-bind host:port>] [B<-proxy host:port>] [B<-unix path>] [B<-4>] [B<-6>] [B<-servername name>] +[B<-noservername>] [B<-verify depth>] [B<-verify_return_error>] [B<-cert filename>] [B<-certform DER|PEM>] [B<-key filename>] [B<-keyform DER|PEM>] +[B<-cert_chain filename>] +[B<-build_chain>] +[B<-xkey>] +[B<-xcert>] +[B<-xchain>] +[B<-xchain_build>] +[B<-xcertform PEM|DER>] +[B<-xkeyform PEM|DER>] [B<-pass arg>] [B<-CApath directory>] [B<-CAfile filename>] +[B<-chainCApath directory>] +[B<-chainCAfile filename>] [B<-no-CAfile>] [B<-no-CApath>] +[B<-requestCAfile filename>] [B<-dane_tlsa_domain domain>] [B<-dane_tlsa_rrdata rrdata>] [B<-dane_ee_no_namechecks>] @@ -56,6 +70,7 @@ B B [B<-verify_hostname hostname>] [B<-verify_ip ip>] [B<-verify_name name>] +[B<-build_chain>] [B<-x509_strict>] [B<-reconnect>] [B<-showcerts>] @@ -67,6 +82,9 @@ B B [B<-crlf>] [B<-ign_eof>] [B<-no_ign_eof>] +[B<-psk_identity identity>] +[B<-psk key>] +[B<-psk_session file>] [B<-quiet>] [B<-ssl3>] [B<-tls1>] @@ -81,32 +99,44 @@ B B [B<-dtls>] [B<-dtls1>] [B<-dtls1_2>] +[B<-sctp>] +[B<-sctp_label_bug>] [B<-fallback_scsv>] [B<-async>] +[B<-max_send_frag>] [B<-split_send_frag>] [B<-max_pipelines>] [B<-read_buf>] [B<-bugs>] [B<-comp>] [B<-no_comp>] +[B<-allow_no_dhe_kex>] +[B<-sigalgs sigalglist>] +[B<-curves curvelist>] [B<-cipher cipherlist>] +[B<-ciphersuites val>] [B<-serverpref>] [B<-starttls protocol>] [B<-xmpphost hostname>] +[B<-name hostname>] [B<-engine id>] [B<-tlsextdebug>] [B<-no_ticket>] [B<-sess_out filename>] [B<-sess_in filename>] -[B<-rand file(s)>] +[B<-rand file...>] +[B<-writerand file>] [B<-serverinfo types>] [B<-status>] [B<-alpn protocols>] [B<-nextprotoneg protocols>] -[B<-ct|noct>] +[B<-ct>] +[B<-noct>] [B<-ctlogfile>] [B<-keylogfile file>] [B<-early_data file>] +[B<-enable_pha>] +[B] =head1 DESCRIPTION @@ -117,7 +147,7 @@ SSL servers. =head1 OPTIONS In addition to the options below the B utility also supports the -common and client only options documented in the +common and client only options documented in the "Supported Command Line Commands" section of the L manual page. @@ -129,8 +159,16 @@ Print out a usage message. =item B<-connect host:port> -This specifies the host and optional port to connect to. If not specified -then an attempt is made to connect to the local host on port 4433. +This specifies the host and optional port to connect to. It is possible to +select the host and port using the optional target positional argument instead. +If neither this nor the target positional argument are specified then an attempt +is made to connect to the local host on port 4433. + +=item B<-bind host:port>] + +This specifies the host address and or port to bind as the source for the +connection. For Unix-domain sockets the port is ignored and the host is +used as the source socket address. =item B<-proxy host:port> @@ -152,7 +190,24 @@ Use IPv6 only. =item B<-servername name> -Set the TLS SNI (Server Name Indication) extension in the ClientHello message. +Set the TLS SNI (Server Name Indication) extension in the ClientHello message to +the given value. +If B<-servername> is not provided, the TLS SNI extension will be populated with +the name given to B<-connect> if it follows a DNS name format. If B<-connect> is +not provided either, the SNI is set to "localhost". +This is the default since OpenSSL 1.1.1. + +Even though SNI should normally be a DNS name and not an IP address, if +B<-servername> is provided then that name will be sent, regardless of whether +it is a DNS name or not. + +This option cannot be used in conjunction with B<-noservername>. + +=item B<-noservername> + +Suppresses sending of the SNI (Server Name Indication) extension in the +ClientHello message. Cannot be used in conjunction with the B<-servername> or +<-dane_tlsa_domain> options. =item B<-cert certname> @@ -172,6 +227,34 @@ be used. The private format to use: DER or PEM. PEM is the default. +=item B<-cert_chain> + +A file containing trusted certificates to use when attempting to build the +client/server certificate chain related to the certificate specified via the +B<-cert> option. + +=item B<-build_chain> + +Specify whether the application should build the certificate chain to be +provided to the server. + +=item B<-xkey infile>, B<-xcert infile>, B<-xchain> + +Specify an extra certificate, private key and certificate chain. These behave +in the same manner as the B<-cert>, B<-key> and B<-cert_chain> options. When +specified, the callback returning the first valid chain will be in use by the +client. + +=item B<-xchain_build> + +Specify whether the application should build the certificate chain to be +provided to the server for the extra certificates provided via B<-xkey infile>, +B<-xcert infile>, B<-xchain> options. + +=item B<-xcertform PEM|DER>, B<-xkeyform PEM|DER> + +Extra certificate and private key format respectively. + =item B<-pass arg> the private key password source. For more information about the format of B @@ -192,7 +275,7 @@ abort the handshake with a fatal error. =item B<-nameopt option> -option which determines how the subject or issuer names are displayed. The +Option which determines how the subject or issuer names are displayed. The B