OSDN Git Service

Update README
[linuxjm/LDP_man-pages.git] / release / man3 / mpool.3
index e69bdf6..99fbce1 100644 (file)
@@ -1,6 +1,7 @@
 .\" Copyright (c) 1990, 1993
 .\"    The Regents of the University of California.  All rights reserved.
 .\"
+.\" %%%LICENSE_START(BSD_4_CLAUSE_UCB)
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
 .\" are met:
@@ -28,6 +29,7 @@
 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
+.\" %%%LICENSE_END
 .\"
 .\"    @(#)mpool.3     8.1 (Berkeley) 6/4/93
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
+.\"
+.\" 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>
+.\" Updated 2012-05-01, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
 .TH MPOOL 3 2012\-04\-26 "" "Linux Programmer's Manual"
 .UC 7
 .SH 名前
-mpool \- å\85±æ\9c\89ã\83¡ã\83¢ã\83ªã\83\90ã\83\83ã\83\95ã\82¡プール
+mpool \- å\85±æ\9c\89ã\83¡ã\83¢ã\83ªã\83¼ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼プール
 .SH 書式
 .nf
 \fB#include <db.h>\fP
@@ -68,28 +78,28 @@ mpool \- 共有メモリバッファプール
 インターフェースは提供されていない。おそらく、このページではなく、
 \fIlibdb\fP ライブラリが提供する API をお探しなのだろう。
 
-\fImpool\fP は、ファイルに対するページ指向のバッファ管理を実装した ライブラリインターフェイスである。
+\fImpool\fP は、ファイルに対するページ指向のバッファ管理を実装した ライブラリインターフェイスである。
 .PP
\96¢æ\95° \fBmpool_open\fP()  ã\81¯ã\83¡ã\83¢ã\83ªã\83\97ã\83¼ã\83«ã\82\92å\88\9dæ\9c\9få\8c\96ã\81\99ã\82\8bã\80\82 \fIkey\fP å¼\95æ\95°ã\81¯ã\83\90ã\82¤ã\83\88æ\96\87å­\97å\88\97ã\81§ã\81\82ã\82\8aã\80\81ã\83\90ã\83\83ã\83\95ã\82¡を共有したい複数プロセス間
\81§ã\81®ã\83\8dã\82´ã\82·ã\82¨ã\83¼ã\82·ã\83§ã\83³ã\81«ä½¿ã\82\8fã\82\8cã\82\8bã\80\82 ã\83\95ã\82¡ã\82¤ã\83«ã\83\90ã\83\83ã\83\95ã\82¡ã\81\8cå\85±æ\9c\89ã\83¡ã\83¢ã\83ªã\81«ã\83\9eã\83\83ã\83\97ã\81\95ã\82\8cã\82\8bã\81¨ã\80\81 å\90\8cã\81\98ã\82­ã\83¼ã\82\92使ã\81\86ã\83\97ã\83­ã\82»ã\82¹ã\81¯å\85¨ã\81¦ã\83\90ã\83\83ã\83\95ã\82¡ã\82\92å\85±æ\9c\89ã\81\99ã\82\8bã\80\82 \fIkey\fP ã\81\8c
-NULL だと、バッファはプライベートなメモリに割り付けられる。 \fIfd\fP 引数はもとになるファイルのファイルデスクリプタである。
\81\93ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82¹ã\82¯ã\83ªã\83\97ã\82¿はシーク可能でなくてはならない。 \fIkey\fP が NULL でなく、かつ既にマップされているファイルにマッチした場合、
\96¢æ\95° \fBmpool_open\fP()  ã\81¯ã\83¡ã\83¢ã\83ªã\83¼ã\83\97ã\83¼ã\83«ã\82\92å\88\9dæ\9c\9få\8c\96ã\81\99ã\82\8bã\80\82 \fIkey\fP å¼\95æ\95°ã\81¯ã\83\90ã\82¤ã\83\88æ\96\87å­\97å\88\97ã\81§ã\81\82ã\82\8aã\80\81ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼を共有したい複数プロセス間
\81§ã\81®ã\83\8dã\82´ã\82·ã\82¨ã\83¼ã\82·ã\83§ã\83³ã\81«ä½¿ã\82\8fã\82\8cã\82\8bã\80\82 ã\83\95ã\82¡ã\82¤ã\83«ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81\8cå\85±æ\9c\89ã\83¡ã\83¢ã\83ªã\83¼ã\81«ã\83\9eã\83\83ã\83\97ã\81\95ã\82\8cã\82\8bã\81¨ã\80\81 å\90\8cã\81\98ã\82­ã\83¼ã\82\92使ã\81\86ã\83\97ã\83­ã\82»ã\82¹ã\81¯å\85¨ã\81¦ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82\92å\85±æ\9c\89ã\81\99ã\82\8bã\80\82 \fIkey\fP
+が NULL だと、バッファーはプライベートなメモリーに割り付けられる。 \fIfd\fP 引数はもとになるファイルのファイルディスクリプターである。
\81\93ã\81®ã\83\95ã\82¡ã\82¤ã\83«ã\83\87ã\82£ã\82¹ã\82¯ã\83ªã\83\97ã\82¿ã\83¼はシーク可能でなくてはならない。 \fIkey\fP が NULL でなく、かつ既にマップされているファイルにマッチした場合、
 \fIfd\fP 引数は無視される。
 .PP
 \fIpagesize\fP 引数はバイト単位でのページサイズであり、ファイルはこのサイズに分割される。 \fImaxcache\fP
-引数は基ファイルをキャッシュするときに用いる最大ページ数である。 この値はファイルバッファを共有しているプロセスの数には関係ないが、
+å¼\95æ\95°ã\81¯å\9fºã\83\95ã\82¡ã\82¤ã\83«ã\82\92ã\82­ã\83£ã\83\83ã\82·ã\83¥ã\81\99ã\82\8bã\81¨ã\81\8dã\81«ç\94¨ã\81\84ã\82\8bæ\9c\80大ã\83\9aã\83¼ã\82¸æ\95°ã\81§ã\81\82ã\82\8bã\80\82 ã\81\93ã\81®å\80¤ã\81¯ã\83\95ã\82¡ã\82¤ã\83«ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82\92å\85±æ\9c\89ã\81\97ã\81¦ã\81\84ã\82\8bã\83\97ã\83­ã\82»ã\82¹ã\81®æ\95°ã\81«ã\81¯é\96¢ä¿\82ã\81ªã\81\84ã\81\8cã\80\81
 ファイルを共有するプロセスが指定したうちの最大値が実際に用いられる。
 .PP
 関数 \fBmpool_filter\fP()  は透過的なページ入出力処理を可能にする。 関数 \fIpgin\fP が指定されていると、
-ファイルからメモリプールに読み込まれる度にこの関数が呼び出される。 関数 \fIpgout\fP が指定されていと、
-バッファからファイルに書き出される度にこの関数が呼び出される。 どちらの関数も、 \fIpgcookie\fP
\83\9dã\82¤ã\83³ã\82¿ã\80\81ã\83\9aã\83¼ã\82¸æ\95°ã\80\81読ã\81¿æ\9b¸ã\81\8dã\81\95ã\82\8cã\82\8bã\83\9aã\83¼ã\82¸ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿を引数にとる。
\83\95ã\82¡ã\82¤ã\83«ã\81\8bã\82\89ã\83¡ã\83¢ã\83ªã\83¼ã\83\97ã\83¼ã\83«ã\81«èª­ã\81¿è¾¼ã\81¾ã\82\8cã\82\8b度ã\81«ã\81\93ã\81®é\96¢æ\95°ã\81\8cå\91¼ã\81³å\87ºã\81\95ã\82\8cã\82\8bã\80\82 é\96¢æ\95° \fIpgout\fP ã\81\8cæ\8c\87å®\9aã\81\95ã\82\8cã\81¦ã\81\84ã\81¨ã\80\81
\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81\8bã\82\89ã\83\95ã\82¡ã\82¤ã\83«ã\81«æ\9b¸ã\81\8då\87ºã\81\95ã\82\8cã\82\8b度ã\81«ã\81\93ã\81®é\96¢æ\95°ã\81\8cå\91¼ã\81³å\87ºã\81\95ã\82\8cã\82\8bã\80\82 ã\81©ã\81¡ã\82\89ã\81®é\96¢æ\95°ã\82\82ã\80\81 \fIpgcookie\fP
\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\80\81ã\83\9aã\83¼ã\82¸æ\95°ã\80\81読ã\81¿æ\9b¸ã\81\8dã\81\95ã\82\8cã\82\8bã\83\9aã\83¼ã\82¸ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼を引数にとる。
 .PP
-関数 \fBmpool_new\fP()  は \fIMPOOL\fP ポインタとアドレスを引数にとる。
-新しいページが割り当て可能な場合、ページへのポインタが返され、 ページ数が \fIpgnoaddr\fP アドレスに納められる。 割り当てが不可能な場合は
\96¢æ\95° \fBmpool_new\fP()  ã\81¯ \fIMPOOL\fP ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81¨ã\82¢ã\83\89ã\83¬ã\82¹ã\82\92å¼\95æ\95°ã\81«ã\81¨ã\82\8bã\80\82
\96°ã\81\97ã\81\84ã\83\9aã\83¼ã\82¸ã\81\8cå\89²ã\82\8aå½\93ã\81¦å\8f¯è\83½ã\81ªå ´å\90\88ã\80\81ã\83\9aã\83¼ã\82¸ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81\8cè¿\94ã\81\95ã\82\8cã\80\81 ã\83\9aã\83¼ã\82¸æ\95°ã\81\8c \fIpgnoaddr\fP ã\82¢ã\83\89ã\83¬ã\82¹ã\81«ç´\8dã\82\81ã\82\89ã\82\8cã\82\8bã\80\82 å\89²ã\82\8aå½\93ã\81¦ã\81\8cä¸\8då\8f¯è\83½ã\81ªå ´å\90\88ã\81¯
 NULL が返され、 \fIerrno\fP がセットされる。
 .PP
\96¢æ\95° \fBmpool_get\fP()  ã\81¯ \fIMPOOL\fP ã\83\9dã\82¤ã\83³ã\82¿ã\81¨ã\83\9aã\83¼ã\82¸æ\95°ã\82\92å¼\95æ\95°ã\81«ã\81¨ã\82\8bã\80\82ã\83\9aã\83¼ã\82¸ã\81\8cå­\98å\9c¨ã\81\97ã\81¦ã\81\84ã\82\8bã\81¨ã\80\81 ã\83\9aã\83¼ã\82¸ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿が返される。
\96¢æ\95° \fBmpool_get\fP()  ã\81¯ \fIMPOOL\fP ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81¨ã\83\9aã\83¼ã\82¸æ\95°ã\82\92å¼\95æ\95°ã\81«ã\81¨ã\82\8bã\80\82ã\83\9aã\83¼ã\82¸ã\81\8cå­\98å\9c¨ã\81\97ã\81¦ã\81\84ã\82\8bã\81¨ã\80\81 ã\83\9aã\83¼ã\82¸ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼が返される。
 存在していないと NULL が返され、 \fIerrno\fP がセットされる。 \fIflags\fP 引き数は現在使用されていない。
 .PP
 関数 \fBmpool_put\fP()  は \fIpgaddr\fP が参照するページを解放する。 \fIpgaddr\fP は以前に \fBmpool_get\fP()
@@ -100,10 +110,10 @@ NULL が返され、 \fIerrno\fP がセットされる。
 .PP
 \fBmpool_put\fP()  は成功すると 0 を、エラーがあると \-1 を返す。
 .PP
-関数 \fBmpool_sync\fP()  は \fIMPOOL\fP ポインタの示すページのうち、 変更されたものを全てファイルに書き出す。
\96¢æ\95° \fBmpool_sync\fP()  ã\81¯ \fIMPOOL\fP ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81®ç¤ºã\81\99ã\83\9aã\83¼ã\82¸ã\81®ã\81\86ã\81¡ã\80\81 å¤\89æ\9b´ã\81\95ã\82\8cã\81\9fã\82\82ã\81®ã\82\92å\85¨ã\81¦ã\83\95ã\82¡ã\82¤ã\83«ã\81«æ\9b¸ã\81\8då\87ºã\81\99ã\80\82
 \fBmpool_sync\fP()  は成功すると 0 を、エラーがあると \-1 を返す。
 .PP
\96¢æ\95° \fBmpool_close\fP()  ã\81¯ã\83¡ã\83¢ã\83ªã\83\97ã\83¼ã\83«ã\82¯ã\83\83ã\82­ã\83¼ã\81®ç¤ºã\81\99å\89²ã\82\8aå½\93ã\81¦æ¸\88ã\81¿ã\81®ã\83¡ã\83¢ã\83ªを解放する。
\96¢æ\95° \fBmpool_close\fP()  ã\81¯ã\83¡ã\83¢ã\83ªã\83¼ã\83\97ã\83¼ã\83«ã\82¯ã\83\83ã\82­ã\83¼ã\81®ç¤ºã\81\99å\89²ã\82\8aå½\93ã\81¦æ¸\88ã\81¿ã\81®ã\83¡ã\83¢ã\83ªã\83¼を解放する。
 変更されたページはファイルに\fB書き出されない\fP。 \fImpool_close ()\fP は成功すると 0 を、エラーがあると \-1 を返す。
 .SH エラー
 関数 \fBmpool_open\fP()  は失敗するとライブラリルーチン \fBmalloc\fP(3)  で指定されているエラーに応じた \fIerrno\fP
@@ -127,6 +137,6 @@ POSIX.1\-2001 にはない。 BSD 系に存在する。
 .SH 関連項目
 \fBbtree\fP(3), \fBdbopen\fP(3), \fBhash\fP(3), \fBrecno\fP(3)
 .SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.41 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。