projects / thirdparty / openssl.git / blame
| Commit | Line | Data |
|---|---|---|
| c03726ca RS |
1 | =pod |
| 2 | ||
| 3 | =head1 NAME | |
| 4 | ||
| 5 | X509_check_ca - check if given certificate is CA certificate | |
| 6 | ||
| 7 | =head1 SYNOPSIS | |
| 8 | ||
| e9b77246 | 9 | #include <openssl/x509v3.h> |
| c03726ca | 10 | |
| e9b77246 | 11 | int X509_check_ca(X509 *cert); |
| c03726ca RS |
12 | |
| 13 | =head1 DESCRIPTION | |
| 14 | ||
| 15 | This function checks if given certificate is CA certificate (can be used | |
| 16 | to sign other certificates). | |
| 17 | ||
| 1f13ad31 | 18 | =head1 RETURN VALUES |
| c03726ca RS |
19 | |
| 20 | Function return 0, if it is not CA certificate, 1 if it is proper X509v3 | |
| 21 | CA certificate with B<basicConstraints> extension CA:TRUE, | |
| 0ad69cd6 | 22 | 3, if it is self-signed X509 v1 certificate, 4, if it is certificate with |
| c03726ca RS |
23 | B<keyUsage> extension with bit B<keyCertSign> set, but without |
| 24 | B<basicConstraints>, and 5 if it has outdated Netscape Certificate Type | |
| 25 | extension telling that it is CA certificate. | |
| 26 | ||
| 33328581 MC |
27 | This function will also return 0 on error. |
| 28 | ||
| 9c0586d5 | 29 | Actually, any nonzero value means that this certificate could have been |
| c03726ca RS |
30 | used to sign other certificates. |
| 31 | ||
| 32 | =head1 SEE ALSO | |
| 33 | ||
| 34 | L<X509_verify_cert(3)>, | |
| 35 | L<X509_check_issued(3)>, | |
| 36 | L<X509_check_purpose(3)> | |
| 37 | ||
| e2f92610 RS |
38 | =head1 COPYRIGHT |
| 39 | ||
| 61f805c1 | 40 | Copyright 2015-2018 The OpenSSL Project Authors. All Rights Reserved. |
| e2f92610 | 41 | |
| 4746f25a | 42 | Licensed under the Apache License 2.0 (the "License"). You may not use |
| e2f92610 RS |
43 | this file except in compliance with the License. You can obtain a copy |
| 44 | in the file LICENSE in the source distribution or at | |
| 45 | L<https://www.openssl.org/source/license.html>. | |
| 46 | ||
| 47 | =cut |