Update README

[linuxjm/LDP_man-pages.git] / release / man3 / dbopen.3

diff --git a/release/man3/dbopen.3 b/release/man3/dbopen.3
index 42babd3..2c30c90 100644 (file)
--- a/release/man3/dbopen.3
+++ b/release/man3/dbopen.3
@@ -102,11 +102,11 @@ hashed フォーマットは、拡張可能な動的 hash スキームである
 \fItype\fP 引き数は \fIDBTYPE\fP 型である (インクルードファイル \fI<db.h>\fP で定義されている)。
 \fBDB_BTREE\fP, \fBDB_HASH\fP, \fBDB_RECNO\fP のいずれかをセットできる。
 .PP
-\fIopeninfo\fP 引き数はアクセスメソッドに固有な構造体へのポインタである。 それぞれの構造体に関しては各アクセスメソッドの
+\fIopeninfo\fP å¼\95ã\81\8dæ\95°ã\81¯ã\82¢ã\82¯ã\82»ã\82¹ã\83¡ã\82½ã\83\83ã\83\89ã\81«å\9bºæ\9c\89ã\81ªæ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81§ã\81\82ã\82\8bã\80\82 ã\81\9dã\82\8cã\81\9eã\82\8cã\81®æ§\8bé\80 ä½\93ã\81«é\96¢ã\81\97ã\81¦ã\81¯å\90\84ã\82¢ã\82¯ã\82»ã\82¹ã\83¡ã\82½ã\83\83ã\83\89ã\81®
 マニュアルページに記述されている。 \fIopeninfo\fP が NULL の場合、それぞれのアクセスメソッドとシステムとに適合した
 デフォルトが用いられる。
 .PP
-\fBdbopen\fP()  は、成功した場合 \fIDB\fP 構造体へのポインタを、エラーの場合 NULL を返す。 \fIDB\fP 構造体は
+\fBdbopen\fP()  ã\81¯ã\80\81æ\88\90å\8a\9fã\81\97ã\81\9få ´å\90\88 \fIDB\fP æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92ã\80\81ã\82¨ã\83©ã\83¼ã\81®å ´å\90\88 NULL ã\82\92è¿\94ã\81\99ã\80\82 \fIDB\fP æ§\8bé\80 ä½\93ã\81¯
 \fI<db.h>\fP インクルードファイルの中で定義されており、 少なくとも以下のようなフィールドを持っている。
 .sp
 .in +4n
@@ -128,19 +128,19 @@ typedef struct {
 .in
 .PP
 各要素には、データベースのタイプと、 様々な動作をする関数のセットが記述されている。 これらの関数は \fBdbopen\fP()
-ã\81«ã\82\88ã\81£ã\81¦è¿\94ã\81\95ã\82\8cã\82\8bæ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\82\92å¼\95ã\81\8dæ\95°ã\81«ã\81¨ã\82\8bã\80\82 ã\82­ã\83¼/ã\83\87ã\83¼ã\82¿æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿やフラグ値を取るものもある。
+ã\81«ã\82\88ã\81£ã\81¦è¿\94ã\81\95ã\82\8cã\82\8bæ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92å¼\95ã\81\8dæ\95°ã\81«ã\81¨ã\82\8bã\80\82 ã\82­ã\83¼/ã\83\87ã\83¼ã\82¿æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼やフラグ値を取るものもある。
 .TP 
 \fItype\fP
 用いられているアクセスメソッド (とファイルフォーマット) の型。
 .TP 
 \fIclose\fP
-キャッシュされた情報をディスクに掃きだすためのルーチンへのポインタ。 割り当てられたリソースを解放し、利用したファイル(群)をクローズする。
-キー/データ対がメモリにキャッシュされている場合、 \fIclose\fP や \fIsync\fP
+ã\82­ã\83£ã\83\83ã\82·ã\83¥ã\81\95ã\82\8cã\81\9fæ\83\85å ±ã\82\92ã\83\87ã\82£ã\82¹ã\82¯ã\81«æ\8e\83ã\81\8dã\81 ã\81\99ã\81\9fã\82\81ã\81®ã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82 å\89²ã\82\8aå½\93ã\81¦ã\82\89ã\82\8cã\81\9fã\83ªã\82½ã\83¼ã\82¹ã\82\92解æ\94¾ã\81\97ã\80\81å\88©ç\94¨ã\81\97ã\81\9fã\83\95ã\82¡ã\82¤ã\83«(群)ã\82\92ã\82¯ã\83­ã\83¼ã\82ºã\81\99ã\82\8bã\80\82
+ã\82­ã\83¼/ã\83\87ã\83¼ã\82¿å¯¾ã\81\8cã\83¡ã\83¢ã\83ªã\83¼ã\81«ã\82­ã\83£ã\83\83ã\82·ã\83¥ã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bå ´å\90\88ã\80\81 \fIclose\fP ã\82\84 \fIsync\fP
 関数での同期に失敗すると、情報に矛盾が生じるか情報を失う可能性がある。 \fIclose\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP
 をセットする)、成功すると 0 を返す。
 .TP 
 \fIdel\fP
-データベースからキー/データ対を削除するルーチンへのポインタ。
+ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8bã\82\89ã\82­ã\83¼/ã\83\87ã\83¼ã\82¿å¯¾ã\82\92å\89\8aé\99¤ã\81\99ã\82\8bã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82
 .IP
 \fIflag\fP 引き数は次の値がセットできる。
 .RS
@@ -153,19 +153,19 @@ typedef struct {
 がファイル中に無い場合 1 を返す。
 .TP 
 \fIfd\fP
-ç\94¨ã\81\84ã\81¦ã\81\84ã\82\8bã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\82\92è¿\94ã\81\99ã\83«ã\83¼ã\83\81ã\83³ ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿。 同じファイル名 \fIfile\fP で \fBdbopen\fP()
-ã\82\92å\91¼ã\81³å\87ºã\81\97ã\81\9få\85¨ã\81¦ã\81®ã\83\97ã\83­ã\82»ã\82¹ã\81«å¯¾ã\81\97ã\81¦ã\80\81 ã\81\9dã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\82\92示ã\81\99å\8d\98ä¸\80ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\81\8cè¿\94ã\81\95ã\82\8cã\82\8bã\80\82 ã\81\93ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿はロック関数
-\fBfcntl\fP(2)  ã\81¨ \fBflock\fP(2)  ã\81¸ã\81®å¼\95ã\81\8dæ\95°ã\81¨ã\81\97ã\81¦å®\89å\85¨ã\81«ä½¿ç\94¨ã\81§ã\81\8dã\82\8bã\80\82 ã\81\93ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿は、必ずしもアクセスメソッドで
-用いられているファイルのいずれかに関連づけられていなくても良い。 メモリ内のデータベースにはファイルデスクリプタは無い。 \fIfd\fP
-ã\83«ã\83¼ã\83\81ã\83³ã\81¯ã\82¨ã\83©ã\83¼ã\81®å ´å\90\88 \-1 ã\82\92è¿\94ã\81\97 (\fIerrno\fP ã\82\92ã\82»ã\83\83ã\83\88ã\81\99ã\82\8b)ã\80\81æ\88\90å\8a\9fã\81\99ã\82\8bã\81¨ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿を返す。
+ç\94¨ã\81\84ã\81¦ã\81\84ã\82\8bã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\82\92è¿\94ã\81\99ã\83«ã\83¼ã\83\81ã\83³ ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼。 同じファイル名 \fIfile\fP で \fBdbopen\fP()
+ã\82\92å\91¼ã\81³å\87ºã\81\97ã\81\9få\85¨ã\81¦ã\81®ã\83\97ã\83­ã\82»ã\82¹ã\81«å¯¾ã\81\97ã\81¦ã\80\81 ã\81\9dã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\82\92示ã\81\99å\8d\98ä¸\80ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼ã\81\8cè¿\94ã\81\95ã\82\8cã\82\8bã\80\82 ã\81\93ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼はロック関数
+\fBfcntl\fP(2)  ã\81¨ \fBflock\fP(2)  ã\81¸ã\81®å¼\95ã\81\8dæ\95°ã\81¨ã\81\97ã\81¦å®\89å\85¨ã\81«ä½¿ç\94¨ã\81§ã\81\8dã\82\8bã\80\82 ã\81\93ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼は、必ずしもアクセスメソッドで
+用いられているファイルのいずれかに関連づけられていなくても良い。 メモリー内のデータベースにはファイルディスクリプターは無い。 \fIfd\fP
+ã\83«ã\83¼ã\83\81ã\83³ã\81¯ã\82¨ã\83©ã\83¼ã\81®å ´å\90\88 \-1 ã\82\92è¿\94ã\81\97 (\fIerrno\fP ã\82\92ã\82»ã\83\83ã\83\88ã\81\99ã\82\8b)ã\80\81æ\88\90å\8a\9fã\81\99ã\82\8bã\81¨ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼を返す。
 .TP 
 \fIget\fP
-データベースからキーを用いてデータを取り出すための ルーチンへのポインタ。 指定した \fIkey\fP に関連づけられたデータのアドレスと長さが
+ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8bã\82\89ã\82­ã\83¼ã\82\92ç\94¨ã\81\84ã\81¦ã\83\87ã\83¼ã\82¿ã\82\92å\8f\96ã\82\8aå\87ºã\81\99ã\81\9fã\82\81ã\81® ã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82 æ\8c\87å®\9aã\81\97ã\81\9f \fIkey\fP ã\81«é\96¢é\80£ã\81¥ã\81\91ã\82\89ã\82\8cã\81\9fã\83\87ã\83¼ã\82¿ã\81®ã\82¢ã\83\89ã\83¬ã\82¹ã\81¨é\95·ã\81\95ã\81\8c
 \fIdata\fP が参照する構造体に返される。 \fIget\fP ルーチンはエラーの場合 \-1 を返し (\fIerrno\fP をセットする)、成功すると 0
 を返す。また \fIkey\fP がファイル中に無い場合 1 を返す。
 .TP 
 \fIput\fP
-キー/データ対をデータベースに納めるルーチンへのポインタ。
+ã\82­ã\83¼/ã\83\87ã\83¼ã\82¿å¯¾ã\82\92ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81«ç´\8dã\82\81ã\82\8bã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82
 .IP
 \fIflag\fP 引き数には次の値のうちのどれか一つがセットできる。
 .RS
@@ -202,7 +202,7 @@ typedef struct {
 \fBR_NOOVERWRITE\fP がセットされていてキーが既に存在する場合 1 を返す。
 .TP 
 \fIseq\fP
-データベースからシーケンシャルにデータを取り出すための ルーチンへのポインタ。 キーのアドレスと長さが \fIkey\fP
+ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8bã\82\89ã\82·ã\83¼ã\82±ã\83³ã\82·ã\83£ã\83«ã\81«ã\83\87ã\83¼ã\82¿ã\82\92å\8f\96ã\82\8aå\87ºã\81\99ã\81\9fã\82\81ã\81® ã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82 ã\82­ã\83¼ã\81®ã\82¢ã\83\89ã\83¬ã\82¹ã\81¨é\95·ã\81\95ã\81\8c \fIkey\fP
 が参照する構造体に返される。データのアドレスと長さが \fIdata\fP が参照する構造体に返される。
 .IP
 シーケンシャルなキー/データ対の取得はいつでも行える。また 「カーソル」の位置は \fIdel\fP, \fIget\fP, \fIput\fP, \fIsync\fP
@@ -240,7 +240,7 @@ typedef struct {
 かつデータベースファイルが文字型のスペシャルファイルで、 完成しているキー/データ対が無い場合には、 \fIseq\fP ルーチンは 2 を返す。
 .TP 
 \fIsync\fP
-ã\82­ã\83£ã\83\83ã\82·ã\83¥ã\81\95ã\82\8cã\81\9fæ\83\85å ±ã\82\92ã\83\87ã\82£ã\82¹ã\82¯ã\81«æ\8e\83ã\81\8då\87ºã\81\99ã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\80\82 ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8cã\83¡ã\83¢ã\83ªの中だけにある場合、 \fIsync\fP
+ã\82­ã\83£ã\83\83ã\82·ã\83¥ã\81\95ã\82\8cã\81\9fæ\83\85å ±ã\82\92ã\83\87ã\82£ã\82¹ã\82¯ã\81«æ\8e\83ã\81\8då\87ºã\81\99ã\83«ã\83¼ã\83\81ã\83³ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82 ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8cã\83¡ã\83¢ã\83ªã\83¼の中だけにある場合、 \fIsync\fP
 ルーチンは何の効果もなく常に成功する。
 .IP
 flag には以下の値がセットできる。
@@ -268,12 +268,12 @@ typedef struct {
 \fIDBT\fP 構造体の各要素は次のように定義されている。
 .TP 
 \fIdata\fP
-バイト文字列へのポインタ。
+ã\83\90ã\82¤ã\83\88æ\96\87å­\97å\88\97ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\82
 .TP 
 \fIsize\fP
 バイト文字列の長さ。
 .PP
-キーとデータのバイト文字列は、 基本的には無制限の長さの文字列を参照できるが、 しかしいずれも使用可能なメモリに収まっていなくてはならない。
+ã\82­ã\83¼ã\81¨ã\83\87ã\83¼ã\82¿ã\81®ã\83\90ã\82¤ã\83\88æ\96\87å­\97å\88\97ã\81¯ã\80\81 å\9fºæ\9c¬ç\9a\84ã\81«ã\81¯ç\84¡å\88¶é\99\90ã\81®é\95·ã\81\95ã\81®æ\96\87å­\97å\88\97ã\82\92å\8f\82ç\85§ã\81§ã\81\8dã\82\8bã\81\8cã\80\81 ã\81\97ã\81\8bã\81\97ã\81\84ã\81\9aã\82\8cã\82\82使ç\94¨å\8f¯è\83½ã\81ªã\83¡ã\83¢ã\83ªã\83¼ã\81«å\8f\8eã\81¾ã\81£ã\81¦ã\81\84ã\81ªã\81\8fã\81¦ã\81¯ã\81ªã\82\89ã\81ªã\81\84ã\80\82
 アクセスメソッドはバイト文字列のアラインメントについては 何も保証していない事に注意すること。
 .SH エラー
 \fBdbopen\fP()  ルーチンは失敗するとライブラリルーチン \fBopen\fP(2)  と \fBmalloc\fP(3)  で指定されているエラーに応じた
@@ -283,8 +283,8 @@ typedef struct {
 ファイルが正しくフォーマットされていない。
 .TP 
 \fBEINVAL\fP
-指定したパラメータ (ハッシュ関数、バイト埋めなど) が現在のファイル仕様
-に合っていない、パラメータが関数にとって無意味 (例えば、あらかじめ初期
+指定したパラメーター (ハッシュ関数、バイト埋めなど) が現在のファイル仕様
+ã\81«å\90\88ã\81£ã\81¦ã\81\84ã\81ªã\81\84ã\80\81ã\83\91ã\83©ã\83¡ã\83¼ã\82¿ã\83¼ã\81\8cé\96¢æ\95°ã\81«ã\81¨ã\81£ã\81¦ç\84¡æ\84\8få\91³ (ä¾\8bã\81\88ã\81°ã\80\81ã\81\82ã\82\89ã\81\8bã\81\98ã\82\81å\88\9dæ\9c\9f
 化しないでカーソルを使うとか)、ファイルとソフトウェアのバージョンが
 合っていない。
 .PP
@@ -294,14 +294,14 @@ typedef struct {
 \fIdel\fP, \fIget\fP, \fIput\fP, \fIseq\fP ルーチンは失敗するとライブラリルーチン \fBread\fP(2), \fBwrite\fP(2),
 \fBfree\fP(3), \fBmalloc\fP(3)  で指定されているエラーに応じた \fIerrno\fP をセットする。
 .PP
-\fIfd\fP ルーチンはメモリ内データベースに対し失敗すると \fIerrno\fP に \fBENOENT\fP をセットする。
+\fIfd\fP ルーチンはメモリー内データベースに対し失敗すると \fIerrno\fP に \fBENOENT\fP をセットする。
 .PP
 \fIsync\fP ルーチンは失敗するとライブラリルーチン \fBfsync\fP(2)  で指定されているエラーに応じた \fIerrno\fP をセットする。
 .SH バグ
 typedef \fIDBT\fP は \*(lqdata base thang\*(rqの略語であるが、これが使われているのは、
 まだ使われていない妥当な名前が思い付かなかったためである。
 .PP
-ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿を使ったやりとりはひどい代物であり、 将来のバージョンでは削除されるだろう。
+ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼を使ったやりとりはひどい代物であり、 将来のバージョンでは削除されるだろう。
 .PP
 どのアクセスメソッドも、同時アクセス、ロック、トランザクション の仕組みは備えていない。
 .SH 関連項目
@@ -310,6 +310,6 @@ typedef \fIDBT\fP は \*(lqdata base thang\*(rqの略語であるが、これが
 \fILIBTP: Portable, Modular Transactions for UNIX\fP, Margo Seltzer, Michael
 Olson, USENIX proceedings, Winter 1992.
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.68 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。