1*ebfedea0SLionel Sambuc=pod
2*ebfedea0SLionel Sambuc
3*ebfedea0SLionel Sambuc=head1 NAME
4*ebfedea0SLionel Sambuc
5*ebfedea0SLionel SambucOPENSSL_VERSION_NUMBER, SSLeay, SSLeay_version - get OpenSSL version number
6*ebfedea0SLionel Sambuc
7*ebfedea0SLionel Sambuc=head1 SYNOPSIS
8*ebfedea0SLionel Sambuc
9*ebfedea0SLionel Sambuc #include <openssl/opensslv.h>
10*ebfedea0SLionel Sambuc #define OPENSSL_VERSION_NUMBER 0xnnnnnnnnnL
11*ebfedea0SLionel Sambuc
12*ebfedea0SLionel Sambuc #include <openssl/crypto.h>
13*ebfedea0SLionel Sambuc long SSLeay(void);
14*ebfedea0SLionel Sambuc const char *SSLeay_version(int t);
15*ebfedea0SLionel Sambuc
16*ebfedea0SLionel Sambuc=head1 DESCRIPTION
17*ebfedea0SLionel Sambuc
18*ebfedea0SLionel SambucOPENSSL_VERSION_NUMBER is a numeric release version identifier:
19*ebfedea0SLionel Sambuc
20*ebfedea0SLionel Sambuc MMNNFFPPS: major minor fix patch status
21*ebfedea0SLionel Sambuc
22*ebfedea0SLionel SambucThe status nibble has one of the values 0 for development, 1 to e for betas
23*ebfedea0SLionel Sambuc1 to 14, and f for release.
24*ebfedea0SLionel Sambuc
25*ebfedea0SLionel Sambucfor example
26*ebfedea0SLionel Sambuc
27*ebfedea0SLionel Sambuc 0x000906000 == 0.9.6 dev
28*ebfedea0SLionel Sambuc 0x000906023 == 0.9.6b beta 3
29*ebfedea0SLionel Sambuc 0x00090605f == 0.9.6e release
30*ebfedea0SLionel Sambuc
31*ebfedea0SLionel SambucVersions prior to 0.9.3 have identifiers E<lt> 0x0930.
32*ebfedea0SLionel SambucVersions between 0.9.3 and 0.9.5 had a version identifier with this
33*ebfedea0SLionel Sambucinterpretation:
34*ebfedea0SLionel Sambuc
35*ebfedea0SLionel Sambuc MMNNFFRBB major minor fix final beta/patch
36*ebfedea0SLionel Sambuc
37*ebfedea0SLionel Sambucfor example
38*ebfedea0SLionel Sambuc
39*ebfedea0SLionel Sambuc 0x000904100 == 0.9.4 release
40*ebfedea0SLionel Sambuc 0x000905000 == 0.9.5 dev
41*ebfedea0SLionel Sambuc
42*ebfedea0SLionel SambucVersion 0.9.5a had an interim interpretation that is like the current one,
43*ebfedea0SLionel Sambucexcept the patch level got the highest bit set, to keep continuity.  The
44*ebfedea0SLionel Sambucnumber was therefore 0x0090581f.
45*ebfedea0SLionel Sambuc
46*ebfedea0SLionel Sambuc
47*ebfedea0SLionel SambucFor backward compatibility, SSLEAY_VERSION_NUMBER is also defined.
48*ebfedea0SLionel Sambuc
49*ebfedea0SLionel SambucSSLeay() returns this number. The return value can be compared to the
50*ebfedea0SLionel Sambucmacro to make sure that the correct version of the library has been
51*ebfedea0SLionel Sambucloaded, especially when using DLLs on Windows systems.
52*ebfedea0SLionel Sambuc
53*ebfedea0SLionel SambucSSLeay_version() returns different strings depending on B<t>:
54*ebfedea0SLionel Sambuc
55*ebfedea0SLionel Sambuc=over 4
56*ebfedea0SLionel Sambuc
57*ebfedea0SLionel Sambuc=item SSLEAY_VERSION
58*ebfedea0SLionel Sambuc
59*ebfedea0SLionel SambucThe text variant of the version number and the release date.  For example,
60*ebfedea0SLionel Sambuc"OpenSSL 0.9.5a 1 Apr 2000".
61*ebfedea0SLionel Sambuc
62*ebfedea0SLionel Sambuc=item SSLEAY_CFLAGS
63*ebfedea0SLionel Sambuc
64*ebfedea0SLionel SambucThe compiler flags set for the compilation process in the form
65*ebfedea0SLionel Sambuc"compiler: ..."  if available or "compiler: information not available"
66*ebfedea0SLionel Sambucotherwise.
67*ebfedea0SLionel Sambuc
68*ebfedea0SLionel Sambuc=item SSLEAY_BUILT_ON
69*ebfedea0SLionel Sambuc
70*ebfedea0SLionel SambucThe date of the build process in the form "built on: ..." if available
71*ebfedea0SLionel Sambucor "built on: date not available" otherwise.
72*ebfedea0SLionel Sambuc
73*ebfedea0SLionel Sambuc=item SSLEAY_PLATFORM
74*ebfedea0SLionel Sambuc
75*ebfedea0SLionel SambucThe "Configure" target of the library build in the form "platform: ..."
76*ebfedea0SLionel Sambucif available or "platform: information not available" otherwise.
77*ebfedea0SLionel Sambuc
78*ebfedea0SLionel Sambuc=item SSLEAY_DIR
79*ebfedea0SLionel Sambuc
80*ebfedea0SLionel SambucThe "OPENSSLDIR" setting of the library build in the form "OPENSSLDIR: "...""
81*ebfedea0SLionel Sambucif available or "OPENSSLDIR: N/A" otherwise.
82*ebfedea0SLionel Sambuc
83*ebfedea0SLionel Sambuc=back
84*ebfedea0SLionel Sambuc
85*ebfedea0SLionel SambucFor an unknown B<t>, the text "not available" is returned.
86*ebfedea0SLionel Sambuc
87*ebfedea0SLionel Sambuc=head1 RETURN VALUE
88*ebfedea0SLionel Sambuc
89*ebfedea0SLionel SambucThe version number.
90*ebfedea0SLionel Sambuc
91*ebfedea0SLionel Sambuc=head1 SEE ALSO
92*ebfedea0SLionel Sambuc
93*ebfedea0SLionel SambucL<crypto(3)|crypto(3)>
94*ebfedea0SLionel Sambuc
95*ebfedea0SLionel Sambuc=head1 HISTORY
96*ebfedea0SLionel Sambuc
97*ebfedea0SLionel SambucSSLeay() and SSLEAY_VERSION_NUMBER are available in all versions of SSLeay and OpenSSL.
98*ebfedea0SLionel SambucOPENSSL_VERSION_NUMBER is available in all versions of OpenSSL.
99*ebfedea0SLionel SambucB<SSLEAY_DIR> was added in OpenSSL 0.9.7.
100*ebfedea0SLionel Sambuc
101*ebfedea0SLionel Sambuc=cut
102