]>
Commit | Line | Data |
---|---|---|
9f7b1b24 UM |
1 | =pod |
2 | ||
3 | =head1 NAME | |
4 | ||
b0700d2c RS |
5 | OPENSSL_VERSION_NUMBER, OpenSSL_version, |
6 | OpenSSL_version_num - get OpenSSL version number | |
9f7b1b24 UM |
7 | |
8 | =head1 SYNOPSIS | |
9 | ||
10 | #include <openssl/opensslv.h> | |
11 | #define OPENSSL_VERSION_NUMBER 0xnnnnnnnnnL | |
12 | ||
13 | #include <openssl/crypto.h> | |
b0700d2c RS |
14 | |
15 | unsigned long OpenSSL_version_num(); | |
a528d4f0 | 16 | const char *OpenSSL_version(int t); |
9f7b1b24 UM |
17 | |
18 | =head1 DESCRIPTION | |
19 | ||
20 | OPENSSL_VERSION_NUMBER is a numeric release version identifier: | |
21 | ||
9208640a | 22 | MNNFFPPS: major minor fix patch status |
e65c84ab RL |
23 | |
24 | The status nibble has one of the values 0 for development, 1 to e for betas | |
25 | 1 to 14, and f for release. | |
26 | ||
27 | for example | |
28 | ||
29 | 0x000906000 == 0.9.6 dev | |
30 | 0x000906023 == 0.9.6b beta 3 | |
31 | 0x00090605f == 0.9.6e release | |
32 | ||
33 | Versions prior to 0.9.3 have identifiers E<lt> 0x0930. | |
34 | Versions between 0.9.3 and 0.9.5 had a version identifier with this | |
35 | interpretation: | |
36 | ||
9f7b1b24 UM |
37 | MMNNFFRBB major minor fix final beta/patch |
38 | ||
39 | for example | |
40 | ||
41 | 0x000904100 == 0.9.4 release | |
42 | 0x000905000 == 0.9.5 dev | |
43 | ||
c8973693 | 44 | Version 0.9.5a had an interim interpretation that is like the current one, |
e65c84ab RL |
45 | except the patch level got the highest bit set, to keep continuity. The |
46 | number was therefore 0x0090581f. | |
47 | ||
b0700d2c | 48 | OpenSSL_version_num() returns the version number. |
9f7b1b24 | 49 | |
a528d4f0 | 50 | OpenSSL_version() returns different strings depending on B<t>: |
e65c84ab RL |
51 | |
52 | =over 4 | |
53 | ||
a528d4f0 | 54 | =item OPENSSL_VERSION |
dc4ddcd2 | 55 | |
e65c84ab | 56 | The text variant of the version number and the release date. For example, |
a528d4f0 | 57 | "OpenSSL 1.0.1a 15 Oct 2015". |
e65c84ab | 58 | |
a528d4f0 | 59 | =item OPENSSL_CFLAGS |
dc4ddcd2 BM |
60 | |
61 | The compiler flags set for the compilation process in the form | |
62 | "compiler: ..." if available or "compiler: information not available" | |
63 | otherwise. | |
64 | ||
a528d4f0 | 65 | =item OPENSSL_BUILT_ON |
dc4ddcd2 BM |
66 | |
67 | The date of the build process in the form "built on: ..." if available | |
68 | or "built on: date not available" otherwise. | |
e65c84ab | 69 | |
a528d4f0 | 70 | =item OPENSSL_PLATFORM |
e65c84ab | 71 | |
dc4ddcd2 BM |
72 | The "Configure" target of the library build in the form "platform: ..." |
73 | if available or "platform: information not available" otherwise. | |
74 | ||
a528d4f0 | 75 | =item OPENSSL_DIR |
e65c84ab | 76 | |
dc4ddcd2 BM |
77 | The "OPENSSLDIR" setting of the library build in the form "OPENSSLDIR: "..."" |
78 | if available or "OPENSSLDIR: N/A" otherwise. | |
e65c84ab | 79 | |
e09621ff RL |
80 | =item OPENSSL_ENGINES_DIR |
81 | ||
82 | The "ENGINESDIR" setting of the library build in the form "ENGINESDIR: "..."" | |
83 | if available or "ENGINESDIR: N/A" otherwise. | |
84 | ||
dc4ddcd2 | 85 | =back |
e65c84ab | 86 | |
31cafe53 BM |
87 | For an unknown B<t>, the text "not available" is returned. |
88 | ||
9f7b1b24 UM |
89 | =head1 RETURN VALUE |
90 | ||
91 | The version number. | |
92 | ||
93 | =head1 SEE ALSO | |
94 | ||
b97fdb57 | 95 | L<crypto(7)> |
9f7b1b24 | 96 | |
e2f92610 RS |
97 | =head1 COPYRIGHT |
98 | ||
99 | Copyright 2000-2016 The OpenSSL Project Authors. All Rights Reserved. | |
100 | ||
101 | Licensed under the OpenSSL license (the "License"). You may not use | |
102 | this file except in compliance with the License. You can obtain a copy | |
103 | in the file LICENSE in the source distribution or at | |
104 | L<https://www.openssl.org/source/license.html>. | |
105 | ||
106 | =cut |