]> git.ipfire.org Git - thirdparty/openssl.git/blame - include/openssl/opensslv.h
Prepare for 1.1.1-pre4-dev
[thirdparty/openssl.git] / include / openssl / opensslv.h
CommitLineData
21dcbebc 1/*
6738bf14 2 * Copyright 1999-2018 The OpenSSL Project Authors. All Rights Reserved.
21dcbebc
RS
3 *
4 * Licensed under the OpenSSL license (the "License"). You may not use
5 * this file except in compliance with the License. You can obtain a copy
6 * in the file LICENSE in the source distribution or at
7 * https://www.openssl.org/source/license.html
8 */
9
033d858c 10#ifndef HEADER_OPENSSLV_H
0f113f3e 11# define HEADER_OPENSSLV_H
09ad8001 12
17e80c6b
RS
13#ifdef __cplusplus
14extern "C" {
15#endif
16
1d97c843
TH
17/*-
18 * Numeric release version identifier:
97639f0d 19 * MNNFFPPS: major minor fix patch status
e55818b9
RL
20 * The status nibble has one of the values 0 for development, 1 to e for betas
21 * 1 to 14, and f for release. The patch level is exactly that.
e90c7729 22 * For example:
0f113f3e
MC
23 * 0.9.3-dev 0x00903000
24 * 0.9.3-beta1 0x00903001
3cf4f5d0
RL
25 * 0.9.3-beta2-dev 0x00903002
26 * 0.9.3-beta2 0x00903002 (same as ...beta2-dev)
0f113f3e
MC
27 * 0.9.3 0x0090300f
28 * 0.9.3a 0x0090301f
29 * 0.9.4 0x0090400f
30 * 1.2.3z 0x102031af
e55818b9
RL
31 *
32 * For continuity reasons (because 0.9.5 is already out, and is coded
33 * 0x00905100), between 0.9.5 and 0.9.6 the coding of the patch level
34 * part is slightly different, by setting the highest bit. This means
35 * that 0.9.5a looks like this: 0x0090581f. At 0.9.6, we can start
36 * with 0x0090600S...
37 *
06064bb5 38 * (Prior to 0.9.3-dev a different scheme was used: 0.9.2b is 0x0922.)
e55818b9
RL
39 * (Prior to 0.9.5a beta1, a different scheme was used: MMNNFFRBB for
40 * major minor fix final patch/beta)
e90c7729 41 */
9fcfd0cd
MC
42# define OPENSSL_VERSION_NUMBER 0x10101004L
43# define OPENSSL_VERSION_TEXT "OpenSSL 1.1.1-pre4-dev xx XXX xxxx"
b436a982 44
3c5a61dd
MR
45#define OPENSSL_MAKE_VERSION(maj,min,fix,patch) ((0x10000000L)+((maj&0xff)<<20)+((min&0xff)<<12)+((fix&0xff)<<4)+patch)
46
47/* use this for #if tests, should never depend upon fix/patch */
48#define OPENSSL_VERSION_AT_LEAST(maj,min) (OPENSSL_MAKE_VERSION(maj,min, 0, 0) >= OPENSSL_VERSION_NUMBER)
49
1d97c843
TH
50/*-
51 * The macros below are to be used for shared library (.so, .dll, ...)
b436a982
RL
52 * versioning. That kind of versioning works a bit differently between
53 * operating systems. The most usual scheme is to set a major and a minor
54 * number, and have the runtime loader check that the major number is equal
55 * to what it was at application link time, while the minor number has to
56 * be greater or equal to what it was at application link time. With this
57 * scheme, the version number is usually part of the file name, like this:
58 *
0f113f3e 59 * libcrypto.so.0.9
b436a982 60 *
b6453a68 61 * Some unixen also make a softlink with the major version number only:
b436a982 62 *
0f113f3e 63 * libcrypto.so.0
b436a982 64 *
6bc847e4
RL
65 * On Tru64 and IRIX 6.x it works a little bit differently. There, the
66 * shared library version is stored in the file, and is actually a series
67 * of versions, separated by colons. The rightmost version present in the
68 * library when linking an application is stored in the application to be
69 * matched at run time. When the application is run, a check is done to
70 * see if the library version stored in the application matches any of the
71 * versions in the version string of the library itself.
b436a982
RL
72 * This version string can be constructed in any way, depending on what
73 * kind of matching is desired. However, to implement the same scheme as
74 * the one used in the other unixen, all compatible versions, from lowest
75 * to highest, should be part of the string. Consecutive builds would
76 * give the following versions strings:
77 *
0f113f3e
MC
78 * 3.0
79 * 3.0:3.1
80 * 3.0:3.1:3.2
81 * 4.0
82 * 4.0:4.1
b436a982
RL
83 *
84 * Notice how version 4 is completely incompatible with version, and
85 * therefore give the breach you can see.
86 *
87 * There may be other schemes as well that I haven't yet discovered.
88 *
89 * So, here's the way it works here: first of all, the library version
90 * number doesn't need at all to match the overall OpenSSL version.
91 * However, it's nice and more understandable if it actually does.
92 * The current library version is stored in the macro SHLIB_VERSION_NUMBER,
93 * which is just a piece of text in the format "M.m.e" (Major, minor, edit).
6bc847e4 94 * For the sake of Tru64, IRIX, and any other OS that behaves in similar ways,
b436a982
RL
95 * we need to keep a history of version numbers, which is done in the
96 * macro SHLIB_VERSION_HISTORY. The numbers are separated by colons and
97 * should only keep the versions that are binary compatible with the current.
98 */
0f113f3e 99# define SHLIB_VERSION_HISTORY ""
6a919b44 100# define SHLIB_VERSION_NUMBER "1.1"
b436a982
RL
101
102
17e80c6b
RS
103#ifdef __cplusplus
104}
105#endif
0f113f3e 106#endif /* HEADER_OPENSSLV_H */