.\"
.\" @(#)mpool.3 8.1 (Berkeley) 6/4/93
.\"
-.\" Japanese Version Copyright (c) 1999 Shouichi Saito
-.\" all rights reserved.
-.\" Translated Mon Jul 26 21:51:36 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 MPOOL 3 1993-06-04 "" "Linux Programmer's Manual"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH MPOOL 3 1993\-06\-04 "" "Linux Programmer's Manual"
.UC 7
.SH 名前
mpool \- 共有メモリバッファプール
.SH 書式
.nf
-.B #include <db.h>
-.B #include <mpool.h>
+\fB#include <db.h>\fP
+\fB#include <mpool.h>\fP
.sp
-.BI "MPOOL *mpool_open(DBT *" key ", int " fd ", pgno_t " pagesize \
-", pgno_t " maxcache );
+\fBMPOOL *mpool_open(DBT *\fP\fIkey\fP\fB, int \fP\fIfd\fP\fB, pgno_t \fP\fIpagesize\fP\fB, pgno_t \fP\fImaxcache\fP\fB);\fP
.sp
-.BI "void mpool_filter(MPOOL *" mp ", void (*pgin)(void *, pgno_t, void *),"
-.BI " void (*" pgout ")(void *, pgno_t, void *),"
-.BI " void *" pgcookie );
+\fBvoid mpool_filter(MPOOL *\fP\fImp\fP\fB, void (*pgin)(void *, pgno_t, void *),\fP
+\fB void (*\fP\fIpgout\fP\fB)(void *, pgno_t, void *),\fP
+\fB void *\fP\fIpgcookie\fP\fB);\fP
.sp
-.BI "void *mpool_new(MPOOL *" mp ", pgno_t *" pgnoaddr );
+\fBvoid *mpool_new(MPOOL *\fP\fImp\fP\fB, pgno_t *\fP\fIpgnoaddr\fP\fB);\fP
.sp
-.BI "void *mpool_get(MPOOL *" mp ", pgno_t " pgno ", unsigned int " flags );
+\fBvoid *mpool_get(MPOOL *\fP\fImp\fP\fB, pgno_t \fP\fIpgno\fP\fB, unsigned int \fP\fIflags\fP\fB);\fP
.sp
-.BI "int mpool_put(MPOOL *" mp ", void *" pgaddr ", unsigned int " flags );
+\fBint mpool_put(MPOOL *\fP\fImp\fP\fB, void *\fP\fIpgaddr\fP\fB, unsigned int \fP\fIflags\fP\fB);\fP
.sp
-.BI "int mpool_sync(MPOOL *" mp );
+\fBint mpool_sync(MPOOL *\fP\fImp\fP\fB);\fP
.sp
-.BI "int mpool_close(MPOOL *" mp );
+\fBint mpool_close(MPOOL *\fP\fImp\fP\fB);\fP
.fi
.SH 説明
-.I mpool
-は、ファイルに対するページ指向のバッファ管理を実装した
-ライブラリインターフェイスである。
+\fImpool\fP は、ファイルに対するページ指向のバッファ管理を実装した ライブラリインターフェイスである。
.PP
-関数
-.BR mpool_open ()
-はメモリプールを初期化する。
-.I key
-引数はバイト文字列であり、バッファを共有したい複数プロセス間
-でのネゴシエーションに使われる。
-ファイルバッファが共有メモリにマップされると、
-同じキーを使うプロセスは全てバッファを共有する。
-.I key
-が NULL だと、バッファはプライベートなメモリに割り付けられる。
-.I fd
-引数はもとになるファイルのファイルデスクリプタである。
-このファイルデスクリプタはシーク可能でなくてはならない。
-.I key
-が NULL でなく、かつ既にマップされているファイルにマッチした場合、
-.I fd
-引数は無視される。
+関数 \fBmpool_open\fP() はメモリプールを初期化する。 \fIkey\fP 引数はバイト文字列であり、バッファを共有したい複数プロセス間
+でのネゴシエーションに使われる。 ファイルバッファが共有メモリにマップされると、 同じキーを使うプロセスは全てバッファを共有する。 \fIkey\fP が
+NULL だと、バッファはプライベートなメモリに割り付けられる。 \fIfd\fP 引数はもとになるファイルのファイルデスクリプタである。
+このファイルデスクリプタはシーク可能でなくてはならない。 \fIkey\fP が NULL でなく、かつ既にマップされているファイルにマッチした場合、
+\fIfd\fP 引数は無視される。
.PP
-.I pagesize
-引数はバイト単位でのページサイズであり、ファイルはこのサイズに分割される。
-.I maxcache
-引数は基ファイルをキャッシュするときに用いる最大ページ数である。
-.\"NAKANO "at any one time" は「どんな瞬間においても (最大)」ですが、
-.\"NAKANO 省略可能でしょう。
-この値はファイルバッファを共有しているプロセスの数には関係ないが、
+\fIpagesize\fP 引数はバイト単位でのページサイズであり、ファイルはこのサイズに分割される。 \fImaxcache\fP
+引数は基ファイルをキャッシュするときに用いる最大ページ数である。 この値はファイルバッファを共有しているプロセスの数には関係ないが、
ファイルを共有するプロセスが指定したうちの最大値が実際に用いられる。
.PP
-関数
-.BR mpool_filter ()
-は透過的なページ入出力処理を可能にする。
-関数
-.I pgin
-が指定されていると、
-ファイルからメモリプールに読み込まれる度にこの関数が呼び出される。
-関数
-.I pgout
-が指定されていと、
-バッファからファイルに書き出される度にこの関数が呼び出される。
-どちらの関数も、
-.I pgcookie
+関数 \fBmpool_filter\fP() は透過的なページ入出力処理を可能にする。 関数 \fIpgin\fP が指定されていると、
+ファイルからメモリプールに読み込まれる度にこの関数が呼び出される。 関数 \fIpgout\fP が指定されていと、
+バッファからファイルに書き出される度にこの関数が呼び出される。 どちらの関数も、 \fIpgcookie\fP
ポインタ、ページ数、読み書きされるページへのポインタを引数にとる。
.PP
-関数
-.BR mpool_new ()
-は
-.I MPOOL
-ポインタとアドレスを引数にとる。
-新しいページが割り当て可能な場合、ページへのポインタが返され、
-ページ数が
-.I pgnoaddr
-アドレスに納められる。
-割り当てが不可能な場合は NULL が返され、
-.I errno
-がセットされる。
+関数 \fBmpool_new\fP() は \fIMPOOL\fP ポインタとアドレスを引数にとる。
+新しいページが割り当て可能な場合、ページへのポインタが返され、 ページ数が \fIpgnoaddr\fP アドレスに納められる。 割り当てが不可能な場合は
+NULL が返され、 \fIerrno\fP がセットされる。
.PP
-関数
-.BR mpool_get ()
-は
-.I MPOOL
-ポインタとページ数を引数にとる。ページが存在していると、
-ページへのポインタが返される。
-存在していないと NULL が返され、
-.I errno
-がセットされる。
-.I flags
-引き数は現在使用されていない。
+関数 \fBmpool_get\fP() は \fIMPOOL\fP ポインタとページ数を引数にとる。ページが存在していると、 ページへのポインタが返される。
+存在していないと NULL が返され、 \fIerrno\fP がセットされる。 \fIflags\fP 引き数は現在使用されていない。
.PP
-関数
-.BR mpool_put ()
-は
-.I pgaddr
-が参照するページを解放する。
-.I pgaddr
-は以前に
-.BR mpool_get ()
-か
-.BR mpool_new ()
-が返したアドレスでなければならない。
-flag の値は以下の値の論理和で指定する。
-.TP
-.B MPOOL_DIRTY
+関数 \fBmpool_put\fP() は \fIpgaddr\fP が参照するページを解放する。 \fIpgaddr\fP は以前に \fBmpool_get\fP()
+か \fBmpool_new\fP() が返したアドレスでなければならない。 flag の値は以下の値の論理和で指定する。
+.TP
+\fBMPOOL_DIRTY\fP
ページは変更されており、ファイルに書き出す必要がある。
.PP
-.BR mpool_put ()
-は成功すると 0 を、エラーがあると \-1 を返す。
+\fBmpool_put\fP() は成功すると 0 を、エラーがあると \-1 を返す。
.PP
-関数
-.BR mpool_sync ()
-は
-.I MPOOL
-ポインタの示すページのうち、
-変更されたものを全てファイルに書き出す。
-.BR mpool_sync ()
-は成功すると 0 を、エラーがあると \-1 を返す。
+関数 \fBmpool_sync\fP() は \fIMPOOL\fP ポインタの示すページのうち、 変更されたものを全てファイルに書き出す。
+\fBmpool_sync\fP() は成功すると 0 を、エラーがあると \-1 を返す。
.PP
-関数
-.BR mpool_close ()
-はメモリプールクッキーの示す割り当て済みのメモリを解放する。
-変更されたページはファイルに\fB書き出されない\fP。
-.I mpool_close ()
-は成功すると 0 を、エラーがあると \-1 を返す。
+関数 \fBmpool_close\fP() はメモリプールクッキーの示す割り当て済みのメモリを解放する。
+変更されたページはファイルに\fB書き出されない\fP。 \fImpool_close ()\fP は成功すると 0 を、エラーがあると \-1 を返す。
.SH エラー
-関数
-.BR mpool_open ()
-は失敗するとライブラリルーチン
-.BR malloc (3)
-で指定されているエラーに応じた
-.I errno
+関数 \fBmpool_open\fP() は失敗するとライブラリルーチン \fBmalloc\fP(3) で指定されているエラーに応じた \fIerrno\fP
をセットする。
.PP
-関数
-.BR mpool_get ()
-は失敗すると次のような
-.I errno
-をセットする。
-.TP 15
-.B EINVAL
+関数 \fBmpool_get\fP() は失敗すると次のような \fIerrno\fP をセットする。
+.TP 15
+\fBEINVAL\fP
要求のあったレコードは存在しない。
.PP
-関数
-.BR mpool_new ()
-と
-.BR mpool_get ()
-は失敗するとライブラリルーチン
-.BR read (2),
-.BR write (2),
-.BR malloc (3)
-で指定されているエラーに応じた
-.I errno
-をセットする。
+関数 \fBmpool_new\fP() と \fBmpool_get\fP() は失敗するとライブラリルーチン \fBread\fP(2),
+\fBwrite\fP(2), \fBmalloc\fP(3) で指定されているエラーに応じた \fIerrno\fP をセットする。
.PP
-関数
-.BR mpool_sync ()
-は失敗するとライブラリルーチン
-.BR write (2)
-で指定されているエラーに応じた
-.I errno
+関数 \fBmpool_sync\fP() は失敗するとライブラリルーチン \fBwrite\fP(2) で指定されているエラーに応じた \fIerrno\fP
をセットする。
.PP
-関数
-.BR mpool_close ()
-は失敗するとライブラリルーチン
-.BR free (3)
-で指定されているエラーに応じた
-.I errno
+関数 \fBmpool_close\fP() は失敗するとライブラリルーチン \fBfree\fP(3) で指定されているエラーに応じた \fIerrno\fP
をセットする。
.SH 準拠
-POSIX.1-2001 にはない。
-BSD 系に存在する。
+POSIX.1\-2001 にはない。 BSD 系に存在する。
.SH 関連項目
-.BR btree (3),
-.BR dbopen (3),
-.BR hash (3),
-.BR recno (3)
+\fBbtree\fP(3), \fBdbopen\fP(3), \fBhash\fP(3), \fBrecno\fP(3)
OSDN Git Service
