.ds ve 1.8
.TH GDBM 3 5/19/99
.\" Japanese Version Copyright (c) 2000 Tsugikazu Shibata
.\"         all rights reserved.
.\" Translated Fri. August 29 23:32:00 JST 2000
.\"         by Tsugikazu Shibata <ts@tsden.org>
.SH ̾
GDBM - GNUǡ١ޥ͡㡣\fBdbm\fR  \fBndbm\fR
ߴǽޤࡣ (Version \*(ve.)

.SH 
.B #include <gdbm.h>
.PP
.SM
.B extern gdbm_error
.br
.B gdbm_errno
.PP
.B extern char
.br
.B *gdbm_version
.PP
.B GDBM_FILE
.br
.B gdbm_open (name, block_size, read_write, mode, fatal_func)
.br
.B char * name;
.br
.B int block_size, read_write, mode;
.br
.B void (*fatal_func) ();
.PP
.B void
.br
.B gdbm_close (dbf)
.br
.B GDBM_FILE dbf;
.PP
.B int
.br
.B gdbm_store (dbf, key, content, flag)
.br
.B GDBM_FILE dbf;
.br
.B datum key, content;
.br
.B int flag;
.PP
.B datum
.br
.B gdbm_fetch (dbf, key)
.br
.B GDBM_FILE dbf;
.br
.B datum key;
.PP
.B int
.br
.B gdbm_delete (dbf, key)
.br
.B GDBM_FILE dbf;
.br
.B datum key;
.PP
.B datum
.br
.B gdbm_firstkey (dbf)
.br
.B GDBM_FILE dbf;
.PP
.B datum
.br
.B gdbm_nextkey (dbf, key)
.br
.B GDBM_FILE dbf;
.br
.B datum key;
.PP
.B int
.br
.B gdbm_reorganize (dbf)
.br
.B GDBM_FILE dbf;
.PP
.B void
.br
.B gdbm_sync (dbf)
.br
.B GDBM_FILE dbf;
.PP
.B int
.br
.B gdbm_exists (dbf, key)
.br
.B GDBM_FILE dbf;
.br
.B datum key;
.PP
.B char *
.br
.B gdbm_strerror (errno)
.br
.B gdbm_error errno;
.PP
.B int
.br
.B gdbm_setopt (dbf, option, value, size)
.br
.B GDBM_FILE dbf;
.br
.B int option;
.br
.B int *value;
.br
.B int size;
.PP
.B int
.br
.B gdbm_fdesc (dbf)
.br
.B GDBM_FILE dbf;
.PP
.PP
.B DBM Compatability routines:
.PP
.B #include <dbm.h>
.PP
.SM
.B int
.br
.B dbminit (name)
.br
.B char *name;
.PP
.B int
.br
.B store (key, content)
.br
.B datum key, content;
.PP
.B datum
.br
.B fetch (key)
.br
.B datum key;
.PP
.B int
.br
.B delete (key)
.br
.B datum key;
.PP
.B datum
.br
.B firstkey ()
.PP
.B datum
.br
.B nextkey (key)
.br
.B datum key;
.PP
.B int
.br
.B dbmclose ()
.PP
.PP
.B NDBM Compatability routines:
.PP
.B #include <ndbm.h>
.PP
.SM
.B DBM
.br
.B *dbm_open (name, flags, mode)
.br
.B char *name;
.br
.B int flags, mode;
.PP
.B void
.br
.B dbm_close (file)
.br
.B DBM *file;
.PP
.B datum
.br
.B dbm_fetch (file, key)
.br
.B DBM *file;
.br
.B datum key;
.PP
.B int
.br
.B dbm_store (file, key, content, flags)
.br
.B DBM *file;
.br
.B datum key, content;
.br
.B int flags;
.PP
.B int
.br
.B dbm_delete (file, key)
.br
.B DBM *file;
.br
.B datum key;
.PP
.B datum
.br
.B dbm_firstkey (file)
.br
.B DBM *file;
.PP
.B datum
.br
.B dbm_nextkey (file)
.br
.B DBM *file;
.PP
.B int
.br
.B dbm_error (file)
.br
.B DBM *file;
.PP
.B int
.br
.B dbm_clearerr (file)
.br
.B DBM *file;
.PP
.B int
.br
.B dbm_pagfno (file)
.br
.B DBM *file;
.PP
.B int
.br
.B dbm_dirfno (file)
.br
.B DBM *file;
.PP
.B int
.br
.B dbm_rdonly (file)
.br
.B DBM *file;


.SH 
GNU dbm ϡȥǡΥڥޤǡե갷
롼󷲤Υ饤֥Ǥ롣
󶡤륢ȤƤϡˤǼˤФ
ˤ¾٤ƤΥϤ륽ȤƤʤŪ
롣
ĤΥץʣΥǡեƱѤ뤳ȤǤ롣

gdbm ե򥪡ץ󤹤ץϡ֥꡼פޤϡ֥饤
ȸƤФ롣
1 Ĥ gdbm ե򥪡ץǤ饤 1 Ĥ
꡼ʣ 1 Ĥ gdbm ե򥪡ץ󤹤뤳ȤǤ롣

꡼ȥ饤ƱƱե򥪡ץ󤹤뤳ȤϤǤʤ
gdbm ե򥪡ץ󤹤³ϡ

  GDBM_FILE dbf;
 
   dbf = gdbm_open ( name, block_size, read_write, mode, fatal_func )

\fIname\fR ϥե̾Ǥ롣(̾gdbm Ϥ̾
ʸդä褦ʤȤϤʤ)
\fIblock_size\fR ϥǥ 1 ž륵Ǥ롣
Υѥ᡼ϡեξʳ̵뤵롣Ǿ
 512 Ǥ롣
512 ⾮ˤ, gdbm ϥե륷ƥФ stat
Υ֥åѤ롣
\fIread_write\fR ˤϰʲΤ줫ͤ롣
.br
.B GDBM_READER
꡼
.br
.B GDBM_WRITER
饤
.br
.B GDBM_WRCREAT
饤 - ǡ١¸ߤʤк
.br
.B GDBM_NEWDB
饤 - Ǥ¸ߤƤ⿷ǡ١
.br
Ǹ 3 ĤˤĤƤ (ǡ١Υ饤) \fIread_write\fR Ф
ʲӥåȤ OR ˤɲäǤ:
.B GDBM_SYNC
Ϥ٤ƤΥǡ١ǥƱ롢ޤ
.B GDBM_NOLOCK
ϥǡ١ե˴ؤ饤֥꤫ΥåưԤʤ
ץ
.B GDBM_FAST
 gdbm δư no-sync ⡼ɤˤʤäˤ⤦Ȥʤʤä
.br
\fImode\fR ϥեΥ⡼ɤǤ (\fBchmod(2)\fR  \fBopen(2)\fR 
)\fI(*fatal_func) ()\fR  dbm ̿Ū顼򸡽Ф˸ƤӽФ
ؿǤ롣δؿؤͣΥѥ᡼ʸǤ롣
 0 ꤵȡgdbm ϥǥեȤδؿѤ롣

֤ \fIdbf\fR ϡ gdbm ե˥¾Τ٤ƤΥ롼
ɬפʥݥ󥿤Ǥ롣 NULL ݥ󥿤֤ä硢\fBgdbm_open\fR 
ʤäȤ򼨤
gdbm Υ顼  \fIgdbm_errno\fR ˡƥΥ顼 \fIerrno\fR 
˳Ǽ롣(顼ɤˤĤƤ gdbmerrno.h 򻲾)

ʲΤ٤ƤΥˤƤϡ
ѥ᡼ \fIdbf\fR  \fBgdbm_open\fR 
֤äƤݥ󥿤Ǥ롣
ɤʥեǤ⥪ץ󤷤Τ򥯥뤳ȤϽפǤ롣
ϥեФ꡼饤򹹿롣
ϰʲΤ褦ˤƹԤ

   gdbm_close (dbf);

ǡ١ 3 Ĥμʥ롼ˤäѤǤ롣ǽϥǡ
ǡ١˳ǼΤǤ롣


   ret = gdbm_store ( dbf, key, content, flag )


\fIdbf\fR  \fBgdbm_open\fR ֤äƤݥ󥿤Ǥ롣
\fIkey\fR ϥǡǡ\fIcontent\fR  \fIkey\fR ˴Ϣդ줿
ǡǤ롣
\fIflag\fR ϰʲΤ줫ͤĤȤǤ롣
.br
.B GDBM_INSERT
Τߡ¸ߤХ顼Ȥʤ롣
.br
.B GDBM_REPLACE
¸ߤƤ򹹿롣

꡼ \fBgdbm_store\fR 򥳡뤷硢֤ͤ -1 Ȥʤ롣
GDBM_INSERT ꤵ줿˥ǡ١ \fIkey\fR ¸ߤȡ
֤ͤ 1 Ǥ롣Ǥʤ֤ͤ 0 Ǥ롣

\fI: ˥ǡ١¸ߤ륭ꤷƳǼ硢
GDBM_REPLACEǸƤӽФƤʤСgdbm ϸŤǡ
ǡ֤롣
Ʊ 2 ĤΥǡƥ뤳ȤϤǤʤ
ޤ gdbm_store 顼֤Ȥʤ

: gdbm Υϡdbm  ndbm Ȱۤʤ¤ʤ
ǡɬפʤ礭뤳ȤǤ롣
\fR

ǡ򸡺ˤϡʲΤ褦ˤ:

  content = gdbm_fetch ( dbf, key )

\fIdbf\fR  \fBgdbm_open\fR ֤äƤݥ󥿤Ǥ롣
\fIkey\fR ϥǡǤ롣

֤ͤ \fIdptr\fR  NULL ξ硢ǡϸĤʤä
ĤäϥǡؤΥݥ󥿤֤롣
\fIdptr\fR ε֤ \fBmalloc(3C)\fR ˤݤ롣 
\fBgdbm\fI ϼưŪˤΥǡ뤳ȤϤʤ
ɬפ̵ʤäΰΤϥץޤǤǤ롣\fR

ǡ򻲾Ȥˡˤϡ

   ret = gdbm_exists ( dbf, key )

\fIdbf\fR  \fBgdbm_open\fR ֤äƤݥ󥿤Ǥ롣
\fIkey\fR ϸǡǤ롣

ǡ١ \fIkey\fR ĤС֤ \fIret\fR  true Ǥ롣
.\" If nothing appropiate is found, \fIret\fR will be false.
бΤĤʤ \fIret\fR  false Ǥ롣

\fBgdbm_fetch\fR ǤϥݤԤ뤬Υ롼Ϥ򤷤ʤ
Τǡ쥳ɤ¸ߤå򤹤Ωġ

ǡ١餢ǡϡʲΤ褦ˤ:

   ret = gdbm_delete ( dbf, key )

\fIdbf\fR  \fBgdbm_open\fR ֤äƤݥ󥿤Ǥ롣\fIkey\fR 
ǡǤ롣

ƥब¸ߤʤäꡢ׵ᤷΤ꡼ä硢
֤ͤ -1 Ǥ롣
֤ͤ 0 Ǥ롣

 2 ĤΥ롼ϡǡ١Τ٤ƤΥƥ˥Ǥ롣
ϥǤϤʤǡ١Ǥ٤ƤΥ˳ 1 
뤳ȤݾڤƤ롣(ϥϥåͤνˤʤ롣)

   key = gdbm_firstkey ( dbf )

   nextkey = gdbm_nextkey ( dbf, key )

\fIdbf\fR  \fBgdbm_open\fR ֤äƤݥ󥿤Ǥ롣\fIkey\fR 
ǡǤ롣

֤ͤϤɤ \fBdatum\fR Ǥ롣֤ͤ \fIdptr\fR Ǥ NULL
ξ硢ǽΥޤϼΥʤäȤ򼨤
֤ͤ \fIdptr\fR ǤؤƤΤ \fBmalloc(3C)\fR
ˤݤ줿ǡǤꡢ\fBgdbm\fR  free ƤϤʤȤ
⤦դ뤳ȡ

δؿϥǡ١꡼ɥ꡼ǻȤ뤳ȤտޤƤ
ȤСǡ١ǧꤹ褦Ūǡ

եؤΡֻȡפϡ֥ϥå塦ơ֥פ˴ŤƤ롣
\fIgdbm_delete\fR ϥϥå塦ơ֥ƹơָĤ뤳ȤΤʤ
ƥबơ֥֤ʤ褦ˡ٤Ƥζǧ롣
٤ƤΥǡμΤѹäʤäȤƤ⡢ꥸʥΥ
ݾڤʤ

.\" It is possible that some key will not be visited if a loop like
.\" the following is executed:
ʲΥ롼פ¹Ԥ줿硢ĤΥĤ
ʤȤ롣


    key = gdbm_firstkey ( dbf );
    while ( key.dptr ) {
       nextkey = gdbm_nextkey ( dbf, key );
       if ( some condition ) {
          gdbm_delete ( dbf, key );
          free ( key.dptr );
       }
       key = nextkey;
    }


ʲΥ롼Ϸ֤Ȥ٤ǤϤʤ


   ret = gdbm_reorganize ( dbf )

⤷ʤκԤ\fBgdbm\fR ե뤬ȤäƤ
ڡ򾮤ȻפʤСΥ롼ϥǡ١κƹԤ
\fBgdbm\fR Ϥκƹʳ \fBgdbm\fR ȤäƤե礭
뤳Ȥ̵(줿ڡϺѤ)

ǡ١ GDBM_SYNC ե饰դ open ʤ¤ꡢgdbm ϼư
³ˡwrite ǥ˥եå夹ΤԤĤ褦ʤȤϤʤ
Υ롼ϥǡ١ʪŪ˥ǥ˽񤭽ФȤݾڤ롣

   gdbm_sync ( dbf )

ϥᥤξ֤ǥξ֤ƱޤǤäʤ

\fBgdbm\fR Υ顼ɤʸΥƥȤѴˤϡΥ롼
Ѥ롣

   ret = gdbm_strerror ( errno )


 \fIerrno\fR  \fIgdbm_error\fR Ǥꡢ̾ϥХѿ
 \fIgdbm_errno\fR Ǥ롣бե졼֤äƤ롣

\fBgdbm\fR ϴ open ƤեФ륪ץǤ
ǽ򥵥ݡȤƤ롣

   ret = gdbm_setopt ( dbf, option, value, size )

ǡ\fIdbf\fR ľ \fBgdbm_open\fR ֤ͤǤꡢ
\fIoption\fR ꤷץꤹ롣ߤץϡ

\fBGDBM_CACHESIZE\fR -  bucket åΥꤹ롣
Υץ \fIGDBM_FILE\fR Υǥץ˰٤Ǥ
ǡ١κǽΥ˼ưŪ 100 ꤵ롣

\fBGDBM_FASTMODE\fR - \fBfast mode\fR  on, off ꤹ롣
\fBfast mode\fR ϤǤ˥ץ󤵤Ƥơƥ֤ʥǡ١
Фƥȥ (on, off) Ǥ롣\fIvalue\fR (ʲ)  TRUE  FALSE 
Ǥ롣ΥץϤ⤦Ȥʤ

\fBGDBM_SYNCMODE\fR - ե륷ƥƱ on, off 롣
ΥǥեȤ off Ǥ롣\fIvalue\fR (ʲ)  TRUE  FALSE 
ꤹ롣

\fBGDBM_CENTFREE\fR - \fBcentral ե꡼֥åס\fR  on, off 롣
ǥեȤ off ǤꡢϰΥС \fBgdbm\fR Υե꡼
֥åμ갷ƱǤ롣⤷ꤵȡΥץϤ
θϥե꡼֥åϥХסˤ졢(Ūˤ) ¿
ե륹ڡ᤯Ѥ褦ˤʤ롣
\fIvalue\fR (ʲ)  TRUE  FALSE ꤹ٤Ǥ롣
աεǽϤޤƤǤ롣

\fBGDBM_COALESCEBLKS\fR - ե꡼֥åޡ󥰤 on, off 
롣ǥեȤ off ΥС \fBgdbm\fR Υե꡼֥å
ΰƱǤ롣⤷ꤵȤΥץϡնˤե꡼
֥åޡ롣 ä\fBGDBM_CENTFREE\fR Ȱ˻Ȥ줿
ȤƤ ֤ CPU Τˤʤ롣\fIvalue\fR (ʲ)  TRUE 
 FALSE ꤹ٤Ǥ롣
աεǽϤޤƤǤ롣

\fIvalue\fR  \fIoption\fR ꤹͤǤꡢinteger ؤΥݥ
Ǥ롣 \fIsize\fR  \fIvalue\fR ˤäƥݥȤǡ
Ǥ롣֤ͤ Ԥ -1 ˤʤꡢ 0 ˤʤ롣
Ԥξ硢Хѿ \fIgdbm_errno\fR ˤͤꤵ롣

㤨С\fBgdbm_open\fR ǥץ󤷤ǡ١򥢥ˡ
åȤ 10 Ȥ褦ꤹ硢ʲΥɤѤǤ롧

   int value = 10;

   ret = gdbm_setopt( dbf, GDBM_CACHESIZE, &value, sizeof(int));


⤷ǡ١ \fBGDBM_NOLOCK\fR ե饰դǥץ󤵤줿硢
桼ϥǡ١Фơ㤨ʣΥ饤ƱΥե
ФƹԤ褦ʡʬȼΥեå󥰤ȤȤǤ롢

򥵥ݡȤ뤿ᡢ\fIgdbm_fdesc\fR 롼󶡤롣

   ret = gdbm_fdesc ( dbf )

  \fIdbf\fR ϰ \fBgdbm_open\fR ֤ͤǤ롣
֤ͤϥǡ١ΥեǥץǤ롣


ʲ 2 ĤγѿΩĤȤ
\fIgdbm_errno\fR  gdbm Υ顼˴ؤܤġ
(gdbm.h ϥ顼ͤ gdbm_errno ѿȤ)
.br
\fIgdbm_version\fR ϥСʸġ


⤦̣ȤĤ롣ޤ \fBgdbm\fR ϡַ֤Τ
եǤ̵ȤȤǤ롣ʤϤΥե UNIX 
\fBcp(1)\fR ޥɤˤäƥԡ뤳ȤǽǡΥԡδ
˥ե륵ĥ褦ʤȤϤʤˡUNIX ǤǤ˻
Ƥ \fBdbm\fR Υѥ֥⡼ɤ¸ߤ롣Υѥ֥
⡼ɤǤϡ\fRgdbm\fR Υեݥ󥿤ϥץޤ˼äɬפǤ
ʤ٤ˤ 1 ĤΥեץ󤵤롣ѥ֥⡼
ƤѼԤϥ饤ȸʤ롣⤷\fBgdbm\fR ե뤬꡼
꡼ʤС饤ȤƤϼԤ꡼Ȥƥץľ
ߤ롣datum ¤ΤΤ٤ƤΥݥ󥿤ϡ\fBgdbm\fR Ǥ
ǡؤ (ɸŪ UNIX \fBdbm\fR 褦) 
Ūݥ󥿤Ȥưɬפ롣



.SH 
Υ饤֥ϥѥԤκǸΥѥ᡼Ȥ \fI-lgdbm\fR 
ꤹ뤳ȤѤ롣

.sp
	gcc -o prog prog.c -lgdbm
.SH Х


.SH Ϣ
dbm, ndbm

.SH 

by Philip A. Nelson and Jason Downs.
Copyright (C) 1990 - 1999 Free Software Foundation, Inc.
 
GDBM is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 1, or (at your option)
any later version.
 
GDBM is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.
 
You should have received a copy of the GNU General Public License
along with GDBM; see the file COPYING.  If not, write to
the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
 
You may contact the original author by:
.br
   e-mail:  phil@cs.wwu.edu
.br
  us-mail:  Philip A. Nelson
.br
Computer Science Department
.br
Western Washington University
.br
Bellingham, WA 98226
 
You may contact the current maintainer by:
.br
   e-mail:  downsj@downsj.com