doc/man1/openssl-verify.pod

   1 =pod
   2
   3 =head1 NAME
   4
   5 openssl-verify - Utility to verify certificates
   6
   7 =head1 SYNOPSIS
   8
   9 B<openssl> B<verify>
  10 [B<-help>]
  11 [B<-CAfile> I<file>]
  12 [B<-CApath> I<directory>]
  13 [B<-no-CAfile>]
  14 [B<-no-CApath>]
  15 [B<-allow_proxy_certs>]
  16 [B<-attime> I<timestamp>]
  17 [B<-check_ss_sig>]
  18 [B<-CRLfile> I<file>]
  19 [B<-crl_download>]
  20 [B<-crl_check>]
  21 [B<-crl_check_all>]
  22 [B<-engine> I<id>]
  23 [B<-explicit_policy>]
  24 [B<-extended_crl>]
  25 [B<-ignore_critical>]
  26 [B<-inhibit_any>]
  27 [B<-inhibit_map>]
  28 [B<-nameopt> I<option>]
  29 [B<-no_check_time>]
  30 [B<-partial_chain>]
  31 [B<-policy> I<arg>]
  32 [B<-policy_check>]
  33 [B<-policy_print>]
  34 [B<-purpose> I<purpose>]
  35 [B<-suiteB_128>]
  36 [B<-suiteB_128_only>]
  37 [B<-suiteB_192>]
  38 [B<-trusted_first>]
  39 [B<-no_alt_chains>]
  40 [B<-untrusted> I<file>]
  41 [B<-trusted> I<file>]
  42 [B<-use_deltas>]
  43 [B<-verbose>]
  44 [B<-auth_level> I<level>]
  45 [B<-verify_depth> I<num>]
  46 [B<-verify_email> I<email>]
  47 [B<-verify_hostname> I<hostname>]
  48 [B<-verify_ip> I<ip>]
  49 [B<-verify_name> I<name>]
  50 [B<-x509_strict>]
  51 [B<-show_chain>]
  52 [B<-sm2-id> I<string>]
  53 [B<-sm2-hex-id> I<hex-string>]
  54 [B<-->]
  55 [I<certificate> ...]
  56
  57 =for comment ifdef engine sm2-id sm2-hex-id
  58
  59 =head1 DESCRIPTION
  60
  61 This command verifies certificate chains.
  62
  63 =head1 OPTIONS
  64
  65 =over 4
  66
  67 =item B<-help>
  68
  69 Print out a usage message.
  70
  71 =item B<-CAfile> I<file>
  72
  73 A I<file> of trusted certificates.
  74 The file should contain one or more certificates in PEM format.
  75
  76 =item B<-CApath> I<directory>
  77
  78 A directory of trusted certificates. The certificates should have names
  79 of the form: F<I<hash>.0> or have symbolic links to them of this form
  80 (I<hash> is the hashed certificate subject name: see the L<openssl-x509(1)>
  81 B<-hash> option). Under Unix, L<openssl-rehash(1)> will automatically create
  82 symbolic links to a directory of certificates.
  83
  84 =item B<-no-CAfile>
  85
  86 Do not load the trusted CA certificates from the default file location.
  87
  88 =item B<-no-CApath>
  89
  90 Do not load the trusted CA certificates from the default directory location.
  91
  92 =item B<-allow_proxy_certs>
  93
  94 Allow the verification of proxy certificates.
  95
  96 =item B<-attime> I<timestamp>
  97
  98 Perform validation checks using time specified by I<timestamp> and not
  99 current system time. I<timestamp> is the number of seconds since
 100 01.01.1970 (UNIX time).
 101
 102 =item B<-check_ss_sig>
 103
 104 Verify the signature on the self-signed root CA. This is disabled by default
 105 because it doesn't add any security.
 106
 107 =item B<-CRLfile> I<file>
 108
 109 The I<file> should contain one or more CRLs in PEM format.
 110 This option can be specified more than once to include CRLs from multiple
 111 I<file>s.
 112
 113 =item B<-crl_download>
 114
 115 Attempt to download CRL information for this certificate.
 116
 117 =item B<-crl_check>
 118
 119 Checks end entity certificate validity by attempting to look up a valid CRL.
 120 If a valid CRL cannot be found an error occurs.
 121
 122 =item B<-crl_check_all>
 123
 124 Checks the validity of B<all> certificates in the chain by attempting
 125 to look up valid CRLs.
 126
 127 =item B<-engine> I<id>
 128
 129 Specifying an engine I<id> will cause this command to attempt to load the
 130 specified engine.
 131 The engine will then be set as the default for all its supported algorithms.
 132 If you want to load certificates or CRLs that require engine support via any of
 133 the B<-trusted>, B<-untrusted> or B<-CRLfile> options, the B<-engine> option
 134 must be specified before those options.
 135
 136 =item B<-explicit_policy>
 137
 138 Set policy variable require-explicit-policy (see RFC5280).
 139
 140 =item B<-extended_crl>
 141
 142 Enable extended CRL features such as indirect CRLs and alternate CRL
 143 signing keys.
 144
 145 =item B<-ignore_critical>
 146
 147 Normally if an unhandled critical extension is present which is not
 148 supported by OpenSSL the certificate is rejected (as required by RFC5280).
 149 If this option is set critical extensions are ignored.
 150
 151 =item B<-inhibit_any>
 152
 153 Set policy variable inhibit-any-policy (see RFC5280).
 154
 155 =item B<-inhibit_map>
 156
 157 Set policy variable inhibit-policy-mapping (see RFC5280).
 158
 159 =item B<-nameopt> I<option>
 160
 161 Option which determines how the subject or issuer names are displayed. The
 162 I<option> argument can be a single option or multiple options separated by
 163 commas.  Alternatively the B<-nameopt> switch may be used more than once to
 164 set multiple options. See the L<x509(1)> manual page for details.
 165
 166 =item B<-no_check_time>
 167
 168 This option suppresses checking the validity period of certificates and CRLs
 169 against the current time. If option B<-attime> is used to specify
 170 a verification time, the check is not suppressed.
 171
 172 =item B<-partial_chain>
 173
 174 Allow verification to succeed even if a I<complete> chain cannot be built to a
 175 self-signed trust-anchor, provided it is possible to construct a chain to a
 176 trusted certificate that might not be self-signed.
 177
 178 =item B<-policy> I<arg>
 179
 180 Enable policy processing and add I<arg> to the user-initial-policy-set (see
 181 RFC5280). The policy I<arg> can be an object name an OID in numeric form.
 182 This argument can appear more than once.
 183
 184 =item B<-policy_check>
 185
 186 Enables certificate policy processing.
 187
 188 =item B<-policy_print>
 189
 190 Print out diagnostics related to policy processing.
 191
 192 =item B<-purpose> I<purpose>
 193
 194 The intended use for the certificate. If this option is not specified,
 195 this command will not consider certificate purpose during chain
 196 verification.
 197 Currently accepted uses are B<sslclient>, B<sslserver>, B<nssslserver>,
 198 B<smimesign>, B<smimeencrypt>. See the L</VERIFY OPERATION> section for more
 199 information.
 200
 201 =item B<-suiteB_128_only>, B<-suiteB_128>, B<-suiteB_192>
 202
 203 Enable the Suite B mode operation at 128 bit Level of Security, 128 bit or
 204 192 bit, or only 192 bit Level of Security respectively.
 205 See RFC6460 for details. In particular the supported signature algorithms are
 206 reduced to support only ECDSA and SHA256 or SHA384 and only the elliptic curves
 207 P-256 and P-384.
 208
 209 =item B<-trusted_first>
 210
 211 When constructing the certificate chain, use the trusted certificates specified
 212 via B<-CAfile>, B<-CApath> or B<-trusted> before any certificates specified via
 213 B<-untrusted>.
 214 This can be useful in environments with Bridge or Cross-Certified CAs.
 215 As of OpenSSL 1.1.0 this option is on by default and cannot be disabled.
 216
 217 =item B<-no_alt_chains>
 218
 219 By default, unless B<-trusted_first> is specified, when building a certificate
 220 chain, if the first certificate chain found is not trusted, then OpenSSL will
 221 attempt to replace untrusted issuer certificates with certificates from the
 222 trust store to see if an alternative chain can be found that is trusted.
 223 As of OpenSSL 1.1.0, with B<-trusted_first> always on, this option has no
 224 effect.
 225
 226 =item B<-untrusted> I<file>
 227
 228 A I<file> of additional untrusted certificates (intermediate issuer CAs) used
 229 to construct a certificate chain from the subject certificate to a trust-anchor.
 230 The I<file> should contain one or more certificates in PEM format.
 231 This option can be specified more than once to include untrusted certificates
 232 from multiple I<file>s.
 233
 234 =item B<-trusted> I<file>
 235
 236 A I<file> of trusted certificates, which must be self-signed, unless the
 237 B<-partial_chain> option is specified.
 238 The I<file> contains one or more certificates in PEM format.
 239 With this option, no additional (e.g., default) certificate lists are
 240 consulted.
 241 That is, the only trust-anchors are those listed in I<file>.
 242 This option can be specified more than once to include trusted certificates
 243 from multiple I<file>s.
 244 This option implies the B<-no-CAfile> and B<-no-CApath> options.
 245 This option cannot be used in combination with either of the B<-CAfile> or
 246 B<-CApath> options.
 247
 248 =item B<-use_deltas>
 249
 250 Enable support for delta CRLs.
 251
 252 =item B<-verbose>
 253
 254 Print extra information about the operations being performed.
 255
 256 =item B<-auth_level> I<level>
 257
 258 Set the certificate chain authentication security level to I<level>.
 259 The authentication security level determines the acceptable signature and
 260 public key strength when verifying certificate chains.
 261 For a certificate chain to validate, the public keys of all the certificates
 262 must meet the specified security I<level>.
 263 The signature algorithm security level is enforced for all the certificates in
 264 the chain except for the chain's I<trust anchor>, which is either directly
 265 trusted or validated by means other than its signature.
 266 See L<SSL_CTX_set_security_level(3)> for the definitions of the available
 267 levels.
 268 The default security level is -1, or "not set".
 269 At security level 0 or lower all algorithms are acceptable.
 270 Security level 1 requires at least 80-bit-equivalent security and is broadly
 271 interoperable, though it will, for example, reject MD5 signatures or RSA keys
 272 shorter than 1024 bits.
 273
 274 =item B<-verify_depth> I<num>
 275
 276 Limit the certificate chain to I<num> intermediate CA certificates.
 277 A maximal depth chain can have up to I<num>+2 certificates, since neither the
 278 end-entity certificate nor the trust-anchor certificate count against the
 279 B<-verify_depth> limit.
 280
 281 =item B<-verify_email> I<email>
 282
 283 Verify if I<email> matches the email address in Subject Alternative Name or
 284 the email in the subject Distinguished Name.
 285
 286 =item B<-verify_hostname> I<hostname>
 287
 288 Verify if I<hostname> matches DNS name in Subject Alternative Name or
 289 Common Name in the subject certificate.
 290
 291 =item B<-verify_ip> I<ip>
 292
 293 Verify if I<ip> matches the IP address in Subject Alternative Name of
 294 the subject certificate.
 295
 296 =item B<-verify_name> I<name>
 297
 298 Use default verification policies like trust model and required certificate
 299 policies identified by I<name>.
 300 The trust model determines which auxiliary trust or reject OIDs are applicable
 301 to verifying the given certificate chain.
 302 See the B<-addtrust> and B<-addreject> options for L<openssl-x509(1)>.
 303 Supported policy names include: B<default>, B<pkcs7>, B<smime_sign>,
 304 B<ssl_client>, B<ssl_server>.
 305 These mimics the combinations of purpose and trust settings used in SSL, CMS
 306 and S/MIME.
 307 As of OpenSSL 1.1.0, the trust model is inferred from the purpose when not
 308 specified, so the B<-verify_name> options are functionally equivalent to the
 309 corresponding B<-purpose> settings.
 310
 311 =item B<-x509_strict>
 312
 313 For strict X.509 compliance, disable non-compliant workarounds for broken
 314 certificates.
 315
 316 =item B<-show_chain>
 317
 318 Display information about the certificate chain that has been built (if
 319 successful). Certificates in the chain that came from the untrusted list will be
 320 flagged as "untrusted".
 321
 322 =item B<-sm2-id>
 323
 324 Specify the ID string to use when verifying an SM2 certificate. The ID string is
 325 required by the SM2 signature algorithm for signing and verification.
 326
 327 =item B<-sm2-hex-id>
 328
 329 Specify a binary ID string to use when signing or verifying using an SM2
 330 certificate. The argument for this option is string of hexadecimal digits.
 331
 332 =item B<-->
 333
 334 Indicates the last option. All arguments following this are assumed to be
 335 certificate files. This is useful if the first certificate filename begins
 336 with a B<->.
 337
 338 =item I<certificate> ...
 339
 340 One or more certificates to verify. If no certificates are given,
 341 this command will attempt to read a certificate from standard input.
 342 Certificates must be in PEM format.
 343
 344 =back
 345
 346 =head1 VERIFY OPERATION
 347
 348 This command uses the same functions as the internal SSL
 349 and S/MIME verification, therefore this description applies to these verify
 350 operations too.
 351
 352 There is one crucial difference between the verify operations performed
 353 by this command: wherever possible an attempt is made to
 354 continue after an error whereas normally the verify operation would halt on
 355 the first error. This allows all the problems with a certificate chain to be
 356 determined.
 357
 358 The verify operation consists of a number of separate steps.
 359
 360 Firstly a certificate chain is built up starting from the supplied certificate
 361 and ending in the root CA.
 362 It is an error if the whole chain cannot be built up.
 363 The chain is built up by looking up the issuers certificate of the current
 364 certificate.
 365 If a certificate is found which is its own issuer it is assumed to be the root
 366 CA.
 367
 368 The process of 'looking up the issuers certificate' itself involves a number of
 369 steps.
 370 After all certificates whose subject name matches the issuer name of the current
 371 certificate are subject to further tests.
 372 The relevant authority key identifier components of the current certificate (if
 373 present) must match the subject key identifier (if present) and issuer and
 374 serial number of the candidate issuer, in addition the keyUsage extension of
 375 the candidate issuer (if present) must permit certificate signing.
 376
 377 The lookup first looks in the list of untrusted certificates and if no match
 378 is found the remaining lookups are from the trusted certificates. The root CA
 379 is always looked up in the trusted certificate list: if the certificate to
 380 verify is a root certificate then an exact match must be found in the trusted
 381 list.
 382
 383 The second operation is to check every untrusted certificate's extensions for
 384 consistency with the supplied purpose. If the B<-purpose> option is not included
 385 then no checks are done. The supplied or "leaf" certificate must have extensions
 386 compatible with the supplied purpose and all other certificates must also be
 387 valid CA certificates. The precise extensions required are described in more
 388 detail in L<openssl-x509(1)/CERTIFICATE EXTENSIONS>.
 389
 390 The third operation is to check the trust settings on the root CA. The root CA
 391 should be trusted for the supplied purpose.
 392 For compatibility with previous versions of OpenSSL, a certificate with no
 393 trust settings is considered to be valid for all purposes.
 394
 395 The final operation is to check the validity of the certificate chain. The
 396 validity period is checked against the current system time and the notBefore
 397 and notAfter dates in the certificate. The certificate signatures are also
 398 checked at this point.
 399
 400 If all operations complete successfully then certificate is considered valid. If
 401 any operation fails then the certificate is not valid.
 402
 403 =head1 DIAGNOSTICS
 404
 405 When a verify operation fails the output messages can be somewhat cryptic. The
 406 general form of the error message is:
 407
 408  server.pem: /C=AU/ST=Queensland/O=CryptSoft Pty Ltd/CN=Test CA (1024 bit)
 409  error 24 at 1 depth lookup:invalid CA certificate
 410
 411 The first line contains the name of the certificate being verified followed by
 412 the subject name of the certificate. The second line contains the error number
 413 and the depth. The depth is number of the certificate being verified when a
 414 problem was detected starting with zero for the certificate being verified itself
 415 then 1 for the CA that signed the certificate and so on. Finally a text version
 416 of the error number is presented.
 417
 418 A partial list of the error codes and messages is shown below, this also
 419 includes the name of the error code as defined in the header file
 420 F<< <openssl/x509_vfy.h> >>.
 421 Some of the error codes are defined but never returned: these are described
 422 as "unused".
 423
 424 =over 4
 425
 426 =item B<X509_V_OK>
 427
 428 The operation was successful.
 429
 430 =item B<X509_V_ERR_UNSPECIFIED>
 431
 432 Unspecified error; should not happen.
 433
 434 =item B<X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT>
 435
 436 The issuer certificate of a looked up certificate could not be found. This
 437 normally means the list of trusted certificates is not complete.
 438
 439 =item B<X509_V_ERR_UNABLE_TO_GET_CRL>
 440
 441 The CRL of a certificate could not be found.
 442
 443 =item B<X509_V_ERR_UNABLE_TO_DECRYPT_CERT_SIGNATURE>
 444
 445 The certificate signature could not be decrypted. This means that the
 446 actual signature value could not be determined rather than it not matching
 447 the expected value, this is only meaningful for RSA keys.
 448
 449 =item B<X509_V_ERR_UNABLE_TO_DECRYPT_CRL_SIGNATURE>
 450
 451 The CRL signature could not be decrypted: this means that the actual
 452 signature value could not be determined rather than it not matching the
 453 expected value. Unused.
 454
 455 =item B<X509_V_ERR_UNABLE_TO_DECODE_ISSUER_PUBLIC_KEY>
 456
 457 The public key in the certificate SubjectPublicKeyInfo could not be read.
 458
 459 =item B<X509_V_ERR_CERT_SIGNATURE_FAILURE>
 460
 461 The signature of the certificate is invalid.
 462
 463 =item B<X509_V_ERR_CRL_SIGNATURE_FAILURE>
 464
 465 The signature of the certificate is invalid.
 466
 467 =item B<X509_V_ERR_CERT_NOT_YET_VALID>
 468
 469 The certificate is not yet valid: the notBefore date is after the
 470 current time.
 471
 472 =item B<X509_V_ERR_CERT_HAS_EXPIRED>
 473
 474 The certificate has expired: that is the notAfter date is before the
 475 current time.
 476
 477 =item B<X509_V_ERR_CRL_NOT_YET_VALID>
 478
 479 The CRL is not yet valid.
 480
 481 =item B<X509_V_ERR_CRL_HAS_EXPIRED>
 482
 483 The CRL has expired.
 484
 485 =item B<X509_V_ERR_ERROR_IN_CERT_NOT_BEFORE_FIELD>
 486
 487 The certificate notBefore field contains an invalid time.
 488
 489 =item B<X509_V_ERR_ERROR_IN_CERT_NOT_AFTER_FIELD>
 490
 491 The certificate notAfter field contains an invalid time.
 492
 493 =item B<X509_V_ERR_ERROR_IN_CRL_LAST_UPDATE_FIELD>
 494
 495 The CRL lastUpdate field contains an invalid time.
 496
 497 =item B<X509_V_ERR_ERROR_IN_CRL_NEXT_UPDATE_FIELD>
 498
 499 The CRL nextUpdate field contains an invalid time.
 500
 501 =item B<X509_V_ERR_OUT_OF_MEM>
 502
 503 An error occurred trying to allocate memory. This should never happen.
 504
 505 =item B<X509_V_ERR_DEPTH_ZERO_SELF_SIGNED_CERT>
 506
 507 The passed certificate is self-signed and the same certificate cannot
 508 be found in the list of trusted certificates.
 509
 510 =item B<X509_V_ERR_SELF_SIGNED_CERT_IN_CHAIN>
 511
 512 The certificate chain could be built up using the untrusted certificates
 513 but the root could not be found locally.
 514
 515 =item B<X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY>
 516
 517 The issuer certificate could not be found: this occurs if the issuer
 518 certificate of an untrusted certificate cannot be found.
 519
 520 =item B<X509_V_ERR_UNABLE_TO_VERIFY_LEAF_SIGNATURE>
 521
 522 No signatures could be verified because the chain contains only one
 523 certificate and it is not self signed.
 524
 525 =item B<X509_V_ERR_CERT_CHAIN_TOO_LONG>
 526
 527 The certificate chain length is greater than the supplied maximum
 528 depth. Unused.
 529
 530 =item B<X509_V_ERR_CERT_REVOKED>
 531
 532 The certificate has been revoked.
 533
 534 =item B<X509_V_ERR_INVALID_CA>
 535
 536 A CA certificate is invalid. Either it is not a CA or its extensions
 537 are not consistent with the supplied purpose.
 538
 539 =item B<X509_V_ERR_PATH_LENGTH_EXCEEDED>
 540
 541 The basicConstraints pathlength parameter has been exceeded.
 542
 543 =item B<X509_V_ERR_INVALID_PURPOSE>
 544
 545 The supplied certificate cannot be used for the specified purpose.
 546
 547 =item B<X509_V_ERR_CERT_UNTRUSTED>
 548
 549 The root CA is not marked as trusted for the specified purpose.
 550
 551 =item B<X509_V_ERR_CERT_REJECTED>
 552
 553 The root CA is marked to reject the specified purpose.
 554
 555 =item B<X509_V_ERR_SUBJECT_ISSUER_MISMATCH>
 556
 557 Not used as of OpenSSL 1.1.0 as a result of the deprecation of the
 558 B<-issuer_checks> option.
 559
 560 =item B<X509_V_ERR_AKID_SKID_MISMATCH>
 561
 562 Not used as of OpenSSL 1.1.0 as a result of the deprecation of the
 563 B<-issuer_checks> option.
 564
 565 =item B<X509_V_ERR_AKID_ISSUER_SERIAL_MISMATCH>
 566
 567 Not used as of OpenSSL 1.1.0 as a result of the deprecation of the
 568 B<-issuer_checks> option.
 569
 570 =item B<X509_V_ERR_KEYUSAGE_NO_CERTSIGN>
 571
 572 Not used as of OpenSSL 1.1.0 as a result of the deprecation of the
 573 B<-issuer_checks> option.
 574
 575 =item B<X509_V_ERR_UNABLE_TO_GET_CRL_ISSUER>
 576
 577 Unable to get CRL issuer certificate.
 578
 579 =item B<X509_V_ERR_UNHANDLED_CRITICAL_EXTENSION>
 580
 581 Unhandled critical extension.
 582
 583 =item B<X509_V_ERR_KEYUSAGE_NO_CRL_SIGN>
 584
 585 Key usage does not include CRL signing.
 586
 587 =item B<X509_V_ERR_UNHANDLED_CRITICAL_CRL_EXTENSION>
 588
 589 Unhandled critical CRL extension.
 590
 591 =item B<X509_V_ERR_INVALID_NON_CA>
 592
 593 Invalid non-CA certificate has CA markings.
 594
 595 =item B<X509_V_ERR_PROXY_PATH_LENGTH_EXCEEDED>
 596
 597 Proxy path length constraint exceeded.
 598
 599 =item B<X509_V_ERR_PROXY_SUBJECT_INVALID>
 600
 601 Proxy certificate subject is invalid.  It MUST be the same as the issuer
 602 with a single CN component added.
 603
 604 =item B<X509_V_ERR_KEYUSAGE_NO_DIGITAL_SIGNATURE>
 605
 606 Key usage does not include digital signature.
 607
 608 =item B<X509_V_ERR_PROXY_CERTIFICATES_NOT_ALLOWED>
 609
 610 Proxy certificates not allowed, please use B<-allow_proxy_certs>.
 611
 612 =item B<X509_V_ERR_INVALID_EXTENSION>
 613
 614 Invalid or inconsistent certificate extension.
 615
 616 =item B<X509_V_ERR_INVALID_POLICY_EXTENSION>
 617
 618 Invalid or inconsistent certificate policy extension.
 619
 620 =item B<X509_V_ERR_NO_EXPLICIT_POLICY>
 621
 622 No explicit policy.
 623
 624 =item B<X509_V_ERR_DIFFERENT_CRL_SCOPE>
 625
 626 Different CRL scope.
 627
 628 =item B<X509_V_ERR_UNSUPPORTED_EXTENSION_FEATURE>
 629
 630 Unsupported extension feature.
 631
 632 =item B<X509_V_ERR_UNNESTED_RESOURCE>
 633
 634 RFC 3779 resource not subset of parent's resources.
 635
 636 =item B<X509_V_ERR_PERMITTED_VIOLATION>
 637
 638 Permitted subtree violation.
 639
 640 =item B<X509_V_ERR_EXCLUDED_VIOLATION>
 641
 642 Excluded subtree violation.
 643
 644 =item B<X509_V_ERR_SUBTREE_MINMAX>
 645
 646 Name constraints minimum and maximum not supported.
 647
 648 =item B<X509_V_ERR_APPLICATION_VERIFICATION>
 649
 650 Application verification failure. Unused.
 651
 652 =item B<X509_V_ERR_UNSUPPORTED_CONSTRAINT_TYPE>
 653
 654 Unsupported name constraint type.
 655
 656 =item B<X509_V_ERR_UNSUPPORTED_CONSTRAINT_SYNTAX>
 657
 658 Unsupported or invalid name constraint syntax.
 659
 660 =item B<X509_V_ERR_UNSUPPORTED_NAME_SYNTAX>
 661
 662 Unsupported or invalid name syntax.
 663
 664 =item B<X509_V_ERR_CRL_PATH_VALIDATION_ERROR>
 665
 666 CRL path validation error.
 667
 668 =item B<X509_V_ERR_PATH_LOOP>
 669
 670 Path loop.
 671
 672 =item B<X509_V_ERR_SUITE_B_INVALID_VERSION>
 673
 674 Suite B: certificate version invalid.
 675
 676 =item B<X509_V_ERR_SUITE_B_INVALID_ALGORITHM>
 677
 678 Suite B: invalid public key algorithm.
 679
 680 =item B<X509_V_ERR_SUITE_B_INVALID_CURVE>
 681
 682 Suite B: invalid ECC curve.
 683
 684 =item B<X509_V_ERR_SUITE_B_INVALID_SIGNATURE_ALGORITHM>
 685
 686 Suite B: invalid signature algorithm.
 687
 688 =item B<X509_V_ERR_SUITE_B_LOS_NOT_ALLOWED>
 689
 690 Suite B: curve not allowed for this LOS.
 691
 692 =item B<X509_V_ERR_SUITE_B_CANNOT_SIGN_P_384_WITH_P_256>
 693
 694 Suite B: cannot sign P-384 with P-256.
 695
 696 =item B<X509_V_ERR_HOSTNAME_MISMATCH>
 697
 698 Hostname mismatch.
 699
 700 =item B<X509_V_ERR_EMAIL_MISMATCH>
 701
 702 Email address mismatch.
 703
 704 =item B<X509_V_ERR_IP_ADDRESS_MISMATCH>
 705
 706 IP address mismatch.
 707
 708 =item B<X509_V_ERR_DANE_NO_MATCH>
 709
 710 DANE TLSA authentication is enabled, but no TLSA records matched the
 711 certificate chain.
 712 This error is only possible in L<s_client(1)>.
 713
 714 =item B<X509_V_ERR_EE_KEY_TOO_SMALL>
 715
 716 EE certificate key too weak.
 717
 718 =item B<X509_ERR_CA_KEY_TOO_SMALL>
 719
 720 CA certificate key too weak.
 721
 722 =item B<X509_ERR_CA_MD_TOO_WEAK>
 723
 724 CA signature digest algorithm too weak.
 725
 726 =item B<X509_V_ERR_INVALID_CALL>
 727
 728 nvalid certificate verification context.
 729
 730 =item B<X509_V_ERR_STORE_LOOKUP>
 731
 732 Issuer certificate lookup error.
 733
 734 =item B<X509_V_ERR_NO_VALID_SCTS>
 735
 736 Certificate Transparency required, but no valid SCTs found.
 737
 738 =item B<X509_V_ERR_PROXY_SUBJECT_NAME_VIOLATION>
 739
 740 Proxy subject name violation.
 741
 742 =item B<X509_V_ERR_OCSP_VERIFY_NEEDED>
 743
 744 Returned by the verify callback to indicate an OCSP verification is needed.
 745
 746 =item B<X509_V_ERR_OCSP_VERIFY_FAILED>
 747
 748 Returned by the verify callback to indicate OCSP verification failed.
 749
 750 =item B<X509_V_ERR_OCSP_CERT_UNKNOWN>
 751
 752 Returned by the verify callback to indicate that the certificate is not recognized
 753 by the OCSP responder.
 754
 755 =back
 756
 757 =head1 BUGS
 758
 759 Although the issuer checks are a considerable improvement over the old
 760 technique they still suffer from limitations in the underlying X509_LOOKUP
 761 API. One consequence of this is that trusted certificates with matching
 762 subject name must either appear in a file (as specified by the B<-CAfile>
 763 option) or a directory (as specified by B<-CApath>). If they occur in
 764 both then only the certificates in the file will be recognised.
 765
 766 Previous versions of OpenSSL assume certificates with matching subject
 767 name are identical and mishandled them.
 768
 769 Previous versions of this documentation swapped the meaning of the
 770 B<X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT> and
 771 B<X509_V_ERR_UNABLE_TO_GET_ISSUER_CERT_LOCALLY> error codes.
 772
 773 =head1 SEE ALSO
 774
 775 L<openssl(1)>,
 776 L<openssl-x509(1)>
 777
 778 =head1 HISTORY
 779
 780 The B<-show_chain> option was added in OpenSSL 1.1.0.
 781
 782 The B<-issuer_checks> option is deprecated as of OpenSSL 1.1.0 and
 783 is silently ignored.
 784
 785 The B<-sm2-id> and B<-sm2-hex-id> options were added in OpenSSL 3.0.
 786
 787 =head1 COPYRIGHT
 788
 789 Copyright 2000-2019 The OpenSSL Project Authors. All Rights Reserved.
 790
 791 Licensed under the Apache License 2.0 (the "License").  You may not use
 792 this file except in compliance with the License.  You can obtain a copy
 793 in the file LICENSE in the source distribution or at
 794 L<https://www.openssl.org/source/license.html>.
 795
 796 =cut