summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorinoguchi <>2019-07-11 10:31:48 +0000
committerinoguchi <>2019-07-11 10:31:48 +0000
commit08667db6793faaf3c266211cea6452f53bcb4f0c (patch)
tree73220ffc4a5b913a61c69010aeb55391345c1919
parent7da60065ae1fa02de0bee5adff81fe5448048378 (diff)
downloadopenbsd-08667db6793faaf3c266211cea6452f53bcb4f0c.tar.gz
openbsd-08667db6793faaf3c266211cea6452f53bcb4f0c.tar.bz2
openbsd-08667db6793faaf3c266211cea6452f53bcb4f0c.zip
Fix manual openssl(1) s_client
- Add undocumented options below. -alpn, -certform, -dtls1, -host, -keyform, -keymatexport, -keymatexportlen, -legacy_server_connect, -mtu, -no_ign_eof, -no_legacy_server_connect, -pass -port, -serverpref, -sess_in, -sess_out, -status, -timeout, -use_srtp, -verify_return_error - Remove -psk and -psk_identity since not exist in source code. I didn't add these 4 options since these were no-op. -nextprotoneg, -legacy_renegotiation, -no_comp, -no_ssl2 This option was removed from manual in the past. -no_ssl3 ok jmc@
-rw-r--r--src/usr.bin/openssl/openssl.194
1 files changed, 80 insertions, 14 deletions
diff --git a/src/usr.bin/openssl/openssl.1 b/src/usr.bin/openssl/openssl.1
index 90ff100111..1cf58eb6c5 100644
--- a/src/usr.bin/openssl/openssl.1
+++ b/src/usr.bin/openssl/openssl.1
@@ -1,4 +1,4 @@
1.\" $OpenBSD: openssl.1,v 1.109 2019/07/09 11:19:05 inoguchi Exp $ 1.\" $OpenBSD: openssl.1,v 1.110 2019/07/11 10:31:48 inoguchi Exp $
2.\" ==================================================================== 2.\" ====================================================================
3.\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved. 3.\" Copyright (c) 1998-2002 The OpenSSL Project. All rights reserved.
4.\" 4.\"
@@ -110,7 +110,7 @@
110.\" copied and put under another distribution licence 110.\" copied and put under another distribution licence
111.\" [including the GNU Public Licence.] 111.\" [including the GNU Public Licence.]
112.\" 112.\"
113.Dd $Mdocdate: July 9 2019 $ 113.Dd $Mdocdate: July 11 2019 $
114.Dt OPENSSL 1 114.Dt OPENSSL 1
115.Os 115.Os
116.Sh NAME 116.Sh NAME
@@ -3605,10 +3605,12 @@ Verify the input data and output the recovered data.
3605.nr nS 1 3605.nr nS 1
3606.Nm "openssl s_client" 3606.Nm "openssl s_client"
3607.Op Fl 4 | 6 3607.Op Fl 4 | 6
3608.Op Fl alpn Ar protocols
3608.Op Fl bugs 3609.Op Fl bugs
3609.Op Fl CAfile Ar file 3610.Op Fl CAfile Ar file
3610.Op Fl CApath Ar directory 3611.Op Fl CApath Ar directory
3611.Op Fl cert Ar file 3612.Op Fl cert Ar file
3613.Op Fl certform Cm der | pem
3612.Op Fl check_ss_sig 3614.Op Fl check_ss_sig
3613.Op Fl cipher Ar cipherlist 3615.Op Fl cipher Ar cipherlist
3614.Op Fl connect Ar host Ns Op : Ns Ar port 3616.Op Fl connect Ar host Ns Op : Ns Ar port
@@ -3616,36 +3618,53 @@ Verify the input data and output the recovered data.
3616.Op Fl crl_check_all 3618.Op Fl crl_check_all
3617.Op Fl crlf 3619.Op Fl crlf
3618.Op Fl debug 3620.Op Fl debug
3621.Op Fl dtls1
3619.Op Fl extended_crl 3622.Op Fl extended_crl
3620.Op Fl groups 3623.Op Fl groups
3624.Op Fl host Ar host
3621.Op Fl ign_eof 3625.Op Fl ign_eof
3622.Op Fl ignore_critical 3626.Op Fl ignore_critical
3623.Op Fl issuer_checks 3627.Op Fl issuer_checks
3624.Op Fl key Ar keyfile 3628.Op Fl key Ar keyfile
3629.Op Fl keyform Cm der | pem
3630.Op Fl keymatexport Ar label
3631.Op Fl keymatexportlen Ar len
3632.Op Fl legacy_server_connect
3625.Op Fl msg 3633.Op Fl msg
3634.Op Fl mtu Ar mtu
3626.Op Fl nbio 3635.Op Fl nbio
3627.Op Fl nbio_test 3636.Op Fl nbio_test
3637.Op Fl no_comp
3638.Op Fl no_ign_eof
3639.Op Fl no_legacy_server_connect
3628.Op Fl no_ticket 3640.Op Fl no_ticket
3629.Op Fl no_tls1 3641.Op Fl no_tls1
3630.Op Fl no_tls1_1 3642.Op Fl no_tls1_1
3631.Op Fl no_tls1_2 3643.Op Fl no_tls1_2
3644.Op Fl pass Ar arg
3632.Op Fl pause 3645.Op Fl pause
3633.Op Fl policy_check 3646.Op Fl policy_check
3647.Op Fl port Ar port
3634.Op Fl prexit 3648.Op Fl prexit
3635.Op Fl proxy Ar host : Ns Ar port 3649.Op Fl proxy Ar host : Ns Ar port
3636.Op Fl psk Ar key
3637.Op Fl psk_identity Ar identity
3638.Op Fl quiet 3650.Op Fl quiet
3639.Op Fl reconnect 3651.Op Fl reconnect
3640.Op Fl servername Ar name 3652.Op Fl servername Ar name
3653.Op Fl serverpref
3654.Op Fl sess_in Ar file
3655.Op Fl sess_out Ar file
3641.Op Fl showcerts 3656.Op Fl showcerts
3642.Op Fl starttls Ar protocol 3657.Op Fl starttls Ar protocol
3643.Op Fl state 3658.Op Fl state
3659.Op Fl status
3660.Op Fl timeout
3644.Op Fl tls1 3661.Op Fl tls1
3645.Op Fl tls1_1 3662.Op Fl tls1_1
3646.Op Fl tls1_2 3663.Op Fl tls1_2
3647.Op Fl tlsextdebug 3664.Op Fl tlsextdebug
3665.Op Fl use_srtp Ar profiles
3648.Op Fl verify Ar depth 3666.Op Fl verify Ar depth
3667.Op Fl verify_return_error
3649.Op Fl x509_strict 3668.Op Fl x509_strict
3650.Op Fl xmpphost Ar host 3669.Op Fl xmpphost Ar host
3651.nr nS 0 3670.nr nS 0
@@ -3674,6 +3693,11 @@ The options are as follows:
3674Attempt connections using IPv4 only. 3693Attempt connections using IPv4 only.
3675.It Fl 6 3694.It Fl 6
3676Attempt connections using IPv6 only. 3695Attempt connections using IPv6 only.
3696.It Fl alpn Ar protocols
3697Enable the Application-Layer Protocol Negotiation.
3698.Ar protocols
3699is a comma-separated list of protocol names that the client should advertise
3700support for.
3677.It Fl bugs 3701.It Fl bugs
3678Enable various workarounds for buggy implementations. 3702Enable various workarounds for buggy implementations.
3679.It Fl CAfile Ar file 3703.It Fl CAfile Ar file
@@ -3694,6 +3718,10 @@ These are also used when building the client certificate chain.
3694.It Fl cert Ar file 3718.It Fl cert Ar file
3695The certificate to use, if one is requested by the server. 3719The certificate to use, if one is requested by the server.
3696The default is not to use a certificate. 3720The default is not to use a certificate.
3721.It Fl certform Cm der | pem
3722The certificate format.
3723The default is
3724.Cm pem .
3697.It Xo 3725.It Xo
3698.Fl check_ss_sig , 3726.Fl check_ss_sig ,
3699.Fl crl_check , 3727.Fl crl_check ,
@@ -3731,25 +3759,57 @@ Translate a line feed from the terminal into CR+LF,
3731as required by some servers. 3759as required by some servers.
3732.It Fl debug 3760.It Fl debug
3733Print extensive debugging information, including a hex dump of all traffic. 3761Print extensive debugging information, including a hex dump of all traffic.
3762.It Fl dtls1
3763Permit only DTLS1.0.
3734.It Fl groups Ar ecgroups 3764.It Fl groups Ar ecgroups
3735Specify a colon-separated list of permitted EC curve groups. 3765Specify a colon-separated list of permitted EC curve groups.
3766.It Fl host Ar host
3767The
3768.Ar host
3769to connect to.
3770The default is localhost.
3736.It Fl ign_eof 3771.It Fl ign_eof
3737Inhibit shutting down the connection when end of file is reached in the input. 3772Inhibit shutting down the connection when end of file is reached in the input.
3738.It Fl key Ar keyfile 3773.It Fl key Ar keyfile
3739The private key to use. 3774The private key to use.
3740If not specified, the certificate file will be used. 3775If not specified, the certificate file will be used.
3776.It Fl keyform Cm der | pem
3777The private key format.
3778The default is
3779.Cm pem .
3780.It Fl keymatexport Ar label
3781Export keying material using label.
3782.It Fl keymatexportlen Ar len
3783Export len bytes of keying material (default 20).
3784.It Fl legacy_server_connect , no_legacy_server_connect
3785Allow or disallow initial connection to servers that don't support RI.
3741.It Fl msg 3786.It Fl msg
3742Show all protocol messages with hex dump. 3787Show all protocol messages with hex dump.
3788.It Fl mtu Ar mtu
3789Set the link layer MTU.
3743.It Fl nbio 3790.It Fl nbio
3744Turn on non-blocking I/O. 3791Turn on non-blocking I/O.
3745.It Fl nbio_test 3792.It Fl nbio_test
3746Test non-blocking I/O. 3793Test non-blocking I/O.
3794.It Fl no_ign_eof
3795Shut down the connection when end of file is reached in the input.
3796Can be used to override the implicit
3797.Fl ign_eof
3798after
3799.Fl quiet .
3747.It Fl no_tls1 | no_tls1_1 | no_tls1_2 3800.It Fl no_tls1 | no_tls1_1 | no_tls1_2
3748Disable the use of TLS1.0, 1.1, and 1.2, respectively. 3801Disable the use of TLS1.0, 1.1, and 1.2, respectively.
3749.It Fl no_ticket 3802.It Fl no_ticket
3750Disable RFC 4507 session ticket support. 3803Disable RFC 4507 session ticket support.
3804.It Fl pass Ar arg
3805The private key password source.
3751.It Fl pause 3806.It Fl pause
3752Pause 1 second between each read and write call. 3807Pause 1 second between each read and write call.
3808.It Fl port Ar port
3809The
3810.Ar port
3811to connect to.
3812The default is 4433.
3753.It Fl prexit 3813.It Fl prexit
3754Print session information when the program exits. 3814Print session information when the program exits.
3755This will always attempt 3815This will always attempt
@@ -3771,16 +3831,6 @@ argument is given to the proxy.
3771If not specified, localhost is used as final destination. 3831If not specified, localhost is used as final destination.
3772After that, switch the connection through the proxy to the destination 3832After that, switch the connection through the proxy to the destination
3773to TLS. 3833to TLS.
3774.It Fl psk Ar key
3775Use the PSK key
3776.Ar key
3777when using a PSK cipher suite.
3778The key is given as a hexadecimal number without the leading 0x,
3779for example -psk 1a2b3c4d.
3780.It Fl psk_identity Ar identity
3781Use the PSK
3782.Ar identity
3783when using a PSK cipher suite.
3784.It Fl quiet 3834.It Fl quiet
3785Inhibit printing of session and certificate information. 3835Inhibit printing of session and certificate information.
3786This implicitly turns on 3836This implicitly turns on
@@ -3796,6 +3846,13 @@ message, using the specified server
3796.It Fl showcerts 3846.It Fl showcerts
3797Display the whole server certificate chain: normally only the server 3847Display the whole server certificate chain: normally only the server
3798certificate itself is displayed. 3848certificate itself is displayed.
3849.It Fl serverpref
3850Use the server's cipher preferences.
3851.It Fl sess_in Ar file
3852Load TLS session from file.
3853The client will attempt to resume a connection from this session.
3854.It Fl sess_out Ar file
3855Output TLS session to file.
3799.It Fl starttls Ar protocol 3856.It Fl starttls Ar protocol
3800Send the protocol-specific messages to switch to TLS for communication. 3857Send the protocol-specific messages to switch to TLS for communication.
3801.Ar protocol 3858.Ar protocol
@@ -3809,10 +3866,17 @@ and
3809.Qq xmpp . 3866.Qq xmpp .
3810.It Fl state 3867.It Fl state
3811Print the SSL session states. 3868Print the SSL session states.
3869.It Fl status
3870Send a certificate status request to the server (OCSP stapling).
3871The server response (if any) is printed out.
3872.It Fl timeout
3873Enable send/receive timeout on DTLS connections.
3812.It Fl tls1 | tls1_1 | tls1_2 3874.It Fl tls1 | tls1_1 | tls1_2
3813Permit only TLS1.0, 1.1, or 1.2, respectively. 3875Permit only TLS1.0, 1.1, or 1.2, respectively.
3814.It Fl tlsextdebug 3876.It Fl tlsextdebug
3815Print a hex dump of any TLS extensions received from the server. 3877Print a hex dump of any TLS extensions received from the server.
3878.It Fl use_srtp Ar profiles
3879Offer SRTP key management with a colon-separated profile list.
3816.It Fl verify Ar depth 3880.It Fl verify Ar depth
3817Turn on server certificate verification, 3881Turn on server certificate verification,
3818with a maximum length of 3882with a maximum length of
@@ -3821,6 +3885,8 @@ Currently the verify operation continues after errors so all the problems
3821with a certificate chain can be seen. 3885with a certificate chain can be seen.
3822As a side effect the connection will never fail due to a server 3886As a side effect the connection will never fail due to a server
3823certificate verify failure. 3887certificate verify failure.
3888.It Fl verify_return_error
3889Return verification error.
3824.It Fl xmpphost Ar hostname 3890.It Fl xmpphost Ar hostname
3825When used with 3891When used with
3826.Fl starttls Ar xmpp , 3892.Fl starttls Ar xmpp ,