1X509_GET_VERSION(3)                 OpenSSL                X509_GET_VERSION(3)
2
3
4

NAME

6       X509_get_version, X509_set_version, X509_REQ_get_version,
7       X509_REQ_set_version, X509_CRL_get_version, X509_CRL_set_version - get
8       or set certificate, certificate request or CRL version
9

SYNOPSIS

11        #include <openssl/x509.h>
12
13        long X509_get_version(const X509 *x);
14        int X509_set_version(X509 *x, long version);
15
16        long X509_REQ_get_version(const X509_REQ *req);
17        int X509_REQ_set_version(X509_REQ *x, long version);
18
19        long X509_CRL_get_version(const X509_CRL *crl);
20        int X509_CRL_set_version(X509_CRL *x, long version);
21

DESCRIPTION

23       X509_get_version() returns the numerical value of the version field of
24       certificate x. Note: this is defined by standards (X.509 et al) to be
25       one less than the certificate version. So a version 3 certificate will
26       return 2 and a version 1 certificate will return 0.
27
28       X509_set_version() sets the numerical value of the version field of
29       certificate x to version.
30
31       Similarly X509_REQ_get_version(), X509_REQ_set_version(),
32       X509_CRL_get_version() and X509_CRL_set_version() get and set the
33       version number of certificate requests and CRLs.
34

NOTES

36       The version field of certificates, certificate requests and CRLs has a
37       DEFAULT value of v1(0) meaning the field should be omitted for version
38       1. This is handled transparently by these functions.
39

RETURN VALUES

41       X509_get_version(), X509_REQ_get_version() and X509_CRL_get_version()
42       return the numerical value of the version field.
43
44       X509_set_version(), X509_REQ_set_version() and X509_CRL_set_version()
45       return 1 for success and 0 for failure.
46

SEE ALSO

48       d2i_X509(3), ERR_get_error(3), X509_CRL_get0_by_serial(3),
49       X509_get0_signature(3), X509_get_ext_d2i(3),
50       X509_get_extension_flags(3), X509_get_pubkey(3),
51       X509_get_subject_name(3), X509_NAME_add_entry_by_txt(3),
52       X509_NAME_ENTRY_get_object(3), X509_NAME_get_index_by_NID(3),
53       X509_NAME_print_ex(3), X509_new(3), X509_sign(3), X509V3_get_d2i(3),
54       X509_verify_cert(3)
55

HISTORY

57       X509_get_version(), X509_REQ_get_version() and X509_CRL_get_version()
58       are functions in OpenSSL 1.1.0, in previous versions they were macros.
59
61       Copyright 2015-2016 The OpenSSL Project Authors. All Rights Reserved.
62
63       Licensed under the OpenSSL license (the "License").  You may not use
64       this file except in compliance with the License.  You can obtain a copy
65       in the file LICENSE in the source distribution or at
66       <https://www.openssl.org/source/license.html>.
67
68
69
701.1.1d                            2019-10-03               X509_GET_VERSION(3)
Impressum