include/ndbm.h

   1 /*
   2  * CDDL HEADER START
   3  *
   4  * The contents of this file are subject to the terms of the
   5  * Common Development and Distribution License, Version 1.0 only
   6  * (the "License").  You may not use this file except in compliance
   7  * with the License.
   8  *
   9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
  10  * or http://www.opensolaris.org/os/licensing.
  11  * See the License for the specific language governing permissions
  12  * and limitations under the License.
  13  *
  14  * When distributing Covered Code, include this CDDL HEADER in each
  15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  16  * If applicable, add the following below this CDDL HEADER, with the
  17  * fields enclosed by brackets "[]" replaced with your own identifying
  18  * information: Portions Copyright [yyyy] [name of copyright owner]
  19  *
  20  * CDDL HEADER END
  21  */
  22 /*
  23  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
  24  *
  25  * Copyright 1989 Sun Microsystems, Inc.  All rights reserved.
  26  * Use is subject to license terms.
  27  */
  28
  29 /*      Copyright (c) 1983, 1984, 1985, 1986, 1987, 1988, 1989 AT&T     */
  30 /*        All Rights Reserved   */
  31
  32 /*
  33  * Portions of this source code were derived from Berkeley 4.3 BSD
  34  * under license from the Regents of the University of California.
  35  */
  36
  37 /*
  38  * Hashed key data base library.
  39  */
  40
  41 #ifndef _NDBM_H
  42 #define _NDBM_H
  43
  44 #include <sys/feature_tests.h>
  45 #include <sys/types.h>
  46
  47 #ifdef  __cplusplus
  48 extern "C" {
  49 #endif
  50
  51 /*
  52  * flags to dbm_store()
  53  */
  54 #define DBM_INSERT      0
  55 #define DBM_REPLACE     1
  56
  57 #define _PBLKSIZ 1024
  58 #define _DBLKSIZ 4096
  59
  60 #if !defined(_XPG4_2) || defined(__EXTENSIONS__)
  61 #define PBLKSIZ _PBLKSIZ
  62 #define DBLKSIZ _DBLKSIZ
  63 #endif /* !defined(_XPG4_2) || defined(__EXTENSIONS__) */
  64
  65 typedef struct {
  66         int     dbm_dirf;               /* open directory file */
  67         int     dbm_pagf;               /* open page file */
  68         int     dbm_flags;              /* flags, see below */
  69         long    dbm_maxbno;             /* last ``bit'' in dir file */
  70         long    dbm_bitno;              /* current bit number */
  71         long    dbm_hmask;              /* hash mask */
  72         long    dbm_blkptr;             /* current block for dbm_nextkey */
  73         int     dbm_keyptr;             /* current key for dbm_nextkey */
  74         long    dbm_blkno;              /* current page to read/write */
  75         long    dbm_pagbno;             /* current page in pagbuf */
  76         char    dbm_pagbuf[_PBLKSIZ];   /* page file block buffer */
  77         long    dbm_dirbno;             /* current block in dirbuf */
  78         char    dbm_dirbuf[_DBLKSIZ];   /* directory file block buffer */
  79 } DBM;
  80
  81 typedef struct {
  82         void    *dptr;
  83         size_t  dsize;
  84 } datum;
  85
  86 DBM     *dbm_open(const char *, int, mode_t);
  87 void    dbm_close(DBM *);
  88 datum   dbm_fetch(DBM *, datum);
  89 datum   dbm_firstkey(DBM *);
  90 datum   dbm_nextkey(DBM *);
  91 int     dbm_delete(DBM *, datum);
  92 int     dbm_store(DBM *, datum, datum, int);
  93 int     dbm_clearerr(DBM *);
  94 int     dbm_error(DBM *);
  95
  96 #define _DBM_RDONLY     0x1     /* data base open read-only */
  97 #define _DBM_IOERR      0x2     /* data base I/O error */
  98
  99 #define dbm_rdonly(__db)        ((__db)->dbm_flags & _DBM_RDONLY)
 100 #define dbm_error(__db)         ((__db)->dbm_flags & _DBM_IOERR)
 101 /* use this one at your own risk! */
 102 #define dbm_clearerr(__db)      ((__db)->dbm_flags &= ~_DBM_IOERR)
 103 /* for fstat(2) */
 104 #define dbm_dirfno(__db)        ((__db)->dbm_dirf)
 105 #define dbm_pagfno(__db)        ((__db)->dbm_pagf)
 106
 107 #ifdef  __cplusplus
 108 }
 109 #endif
 110
 111 #endif  /* _NDBM_H */