2013-06-18 01:59:55 +00:00
|
|
|
/* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
|
|
* contributor license agreements. See the NOTICE file distributed with
|
|
|
|
* this work for additional information regarding copyright ownership.
|
|
|
|
* The ASF licenses this file to You under the Apache License, Version 2.0
|
|
|
|
* (the "License"); you may not use this file except in compliance with
|
|
|
|
* the License. You may obtain a copy of the License at
|
|
|
|
*
|
|
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
*
|
|
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
|
|
* See the License for the specific language governing permissions and
|
|
|
|
* limitations under the License.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef APU_VERSION_H
|
|
|
|
#define APU_VERSION_H
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @file apu_version.h
|
|
|
|
* @brief APR-util Versioning Interface
|
|
|
|
*
|
|
|
|
* APR-util's Version
|
|
|
|
*
|
|
|
|
* There are several different mechanisms for accessing the version. There
|
|
|
|
* is a string form, and a set of numbers; in addition, there are constants
|
|
|
|
* which can be compiled into your application, and you can query the library
|
|
|
|
* being used for its actual version.
|
|
|
|
*
|
|
|
|
* Note that it is possible for an application to detect that it has been
|
|
|
|
* compiled against a different version of APU by use of the compile-time
|
|
|
|
* constants and the use of the run-time query function.
|
|
|
|
*
|
|
|
|
* APU version numbering follows the guidelines specified in:
|
|
|
|
*
|
|
|
|
* http://apr.apache.org/versioning.html
|
|
|
|
*/
|
|
|
|
|
|
|
|
|
2013-11-25 22:15:47 +00:00
|
|
|
#define APU_COPYRIGHT "Copyright (c) 2013 The Apache Software " \
|
|
|
|
"Foundation or its licensors, as applicable."
|
|
|
|
|
2013-06-18 01:59:55 +00:00
|
|
|
/* The numeric compile-time version constants. These constants are the
|
|
|
|
* authoritative version numbers for APU.
|
|
|
|
*/
|
|
|
|
|
|
|
|
/** major version
|
|
|
|
* Major API changes that could cause compatibility problems for older
|
|
|
|
* programs such as structure size changes. No binary compatibility is
|
|
|
|
* possible across a change in the major version.
|
|
|
|
*/
|
|
|
|
#define APU_MAJOR_VERSION 1
|
|
|
|
|
|
|
|
/** minor version
|
|
|
|
* Minor API changes that do not cause binary compatibility problems.
|
|
|
|
* Reset to 0 when upgrading APU_MAJOR_VERSION
|
|
|
|
*/
|
2013-07-28 05:14:54 +00:00
|
|
|
#define APU_MINOR_VERSION 5
|
2013-06-18 01:59:55 +00:00
|
|
|
|
|
|
|
/** patch level
|
|
|
|
* The Patch Level never includes API changes, simply bug fixes.
|
|
|
|
* Reset to 0 when upgrading APR_MINOR_VERSION
|
|
|
|
*/
|
2013-11-25 22:15:47 +00:00
|
|
|
#define APU_PATCH_VERSION 3
|
2013-06-18 01:59:55 +00:00
|
|
|
|
|
|
|
/**
|
|
|
|
* The symbol APU_IS_DEV_VERSION is only defined for internal,
|
|
|
|
* "development" copies of APU. It is undefined for released versions
|
|
|
|
* of APU.
|
|
|
|
*/
|
|
|
|
/* #define APU_IS_DEV_VERSION */
|
|
|
|
|
|
|
|
|
|
|
|
#if defined(APU_IS_DEV_VERSION) || defined(DOXYGEN)
|
|
|
|
/** Internal: string form of the "is dev" flag */
|
2013-11-25 22:15:47 +00:00
|
|
|
#ifndef APU_IS_DEV_STRING
|
2013-06-18 01:59:55 +00:00
|
|
|
#define APU_IS_DEV_STRING "-dev"
|
2013-11-25 22:15:47 +00:00
|
|
|
#endif
|
2013-06-18 01:59:55 +00:00
|
|
|
#else
|
|
|
|
#define APU_IS_DEV_STRING ""
|
|
|
|
#endif
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef APU_STRINGIFY
|
|
|
|
/** Properly quote a value as a string in the C preprocessor */
|
|
|
|
#define APU_STRINGIFY(n) APU_STRINGIFY_HELPER(n)
|
|
|
|
/** Helper macro for APU_STRINGIFY */
|
|
|
|
#define APU_STRINGIFY_HELPER(n) #n
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/** The formatted string of APU's version */
|
|
|
|
#define APU_VERSION_STRING \
|
|
|
|
APU_STRINGIFY(APU_MAJOR_VERSION) "." \
|
|
|
|
APU_STRINGIFY(APU_MINOR_VERSION) "." \
|
|
|
|
APU_STRINGIFY(APU_PATCH_VERSION) \
|
|
|
|
APU_IS_DEV_STRING
|
|
|
|
|
|
|
|
/** An alternative formatted string of APR's version */
|
|
|
|
/* macro for Win32 .rc files using numeric csv representation */
|
|
|
|
#define APU_VERSION_STRING_CSV APU_MAJOR_VERSION ##, \
|
|
|
|
##APU_MINOR_VERSION ##, \
|
|
|
|
##APU_PATCH_VERSION
|
|
|
|
|
|
|
|
|
|
|
|
#ifndef APU_VERSION_ONLY
|
|
|
|
|
|
|
|
/* The C language API to access the version at run time,
|
|
|
|
* as opposed to compile time. APU_VERSION_ONLY may be defined
|
|
|
|
* externally when preprocessing apr_version.h to obtain strictly
|
|
|
|
* the C Preprocessor macro declarations.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#include "apr_version.h"
|
|
|
|
|
|
|
|
#include "apu.h"
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
extern "C" {
|
|
|
|
#endif
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return APR-util's version information information in a numeric form.
|
|
|
|
*
|
|
|
|
* @param pvsn Pointer to a version structure for returning the version
|
|
|
|
* information.
|
|
|
|
*/
|
|
|
|
APU_DECLARE(void) apu_version(apr_version_t *pvsn);
|
|
|
|
|
|
|
|
/** Return APU's version information as a string. */
|
|
|
|
APU_DECLARE(const char *) apu_version_string(void);
|
|
|
|
|
|
|
|
#ifdef __cplusplus
|
|
|
|
}
|
|
|
|
#endif
|
|
|
|
|
|
|
|
#endif /* ndef APU_VERSION_ONLY */
|
|
|
|
|
|
|
|
#endif /* ndef APU_VERSION_H */
|