Annotation of parser3/src/lib/sdbm/apr-include/apr.h, revision 1.4
1.2 paf 1: /* ====================================================================
2: * The Apache Software License, Version 1.1
3: *
4: * Copyright (c) 2000-2002 The Apache Software Foundation. All rights
5: * reserved.
6: *
7: * Redistribution and use in source and binary forms, with or without
8: * modification, are permitted provided that the following conditions
9: * are met:
10: *
11: * 1. Redistributions of source code must retain the above copyright
12: * notice, this list of conditions and the following disclaimer.
13: *
14: * 2. Redistributions in binary form must reproduce the above copyright
15: * notice, this list of conditions and the following disclaimer in
16: * the documentation and/or other materials provided with the
17: * distribution.
18: *
19: * 3. The end-user documentation included with the redistribution,
20: * if any, must include the following acknowledgment:
21: * "This product includes software developed by the
22: * Apache Software Foundation (http://www.apache.org/)."
23: * Alternately, this acknowledgment may appear in the software itself,
24: * if and wherever such third-party acknowledgments normally appear.
25: *
26: * 4. The names "Apache" and "Apache Software Foundation" must
27: * not be used to endorse or promote products derived from this
28: * software without prior written permission. For written
29: * permission, please contact apache@apache.org.
30: *
31: * 5. Products derived from this software may not be called "Apache",
32: * nor may "Apache" appear in their name, without prior written
33: * permission of the Apache Software Foundation.
34: *
35: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
36: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
37: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
38: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
39: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
40: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
41: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
42: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
43: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
44: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
45: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
46: * SUCH DAMAGE.
47: * ====================================================================
48: *
49: * This software consists of voluntary contributions made by many
50: * individuals on behalf of the Apache Software Foundation. For more
51: * information on the Apache Software Foundation, please see
52: * <http://www.apache.org/>.
53: */
54:
55: #ifndef APR_H
56: #define APR_H
57:
1.4 ! paf 58: #include <stddef.h>
! 59:
1.2 paf 60: typedef int apr_int32_t;
61:
62: /**
63: * APR_DECLARE_EXPORT is defined when building the APR dynamic library,
64: * so that all public symbols are exported.
65: *
66: * APR_DECLARE_STATIC is defined when including the APR public headers,
67: * to provide static linkage when the dynamic library may be unavailable.
68: *
69: * APR_DECLARE_STATIC and APR_DECLARE_EXPORT are left undefined when
70: * including the APR public headers, to import and link the symbols from the
71: * dynamic APR library and assure appropriate indirection and calling
72: * conventions at compile time.
73: */
74:
75: /**
76: * The public APR functions are declared with APR_DECLARE(), so they may
77: * use the most appropriate calling convention. Public APR functions with
78: * variable arguments must use APR_DECLARE_NONSTD().
79: *
80: * @deffunc APR_DECLARE(rettype) apr_func(args);
81: */
82: #define APR_DECLARE(type) type
83:
84: /**
85: * The public APR functions using variable arguments are declared with
86: * AP_DECLARE(), as they must use the C language calling convention.
87: *
88: * @deffunc APR_DECLARE_NONSTD(rettype) apr_func(args, ...);
89: */
90: #define APR_DECLARE_NONSTD(type) type
91:
92: /**
93: * The public APR variables are declared with AP_MODULE_DECLARE_DATA.
94: * This assures the appropriate indirection is invoked at compile time.
95: *
96: * @deffunc APR_DECLARE_DATA type apr_variable;
97: * @tip APR_DECLARE_DATA extern type apr_variable; syntax is required for
98: * declarations within headers to properly import the variable.
99: */
100: #define APR_DECLARE_DATA
101:
102: typedef int apr_off_t;
103: typedef size_t apr_size_t;
104:
105: #endif /* APR_H */
106:
E-mail: