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 4 25 #define LZMA_VERSION_PATCH 1 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