diff options
Diffstat (limited to 'src')
-rw-r--r-- | src/lib/libcrypto/man/OPENSSL_VERSION_NUMBER.3 | 51 |
1 files changed, 38 insertions, 13 deletions
diff --git a/src/lib/libcrypto/man/OPENSSL_VERSION_NUMBER.3 b/src/lib/libcrypto/man/OPENSSL_VERSION_NUMBER.3 index e5a66c58db..dcbad61b7e 100644 --- a/src/lib/libcrypto/man/OPENSSL_VERSION_NUMBER.3 +++ b/src/lib/libcrypto/man/OPENSSL_VERSION_NUMBER.3 | |||
@@ -1,4 +1,4 @@ | |||
1 | .\" $OpenBSD: OPENSSL_VERSION_NUMBER.3,v 1.4 2018/02/17 18:00:59 schwarze Exp $ | 1 | .\" $OpenBSD: OPENSSL_VERSION_NUMBER.3,v 1.5 2018/02/17 18:44:36 schwarze Exp $ |
2 | .\" full merge up to: OpenSSL 1f13ad31 Dec 25 17:50:39 2017 +0800 | 2 | .\" full merge up to: OpenSSL 1f13ad31 Dec 25 17:50:39 2017 +0800 |
3 | .\" | 3 | .\" |
4 | .\" This file is a derived work. | 4 | .\" This file is a derived work. |
@@ -73,6 +73,8 @@ | |||
73 | .Os | 73 | .Os |
74 | .Sh NAME | 74 | .Sh NAME |
75 | .Nm OPENSSL_VERSION_NUMBER , | 75 | .Nm OPENSSL_VERSION_NUMBER , |
76 | .Nm LIBRESSL_VERSION_NUMBER , | ||
77 | .Nm LIBRESSL_VERSION_TEXT , | ||
76 | .Nm OpenSSL_version_num , | 78 | .Nm OpenSSL_version_num , |
77 | .Nm OpenSSL_version , | 79 | .Nm OpenSSL_version , |
78 | .Nm SSLeay , | 80 | .Nm SSLeay , |
@@ -81,6 +83,8 @@ | |||
81 | .Sh SYNOPSIS | 83 | .Sh SYNOPSIS |
82 | .In openssl/opensslv.h | 84 | .In openssl/opensslv.h |
83 | .Fd #define OPENSSL_VERSION_NUMBER 0x020000000L | 85 | .Fd #define OPENSSL_VERSION_NUMBER 0x020000000L |
86 | .Fd #define LIBRESSL_VERSION_NUMBER 0x02nnnn00fL | ||
87 | .Fd #define LIBRESSL_VERSION_TEXT \(dqLibreSSL 2.n.n\(dq | ||
84 | .In openssl/crypto.h | 88 | .In openssl/crypto.h |
85 | .Ft unsigned long | 89 | .Ft unsigned long |
86 | .Fn OpenSSL_version_num void | 90 | .Fn OpenSSL_version_num void |
@@ -96,21 +100,32 @@ | |||
96 | .Fc | 100 | .Fc |
97 | .Sh DESCRIPTION | 101 | .Sh DESCRIPTION |
98 | .Dv OPENSSL_VERSION_NUMBER | 102 | .Dv OPENSSL_VERSION_NUMBER |
99 | is a numeric release version identifier. | 103 | and |
100 | For OpenSSL, the first two digits contain the major release number, | 104 | .Dv LIBRESSL_VERSION_NUMBER |
105 | are numeric release version identifiers. | ||
106 | The first two digits contain the major release number, | ||
101 | the third and fourth digits the minor release number, | 107 | the third and fourth digits the minor release number, |
102 | the fifth and sixth digits the fix release number, | 108 | and the fifth and sixth digits the fix release number. |
103 | the seventh and eight digits the patch release number. | 109 | For OpenSSL, the seventh and eight digits contain the patch release number |
104 | The final digit is 0 for development, 1 to e for betas 1 to 14, or f | 110 | and the final digit is 0 for development, 1 to e for betas 1 to 14, or f |
105 | for release. | 111 | for release. |
106 | For LibreSSL, this number is always 0x020000000. | 112 | For LibreSSL, |
113 | .Dv OPENSSL_VERSION_NUMBER | ||
114 | is always 0x020000000, | ||
115 | and | ||
116 | .Dv LIBRESSL_VERSION_NUMBER | ||
117 | always ends with 00f. | ||
107 | .Pp | 118 | .Pp |
108 | For example: | 119 | For example: |
109 | .Bd -literal -offset indent | 120 | .Bd -literal -offset indent |
121 | OPENSSL_VERSION_NUMBER: | ||
110 | 0x000906000 == 0.9.6 dev | 122 | 0x000906000 == 0.9.6 dev |
111 | 0x000906023 == 0.9.6b beta 3 | 123 | 0x000906023 == 0.9.6b beta 3 |
112 | 0x00090605f == 0.9.6e release | 124 | 0x00090605f == 0.9.6e release |
113 | 0x020000000 == 2.0.0 for any version of LibreSSL | 125 | 0x020000000 == 2.0.0 for any version of LibreSSL |
126 | |||
127 | LIBRESSL_VERSION_NUMBER: | ||
128 | 0x02070000f == LibreSSL 2.7.0 | ||
114 | .Ed | 129 | .Ed |
115 | .Pp | 130 | .Pp |
116 | OpenSSL versions prior to 0.9.3 had identifiers < 0x0930. | 131 | OpenSSL versions prior to 0.9.3 had identifiers < 0x0930. |
@@ -129,7 +144,8 @@ one, except the patch level got the highest bit set, to keep continuity. | |||
129 | The number was therefore 0x0090581f. | 144 | The number was therefore 0x0090581f. |
130 | .Pp | 145 | .Pp |
131 | .Fn OpenSSL_version_num | 146 | .Fn OpenSSL_version_num |
132 | returns this version number. | 147 | returns |
148 | .Dv OPENSSL_VERSION_NUMBER . | ||
133 | .Pp | 149 | .Pp |
134 | .Fn OpenSSL_version | 150 | .Fn OpenSSL_version |
135 | returns different strings depending on | 151 | returns different strings depending on |
@@ -137,11 +153,11 @@ returns different strings depending on | |||
137 | .Bl -tag -width Ds | 153 | .Bl -tag -width Ds |
138 | .It Dv OPENSSL_VERSION | 154 | .It Dv OPENSSL_VERSION |
139 | The text variant of the version number. | 155 | The text variant of the version number. |
140 | For OpenSSL, it is followed by the release date. | 156 | For OpenSSL, it is followed by the release date, for example |
141 | For example, | 157 | .Qq OpenSSL 0.9.5a 1 Apr 2000 . |
142 | .Qq OpenSSL 0.9.5a 1 Apr 2000 | 158 | For LibreSSL, |
143 | or | 159 | .Dv LIBRESSL_VERSION_TEXT |
144 | .Qq LibreSSL 2.7.0 . | 160 | is returned. |
145 | .It Dv OPENSSL_CFLAGS | 161 | .It Dv OPENSSL_CFLAGS |
146 | The compiler flags set for the compilation process in the form | 162 | The compiler flags set for the compilation process in the form |
147 | .Qq compiler: ... | 163 | .Qq compiler: ... |
@@ -236,3 +252,12 @@ are available in all versions of SSLeay and OpenSSL. | |||
236 | is available in all versions of OpenSSL. | 252 | is available in all versions of OpenSSL. |
237 | .Dv SSLEAY_DIR | 253 | .Dv SSLEAY_DIR |
238 | was added in OpenSSL 0.9.7. | 254 | was added in OpenSSL 0.9.7. |
255 | .Pp | ||
256 | .Dv LIBRESSL_VERSION_NUMBER | ||
257 | first appeared in LibreSSL 2.0.0 and | ||
258 | .Ox 5.6 | ||
259 | and got its final format in LibreSSL 2.3.2 and | ||
260 | .Ox 5.9 . | ||
261 | .Dv LIBRESSL_VERSION_TEXT | ||
262 | first appered in LibreSSL 2.2.2 and | ||
263 | .Ox 5.8 . | ||