summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
Diffstat (limited to 'src')
-rw-r--r--src/lib/libssl/man/SSL_alert_type_string.375
1 files changed, 36 insertions, 39 deletions
diff --git a/src/lib/libssl/man/SSL_alert_type_string.3 b/src/lib/libssl/man/SSL_alert_type_string.3
index 0f051cc0a6..9d3c03555c 100644
--- a/src/lib/libssl/man/SSL_alert_type_string.3
+++ b/src/lib/libssl/man/SSL_alert_type_string.3
@@ -1,4 +1,4 @@
1.\" $OpenBSD: SSL_alert_type_string.3,v 1.8 2025/06/08 22:52:00 schwarze Exp $ 1.\" $OpenBSD: SSL_alert_type_string.3,v 1.9 2026/06/22 14:07:17 tb Exp $
2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100 2.\" OpenSSL b97fdb57 Nov 11 09:33:09 2016 +0100
3.\" 3.\"
4.\" This file was written by Lutz Jaenicke <jaenicke@openssl.org>. 4.\" This file was written by Lutz Jaenicke <jaenicke@openssl.org>.
@@ -48,7 +48,7 @@
48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED 48.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
49.\" OF THE POSSIBILITY OF SUCH DAMAGE. 49.\" OF THE POSSIBILITY OF SUCH DAMAGE.
50.\" 50.\"
51.Dd $Mdocdate: June 8 2025 $ 51.Dd $Mdocdate: June 22 2026 $
52.Dt SSL_ALERT_TYPE_STRING 3 52.Dt SSL_ALERT_TYPE_STRING 3
53.Os 53.Os
54.Sh NAME 54.Sh NAME
@@ -78,9 +78,8 @@ returns a string indicating the type of the alert specified by
78.Fa value . 78.Fa value .
79.Pp 79.Pp
80.Fn SSL_alert_desc_string 80.Fn SSL_alert_desc_string
81returns a two letter string as a short form describing the reason of the alert 81always returns the two letter string
82specified by 82.Qq !! .
83.Fa value .
84.Pp 83.Pp
85.Fn SSL_alert_desc_string_long 84.Fn SSL_alert_desc_string_long
86returns a string describing the reason of the alert specified by 85returns a string describing the reason of the alert specified by
@@ -114,9 +113,9 @@ The following strings can occur for
114or 113or
115.Fn SSL_alert_type_string_long : 114.Fn SSL_alert_type_string_long :
116.Bl -tag -width Ds 115.Bl -tag -width Ds
117.It \(dqW\(dq/\(dqwarning\(dq 116.It Qo W Qc Ns / Ns Qq warning
118.It \(dqF\(dq/\(dqfatal\(dq 117.It Qo F Qc Ns / Ns Qq fatal
119.It \(dqU\(dq/\(dqunknown\(dq 118.It Qo U Qc Ns / Ns Qq unknown
120This indicates that no support is available for this alert type. 119This indicates that no support is available for this alert type.
121Probably 120Probably
122.Fa value 121.Fa value
@@ -124,102 +123,100 @@ does not contain a correct alert message.
124.El 123.El
125.Pp 124.Pp
126The following strings can occur for 125The following strings can occur for
127.Fn SSL_alert_desc_string
128or
129.Fn SSL_alert_desc_string_long : 126.Fn SSL_alert_desc_string_long :
130.Bl -tag -width Ds 127.Bl -tag -width Ds
131.It \(dqCN\(dq/\(dqclose notify\(dq 128.It Qq close notify
132The connection shall be closed. 129The connection shall be closed.
133This is a warning alert. 130This is a warning alert.
134.It \(dqUM\(dq/\(dqunexpected message\(dq 131.It Qq unexpected message
135An inappropriate message was received. 132An inappropriate message was received.
136This alert is always fatal and should never be observed in communication 133This alert is always fatal and should never be observed in communication
137between proper implementations. 134between proper implementations.
138.It \(dqBM\(dq/\(dqbad record mac\(dq 135.It Qq bad record mac
139This alert is returned if a record is received with an incorrect MAC. 136This alert is returned if a record is received with an incorrect MAC.
140This message is always fatal. 137This message is always fatal.
141.It \(dqDF\(dq/\(dqdecompression failure\(dq 138.It Qq decompression failure
142The decompression function received improper input 139The decompression function received improper input
143(e.g., data that would expand to excessive length). 140(e.g., data that would expand to excessive length).
144This message is always fatal. 141This message is always fatal.
145.It \(dqHF\(dq/\(dqhandshake failure\(dq 142.It Qq handshake failure
146Reception of a handshake_failure alert message indicates that the sender was 143Reception of a handshake_failure alert message indicates that the sender was
147unable to negotiate an acceptable set of security parameters given the options 144unable to negotiate an acceptable set of security parameters given the options
148available. 145available.
149This is a fatal error. 146This is a fatal error.
150.It \(dqNC\(dq/\(dqno certificate\(dq 147.It Qq no certificate
151A client, that was asked to send a certificate, does not send a certificate 148A client, that was asked to send a certificate, does not send a certificate
152(SSLv3 only). 149(SSLv3 only).
153.It \(dqBC\(dq/\(dqbad certificate\(dq 150.It Qq bad certificate
154A certificate was corrupt, contained signatures that did not verify correctly, 151A certificate was corrupt, contained signatures that did not verify correctly,
155etc. 152etc.
156.It \(dqUC\(dq/\(dqunsupported certificate\(dq 153.It Qq unsupported certificate
157A certificate was of an unsupported type. 154A certificate was of an unsupported type.
158.It \(dqCR\(dq/\(dqcertificate revoked\(dq 155.It Qq certificate revoked
159A certificate was revoked by its signer. 156A certificate was revoked by its signer.
160.It \(dqCE\(dq/\(dqcertificate expired\(dq 157.It Qq certificate expired
161A certificate has expired or is not currently valid. 158A certificate has expired or is not currently valid.
162.It \(dqCU\(dq/\(dqcertificate unknown\(dq 159.It Qq certificate unknown
163Some other (unspecified) issue arose in processing the certificate, 160Some other (unspecified) issue arose in processing the certificate,
164rendering it unacceptable. 161rendering it unacceptable.
165.It \(dqIP\(dq/\(dqillegal parameter\(dq 162.It Qq illegal parameter
166A field in the handshake was out of range or inconsistent with other fields. 163A field in the handshake was out of range or inconsistent with other fields.
167This is always fatal. 164This is always fatal.
168.It \(dqDC\(dq/\(dqdecryption failed\(dq 165.It Qq decryption failed
169A TLSCiphertext decrypted in an invalid way: either it wasn't an even multiple 166A TLSCiphertext decrypted in an invalid way: either it wasn't an even multiple
170of the block length or its padding values, when checked, weren't correct. 167of the block length or its padding values, when checked, weren't correct.
171This message is always fatal. 168This message is always fatal.
172.It \(dqRO\(dq/\(dqrecord overflow\(dq 169.It Qq record overflow
173A TLSCiphertext record was received which had a length more than 170A TLSCiphertext record was received which had a length more than
1742^14+2048 bytes, or a record decrypted to a TLSCompressed record with more than 1712^14+2048 bytes, or a record decrypted to a TLSCompressed record with more than
1752^14+1024 bytes. 1722^14+1024 bytes.
176This message is always fatal. 173This message is always fatal.
177.It \(dqCA\(dq/\(dqunknown CA\(dq 174.It Qq unknown CA
178A valid certificate chain or partial chain was received, 175A valid certificate chain or partial chain was received,
179but the certificate was not accepted because the CA certificate could not be 176but the certificate was not accepted because the CA certificate could not be
180located or couldn't be matched with a known, trusted CA. 177located or couldn't be matched with a known, trusted CA.
181This message is always fatal. 178This message is always fatal.
182.It \(dqAD\(dq/\(dqaccess denied\(dq 179.It Qq access denied
183A valid certificate was received, but when access control was applied, 180A valid certificate was received, but when access control was applied,
184the sender decided not to proceed with negotiation. 181the sender decided not to proceed with negotiation.
185This message is always fatal. 182This message is always fatal.
186.It \(dqDE\(dq/\(dqdecode error\(dq 183.It Qq decode error
187A message could not be decoded because some field was out of the specified 184A message could not be decoded because some field was out of the specified
188range or the length of the message was incorrect. 185range or the length of the message was incorrect.
189This message is always fatal. 186This message is always fatal.
190.It \(dqCY\(dq/\(dqdecrypt error\(dq 187.It Qq decrypt error
191A handshake cryptographic operation failed, including being unable to correctly 188A handshake cryptographic operation failed, including being unable to correctly
192verify a signature, decrypt a key exchange, or validate a finished message. 189verify a signature, decrypt a key exchange, or validate a finished message.
193.It \(dqER\(dq/\(dqexport restriction\(dq 190.It Qq export restriction
194A negotiation not in compliance with export restrictions was detected; 191A negotiation not in compliance with export restrictions was detected;
195for example, attempting to transfer a 1024 bit ephemeral RSA key for the 192for example, attempting to transfer a 1024 bit ephemeral RSA key for the
196RSA_EXPORT handshake method. 193RSA_EXPORT handshake method.
197This message is always fatal. 194This message is always fatal.
198.It \(dqPV\(dq/\(dqprotocol version\(dq 195.It Qq protocol version
199The protocol version the client has attempted to negotiate is recognized, 196The protocol version the client has attempted to negotiate is recognized,
200but not supported. 197but not supported.
201(For example, old protocol versions might be avoided for security reasons.) 198(For example, old protocol versions might be avoided for security reasons.)
202This message is always fatal. 199This message is always fatal.
203.It \(dqIS\(dq/\(dqinsufficient security\(dq 200.It Qq insufficient security
204Returned instead of handshake_failure when a negotiation has failed 201Returned instead of handshake_failure when a negotiation has failed
205specifically because the server requires ciphers more secure than those 202specifically because the server requires ciphers more secure than those
206supported by the client. 203supported by the client.
207This message is always fatal. 204This message is always fatal.
208.It \(dqIE\(dq/\(dqinternal error\(dq 205.It Qq internal error
209An internal error unrelated to the peer or the correctness of the protocol 206An internal error unrelated to the peer or the correctness of the protocol
210makes it impossible to continue (such as a memory allocation failure). 207makes it impossible to continue (such as a memory allocation failure).
211This message is always fatal. 208This message is always fatal.
212.It \(dqIF\(dq/\(dqinappropriate fallback\(dq 209.It Qq inappropriate fallback
213Sent by a server in response to an invalid connection retry attempt from 210Sent by a server in response to an invalid connection retry attempt from
214a client (see RFC 7507). 211a client (see RFC 7507).
215.It \(dqUS\(dq/\(dquser canceled\(dq 212.It Qq user canceled
216This handshake is being canceled for some reason unrelated to a protocol 213This handshake is being canceled for some reason unrelated to a protocol
217failure. 214failure.
218If the user cancels an operation after the handshake is complete, 215If the user cancels an operation after the handshake is complete,
219just closing the connection by sending a close_notify is more appropriate. 216just closing the connection by sending a close_notify is more appropriate.
220This alert should be followed by a close_notify. 217This alert should be followed by a close_notify.
221This message is generally a warning. 218This message is generally a warning.
222.It \(dqNR\(dq/\(dqno renegotiation\(dq 219.It Qq no renegotiation
223Sent by the client in response to a hello request or by the server in response 220Sent by the client in response to a hello request or by the server in response
224to a client hello after initial handshaking. 221to a client hello after initial handshaking.
225Either of these would normally lead to renegotiation; when that is not 222Either of these would normally lead to renegotiation; when that is not
@@ -230,16 +227,16 @@ process to satisfy a request; the process might receive security parameters
230(key length, authentication, etc.) at startup and it might be difficult to 227(key length, authentication, etc.) at startup and it might be difficult to
231communicate changes to these parameters after that point. 228communicate changes to these parameters after that point.
232This message is always a warning. 229This message is always a warning.
233.It \(dqUP\(dq/\(dqunknown PSK identity\(dq 230.It Qq unknown PSK identity
234Sent by the server to indicate that it does not recognize a PSK identity or an 231Sent by the server to indicate that it does not recognize a PSK identity or an
235SRP identity. 232SRP identity.
236.It \(dqCQ\(dq/\(dqcertificate required\(dq 233.It Qq certificate required
237Sent by servers when a client certificate is desired but none was provided 234Sent by servers when a client certificate is desired but none was provided
238by the client. 235by the client.
239.It \(dqAP\(dq/\(dqno application protocol\(dq 236.It Qq no application protocol
240Sent by servers when a client ALPN extension advertises only protocols that 237Sent by servers when a client ALPN extension advertises only protocols that
241the server does not support (see RFC 7301). 238the server does not support (see RFC 7301).
242.It \(dqUK\(dq/\(dqunknown\(dq 239.It Qq unknown
243This indicates that no description is available for this alert type. 240This indicates that no description is available for this alert type.
244Probably 241Probably
245.Fa value 242.Fa value