Annotation of embedaddon/php/Zend/zend_ini.h, revision 1.1

1.1     ! misho       1: /*
        !             2:    +----------------------------------------------------------------------+
        !             3:    | Zend Engine                                                          |
        !             4:    +----------------------------------------------------------------------+
        !             5:    | Copyright (c) 1998-2012 Zend Technologies Ltd. (http://www.zend.com) |
        !             6:    +----------------------------------------------------------------------+
        !             7:    | This source file is subject to version 2.00 of the Zend 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.zend.com/license/2_00.txt.                                |
        !            11:    | If you did not receive a copy of the Zend license and are unable to  |
        !            12:    | obtain it through the world-wide-web, please send a note to          |
        !            13:    | license@zend.com so we can mail you a copy immediately.              |
        !            14:    +----------------------------------------------------------------------+
        !            15:    | Author: Zeev Suraski <zeev@zend.com>                                 |
        !            16:    +----------------------------------------------------------------------+
        !            17: */
        !            18: 
        !            19: /* $Id: zend_ini.h 321634 2012-01-01 13:15:04Z felipe $ */
        !            20: 
        !            21: #ifndef ZEND_INI_H
        !            22: #define ZEND_INI_H
        !            23: 
        !            24: #define ZEND_INI_USER  (1<<0)
        !            25: #define ZEND_INI_PERDIR        (1<<1)
        !            26: #define ZEND_INI_SYSTEM        (1<<2)
        !            27: 
        !            28: #define ZEND_INI_ALL (ZEND_INI_USER|ZEND_INI_PERDIR|ZEND_INI_SYSTEM)
        !            29: 
        !            30: #ifndef XtOffsetOf
        !            31: # if defined(CRAY) || (defined(__arm) && !defined(LINUX))
        !            32: # ifdef __STDC__
        !            33: # define XtOffset(p_type, field) _Offsetof(p_type, field)
        !            34: # else
        !            35: # ifdef CRAY2
        !            36: # define XtOffset(p_type, field) \
        !            37:     (sizeof(int)*((unsigned int)&(((p_type)NULL)->field)))
        !            38: 
        !            39: # else /* !CRAY2 */
        !            40: 
        !            41: # define XtOffset(p_type, field) ((unsigned int)&(((p_type)NULL)->field))
        !            42: 
        !            43: # endif /* !CRAY2 */
        !            44: # endif /* __STDC__ */
        !            45: # else /* ! (CRAY || __arm) */
        !            46: 
        !            47: # define XtOffset(p_type, field) \
        !            48:     ((long) (((char *) (&(((p_type)NULL)->field))) - ((char *) NULL)))
        !            49: 
        !            50: # endif /* !CRAY */
        !            51: 
        !            52: # ifdef offsetof
        !            53: # define XtOffsetOf(s_type, field) offsetof(s_type, field)
        !            54: # else
        !            55: # define XtOffsetOf(s_type, field) XtOffset(s_type*, field)
        !            56: # endif
        !            57: 
        !            58: #endif
        !            59: 
        !            60: typedef struct _zend_ini_entry zend_ini_entry;
        !            61: 
        !            62: #define ZEND_INI_MH(name) int name(zend_ini_entry *entry, char *new_value, uint new_value_length, void *mh_arg1, void *mh_arg2, void *mh_arg3, int stage TSRMLS_DC)
        !            63: #define ZEND_INI_DISP(name) void name(zend_ini_entry *ini_entry, int type)
        !            64: 
        !            65: struct _zend_ini_entry {
        !            66:        int module_number;
        !            67:        int modifiable;
        !            68:        char *name;
        !            69:        uint name_length;
        !            70:        ZEND_INI_MH((*on_modify));
        !            71:        void *mh_arg1;
        !            72:        void *mh_arg2;
        !            73:        void *mh_arg3;
        !            74: 
        !            75:        char *value;
        !            76:        uint value_length;
        !            77: 
        !            78:        char *orig_value;
        !            79:        uint orig_value_length;
        !            80:        int orig_modifiable;
        !            81:        int modified;
        !            82: 
        !            83:        void (*displayer)(zend_ini_entry *ini_entry, int type);
        !            84: };
        !            85: 
        !            86: BEGIN_EXTERN_C()
        !            87: ZEND_API int zend_ini_startup(TSRMLS_D);
        !            88: ZEND_API int zend_ini_shutdown(TSRMLS_D);
        !            89: ZEND_API int zend_ini_global_shutdown(TSRMLS_D);
        !            90: ZEND_API int zend_ini_deactivate(TSRMLS_D);
        !            91: 
        !            92: ZEND_API int zend_copy_ini_directives(TSRMLS_D);
        !            93: 
        !            94: ZEND_API void zend_ini_sort_entries(TSRMLS_D);
        !            95: 
        !            96: ZEND_API int zend_register_ini_entries(const zend_ini_entry *ini_entry, int module_number TSRMLS_DC);
        !            97: ZEND_API void zend_unregister_ini_entries(int module_number TSRMLS_DC);
        !            98: ZEND_API void zend_ini_refresh_caches(int stage TSRMLS_DC);
        !            99: ZEND_API int zend_alter_ini_entry(char *name, uint name_length, char *new_value, uint new_value_length, int modify_type, int stage);
        !           100: ZEND_API int zend_alter_ini_entry_ex(char *name, uint name_length, char *new_value, uint new_value_length, int modify_type, int stage, int force_change TSRMLS_DC);
        !           101: ZEND_API int zend_restore_ini_entry(char *name, uint name_length, int stage);
        !           102: ZEND_API void display_ini_entries(zend_module_entry *module);
        !           103: 
        !           104: ZEND_API long zend_ini_long(char *name, uint name_length, int orig);
        !           105: ZEND_API double zend_ini_double(char *name, uint name_length, int orig);
        !           106: ZEND_API char *zend_ini_string(char *name, uint name_length, int orig);
        !           107: ZEND_API char *zend_ini_string_ex(char *name, uint name_length, int orig, zend_bool *exists);
        !           108: 
        !           109: ZEND_API int zend_ini_register_displayer(char *name, uint name_length, void (*displayer)(zend_ini_entry *ini_entry, int type));
        !           110: 
        !           111: ZEND_API ZEND_INI_DISP(zend_ini_boolean_displayer_cb);
        !           112: ZEND_API ZEND_INI_DISP(zend_ini_color_displayer_cb);
        !           113: ZEND_API ZEND_INI_DISP(display_link_numbers);
        !           114: END_EXTERN_C()
        !           115: 
        !           116: #define ZEND_INI_BEGIN()               static const zend_ini_entry ini_entries[] = {
        !           117: #define ZEND_INI_END()         { 0, 0, NULL, 0, NULL, NULL, NULL, NULL, NULL, 0, NULL, 0, 0, 0, NULL } };
        !           118: 
        !           119: #define ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, arg3, displayer) \
        !           120:        { 0, modifiable, name, sizeof(name), on_modify, arg1, arg2, arg3, default_value, sizeof(default_value)-1, NULL, 0, 0, 0, displayer },
        !           121: 
        !           122: #define ZEND_INI_ENTRY3(name, default_value, modifiable, on_modify, arg1, arg2, arg3) \
        !           123:        ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, arg3, NULL)
        !           124: 
        !           125: #define ZEND_INI_ENTRY2_EX(name, default_value, modifiable, on_modify, arg1, arg2, displayer) \
        !           126:        ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, arg2, NULL, displayer)
        !           127: 
        !           128: #define ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, arg1, arg2) \
        !           129:        ZEND_INI_ENTRY2_EX(name, default_value, modifiable, on_modify, arg1, arg2, NULL)
        !           130: 
        !           131: #define ZEND_INI_ENTRY1_EX(name, default_value, modifiable, on_modify, arg1, displayer) \
        !           132:        ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, arg1, NULL, NULL, displayer)
        !           133: 
        !           134: #define ZEND_INI_ENTRY1(name, default_value, modifiable, on_modify, arg1) \
        !           135:        ZEND_INI_ENTRY1_EX(name, default_value, modifiable, on_modify, arg1, NULL)
        !           136:        
        !           137: #define ZEND_INI_ENTRY_EX(name, default_value, modifiable, on_modify, displayer) \
        !           138:        ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, NULL, NULL, NULL, displayer)
        !           139: 
        !           140: #define ZEND_INI_ENTRY(name, default_value, modifiable, on_modify) \
        !           141:        ZEND_INI_ENTRY_EX(name, default_value, modifiable, on_modify, NULL)
        !           142: 
        !           143: #ifdef ZTS
        !           144: #define STD_ZEND_INI_ENTRY(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
        !           145:        ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr##_id)
        !           146: #define STD_ZEND_INI_ENTRY_EX(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr, displayer) \
        !           147:        ZEND_INI_ENTRY2_EX(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr##_id, displayer)
        !           148: #define STD_ZEND_INI_BOOLEAN(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
        !           149:        ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr##_id, NULL, zend_ini_boolean_displayer_cb)
        !           150: #else
        !           151: #define STD_ZEND_INI_ENTRY(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
        !           152:        ZEND_INI_ENTRY2(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr)
        !           153: #define STD_ZEND_INI_ENTRY_EX(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr, displayer) \
        !           154:        ZEND_INI_ENTRY2_EX(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr, displayer)
        !           155: #define STD_ZEND_INI_BOOLEAN(name, default_value, modifiable, on_modify, property_name, struct_type, struct_ptr) \
        !           156:        ZEND_INI_ENTRY3_EX(name, default_value, modifiable, on_modify, (void *) XtOffsetOf(struct_type, property_name), (void *) &struct_ptr, NULL, zend_ini_boolean_displayer_cb)
        !           157: #endif
        !           158: 
        !           159: #define INI_INT(name) zend_ini_long((name), sizeof(name), 0)
        !           160: #define INI_FLT(name) zend_ini_double((name), sizeof(name), 0)
        !           161: #define INI_STR(name) zend_ini_string_ex((name), sizeof(name), 0, NULL)
        !           162: #define INI_BOOL(name) ((zend_bool) INI_INT(name))
        !           163: 
        !           164: #define INI_ORIG_INT(name)     zend_ini_long((name), sizeof(name), 1)
        !           165: #define INI_ORIG_FLT(name)     zend_ini_double((name), sizeof(name), 1)
        !           166: #define INI_ORIG_STR(name)     zend_ini_string((name), sizeof(name), 1)
        !           167: #define INI_ORIG_BOOL(name) ((zend_bool) INI_ORIG_INT(name))
        !           168: 
        !           169: #define REGISTER_INI_ENTRIES() zend_register_ini_entries(ini_entries, module_number TSRMLS_CC)
        !           170: #define UNREGISTER_INI_ENTRIES() zend_unregister_ini_entries(module_number TSRMLS_CC)
        !           171: #define DISPLAY_INI_ENTRIES() display_ini_entries(zend_module)
        !           172: 
        !           173: #define REGISTER_INI_DISPLAYER(name, displayer) zend_ini_register_displayer((name), sizeof(name), displayer)
        !           174: #define REGISTER_INI_BOOLEAN(name) REGISTER_INI_DISPLAYER(name, zend_ini_boolean_displayer_cb)
        !           175: 
        !           176: /* Standard message handlers */
        !           177: BEGIN_EXTERN_C()
        !           178: ZEND_API ZEND_INI_MH(OnUpdateBool);
        !           179: ZEND_API ZEND_INI_MH(OnUpdateLong);
        !           180: ZEND_API ZEND_INI_MH(OnUpdateLongGEZero);
        !           181: ZEND_API ZEND_INI_MH(OnUpdateReal);
        !           182: ZEND_API ZEND_INI_MH(OnUpdateString);
        !           183: ZEND_API ZEND_INI_MH(OnUpdateStringUnempty);
        !           184: END_EXTERN_C()
        !           185: 
        !           186: #define ZEND_INI_DISPLAY_ORIG  1
        !           187: #define ZEND_INI_DISPLAY_ACTIVE        2
        !           188: 
        !           189: #define ZEND_INI_STAGE_STARTUP         (1<<0)
        !           190: #define ZEND_INI_STAGE_SHUTDOWN                (1<<1)
        !           191: #define ZEND_INI_STAGE_ACTIVATE                (1<<2)
        !           192: #define ZEND_INI_STAGE_DEACTIVATE      (1<<3)
        !           193: #define ZEND_INI_STAGE_RUNTIME         (1<<4)
        !           194: #define ZEND_INI_STAGE_HTACCESS                (1<<5)
        !           195: 
        !           196: /* INI parsing engine */
        !           197: typedef void (*zend_ini_parser_cb_t)(zval *arg1, zval *arg2, zval *arg3, int callback_type, void *arg TSRMLS_DC);
        !           198: BEGIN_EXTERN_C()
        !           199: ZEND_API int zend_parse_ini_file(zend_file_handle *fh, zend_bool unbuffered_errors, int scanner_mode, zend_ini_parser_cb_t ini_parser_cb, void *arg TSRMLS_DC);
        !           200: ZEND_API int zend_parse_ini_string(char *str, zend_bool unbuffered_errors, int scanner_mode, zend_ini_parser_cb_t ini_parser_cb, void *arg TSRMLS_DC);
        !           201: END_EXTERN_C()
        !           202: 
        !           203: /* INI entries */
        !           204: #define ZEND_INI_PARSER_ENTRY     1 /* Normal entry: foo = bar */
        !           205: #define ZEND_INI_PARSER_SECTION          2 /* Section: [foobar] */
        !           206: #define ZEND_INI_PARSER_POP_ENTRY 3 /* Offset entry: foo[] = bar */
        !           207: 
        !           208: typedef struct _zend_ini_parser_param {
        !           209:        zend_ini_parser_cb_t ini_parser_cb;
        !           210:        void *arg;
        !           211: } zend_ini_parser_param;
        !           212: 
        !           213: #endif /* ZEND_INI_H */
        !           214: 
        !           215: /*
        !           216:  * Local variables:
        !           217:  * tab-width: 4
        !           218:  * c-basic-offset: 4
        !           219:  * indent-tabs-mode: t
        !           220:  * End:
        !           221:  */

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>