ap_config.h File Reference

Symbol export macros and hook functions. More...

#include "ap_hooks.h"
#include "os.h"
#include "ap_config_auto.h"
#include "ap_config_layout.h"
#include "apache_noprobes.h"

Include dependency graph for ap_config.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	AP_DECLARE_STATIC
#define	AP_DECLARE_EXPORT
#define	AP_DECLARE(type)   type
#define	AP_DECLARE_NONSTD(type)   type
#define	AP_DECLARE_DATA
#define	APREQ_DECLARE(d)   APR_DECLARE(d)
#define	APREQ_DECLARE_NONSTD(d)   APR_DECLARE_NONSTD(d)
#define	APREQ_DECLARE_DATA
#define	AP_MODULE_DECLARE(type)   type
#define	AP_MODULE_DECLARE_NONSTD(type)   type
#define	AP_MODULE_DECLARE_DATA
#define	DEFAULT_PIDLOG   "httpd.pid"
#define	AP_HAVE_RELIABLE_PIPED_LOGS   TRUE
#define	__has_attribute(x)   0
#define	AP_FN_ATTR_SENTINEL
#define	AP_FN_ATTR_WARN_UNUSED_RESULT
#define	AP_FN_ATTR_ALLOC_SIZE(x)
#define	AP_FN_ATTR_ALLOC_SIZE2(x, y)
#define	AP_FN_ATTR_NONNULL_ALL
#define	AP_FN_ATTR_NONNULL(x)

Detailed Description

Symbol export macros and hook functions.

Macro Definition Documentation

__has_attribute

#define __has_attribute

(

x

)

0

AP_DECLARE

#define AP_DECLARE

(

type

)

type

Apache Core dso functions are declared with AP_DECLARE(), so they may use the most appropriate calling convention. Hook functions and other Core functions with variable arguments must use AP_DECLARE_NONSTD().

AP_DECLARE(rettype) ap_func(args)

AP_DECLARE_DATA

#define AP_DECLARE_DATA

Apache Core dso variables are declared with AP_MODULE_DECLARE_DATA. This assures the appropriate indirection is invoked at compile time.

Note

AP_DECLARE_DATA extern type apr_variable; syntax is required for declarations within headers to properly import the variable.

AP_DECLARE_DATA type apr_variable

AP_DECLARE_EXPORT

#define AP_DECLARE_EXPORT

AP_DECLARE_EXPORT is defined when building the Apache Core dynamic library, so that all public symbols are exported.

See also

AP_DECLARE_STATIC

AP_DECLARE_NONSTD

#define AP_DECLARE_NONSTD

(

type

)

type

Apache Core dso variable argument and hook functions are declared with AP_DECLARE_NONSTD(), as they must use the C language calling convention.

See also

AP_DECLARE

AP_DECLARE_NONSTD(rettype) ap_func(args [...])

AP_DECLARE_STATIC

#define AP_DECLARE_STATIC

AP_DECLARE_STATIC is defined when including Apache's Core headers, to provide static linkage when the dynamic library may be unavailable.

See also

AP_DECLARE_EXPORT

AP_DECLARE_STATIC and AP_DECLARE_EXPORT are left undefined when including Apache's Core headers, to import and link the symbols from the dynamic Apache Core library and assure appropriate indirection and calling conventions at compile time.

AP_FN_ATTR_ALLOC_SIZE

#define AP_FN_ATTR_ALLOC_SIZE

(

x

)

AP_FN_ATTR_ALLOC_SIZE2

#define AP_FN_ATTR_ALLOC_SIZE2	(		x,
			y
	)

AP_FN_ATTR_NONNULL

#define AP_FN_ATTR_NONNULL

(

x

)

AP_FN_ATTR_NONNULL_ALL

#define AP_FN_ATTR_NONNULL_ALL

AP_FN_ATTR_SENTINEL

#define AP_FN_ATTR_SENTINEL

AP_FN_ATTR_WARN_UNUSED_RESULT

#define AP_FN_ATTR_WARN_UNUSED_RESULT

AP_HAVE_RELIABLE_PIPED_LOGS

#define AP_HAVE_RELIABLE_PIPED_LOGS   TRUE

AP_MODULE_DECLARE

#define AP_MODULE_DECLARE

(

type

)

type

Declare a dso module's exported module structure as AP_MODULE_DECLARE_DATA.

Unless AP_MODULE_DECLARE_STATIC is defined at compile time, symbols declared with AP_MODULE_DECLARE_DATA are always exported.

module AP_MODULE_DECLARE_DATA mod_tag

AP_MODULE_DECLARE_DATA

#define AP_MODULE_DECLARE_DATA

AP_MODULE_DECLARE_NONSTD

#define AP_MODULE_DECLARE_NONSTD

(

type

)

type

APREQ_DECLARE

#define APREQ_DECLARE

(

d

)

APR_DECLARE(d)

The public APREQ functions are declared with APREQ_DECLARE(), so they may use the most appropriate calling convention. Public APR functions with variable arguments must use APR_DECLARE_NONSTD().

Remarks

Both the declaration and implementations must use the same macro. APREQ_DECLARE(rettype) apeq_func(args)

APREQ_DECLARE_DATA

#define APREQ_DECLARE_DATA

The public APREQ variables are declared with APREQ_DECLARE_DATA. This assures the appropriate indirection is invoked at compile time.

See also

APREQ_DECLARE

APREQ_DECLARE_NONSTD

Remarks

Note that the declaration and implementations use different forms, but both must include the macro. extern APREQ_DECLARE_DATA type apr_variable;
APREQ_DECLARE_DATA type apr_variable = value;

APREQ_DECLARE_NONSTD

#define APREQ_DECLARE_NONSTD

(

d

)

APR_DECLARE_NONSTD(d)

APEQ_DECLARE_NONSTD(rettype) apr_func(args, ...);

DEFAULT_PIDLOG

#define DEFAULT_PIDLOG   "httpd.pid"