sl@0: /* crypto/lhash/lhash.h */ sl@0: /* Copyright (C) 1995-1998 Eric Young (eay@cryptsoft.com) sl@0: * All rights reserved. sl@0: * sl@0: * This package is an SSL implementation written sl@0: * by Eric Young (eay@cryptsoft.com). sl@0: * The implementation was written so as to conform with Netscapes SSL. sl@0: * sl@0: * This library is free for commercial and non-commercial use as long as sl@0: * the following conditions are aheared to. The following conditions sl@0: * apply to all code found in this distribution, be it the RC4, RSA, sl@0: * lhash, DES, etc., code; not just the SSL code. The SSL documentation sl@0: * included with this distribution is covered by the same copyright terms sl@0: * except that the holder is Tim Hudson (tjh@cryptsoft.com). sl@0: * sl@0: * Copyright remains Eric Young's, and as such any Copyright notices in sl@0: * the code are not to be removed. sl@0: * If this package is used in a product, Eric Young should be given attribution sl@0: * as the author of the parts of the library used. sl@0: * This can be in the form of a textual message at program startup or sl@0: * in documentation (online or textual) provided with the package. sl@0: * sl@0: * Redistribution and use in source and binary forms, with or without sl@0: * modification, are permitted provided that the following conditions sl@0: * are met: sl@0: * 1. Redistributions of source code must retain the copyright sl@0: * notice, this list of conditions and the following disclaimer. sl@0: * 2. Redistributions in binary form must reproduce the above copyright sl@0: * notice, this list of conditions and the following disclaimer in the sl@0: * documentation and/or other materials provided with the distribution. sl@0: * 3. All advertising materials mentioning features or use of this software sl@0: * must display the following acknowledgement: sl@0: * "This product includes cryptographic software written by sl@0: * Eric Young (eay@cryptsoft.com)" sl@0: * The word 'cryptographic' can be left out if the rouines from the library sl@0: * being used are not cryptographic related :-). sl@0: * 4. If you include any Windows specific code (or a derivative thereof) from sl@0: * the apps directory (application code) you must include an acknowledgement: sl@0: * "This product includes software written by Tim Hudson (tjh@cryptsoft.com)" sl@0: * sl@0: * THIS SOFTWARE IS PROVIDED BY ERIC YOUNG ``AS IS'' AND sl@0: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE sl@0: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE sl@0: * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE sl@0: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL sl@0: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS sl@0: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) sl@0: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT sl@0: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY sl@0: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF sl@0: * SUCH DAMAGE. sl@0: * sl@0: * The licence and distribution terms for any publically available version or sl@0: * derivative of this code cannot be changed. i.e. this code cannot simply be sl@0: * copied and put under another distribution licence sl@0: * [including the GNU Public Licence.] sl@0: */ sl@0: /* sl@0: © Portions copyright (c) 2006 Nokia Corporation. All rights reserved. sl@0: */ sl@0: sl@0: /* Header for dynamic hash table routines sl@0: * Author - Eric Young sl@0: */ sl@0: sl@0: #ifndef HEADER_LHASH_H sl@0: #define HEADER_LHASH_H sl@0: sl@0: #if (defined(__SYMBIAN32__) && !defined(SYMBIAN)) sl@0: #define SYMBIAN sl@0: #endif sl@0: sl@0: #ifdef SYMBIAN sl@0: #include sl@0: #endif sl@0: #include sl@0: #ifndef OPENSSL_NO_FP_API sl@0: #include sl@0: #endif sl@0: sl@0: #ifndef OPENSSL_NO_BIO sl@0: #include sl@0: #endif sl@0: sl@0: #ifdef __cplusplus sl@0: extern "C" { sl@0: #endif sl@0: sl@0: typedef struct lhash_node_st sl@0: { sl@0: void *data; sl@0: struct lhash_node_st *next; sl@0: #ifndef OPENSSL_NO_HASH_COMP sl@0: unsigned long hash; sl@0: #endif sl@0: } LHASH_NODE; sl@0: sl@0: typedef int (*LHASH_COMP_FN_TYPE)(const void *, const void *); sl@0: typedef unsigned long (*LHASH_HASH_FN_TYPE)(const void *); sl@0: typedef void (*LHASH_DOALL_FN_TYPE)(void *); sl@0: typedef void (*LHASH_DOALL_ARG_FN_TYPE)(void *, void *); sl@0: sl@0: /* Macros for declaring and implementing type-safe wrappers for LHASH callbacks. sl@0: * This way, callbacks can be provided to LHASH structures without function sl@0: * pointer casting and the macro-defined callbacks provide per-variable casting sl@0: * before deferring to the underlying type-specific callbacks. NB: It is sl@0: * possible to place a "static" in front of both the DECLARE and IMPLEMENT sl@0: * macros if the functions are strictly internal. */ sl@0: sl@0: /* First: "hash" functions */ sl@0: #define DECLARE_LHASH_HASH_FN(f_name,o_type) \ sl@0: unsigned long f_name##_LHASH_HASH(const void *); sl@0: #define IMPLEMENT_LHASH_HASH_FN(f_name,o_type) \ sl@0: unsigned long f_name##_LHASH_HASH(const void *arg) { \ sl@0: o_type a = (o_type)arg; \ sl@0: return f_name(a); } sl@0: #define LHASH_HASH_FN(f_name) f_name##_LHASH_HASH sl@0: sl@0: /* Second: "compare" functions */ sl@0: #define DECLARE_LHASH_COMP_FN(f_name,o_type) \ sl@0: int f_name##_LHASH_COMP(const void *, const void *); sl@0: #define IMPLEMENT_LHASH_COMP_FN(f_name,o_type) \ sl@0: int f_name##_LHASH_COMP(const void *arg1, const void *arg2) { \ sl@0: o_type a = (o_type)arg1; \ sl@0: o_type b = (o_type)arg2; \ sl@0: return f_name(a,b); } sl@0: #define LHASH_COMP_FN(f_name) f_name##_LHASH_COMP sl@0: sl@0: /* Third: "doall" functions */ sl@0: #define DECLARE_LHASH_DOALL_FN(f_name,o_type) \ sl@0: void f_name##_LHASH_DOALL(void *); sl@0: #define IMPLEMENT_LHASH_DOALL_FN(f_name,o_type) \ sl@0: void f_name##_LHASH_DOALL(void *arg) { \ sl@0: o_type a = (o_type)arg; \ sl@0: f_name(a); } sl@0: #define LHASH_DOALL_FN(f_name) f_name##_LHASH_DOALL sl@0: sl@0: /* Fourth: "doall_arg" functions */ sl@0: #define DECLARE_LHASH_DOALL_ARG_FN(f_name,o_type,a_type) \ sl@0: void f_name##_LHASH_DOALL_ARG(void *, void *); sl@0: #define IMPLEMENT_LHASH_DOALL_ARG_FN(f_name,o_type,a_type) \ sl@0: void f_name##_LHASH_DOALL_ARG(void *arg1, void *arg2) { \ sl@0: o_type a = (o_type)arg1; \ sl@0: a_type b = (a_type)arg2; \ sl@0: f_name(a,b); } sl@0: #define LHASH_DOALL_ARG_FN(f_name) f_name##_LHASH_DOALL_ARG sl@0: sl@0: typedef struct lhash_st sl@0: { sl@0: LHASH_NODE **b; sl@0: LHASH_COMP_FN_TYPE comp; sl@0: LHASH_HASH_FN_TYPE hash; sl@0: unsigned int num_nodes; sl@0: unsigned int num_alloc_nodes; sl@0: unsigned int p; sl@0: unsigned int pmax; sl@0: unsigned long up_load; /* load times 256 */ sl@0: unsigned long down_load; /* load times 256 */ sl@0: unsigned long num_items; sl@0: sl@0: unsigned long num_expands; sl@0: unsigned long num_expand_reallocs; sl@0: unsigned long num_contracts; sl@0: unsigned long num_contract_reallocs; sl@0: unsigned long num_hash_calls; sl@0: unsigned long num_comp_calls; sl@0: unsigned long num_insert; sl@0: unsigned long num_replace; sl@0: unsigned long num_delete; sl@0: unsigned long num_no_delete; sl@0: unsigned long num_retrieve; sl@0: unsigned long num_retrieve_miss; sl@0: unsigned long num_hash_comps; sl@0: sl@0: int error; sl@0: } LHASH; sl@0: sl@0: #define LH_LOAD_MULT 256 sl@0: sl@0: /* Indicates a malloc() error in the last call, this is only bad sl@0: * in lh_insert(). */ sl@0: #define lh_error(lh) ((lh)->error) sl@0: sl@0: IMPORT_C LHASH *lh_new(LHASH_HASH_FN_TYPE h, LHASH_COMP_FN_TYPE c); sl@0: IMPORT_C void lh_free(LHASH *lh); sl@0: IMPORT_C void *lh_insert(LHASH *lh, void *data); sl@0: IMPORT_C void *lh_delete(LHASH *lh, const void *data); sl@0: IMPORT_C void *lh_retrieve(LHASH *lh, const void *data); sl@0: IMPORT_C void lh_doall(LHASH *lh, LHASH_DOALL_FN_TYPE func); sl@0: IMPORT_C void lh_doall_arg(LHASH *lh, LHASH_DOALL_ARG_FN_TYPE func, void *arg); sl@0: IMPORT_C unsigned long lh_strhash(const char *c); sl@0: IMPORT_C unsigned long lh_num_items(const LHASH *lh); sl@0: sl@0: #ifndef OPENSSL_NO_FP_API sl@0: IMPORT_C void lh_stats(const LHASH *lh, FILE *out); sl@0: IMPORT_C void lh_node_stats(const LHASH *lh, FILE *out); sl@0: IMPORT_C void lh_node_usage_stats(const LHASH *lh, FILE *out); sl@0: #endif sl@0: sl@0: #ifndef OPENSSL_NO_BIO sl@0: IMPORT_C void lh_stats_bio(const LHASH *lh, BIO *out); sl@0: IMPORT_C void lh_node_stats_bio(const LHASH *lh, BIO *out); sl@0: IMPORT_C void lh_node_usage_stats_bio(const LHASH *lh, BIO *out); sl@0: #endif sl@0: #ifdef __cplusplus sl@0: } sl@0: #endif sl@0: sl@0: #endif sl@0: