summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorschwarze <>2023-06-08 09:40:17 +0000
committerschwarze <>2023-06-08 09:40:17 +0000
commitccc698d6521b756838b52dca551ee9cd47bdd283 (patch)
tree3eda705a11d0d1827114ebae71151bb978e1586f
parentd323186428a08aba14848a7b6be0daadfe582ffd (diff)
downloadopenbsd-ccc698d6521b756838b52dca551ee9cd47bdd283.tar.gz
openbsd-ccc698d6521b756838b52dca551ee9cd47bdd283.tar.bz2
openbsd-ccc698d6521b756838b52dca551ee9cd47bdd283.zip
From the description of "openssl verify", delete the duplicate and
outdated list of error messages. Instead, refer to the master copy of that list in X509_STORE_CTX_get_error(3). Suggested by and OK tb@, and beck@ also agrees with the idea.
-rw-r--r--src/usr.bin/openssl/openssl.1139
1 files changed, 9 insertions, 130 deletions
diff --git a/src/usr.bin/openssl/openssl.1 b/src/usr.bin/openssl/openssl.1
index 3005cdd2d8..45ae95fa5b 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.147 2023/06/07 10:53:30 schwarze Exp $ 1.\" $OpenBSD: openssl.1,v 1.148 2023/06/08 09:40:17 schwarze 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: June 7 2023 $ 113.Dd $Mdocdate: June 8 2023 $
114.Dt OPENSSL 1 114.Dt OPENSSL 1
115.Os 115.Os
116.Sh NAME 116.Sh NAME
@@ -6058,137 +6058,16 @@ error 24 at 1 depth lookup:invalid CA certificate
6058.Pp 6058.Pp
6059The first line contains the name of the certificate being verified, followed by 6059The first line contains the name of the certificate being verified, followed by
6060the subject name of the certificate. 6060the subject name of the certificate.
6061The second line contains the error number and the depth. 6061The second line contains the error number as defined by the
6062.Dv X509_V_ERR_*
6063constants in
6064.In openssl/x509_vfy.h ,
6065the associated error message documented in
6066.Xr X509_STORE_CTX_get_error 3 ,
6067and the depth.
6062The depth is the number of the certificate being verified when a 6068The depth is the number of the certificate being verified when a
6063problem was detected starting with zero for the certificate being verified 6069problem was detected starting with zero for the certificate being verified
6064itself, then 1 for the CA that signed the certificate and so on. 6070itself, then 1 for the CA that signed the certificate and so on.
6065Finally a text version of the error number is presented.
6066.Pp
6067An exhaustive list of the error codes and messages is shown below; this also
6068includes the name of the error code as defined in the header file
6069.In openssl/x509_vfy.h .
6070Some of the error codes are defined but never returned: these are described as
6071.Qq unused .
6072.Bl -tag -width "XXXX"
6073.It 0 X509_V_OK
6074The operation was successful.
6075.It 2 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT
6076The issuer certificate of an untrusted certificate could not be found.
6077.It 3 X509_V_ERR_UNABLE_TO_GET_CRL
6078The CRL of a certificate could not be found.
6079.It 4 X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE
6080The certificate signature could not be decrypted.
6081This means that the actual signature value could not be determined
6082rather than it not matching the expected value.
6083This is only meaningful for RSA keys.
6084.It 5 X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE
6085The CRL signature could not be decrypted.
6086This means that the actual signature value could not be determined
6087rather than it not matching the expected value.
6088Unused.
6089.It 6 X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY
6090The public key in the certificate
6091.Cm SubjectPublicKeyInfo
6092could not be read.
6093.It 7 X509_V_ERR_CERT_SIGNATURE_FAILURE
6094The signature of the certificate is invalid.
6095.It 8 X509_V_ERR_CRL_SIGNATURE_FAILURE
6096The signature of the certificate is invalid.
6097.It 9 X509_V_ERR_CERT_NOT_YET_VALID
6098The certificate is not yet valid: the
6099.Cm notBefore
6100date is after the current time.
6101.It 10 X509_V_ERR_CERT_HAS_EXPIRED
6102The certificate has expired; that is, the
6103.Cm notAfter
6104date is before the current time.
6105.It 11 X509_V_ERR_CRL_NOT_YET_VALID
6106The CRL is not yet valid.
6107.It 12 X509_V_ERR_CRL_HAS_EXPIRED
6108The CRL has expired.
6109.It 13 X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD
6110The certificate
6111.Cm notBefore
6112field contains an invalid time.
6113.It 14 X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD
6114The certificate
6115.Cm notAfter
6116field contains an invalid time.
6117.It 15 X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD
6118The CRL
6119.Cm thisUpdate
6120field contains an invalid time.
6121The error code is misnamed and the error message confusingly talks about
6122.Dq lastUpdate
6123instead of
6124.Dq thisUpdate
6125for historical reasons.
6126.It 16 X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD
6127The CRL
6128.Cm nextUpdate
6129field contains an invalid time.
6130.It 17 X509_V_ERR_OUT_OF_MEM
6131An error occurred trying to allocate memory.
6132This should never happen.
6133.It 18 X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT
6134The passed certificate is self-signed and the same certificate cannot be
6135found in the list of trusted certificates.
6136.It 19 X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN
6137The certificate chain could be built up using the untrusted certificates but
6138the root could not be found locally.
6139.It 20 X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY
6140The issuer certificate of a locally looked up certificate could not be found.
6141This normally means the list of trusted certificates is not complete.
6142.It 21 X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE
6143No signatures could be verified because the chain contains only one
6144certificate and it is not self-signed.
6145.It 22 X509_V_ERR_CERT_CHAIN_TOO_LONG
6146The certificate chain length is greater than the supplied maximum depth.
6147Unused.
6148.It 23 X509_V_ERR_CERT_REVOKED
6149The certificate has been revoked.
6150.It 24 X509_V_ERR_INVALID_CA
6151A CA certificate is invalid.
6152Either it is not a CA or its extensions are not consistent
6153with the supplied purpose.
6154.It 25 X509_V_ERR_PATH_LENGTH_EXCEEDED
6155The
6156.Cm basicConstraints
6157pathlength parameter has been exceeded.
6158.It 26 X509_V_ERR_INVALID_PURPOSE
6159The supplied certificate cannot be used for the specified purpose.
6160.It 27 X509_V_ERR_CERT_UNTRUSTED
6161The root CA is not marked as trusted for the specified purpose.
6162.It 28 X509_V_ERR_CERT_REJECTED
6163The root CA is marked to reject the specified purpose.
6164.It 29 X509_V_ERR_SUBJECT_ISSUER_MISMATCH
6165The current candidate issuer certificate was rejected because its subject name
6166did not match the issuer name of the current certificate.
6167Only displayed when the
6168.Fl issuer_checks
6169option is set.
6170.It 30 X509_V_ERR_AKID_SKID_MISMATCH
6171The current candidate issuer certificate was rejected because its subject key
6172identifier was present and did not match the authority key identifier current
6173certificate.
6174Only displayed when the
6175.Fl issuer_checks
6176option is set.
6177.It 31 X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH
6178The current candidate issuer certificate was rejected because its issuer name
6179and serial number were present and did not match the authority key identifier
6180of the current certificate.
6181Only displayed when the
6182.Fl issuer_checks
6183option is set.
6184.It 32 X509_V_ERR_KEYUSAGE_NO_CERTSIGN
6185The current candidate issuer certificate was rejected because its
6186.Cm keyUsage
6187extension does not permit certificate signing.
6188.It 50 X509_V_ERR_APPLICATION_VERIFICATION
6189An application specific error.
6190Unused.
6191.El
6192.Tg version 6071.Tg version
6193.Sh VERSION 6072.Sh VERSION
6194.Nm openssl version 6073.Nm openssl version