diff options
| author | inoguchi <> | 2019-07-12 10:21:08 +0000 |
|---|---|---|
| committer | inoguchi <> | 2019-07-12 10:21:08 +0000 |
| commit | 1db1069d1b9ecde8b795c0cadab6f84368986bc7 (patch) | |
| tree | 1d5dac68d0bbcc19c2ec73fa8da434af3e12ca88 /src | |
| parent | 8bdcdce4ae33e4cef15864c11df84176c17a095a (diff) | |
| download | openbsd-1db1069d1b9ecde8b795c0cadab6f84368986bc7.tar.gz openbsd-1db1069d1b9ecde8b795c0cadab6f84368986bc7.tar.bz2 openbsd-1db1069d1b9ecde8b795c0cadab6f84368986bc7.zip | |
Fix manual openssl(1) s_server
- Add undocumented options below.
-alpn, -cert2, -certform, -dcertform, -dkeyform, -dpass, -dtls1, -key2,
-keyform, -keymatexport, -keymatexportlen, -mtu, -named_curve, -no_cache,
-no_ecdhe, -no_ticket, -pass, -port, -servername, -servername_fatal,
-status, -status_timeout, -status_url, -status_verbose, -timeout,
-tlsextdebug, -use_srtp, -verify_return_error
- Remove -hack, -psk and -psk_hint since not exist in source code.
I didn't add these 5 options since these were no-op.
-chain, -legacy_renegotiation, -nextprotoneg, -no_comp, -no_ssl2
This option was removed from manual in the past.
-no_ssl3
ok and suggestions from jmc@
Diffstat (limited to 'src')
| -rw-r--r-- | src/usr.bin/openssl/openssl.1 | 112 |
1 files changed, 94 insertions, 18 deletions
diff --git a/src/usr.bin/openssl/openssl.1 b/src/usr.bin/openssl/openssl.1 index 1cf58eb6c5..6e83385966 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.110 2019/07/11 10:31:48 inoguchi Exp $ | 1 | .\" $OpenBSD: openssl.1,v 1.111 2019/07/12 10:21:08 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 11 2019 $ | 113 | .Dd $Mdocdate: July 12 2019 $ |
| 114 | .Dt OPENSSL 1 | 114 | .Dt OPENSSL 1 |
| 115 | .Os | 115 | .Os |
| 116 | .Sh NAME | 116 | .Sh NAME |
| @@ -3899,42 +3899,67 @@ will be used. | |||
| 3899 | .nr nS 1 | 3899 | .nr nS 1 |
| 3900 | .Nm "openssl s_server" | 3900 | .Nm "openssl s_server" |
| 3901 | .Op Fl accept Ar port | 3901 | .Op Fl accept Ar port |
| 3902 | .Op Fl alpn Ar protocols | ||
| 3902 | .Op Fl bugs | 3903 | .Op Fl bugs |
| 3903 | .Op Fl CAfile Ar file | 3904 | .Op Fl CAfile Ar file |
| 3904 | .Op Fl CApath Ar directory | 3905 | .Op Fl CApath Ar directory |
| 3905 | .Op Fl cert Ar file | 3906 | .Op Fl cert Ar file |
| 3907 | .Op Fl cert2 Ar file | ||
| 3908 | .Op Fl certform Cm der | pem | ||
| 3906 | .Op Fl cipher Ar cipherlist | 3909 | .Op Fl cipher Ar cipherlist |
| 3907 | .Op Fl context Ar id | 3910 | .Op Fl context Ar id |
| 3908 | .Op Fl crl_check | 3911 | .Op Fl crl_check |
| 3909 | .Op Fl crl_check_all | 3912 | .Op Fl crl_check_all |
| 3910 | .Op Fl crlf | 3913 | .Op Fl crlf |
| 3911 | .Op Fl dcert Ar file | 3914 | .Op Fl dcert Ar file |
| 3915 | .Op Fl dcertform Cm der | pem | ||
| 3912 | .Op Fl debug | 3916 | .Op Fl debug |
| 3913 | .Op Fl dhparam Ar file | 3917 | .Op Fl dhparam Ar file |
| 3914 | .Op Fl dkey Ar file | 3918 | .Op Fl dkey Ar file |
| 3915 | .Op Fl hack | 3919 | .Op Fl dkeyform Cm der | pem |
| 3920 | .Op Fl dpass Ar arg | ||
| 3921 | .Op Fl dtls1 | ||
| 3916 | .Op Fl HTTP | 3922 | .Op Fl HTTP |
| 3917 | .Op Fl id_prefix Ar arg | 3923 | .Op Fl id_prefix Ar arg |
| 3918 | .Op Fl key Ar keyfile | 3924 | .Op Fl key Ar keyfile |
| 3925 | .Op Fl key2 Ar keyfile | ||
| 3926 | .Op Fl keyform Cm der | pem | ||
| 3927 | .Op Fl keymatexport Ar label | ||
| 3928 | .Op Fl keymatexportlen Ar len | ||
| 3919 | .Op Fl msg | 3929 | .Op Fl msg |
| 3930 | .Op Fl mtu Ar mtu | ||
| 3931 | .Op Fl named_curve Ar arg | ||
| 3920 | .Op Fl nbio | 3932 | .Op Fl nbio |
| 3921 | .Op Fl nbio_test | 3933 | .Op Fl nbio_test |
| 3934 | .Op Fl no_cache | ||
| 3922 | .Op Fl no_dhe | 3935 | .Op Fl no_dhe |
| 3936 | .Op Fl no_ecdhe | ||
| 3937 | .Op Fl no_ticket | ||
| 3923 | .Op Fl no_tls1 | 3938 | .Op Fl no_tls1 |
| 3924 | .Op Fl no_tls1_1 | 3939 | .Op Fl no_tls1_1 |
| 3925 | .Op Fl no_tls1_2 | 3940 | .Op Fl no_tls1_2 |
| 3926 | .Op Fl no_tmp_rsa | 3941 | .Op Fl no_tmp_rsa |
| 3927 | .Op Fl nocert | 3942 | .Op Fl nocert |
| 3928 | .Op Fl psk Ar key | 3943 | .Op Fl pass Ar arg |
| 3929 | .Op Fl psk_hint Ar hint | 3944 | .Op Fl port Ar port |
| 3930 | .Op Fl quiet | 3945 | .Op Fl quiet |
| 3946 | .Op Fl servername Ar name | ||
| 3947 | .Op Fl servername_fatal | ||
| 3931 | .Op Fl serverpref | 3948 | .Op Fl serverpref |
| 3932 | .Op Fl state | 3949 | .Op Fl state |
| 3950 | .Op Fl status | ||
| 3951 | .Op Fl status_timeout Ar nsec | ||
| 3952 | .Op Fl status_url Ar url | ||
| 3953 | .Op Fl status_verbose | ||
| 3954 | .Op Fl timeout | ||
| 3933 | .Op Fl tls1 | 3955 | .Op Fl tls1 |
| 3934 | .Op Fl tls1_1 | 3956 | .Op Fl tls1_1 |
| 3935 | .Op Fl tls1_2 | 3957 | .Op Fl tls1_2 |
| 3958 | .Op Fl tlsextdebug | ||
| 3959 | .Op Fl use_srtp Ar profiles | ||
| 3936 | .Op Fl Verify Ar depth | 3960 | .Op Fl Verify Ar depth |
| 3937 | .Op Fl verify Ar depth | 3961 | .Op Fl verify Ar depth |
| 3962 | .Op Fl verify_return_error | ||
| 3938 | .Op Fl WWW | 3963 | .Op Fl WWW |
| 3939 | .Op Fl www | 3964 | .Op Fl www |
| 3940 | .nr nS 0 | 3965 | .nr nS 0 |
| @@ -3969,11 +3994,15 @@ Print out some session cache status information. | |||
| 3969 | .Pp | 3994 | .Pp |
| 3970 | The options are as follows: | 3995 | The options are as follows: |
| 3971 | .Bl -tag -width Ds | 3996 | .Bl -tag -width Ds |
| 3972 | .It Fl accept Ar port | 3997 | .It Fl accept Ar port , Fl port Ar port |
| 3973 | Listen on TCP | 3998 | Listen on TCP |
| 3974 | .Ar port | 3999 | .Ar port |
| 3975 | for connections. | 4000 | for connections. |
| 3976 | The default is port 4433. | 4001 | The default is port 4433. |
| 4002 | .It Fl alpn Ar protocols | ||
| 4003 | Enable the Application-Layer Protocol Negotiation. | ||
| 4004 | .Ar protocols | ||
| 4005 | is a comma-separated list of supported protocol names. | ||
| 3977 | .It Fl bugs | 4006 | .It Fl bugs |
| 3978 | Enable various workarounds for buggy implementations. | 4007 | Enable various workarounds for buggy implementations. |
| 3979 | .It Fl CAfile Ar file | 4008 | .It Fl CAfile Ar file |
| @@ -4001,6 +4030,12 @@ For example, the DSS cipher suites require a certificate containing a DSS | |||
| 4001 | If not specified, the file | 4030 | If not specified, the file |
| 4002 | .Pa server.pem | 4031 | .Pa server.pem |
| 4003 | will be used. | 4032 | will be used. |
| 4033 | .It Fl cert2 Ar file | ||
| 4034 | The certificate to use for servername. | ||
| 4035 | .It Fl certform Cm der | pem | ||
| 4036 | The certificate format. | ||
| 4037 | The default is | ||
| 4038 | .Cm pem . | ||
| 4004 | .It Fl cipher Ar cipherlist | 4039 | .It Fl cipher Ar cipherlist |
| 4005 | Modify the cipher list used by the server. | 4040 | Modify the cipher list used by the server. |
| 4006 | This allows the cipher list used by the server to be modified. | 4041 | This allows the cipher list used by the server to be modified. |
| @@ -4032,6 +4067,9 @@ options except there is no default if they are not specified | |||
| 4032 | By using RSA and DSS certificates and keys, | 4067 | By using RSA and DSS certificates and keys, |
| 4033 | a server can support clients which only support RSA or DSS cipher suites | 4068 | a server can support clients which only support RSA or DSS cipher suites |
| 4034 | by using an appropriate certificate. | 4069 | by using an appropriate certificate. |
| 4070 | .It Fl dcertform Cm der | pem , Fl dkeyform Cm der | pem , Fl dpass Ar arg | ||
| 4071 | Additional certificate and private key format, and private key password source, | ||
| 4072 | respectively. | ||
| 4035 | .It Fl debug | 4073 | .It Fl debug |
| 4036 | Print extensive debugging information, including a hex dump of all traffic. | 4074 | Print extensive debugging information, including a hex dump of all traffic. |
| 4037 | .It Fl dhparam Ar file | 4075 | .It Fl dhparam Ar file |
| @@ -4043,8 +4081,8 @@ load the parameters from the server certificate file. | |||
| 4043 | If this fails, a static set of parameters hard coded into the | 4081 | If this fails, a static set of parameters hard coded into the |
| 4044 | .Nm s_server | 4082 | .Nm s_server |
| 4045 | program will be used. | 4083 | program will be used. |
| 4046 | .It Fl hack | 4084 | .It Fl dtls1 |
| 4047 | Enables a further workaround for some early Netscape SSL code. | 4085 | Permit only DTLS1.0. |
| 4048 | .It Fl HTTP | 4086 | .It Fl HTTP |
| 4049 | Emulate a simple web server. | 4087 | Emulate a simple web server. |
| 4050 | Pages are resolved relative to the current directory. | 4088 | Pages are resolved relative to the current directory. |
| @@ -4065,14 +4103,34 @@ when each of which might be generating a unique range of session IDs. | |||
| 4065 | .It Fl key Ar keyfile | 4103 | .It Fl key Ar keyfile |
| 4066 | The private key to use. | 4104 | The private key to use. |
| 4067 | If not specified, the certificate file will be used. | 4105 | If not specified, the certificate file will be used. |
| 4106 | .It Fl key2 Ar keyfile | ||
| 4107 | The private key to use for servername. | ||
| 4108 | .It Fl keyform Cm der | pem | ||
| 4109 | The private key format. | ||
| 4110 | The default is | ||
| 4111 | .Cm pem . | ||
| 4112 | .It Fl keymatexport Ar label | ||
| 4113 | Export keying material using label. | ||
| 4114 | .It Fl keymatexportlen Ar len | ||
| 4115 | Export len bytes of keying material (default 20). | ||
| 4068 | .It Fl msg | 4116 | .It Fl msg |
| 4069 | Show all protocol messages with hex dump. | 4117 | Show all protocol messages with hex dump. |
| 4118 | .It Fl mtu Ar mtu | ||
| 4119 | Set the link layer MTU. | ||
| 4120 | .It Fl named_curve Ar arg | ||
| 4121 | Specify the elliptic curve name to use for ephemeral ECDH keys. | ||
| 4070 | .It Fl nbio | 4122 | .It Fl nbio |
| 4071 | Turn on non-blocking I/O. | 4123 | Turn on non-blocking I/O. |
| 4072 | .It Fl nbio_test | 4124 | .It Fl nbio_test |
| 4073 | Test non-blocking I/O. | 4125 | Test non-blocking I/O. |
| 4126 | .It Fl no_cache | ||
| 4127 | Disable session caching. | ||
| 4074 | .It Fl no_dhe | 4128 | .It Fl no_dhe |
| 4075 | Disable ephemeral DH cipher suites. | 4129 | Disable ephemeral DH cipher suites. |
| 4130 | .It Fl no_ecdhe | ||
| 4131 | Disable ephemeral ECDH cipher suites. | ||
| 4132 | .It Fl no_ticket | ||
| 4133 | Disable RFC 4507 session ticket support. | ||
| 4076 | .It Fl no_tls1 | no_tls1_1 | no_tls1_2 | 4134 | .It Fl no_tls1 | no_tls1_1 | no_tls1_2 |
| 4077 | Disable the use of TLS1.0, 1.1, and 1.2, respectively. | 4135 | Disable the use of TLS1.0, 1.1, and 1.2, respectively. |
| 4078 | .It Fl no_tmp_rsa | 4136 | .It Fl no_tmp_rsa |
| @@ -4081,24 +4139,42 @@ Disable temporary RSA key generation. | |||
| 4081 | Do not use a certificate. | 4139 | Do not use a certificate. |
| 4082 | This restricts the cipher suites available to the anonymous ones | 4140 | This restricts the cipher suites available to the anonymous ones |
| 4083 | (currently just anonymous DH). | 4141 | (currently just anonymous DH). |
| 4084 | .It Fl psk Ar key | 4142 | .It Fl pass Ar arg |
| 4085 | Use the PSK key | 4143 | The private key password source. |
| 4086 | .Ar key | ||
| 4087 | when using a PSK cipher suite. | ||
| 4088 | The key is given as a hexadecimal number without the leading 0x, | ||
| 4089 | for example -psk 1a2b3c4d. | ||
| 4090 | .It Fl psk_hint Ar hint | ||
| 4091 | Use the PSK identity hint | ||
| 4092 | .Ar hint | ||
| 4093 | when using a PSK cipher suite. | ||
| 4094 | .It Fl quiet | 4144 | .It Fl quiet |
| 4095 | Inhibit printing of session and certificate information. | 4145 | Inhibit printing of session and certificate information. |
| 4146 | .It Fl servername Ar name | ||
| 4147 | Set the TLS Server Name Indication (SNI) extension with | ||
| 4148 | .Ar name . | ||
| 4149 | .It Fl servername_fatal | ||
| 4150 | Send fatal alert if servername does not match. | ||
| 4151 | The default is warning alert. | ||
| 4096 | .It Fl serverpref | 4152 | .It Fl serverpref |
| 4097 | Use server's cipher preferences. | 4153 | Use server's cipher preferences. |
| 4098 | .It Fl state | 4154 | .It Fl state |
| 4099 | Print the SSL session states. | 4155 | Print the SSL session states. |
| 4156 | .It Fl status | ||
| 4157 | Enables certificate status request support (OCSP stapling). | ||
| 4158 | .It Fl status_timeout Ar nsec | ||
| 4159 | Sets the timeout for OCSP response in seconds. | ||
| 4160 | .It Fl status_url Ar url | ||
| 4161 | Sets a fallback responder URL to use if no responder URL is present in the | ||
| 4162 | server certificate. | ||
| 4163 | Without this option, an error is returned if the server certificate does not | ||
| 4164 | contain a responder address. | ||
| 4165 | .It Fl status_verbose | ||
| 4166 | Enables certificate status request support (OCSP stapling) and gives a verbose | ||
| 4167 | printout of the OCSP response. | ||
| 4168 | .It Fl timeout | ||
| 4169 | Enable send/receive timeout on DTLS connections. | ||
| 4100 | .It Fl tls1 | tls1_1 | tls1_2 | 4170 | .It Fl tls1 | tls1_1 | tls1_2 |
| 4101 | Permit only TLS1.0, 1.1, or 1.2, respectively. | 4171 | Permit only TLS1.0, 1.1, or 1.2, respectively. |
| 4172 | .It Fl tlsextdebug | ||
| 4173 | Print a hex dump of any TLS extensions received from the server. | ||
| 4174 | .It Fl use_srtp Ar profiles | ||
| 4175 | Offer SRTP key management with a colon-separated profile list. | ||
| 4176 | .It Fl verify_return_error | ||
| 4177 | Return verification error. | ||
| 4102 | .It Fl WWW | 4178 | .It Fl WWW |
| 4103 | Emulate a simple web server. | 4179 | Emulate a simple web server. |
| 4104 | Pages are resolved relative to the current directory. | 4180 | Pages are resolved relative to the current directory. |
