Annotation of embedaddon/php/main/php.h, revision 1.1.1.1
1.1 misho 1: /*
2: +----------------------------------------------------------------------+
3: | PHP Version 5 |
4: +----------------------------------------------------------------------+
5: | Copyright (c) 1997-2012 The PHP Group |
6: +----------------------------------------------------------------------+
7: | This source file is subject to version 3.01 of the PHP license, |
8: | that is bundled with this package in the file LICENSE, and is |
9: | available through the world-wide-web at the following url: |
10: | http://www.php.net/license/3_01.txt |
11: | If you did not receive a copy of the PHP license and are unable to |
12: | obtain it through the world-wide-web, please send a note to |
13: | license@php.net so we can mail you a copy immediately. |
14: +----------------------------------------------------------------------+
15: | Authors: Andi Gutmans <andi@zend.com> |
16: | Zeev Suraski <zeev@zend.com> |
17: +----------------------------------------------------------------------+
18: */
19:
20: /* $Id: php.h 321634 2012-01-01 13:15:04Z felipe $ */
21:
22: #ifndef PHP_H
23: #define PHP_H
24:
25: #ifdef HAVE_DMALLOC
26: #include <dmalloc.h>
27: #endif
28:
29: #define PHP_API_VERSION 20090626
30: #define PHP_HAVE_STREAMS
31: #define YYDEBUG 0
32:
33: #include "php_version.h"
34: #include "zend.h"
35: #include "zend_qsort.h"
36: #include "php_compat.h"
37:
38: #include "zend_API.h"
39:
40: #undef sprintf
41: #define sprintf php_sprintf
42:
43: /* PHP's DEBUG value must match Zend's ZEND_DEBUG value */
44: #undef PHP_DEBUG
45: #define PHP_DEBUG ZEND_DEBUG
46:
47: #ifdef PHP_WIN32
48: # include "tsrm_win32.h"
49: # include "win95nt.h"
50: # ifdef PHP_EXPORTS
51: # define PHPAPI __declspec(dllexport)
52: # else
53: # define PHPAPI __declspec(dllimport)
54: # endif
55: # define PHP_DIR_SEPARATOR '\\'
56: # define PHP_EOL "\r\n"
57: #else
58: # if defined(__GNUC__) && __GNUC__ >= 4
59: # define PHPAPI __attribute__ ((visibility("default")))
60: # else
61: # define PHPAPI
62: # endif
63:
64: #define THREAD_LS
65: #define PHP_DIR_SEPARATOR '/'
66: #if defined(__MacOSX__)
67: #define PHP_EOL "\r"
68: #else
69: #define PHP_EOL "\n"
70: #endif
71: #endif
72:
73: #ifdef NETWARE
74: /* For php_get_uname() function */
75: #define PHP_UNAME "NetWare"
76: #define PHP_OS PHP_UNAME
77: #endif
78:
79: #if HAVE_ASSERT_H
80: #if PHP_DEBUG
81: #undef NDEBUG
82: #else
83: #ifndef NDEBUG
84: #define NDEBUG
85: #endif
86: #endif
87: #include <assert.h>
88: #else /* HAVE_ASSERT_H */
89: #define assert(expr) ((void) (0))
90: #endif /* HAVE_ASSERT_H */
91:
92: #define APACHE 0
93:
94: #if HAVE_UNIX_H
95: #include <unix.h>
96: #endif
97:
98: #if HAVE_ALLOCA_H
99: #include <alloca.h>
100: #endif
101:
102: #if HAVE_BUILD_DEFS_H
103: #include <build-defs.h>
104: #endif
105:
106: /*
107: * This is a fast version of strlcpy which should be used, if you
108: * know the size of the destination buffer and if you know
109: * the length of the source string.
110: *
111: * size is the allocated number of bytes of dst
112: * src_size is the number of bytes excluding the NUL of src
113: */
114:
115: #define PHP_STRLCPY(dst, src, size, src_size) \
116: { \
117: size_t php_str_len; \
118: \
119: if (src_size >= size) \
120: php_str_len = size - 1; \
121: else \
122: php_str_len = src_size; \
123: memcpy(dst, src, php_str_len); \
124: dst[php_str_len] = '\0'; \
125: }
126:
127: #ifndef HAVE_STRLCPY
128: BEGIN_EXTERN_C()
129: PHPAPI size_t php_strlcpy(char *dst, const char *src, size_t siz);
130: END_EXTERN_C()
131: #undef strlcpy
132: #define strlcpy php_strlcpy
133: #endif
134:
135: #ifndef HAVE_STRLCAT
136: BEGIN_EXTERN_C()
137: PHPAPI size_t php_strlcat(char *dst, const char *src, size_t siz);
138: END_EXTERN_C()
139: #undef strlcat
140: #define strlcat php_strlcat
141: #endif
142:
143: #ifndef HAVE_STRTOK_R
144: BEGIN_EXTERN_C()
145: char *strtok_r(char *s, const char *delim, char **last);
146: END_EXTERN_C()
147: #endif
148:
149: #ifndef HAVE_SOCKLEN_T
150: typedef unsigned int socklen_t;
151: #endif
152:
153: #define CREATE_MUTEX(a, b)
154: #define SET_MUTEX(a)
155: #define FREE_MUTEX(a)
156:
157: /*
158: * Then the ODBC support can use both iodbc and Solid,
159: * uncomment this.
160: * #define HAVE_ODBC (HAVE_IODBC|HAVE_SOLID)
161: */
162:
163: #include <stdlib.h>
164: #include <ctype.h>
165: #if HAVE_UNISTD_H
166: #include <unistd.h>
167: #endif
168: #if HAVE_STDARG_H
169: #include <stdarg.h>
170: #else
171: # if HAVE_SYS_VARARGS_H
172: # include <sys/varargs.h>
173: # endif
174: #endif
175:
176: #ifndef va_copy
177: # ifdef __va_copy
178: # define va_copy(ap1, ap2) __va_copy((ap1), (ap2))
179: # else
180: # define va_copy(ap1, ap2) memcpy((&ap1), (&ap2), sizeof(va_list))
181: # endif
182: #endif
183:
184: #include "zend_hash.h"
185: #include "php3_compat.h"
186: #include "zend_alloc.h"
187: #include "zend_stack.h"
188:
189: #if STDC_HEADERS
190: # include <string.h>
191: #else
192: # ifndef HAVE_MEMCPY
193: # define memcpy(d, s, n) bcopy((s), (d), (n))
194: # endif
195: # ifndef HAVE_MEMMOVE
196: # define memmove(d, s, n) bcopy ((s), (d), (n))
197: # endif
198: #endif
199:
200: #include "safe_mode.h"
201:
202: #ifndef HAVE_STRERROR
203: char *strerror(int);
204: #endif
205:
206: #if HAVE_PWD_H
207: # ifdef PHP_WIN32
208: #include "win32/param.h"
209: # else
210: #include <pwd.h>
211: #include <sys/param.h>
212: # endif
213: #endif
214:
215: #if HAVE_LIMITS_H
216: #include <limits.h>
217: #endif
218:
219: #ifndef LONG_MAX
220: #define LONG_MAX 2147483647L
221: #endif
222:
223: #ifndef LONG_MIN
224: #define LONG_MIN (- LONG_MAX - 1)
225: #endif
226:
227: #ifndef INT_MAX
228: #define INT_MAX 2147483647
229: #endif
230:
231: #ifndef INT_MIN
232: #define INT_MIN (- INT_MAX - 1)
233: #endif
234:
235: #define PHP_GCC_VERSION ZEND_GCC_VERSION
236: #define PHP_ATTRIBUTE_MALLOC ZEND_ATTRIBUTE_MALLOC
237: #define PHP_ATTRIBUTE_FORMAT ZEND_ATTRIBUTE_FORMAT
238:
239: BEGIN_EXTERN_C()
240: #include "snprintf.h"
241: END_EXTERN_C()
242: #include "spprintf.h"
243:
244: #define EXEC_INPUT_BUF 4096
245:
246: #define PHP_MIME_TYPE "application/x-httpd-php"
247:
248: /* macros */
249: #define STR_PRINT(str) ((str)?(str):"")
250:
251: #ifndef MAXPATHLEN
252: # ifdef PATH_MAX
253: # define MAXPATHLEN PATH_MAX
254: # elif defined(MAX_PATH)
255: # define MAXPATHLEN MAX_PATH
256: # else
257: # define MAXPATHLEN 256 /* Should be safe for any weird systems that do not define it */
258: # endif
259: #endif
260:
261:
262: /* global variables */
263: #if !defined(PHP_WIN32)
264: #define PHP_SLEEP_NON_VOID
265: #define php_sleep sleep
266: extern char **environ;
267: #endif /* !defined(PHP_WIN32) */
268:
269: #ifdef PHP_PWRITE_64
270: ssize_t pwrite(int, void *, size_t, off64_t);
271: #endif
272:
273: #ifdef PHP_PREAD_64
274: ssize_t pread(int, void *, size_t, off64_t);
275: #endif
276:
277: BEGIN_EXTERN_C()
278: void phperror(char *error);
279: PHPAPI int php_write(void *buf, uint size TSRMLS_DC);
280: PHPAPI int php_printf(const char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 1,
281: 2);
282: PHPAPI void php_log_err(char *log_message TSRMLS_DC);
283: int Debug(char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 1, 2);
284: int cfgparse(void);
285: END_EXTERN_C()
286:
287: #define php_error zend_error
288: #define error_handling_t zend_error_handling_t
289:
290: BEGIN_EXTERN_C()
291: static inline ZEND_ATTRIBUTE_DEPRECATED void php_set_error_handling(error_handling_t error_handling, zend_class_entry *exception_class TSRMLS_DC)
292: {
293: zend_replace_error_handling(error_handling, exception_class, NULL TSRMLS_CC);
294: }
295: static inline ZEND_ATTRIBUTE_DEPRECATED void php_std_error_handling() {}
296:
297: PHPAPI void php_verror(const char *docref, const char *params, int type, const char *format, va_list args TSRMLS_DC) PHP_ATTRIBUTE_FORMAT(printf, 4, 0);
298:
299: #ifdef ZTS
300: #define PHP_ATTR_FMT_OFFSET 1
301: #else
302: #define PHP_ATTR_FMT_OFFSET 0
303: #endif
304:
305: /* PHPAPI void php_error(int type, const char *format, ...); */
306: PHPAPI void php_error_docref0(const char *docref TSRMLS_DC, int type, const char *format, ...)
307: PHP_ATTRIBUTE_FORMAT(printf, PHP_ATTR_FMT_OFFSET + 3, PHP_ATTR_FMT_OFFSET + 4);
308: PHPAPI void php_error_docref1(const char *docref TSRMLS_DC, const char *param1, int type, const char *format, ...)
309: PHP_ATTRIBUTE_FORMAT(printf, PHP_ATTR_FMT_OFFSET + 4, PHP_ATTR_FMT_OFFSET + 5);
310: PHPAPI void php_error_docref2(const char *docref TSRMLS_DC, const char *param1, const char *param2, int type, const char *format, ...)
311: PHP_ATTRIBUTE_FORMAT(printf, PHP_ATTR_FMT_OFFSET + 5, PHP_ATTR_FMT_OFFSET + 6);
312: #ifdef PHP_WIN32
313: PHPAPI void php_win32_docref2_from_error(DWORD error, const char *param1, const char *param2 TSRMLS_DC);
314: #endif
315: END_EXTERN_C()
316:
317: #define php_error_docref php_error_docref0
318:
319: #define zenderror phperror
320: #define zendlex phplex
321:
322: #define phpparse zendparse
323: #define phprestart zendrestart
324: #define phpin zendin
325:
326: #define php_memnstr zend_memnstr
327:
328: /* functions */
329: BEGIN_EXTERN_C()
330: PHPAPI extern int (*php_register_internal_extensions_func)(TSRMLS_D);
331: PHPAPI int php_register_internal_extensions(TSRMLS_D);
332: PHPAPI int php_mergesort(void *base, size_t nmemb, register size_t size, int (*cmp)(const void *, const void * TSRMLS_DC) TSRMLS_DC);
333: PHPAPI void php_register_pre_request_shutdown(void (*func)(void *), void *userdata);
334: PHPAPI void php_com_initialize(TSRMLS_D);
335: END_EXTERN_C()
336:
337: /* PHP-named Zend macro wrappers */
338: #define PHP_FN ZEND_FN
339: #define PHP_MN ZEND_MN
340: #define PHP_NAMED_FUNCTION ZEND_NAMED_FUNCTION
341: #define PHP_FUNCTION ZEND_FUNCTION
342: #define PHP_METHOD ZEND_METHOD
343:
344: #define PHP_RAW_NAMED_FE ZEND_RAW_NAMED_FE
345: #define PHP_NAMED_FE ZEND_NAMED_FE
346: #define PHP_FE ZEND_FE
347: #define PHP_DEP_FE ZEND_DEP_FE
348: #define PHP_FALIAS ZEND_FALIAS
349: #define PHP_DEP_FALIAS ZEND_DEP_FALIAS
350: #define PHP_ME ZEND_ME
351: #define PHP_MALIAS ZEND_MALIAS
352: #define PHP_ABSTRACT_ME ZEND_ABSTRACT_ME
353: #define PHP_ME_MAPPING ZEND_ME_MAPPING
354: #define PHP_FE_END ZEND_FE_END
355:
356: #define PHP_MODULE_STARTUP_N ZEND_MODULE_STARTUP_N
357: #define PHP_MODULE_SHUTDOWN_N ZEND_MODULE_SHUTDOWN_N
358: #define PHP_MODULE_ACTIVATE_N ZEND_MODULE_ACTIVATE_N
359: #define PHP_MODULE_DEACTIVATE_N ZEND_MODULE_DEACTIVATE_N
360: #define PHP_MODULE_INFO_N ZEND_MODULE_INFO_N
361:
362: #define PHP_MODULE_STARTUP_D ZEND_MODULE_STARTUP_D
363: #define PHP_MODULE_SHUTDOWN_D ZEND_MODULE_SHUTDOWN_D
364: #define PHP_MODULE_ACTIVATE_D ZEND_MODULE_ACTIVATE_D
365: #define PHP_MODULE_DEACTIVATE_D ZEND_MODULE_DEACTIVATE_D
366: #define PHP_MODULE_INFO_D ZEND_MODULE_INFO_D
367:
368: /* Compatibility macros */
369: #define PHP_MINIT ZEND_MODULE_STARTUP_N
370: #define PHP_MSHUTDOWN ZEND_MODULE_SHUTDOWN_N
371: #define PHP_RINIT ZEND_MODULE_ACTIVATE_N
372: #define PHP_RSHUTDOWN ZEND_MODULE_DEACTIVATE_N
373: #define PHP_MINFO ZEND_MODULE_INFO_N
374: #define PHP_GINIT ZEND_GINIT
375: #define PHP_GSHUTDOWN ZEND_GSHUTDOWN
376:
377: #define PHP_MINIT_FUNCTION ZEND_MODULE_STARTUP_D
378: #define PHP_MSHUTDOWN_FUNCTION ZEND_MODULE_SHUTDOWN_D
379: #define PHP_RINIT_FUNCTION ZEND_MODULE_ACTIVATE_D
380: #define PHP_RSHUTDOWN_FUNCTION ZEND_MODULE_DEACTIVATE_D
381: #define PHP_MINFO_FUNCTION ZEND_MODULE_INFO_D
382: #define PHP_GINIT_FUNCTION ZEND_GINIT_FUNCTION
383: #define PHP_GSHUTDOWN_FUNCTION ZEND_GSHUTDOWN_FUNCTION
384:
385: #define PHP_MODULE_GLOBALS ZEND_MODULE_GLOBALS
386:
387:
388: /* Output support */
389: #include "main/php_output.h"
390: #define PHPWRITE(str, str_len) php_body_write((str), (str_len) TSRMLS_CC)
391: #define PUTS(str) do { \
392: const char *__str = (str); \
393: php_body_write(__str, strlen(__str) TSRMLS_CC); \
394: } while (0)
395:
396: #define PUTC(c) (php_body_write(&(c), 1 TSRMLS_CC), (c))
397: #define PHPWRITE_H(str, str_len) php_header_write((str), (str_len) TSRMLS_CC)
398: #define PUTS_H(str) do { \
399: const char *__str = (str); \
400: php_header_write(__str, strlen(__str) TSRMLS_CC); \
401: } while (0)
402:
403: #define PUTC_H(c) (php_header_write(&(c), 1 TSRMLS_CC), (c))
404:
405: #include "php_streams.h"
406: #include "php_memory_streams.h"
407: #include "fopen_wrappers.h"
408:
409:
410: /* Virtual current working directory support */
411: #include "tsrm_virtual_cwd.h"
412:
413: #include "zend_constants.h"
414:
415: /* connection status states */
416: #define PHP_CONNECTION_NORMAL 0
417: #define PHP_CONNECTION_ABORTED 1
418: #define PHP_CONNECTION_TIMEOUT 2
419:
420: #include "php_reentrancy.h"
421:
422: /* Finding offsets of elements within structures.
423: * Taken from the Apache code, which in turn, was taken from X code...
424: */
425:
426: #ifndef XtOffset
427: #if defined(CRAY) || (defined(__arm) && !(defined(LINUX) || defined(__riscos__)))
428: #ifdef __STDC__
429: #define XtOffset(p_type, field) _Offsetof(p_type, field)
430: #else
431: #ifdef CRAY2
432: #define XtOffset(p_type, field) \
433: (sizeof(int)*((unsigned int)&(((p_type)NULL)->field)))
434:
435: #else /* !CRAY2 */
436:
437: #define XtOffset(p_type, field) ((unsigned int)&(((p_type)NULL)->field))
438:
439: #endif /* !CRAY2 */
440: #endif /* __STDC__ */
441: #else /* ! (CRAY || __arm) */
442:
443: #define XtOffset(p_type, field) \
444: ((long) (((char *) (&(((p_type)NULL)->field))) - ((char *) NULL)))
445:
446: #endif /* !CRAY */
447: #endif /* ! XtOffset */
448:
449: #ifndef XtOffsetOf
450: #ifdef offsetof
451: #define XtOffsetOf(s_type, field) offsetof(s_type, field)
452: #else
453: #define XtOffsetOf(s_type, field) XtOffset(s_type*, field)
454: #endif
455: #endif /* !XtOffsetOf */
456:
457: #if SUHOSIN_PATCH
458: #include "suhosin_patch.h"
459: #endif
460:
461: #endif
462:
463: /*
464: * Local variables:
465: * tab-width: 4
466: * c-basic-offset: 4
467: * End:
468: * vim600: sw=4 ts=4 fdm=marker
469: * vim<600: sw=4 ts=4
470: */
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>