1 | /** |
2 | * \file lzma/version.h |
3 | * \brief Version number |
4 | */ |
5 | |
6 | /* |
7 | * Author: Lasse Collin |
8 | * |
9 | * This file has been put into the public domain. |
10 | * You can do whatever you want with this file. |
11 | * |
12 | * See ../lzma.h for information about liblzma as a whole. |
13 | */ |
14 | |
15 | #ifndef LZMA_H_INTERNAL |
16 | # error Never include this file directly. Use <lzma.h> instead. |
17 | #endif |
18 | |
19 | |
20 | /* |
21 | * Version number split into components |
22 | */ |
23 | #define LZMA_VERSION_MAJOR 5 |
24 | #define LZMA_VERSION_MINOR 2 |
25 | #define LZMA_VERSION_PATCH 5 |
26 | #define LZMA_VERSION_STABILITY LZMA_VERSION_STABILITY_STABLE |
27 | |
28 | #ifndef LZMA_VERSION_COMMIT |
29 | # define LZMA_VERSION_COMMIT "" |
30 | #endif |
31 | |
32 | |
33 | /* |
34 | * Map symbolic stability levels to integers. |
35 | */ |
36 | #define LZMA_VERSION_STABILITY_ALPHA 0 |
37 | #define LZMA_VERSION_STABILITY_BETA 1 |
38 | #define LZMA_VERSION_STABILITY_STABLE 2 |
39 | |
40 | |
41 | /** |
42 | * \brief Compile-time version number |
43 | * |
44 | * The version number is of format xyyyzzzs where |
45 | * - x = major |
46 | * - yyy = minor |
47 | * - zzz = revision |
48 | * - s indicates stability: 0 = alpha, 1 = beta, 2 = stable |
49 | * |
50 | * The same xyyyzzz triplet is never reused with different stability levels. |
51 | * For example, if 5.1.0alpha has been released, there will never be 5.1.0beta |
52 | * or 5.1.0 stable. |
53 | * |
54 | * \note The version number of liblzma has nothing to with |
55 | * the version number of Igor Pavlov's LZMA SDK. |
56 | */ |
57 | #define LZMA_VERSION (LZMA_VERSION_MAJOR * UINT32_C(10000000) \ |
58 | + LZMA_VERSION_MINOR * UINT32_C(10000) \ |
59 | + LZMA_VERSION_PATCH * UINT32_C(10) \ |
60 | + LZMA_VERSION_STABILITY) |
61 | |
62 | |
63 | /* |
64 | * Macros to construct the compile-time version string |
65 | */ |
66 | #if LZMA_VERSION_STABILITY == LZMA_VERSION_STABILITY_ALPHA |
67 | # define LZMA_VERSION_STABILITY_STRING "alpha" |
68 | #elif LZMA_VERSION_STABILITY == LZMA_VERSION_STABILITY_BETA |
69 | # define LZMA_VERSION_STABILITY_STRING "beta" |
70 | #elif LZMA_VERSION_STABILITY == LZMA_VERSION_STABILITY_STABLE |
71 | # define LZMA_VERSION_STABILITY_STRING "" |
72 | #else |
73 | # error Incorrect LZMA_VERSION_STABILITY |
74 | #endif |
75 | |
76 | #define LZMA_VERSION_STRING_C_(major, minor, patch, stability, commit) \ |
77 | #major "." #minor "." #patch stability commit |
78 | |
79 | #define LZMA_VERSION_STRING_C(major, minor, patch, stability, commit) \ |
80 | LZMA_VERSION_STRING_C_(major, minor, patch, stability, commit) |
81 | |
82 | |
83 | /** |
84 | * \brief Compile-time version as a string |
85 | * |
86 | * This can be for example "4.999.5alpha", "4.999.8beta", or "5.0.0" (stable |
87 | * versions don't have any "stable" suffix). In future, a snapshot built |
88 | * from source code repository may include an additional suffix, for example |
89 | * "4.999.8beta-21-g1d92". The commit ID won't be available in numeric form |
90 | * in LZMA_VERSION macro. |
91 | */ |
92 | #define LZMA_VERSION_STRING LZMA_VERSION_STRING_C( \ |
93 | LZMA_VERSION_MAJOR, LZMA_VERSION_MINOR, \ |
94 | LZMA_VERSION_PATCH, LZMA_VERSION_STABILITY_STRING, \ |
95 | LZMA_VERSION_COMMIT) |
96 | |
97 | |
98 | /* #ifndef is needed for use with windres (MinGW or Cygwin). */ |
99 | #ifndef LZMA_H_INTERNAL_RC |
100 | |
101 | /** |
102 | * \brief Run-time version number as an integer |
103 | * |
104 | * Return the value of LZMA_VERSION macro at the compile time of liblzma. |
105 | * This allows the application to compare if it was built against the same, |
106 | * older, or newer version of liblzma that is currently running. |
107 | */ |
108 | extern LZMA_API(uint32_t) lzma_version_number(void) |
109 | lzma_nothrow lzma_attr_const; |
110 | |
111 | |
112 | /** |
113 | * \brief Run-time version as a string |
114 | * |
115 | * This function may be useful if you want to display which version of |
116 | * liblzma your application is currently using. |
117 | */ |
118 | extern LZMA_API(const char *) lzma_version_string(void) |
119 | lzma_nothrow lzma_attr_const; |
120 | |
121 | #endif |
122 | |