diff options
Diffstat (limited to 'src')
| -rw-r--r-- | src/lib/libssl/man/SSL_alert_type_string.3 | 75 |
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 |
| 81 | returns a two letter string as a short form describing the reason of the alert | 81 | always returns the two letter string |
| 82 | specified by | 82 | .Qq !! . |
| 83 | .Fa value . | ||
| 84 | .Pp | 83 | .Pp |
| 85 | .Fn SSL_alert_desc_string_long | 84 | .Fn SSL_alert_desc_string_long |
| 86 | returns a string describing the reason of the alert specified by | 85 | returns a string describing the reason of the alert specified by |
| @@ -114,9 +113,9 @@ The following strings can occur for | |||
| 114 | or | 113 | or |
| 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 |
| 120 | This indicates that no support is available for this alert type. | 119 | This indicates that no support is available for this alert type. |
| 121 | Probably | 120 | Probably |
| 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 |
| 126 | The following strings can occur for | 125 | The following strings can occur for |
| 127 | .Fn SSL_alert_desc_string | ||
| 128 | or | ||
| 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 |
| 132 | The connection shall be closed. | 129 | The connection shall be closed. |
| 133 | This is a warning alert. | 130 | This is a warning alert. |
| 134 | .It \(dqUM\(dq/\(dqunexpected message\(dq | 131 | .It Qq unexpected message |
| 135 | An inappropriate message was received. | 132 | An inappropriate message was received. |
| 136 | This alert is always fatal and should never be observed in communication | 133 | This alert is always fatal and should never be observed in communication |
| 137 | between proper implementations. | 134 | between proper implementations. |
| 138 | .It \(dqBM\(dq/\(dqbad record mac\(dq | 135 | .It Qq bad record mac |
| 139 | This alert is returned if a record is received with an incorrect MAC. | 136 | This alert is returned if a record is received with an incorrect MAC. |
| 140 | This message is always fatal. | 137 | This message is always fatal. |
| 141 | .It \(dqDF\(dq/\(dqdecompression failure\(dq | 138 | .It Qq decompression failure |
| 142 | The decompression function received improper input | 139 | The 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). |
| 144 | This message is always fatal. | 141 | This message is always fatal. |
| 145 | .It \(dqHF\(dq/\(dqhandshake failure\(dq | 142 | .It Qq handshake failure |
| 146 | Reception of a handshake_failure alert message indicates that the sender was | 143 | Reception of a handshake_failure alert message indicates that the sender was |
| 147 | unable to negotiate an acceptable set of security parameters given the options | 144 | unable to negotiate an acceptable set of security parameters given the options |
| 148 | available. | 145 | available. |
| 149 | This is a fatal error. | 146 | This is a fatal error. |
| 150 | .It \(dqNC\(dq/\(dqno certificate\(dq | 147 | .It Qq no certificate |
| 151 | A client, that was asked to send a certificate, does not send a certificate | 148 | A 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 |
| 154 | A certificate was corrupt, contained signatures that did not verify correctly, | 151 | A certificate was corrupt, contained signatures that did not verify correctly, |
| 155 | etc. | 152 | etc. |
| 156 | .It \(dqUC\(dq/\(dqunsupported certificate\(dq | 153 | .It Qq unsupported certificate |
| 157 | A certificate was of an unsupported type. | 154 | A certificate was of an unsupported type. |
| 158 | .It \(dqCR\(dq/\(dqcertificate revoked\(dq | 155 | .It Qq certificate revoked |
| 159 | A certificate was revoked by its signer. | 156 | A certificate was revoked by its signer. |
| 160 | .It \(dqCE\(dq/\(dqcertificate expired\(dq | 157 | .It Qq certificate expired |
| 161 | A certificate has expired or is not currently valid. | 158 | A certificate has expired or is not currently valid. |
| 162 | .It \(dqCU\(dq/\(dqcertificate unknown\(dq | 159 | .It Qq certificate unknown |
| 163 | Some other (unspecified) issue arose in processing the certificate, | 160 | Some other (unspecified) issue arose in processing the certificate, |
| 164 | rendering it unacceptable. | 161 | rendering it unacceptable. |
| 165 | .It \(dqIP\(dq/\(dqillegal parameter\(dq | 162 | .It Qq illegal parameter |
| 166 | A field in the handshake was out of range or inconsistent with other fields. | 163 | A field in the handshake was out of range or inconsistent with other fields. |
| 167 | This is always fatal. | 164 | This is always fatal. |
| 168 | .It \(dqDC\(dq/\(dqdecryption failed\(dq | 165 | .It Qq decryption failed |
| 169 | A TLSCiphertext decrypted in an invalid way: either it wasn't an even multiple | 166 | A TLSCiphertext decrypted in an invalid way: either it wasn't an even multiple |
| 170 | of the block length or its padding values, when checked, weren't correct. | 167 | of the block length or its padding values, when checked, weren't correct. |
| 171 | This message is always fatal. | 168 | This message is always fatal. |
| 172 | .It \(dqRO\(dq/\(dqrecord overflow\(dq | 169 | .It Qq record overflow |
| 173 | A TLSCiphertext record was received which had a length more than | 170 | A TLSCiphertext record was received which had a length more than |
| 174 | 2^14+2048 bytes, or a record decrypted to a TLSCompressed record with more than | 171 | 2^14+2048 bytes, or a record decrypted to a TLSCompressed record with more than |
| 175 | 2^14+1024 bytes. | 172 | 2^14+1024 bytes. |
| 176 | This message is always fatal. | 173 | This message is always fatal. |
| 177 | .It \(dqCA\(dq/\(dqunknown CA\(dq | 174 | .It Qq unknown CA |
| 178 | A valid certificate chain or partial chain was received, | 175 | A valid certificate chain or partial chain was received, |
| 179 | but the certificate was not accepted because the CA certificate could not be | 176 | but the certificate was not accepted because the CA certificate could not be |
| 180 | located or couldn't be matched with a known, trusted CA. | 177 | located or couldn't be matched with a known, trusted CA. |
| 181 | This message is always fatal. | 178 | This message is always fatal. |
| 182 | .It \(dqAD\(dq/\(dqaccess denied\(dq | 179 | .It Qq access denied |
| 183 | A valid certificate was received, but when access control was applied, | 180 | A valid certificate was received, but when access control was applied, |
| 184 | the sender decided not to proceed with negotiation. | 181 | the sender decided not to proceed with negotiation. |
| 185 | This message is always fatal. | 182 | This message is always fatal. |
| 186 | .It \(dqDE\(dq/\(dqdecode error\(dq | 183 | .It Qq decode error |
| 187 | A message could not be decoded because some field was out of the specified | 184 | A message could not be decoded because some field was out of the specified |
| 188 | range or the length of the message was incorrect. | 185 | range or the length of the message was incorrect. |
| 189 | This message is always fatal. | 186 | This message is always fatal. |
| 190 | .It \(dqCY\(dq/\(dqdecrypt error\(dq | 187 | .It Qq decrypt error |
| 191 | A handshake cryptographic operation failed, including being unable to correctly | 188 | A handshake cryptographic operation failed, including being unable to correctly |
| 192 | verify a signature, decrypt a key exchange, or validate a finished message. | 189 | verify a signature, decrypt a key exchange, or validate a finished message. |
| 193 | .It \(dqER\(dq/\(dqexport restriction\(dq | 190 | .It Qq export restriction |
| 194 | A negotiation not in compliance with export restrictions was detected; | 191 | A negotiation not in compliance with export restrictions was detected; |
| 195 | for example, attempting to transfer a 1024 bit ephemeral RSA key for the | 192 | for example, attempting to transfer a 1024 bit ephemeral RSA key for the |
| 196 | RSA_EXPORT handshake method. | 193 | RSA_EXPORT handshake method. |
| 197 | This message is always fatal. | 194 | This message is always fatal. |
| 198 | .It \(dqPV\(dq/\(dqprotocol version\(dq | 195 | .It Qq protocol version |
| 199 | The protocol version the client has attempted to negotiate is recognized, | 196 | The protocol version the client has attempted to negotiate is recognized, |
| 200 | but not supported. | 197 | but 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.) |
| 202 | This message is always fatal. | 199 | This message is always fatal. |
| 203 | .It \(dqIS\(dq/\(dqinsufficient security\(dq | 200 | .It Qq insufficient security |
| 204 | Returned instead of handshake_failure when a negotiation has failed | 201 | Returned instead of handshake_failure when a negotiation has failed |
| 205 | specifically because the server requires ciphers more secure than those | 202 | specifically because the server requires ciphers more secure than those |
| 206 | supported by the client. | 203 | supported by the client. |
| 207 | This message is always fatal. | 204 | This message is always fatal. |
| 208 | .It \(dqIE\(dq/\(dqinternal error\(dq | 205 | .It Qq internal error |
| 209 | An internal error unrelated to the peer or the correctness of the protocol | 206 | An internal error unrelated to the peer or the correctness of the protocol |
| 210 | makes it impossible to continue (such as a memory allocation failure). | 207 | makes it impossible to continue (such as a memory allocation failure). |
| 211 | This message is always fatal. | 208 | This message is always fatal. |
| 212 | .It \(dqIF\(dq/\(dqinappropriate fallback\(dq | 209 | .It Qq inappropriate fallback |
| 213 | Sent by a server in response to an invalid connection retry attempt from | 210 | Sent by a server in response to an invalid connection retry attempt from |
| 214 | a client (see RFC 7507). | 211 | a client (see RFC 7507). |
| 215 | .It \(dqUS\(dq/\(dquser canceled\(dq | 212 | .It Qq user canceled |
| 216 | This handshake is being canceled for some reason unrelated to a protocol | 213 | This handshake is being canceled for some reason unrelated to a protocol |
| 217 | failure. | 214 | failure. |
| 218 | If the user cancels an operation after the handshake is complete, | 215 | If the user cancels an operation after the handshake is complete, |
| 219 | just closing the connection by sending a close_notify is more appropriate. | 216 | just closing the connection by sending a close_notify is more appropriate. |
| 220 | This alert should be followed by a close_notify. | 217 | This alert should be followed by a close_notify. |
| 221 | This message is generally a warning. | 218 | This message is generally a warning. |
| 222 | .It \(dqNR\(dq/\(dqno renegotiation\(dq | 219 | .It Qq no renegotiation |
| 223 | Sent by the client in response to a hello request or by the server in response | 220 | Sent by the client in response to a hello request or by the server in response |
| 224 | to a client hello after initial handshaking. | 221 | to a client hello after initial handshaking. |
| 225 | Either of these would normally lead to renegotiation; when that is not | 222 | Either 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 |
| 231 | communicate changes to these parameters after that point. | 228 | communicate changes to these parameters after that point. |
| 232 | This message is always a warning. | 229 | This message is always a warning. |
| 233 | .It \(dqUP\(dq/\(dqunknown PSK identity\(dq | 230 | .It Qq unknown PSK identity |
| 234 | Sent by the server to indicate that it does not recognize a PSK identity or an | 231 | Sent by the server to indicate that it does not recognize a PSK identity or an |
| 235 | SRP identity. | 232 | SRP identity. |
| 236 | .It \(dqCQ\(dq/\(dqcertificate required\(dq | 233 | .It Qq certificate required |
| 237 | Sent by servers when a client certificate is desired but none was provided | 234 | Sent by servers when a client certificate is desired but none was provided |
| 238 | by the client. | 235 | by the client. |
| 239 | .It \(dqAP\(dq/\(dqno application protocol\(dq | 236 | .It Qq no application protocol |
| 240 | Sent by servers when a client ALPN extension advertises only protocols that | 237 | Sent by servers when a client ALPN extension advertises only protocols that |
| 241 | the server does not support (see RFC 7301). | 238 | the server does not support (see RFC 7301). |
| 242 | .It \(dqUK\(dq/\(dqunknown\(dq | 239 | .It Qq unknown |
| 243 | This indicates that no description is available for this alert type. | 240 | This indicates that no description is available for this alert type. |
| 244 | Probably | 241 | Probably |
| 245 | .Fa value | 242 | .Fa value |
