dict.h ファイル

#include <fcntl.h>
#include <setjmp.h>
#include <vstream.h>
#include <argv.h>
#include <vstring.h>
#include <myflock.h>

[ソースコード]

データ構造
struct	DICT_OWNER
struct	DICT
struct	DICT_UTF8_BACKUP

マクロ定義
#define	DICT_JMP_BUF   sigjmp_buf
#define	DICT_OWNER_UNKNOWN   (-1) /* ex: unauthenticated tcp, proxy */
#define	DICT_OWNER_TRUSTED   (!1) /* ex: root-owned config file */
#define	DICT_OWNER_UNTRUSTED   (!0) /* ex: non-root config file */
#define	DICT_OWNER_AGGREGATE_INIT(dst)
#define	DICT_OWNER_AGGREGATE_UPDATE(dst, src)
#define	DICT_DEBUG(d)   ((d)->flags & DICT_FLAG_DEBUG ? dict_debug(d) : (d))
#define	DICT_FLAG_NONE   (0)
#define	DICT_FLAG_DUP_WARN   (1<<0) /* warn about dups if not supported */
#define	DICT_FLAG_DUP_IGNORE   (1<<1) /* ignore dups if not supported */
#define	DICT_FLAG_TRY0NULL   (1<<2) /* do not append 0 to key/value */
#define	DICT_FLAG_TRY1NULL   (1<<3) /* append 0 to key/value */
#define	DICT_FLAG_FIXED   (1<<4) /* fixed key map */
#define	DICT_FLAG_PATTERN   (1<<5) /* keys are patterns */
#define	DICT_FLAG_LOCK   (1<<6) /* use temp lock before access */
#define	DICT_FLAG_DUP_REPLACE   (1<<7) /* replace dups if supported */
#define	DICT_FLAG_SYNC_UPDATE   (1<<8) /* sync updates if supported */
#define	DICT_FLAG_DEBUG   (1<<9) /* log access */
#define	DICT_FLAG_NO_REGSUB   (1<<11) /* disallow regexp substitution */
#define	DICT_FLAG_NO_PROXY   (1<<12) /* disallow proxy mapping */
#define	DICT_FLAG_NO_UNAUTH   (1<<13) /* disallow unauthenticated data */
#define	DICT_FLAG_FOLD_FIX   (1<<14) /* case-fold key with fixed-case map */
#define	DICT_FLAG_FOLD_MUL   (1<<15) /* case-fold key with multi-case map */
#define	DICT_FLAG_FOLD_ANY   (DICT_FLAG_FOLD_FIX | DICT_FLAG_FOLD_MUL)
#define	DICT_FLAG_OPEN_LOCK   (1<<16) /* perm lock if not multi-writer safe */
#define	DICT_FLAG_BULK_UPDATE   (1<<17) /* optimize for bulk updates */
#define	DICT_FLAG_MULTI_WRITER   (1<<18) /* multi-writer safe map */
#define	DICT_FLAG_UTF8_REQUEST   (1<<19) /* activate UTF-8 if possible */
#define	DICT_FLAG_UTF8_ACTIVE   (1<<20) /* UTF-8 proxy layer is present */
#define	DICT_FLAG_UTF8_MASK   (DICT_FLAG_UTF8_REQUEST)
#define	DICT_FLAG_PARANOID   (DICT_FLAG_NO_REGSUB | DICT_FLAG_NO_PROXY | DICT_FLAG_NO_UNAUTH)
#define	DICT_FLAG_IMPL_MASK
#define	DICT_FLAG_RQST_MASK
#define	DICT_FLAG_INST_MASK   ~(DICT_FLAG_IMPL_MASK | DICT_FLAG_RQST_MASK)
#define	DICT_NEED_UTF8_ACTIVATION(enable, flags)   ((enable) && ((flags) & DICT_FLAG_UTF8_MASK))
#define	DICT_ERR_NONE   0 /* no error */
#define	DICT_ERR_RETRY   (-1) /* soft error */
#define	DICT_ERR_CONFIG   (-2) /* configuration error */
#define	DICT_STAT_FAIL   1 /* any value > 0: notfound, conflict */
#define	DICT_STAT_SUCCESS   0 /* request satisfied */
#define	DICT_STAT_ERROR   (-1) /* any value < 0: database error */
#define	DICT_ERR_VAL_RETURN(dict, err, val)
#define	DICT_SEQ_FUN_FIRST   0 /* set cursor to first record */
#define	DICT_SEQ_FUN_NEXT   1 /* set cursor to next record */
#define	dict_get(dp, key)   ((const char *) (dp)->lookup((dp), (key)))
#define	dict_put(dp, key, val)   (dp)->update((dp), (key), (val))
#define	dict_del(dp, key)   (dp)->delete((dp), (key))
#define	dict_seq(dp, f, key, val)   (dp)->sequence((dp), (f), (key), (val))
#define	dict_close(dp)   (dp)->close(dp)
#define	DICT_TYPE_NOFILE   "non-existent"
#define	DICT_TYPE_NOUTF8   "non-UTF-8"
#define	dict_setjmp(dict)   sigsetjmp((dict)->jbuf[0], 1)
#define	dict_longjmp(dict, val)   siglongjmp((dict)->jbuf[0], (val))
#define	dict_isjmp(dict)   ((dict)->jbuf != 0)

型定義
typedef struct DICT_OWNER	DICT_OWNER
typedef struct DICT	DICT
typedef void(*	DICT_MAPNAMES_EXTEND_FN) (ARGV *)
typedef DICT *(*	DICT_OPEN_FN) (const char *, int, int)
typedef DICT_OPEN_FN(*	DICT_OPEN_EXTEND_FN) (const char *)
typedef void(*	DICT_WALK_ACTION) (const char *, DICT *, void *)
typedef struct DICT_UTF8_BACKUP	DICT_UTF8_BACKUP

関数
DICT *	dict_alloc (const char *, const char *, ssize_t)
void	dict_free (DICT *)
DICT *	dict_debug (DICT *)
ARGV *	dict_mapnames (void)
DICT_MAPNAMES_EXTEND_FN	dict_mapnames_extend (DICT_MAPNAMES_EXTEND_FN)
void	dict_register (const char *, DICT *)
DICT *	dict_handle (const char *)
void	dict_unregister (const char *)
int	dict_update (const char *, const char *, const char *)
const char *	dict_lookup (const char *, const char *)
int	dict_delete (const char *, const char *)
int	dict_sequence (const char *, const int, const char **, const char **)
int	dict_load_file_xt (const char *, const char *)
void	dict_load_fp (const char *, VSTREAM *)
const char *	dict_eval (const char *, const char *, int)
int	dict_error (const char *)
DICT *	dict_open (const char *, int, int)
DICT *	dict_open3 (const char *, const char *, int, int)
void	dict_open_register (const char *, DICT_OPEN_FN)
DICT_OPEN_EXTEND_FN	dict_open_extend (DICT_OPEN_EXTEND_FN)
void	dict_walk (DICT_WALK_ACTION, void *)
int	dict_changed (void)
const char *	dict_changed_name (void)
const char *	dict_flags_str (int)
int	dict_flags_mask (const char *)
void	dict_type_override (DICT *, const char *)
DICT *	dict_utf8_activate (DICT *)
void	dict_test (int, char **)
DICT *	PRINTFLIKE (5, 6) dict_surrogate(const char *
void	dict_jmp_alloc (DICT *)

変数
int	dict_allow_surrogate
DICT const char	int

マクロ定義詳解

#define dict_close

(

dp

)

(dp)->close(dp)

dict.h の 240 行目に定義があります。

#define DICT_DEBUG

(

d

)

((d)->flags & DICT_FLAG_DEBUG ? dict_debug(d) : (d))

dict.h の 104 行目に定義があります。

#define dict_del	(		dp,
			key
	)		(dp)->delete((dp), (key))

dict.h の 238 行目に定義があります。

#define DICT_ERR_CONFIG   (-2) /* configuration error */

dict.h の 179 行目に定義があります。

#define DICT_ERR_NONE   0 /* no error */

dict.h の 177 行目に定義があります。

#define DICT_ERR_RETRY   (-1) /* soft error */

dict.h の 178 行目に定義があります。

#define DICT_ERR_VAL_RETURN	(		dict,
			err,
			val
	)

値:

do { \
    (dict)->error = (err); \
    return (val); \
    } while (0)

dict.h の 192 行目に定義があります。

#define DICT_FLAG_BULK_UPDATE   (1<<17) /* optimize for bulk updates */

dict.h の 128 行目に定義があります。

#define DICT_FLAG_DEBUG   (1<<9) /* log access */

dict.h の 119 行目に定義があります。

#define DICT_FLAG_DUP_IGNORE   (1<<1) /* ignore dups if not supported */

dict.h の 111 行目に定義があります。

#define DICT_FLAG_DUP_REPLACE   (1<<7) /* replace dups if supported */

dict.h の 117 行目に定義があります。

#define DICT_FLAG_DUP_WARN   (1<<0) /* warn about dups if not supported */

dict.h の 110 行目に定義があります。

#define DICT_FLAG_FIXED   (1<<4) /* fixed key map */

dict.h の 114 行目に定義があります。

#define DICT_FLAG_FOLD_ANY   (DICT_FLAG_FOLD_FIX | DICT_FLAG_FOLD_MUL)

dict.h の 126 行目に定義があります。

#define DICT_FLAG_FOLD_FIX   (1<<14) /* case-fold key with fixed-case map */

dict.h の 124 行目に定義があります。

#define DICT_FLAG_FOLD_MUL   (1<<15) /* case-fold key with multi-case map */

dict.h の 125 行目に定義があります。

#define DICT_FLAG_IMPL_MASK

値:

(DICT_FLAG_FIXED | DICT_FLAG_PATTERN | \
				DICT_FLAG_MULTI_WRITER)

dict.h の 160 行目に定義があります。

#define DICT_FLAG_INST_MASK   ~(DICT_FLAG_IMPL_MASK | DICT_FLAG_RQST_MASK)

dict.h の 166 行目に定義があります。

#define DICT_FLAG_LOCK   (1<<6) /* use temp lock before access */

dict.h の 116 行目に定義があります。

#define DICT_FLAG_MULTI_WRITER   (1<<18) /* multi-writer safe map */

dict.h の 129 行目に定義があります。

#define DICT_FLAG_NO_PROXY   (1<<12) /* disallow proxy mapping */

dict.h の 122 行目に定義があります。

#define DICT_FLAG_NO_REGSUB   (1<<11) /* disallow regexp substitution */

dict.h の 121 行目に定義があります。

#define DICT_FLAG_NO_UNAUTH   (1<<13) /* disallow unauthenticated data */

dict.h の 123 行目に定義があります。

#define DICT_FLAG_NONE   (0)

dict.h の 109 行目に定義があります。

#define DICT_FLAG_OPEN_LOCK   (1<<16) /* perm lock if not multi-writer safe */

dict.h の 127 行目に定義があります。

#define DICT_FLAG_PARANOID   (DICT_FLAG_NO_REGSUB | DICT_FLAG_NO_PROXY | DICT_FLAG_NO_UNAUTH)

dict.h の 158 行目に定義があります。

#define DICT_FLAG_PATTERN   (1<<5) /* keys are patterns */

dict.h の 115 行目に定義があります。

#define DICT_FLAG_RQST_MASK

値:

(DICT_FLAG_FOLD_ANY | DICT_FLAG_LOCK | \
				DICT_FLAG_DUP_REPLACE | DICT_FLAG_DUP_WARN | \
				DICT_FLAG_DUP_IGNORE | DICT_FLAG_SYNC_UPDATE | \
				DICT_FLAG_PARANOID | DICT_FLAG_UTF8_MASK)

dict.h の 162 行目に定義があります。

#define DICT_FLAG_SYNC_UPDATE   (1<<8) /* sync updates if supported */

dict.h の 118 行目に定義があります。

#define DICT_FLAG_TRY0NULL   (1<<2) /* do not append 0 to key/value */

dict.h の 112 行目に定義があります。

#define DICT_FLAG_TRY1NULL   (1<<3) /* append 0 to key/value */

dict.h の 113 行目に定義があります。

#define DICT_FLAG_UTF8_ACTIVE   (1<<20) /* UTF-8 proxy layer is present */

dict.h の 131 行目に定義があります。

#define DICT_FLAG_UTF8_MASK   (DICT_FLAG_UTF8_REQUEST)

dict.h の 133 行目に定義があります。

#define DICT_FLAG_UTF8_REQUEST   (1<<19) /* activate UTF-8 if possible */

dict.h の 130 行目に定義があります。

#define dict_get	(		dp,
			key
	)		((const char *) (dp)->lookup((dp), (key)))

dict.h の 236 行目に定義があります。

#define dict_isjmp

(

dict

)

((dict)->jbuf != 0)

dict.h の 295 行目に定義があります。

#define DICT_JMP_BUF   sigjmp_buf

dict.h の 23 行目に定義があります。

#define dict_longjmp	(		dict,
			val
	)		siglongjmp((dict)->jbuf[0], (val))

dict.h の 293 行目に定義があります。

#define DICT_NEED_UTF8_ACTIVATION	(		enable,
			flags
	)		((enable) && ((flags) & DICT_FLAG_UTF8_MASK))

dict.h の 171 行目に定義があります。

#define DICT_OWNER_AGGREGATE_INIT

(

dst

)

値:

{ \
    (dst).status = DICT_OWNER_TRUSTED; \
    (dst).uid = 0; \
    } while (0)

dict.h の 55 行目に定義があります。

#define DICT_OWNER_AGGREGATE_UPDATE	(		dst,
			src
	)

値:

do { \
    if ((dst).status == DICT_OWNER_TRUSTED \
        || (src).status == DICT_OWNER_UNKNOWN) { \
        (dst) = (src); \
    } else if ((dst).status == (src).status \
        && (dst).uid != (src).uid) { \
        (dst).status = DICT_OWNER_UNKNOWN; \
        (dst).uid = ~0; \
    } \
    } while (0)

dict.h の 63 行目に定義があります。

#define DICT_OWNER_TRUSTED   (!1) /* ex: root-owned config file */

dict.h の 46 行目に定義があります。

#define DICT_OWNER_UNKNOWN   (-1) /* ex: unauthenticated tcp, proxy */

dict.h の 45 行目に定義があります。

#define DICT_OWNER_UNTRUSTED   (!0) /* ex: non-root config file */

dict.h の 47 行目に定義があります。

#define dict_put	(		dp,
			key,
			val
	)		(dp)->update((dp), (key), (val))

dict.h の 237 行目に定義があります。

#define dict_seq	(		dp,
			f,
			key,
			val
	)		(dp)->sequence((dp), (f), (key), (val))

dict.h の 239 行目に定義があります。

#define DICT_SEQ_FUN_FIRST   0 /* set cursor to first record */

dict.h の 200 行目に定義があります。

#define DICT_SEQ_FUN_NEXT   1 /* set cursor to next record */

dict.h の 201 行目に定義があります。

#define dict_setjmp

(

dict

)

sigsetjmp((dict)->jbuf[0], 1)

dict.h の 292 行目に定義があります。

#define DICT_STAT_ERROR   (-1) /* any value < 0: database error */

dict.h の 187 行目に定義があります。

#define DICT_STAT_FAIL   1 /* any value > 0: notfound, conflict */

dict.h の 185 行目に定義があります。

#define DICT_STAT_SUCCESS   0 /* request satisfied */

dict.h の 186 行目に定義があります。

#define DICT_TYPE_NOFILE   "non-existent"

dict.h の 275 行目に定義があります。

#define DICT_TYPE_NOUTF8   "non-UTF-8"

dict.h の 276 行目に定義があります。

型定義詳解

typedef struct DICT DICT

typedef void(* DICT_MAPNAMES_EXTEND_FN) (ARGV *)

dict.h の 207 行目に定義があります。

typedef DICT_OPEN_FN(* DICT_OPEN_EXTEND_FN) (const char *)

dict.h の 230 行目に定義があります。

typedef DICT*(* DICT_OPEN_FN) (const char *, int, int)

dict.h の 229 行目に定義があります。

typedef struct DICT_OWNER DICT_OWNER

typedef struct DICT_UTF8_BACKUP DICT_UTF8_BACKUP

typedef void(* DICT_WALK_ACTION) (const char *, DICT *, void *)

dict.h の 241 行目に定義があります。

関数詳解

DICT* dict_alloc	(	const char *	,
		const char *	,
		ssize_t
	)

dict_alloc.c の 135 行目に定義があります。

int dict_changed

(

void

)

dict.c の 613 行目に定義があります。

const char* dict_changed_name

(

void

)

dict.c の 583 行目に定義があります。

DICT* dict_debug

(

DICT *

)

dict_debug.c の 136 行目に定義があります。

int dict_delete	(	const char *	,
		const char *
	)

dict.c の 404 行目に定義があります。

int dict_error

(

const char *

)

dict.c の 431 行目に定義があります。

const char* dict_eval	(	const char *	,
		const char *	,
		int
	)

dict.c の 536 行目に定義があります。

int dict_flags_mask

(

const char *

)

dict.c の 660 行目に定義があります。

const char* dict_flags_str

(

int

)

dict.c の 647 行目に定義があります。

void dict_free

(

DICT *

)

dict_alloc.c の 163 行目に定義があります。

DICT* dict_handle

(

const char *

)

dict.c の 333 行目に定義があります。

void dict_jmp_alloc

(

DICT *

)

dict_alloc.c の 181 行目に定義があります。

int dict_load_file_xt	(	const char *	,
		const char *
	)

dict.c の 441 行目に定義があります。

void dict_load_fp	(	const char *	,
		VSTREAM *
	)

dict.c の 472 行目に定義があります。

const char* dict_lookup	(	const char *	,
		const char *
	)

dict.c の 382 行目に定義があります。

ARGV* dict_mapnames

(

void

)

dict_open.c の 527 行目に定義があります。

DICT_MAPNAMES_EXTEND_FN dict_mapnames_extend

(

DICT_MAPNAMES_EXTEND_FN

)

dict_open.c の 552 行目に定義があります。

DICT* dict_open	(	const char *	,
		int	,
		int
	)

dict_open.c の 421 行目に定義があります。

DICT* dict_open3	(	const char *	,
		const char *	,
		int	,
		int
	)

dict_open.c の 439 行目に定義があります。

DICT_OPEN_EXTEND_FN dict_open_extend

(

DICT_OPEN_EXTEND_FN

)

dict_open.c の 509 行目に定義があります。

void dict_open_register	(	const char *	,
		DICT_OPEN_FN
	)

dict_open.c の 491 行目に定義があります。

void dict_register	(	const char *	,
		DICT *
	)

dict.c の 312 行目に定義があります。

int dict_sequence	(	const char *	,
		const int	,
		const char **	,
		const char **
	)

dict.c の 417 行目に定義があります。

void dict_test	(	int	,
		char **
	)

dict_test.c の 36 行目に定義があります。

void dict_type_override	(	DICT *	,
		const char *
	)

dict_open.c の 563 行目に定義があります。

void dict_unregister

(

const char *

)

dict.c の 354 行目に定義があります。

int dict_update	(	const char *	,
		const char *	,
		const char *
	)

dict.c の 369 行目に定義があります。

DICT* dict_utf8_activate

(

DICT *

)

dict_utf8.c の 248 行目に定義があります。

void dict_walk	(	DICT_WALK_ACTION	,
		void *
	)

dict.c の 569 行目に定義があります。

DICT* PRINTFLIKE	(	5	,
		6
	)		const

変数詳解

int dict_allow_surrogate

dict_surrogate.c の 130 行目に定義があります。

DICT const char int

dict.h の 270 行目に定義があります。