doc/man1/verify.pod

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