Annotation of parser3/src/lib/sdbm/sdbm_private.h, revision 1.1
1.1 ! paf 1: /* ====================================================================
! 2: * The Apache Software License, Version 1.1
! 3: *
! 4: * Copyright (c) 2000-2002 The Apache Software Foundation. All rights
! 5: * reserved.
! 6: *
! 7: * Redistribution and use in source and binary forms, with or without
! 8: * modification, are permitted provided that the following conditions
! 9: * are met:
! 10: *
! 11: * 1. Redistributions of source code must retain the above copyright
! 12: * notice, this list of conditions and the following disclaimer.
! 13: *
! 14: * 2. Redistributions in binary form must reproduce the above copyright
! 15: * notice, this list of conditions and the following disclaimer in
! 16: * the documentation and/or other materials provided with the
! 17: * distribution.
! 18: *
! 19: * 3. The end-user documentation included with the redistribution,
! 20: * if any, must include the following acknowledgment:
! 21: * "This product includes software developed by the
! 22: * Apache Software Foundation (http://www.apache.org/)."
! 23: * Alternately, this acknowledgment may appear in the software itself,
! 24: * if and wherever such third-party acknowledgments normally appear.
! 25: *
! 26: * 4. The names "Apache" and "Apache Software Foundation" must
! 27: * not be used to endorse or promote products derived from this
! 28: * software without prior written permission. For written
! 29: * permission, please contact apache@apache.org.
! 30: *
! 31: * 5. Products derived from this software may not be called "Apache",
! 32: * nor may "Apache" appear in their name, without prior written
! 33: * permission of the Apache Software Foundation.
! 34: *
! 35: * THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
! 36: * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
! 37: * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
! 38: * DISCLAIMED. IN NO EVENT SHALL THE APACHE SOFTWARE FOUNDATION OR
! 39: * ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
! 40: * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
! 41: * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
! 42: * USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
! 43: * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
! 44: * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
! 45: * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 46: * SUCH DAMAGE.
! 47: * ====================================================================
! 48: *
! 49: * This software consists of voluntary contributions made by many
! 50: * individuals on behalf of the Apache Software Foundation. For more
! 51: * information on the Apache Software Foundation, please see
! 52: * <http://www.apache.org/>.
! 53: */
! 54:
! 55: /*
! 56: * sdbm - ndbm work-alike hashed database library
! 57: * based on Per-Ake Larson's Dynamic Hashing algorithms. BIT 18 (1978).
! 58: * author: oz@nexus.yorku.ca
! 59: */
! 60:
! 61: #ifndef SDBM_PRIVATE_H
! 62: #define SDBM_PRIVATE_H
! 63:
! 64: #include "apr.h"
! 65: #include "apr_pools.h"
! 66: #include "apr_file_io.h"
! 67: #include "apr_errno.h" /* for apr_status_t */
! 68:
! 69: #if 0
! 70: /* if the block/page size is increased, it breaks perl apr_sdbm_t compatibility */
! 71: #define DBLKSIZ 16384
! 72: #define PBLKSIZ 8192
! 73: #define PAIRMAX 8008 /* arbitrary on PBLKSIZ-N */
! 74: #else
! 75: #define DBLKSIZ 4096
! 76: #define PBLKSIZ 1024
! 77: #define PAIRMAX 1008 /* arbitrary on PBLKSIZ-N */
! 78: #endif
! 79: #define SPLTMAX 10 /* maximum allowed splits */
! 80:
! 81: /* for apr_sdbm_t.flags */
! 82: #define SDBM_RDONLY 0x1 /* data base open read-only */
! 83: #define SDBM_SHARED 0x2 /* data base open for sharing */
! 84: #define SDBM_SHARED_LOCK 0x4 /* data base locked for shared read */
! 85: #define SDBM_EXCLUSIVE_LOCK 0x8 /* data base locked for write */
! 86:
! 87: struct apr_sdbm_t {
! 88: apr_pool_t *pool;
! 89: apr_file_t *dirf; /* directory file descriptor */
! 90: apr_file_t *pagf; /* page file descriptor */
! 91: apr_int32_t flags; /* status/error flags, see below */
! 92: long maxbno; /* size of dirfile in bits */
! 93: long curbit; /* current bit number */
! 94: long hmask; /* current hash mask */
! 95: long blkptr; /* current block for nextkey */
! 96: int keyptr; /* current key for nextkey */
! 97: long blkno; /* current page to read/write */
! 98: long pagbno; /* current page in pagbuf */
! 99: char pagbuf[PBLKSIZ]; /* page file block buffer */
! 100: long dirbno; /* current block in dirbuf */
! 101: char dirbuf[DBLKSIZ]; /* directory file block buffer */
! 102: int lckcnt; /* number of calls to sdbm_lock */
! 103: };
! 104:
! 105: extern const apr_sdbm_datum_t sdbm_nullitem;
! 106:
! 107: long sdbm_hash(const char *str, int len);
! 108:
! 109: /*
! 110: * zero the cache
! 111: */
! 112: #define SDBM_INVALIDATE_CACHE(db, finfo) \
! 113: do { db->dirbno = (!finfo.size) ? 0 : -1; \
! 114: db->pagbno = -1; \
! 115: db->maxbno = (long)(finfo.size * BYTESIZ); \
! 116: } while (0);
! 117:
! 118: #endif /* SDBM_PRIVATE_H */
E-mail: