OPENSSL_VERSION_NUMBER.pod 2.0 KB
Newer Older
U
Ulf Möller 已提交
1 2 3 4
=pod

=head1 NAME

R
Rich Salz 已提交
5
OPENSSL_VERSION_NUMBER, OpenSSL_version - get OpenSSL version number
U
Ulf Möller 已提交
6 7 8 9 10 11 12

=head1 SYNOPSIS

 #include <openssl/opensslv.h>
 #define OPENSSL_VERSION_NUMBER 0xnnnnnnnnnL

 #include <openssl/crypto.h>
R
Rich Salz 已提交
13
 const char *OpenSSL_version(int t);
U
Ulf Möller 已提交
14 15 16 17 18

=head1 DESCRIPTION

OPENSSL_VERSION_NUMBER is a numeric release version identifier:

19
 MNNFFPPS: major minor fix patch status
20 21 22 23 24 25 26 27 28 29 30 31 32 33

The status nibble has one of the values 0 for development, 1 to e for betas
1 to 14, and f for release.

for example

 0x000906000 == 0.9.6 dev
 0x000906023 == 0.9.6b beta 3
 0x00090605f == 0.9.6e release

Versions prior to 0.9.3 have identifiers E<lt> 0x0930.
Versions between 0.9.3 and 0.9.5 had a version identifier with this
interpretation:

U
Ulf Möller 已提交
34 35 36 37 38 39 40
 MMNNFFRBB major minor fix final beta/patch

for example

 0x000904100 == 0.9.4 release
 0x000905000 == 0.9.5 dev

U
ispell.  
Ulf Möller 已提交
41
Version 0.9.5a had an interim interpretation that is like the current one,
42 43 44 45
except the patch level got the highest bit set, to keep continuity.  The
number was therefore 0x0090581f.


R
Rich Salz 已提交
46
For backward compatibility, OPENSSL_VERSION_NUMBER is also defined.
U
Ulf Möller 已提交
47

R
Rich Salz 已提交
48
OpenSSL_version() returns different strings depending on B<t>:
49 50 51

=over 4

R
Rich Salz 已提交
52
=item OPENSSL_VERSION
53

54
The text variant of the version number and the release date.  For example,
R
Rich Salz 已提交
55
"OpenSSL 1.0.1a 15 Oct 2015".
56

R
Rich Salz 已提交
57
=item OPENSSL_CFLAGS
58 59 60 61 62

The compiler flags set for the compilation process in the form
"compiler: ..."  if available or "compiler: information not available"
otherwise.

R
Rich Salz 已提交
63
=item OPENSSL_BUILT_ON
64 65 66

The date of the build process in the form "built on: ..." if available
or "built on: date not available" otherwise.
67

R
Rich Salz 已提交
68
=item OPENSSL_PLATFORM
69

70 71 72
The "Configure" target of the library build in the form "platform: ..."
if available or "platform: information not available" otherwise.

R
Rich Salz 已提交
73
=item OPENSSL_DIR
74

75 76
The "OPENSSLDIR" setting of the library build in the form "OPENSSLDIR: "...""
if available or "OPENSSLDIR: N/A" otherwise.
77

78
=back
79

80 81
For an unknown B<t>, the text "not available" is returned.

U
Ulf Möller 已提交
82 83 84 85 86 87
=head1 RETURN VALUE

The version number.

=head1 SEE ALSO

R
Rich Salz 已提交
88
L<crypto(3)>
U
Ulf Möller 已提交
89 90

=cut