/* * * registry.h * * $Source: /Users/ekr/tmp/nrappkit-dump/nrappkit/src/registry/registry.h,v $ * $Revision: 1.3 $ * $Date: 2007/07/17 17:58:16 $ * * Datastore for tracking configuration and related info. * * * Copyright (C) 2005, Network Resonance, Inc. * Copyright (C) 2006, Network Resonance, Inc. * All Rights Reserved * * Redistribution and use in source and binary forms, with or without * modification, are permitted provided that the following conditions * are met: * * 1. Redistributions of source code must retain the above copyright * notice, this list of conditions and the following disclaimer. * 2. Redistributions in binary form must reproduce the above copyright * notice, this list of conditions and the following disclaimer in the * documentation and/or other materials provided with the distribution. * 3. Neither the name of Network Resonance, Inc. nor the name of any * contributors to this software may be used to endorse or promote * products derived from this software without specific prior written * permission. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH DAMAGE. * * */ #ifndef __REGISTRY_H__ #define __REGISTRY_H__ #include #include #include #include #define NR_REG_MAX_NR_REGISTRY_LEN 128 #define NR_REG_MAX_TYPE_LEN 32 typedef char NR_registry[NR_REG_MAX_NR_REGISTRY_LEN]; typedef char NR_registry_type[NR_REG_MAX_TYPE_LEN]; extern NR_registry NR_TOP_LEVEL_REGISTRY; extern void *NR_REG_MODE_LOCAL; extern void *NR_REG_MODE_REMOTE; int NR_reg_init(void *mode); int NR_reg_initted(void); int NR_reg_get_char(NR_registry name, char *out); int NR_reg_get_uchar(NR_registry name, UCHAR *out); int NR_reg_get_int2(NR_registry name, INT2 *out); int NR_reg_get_uint2(NR_registry name, UINT2 *out); int NR_reg_get_int4(NR_registry name, INT4 *out); int NR_reg_get_uint4(NR_registry name, UINT4 *out); int NR_reg_get_int8(NR_registry name, INT8 *out); int NR_reg_get_uint8(NR_registry name, UINT8 *out); int NR_reg_get_double(NR_registry name, double *out); int NR_reg_get_registry(NR_registry name, NR_registry out); int NR_reg_get_bytes(NR_registry name, UCHAR *out, size_t size, size_t *length); int NR_reg_get_string(NR_registry name, char *out, size_t size); int NR_reg_get_length(NR_registry name, size_t *length); int NR_reg_get_type(NR_registry name, NR_registry_type type); int NR_reg_get2_char(NR_registry prefix, char *name, char *); int NR_reg_get2_uchar(NR_registry prefix, char *name, UCHAR *); int NR_reg_get2_int2(NR_registry prefix, char *name, INT2 *); int NR_reg_get2_uint2(NR_registry prefix, char *name, UINT2 *); int NR_reg_get2_int4(NR_registry prefix, char *name, INT4 *); int NR_reg_get2_uint4(NR_registry prefix, char *name, UINT4 *); int NR_reg_get2_int8(NR_registry prefix, char *name, INT8 *); int NR_reg_get2_uint8(NR_registry prefix, char *name, UINT8 *); int NR_reg_get2_double(NR_registry prefix, char *name, double *); int NR_reg_get2_bytes(NR_registry prefix, char *name, UCHAR *out, size_t size, size_t *length); int NR_reg_get2_string(NR_registry prefix, char *name, char *out, size_t size); int NR_reg_alloc2_string(NR_registry prefix, char *name, char **); int NR_reg_alloc2_data(NR_registry prefix, char *name, Data *); int NR_reg_set_char(NR_registry name, char data); int NR_reg_set_uchar(NR_registry name, UCHAR data); int NR_reg_set_int2(NR_registry name, INT2 data); int NR_reg_set_uint2(NR_registry name, UINT2 data); int NR_reg_set_int4(NR_registry name, INT4 data); int NR_reg_set_uint4(NR_registry name, UINT4 data); int NR_reg_set_int8(NR_registry name, INT8 data); int NR_reg_set_uint8(NR_registry name, UINT8 data); int NR_reg_set_double(NR_registry name, double data); int NR_reg_set_registry(NR_registry name); int NR_reg_set_bytes(NR_registry name, UCHAR *data, size_t length); int NR_reg_set_string(NR_registry name, char *data); int NR_reg_set2_char(NR_registry prefix, char *name, char data); int NR_reg_set2_uchar(NR_registry prefix, char *name, UCHAR data); int NR_reg_set2_int2(NR_registry prefix, char *name, INT2 data); int NR_reg_set2_uint2(NR_registry prefix, char *name, UINT2 data); int NR_reg_set2_int4(NR_registry prefix, char *name, INT4 data); int NR_reg_set2_uint4(NR_registry prefix, char *name, UINT4 data); int NR_reg_set2_int8(NR_registry prefix, char *name, INT8 data); int NR_reg_set2_uint8(NR_registry prefix, char *name, UINT8 data); int NR_reg_set2_double(NR_registry prefix, char *name, double data); int NR_reg_set2_bytes(NR_registry prefix, char *name, UCHAR *data, size_t length); int NR_reg_set2_string(NR_registry prefix, char *name, char *data); int NR_reg_del(NR_registry name); int NR_reg_fin(NR_registry name); int NR_reg_get_child_count(NR_registry parent, unsigned int *count); int NR_reg_get_child_registry(NR_registry parent, unsigned int i, NR_registry child); int NR_reg_get2_child_count(NR_registry base, NR_registry name, unsigned int *count); int NR_reg_get2_child_registry(NR_registry base, NR_registry name, unsigned int i, NR_registry child); int NR_reg_get_children(NR_registry parent, NR_registry children[], size_t size, size_t *length); int NR_reg_dump(void); /* convenience methods, call RFREE on the returned data */ int NR_reg_alloc_data(NR_registry name, Data *data); int NR_reg_alloc_string(NR_registry name, char **data); #define NR_REG_CB_ACTION_ADD (1<<0) #define NR_REG_CB_ACTION_CHANGE (1<<1) #define NR_REG_CB_ACTION_DELETE (1<<2) #define NR_REG_CB_ACTION_FINAL (1<<6) int NR_reg_register_callback(NR_registry name, char action, void (*cb)(void *cb_arg, char action, NR_registry name), void *cb_arg); int NR_reg_unregister_callback(NR_registry name, char action, void (*cb)(void *cb_arg, char action, NR_registry name)); int NR_reg_make_registry(NR_registry parent, char *child, NR_registry out); int NR_reg_make_child_registry(NR_registry parent, NR_registry descendant, unsigned int generation, NR_registry child); #endif