.\"
.\" @(#)dbopen.3 8.5 (Berkeley) 1/2/94
.\"
-.\" Japanese Version Copyright (c) 1999 Shouichi Saito
-.\" all rights reserved.
-.\" Translated Thu Jul 22 00:00:00 JST 1999
-.\" by Shouichi Saito <ss236rx@ymg.urban.ne.jp>
-.\" Proofed Tue Aug 19 1999 by NAKANO Takeo <nakano@apm.seikei.ac.jp>
+.\"*******************************************************************
.\"
-.\"WORD: descriptor ¥Ç¥¹¥¯¥ê¥×¥¿
-.TH DBOPEN 3 1994-01-02 "" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH DBOPEN 3 1994\-01\-02 "" "Linux Programmer's Manual"
.UC 7
-.\"O .SH NAME
-.SH ̾Á°
-.\"O dbopen \- database access methods
-dbopen \- ¥Ç¡¼¥¿¥Ù¡¼¥¹¥¢¥¯¥»¥¹¥á¥½¥Ã¥É
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 名前
+dbopen \- データベースアクセスメソッド
+.SH 書式
.nf
-.B #include <sys/types.h>
-.B #include <limits.h>
-.B #include <db.h>
+\fB#include <sys/types.h>\fP
+\fB#include <limits.h>\fP
+\fB#include <db.h>\fP
-.BI "DB *dbopen(const char *" file ", int " flags ", int " mode \
-", DBTYPE " type ,
-.BI " const void *" openinfo );
+\fBDB *dbopen(const char *\fP\fIfile\fP\fB, int \fP\fIflags\fP\fB, int \fP\fImode\fP\fB, DBTYPE \fP\fItype\fP\fB,\fP
+\fB const void *\fP\fIopeninfo\fP\fB);\fP
.fi
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O .BR dbopen ()
-.\"O is the library interface to database files.
-.BR dbopen ()
-¤Ï¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë¤ËÂФ¹¤ë¥é¥¤¥Ö¥é¥ê¥¤¥ó¥¿¡¼¥Õ¥§¡¼¥¹¤Ç¤¢¤ë¡£
-.\"O The supported file formats are btree, hashed and UNIX file oriented.
-.\"O The btree format is a representation of a sorted, balanced tree structure.
-.\"O The hashed format is an extensible, dynamic hashing scheme.
-.\"O The flat-file format is a byte stream file with fixed or variable length
-.\"O records.
-¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¥Õ¥©¡¼¥Þ¥Ã¥È¤Ï btree, hash,
-UNIX ¥Õ¥¡¥¤¥ë¤Ë»Ø¸þ¤·¤¿¥Õ¥©¡¼¥Þ¥Ã¥È, ¤Î 3 ¤Ä¤Ç¤¢¤ë¡£
-btree ¥Õ¥©¡¼¥Þ¥Ã¥È¤Ï¡¢¥½¡¼¥È¤µ¤ì¤¿¥Ð¥é¥ó¥¹¥Ä¥ê¡¼¹½Â¤¤Ç¤¢¤ë¡£
-hashed ¥Õ¥©¡¼¥Þ¥Ã¥È¤Ï¡¢³ÈÄ¥²Äǽ¤ÊưŪ hash ¥¹¥¡¼¥à¤Ç¤¢¤ë¡£
-¥Õ¥é¥Ã¥È¥Õ¥¡¥¤¥ë (flat-file) ¥Õ¥©¡¼¥Þ¥Ã¥È¤Ï¡¢
-¸ÇÄêĹ/²ÄÊÑĹ¤Î¥ì¥³¡¼¥É¤«¤é¤Ê¤ë¥Ð¥¤¥È¥¹¥È¥ê¡¼¥à¥Õ¥¡¥¤¥ë¤Ç¤¢¤ë¡£
-.\"O The formats and file format specific information are described in detail
-.\"O in their respective manual pages
-.\"O .BR btree (3),
-.\"O .BR hash (3)
-.\"O and
-.\"O .BR recno (3).
-¤½¤ì¤¾¤ì¤Î¥Õ¥©¡¼¥Þ¥Ã¥È¤È¡¢¥Õ¥¡¥¤¥ë¥Õ¥©¡¼¥Þ¥Ã¥È¤ËÆÃͤξðÊó¤Ï
-¤½¤ì¤¾¤ìÂбþ¤¹¤ë¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸
-.BR btree (3),
-.BR hash (3),
-.BR recno (3)
-¤Ë¾ÜºÙ¤Ëµ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
+.SH 説明
+\fBdbopen\fP() はデータベースファイルに対するライブラリインターフェースである。 サポートされているファイルフォーマットは btree,
+hash, UNIX ファイルに指向したフォーマット, の 3 つである。 btree フォーマットは、ソートされたバランスツリー構造である。
+hashed フォーマットは、拡張可能な動的 hash スキームである。 フラットファイル (flat\-file) フォーマットは、
+固定長/可変長のレコードからなるバイトストリームファイルである。 それぞれのフォーマットと、ファイルフォーマットに特有の情報は
+それぞれ対応するマニュアルページ \fBbtree\fP(3), \fBhash\fP(3), \fBrecno\fP(3) に詳細に記述されている。
.PP
-.\"O .BR dbopen ()
-.\"O opens
-.\"O .I file
-.\"O for reading and/or writing.
-.BR dbopen ()
-¤Ï
-.I file
-¤òÆɤ߹þ¤ß (Æɤ߽ñ¤) ¤¹¤ë¤¿¤á¤Ë¥ª¡¼¥×¥ó¤¹¤ë¡£
-.\"O Files never intended to be preserved on disk may be created by setting
-.\"O the
-.\"O .I file
-.\"O argument to NULL.
-.I file
-°ú¤¿ô¤ò NULL ¤Ë¤¹¤ì¤Ð¡¢
-¥Ç¥£¥¹¥¯¾å¤ËÊݸ¤·¤¿¤¯¤Ê¤¤¥Õ¥¡¥¤¥ë¤òºî¤ë¤³¤È¤â¤Ç¤¤ë¡£
+\fBdbopen\fP() は \fIfile\fP を読み込み (読み書き) するためにオープンする。 \fIfile\fP 引き数を NULL にすれば、
+ディスク上に保存したくないファイルを作ることもできる。
.PP
-.\"O The
-.\"O .I flags
-.\"O and
-.\"O .I mode
-.\"O arguments are as specified to the
-.\"O .BR open (2)
-.\"O routine, however, only the
-.\"O .BR O_CREAT ,
-.\"O .BR O_EXCL ,
-.\"O .BR O_EXLOCK ,
-.\"O .BR O_NONBLOCK ,
-.\"O .BR O_RDONLY ,
-.\"O .BR O_RDWR ,
-.\"O .BR O_SHLOCK ,
-.\"O and
-.\"O .B O_TRUNC
-.\"O flags are meaningful.
-.I flags
-¤È
-.I mode
-°ú¤¿ô¤Ï
-.BR open (2)
-¥ë¡¼¥Á¥ó¤Ç»ØÄꤹ¤ë¤Î¤ÈƱÍͤǤ¢¤ë¡£¤¿¤À¤·
-°ÕÌ£¤ò»ý¤Ä¥Õ¥é¥°¤Ï
-.BR O_CREAT ,
-.BR O_EXCL ,
-.BR O_EXLOCK ,
-.BR O_NONBLOCK ,
-.BR O_RDONLY ,
-.BR O_RDWR ,
-.BR O_SHLOCK ,
-.B O_TRUNC
-¤À¤±¤Ç¤¢¤ë¡£
-.\"O (Note, opening a database file
-.\"O .B O_WRONLY
-.\"O is not possible.)
-(Ãí°Õ:
-.B O_WRONLY
-¤Ç¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë¤ò³«¤¯»ö¤Ï½ÐÍè¤Ê¤¤)
-.\"Three additional options may be specified by
-.\".IR or 'ing
+.\"Three additional options may be specified by ORing
.\"them into the
.\".I flags
.\"argument.
.\"DB_TXN
.\"Support transactions in the database.
.\"The DB_LOCK and DB_SHMEM flags must be set as well.
+\fIflags\fP と \fImode\fP 引き数は \fBopen\fP(2) ルーチンで指定するのと同様である。ただし 意味を持つフラグは
+\fBO_CREAT\fP, \fBO_EXCL\fP, \fBO_EXLOCK\fP, \fBO_NONBLOCK\fP, \fBO_RDONLY\fP, \fBO_RDWR\fP,
+\fBO_SHLOCK\fP, \fBO_TRUNC\fP だけである。 (注意: \fBO_WRONLY\fP でデータベースファイルを開く事は出来ない)
.PP
-.\"O The
-.\"O .I type
-.\"O argument is of type
-.\"O .I DBTYPE
-.\"O (as defined in the
-.\"O .I <db.h>
-.\"O include file) and
-.\"O may be set to
-.\"O .BR DB_BTREE ,
-.\"O .BR DB_HASH ,
-.\"O or
-.\"O .BR DB_RECNO .
-.I type
-°ú¤¿ô¤Ï
-.I DBTYPE
-·¿¤Ç¤¢¤ë (¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë
-.I <db.h>
-¤ÇÄêµÁ¤µ¤ì¤Æ¤¤¤ë)¡£
-.BR DB_BTREE ,
-.BR DB_HASH ,
-.B DB_RECNO
-¤Î¤¤¤º¤ì¤«¤ò¥»¥Ã¥È¤Ç¤¤ë¡£
+\fItype\fP 引き数は \fIDBTYPE\fP 型である (インクルードファイル \fI<db.h>\fP で定義されている)。
+\fBDB_BTREE\fP, \fBDB_HASH\fP, \fBDB_RECNO\fP のいずれかをセットできる。
.PP
-.\"O The
-.\"O .I openinfo
-.\"O argument is a pointer to an access method specific structure described
-.\"O in the access method's manual page.
-.\"O If
-.\"O .I openinfo
-.\"O is NULL, each access method will use defaults appropriate for the system
-.\"O and the access method.
-.I openinfo
-°ú¤¿ô¤Ï¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ë¸Çͤʹ½Â¤ÂΤؤΥݥ¤¥ó¥¿¤Ç¤¢¤ë¡£
-¤½¤ì¤¾¤ì¤Î¹½Â¤ÂΤ˴ؤ·¤Æ¤Ï³Æ¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Î
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ëµ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
-.I openinfo
-¤¬ NULL ¤Î¾ì¹ç¡¢¤½¤ì¤¾¤ì¤Î¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤È¥·¥¹¥Æ¥à¤È¤ËŬ¹ç¤·¤¿
-¥Ç¥Õ¥©¥ë¥È¤¬ÍѤ¤¤é¤ì¤ë¡£
+\fIopeninfo\fP 引き数はアクセスメソッドに固有な構造体へのポインタである。 それぞれの構造体に関しては各アクセスメソッドの
+マニュアルページに記述されている。 \fIopeninfo\fP が NULL の場合、それぞれのアクセスメソッドとシステムとに適合した
+デフォルトが用いられる。
.PP
-.\"O .BR dbopen ()
-.\"O returns a pointer to a
-.\"O .I DB
-.\"O structure on success and NULL on error.
-.\"O The
-.\"O .I DB
-.\"O structure is defined in the
-.\"O .I <db.h>
-.\"O include file, and contains at
-.\"O least the following fields:
-.BR dbopen ()
-¤Ï¡¢À®¸ù¤·¤¿¾ì¹ç
-.I DB
-¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤ò¡¢¥¨¥é¡¼¤Î¾ì¹ç NULL ¤òÊÖ¤¹¡£
-.I DB
-¹½Â¤ÂΤÏ
-.I <db.h>
-¥¤¥ó¥¯¥ë¡¼¥É¥Õ¥¡¥¤¥ë¤ÎÃæ¤ÇÄêµÁ¤µ¤ì¤Æ¤ª¤ê¡¢
-¾¯¤Ê¤¯¤È¤â°Ê²¼¤Î¤è¤¦¤Ê¥Õ¥£¡¼¥ë¥É¤ò»ý¤Ã¤Æ¤¤¤ë¡£
+\fBdbopen\fP() は、成功した場合 \fIDB\fP 構造体へのポインタを、エラーの場合 NULL を返す。 \fIDB\fP 構造体は
+\fI<db.h>\fP インクルードファイルの中で定義されており、 少なくとも以下のようなフィールドを持っている。
.sp
.in +4n
.nf
.fi
.in
.PP
-.\"O These elements describe a database type and a set of functions performing
-.\"O various actions.
-.\"O These functions take a pointer to a structure as returned by
-.\"O .BR dbopen (),
-.\"O and sometimes one or more pointers to key/data structures and a flag value.
-³ÆÍ×ÁǤˤϡ¢¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥¿¥¤¥×¤È¡¢
-ÍÍ¡¹¤ÊÆ°ºî¤ò¤¹¤ë´Ø¿ô¤Î¥»¥Ã¥È¤¬µ½Ò¤µ¤ì¤Æ¤¤¤ë¡£
-¤³¤ì¤é¤Î´Ø¿ô¤Ï
-.BR dbopen ()
-¤Ë¤è¤Ã¤ÆÊÖ¤µ¤ì¤ë¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤ò°ú¤¿ô¤Ë¤È¤ë¡£
-¥¡¼/¥Ç¡¼¥¿¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤ä¥Õ¥é¥°Ãͤò¼è¤ë¤â¤Î¤â¤¢¤ë¡£
-.TP
-.I type
-.\"O The type of the underlying access method (and file format).
-ÍѤ¤¤é¤ì¤Æ¤¤¤ë¥¢¥¯¥»¥¹¥á¥½¥Ã¥É (¤È¥Õ¥¡¥¤¥ë¥Õ¥©¡¼¥Þ¥Ã¥È) ¤Î·¿¡£
-.TP
-.I close
-.\"O A pointer to a routine to flush any cached information to disk, free any
-.\"O allocated resources, and close the underlying file(s).
-¥¥ã¥Ã¥·¥å¤µ¤ì¤¿¾ðÊó¤ò¥Ç¥£¥¹¥¯¤ËÁݤ¤À¤¹¤¿¤á¤Î¥ë¡¼¥Á¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
-³ä¤êÅö¤Æ¤é¤ì¤¿¥ê¥½¡¼¥¹¤ò²òÊü¤·¡¢ÍøÍѤ·¤¿¥Õ¥¡¥¤¥ë(·²)¤ò¥¯¥í¡¼¥º¤¹¤ë¡£
-.\"O Since key/data pairs may be cached in memory, failing to sync the file
-.\"O with a
-.\"O .I close
-.\"O or
-.\"O .I sync
-.\"O function may result in inconsistent or lost information.
-¥¡¼/¥Ç¡¼¥¿ÂФ¬¥á¥â¥ê¤Ë¥¥ã¥Ã¥·¥å¤µ¤ì¤Æ¤¤¤ë¾ì¹ç¡¢
-.I close
-¤ä
-.I sync
-´Ø¿ô¤Ç¤ÎƱ´ü¤Ë¼ºÇÔ¤¹¤ë¤È¡¢¾ðÊó¤ËÌ·½â¤¬À¸¤¸¤ë¤«¾ðÊó¤ò¼º¤¦²ÄǽÀ¤¬¤¢¤ë¡£
-.\"O .I close
-.\"O routines return \-1 on error (setting
-.\"O .IR errno )
-.\"O and 0 on success.
-.I close
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£
-.TP
-.I del
-.\"O A pointer to a routine to remove key/data pairs from the database.
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤é¥¡¼/¥Ç¡¼¥¿ÂФòºï½ü¤¹¤ë¥ë¡¼¥Á¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
+各要素には、データベースのタイプと、 様々な動作をする関数のセットが記述されている。 これらの関数は \fBdbopen\fP()
+によって返される構造体へのポインタを引き数にとる。 キー/データ構造体へのポインタやフラグ値を取るものもある。
+.TP
+\fItype\fP
+用いられているアクセスメソッド (とファイルフォーマット) の型。
+.TP
+\fIclose\fP
+キャッシュされた情報をディスクに掃きだすためのルーチンへのポインタ。 割り当てられたリソースを解放し、利用したファイル(群)をクローズする。
+キー/データ対がメモリにキャッシュされている場合、 \fIclose\fP や \fIsync\fP
+関数での同期に失敗すると、情報に矛盾が生じるか情報を失う可能性がある。 \fIclose\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP
+をセットする)、成功すると 0 を返す。
+.TP
+\fIdel\fP
+データベースからキー/データ対を削除するルーチンへのポインタ。
.IP
-.\"O The argument
-.\"O .I flag
-.\"O may be set to the following value:
-.I flag
-°ú¤¿ô¤Ï¼¡¤ÎÃͤ¬¥»¥Ã¥È¤Ç¤¤ë¡£
+\fIflag\fP 引き数は次の値がセットできる。
.RS
-.TP
-.B R_CURSOR
-.\"O Delete the record referenced by the cursor.
-.\"O The cursor must have previously been initialized.
-¥«¡¼¥½¥ë (cursor) ¤¬»²¾È¤·¤Æ¤¤¤ë¥ì¥³¡¼¥É¤òºï½ü¤¹¤ë¡£
-¥«¡¼¥½¥ë¤ÏÁ°¤â¤Ã¤Æ½é´ü²½¤µ¤ì¤Æ¤¤¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
+.TP
+\fBR_CURSOR\fP
+カーソル (cursor) が参照しているレコードを削除する。 カーソルは前もって初期化されていなくてはならない。
.RE
.IP
-.\"O .I delete
-.\"O routines return \-1 on error (setting
-.\"O .IR errno ),
-.\"O 0 on success, and 1 if the specified
-.\"O .I key
-.\"O was not in the file.
-.I delete
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£¤Þ¤¿»ØÄê¤Î
-.I key
-¤¬¥Õ¥¡¥¤¥ëÃæ¤Ë̵¤¤¾ì¹ç 1 ¤òÊÖ¤¹¡£
-.TP
-.I fd
-.\"O A pointer to a routine which returns a file descriptor representative
-.\"O of the underlying database.
-ÍѤ¤¤Æ¤¤¤ë¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¥ë¡¼¥Á¥ó
-¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
-.\"O A file descriptor referencing the same file will be returned to all
-.\"O processes which call
-.\"O .BR dbopen ()
-.\"O with the same
-.\"O .I file
-.\"O name.
-Ʊ¤¸¥Õ¥¡¥¤¥ë̾
-.I file
-¤Ç
-.BR dbopen ()
-¤ò¸Æ¤Ó½Ð¤·¤¿Á´¤Æ¤Î¥×¥í¥»¥¹¤ËÂФ·¤Æ¡¢
-¤½¤Î¥Õ¥¡¥¤¥ë¤ò¼¨¤¹Ã±°ì¤Î¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤¬ÊÖ¤µ¤ì¤ë¡£
-.\"O This file descriptor may be safely used as an argument to the
-.\"O .BR fcntl (2)
-.\"O and
-.\"O .BR flock (2)
-.\"O locking functions.
-¤³¤Î¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤Ï¥í¥Ã¥¯´Ø¿ô
-.BR fcntl (2)
-¤È
-.BR flock (2)
-¤Ø¤Î°ú¤¿ô¤È¤·¤Æ°ÂÁ´¤Ë»ÈÍѤǤ¤ë¡£
-.\"O The file descriptor is not necessarily associated with any of the
-.\"O underlying files used by the access method.
-.\"O No file descriptor is available for in memory databases.
-.\"O .I fd
-.\"O routines return \-1 on error (setting
-.\"O .IR errno ),
-.\"O and the file descriptor on success.
-¤³¤Î¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤Ï¡¢É¬¤º¤·¤â¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ç
-ÍѤ¤¤é¤ì¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë¤Î¤¤¤º¤ì¤«¤Ë´ØÏ¢¤Å¤±¤é¤ì¤Æ¤¤¤Ê¤¯¤Æ¤âÎɤ¤¡£
-¥á¥â¥êÆâ¤Î¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ë¤Ï¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤Ï̵¤¤¡£
-.I fd
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢À®¸ù¤¹¤ë¤È¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤òÊÖ¤¹¡£
-.TP
-.I get
-.\"O A pointer to a routine which is the interface for keyed retrieval from
-.\"O the database.
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤é¥¡¼¤òÍѤ¤¤Æ¥Ç¡¼¥¿¤ò¼è¤ê½Ð¤¹¤¿¤á¤Î
-¥ë¡¼¥Á¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
-.\"O The address and length of the data associated with the specified
-.\"O .I key
-.\"O are returned in the structure referenced by
-.\"O .IR data .
-»ØÄꤷ¤¿
-.I key
-¤Ë´ØÏ¢¤Å¤±¤é¤ì¤¿¥Ç¡¼¥¿¤Î¥¢¥É¥ì¥¹¤ÈŤµ¤¬
-.I data
-¤¬»²¾È¤¹¤ë¹½Â¤ÂΤËÊÖ¤µ¤ì¤ë¡£
-.\"O .I get
-.\"O routines return \-1 on error (setting
-.\"O .IR errno ),
-.\"O 0 on success, and 1 if the
-.\"O .I key
-.\"O was not in the file.
-.I get
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£¤Þ¤¿
-.I key
-¤¬¥Õ¥¡¥¤¥ëÃæ¤Ë̵¤¤¾ì¹ç 1 ¤òÊÖ¤¹¡£
-.TP
-.I put
-.\"O A pointer to a routine to store key/data pairs in the database.
-¥¡¼/¥Ç¡¼¥¿ÂФò¥Ç¡¼¥¿¥Ù¡¼¥¹¤ËǼ¤á¤ë¥ë¡¼¥Á¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
+\fIdelete\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、成功すると 0 を返す。また指定の \fIkey\fP
+がファイル中に無い場合 1 を返す。
+.TP
+\fIfd\fP
+用いているデータベースのファイルデスクリプタを返すルーチン へのポインタ。 同じファイル名 \fIfile\fP で \fBdbopen\fP()
+を呼び出した全てのプロセスに対して、 そのファイルを示す単一のファイルデスクリプタが返される。 このファイルデスクリプタはロック関数
+\fBfcntl\fP(2) と \fBflock\fP(2) への引き数として安全に使用できる。 このファイルデスクリプタは、必ずしもアクセスメソッドで
+用いられているファイルのいずれかに関連づけられていなくても良い。 メモリ内のデータベースにはファイルデスクリプタは無い。 \fIfd\fP
+ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、成功するとファイルデスクリプタを返す。
+.TP
+\fIget\fP
+データベースからキーを用いてデータを取り出すための ルーチンへのポインタ。 指定した \fIkey\fP に関連づけられたデータのアドレスと長さが
+\fIdata\fP が参照する構造体に返される。 \fIget\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、成功すると 0
+を返す。また \fIkey\fP がファイル中に無い場合 1 を返す。
+.TP
+\fIput\fP
+キー/データ対をデータベースに納めるルーチンへのポインタ。
.IP
-.\"O The argument
-.\"O .I flag
-.\"O may be set to one of the following values:
-.I flag
-°ú¤¿ô¤Ë¤Ï¼¡¤ÎÃͤΤ¦¤Á¤Î¤É¤ì¤«°ì¤Ä¤¬¥»¥Ã¥È¤Ç¤¤ë¡£
+\fIflag\fP 引き数には次の値のうちのどれか一つがセットできる。
.RS
-.TP
-.B R_CURSOR
-.\"O Replace the key/data pair referenced by the cursor.
-.\"O The cursor must have previously been initialized.
-¥«¡¼¥½¥ë¤¬»²¾È¤·¤Æ¤¤¤ë¥¡¼/¥Ç¡¼¥¿ÂФòÃÖ¤´¹¤¨¤ë¡£
-¥«¡¼¥½¥ë¤ÏÁ°¤â¤Ã¤Æ½é´ü²½¤µ¤ì¤Æ¤¤¤ëɬÍפ¬¤¢¤ë¡£
-.TP
-.B R_IAFTER
-.\"O Append the data immediately after the data referenced by
-.\"O .IR key ,
-.\"O creating a new key/data pair.
-.\"O The record number of the appended key/data pair is returned in the
-.\"O .I key
-.\"O structure.
-.\"O (Applicable only to the
-.\"O .B DB_RECNO
-.\"O access method.)
-.I key
-¤Ç»²¾È¤µ¤ì¤ë¥Ç¡¼¥¿¤Îľ¸å¤Ë¡¢
-¿·¤·¤¤¥¡¼/¥Ç¡¼¥¿ÂФòºî¤Ã¤Æ¥Ç¡¼¥¿¤òÄɲ乤롣
-Äɲ䵤줿¥¡¼/¥Ç¡¼¥¿ÂФΥ쥳¡¼¥ÉÈÖ¹æ¤Ï
-.I key
-¹½Â¤ÂΤËÊÖ¤µ¤ì¤ë¡£
-.RB ( DB_RECNO
-¥¢¥¯¥»¥¹ÊýË¡¤Ç¤Î¤ß»È¤¨¤ë¡£)
-.TP
-.B R_IBEFORE
-.\"O Insert the data immediately before the data referenced by
-.\"O .IR key ,
-.\"O creating a new key/data pair.
-.\"O The record number of the inserted key/data pair is returned in the
-.\"O .I key
-.\"O structure.
-.\"O (Applicable only to the
-.\"O .B DB_RECNO
-.\"O access method.)
-.I key
-¤Ç»²¾È¤µ¤ì¤ë¥Ç¡¼¥¿¤ÎľÁ°¤Ë¡¢
-¿·¤·¤¤¥¡¼/¥Ç¡¼¥¿ÂФòºî¤Ã¤Æ¥Ç¡¼¥¿¤òÁÞÆþ¤¹¤ë¡£
-Äɲ䵤줿¥¡¼/¥Ç¡¼¥¿ÂФΥ쥳¡¼¥ÉÈÖ¹æ¤Ï
-.I key
-¹½Â¤ÂΤËÊÖ¤µ¤ì¤ë¡£
-.RB ( DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ç¤Î¤ß»È¤¨¤ë¡£)
-.TP
-.B R_NOOVERWRITE
-.\"O Enter the new key/data pair only if the key does not previously exist.
-¥¡¼¤¬¤¢¤é¤«¤¸¤á¸ºß¤·¤Ê¤¤¾ì¹ç¤Ë¸Â¤ê¡¢¿·¤·¤¤¥¡¼/¥Ç¡¼¥¿ÂФò¤¤¤ì¤ë¡£
-.TP
-.B R_SETCURSOR
-.\"O Store the key/data pair, setting or initializing the position of the
-.\"O cursor to reference it.
-.\"O (Applicable only to the
-.\"O .B DB_BTREE
-.\"O and
-.\"O .B DB_RECNO
-.\"O access methods.)
-¥¡¼/¥Ç¡¼¥¿ÂФòǼ¤á¡¢¤½¤ì¤ò»Ø¤¹¤è¤¦¤Ë¥«¡¼¥½¥ë°ÌÃÖ¤ò¥»¥Ã¥È¤¢¤ë¤¤¤Ï½é´ü
-²½¤¹¤ë¡£
-.RB ( DB_BTREE
-¤È
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ç¤Î¤ß»È¤¨¤ë¡£)
+.TP
+\fBR_CURSOR\fP
+カーソルが参照しているキー/データ対を置き換える。 カーソルは前もって初期化されている必要がある。
+.TP
+\fBR_IAFTER\fP
+\fIkey\fP で参照されるデータの直後に、 新しいキー/データ対を作ってデータを追加する。 追加されたキー/データ対のレコード番号は \fIkey\fP
+構造体に返される。 (\fBDB_RECNO\fP アクセス方法でのみ使える。)
+.TP
+\fBR_IBEFORE\fP
+\fIkey\fP で参照されるデータの直前に、 新しいキー/データ対を作ってデータを挿入する。 追加されたキー/データ対のレコード番号は \fIkey\fP
+構造体に返される。 (\fBDB_RECNO\fP アクセスメソッドでのみ使える。)
+.TP
+\fBR_NOOVERWRITE\fP
+キーがあらかじめ存在しない場合に限り、新しいキー/データ対をいれる。
+.TP
+\fBR_SETCURSOR\fP
+キー/データ対を納め、それを指すようにカーソル位置をセットあるいは初期 化する。 (\fBDB_BTREE\fP と \fBDB_RECNO\fP
+アクセスメソッドでのみ使える。)
.RE
.IP
-.\"O .B R_SETCURSOR
-.\"O is available only for the
-.\"O .B DB_BTREE
-.\"O and
-.\"O .B DB_RECNO
-.\"O access
-.\"O methods because it implies that the keys have an inherent order
-.\"O which does not change.
-.B R_SETCURSOR
-¤Ï
-.B DB_BTREE
-¤È
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ç¤·¤«ÍøÍѤǤ¤Ê¤¤¡£
-¤Ê¤¼¤Ê¤é
-.B R_SETCURSOR
-¤òÍѤ¤¤ë¤Ë¤Ï¡¢Êѹ¹¤µ¤ì¤ë»ö¤Î̵¤¤¸Çͤνç½ø¤ò¥¡¼
-¤¬»ý¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¤«¤é¤Ç¤¢¤ë¡£
+\fBR_SETCURSOR\fP は \fBDB_BTREE\fP と \fBDB_RECNO\fP アクセスメソッドでしか利用できない。 なぜなら
+\fBR_SETCURSOR\fP を用いるには、変更される事の無い固有の順序をキー が持っていなければならないからである。
.IP
-.\"O .B R_IAFTER
-.\"O and
-.\"O .B R_IBEFORE
-.\"O are available only for the
-.\"O .B DB_RECNO
-.\"O access method because they each imply that the access method is able to
-.\"O create new keys.
-.\"O This is only true if the keys are ordered and independent, record numbers
-.\"O for example.
-.B R_IAFTER
-¤È
-.B R_IBEFORE
-¤Ï
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ç¤·¤«ÍøÍѤǤ¤Ê¤¤¡£
-¤³¤ì¤é¤ò¼Â¸½¤¹¤ë¤Ë¤Ï¡¢¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤¬
-¿·¤·¤¤¥¡¼¤òºî¤ì¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¤«¤é¤Ç¤¢¤ë¡£
-¤³¤ì¤¬À®Î©¤¹¤ë¤Î¤Ï¡¢Î㤨¤Ð¡¢½ç½ø¤Å¤±¤é¤¿ÆÈΩ¤Ê¥ì¥³¡¼¥ÉÈֹ椬
-¥¡¼¤Ë¤Ê¤Ã¤Æ¤¤¤ë¤è¤¦¤Ê¾ì¹ç¤À¤±¤Ç¤¢¤ë¡£
+\fBR_IAFTER\fP と \fBR_IBEFORE\fP は \fBDB_RECNO\fP アクセスメソッドでしか利用できない。
+これらを実現するには、アクセスメソッドが 新しいキーを作れなければならないからである。 これが成立するのは、例えば、順序づけらた独立なレコード番号が
+キーになっているような場合だけである。
.IP
-.\"O The default behavior of the
-.I put
-.\"O routines is to enter the new key/data pair, replacing any previously
-.\"O existing key.
-¥ë¡¼¥Á¥ó¤Î¥Ç¥Õ¥©¥ë¥È¤ÎÆ°ºî¤Ï¡¢¿·¤·¤¤¥¡¼/¥Ç¡¼¥¿ÂФò
-´û¤Ë¸ºß¤¹¤ë¥¡¼¤òÃÖ¤´¹¤¨¤ë»ö¤Æ³ÊǼ¤¹¤ëÆ°ºî¤Ç¤¢¤ë¡£
+\fIput\fP ルーチンのデフォルトの動作は、新しいキー/データ対を 既に存在するキーを置き換える事て格納する動作である。
.IP
-.I put
-.\"O routines return \-1 on error (setting
-.\"O .IR errno ),
-.\"O 0 on success, and 1 if the
-.\"O .B R_NOOVERWRITE
-.\"O .I flag
-.\"O was set and the key already exists in the file.
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£¤Þ¤¿
-.I flag
-¤Ë
-.B R_NOOVERWRITE
-¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤Æ¥¡¼¤¬´û¤Ë¸ºß¤¹¤ë¾ì¹ç 1 ¤òÊÖ¤¹¡£
-.TP
-.I seq
-.\"O A pointer to a routine which is the interface for sequential
-.\"O retrieval from the database.
-.\"O The address and length of the key are returned in the structure
-.\"O referenced by
-.\"O .IR key ,
-.\"O and the address and length of the data are returned in the
-.\"O structure referenced
-.\"O by
-.\"O .IR data .
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤«¤é¥·¡¼¥±¥ó¥·¥ã¥ë¤Ë¥Ç¡¼¥¿¤ò¼è¤ê½Ð¤¹¤¿¤á¤Î
-¥ë¡¼¥Á¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
-¥¡¼¤Î¥¢¥É¥ì¥¹¤ÈŤµ¤¬
-.I key
-¤¬»²¾È¤¹¤ë¹½Â¤ÂΤËÊÖ¤µ¤ì¤ë¡£¥Ç¡¼¥¿¤Î¥¢¥É¥ì¥¹¤ÈŤµ¤¬
-.I data
-¤¬»²¾È¤¹¤ë¹½Â¤ÂΤËÊÖ¤µ¤ì¤ë¡£
+\fIput\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、成功すると 0 を返す。また \fIflag\fP に
+\fBR_NOOVERWRITE\fP がセットされていてキーが既に存在する場合 1 を返す。
+.TP
+\fIseq\fP
+データベースからシーケンシャルにデータを取り出すための ルーチンへのポインタ。 キーのアドレスと長さが \fIkey\fP
+が参照する構造体に返される。データのアドレスと長さが \fIdata\fP が参照する構造体に返される。
.IP
-.\"O Sequential key/data pair retrieval may begin at any time, and the
-.\"O position of the "cursor" is not affected by calls to the
-¥·¡¼¥±¥ó¥·¥ã¥ë¤Ê¥¡¼/¥Ç¡¼¥¿ÂФμèÆÀ¤Ï¤¤¤Ä¤Ç¤â¹Ô¤¨¤ë¡£¤Þ¤¿
-¡Ö¥«¡¼¥½¥ë¡×¤Î°ÌÃÖ¤Ï
-.IR del ,
-.IR get ,
-.IR put ,
-.\"O or
-.I sync
-.\"O routines.
-¥ë¡¼¥Á¥ó¤Î¸Æ¤Ó½Ð¤·¤Ë¤Ï±Æ¶Á¤µ¤ì¤Ê¤¤¡£
-.\"O Modifications to the database during a sequential scan will be reflected
-.\"O in the scan, that is,
-.\"O records inserted behind the cursor will not be returned
-.\"O while records inserted in front of the cursor will be returned.
-¥·¡¼¥±¥ó¥·¥ã¥ë¤Ê¥¹¥¥ã¥ó¤ÎÅÓÃæ¤Ë¹Ô¤ï¤ì¤¿¥Ç¡¼¥¿¥Ù¡¼¥¹¤Ø¤ÎÊѹ¹¤Ï
-¥¹¥¥ã¥ó¤ËÈ¿±Ç¤µ¤ì¤ë¡£¤¹¤Ê¤ï¤Á¡¢¥«¡¼¥½¥ë¤Î¸å¤í¤ËÁÞÆþ¤µ¤ì¤¿¥ì¥³¡¼¥É¤Ï
-ÊÖ¤µ¤ì¤Ê¤¤¤¬¡¢¥«¡¼¥½¥ë¤ÎÁ°¤ËÁÞÆþ¤µ¤ì¤¿¥ì¥³¡¼¥É¤ÏÊÖ¤µ¤ì¤ë¡£
+シーケンシャルなキー/データ対の取得はいつでも行える。また 「カーソル」の位置は \fIdel\fP, \fIget\fP, \fIput\fP, \fIsync\fP
+ルーチンの呼び出しには影響されない。 シーケンシャルなスキャンの途中に行われたデータベースへの変更は
+スキャンに反映される。すなわち、カーソルの後ろに挿入されたレコードは 返されないが、カーソルの前に挿入されたレコードは返される。
.IP
-.\"O The flag value
-.\"O .B must
-.\"O be set to one of the following values:
-¥Õ¥é¥°ÃͤˤÏ\fBɬ¤º\fP°Ê²¼¤Ë¼¨¤¹¤¦¤Á¤Î
-¤É¤ì¤«°ì¤Ä¤ò¥»¥Ã¥È¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
+フラグ値には\fB必ず\fP以下に示すうちの どれか一つをセットしなければならない。
.RS
-.TP
-.B R_CURSOR
-.\"O The data associated with the specified key is returned.
-.\"O This differs from the
-.\"O .I get
-.\"O routines in that it sets or initializes the cursor to the location of
-.\"O the key as well.
-.\"O (Note, for the
-.\"O .B DB_BTREE
-.\"O access method, the returned key is not necessarily an
-.\"O exact match for the specified key.
-.\"O The returned key is the smallest key greater than or equal to the specified
-.\"O key, permitting partial key matches and range searches.)
-»ØÄꤷ¤¿¥¡¼¤Ë´ØÏ¢¤Å¤±¤é¤ì¤¿¥Ç¡¼¥¿¤¬ÊÖ¤µ¤ì¤ë¡£
-.I get
-¥ë¡¼¥Á¥ó¤È¤Î°ã¤¤¤Ï¡¢¥«¡¼¥½¥ë¤¬¥¡¼¤Î°ÌÃ֤˥»¥Ã¥È¤¢¤ë¤¤¤Ï
-½é´ü²½¤µ¤ì¤ëÅÀ¤Ç¤¢¤ë¡£
-(Ãí°Õ:
-.B DB_BTREE
-¥¢¥¯¥»¥¹ÊýË¡¤Ç¤Ï¡¢ÊÖ¤µ¤ì¤¿¥¡¼¤¬
-ɬ¤º¤·¤â»ØÄꤷ¤¿¥¡¼¤ËÀµ¤·¤¯¥Þ¥Ã¥Á¤·¤Ê¤¤¤«¤â¤·¤ì¤Ê¤¤¡£
-ÊÖ¤µ¤ì¤¿¥¡¼¤Ï¡¢»ØÄꤵ¤ì¤¿¥¡¼¤ËÅù¤·¤¤¤«¤è¤êÂ礤¤¤â¤Î¤Î¤¦¤Á
-ºÇ¾®¤Î¤â¤Î¤Ë¤Ê¤ë
-(Éôʬ¥¡¼¥Þ¥Ã¥Á¤«Èϰϸ¡º÷¤¬µö²Ä¤µ¤ì¤Æ¤¤¤ë¾ì¹ç)¡£)
-.TP
-.B R_FIRST
-.\"O The first key/data pair of the database is returned, and the cursor
-.\"O is set or initialized to reference it.
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤ÎºÇ½é¤Î¥¡¼/¥Ç¡¼¥¿ÂФ¬ÊÖ¤µ¤ì¤ë¡£
-¥«¡¼¥½¥ë¤Ï¤½¤ì¤ò»²¾È¤¹¤ë¤è¤¦¤Ë¥»¥Ã¥È¤Þ¤¿¤Ï½é´ü²½¤µ¤ì¤ë¡£
-.TP
-.B R_LAST
-.\"O The last key/data pair of the database is returned, and the cursor
-.\"O is set or initialized to reference it.
-.\"O (Applicable only to the
-.\"O .B DB_BTREE
-.\"O and
-.\"O .B DB_RECNO
-.\"O access methods.)
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤ÎºÇ¸å¤Î¥¡¼/¥Ç¡¼¥¿ÂФ¬ÊÖ¤µ¤ì¤ë¡£¥«¡¼¥½¥ë¤Ï¤½¤ì¤ò»²¾È¤¹¤ë
-¤è¤¦¤Ë¥»¥Ã¥È¤Þ¤¿¤Ï½é´ü²½¤µ¤ì¤ë¡£
-.RB ( DB_BTREE
-¤È
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤À¤±¤Ç»È¤¨¤ë¡£)
-.TP
-.B R_NEXT
-.\"O Retrieve the key/data pair immediately after the cursor.
-.\"O If the cursor is not yet set, this is the same as the
-.\"O .B R_FIRST
-.\"O flag.
-¥«¡¼¥½¥ëľ¸å¤Î¥¡¼/¥Ç¡¼¥¿ÂФò¼èÆÀ¤¹¤ë¡£
-¥«¡¼¥½¥ë¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï
-.B R_FIRST
-¥Õ¥é¥°¤ÈƱ¤¸¡£
-.TP
-.B R_PREV
-.\"O Retrieve the key/data pair immediately before the cursor.
-.\"O If the cursor is not yet set, this is the same as the
-.\"O .B R_LAST
-.\"O flag.
-.\"O (Applicable only to the
-.\"O .B DB_BTREE
-.\"O and
-.\"O .B DB_RECNO
-.\"O access methods.)
-¥«¡¼¥½¥ëľÁ°¤Î¥¡¼/¥Ç¡¼¥¿ÂФò¼èÆÀ¤¹¤ë¡£
-¥«¡¼¥½¥ë¤¬¥»¥Ã¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¤Ï
-.B R_LAST
-¥Õ¥é¥°¤ÈƱ¤¸¡£
-.RB ( DB_BTREE
-¤È
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤À¤±¤Ç»È¤¨¤ë¡£)
+.TP
+\fBR_CURSOR\fP
+指定したキーに関連づけられたデータが返される。 \fIget\fP ルーチンとの違いは、カーソルがキーの位置にセットあるいは 初期化される点である。 (注意:
+\fBDB_BTREE\fP アクセス方法では、返されたキーが 必ずしも指定したキーに正しくマッチしないかもしれない。
+返されたキーは、指定されたキーに等しいかより大きいもののうち 最小のものになる (部分キーマッチか範囲検索が許可されている場合)。)
+.TP
+\fBR_FIRST\fP
+データベースの最初のキー/データ対が返される。 カーソルはそれを参照するようにセットまたは初期化される。
+.TP
+\fBR_LAST\fP
+データベースの最後のキー/データ対が返される。カーソルはそれを参照する ようにセットまたは初期化される。 (\fBDB_BTREE\fP と
+\fBDB_RECNO\fP アクセスメソッドだけで使える。)
+.TP
+\fBR_NEXT\fP
+カーソル直後のキー/データ対を取得する。 カーソルがセットされていない場合は \fBR_FIRST\fP フラグと同じ。
+.TP
+\fBR_PREV\fP
+カーソル直前のキー/データ対を取得する。 カーソルがセットされていない場合は \fBR_LAST\fP フラグと同じ。 (\fBDB_BTREE\fP と
+\fBDB_RECNO\fP アクセスメソッドだけで使える。)
.RE
.IP
-.\"O .B R_LAST
-.\"O and
-.\"O .B R_PREV
-.\"O are available only for the
-.\"O .B DB_BTREE
-.\"O and
-.\"O .B DB_RECNO
-.\"O access methods because they each imply that the keys have an inherent
-.\"O order which does not change.
-.B R_LAST
-¤È
-.B R_PREV
-¤Ï¡¢
-.B DB_BTREE
-¤È
-.B DB_RECNO
-¥¢¥¯¥»¥¹ÊýË¡¤Ç¤·¤«»È¤¨¤Ê¤¤¡£
-¤Ê¤¼¤Ê¤é
-.B R_SETCURSOR
-¤òÍѤ¤¤ë¤Ë¤Ï¡¢Êѹ¹¤µ¤ì¤ë»ö¤Î̵¤¤¸Çͤνç½ø¤ò¥¡¼¤¬»ý¤Ã¤Æ¤¤¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¤«¤é¤Ç¤¢¤ë¡£
+\fBR_LAST\fP と \fBR_PREV\fP は、 \fBDB_BTREE\fP と \fBDB_RECNO\fP アクセス方法でしか使えない。 なぜなら
+\fBR_SETCURSOR\fP を用いるには、変更される事の無い固有の順序をキーが持っていなければならないからである。
.IP
-.I seq
-.\"O routines return \-1 on error (setting
-.\"O .IR errno ),
-.\"O 0 on success and 1 if there are no key/data pairs less than or greater
-.\"O than the specified or current key.
-.\"O If the
-.\"O .B DB_RECNO
-.\"O access method is being used, and if the database file
-.\"O is a character special file and no complete key/data pairs are currently
-.\"O available, the
-.\"O .I seq
-.\"O routines return 2.
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢
-À®¸ù¤Î¾ì¹ç 0 ¤òÊÖ¤¹¡£
-»ØÄꤷ¤¿¥¡¼¤ä¥«¥ì¥ó¥È¥¡¼¤è¤ê¤âÂ礤¤/¾®¤µ¤¤¥¡¼/¥Ç¡¼¥¿ÂФ¬¤Ê¤¤¾ì¹ç¤Ï
-1 ¤òÊÖ¤¹¡£
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤ò»È¤Ã¤Æ¤¤¤Æ¡¢
-¤«¤Ä¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë¤¬Ê¸»ú·¿¤Î¥¹¥Ú¥·¥ã¥ë¥Õ¥¡¥¤¥ë¤Ç¡¢
-´°À®¤·¤Æ¤¤¤ë¥¡¼/¥Ç¡¼¥¿ÂФ¬Ìµ¤¤¾ì¹ç¤Ë¤Ï¡¢
-.I seq
-¥ë¡¼¥Á¥ó¤Ï 2 ¤òÊÖ¤¹¡£
-.TP
-.I sync
-.\"O A pointer to a routine to flush any cached information to disk.
-.\"O If the database is in memory only, the
-.\"O .I sync
-.\"O routine has no effect and will always succeed.
-¥¥ã¥Ã¥·¥å¤µ¤ì¤¿¾ðÊó¤ò¥Ç¥£¥¹¥¯¤ËÁݤ½Ð¤¹¥ë¡¼¥Á¥ó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
-¥Ç¡¼¥¿¥Ù¡¼¥¹¤¬¥á¥â¥ê¤ÎÃæ¤À¤±¤Ë¤¢¤ë¾ì¹ç¡¢
-.I sync
-¥ë¡¼¥Á¥ó¤Ï²¿¤Î¸ú²Ì¤â¤Ê¤¯¾ï¤ËÀ®¸ù¤¹¤ë¡£
+\fIseq\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、 成功の場合 0 を返す。
+指定したキーやカレントキーよりも大きい/小さいキー/データ対がない場合は 1 を返す。 \fBDB_RECNO\fP アクセスメソッドを使っていて、
+かつデータベースファイルが文字型のスペシャルファイルで、 完成しているキー/データ対が無い場合には、 \fIseq\fP ルーチンは 2 を返す。
+.TP
+\fIsync\fP
+キャッシュされた情報をディスクに掃き出すルーチンへのポインタ。 データベースがメモリの中だけにある場合、 \fIsync\fP
+ルーチンは何の効果もなく常に成功する。
.IP
-.\"O The flag value may be set to the following value:
-flag ¤Ë¤Ï°Ê²¼¤ÎÃͤ¬¥»¥Ã¥È¤Ç¤¤ë¡£
+flag には以下の値がセットできる。
.RS
-.TP
-.B R_RECNOSYNC
-.\"O If the
-.\"O .B DB_RECNO
-.\"O access method is being used, this flag causes
-.\"O the sync routine to apply to the btree file which underlies the
-.\"O recno file, not the recno file itself.
-.B DB_RECNO
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤ò»È¤Ã¤Æ¤¤¤ë¾ì¹ç¤Ë
-¤³¤Î¥Õ¥é¥°¤ò¥»¥Ã¥È¤¹¤ë¤È¡¢
-recno ¥Õ¥¡¥¤¥ë¤½¤Î¤â¤Î¤Ë¤Ç¤Ï¤Ê¤¯¡¢
-¤½¤Î¥Ù¡¼¥¹¤Ë¤Ê¤Ã¤Æ¤¤¤ë btree ¥Õ¥¡¥¤¥ë¤Ë sync ¤¬¹Ô¤ï¤ì¤ë¡£
-.\"O (See the
-.\"O .I bfname
-.\"O field of the
-.\"O .BR recno (3)
-.\"O manual page for more information.)
-(¾ÜºÙ¤Ï
-.BR recno (3)
-¥Þ¥Ë¥å¥¢¥ë¥Ú¡¼¥¸¤Ç
-.I bfname
-¥Õ¥£¡¼¥ë¥É¤òÀâÌÀ¤·¤Æ¤¤¤ëÉôʬ¤ò»²¾È¤Î¤³¤È¡£)
+.TP
+\fBR_RECNOSYNC\fP
+\fBDB_RECNO\fP アクセスメソッドを使っている場合に このフラグをセットすると、 recno ファイルそのものにではなく、 そのベースになっている
+btree ファイルに sync が行われる。 (詳細は \fBrecno\fP(3) マニュアルページで \fIbfname\fP
+フィールドを説明している部分を参照のこと。)
.RE
.IP
-.I sync
-.\"O routines return \-1 on error (setting
-.\"O .IR errno )
-.\"O and 0 on success.
-¥ë¡¼¥Á¥ó¤Ï¥¨¥é¡¼¤Î¾ì¹ç \-1 ¤òÊÖ¤·
-.RI ( errno
-¤ò¥»¥Ã¥È¤¹¤ë)¡¢À®¸ù¤¹¤ë¤È 0 ¤òÊÖ¤¹¡£
-.\"O .SS "Key/Data Pairs"
-.SS ¥¡¼/¥Ç¡¼¥¿ÂÐ
-.\"O Access to all file types is based on key/data pairs.
-.\"O Both keys and data are represented by the following data structure:
-Á´¤Æ¤Î¥Õ¥¡¥¤¥ë¥¿¥¤¥×¤Ë¤ª¤¤¤Æ¡¢
-¥¡¼/¥Ç¡¼¥¿ÂФò¥Ù¡¼¥¹¤Ë¤·¤Æ¥¢¥¯¥»¥¹¤¬¹Ô¤ï¤ì¤ë¡£
-¥¡¼¤È¥Ç¡¼¥¿¤Î¤¤¤º¤ì¤â¡¢¼¡¤Î¥Ç¡¼¥¿¹½Â¤¤Çµ½Ò¤µ¤ì¤ë¡£
+\fIsync\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、成功すると 0 を返す。
+.SS キー/データ対
+全てのファイルタイプにおいて、 キー/データ対をベースにしてアクセスが行われる。 キーとデータのいずれも、次のデータ構造で記述される。
.in +4n
.nf
} DBT;
.fi
.in
-.\"O The elements of the
-.\"O .I DBT
-.\"O structure are defined as follows:
-.I DBT
-¹½Â¤ÂΤγÆÍ×ÁǤϼ¡¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë¡£
-.TP
-.I data
-.\"O A pointer to a byte string.
-¥Ð¥¤¥Èʸ»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¡£
-.TP
-.I size
-.\"O The length of the byte string.
-¥Ð¥¤¥Èʸ»úÎó¤ÎŤµ¡£
.PP
-.\"O Key and data byte strings may reference strings of essentially unlimited
-.\"O length although any two of them must fit into available memory at the same
-.\"O time.
-¥¡¼¤È¥Ç¡¼¥¿¤Î¥Ð¥¤¥Èʸ»úÎó¤Ï¡¢
-´ðËÜŪ¤Ë¤Ï̵À©¸Â¤ÎŤµ¤Îʸ»úÎó¤ò»²¾È¤Ç¤¤ë¤¬¡¢
-¤·¤«¤·¤¤¤º¤ì¤â»ÈÍѲÄǽ¤Ê¥á¥â¥ê¤Ë¼ý¤Þ¤Ã¤Æ¤¤¤Ê¤¯¤Æ¤Ï¤Ê¤é¤Ê¤¤¡£
-.\"O It should be noted that the access methods provide no guarantees about
-.\"O byte string alignment.
-¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤Ï¥Ð¥¤¥Èʸ»úÎó¤Î¥¢¥é¥¤¥ó¥á¥ó¥È¤Ë¤Ä¤¤¤Æ¤Ï
-²¿¤âÊݾڤ·¤Æ¤¤¤Ê¤¤»ö¤ËÃí°Õ¤¹¤ë¤³¤È¡£
-.SH ¥¨¥é¡¼
-.\"O The
-.\"O .BR dbopen ()
-.\"O routine may fail and set
-.\"O .I errno
-.\"O for any of the errors specified for the library routines
-.\"O .BR open (2)
-.\"O and
-.\"O .BR malloc (3)
-.\"O or the following:
-.BR dbopen ()
-¥ë¡¼¥Á¥ó¤Ï¼ºÇÔ¤¹¤ë¤È¥é¥¤¥Ö¥é¥ê¥ë¡¼¥Á¥ó
-.BR open (2)
-¤È
-.BR malloc (3)
-¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ë±þ¤¸¤¿
-.I errno
-¤ò¥»¥Ã¥È¤¹¤ë¡£¤¢¤ë¤¤¤Ï°Ê²¼¤ò¥»¥Ã¥È¤¹¤ë¡£
-.TP
-.B [EFTYPE]
-.\"O A file is incorrectly formatted.
-¥Õ¥¡¥¤¥ë¤¬Àµ¤·¤¯¥Õ¥©¡¼¥Þ¥Ã¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¡£
-.TP
-.B [EINVAL]
-.\"O A parameter has been specified (hash function, pad byte etc.) that is
-.\"O incompatible with the current file specification or which is not
-.\"O meaningful for the function (for example, use of the cursor without
-.\"O prior initialization) or there is a mismatch between the version
-.\"O number of file and the software.
-»ØÄꤷ¤¿¥Ñ¥é¥á¡¼¥¿(¥Ï¥Ã¥·¥å´Ø¿ô¡¢¥Ð¥¤¥ÈËä¤á¤Ê¤É)¤¬¸½ºß¤Î¥Õ¥¡¥¤¥ë»ÅÍͤË
-¹ç¤Ã¤Æ¤¤¤Ê¤¤¡¢¥Ñ¥é¥á¡¼¥¿¤¬´Ø¿ô¤Ë¤È¤Ã¤Æ̵°ÕÌ£
-(Î㤨¤Ð¤¢¤é¤«¤¸¤á½é´ü²½¤·¤Ê¤¤¤Ç¥«¡¼¥½¥ë¤ò»È¤¦¤È¤«)¡¢
-¥Õ¥¡¥¤¥ë¤È¥½¥Õ¥È¥¦¥§¥¢¤Î¥Ð¡¼¥¸¥ç¥ó¤¬¹ç¤Ã¤Æ¤¤¤Ê¤¤¡£
+\fIDBT\fP 構造体の各要素は次のように定義されている。
+.TP
+\fIdata\fP
+バイト文字列へのポインタ。
+.TP
+\fIsize\fP
+バイト文字列の長さ。
+.PP
+キーとデータのバイト文字列は、 基本的には無制限の長さの文字列を参照できるが、 しかしいずれも使用可能なメモリに収まっていなくてはならない。
+アクセスメソッドはバイト文字列のアラインメントについては 何も保証していない事に注意すること。
+.SH エラー
+\fBdbopen\fP() ルーチンは失敗するとライブラリルーチン \fBopen\fP(2) と \fBmalloc\fP(3) で指定されているエラーに応じた
+\fIerrno\fP をセットする。あるいは以下をセットする。
+.TP
+\fB[EFTYPE]\fP
+ファイルが正しくフォーマットされていない。
+.TP
+\fBEINVAL\fP
+指定したパラメータ(ハッシュ関数、バイト埋めなど)が現在のファイル仕様に 合っていない、パラメータが関数にとって無意味
+(例えばあらかじめ初期化しないでカーソルを使うとか)、 ファイルとソフトウェアのバージョンが合っていない。
.PP
-.\"O The
-.I close
-.\"O routines may fail and set
-¥ë¡¼¥Á¥ó¤Ï¼ºÇÔ¤¹¤ë¤È¥é¥¤¥Ö¥é¥ê¥ë¡¼¥Á¥ó
-.\"O .I errno
-.\"O for any of the errors specified for the library routines
-.BR close (2),
-.BR read (2),
-.BR write (2),
-.BR free (3),
-.\"O or
-.BR fsync (2)
-¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ë±þ¤¸¤¿
-.I errno
-¤ò¥»¥Ã¥È¤¹¤ë¡£
+\fIclose\fP ルーチンは失敗するとライブラリルーチン \fBclose\fP(2), \fBread\fP(2), \fBwrite\fP(2),
+\fBfree\fP(3), \fBfsync\fP(2) で指定されているエラーに応じた \fIerrno\fP をセットする。
.PP
-.\"O The
-.IR del ,
-.IR get ,
-.I put
-.\"O and
-¤È
-.I seq
-.\"O routines may fail and set
-¥ë¡¼¥Á¥ó¤Ï¼ºÇÔ¤¹¤ë¤È¥é¥¤¥Ö¥é¥ê¥ë¡¼¥Á¥ó
-.\"O .I errno
-.\"O for any of the errors specified for the library routines
-.BR read (2),
-.BR write (2),
-.BR free (3),
-.\"O or
-.BR malloc (3)
-¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ë±þ¤¸¤¿
-.I errno
-¤ò¥»¥Ã¥È¤¹¤ë¡£
+\fIdel\fP, \fIget\fP, \fIput\fP と \fIseq\fP ルーチンは失敗するとライブラリルーチン \fBread\fP(2), \fBwrite\fP(2),
+\fBfree\fP(3), \fBmalloc\fP(3) で指定されているエラーに応じた \fIerrno\fP をセットする。
.PP
-.\"O The
-.\"O .I fd
-.\"O routines will fail and set
-.\"O .I errno
-.\"O to
-.\"O .B ENOENT
-.\"O for in memory databases.
-.I fd
-¥ë¡¼¥Á¥ó¤Ï¥á¥â¥êÆâ¥Ç¡¼¥¿¥Ù¡¼¥¹¤ËÂФ·¼ºÇÔ¤¹¤ë¤È
-.I errno
-¤Ë
-.B ENOENT
-¤ò¥»¥Ã¥È¤¹¤ë¡£
+\fIfd\fP ルーチンはメモリ内データベースに対し失敗すると \fIerrno\fP に \fBENOENT\fP をセットする。
.PP
-.\"O The
-.I sync
-.\"O routines may fail and set
-¥ë¡¼¥Á¥ó¤Ï¼ºÇÔ¤¹¤ë¤È¥é¥¤¥Ö¥é¥ê¥ë¡¼¥Á¥ó
-.\"O .I errno
-.\"O for any of the errors specified for the library routine
-.BR fsync (2)
-¤Ç»ØÄꤵ¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ë±þ¤¸¤¿
-.I errno
-¤ò¥»¥Ã¥È¤¹¤ë¡£
-.SH ¥Ð¥°
-.\"O The typedef
-.\"O .I DBT
-.\"O is a mnemonic for "data base thang", and was used
-.\"O because no-one could think of a reasonable name that wasn't already used.
-typedef
-.I DBT
-¤Ï ``data base thang''¤Îά¸ì¤Ç¤¢¤ë¤¬¡¢¤³¤ì¤¬»È¤ï¤ì¤Æ¤¤¤ë¤Î¤Ï¡¢
-¤Þ¤À»È¤ï¤ì¤Æ¤¤¤Ê¤¤ÂÅÅö¤Ê̾Á°¤¬»×¤¤ÉÕ¤«¤Ê¤«¤Ã¤¿¤¿¤á¤Ç¤¢¤ë¡£
+\fIsync\fP ルーチンは失敗するとライブラリルーチン \fBfsync\fP(2) で指定されているエラーに応じた \fIerrno\fP をセットする。
+.SH バグ
+typedef \fIDBT\fP は \*(lqdata base thang\*(rqの略語であるが、これが使われているのは、
+まだ使われていない妥当な名前が思い付かなかったためである。
.PP
-.\"O The file descriptor interface is a kludge and will be deleted in a
-.\"O future version of the interface.
-¥Õ¥¡¥¤¥ë¥Ç¥¹¥¯¥ê¥×¥¿¤ò»È¤Ã¤¿¤ä¤ê¤È¤ê¤Ï¤Ò¤É¤¤Âåʪ¤Ç¤¢¤ê¡¢
-¾Íè¤Î¥Ð¡¼¥¸¥ç¥ó¤Ç¤Ïºï½ü¤µ¤ì¤ë¤À¤í¤¦¡£
+ファイルデスクリプタを使ったやりとりはひどい代物であり、 将来のバージョンでは削除されるだろう。
.PP
-.\"O None of the access methods provide any form of concurrent access,
-.\"O locking, or transactions.
-¤É¤Î¥¢¥¯¥»¥¹¥á¥½¥Ã¥É¤â¡¢Æ±»þ¥¢¥¯¥»¥¹¡¢¥í¥Ã¥¯¡¢¥È¥é¥ó¥¶¥¯¥·¥ç¥ó
-¤Î»ÅÁȤߤÏÈ÷¤¨¤Æ¤¤¤Ê¤¤¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR btree (3),
-.BR hash (3),
-.BR mpool (3),
-.BR recno (3)
+どのアクセスメソッドも、同時アクセス、ロック、トランザクション の仕組みは備えていない。
+.SH 関連項目
+\fBbtree\fP(3), \fBhash\fP(3), \fBmpool\fP(3), \fBrecno\fP(3)
.sp
-.IR "LIBTP: Portable, Modular Transactions for UNIX" ,
-Margo Seltzer, Michael Olson, USENIX proceedings, Winter 1992.
+\fILIBTP: Portable, Modular Transactions for UNIX\fP, Margo Seltzer, Michael
+Olson, USENIX proceedings, Winter 1992.
OSDN Git Service
