1
/* Licensed to the Apache Software Foundation (ASF) under one or more
2
* contributor license agreements. See the NOTICE file distributed with
3
* this work for additional information regarding copyright ownership.
4
* The ASF licenses this file to You under the Apache License, Version 2.0
5
* (the "License"); you may not use this file except in compliance with
6
* the License. You may obtain a copy of the License at
8
* http://www.apache.org/licenses/LICENSE-2.0
10
* Unless required by applicable law or agreed to in writing, software
11
* distributed under the License is distributed on an "AS IS" BASIS,
12
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
* See the License for the specific language governing permissions and
14
* limitations under the License.
22
* @brief APR Versioning Interface
26
* There are several different mechanisms for accessing the version. There
27
* is a string form, and a set of numbers; in addition, there are constants
28
* which can be compiled into your application, and you can query the library
29
* being used for its actual version.
31
* Note that it is possible for an application to detect that it has been
32
* compiled against a different version of APR by use of the compile-time
33
* constants and the use of the run-time query function.
35
* APR version numbering follows the guidelines specified in:
37
* http://apr.apache.org/versioning.html
41
/* The numeric compile-time version constants. These constants are the
42
* authoritative version numbers for APR.
46
* Major API changes that could cause compatibility problems for older
47
* programs such as structure size changes. No binary compatibility is
48
* possible across a change in the major version.
50
#define APR_MAJOR_VERSION 1
53
* Minor API changes that do not cause binary compatibility problems.
54
* Reset to 0 when upgrading APR_MAJOR_VERSION
56
#define APR_MINOR_VERSION 4
59
* The Patch Level never includes API changes, simply bug fixes.
60
* Reset to 0 when upgrading APR_MINOR_VERSION
62
#define APR_PATCH_VERSION 2
65
* The symbol APR_IS_DEV_VERSION is only defined for internal,
66
* "development" copies of APR. It is undefined for released versions
69
/* #undef APR_IS_DEV_VERSION */
72
* Check at compile time if the APR version is at least a certain
74
* @param major The major version component of the version checked
75
* for (e.g., the "1" of "1.3.0").
76
* @param minor The minor version component of the version checked
77
* for (e.g., the "3" of "1.3.0").
78
* @param patch The patch level component of the version checked
79
* for (e.g., the "0" of "1.3.0").
80
* @remark This macro is available with APR versions starting with
83
#define APR_VERSION_AT_LEAST(major,minor,patch) \
84
(((major) < APR_MAJOR_VERSION) \
85
|| ((major) == APR_MAJOR_VERSION && (minor) < APR_MINOR_VERSION) \
86
|| ((major) == APR_MAJOR_VERSION && (minor) == APR_MINOR_VERSION && (patch) <= APR_PATCH_VERSION))
88
#if defined(APR_IS_DEV_VERSION) || defined(DOXYGEN)
89
/** Internal: string form of the "is dev" flag */
90
#define APR_IS_DEV_STRING "-dev"
92
#define APR_IS_DEV_STRING ""
95
/* APR_STRINGIFY is defined here, and also in apr_general.h, so wrap it */
97
/** Properly quote a value as a string in the C preprocessor */
98
#define APR_STRINGIFY(n) APR_STRINGIFY_HELPER(n)
99
/** Helper macro for APR_STRINGIFY */
100
#define APR_STRINGIFY_HELPER(n) #n
103
/** The formatted string of APR's version */
104
#define APR_VERSION_STRING \
105
APR_STRINGIFY(APR_MAJOR_VERSION) "." \
106
APR_STRINGIFY(APR_MINOR_VERSION) "." \
107
APR_STRINGIFY(APR_PATCH_VERSION) \
110
/** An alternative formatted string of APR's version */
111
/* macro for Win32 .rc files using numeric csv representation */
112
#define APR_VERSION_STRING_CSV APR_MAJOR_VERSION ##, \
113
##APR_MINOR_VERSION ##, \
117
#ifndef APR_VERSION_ONLY
119
/* The C language API to access the version at run time,
120
* as opposed to compile time. APR_VERSION_ONLY may be defined
121
* externally when preprocessing apr_version.h to obtain strictly
122
* the C Preprocessor macro declarations.
132
* The numeric version information is broken out into fields within this
136
int major; /**< major number */
137
int minor; /**< minor number */
138
int patch; /**< patch number */
139
int is_dev; /**< is development (1 or 0) */
143
* Return APR's version information information in a numeric form.
145
* @param pvsn Pointer to a version structure for returning the version
148
APR_DECLARE(void) apr_version(apr_version_t *pvsn);
150
/** Return APR's version information as a string. */
151
APR_DECLARE(const char *) apr_version_string(void);
157
#endif /* ndef APR_VERSION_ONLY */
159
#endif /* ndef APR_VERSION_H */