diff options
Diffstat (limited to '')
| -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 . | ||
