24 #ifndef INI_CONFIGOBJ_H 25 #define INI_CONFIGOBJ_H 27 #include <sys/types.h> 32 #include "simplebuffer.h" 33 #include "ini_valueobj.h" 35 #ifndef DING_ATTR_FORMAT 36 # if ((__GNUC__ > 3) || ((__GNUC__ == 3) && (__GNUC_MINOR__ >= 3))) 37 # define DING_ATTR_FORMAT(fmt, args) __attribute__((__format__(__printf__, fmt, args))) 39 # define DING_ATTR_FORMAT(fmt, args) 226 #define INI_META_NONE 0 228 #define INI_META_STATS 1 247 #define INI_ACCESS_CHECK_MODE 0x00000001 255 #define INI_ACCESS_CHECK_UID 0x00000002 263 #define INI_ACCESS_CHECK_GID 0x00000004 287 #define INI_MV1S_OVERWRITE 0x0000 289 #define INI_MV1S_ERROR 0x0001 291 #define INI_MV1S_PRESERVE 0x0002 293 #define INI_MV1S_ALLOW 0x0003 295 #define INI_MV1S_DETECT 0x0004 314 #define INI_MV2S_OVERWRITE 0x0000 316 #define INI_MV2S_ERROR 0x0010 318 #define INI_MV2S_PRESERVE 0x0020 320 #define INI_MV2S_ALLOW 0x0030 322 #define INI_MV2S_DETECT 0x0040 340 #define INI_MS_MERGE 0x0000 342 #define INI_MS_ERROR 0x0100 344 #define INI_MS_OVERWRITE 0x0200 346 #define INI_MS_PRESERVE 0x0300 348 #define INI_MS_DETECT 0x0400 367 #define INI_PARSE_NOWRAP 0x0001 369 #define INI_PARSE_NOSPACE 0x0002 371 #define INI_PARSE_NOTAB 0x0004 373 #define INI_PARSE_NO_C_COMMENTS 0x0008 375 #define INI_PARSE_IGNORE_NON_KVP 0x0010 454 #define INI_DEFAULT_SECTION "default" 468 struct ini_parse_error;
551 uint32_t metadata_flags,
552 struct ini_cfgfile **file_ctx);
577 struct ini_cfgfile **file_ctx);
606 struct ini_cfgfile **file_ctx_out);
669 const char *backup_dir,
670 const char *backup_tpl,
706 struct ini_cfgobj *ini_config);
742 const char *filename,
744 struct ini_cfgobj *ini_config);
935 struct ini_cfgfile *file_ctx2,
962 uint32_t collision_flags,
963 uint32_t parse_flags,
964 struct ini_cfgobj *ini_config);
980 struct ini_cfgobj **ini_new);
1008 struct ini_cfgobj *second,
1009 uint32_t collision_flags,
1010 struct ini_cfgobj **result);
1077 const char *patterns[],
1078 const char *sections[],
1081 uint32_t collision_flags,
1082 uint32_t parse_flags,
1083 uint32_t merge_flags,
1084 struct ini_cfgobj **result_cfg,
1085 struct ref_array **error_list,
1086 struct ref_array **success_list);
1119 struct simplebuffer *sbobj);
1198 const char *section,
1256 struct ini_cfgobj *ini_config,
1258 struct value_obj **vo);
2101 const char *format, ...)
2102 DING_ATTR_FORMAT(2, 3);
2165 typedef
int (ini_validator_func)(const
char *rule_name,
2166 struct ini_cfgobj *rules_obj,
2167 struct ini_cfgobj *config_obj,
2168 struct ini_errobj *errobj,
2171 typedef
int (ini_schema_validator_func)(const
char *rule_name,
2172 struct ini_cfgobj *rules_obj,
2173 struct ini_errobj *errobj,
2181 ini_validator_func *func;
2183 ini_schema_validator_func *schema_validator;
2200 struct ini_cfgobj **_rules_obj);
2227 struct ini_cfgobj *config_obj,
2229 struct ini_errobj *errobj);
Definition: ini_configobj.h:191
Definition: ini_configobj.h:207
const char * ini_errobj_get_msg(struct ini_errobj *errobj)
Get pointer to current message in errobj.
int ini_get_config_valueobj(const char *section, const char *name, struct ini_cfgobj *ini_config, int mode, struct value_obj **vo)
Retrieve a value object form the configuration.
void ini_free_long_config_array(long *array)
Free array of long values.
void ini_config_file_print(struct ini_cfgfile *file_ctx)
Print file context.
Definition: ini_configobj.h:200
void ini_free_attribute_list(char **attr_list)
Free list of attributes.
mode_t mode
Definition: ini_configobj.h:429
int void ini_errobj_reset(struct ini_errobj *errobj)
Reset iterator in errobj.
ERR_LEVEL
Definition: ini_configobj.h:172
void ini_config_free_errors(char **errors)
Free array of parsing errors.
char ** ini_get_string_config_array(struct value_obj *vo, const char *sep, int *size, int *error)
Convert value to an array of strings.
Definition: ini_configobj.h:202
Definition: ini_configobj.h:175
Definition: ini_configobj.h:155
INI_GET
Definition: ini_configobj.h:400
int ini_config_save_as(struct ini_cfgfile *file_ctx, const char *filename, struct access_check *new_access, struct ini_cfgobj *ini_config)
Save configuration with a new name.
Definition: ini_configobj.h:198
const char * ini_config_get_filename(struct ini_cfgfile *file_ctx)
Get the fully resolved file name.
void ini_rules_destroy(struct ini_cfgobj *ini_config)
Free the rules.
Definition: ini_configobj.h:440
Definition: ini_configobj.h:402
int ini_rules_check(struct ini_cfgobj *rules_obj, struct ini_cfgobj *config_obj, struct ini_validator **extra_validators, struct ini_errobj *errobj)
Check configuration file using rules.
void ini_free_section_list(char **section_list)
Free list of sections.
uint32_t ini_get_uint32_config_value(struct value_obj *vo, int strict, uint32_t def, int *error)
Convert value to uint32_t number.
int ini_config_file_backup(struct ini_cfgfile *file_ctx, const char *backup_dir, const char *backup_tpl, struct access_check *backup_access, unsigned max_num)
Save configuration in a backup configuration file.
unsigned ini_config_error_count(struct ini_cfgobj *ini_config)
Check parsing errors count.
void ini_config_destroy(struct ini_cfgobj *ini_config)
Destroy a configuration object.
Definition: ini_configobj.h:206
int ini_config_changed(struct ini_cfgfile *file_ctx1, struct ini_cfgfile *file_ctx2, int *changed)
Check if file has changed.
Definition: ini_configobj.h:403
Definition: ini_configobj.h:192
long * ini_get_long_config_array(struct value_obj *vo, int *size, int *error)
Convert value to an array of long values.
int ini_config_file_reopen(struct ini_cfgfile *file_ctx_in, struct ini_cfgfile **file_ctx_out)
Reopen the configuration file.
long ini_get_long_config_value(struct value_obj *vo, int strict, long def, int *error)
Convert value to long number.
Definition: ini_configobj.h:195
unsigned ini_get_unsigned_config_value(struct value_obj *vo, int strict, unsigned def, int *error)
Convert value object to a unsigned number.
char ** ini_get_raw_string_config_array(struct value_obj *vo, const char *sep, int *size, int *error)
Convert value to an array of strings.
void ini_free_bin_config_value(char *bin)
Free binary buffer.
Definition: ini_configobj.h:420
int ini_config_get_errors(struct ini_cfgobj *ini_config, char ***errors)
Get array of parsing errors.
uid_t uid
Definition: ini_configobj.h:427
void ini_config_clean_state(struct ini_cfgobj *ini_config)
Flush cached search data.
Definition: ini_configobj.h:401
char * ini_get_string_config_value(struct value_obj *vo, int *error)
Get the copy of string stored in the configuration value.
Definition: ini_configobj.h:173
int ini_errobj_create(struct ini_errobj **_errobj)
Create structure to hold error messages.
uint64_t ini_get_uint64_config_value(struct value_obj *vo, int strict, uint64_t def, int *error)
Convert value to integer number.
int ini_config_merge(struct ini_cfgobj *first, struct ini_cfgobj *second, uint32_t collision_flags, struct ini_cfgobj **result)
Merge two configuration objects.
void ini_errobj_destroy(struct ini_errobj **errobj)
Free structure that holds error messages.
gid_t gid
Definition: ini_configobj.h:428
Definition: ini_configobj.h:199
int ini_config_set_wrap(struct ini_cfgobj *ini_config, uint32_t boundary)
Set the folding boundary.
Definition: ini_configobj.h:441
size_t ini_errobj_count(struct ini_errobj *errobj)
Return number of messages in errobj.
Definition: ini_configobj.h:152
Definition: ini_configobj.h:203
double * ini_get_double_config_array(struct value_obj *vo, int *size, int *error)
Convert value to an array of floating point values.
Definition: ini_configobj.h:197
Definition: ini_configobj.h:150
Definition: ini_configobj.h:196
enum index_utf_t ini_config_get_bom(struct ini_cfgfile *file_ctx)
Return the encoding indicator.
index_utf_t
Definition: ini_configobj.h:149
int ini_get_int_config_value(struct value_obj *vo, int strict, int def, int *error)
Convert value to integer number.
Definition: ini_configobj.h:209
void ini_config_file_close(struct ini_cfgfile *file_ctx)
Close configuration file after parsing.
Definition: ini_configobj.h:154
Definition: ini_configobj.h:151
void ini_config_print_errors(FILE *file, char **error_list)
Print errors to a file.
int ini_config_change_access(struct ini_cfgfile *file_ctx, struct access_check *new_access)
Change permissions and ownership of the file.
int ini_errobj_add_msg(struct ini_errobj *errobj, const char *format,...) DING_ATTR_FORMAT(2
Add new printf formated message to errobj.
int ini_config_set_bom(struct ini_cfgfile *file_ctx, enum index_utf_t bom)
Set the encoding indicator.
unsigned char ini_get_bool_config_value(struct value_obj *vo, unsigned char def, int *error)
Convert value into a logical value.
char ** ini_get_section_list(struct ini_cfgobj *ini_config, int *size, int *error)
Get list of sections.
const char * ini_get_const_string_config_value(struct value_obj *vo, int *error)
Get the string stored in the configuration value.
ERR_PARSE
Definition: ini_configobj.h:190
Definition: ini_configobj.h:153
void ini_free_double_config_array(double *array)
Free array of floating pointer values.
int ini_config_copy(struct ini_cfgobj *ini_config, struct ini_cfgobj **ini_new)
Create a copy of the configuration object.
Definition: ini_configobj.h:205
int ini_config_access_check(struct ini_cfgfile *file_ctx, uint32_t flags, uid_t uid, gid_t gid, mode_t mode, mode_t mask)
Check file properties.
void ini_config_file_destroy(struct ini_cfgfile *file_ctx)
Close configuration file and free all data.
Definition: ini_configobj.h:210
char ** ini_get_attribute_list(struct ini_cfgobj *ini_config, const char *section, int *size, int *error)
Get list of attributes.
int ini_rules_read_from_file(const char *filename, struct ini_cfgobj **_rules_obj)
Read rules from INI file.
Definition: ini_configobj.h:194
int ini_errobj_no_more_msgs(struct ini_errobj *errobj)
Check if errobj has more messages.
int32_t ini_get_int32_config_value(struct value_obj *vo, int strict, int32_t def, int *error)
Convert value to int32_t number.
int ini_config_save(struct ini_cfgfile *file_ctx, struct access_check *new_access, struct ini_cfgobj *ini_config)
Save configuration in a file.
Definition: ini_configobj.h:439
void ini_errobj_next(struct ini_errobj *errobj)
Move to the next message in errobj.
int ini_config_augment(struct ini_cfgobj *base_cfg, const char *path, const char *patterns[], const char *sections[], struct access_check *check_perm, int error_level, uint32_t collision_flags, uint32_t parse_flags, uint32_t merge_flags, struct ini_cfgobj **result_cfg, struct ref_array **error_list, struct ref_array **success_list)
Augment configuration.
char * ini_get_bin_config_value(struct value_obj *vo, int *length, int *error)
Convert value into a binary sequence.
int ini_config_create(struct ini_cfgobj **ini_config)
Create a configuration object.
int ini_config_file_open(const char *filename, uint32_t metadata_flags, struct ini_cfgfile **file_ctx)
Create a configuration file object.
int ini_config_serialize(struct ini_cfgobj *ini_config, struct simplebuffer *sbobj)
Serialize configuration object.
int64_t ini_get_int64_config_value(struct value_obj *vo, int strict, int64_t def, int *error)
Convert value to integer number.
Definition: ini_configobj.h:174
mode_t mask
Definition: ini_configobj.h:430
double ini_get_double_config_value(struct value_obj *vo, int strict, double def, int *error)
Convert value to floating point number.
Structure used to define application specific (external to libini) validator.
Definition: ini_configobj.h:2179
int ini_config_parse(struct ini_cfgfile *file_ctx, int error_level, uint32_t collision_flags, uint32_t parse_flags, struct ini_cfgobj *ini_config)
Parse the file and populate a configuration object.
uint32_t flags
Definition: ini_configobj.h:421
int ini_config_file_from_mem(void *data_buf, uint32_t data_len, struct ini_cfgfile **file_ctx)
Create a configuration file object using memory buffer.
unsigned long ini_get_ulong_config_value(struct value_obj *vo, int strict, unsigned long def, int *error)
Convert value to unsigned long number.
const struct stat * ini_config_get_stat(struct ini_cfgfile *file_ctx)
Get pointer to collected stat data.
void ini_free_string_config_array(char **str_config)
Free array of string values.
augmode
Definition: ini_configobj.h:438