1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # This file is distributed under the same license as the PACKAGE package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
8 "Project-Id-Version: PACKAGE VERSION\n"
9 "POT-Creation-Date: 2015-02-04 23:30+0900\n"
10 "PO-Revision-Date: 2015-01-23 22:31+0900\n"
11 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
12 "Language-Team: LANGUAGE <LL@li.org>\n"
15 "Content-Type: text/plain; charset=UTF-8\n"
16 "Content-Transfer-Encoding: 8bit\n"
19 #: build/C/man3/btree.3:36
25 #: build/C/man3/btree.3:36 build/C/man3/hash.3:36 build/C/man3/recno.3:36
31 #: build/C/man3/btree.3:36 build/C/man3/dbopen.3:36 build/C/man3/hash.3:36
32 #: build/C/man3/mpool.3:36 build/C/man3/recno.3:36
34 msgid "Linux Programmer's Manual"
35 msgstr "Linux Programmer's Manual"
38 #: build/C/man3/btree.3:38 build/C/man3/dbopen.3:38 build/C/man3/hash.3:38
39 #: build/C/man3/mpool.3:38 build/C/man3/recno.3:38
45 #: build/C/man3/btree.3:40
46 msgid "btree - btree database access method"
47 msgstr "btree - btree データベースへのアクセスメソッド"
50 #: build/C/man3/btree.3:40 build/C/man3/dbopen.3:40 build/C/man3/hash.3:40
51 #: build/C/man3/mpool.3:40 build/C/man3/recno.3:40
57 #: build/C/man3/btree.3:45 build/C/man3/hash.3:45 build/C/man3/recno.3:45
60 "B<#include E<lt>sys/types.hE<gt>\n"
61 "#include E<lt>db.hE<gt>>\n"
63 "B<#include E<lt>sys/types.hE<gt>\n"
64 "#include E<lt>db.hE<gt>>\n"
67 #: build/C/man3/btree.3:47 build/C/man3/dbopen.3:51 build/C/man3/hash.3:47
68 #: build/C/man3/mpool.3:62 build/C/man3/recno.3:47
74 #: build/C/man3/btree.3:54 build/C/man3/dbopen.3:58 build/C/man3/hash.3:54
75 #: build/C/man3/mpool.3:69 build/C/man3/recno.3:54
77 "I<Note well>: This page documents interfaces provided in glibc up until "
78 "version 2.1. Since version 2.2, glibc no longer provides these interfaces. "
79 "Probably, you are looking for the APIs provided by the I<libdb> library "
83 "このページは、バージョン 2.1 までの glibc が提供するインターフェースに\n"
84 "ついて説明している。バージョン 2.2 以降の glibc では、もはやこれらの\n"
85 "インターフェースは提供されていない。おそらく、このページではなく、\n"
86 "I<libdb> ライブラリが提供する API をお探しなのだろう。"
89 #: build/C/man3/btree.3:62
91 "The routine B<dbopen>(3) is the library interface to database files. One "
92 "of the supported file formats is btree files. The general description of "
93 "the database access methods is in B<dbopen>(3), this manual page describes "
94 "only the btree-specific information."
96 "ルーチン B<dbopen>(3) はデータベースファイルに対するライブラリインターフェー"
97 "スである。 サポートされているファイルフォーマットのひとつに btree ファイルが"
98 "ある。 データベースへのアクセスメソッドに関する一般的な記述は B<dbopen>(3) "
99 "に書かれている。 このマニュアルページでは btree 特有の情報についてのみ記述す"
103 #: build/C/man3/btree.3:65
105 "The btree data structure is a sorted, balanced tree structure storing "
106 "associated key/data pairs."
108 "btree データ構造では、ソートされたバランスツリー構造に 互いに関連づけられた"
112 #: build/C/man3/btree.3:71
114 "The btree access-method-specific data structure provided to B<dbopen>(3) is "
115 "defined in the I<E<lt>db.hE<gt>> include file as follows:"
117 "B<dbopen>(3) に渡される btree アクセスメソッドに特有のデータ構造体は、 "
118 "I<E<lt>db.hE<gt>> インクルードファイルで次のように定義されている。"
121 #: build/C/man3/btree.3:84
125 " unsigned long flags;\n"
126 " unsigned int cachesize;\n"
129 " unsigned int psize;\n"
130 " int (*compare)(const DBT *key1, const DBT *key2);\n"
131 " size_t (*prefix)(const DBT *key1, const DBT *key2);\n"
136 " unsigned long flags;\n"
137 " unsigned int cachesize;\n"
140 " unsigned int psize;\n"
141 " int (*compare)(const DBT *key1, const DBT *key2);\n"
142 " size_t (*prefix)(const DBT *key1, const DBT *key2);\n"
147 #: build/C/man3/btree.3:88 build/C/man3/hash.3:85
148 msgid "The elements of this structure are as follows:"
149 msgstr "この構造体の要素を以下に示す。"
152 #: build/C/man3/btree.3:88 build/C/man3/recno.3:93
158 #: build/C/man3/btree.3:91 build/C/man3/recno.3:97
159 msgid "The flag value is specified by ORing any of the following values:"
160 msgstr "I<flags> の値は以下の値の論理和で指定される。"
163 #: build/C/man3/btree.3:92
169 #: build/C/man3/btree.3:111
171 "Permit duplicate keys in the tree, that is, permit insertion if the key to "
172 "be inserted already exists in the tree. The default behavior, as described "
173 "in B<dbopen>(3), is to overwrite a matching key when inserting a new key or "
174 "to fail if the B<R_NOOVERWRITE> flag is specified. The B<R_DUP> flag is "
175 "overridden by the B<R_NOOVERWRITE> flag, and if the B<R_NOOVERWRITE> flag is "
176 "specified, attempts to insert duplicate keys into the tree will fail."
178 "ツリーの中にキーの重複を許す。すなわちツリーの中に挿入されようとしている キー"
179 "が既に存在していても、その挿入を許可する。デフォルトの動作は B<dbopen>(3) に"
180 "記述されているように、新しいキーが挿入されると一致したキーを上書きする。 ある"
181 "いは B<R_NOOVERWRITE> フラグが指定されていると挿入に失敗する。 B<R_DUP> フラ"
182 "グは B<R_NOOVERWRITE> フラグによって上書きされる。つまり B<R_NOOVERWRITE> フ"
183 "ラグが指定された場合、ツリーに複製キーを挿入しようとすると失敗する。"
186 #: build/C/man3/btree.3:121
188 "If the database contains duplicate keys, the order of retrieval of key/data "
189 "pairs is undefined if the I<get> routine is used, however, I<seq> routine "
190 "calls with the B<R_CURSOR> flag set will always return the logical \"first\" "
191 "of any group of duplicate keys."
193 "データベースにキーの重複があると、 I<get> ルーチンを使った場合のキー/データ対"
194 "の取得順は未定義である。それに対し、 B<R_CURSOR> フラグをセットして I<seq> "
195 "ルーチンを使うと、複製キーのグループの中の 論理的に「最初」のキーを必ず返して"
199 #: build/C/man3/btree.3:122 build/C/man3/hash.3:102 build/C/man3/recno.3:129
202 msgstr "I<cachesize>"
205 #: build/C/man3/btree.3:137
207 "A suggested maximum size (in bytes) of the memory cache. This value is "
208 "I<only> advisory, and the access method will allocate more memory rather "
209 "than fail. Since every search examines the root page of the tree, caching "
210 "the most recently used pages substantially improves access time. In "
211 "addition, physical writes are delayed as long as possible, so a moderate "
212 "cache can reduce the number of I/O operations significantly. Obviously, "
213 "using a cache increases (but only increases) the likelihood of corruption or "
214 "lost data if the system crashes while a tree is being modified. If "
215 "I<cachesize> is 0 (no size is specified), a default cache is used."
217 "想定されるメモリーキャッシュの最大サイズ (バイト単位)。 この値は I<あくまで> "
218 "参考であり、アクセスメソッドはこの値を越えたメモリーの 割り当てに成功すること"
219 "もある。 加えて、物理的な書き込みは可能な限り遅延されるので、 キャッシュの大"
220 "きさを適度にしておけば I/O 操作の回数をかなり減らすこと ができる。 あきらかに"
221 "キャッシュを使うと、ツリーが変更されている途中で システムがクラッシュした場合"
222 "のデータ破壊やデータロストの可能性は 増える (まあでもそれだけのこと)。 "
223 "I<cachesize> が 0 (サイズが指定されていない) の場合、デフォルトのキャッシュが"
227 #: build/C/man3/btree.3:137
229 msgid "I<maxkeypage>"
230 msgstr "I<maxkeypage>"
232 #. The maximum number of keys which will be stored on any single page.
233 #. Because of the way the btree data structure works,
235 #. must always be greater than or equal to 2.
238 #. is 0 (no maximum number of keys is specified), the page fill factor is
239 #. made as large as possible (which is almost invariably what is wanted).
241 #: build/C/man3/btree.3:149
243 "The maximum number of keys which will be stored on any single page. Not "
244 "currently implemented."
245 msgstr "単一ページに納められる最大キー数である。現在実装されていない。"
248 #: build/C/man3/btree.3:149
250 msgid "I<minkeypage>"
251 msgstr "I<minkeypage>"
254 #: build/C/man3/btree.3:159
256 "The minimum number of keys which will be stored on any single page. This "
257 "value is used to determine which keys will be stored on overflow pages, that "
258 "is, if a key or data item is longer than the pagesize divided by the "
259 "minkeypage value, it will be stored on overflow pages instead of in the page "
260 "itself. If I<minkeypage> is 0 (no minimum number of keys is specified), a "
261 "value of 2 is used."
263 "単一ページに納められる最小キー数である。この値は、どのキーを オーバーフロー"
264 "ページ に納めるか決めるのに使われる。すなわちキーまたはデータが minkeypage の"
265 "値で分割されたページサイズより大きい時、そのページに納め る代わりにオーバーフ"
266 "ローページに納めるということである。 I<minkeypage> が 0 (キーの最小値が指定さ"
267 "れていない) の場合、値として 2 が使われる。"
270 #: build/C/man3/btree.3:159 build/C/man3/recno.3:138
276 #: build/C/man3/btree.3:167
278 "Page size is the size (in bytes) of the pages used for nodes in the tree. "
279 "The minimum page size is 512 bytes and the maximum page size is 64K. If "
280 "I<psize> is 0 (no page size is specified), a page size is chosen based on "
281 "the underlying filesystem I/O block size."
283 "ツリーの中のノードに使われるページサイズ (バイト単位)。 最小値は 512 バイト"
284 "で、最大値は 64K である。 I<psize> が 0 (ページサイズが指定されていない) の場"
285 "合、 ファイルシステムの I/O ブロックサイズに基づいて決められる。"
288 #: build/C/man3/btree.3:167
294 #: build/C/man3/btree.3:179
296 "Compare is the key comparison function. It must return an integer less "
297 "than, equal to, or greater than zero if the first key argument is considered "
298 "to be respectively less than, equal to, or greater than the second key "
299 "argument. The same comparison function must be used on a given tree every "
300 "time it is opened. If I<compare> is NULL (no comparison function is "
301 "specified), the keys are compared lexically, with shorter keys considered "
302 "less than longer keys."
304 "I<compare> はキーの比較関数である。 最初のキー引数に対し、二番目のキー引数が"
305 "大きい場合には正の整数を、 同じ場合にはゼロを、小さい場合には負の整数を返"
306 "す。 ツリーを開く際には、常に同じ比較関数が使われなければならない。 "
307 "I<compare> が NULL (比較関数が指定されていない) の場合、 辞書的に比較される。"
308 "短いキーは長いキーより小さいことになる。"
311 #: build/C/man3/btree.3:179
317 #: build/C/man3/btree.3:198
319 "Prefix is the prefix comparison function. If specified, this routine must "
320 "return the number of bytes of the second key argument which are necessary to "
321 "determine that it is greater than the first key argument. If the keys are "
322 "equal, the key length should be returned. Note, the usefulness of this "
323 "routine is very data-dependent, but, in some data sets can produce "
324 "significantly reduced tree sizes and search times. If I<prefix> is NULL (no "
325 "prefix function is specified), I<and> no comparison function is specified, a "
326 "default lexical comparison routine is used. If I<prefix> is NULL and a "
327 "comparison routine is specified, no prefix comparison is done."
329 "I<prefix> は前置比較関数である。 このルーチンは (指定された場合には)、二番目"
330 "のキー引数の バイト数を返さなくてはならない。これは二番目のキー引数が 一番目"
331 "のキー引数より大きいかどうか決めるのに必要である。 キーが同じ場合、キーの長さ"
332 "が返る。このルーチンが有用かどうかは、 データに強く依存する。しかしデータセッ"
333 "トによっては、明らかにツリー のサイズと検索時間を減らしてくれる。 I<prefix> "
334 "が NULL (prefix 関数が指定されていない) で、 I<かつ> 比較関数が指定されていな"
335 "いと、デフォルトの辞書比較ルーチンが使われる。 I<prefix> が NULL で比較関数が"
336 "指定されている場合は、前置比較は行われない。"
339 #: build/C/man3/btree.3:198 build/C/man3/hash.3:117 build/C/man3/recno.3:150
345 #: build/C/man3/btree.3:206 build/C/man3/recno.3:158
347 "The byte order for integers in the stored database metadata. The number "
348 "should represent the order as an integer; for example, big endian order "
349 "would be the number 4,321. If I<lorder> is 0 (no order is specified), the "
350 "current host order is used."
352 "データベースに格納されているメタデータの整数値のバイトオーダー。 この数字は、"
353 "順序を整数で表したものである。 例えばビッグエンディアンなら、この数値は "
354 "4,321 となる。 I<lorder> が 0 (指定されていない) の場合、現在のホスト で使わ"
358 #: build/C/man3/btree.3:217
360 "If the file already exists (and the B<O_TRUNC> flag is not specified), the "
361 "values specified for the arguments I<flags>, I<lorder> and I<psize> are "
362 "ignored in favor of the values used when the tree was created."
364 "ファイルが既に存在している (または B<O_TRUCT> フラグが指定されていない) と、 "
365 "引き数 I<flag>, I<lorder>, I<psize> に指定された値は無視され、 ツリーが作られ"
369 #: build/C/man3/btree.3:219
371 "Forward sequential scans of a tree are from the least key to the greatest."
372 msgstr "ツリーの前方順検索は、最小キーから最大キーに向かって行われる。"
375 #: build/C/man3/btree.3:225
377 "Space freed up by deleting key/data pairs from the tree is never reclaimed, "
378 "although it is normally made available for reuse. This means that the btree "
379 "storage structure is grow-only. The only solutions are to avoid excessive "
380 "deletions, or to create a fresh tree periodically from a scan of an existing "
383 "ツリーからキー/データ対が削除されることによってできたスペースは、 通常再利用"
384 "できる形になっているが再利用されることは無い。 つまり brtee 記憶構造は肥大す"
385 "る一方である。 対策は過度の削除を避けるか、 存在するツリーを調べて定期的に新"
389 #: build/C/man3/btree.3:231
391 "Searches, insertions, and deletions in a btree will all complete in O lg "
392 "base N where base is the average fill factor. Often, inserting ordered data "
393 "into btrees results in a low fill factor. This implementation has been "
394 "modified to make ordered insertion the best case, resulting in a much better "
395 "than normal page fill factor."
397 "Searches, insertions, and deletions in a btree will all complete in O lg "
398 "base N where base is the average fill factor. Often, inserting ordered data "
399 "into btrees results in a low fill factor. This implementation has been "
400 "modified to make ordered insertion the best case, resulting in a much better "
401 "than normal page fill factor."
404 #: build/C/man3/btree.3:231 build/C/man3/dbopen.3:481 build/C/man3/hash.3:151
405 #: build/C/man3/mpool.3:185 build/C/man3/recno.3:210
411 #: build/C/man3/btree.3:238
413 "The I<btree> access method routines may fail and set I<errno> for any of the "
414 "errors specified for the library routine B<dbopen>(3)."
416 "I<btree> アクセスメソッドルーチンは失敗すると、ライブラリルーチン "
417 "B<dbopen>(3) で定義されているエラーのいずれかを I<errno> として返す。"
420 #: build/C/man3/btree.3:238 build/C/man3/dbopen.3:543 build/C/man3/hash.3:158
421 #: build/C/man3/recno.3:222
427 #: build/C/man3/btree.3:240 build/C/man3/recno.3:224
428 msgid "Only big and little endian byte order is supported."
430 "バイトオーダーとしてはビッグエンディアンとリトルエンディアンのみが サポートさ"
434 #: build/C/man3/btree.3:240 build/C/man3/dbopen.3:554 build/C/man3/hash.3:160
435 #: build/C/man3/mpool.3:230 build/C/man3/recno.3:224
441 #: build/C/man3/btree.3:245
442 msgid "B<dbopen>(3), B<hash>(3), B<mpool>(3), B<recno>(3)"
443 msgstr "B<dbopen>(3), B<hash>(3), B<mpool>(3), B<recno>(3)"
446 #: build/C/man3/btree.3:248
448 "I<The Ubiquitous B-tree>, Douglas Comer, ACM Comput. Surv. 11, 2 (June "
451 "I<The Ubiquitous B-tree>, Douglas Comer, ACM Comput. Surv. 11, 2 (June "
455 #: build/C/man3/btree.3:252
457 "I<Prefix B-trees>, Bayer and Unterauer, ACM Transactions on Database "
458 "Systems, Vol. 2, 1 (March 1977), 11-26."
460 "I<Prefix B-trees>, Bayer and Unterauer, ACM Transactions on Database "
461 "Systems, Vol. 2, 1 (March 1977), 11-26."
464 #: build/C/man3/btree.3:255
466 "I<The Art of Computer Programming Vol. 3: Sorting and Searching>, D.E. "
467 "Knuth, 1968, pp 471-480."
469 "I<The Art of Computer Programming Vol. 3: Sorting and Searching>, D.E. "
470 "Knuth, 1968, pp 471-480."
473 #: build/C/man3/btree.3:255 build/C/man3/dbopen.3:562 build/C/man3/hash.3:171
474 #: build/C/man3/mpool.3:235 build/C/man3/recno.3:233
480 #: build/C/man3/btree.3:263 build/C/man3/dbopen.3:570 build/C/man3/hash.3:179
481 #: build/C/man3/mpool.3:243 build/C/man3/recno.3:241
484 #| "This page is part of release 3.78 of the Linux I<man-pages> project. A "
485 #| "description of the project, information about reporting bugs, and the "
486 #| "latest version of this page, can be found at \\%http://www.kernel.org/doc/"
489 "This page is part of release 3.79 of the Linux I<man-pages> project. A "
490 "description of the project, information about reporting bugs, and the latest "
491 "version of this page, can be found at \\%http://www.kernel.org/doc/man-"
494 "この man ページは Linux I<man-pages> プロジェクトのリリース 3.78 の一部\n"
495 "である。プロジェクトの説明とバグ報告に関する情報は\n"
496 "http://www.kernel.org/doc/man-pages/ に書かれている。"
499 #: build/C/man3/dbopen.3:36
505 #: build/C/man3/dbopen.3:36
511 #: build/C/man3/dbopen.3:40
512 msgid "dbopen - database access methods"
513 msgstr "dbopen - データベースアクセスメソッド"
516 #: build/C/man3/dbopen.3:46
519 "B<#include E<lt>sys/types.hE<gt>>\n"
520 "B<#include E<lt>limits.hE<gt>>\n"
521 "B<#include E<lt>db.hE<gt>>\n"
522 "B<#include E<lt>fcntl.hE<gt>>\n"
524 "B<#include E<lt>sys/types.hE<gt>>\n"
525 "B<#include E<lt>limits.hE<gt>>\n"
526 "B<#include E<lt>db.hE<gt>>\n"
527 "B<#include E<lt>fcntl.hE<gt>>\n"
530 #: build/C/man3/dbopen.3:50
533 "B<DB *dbopen(const char *>I<file>B<, int >I<flags>B<, int >I<mode>B<, DBTYPE >I<type>B<,>\n"
534 "B< const void *>I<openinfo>B<);>\n"
536 "B<DB *dbopen(const char *>I<file>B<, int >I<flags>B<, int >I<mode>B<, DBTYPE >I<type>B<,>\n"
537 "B< const void *>I<openinfo>B<);>\n"
540 #: build/C/man3/dbopen.3:72
542 "B<dbopen>() is the library interface to database files. The supported file "
543 "formats are btree, hashed and UNIX file oriented. The btree format is a "
544 "representation of a sorted, balanced tree structure. The hashed format is "
545 "an extensible, dynamic hashing scheme. The flat-file format is a byte "
546 "stream file with fixed or variable length records. The formats and file-"
547 "format-specific information are described in detail in their respective "
548 "manual pages B<btree>(3), B<hash>(3), and B<recno>(3)."
550 "B<dbopen>() はデータベースファイルに対するライブラリインターフェースであ"
551 "る。 サポートされているファイルフォーマットは btree, hash, UNIX ファイルに指"
552 "向したフォーマット, の 3 つである。 btree フォーマットは、ソートされたバラン"
553 "スツリー構造である。 hashed フォーマットは、拡張可能な動的 hash スキームであ"
554 "る。 フラットファイル (flat-file) フォーマットは、 固定長/可変長のレコードか"
555 "らなるバイトストリームファイルである。 それぞれのフォーマットと、ファイル"
556 "フォーマットに特有の情報は それぞれ対応するマニュアルページ B<btree>(3), "
557 "B<hash>(3), B<recno>(3) に詳細に記述されている。"
560 #: build/C/man3/dbopen.3:81
562 "B<dbopen>() opens I<file> for reading and/or writing. Files never intended "
563 "to be preserved on disk may be created by setting the I<file> argument to "
566 "B<dbopen>() は I<file> を読み込み (読み書き) するためにオープンする。 "
567 "I<file> 引き数を NULL にすれば、 ディスク上に保存したくないファイルを作ること"
570 #. Three additional options may be specified by ORing
576 #. Do the necessary locking in the database to support concurrent access.
577 #. If concurrent access isn't needed or the database is read-only this
578 #. flag should not be set, as it tends to have an associated performance
582 #. Place the underlying memory pool used by the database in shared
584 #. Necessary for concurrent access.
587 #. Support transactions in the database.
588 #. The DB_LOCK and DB_SHMEM flags must be set as well.
590 #: build/C/man3/dbopen.3:121
592 "The I<flags> and I<mode> arguments are as specified to the B<open>(2) "
593 "routine, however, only the B<O_CREAT>, B<O_EXCL>, B<O_EXLOCK>, "
594 "B<O_NONBLOCK>, B<O_RDONLY>, B<O_RDWR>, B<O_SHLOCK>, and B<O_TRUNC> flags are "
595 "meaningful. (Note, opening a database file B<O_WRONLY> is not possible.)"
597 "I<flags> と I<mode> 引き数は B<open>(2) ルーチンで指定するのと同様である。た"
598 "だし 意味を持つフラグは B<O_CREAT>, B<O_EXCL>, B<O_EXLOCK>, B<O_NONBLOCK>, "
599 "B<O_RDONLY>, B<O_RDWR>, B<O_SHLOCK>, B<O_TRUNC> だけである。 (注意: "
600 "B<O_WRONLY> でデータベースファイルを開く事は出来ない)"
603 #: build/C/man3/dbopen.3:134
605 "The I<type> argument is of type I<DBTYPE> (as defined in the I<E<lt>db."
606 "hE<gt>> include file) and may be set to B<DB_BTREE>, B<DB_HASH>, or "
609 "I<type> 引き数は I<DBTYPE> 型である (インクルードファイル I<E<lt>db.hE<gt>> "
610 "で定義されている)。 B<DB_BTREE>, B<DB_HASH>, B<DB_RECNO> のいずれかをセットで"
614 #: build/C/man3/dbopen.3:143
616 "The I<openinfo> argument is a pointer to an access-method-specific structure "
617 "described in the access method's manual page. If I<openinfo> is NULL, each "
618 "access method will use defaults appropriate for the system and the access "
621 "I<openinfo> 引き数はアクセスメソッドに固有な構造体へのポインターである。 それ"
622 "ぞれの構造体に関しては各アクセスメソッドの マニュアルページに記述されてい"
623 "る。 I<openinfo> が NULL の場合、それぞれのアクセスメソッドとシステムとに適合"
627 #: build/C/man3/dbopen.3:154
629 "B<dbopen>() returns a pointer to a I<DB> structure on success and NULL on "
630 "error. The I<DB> structure is defined in the I<E<lt>db.hE<gt>> include "
631 "file, and contains at least the following fields:"
633 "B<dbopen>() は、成功した場合 I<DB> 構造体へのポインターを、エラーの場合 "
634 "NULL を返す。 I<DB> 構造体は I<E<lt>db.hE<gt>> インクルードファイルの中で定義"
635 "されており、 少なくとも以下のようなフィールドを持っている。"
638 #: build/C/man3/dbopen.3:170
643 " int (*close)(const DB *db);\n"
644 " int (*del)(const DB *db, const DBT *key, unsigned int flags);\n"
645 " int (*fd)(const DB *db);\n"
646 " int (*get)(const DB *db, DBT *key, DBT *data,\n"
647 " unsigned int flags);\n"
648 " int (*put)(const DB *db, DBT *key, const DBT *data,\n"
649 " unsigned int flags);\n"
650 " int (*sync)(const DB *db, unsigned int flags);\n"
651 " int (*seq)(const DB *db, DBT *key, DBT *data,\n"
652 " unsigned int flags);\n"
657 " int (*close)(const DB *db);\n"
658 " int (*del)(const DB *db, const DBT *key, unsigned int flags);\n"
659 " int (*fd)(const DB *db);\n"
660 " int (*get)(const DB *db, DBT *key, DBT *data,\n"
661 " unsigned int flags);\n"
662 " int (*put)(const DB *db, DBT *key, const DBT *data,\n"
663 " unsigned int flags);\n"
664 " int (*sync)(const DB *db, unsigned int flags);\n"
665 " int (*seq)(const DB *db, DBT *key, DBT *data,\n"
666 " unsigned int flags);\n"
670 #: build/C/man3/dbopen.3:178
672 "These elements describe a database type and a set of functions performing "
673 "various actions. These functions take a pointer to a structure as returned "
674 "by B<dbopen>(), and sometimes one or more pointers to key/data structures "
677 "各要素には、データベースのタイプと、 様々な動作をする関数のセットが記述されて"
678 "いる。 これらの関数は B<dbopen>() によって返される構造体へのポインターを引き"
679 "数にとる。 キー/データ構造体へのポインターやフラグ値を取るものもある。"
682 #: build/C/man3/dbopen.3:178
688 #: build/C/man3/dbopen.3:181
689 msgid "The type of the underlying access method (and file format)."
690 msgstr "用いられているアクセスメソッド (とファイルフォーマット) の型。"
693 #: build/C/man3/dbopen.3:181
699 #: build/C/man3/dbopen.3:195
701 "A pointer to a routine to flush any cached information to disk, free any "
702 "allocated resources, and close the underlying file(s). Since key/data pairs "
703 "may be cached in memory, failing to sync the file with a I<close> or I<sync> "
704 "function may result in inconsistent or lost information. I<close> routines "
705 "return -1 on error (setting I<errno>) and 0 on success."
707 "キャッシュされた情報をディスクに掃きだすためのルーチンへのポインター。 割り当"
708 "てられたリソースを解放し、利用したファイル(群)をクローズする。 キー/データ対"
709 "がメモリーにキャッシュされている場合、 I<close> や I<sync> 関数での同期に失敗"
710 "すると、情報に矛盾が生じるか情報を失う可能性がある。 I<close> ルーチンはエ"
711 "ラーの場合 -1 を返し (I<errno> をセットする)、成功すると 0 を返す。"
714 #: build/C/man3/dbopen.3:195
720 #: build/C/man3/dbopen.3:198
721 msgid "A pointer to a routine to remove key/data pairs from the database."
722 msgstr "データベースからキー/データ対を削除するルーチンへのポインター。"
725 #: build/C/man3/dbopen.3:202
726 msgid "The argument I<flag> may be set to the following value:"
727 msgstr "I<flag> 引き数は次の値がセットできる。"
730 #: build/C/man3/dbopen.3:203 build/C/man3/dbopen.3:259
731 #: build/C/man3/dbopen.3:359
737 #: build/C/man3/dbopen.3:207
739 "Delete the record referenced by the cursor. The cursor must have previously "
742 "カーソル (cursor) が参照しているレコードを削除する。 カーソルは前もって初期化"
746 #: build/C/man3/dbopen.3:215
748 "I<delete> routines return -1 on error (setting I<errno>), 0 on success, and "
749 "1 if the specified I<key> was not in the file."
751 "I<delete> ルーチンはエラーの場合 -1 を返し (I<errno> をセットする)、成功する"
752 "と 0 を返す。また指定の I<key> がファイル中に無い場合 1 を返す。"
755 #: build/C/man3/dbopen.3:215
761 #: build/C/man3/dbopen.3:237
763 "A pointer to a routine which returns a file descriptor representative of the "
764 "underlying database. A file descriptor referencing the same file will be "
765 "returned to all processes which call B<dbopen>() with the same I<file> "
766 "name. This file descriptor may be safely used as an argument to the "
767 "B<fcntl>(2) and B<flock>(2) locking functions. The file descriptor is not "
768 "necessarily associated with any of the underlying files used by the access "
769 "method. No file descriptor is available for in memory databases. I<fd> "
770 "routines return -1 on error (setting I<errno>), and the file descriptor on "
773 "用いているデータベースのファイルディスクリプターを返すルーチン へのポイン"
774 "ター。 同じファイル名 I<file> で B<dbopen>() を呼び出した全てのプロセスに対"
775 "して、 そのファイルを示す単一のファイルディスクリプターが返される。 このファ"
776 "イルディスクリプターはロック関数 B<fcntl>(2) と B<flock>(2) への引き数とし"
777 "て安全に使用できる。 このファイルディスクリプターは、必ずしもアクセスメソッド"
778 "で 用いられているファイルのいずれかに関連づけられていなくても良い。 メモリー"
779 "内のデータベースにはファイルディスクリプターは無い。 I<fd> ルーチンはエラーの"
780 "場合 -1 を返し (I<errno> をセットする)、成功するとファイルディスクリプターを"
784 #: build/C/man3/dbopen.3:237
790 #: build/C/man3/dbopen.3:251
792 "A pointer to a routine which is the interface for keyed retrieval from the "
793 "database. The address and length of the data associated with the specified "
794 "I<key> are returned in the structure referenced by I<data>. I<get> routines "
795 "return -1 on error (setting I<errno>), 0 on success, and 1 if the I<key> was "
798 "データベースからキーを用いてデータを取り出すための ルーチンへのポインター。 "
799 "指定した I<key> に関連づけられたデータのアドレスと長さが I<data> が参照する構"
800 "造体に返される。 I<get> ルーチンはエラーの場合 -1 を返し (I<errno> をセットす"
801 "る)、成功すると 0 を返す。また I<key> がファイル中に無い場合 1 を返す。"
804 #: build/C/man3/dbopen.3:251
810 #: build/C/man3/dbopen.3:254
811 msgid "A pointer to a routine to store key/data pairs in the database."
812 msgstr "キー/データ対をデータベースに納めるルーチンへのポインター。"
815 #: build/C/man3/dbopen.3:258
816 msgid "The argument I<flag> may be set to one of the following values:"
817 msgstr "I<flag> 引き数には次の値のうちのどれか一つがセットできる。"
820 #: build/C/man3/dbopen.3:263
822 "Replace the key/data pair referenced by the cursor. The cursor must have "
823 "previously been initialized."
825 "カーソルが参照しているキー/データ対を置き換える。 カーソルは前もって初期化さ"
829 #: build/C/man3/dbopen.3:263
835 #: build/C/man3/dbopen.3:274
837 "Append the data immediately after the data referenced by I<key>, creating a "
838 "new key/data pair. The record number of the appended key/data pair is "
839 "returned in the I<key> structure. (Applicable only to the B<DB_RECNO> "
842 "I<key> で参照されるデータの直後に、 新しいキー/データ対を作ってデータを追加す"
843 "る。 追加されたキー/データ対のレコード番号は I<key> 構造体に返される。 "
844 "(B<DB_RECNO> アクセス方法でのみ使える。)"
847 #: build/C/man3/dbopen.3:274
850 msgstr "B<R_IBEFORE>"
853 #: build/C/man3/dbopen.3:285
855 "Insert the data immediately before the data referenced by I<key>, creating a "
856 "new key/data pair. The record number of the inserted key/data pair is "
857 "returned in the I<key> structure. (Applicable only to the B<DB_RECNO> "
860 "I<key> で参照されるデータの直前に、 新しいキー/データ対を作ってデータを挿入す"
861 "る。 追加されたキー/データ対のレコード番号は I<key> 構造体に返される。 "
862 "(B<DB_RECNO> アクセスメソッドでのみ使える。)"
865 #: build/C/man3/dbopen.3:285
867 msgid "B<R_NOOVERWRITE>"
868 msgstr "B<R_NOOVERWRITE>"
871 #: build/C/man3/dbopen.3:288
872 msgid "Enter the new key/data pair only if the key does not previously exist."
873 msgstr "キーがあらかじめ存在しない場合に限り、新しいキー/データ対をいれる。"
876 #: build/C/man3/dbopen.3:288
878 msgid "B<R_SETCURSOR>"
879 msgstr "B<R_SETCURSOR>"
882 #: build/C/man3/dbopen.3:297
884 "Store the key/data pair, setting or initializing the position of the cursor "
885 "to reference it. (Applicable only to the B<DB_BTREE> and B<DB_RECNO> access "
888 "キー/データ対を納め、それを指すようにカーソル位置をセットあるいは初期 化す"
889 "る。 (B<DB_BTREE> と B<DB_RECNO> アクセスメソッドでのみ使える。)"
892 #: build/C/man3/dbopen.3:307
894 "B<R_SETCURSOR> is available only for the B<DB_BTREE> and B<DB_RECNO> access "
895 "methods because it implies that the keys have an inherent order which does "
898 "B<R_SETCURSOR> は B<DB_BTREE> と B<DB_RECNO> アクセスメソッドでしか利用できな"
899 "い。 なぜなら B<R_SETCURSOR> を用いるには、変更される事の無い固有の順序を"
900 "キー が持っていなければならないからである。"
903 #: build/C/man3/dbopen.3:317
905 "B<R_IAFTER> and B<R_IBEFORE> are available only for the B<DB_RECNO> access "
906 "method because they each imply that the access method is able to create new "
907 "keys. This is true only if the keys are ordered and independent, record "
908 "numbers for example."
910 "B<R_IAFTER> と B<R_IBEFORE> は B<DB_RECNO> アクセスメソッドでしか利用できな"
911 "い。 これらを実現するには、アクセスメソッドが 新しいキーを作れなければならな"
912 "いからである。 これが成立するのは、例えば、順序づけらた独立なレコード番号が "
913 "キーになっているような場合だけである。"
916 #: build/C/man3/dbopen.3:322
918 "The default behavior of the I<put> routines is to enter the new key/data "
919 "pair, replacing any previously existing key."
921 "I<put> ルーチンのデフォルトの動作は、新しいキー/データ対を 既に存在するキーを"
925 #: build/C/man3/dbopen.3:330
927 "I<put> routines return -1 on error (setting I<errno>), 0 on success, and 1 "
928 "if the B<R_NOOVERWRITE> I<flag> was set and the key already exists in the "
931 "I<put> ルーチンはエラーの場合 -1 を返し (I<errno> をセットする)、成功すると "
932 "0 を返す。また I<flag> に B<R_NOOVERWRITE> がセットされていてキーが既に存在す"
936 #: build/C/man3/dbopen.3:330
942 #: build/C/man3/dbopen.3:341
944 "A pointer to a routine which is the interface for sequential retrieval from "
945 "the database. The address and length of the key are returned in the "
946 "structure referenced by I<key>, and the address and length of the data are "
947 "returned in the structure referenced by I<data>."
949 "データベースからシーケンシャルにデータを取り出すための ルーチンへのポイン"
950 "ター。 キーのアドレスと長さが I<key> が参照する構造体に返される。データのアド"
951 "レスと長さが I<data> が参照する構造体に返される。"
954 #: build/C/man3/dbopen.3:354
956 "Sequential key/data pair retrieval may begin at any time, and the position "
957 "of the \"cursor\" is not affected by calls to the I<del>, I<get>, I<put>, or "
958 "I<sync> routines. Modifications to the database during a sequential scan "
959 "will be reflected in the scan, that is, records inserted behind the cursor "
960 "will not be returned while records inserted in front of the cursor will be "
963 "シーケンシャルなキー/データ対の取得はいつでも行える。また 「カーソル」の位置"
964 "は I<del>, I<get>, I<put>, I<sync> ルーチンの呼び出しには影響されない。 シー"
965 "ケンシャルなスキャンの途中に行われたデータベースへの変更は スキャンに反映され"
966 "る。すなわち、カーソルの後ろに挿入されたレコードは 返されないが、カーソルの前"
970 #: build/C/man3/dbopen.3:358
971 msgid "The flag value B<must> be set to one of the following values:"
973 "フラグ値にはB<必ず>以下に示すうちの どれか一つをセットしなければならない。"
976 #: build/C/man3/dbopen.3:372
978 "The data associated with the specified key is returned. This differs from "
979 "the I<get> routines in that it sets or initializes the cursor to the "
980 "location of the key as well. (Note, for the B<DB_BTREE> access method, the "
981 "returned key is not necessarily an exact match for the specified key. The "
982 "returned key is the smallest key greater than or equal to the specified key, "
983 "permitting partial key matches and range searches.)"
985 "指定したキーに関連づけられたデータが返される。 I<get> ルーチンとの違いは、"
986 "カーソルがキーの位置にセットあるいは 初期化される点である。 (注意: "
987 "B<DB_BTREE> アクセス方法では、返されたキーが 必ずしも指定したキーに正しくマッ"
988 "チしないかもしれない。 返されたキーは、指定されたキーに等しいかより大きいもの"
989 "のうち 最小のものになる (部分キーマッチか範囲検索が許可されている場合)。)"
992 #: build/C/man3/dbopen.3:372
998 #: build/C/man3/dbopen.3:376
1000 "The first key/data pair of the database is returned, and the cursor is set "
1001 "or initialized to reference it."
1003 "データベースの最初のキー/データ対が返される。 カーソルはそれを参照するように"
1007 #: build/C/man3/dbopen.3:376
1013 #: build/C/man3/dbopen.3:385
1015 "The last key/data pair of the database is returned, and the cursor is set or "
1016 "initialized to reference it. (Applicable only to the B<DB_BTREE> and "
1017 "B<DB_RECNO> access methods.)"
1019 "データベースの最後のキー/データ対が返される。カーソルはそれを参照する ように"
1020 "セットまたは初期化される。 (B<DB_BTREE> と B<DB_RECNO> アクセスメソッドだけで"
1024 #: build/C/man3/dbopen.3:385
1030 #: build/C/man3/dbopen.3:391
1032 "Retrieve the key/data pair immediately after the cursor. If the cursor is "
1033 "not yet set, this is the same as the B<R_FIRST> flag."
1035 "カーソル直後のキー/データ対を取得する。 カーソルがセットされていない場合は "
1036 "B<R_FIRST> フラグと同じ。"
1039 #: build/C/man3/dbopen.3:391
1045 #: build/C/man3/dbopen.3:402
1047 "Retrieve the key/data pair immediately before the cursor. If the cursor is "
1048 "not yet set, this is the same as the B<R_LAST> flag. (Applicable only to "
1049 "the B<DB_BTREE> and B<DB_RECNO> access methods.)"
1051 "カーソル直前のキー/データ対を取得する。 カーソルがセットされていない場合は "
1052 "B<R_LAST> フラグと同じ。 (B<DB_BTREE> と B<DB_RECNO> アクセスメソッドだけで使"
1056 #: build/C/man3/dbopen.3:413
1058 "B<R_LAST> and B<R_PREV> are available only for the B<DB_BTREE> and "
1059 "B<DB_RECNO> access methods because they each imply that the keys have an "
1060 "inherent order which does not change."
1062 "B<R_LAST> と B<R_PREV> は、 B<DB_BTREE> と B<DB_RECNO> アクセス方法でしか使え"
1063 "ない。 なぜなら B<R_SETCURSOR> を用いるには、変更される事の無い固有の順序を"
1064 "キーが持っていなければならないからである。"
1067 #: build/C/man3/dbopen.3:426
1069 "I<seq> routines return -1 on error (setting I<errno>), 0 on success and 1 if "
1070 "there are no key/data pairs less than or greater than the specified or "
1071 "current key. If the B<DB_RECNO> access method is being used, and if the "
1072 "database file is a character special file and no complete key/data pairs are "
1073 "currently available, the I<seq> routines return 2."
1075 "I<seq> ルーチンはエラーの場合 -1 を返し (I<errno> をセットする)、 成功の場合 "
1076 "0 を返す。 指定したキーやカレントキーよりも大きい/小さいキー/データ対がない場"
1077 "合は 1 を返す。 B<DB_RECNO> アクセスメソッドを使っていて、 かつデータベース"
1078 "ファイルが文字型のスペシャルファイルで、 完成しているキー/データ対が無い場合"
1079 "には、 I<seq> ルーチンは 2 を返す。"
1082 #: build/C/man3/dbopen.3:426
1088 #: build/C/man3/dbopen.3:432
1090 "A pointer to a routine to flush any cached information to disk. If the "
1091 "database is in memory only, the I<sync> routine has no effect and will "
1094 "キャッシュされた情報をディスクに掃き出すルーチンへのポインター。 データベース"
1095 "がメモリーの中だけにある場合、 I<sync> ルーチンは何の効果もなく常に成功する。"
1098 #: build/C/man3/dbopen.3:434
1099 msgid "The flag value may be set to the following value:"
1100 msgstr "flag には以下の値がセットできる。"
1103 #: build/C/man3/dbopen.3:435
1105 msgid "B<R_RECNOSYNC>"
1106 msgstr "B<R_RECNOSYNC>"
1109 #: build/C/man3/dbopen.3:447
1111 "If the B<DB_RECNO> access method is being used, this flag causes the sync "
1112 "routine to apply to the btree file which underlies the recno file, not the "
1113 "recno file itself. (See the I<bfname> field of the B<recno>(3) manual page "
1114 "for more information.)"
1116 "B<DB_RECNO> アクセスメソッドを使っている場合に このフラグをセットすると、 "
1117 "recno ファイルそのものにではなく、 そのベースになっている btree ファイルに "
1118 "sync が行われる。 (詳細は B<recno>(3) マニュアルページで I<bfname> フィール"
1119 "ドを説明している部分を参照のこと。)"
1122 #: build/C/man3/dbopen.3:453
1124 "I<sync> routines return -1 on error (setting I<errno>) and 0 on success."
1126 "I<sync> ルーチンはエラーの場合 -1 を返し (I<errno> をセットする)、成功すると "
1130 #: build/C/man3/dbopen.3:453
1132 msgid "Key/data pairs"
1136 #: build/C/man3/dbopen.3:456
1138 "Access to all file types is based on key/data pairs. Both keys and data are "
1139 "represented by the following data structure:"
1141 "全てのファイルタイプにおいて、 キー/データ対をベースにしてアクセスが行われ"
1142 "る。 キーとデータのいずれも、次のデータ構造で記述される。"
1145 #: build/C/man3/dbopen.3:463
1148 "typedef struct {\n"
1153 "typedef struct {\n"
1159 #: build/C/man3/dbopen.3:469
1160 msgid "The elements of the I<DBT> structure are defined as follows:"
1161 msgstr "I<DBT> 構造体の各要素は次のように定義されている。"
1164 #: build/C/man3/dbopen.3:469
1170 #: build/C/man3/dbopen.3:472
1171 msgid "A pointer to a byte string."
1172 msgstr "バイト文字列へのポインター。"
1175 #: build/C/man3/dbopen.3:472
1181 #: build/C/man3/dbopen.3:475
1182 msgid "The length of the byte string."
1186 #: build/C/man3/dbopen.3:481
1188 "Key and data byte strings may reference strings of essentially unlimited "
1189 "length although any two of them must fit into available memory at the same "
1190 "time. It should be noted that the access methods provide no guarantees "
1191 "about byte string alignment."
1193 "キーとデータのバイト文字列は、 基本的には無制限の長さの文字列を参照できる"
1194 "が、 しかしいずれも使用可能なメモリーに収まっていなくてはならない。 アクセス"
1195 "メソッドはバイト文字列のアラインメントについては 何も保証していない事に注意す"
1199 #: build/C/man3/dbopen.3:491
1201 "The B<dbopen>() routine may fail and set I<errno> for any of the errors "
1202 "specified for the library routines B<open>(2) and B<malloc>(3) or the "
1205 "B<dbopen>() ルーチンは失敗するとライブラリルーチン B<open>(2) と "
1206 "B<malloc>(3) で指定されているエラーに応じた I<errno> をセットする。あるいは"
1210 #: build/C/man3/dbopen.3:491
1213 msgstr "B<[EFTYPE]>"
1216 #: build/C/man3/dbopen.3:494
1217 msgid "A file is incorrectly formatted."
1218 msgstr "ファイルが正しくフォーマットされていない。"
1221 #: build/C/man3/dbopen.3:494 build/C/man3/mpool.3:198 build/C/man3/recno.3:218
1227 #: build/C/man3/dbopen.3:501
1229 "A parameter has been specified (hash function, pad byte, etc.) that is "
1230 "incompatible with the current file specification or which is not meaningful "
1231 "for the function (for example, use of the cursor without prior "
1232 "initialization) or there is a mismatch between the version number of file "
1235 "指定したパラメーター (ハッシュ関数、バイト埋めなど) が現在のファイル仕様\n"
1236 "に合っていない、パラメーターが関数にとって無意味 (例えば、あらかじめ初期\n"
1237 "化しないでカーソルを使うとか)、ファイルとソフトウェアのバージョンが\n"
1241 #: build/C/man3/dbopen.3:513
1243 "The I<close> routines may fail and set I<errno> for any of the errors "
1244 "specified for the library routines B<close>(2), B<read>(2), B<write>(2), "
1245 "B<free>(3), or B<fsync>(2)."
1247 "I<close> ルーチンは失敗するとライブラリルーチン B<close>(2), B<read>(2), "
1248 "B<write>(2), B<free>(3), B<fsync>(2) で指定されているエラーに応じた "
1252 #: build/C/man3/dbopen.3:528
1254 "The I<del>, I<get>, I<put>, and I<seq> routines may fail and set I<errno> "
1255 "for any of the errors specified for the library routines B<read>(2), "
1256 "B<write>(2), B<free>(3) or B<malloc>(3)."
1258 "I<del>, I<get>, I<put>, I<seq> ルーチンは失敗するとライブラリルーチン "
1259 "B<read>(2), B<write>(2), B<free>(3), B<malloc>(3) で指定されているエラーに応"
1260 "じた I<errno> をセットする。"
1263 #: build/C/man3/dbopen.3:536
1265 "The I<fd> routines will fail and set I<errno> to B<ENOENT> for in memory "
1268 "I<fd> ルーチンはメモリー内データベースに対し失敗すると I<errno> に B<ENOENT> "
1272 #: build/C/man3/dbopen.3:543
1274 "The I<sync> routines may fail and set I<errno> for any of the errors "
1275 "specified for the library routine B<fsync>(2)."
1277 "I<sync> ルーチンは失敗するとライブラリルーチン B<fsync>(2) で指定されている"
1278 "エラーに応じた I<errno> をセットする。"
1281 #: build/C/man3/dbopen.3:548
1283 "The typedef I<DBT> is a mnemonic for \"data base thang\", and was used "
1284 "because no-one could think of a reasonable name that wasn't already used."
1286 "typedef I<DBT> は ``data base thang''の略語であるが、これが使われているの"
1287 "は、 まだ使われていない妥当な名前が思い付かなかったためである。"
1290 #: build/C/man3/dbopen.3:551
1292 "The file descriptor interface is a kludge and will be deleted in a future "
1293 "version of the interface."
1295 "ファイルディスクリプターを使ったやりとりはひどい代物であり、 将来のバージョン"
1299 #: build/C/man3/dbopen.3:554
1301 "None of the access methods provide any form of concurrent access, locking, "
1304 "どのアクセスメソッドも、同時アクセス、ロック、トランザクション の仕組みは備え"
1308 #: build/C/man3/dbopen.3:559
1309 msgid "B<btree>(3), B<hash>(3), B<mpool>(3), B<recno>(3)"
1310 msgstr "B<btree>(3), B<hash>(3), B<mpool>(3), B<recno>(3)"
1313 #: build/C/man3/dbopen.3:562
1315 "I<LIBTP: Portable, Modular Transactions for UNIX>, Margo Seltzer, Michael "
1316 "Olson, USENIX proceedings, Winter 1992."
1318 "I<LIBTP: Portable, Modular Transactions for UNIX>, Margo Seltzer, Michael "
1319 "Olson, USENIX proceedings, Winter 1992."
1322 #: build/C/man3/hash.3:36
1328 #: build/C/man3/hash.3:40
1329 msgid "hash - hash database access method"
1330 msgstr "hash - hash データベースへのアクセスメソッド"
1333 #: build/C/man3/hash.3:62
1335 "The routine B<dbopen>(3) is the library interface to database files. One "
1336 "of the supported file formats is hash files. The general description of the "
1337 "database access methods is in B<dbopen>(3), this manual page describes only "
1338 "the hash-specific information."
1340 "ルーチン B<dbopen>(3) はデータベースファイルに対するライブラリインターフェー"
1341 "スである。 サポートされているファイルフォーマットのひとつに hash ファイルがあ"
1342 "る。 データベースへのアクセスメソッドに関する一般的な記述は B<dbopen>(3) に"
1343 "書かれている。 このマニュアルページでは hash 特有の情報についてのみ記述する。"
1346 #: build/C/man3/hash.3:64
1347 msgid "The hash data structure is an extensible, dynamic hashing scheme."
1348 msgstr "hash データ構造は、拡張可能な動的ハッシュスキームである。"
1351 #: build/C/man3/hash.3:70
1353 "The access-method-specific data structure provided to B<dbopen>(3) is "
1354 "defined in the I<E<lt>db.hE<gt>> include file as follows:"
1356 "B<dbopen>(3) に渡される hash アクセスメソッドに特有のデータ構造体は、 "
1357 "I<E<lt>db.hE<gt>> インクルードファイルで以下のように定義されている。"
1360 #: build/C/man3/hash.3:81
1363 "typedef struct {\n"
1364 " unsigned int bsize;\n"
1365 " unsigned int ffactor;\n"
1366 " unsigned int nelem;\n"
1367 " unsigned int cachesize;\n"
1368 " uint32_t (*hash)(const void *, size_t);\n"
1372 "typedef struct {\n"
1373 " unsigned int bsize;\n"
1374 " unsigned int ffactor;\n"
1375 " unsigned int nelem;\n"
1376 " unsigned int cachesize;\n"
1377 " uint32_t (*hash)(const void *, size_t);\n"
1382 #: build/C/man3/hash.3:85
1388 #: build/C/man3/hash.3:90
1390 "defines the hash table bucket size, and is, by default, 256 bytes. It may "
1391 "be preferable to increase the page size for disk-resident tables and tables "
1392 "with large data items."
1394 "hash テーブルバケット (table bucket) のサイズを定義する。 デフォルトは 256 バ"
1395 "イトである。 ディスクに置かれるテーブルやデータアイテムが大きいテーブルでは "
1396 "ページサイズを大きくするほうが良いだろう。"
1399 #: build/C/man3/hash.3:90
1405 #: build/C/man3/hash.3:96
1407 "indicates a desired density within the hash table. It is an approximation "
1408 "of the number of keys allowed to accumulate in any one bucket, determining "
1409 "when the hash table grows or shrinks. The default value is 8."
1411 "ユーザーが望む hash テーブル中の密度である。 これはそれぞれのバケットに格納で"
1412 "きるキーの概数であり、 hash テーブルを拡大・縮小を作用する。 デフォルトは 8 "
1416 #: build/C/man3/hash.3:96
1422 #: build/C/man3/hash.3:102
1424 "is an estimate of the final size of the hash table. If not set or set too "
1425 "low, hash tables will expand gracefully as keys are entered, although a "
1426 "slight performance degradation may be noticed. The default value is 1."
1428 "hash テーブルの最終サイズを大まかに見積もった値である。 この値がセットされて"
1429 "いなかったり、あまりに低くセットされていると、 hash テーブルはキーが入ってく"
1430 "るに応じて拡張される。 しかし少しパフォーマンスが (おそらく気付く程度に) 落ち"
1434 #: build/C/man3/hash.3:108
1436 "is the suggested maximum size, in bytes, of the memory cache. This value is "
1437 "I<only advisory>, and the access method will allocate more memory rather "
1440 "メモリーキャッシュの最大値 (バイト単位) の参考値。 この値は B<あくまで参考で"
1441 "あり>、 アクセスメソッドはこの値を越えたメモリーの割り当てに成功することもあ"
1445 #: build/C/man3/hash.3:108
1451 #: build/C/man3/hash.3:117
1453 "is a user-defined hash function. Since no hash function performs equally "
1454 "well on all possible data, the user may find that the built-in hash function "
1455 "does poorly on a particular data set. A user-specified hash functions must "
1456 "take two arguments (a pointer to a byte string and a length) and return a 32-"
1457 "bit quantity to be used as the hash value."
1459 "はユーザー定義の hash 関数である。 全てのデータに対してうまく作用する hash 関"
1460 "数と言うのはないから、 特定のデータセットに対しては組み込みの hash 関数では "
1461 "パフォーマンスが低いこともあるかもしれない。 ユーザー定義の hash 関数は二つの"
1462 "引数をとらなくてはならない (バイト文字 列へのポインターと、長さ)。 そして "
1463 "hash 値として使われる 32ビットの値を返さなくてはならない。"
1466 #: build/C/man3/hash.3:127
1468 "is the byte order for integers in the stored database metadata. The number "
1469 "should represent the order as an integer; for example, big endian order "
1470 "would be the number 4,321. If I<lorder> is 0 (no order is specified), the "
1471 "current host order is used. If the file already exists, the specified value "
1472 "is ignored and the value specified when the tree was created is used."
1474 "データベースに格納されているメタデータの整数値のバイトオーダー。 この数字は、"
1475 "順序を整数で表したものである。 例えばビッグエンディアンなら、この数値は "
1476 "4,321 となる。 I<lorder> が 0 (指定されていない)場合、現在のホスト で使われて"
1477 "いる並び順が使われる。 ファイルが既に存在する場合、指定した値は無視されツリー"
1478 "が作られ た時に指定されていた値が使われる。"
1481 #: build/C/man3/hash.3:139
1483 "If the file already exists (and the B<O_TRUNC> flag is not specified), the "
1484 "values specified for I<bsize>, I<ffactor>, I<lorder>, and I<nelem> are "
1485 "ignored and the values specified when the tree was created are used."
1487 "ファイルが既に存在している (または B<O_TRUNC> フラグが指定されていない) と、 "
1488 "I<bsize>, I<ffactor>, I<lorder>, I<nelem> に指定された値は無視され、 ハッシュ"
1492 #: build/C/man3/hash.3:144
1494 "If a hash function is specified, I<hash_open> will attempt to determine if "
1495 "the hash function specified is the same as the one with which the database "
1496 "was created, and will fail if it is not."
1498 "hash 関数が指定されると、 I<hash_open> はデータベースが作られた時に指定されて"
1499 "いた hash 関数と今回指定された hash 関数が同じかどうかを調べ、 同じでない場合"
1503 #: build/C/man3/hash.3:151
1505 "Backward-compatible interfaces to the routines described in B<dbm>(3), and "
1506 "B<ndbm>(3) are provided, however these interfaces are not compatible with "
1507 "previous file formats."
1509 "B<dbm>(3), と B<ndbm>(3) に記述されているルーチンへの過去互換を取るためのイ"
1510 "ンターフェイスが 存在する。しかしこれらのインターフェイスは以前のファイル"
1514 #: build/C/man3/hash.3:158
1516 "The I<hash> access method routines may fail and set I<errno> for any of the "
1517 "errors specified for the library routine B<dbopen>(3)."
1519 "I<hash> アクセスメソッドルーチンは、失敗するとライブラリルーチン "
1520 "B<dbopen>(3) で指定されているエラーに応じた I<errno> をセットする。"
1523 #: build/C/man3/hash.3:160
1524 msgid "Only big and little endian byte order are supported."
1526 "バイトオーダーとしてはビッグエンディアンとリトルエンディアンのみが サポートさ"
1530 #: build/C/man3/hash.3:165
1531 msgid "B<btree>(3), B<dbopen>(3), B<mpool>(3), B<recno>(3)"
1532 msgstr "B<btree>(3), B<dbopen>(3), B<mpool>(3), B<recno>(3)"
1535 #: build/C/man3/hash.3:168
1537 "I<Dynamic Hash Tables>, Per-Ake Larson, Communications of the ACM, April "
1540 "I<Dynamic Hash Tables>, Per-Ake Larson, Communications of the ACM, April "
1544 #: build/C/man3/hash.3:171
1546 "I<A New Hash Package for UNIX>, Margo Seltzer, USENIX Proceedings, Winter "
1549 "I<A New Hash Package for UNIX>, Margo Seltzer, USENIX Proceedings, Winter "
1553 #: build/C/man3/mpool.3:36
1559 #: build/C/man3/mpool.3:36
1565 #: build/C/man3/mpool.3:40
1566 msgid "mpool - shared memory buffer pool"
1567 msgstr "mpool - 共有メモリーバッファープール"
1570 #: build/C/man3/mpool.3:44
1573 "B<#include E<lt>db.hE<gt>>\n"
1574 "B<#include E<lt>mpool.hE<gt>>\n"
1576 "B<#include E<lt>db.hE<gt>>\n"
1577 "B<#include E<lt>mpool.hE<gt>>\n"
1580 #: build/C/man3/mpool.3:47
1582 msgid "B<MPOOL *mpool_open(DBT *>I<key>B<, int >I<fd>B<, pgno_t >I<pagesize>B<, pgno_t >I<maxcache>B<);>\n"
1583 msgstr "B<MPOOL *mpool_open(DBT *>I<key>B<, int >I<fd>B<, pgno_t >I<pagesize>B<, pgno_t >I<maxcache>B<);>\n"
1586 #: build/C/man3/mpool.3:51
1589 "B<void mpool_filter(MPOOL *>I<mp>B<, void (*pgin)(void *, pgno_t, void *),>\n"
1590 "B< void (*>I<pgout>B<)(void *, pgno_t, void *),>\n"
1591 "B< void *>I<pgcookie>B<);>\n"
1593 "B<void mpool_filter(MPOOL *>I<mp>B<, void (*pgin)(void *, pgno_t, void *),>\n"
1594 "B< void (*>I<pgout>B<)(void *, pgno_t, void *),>\n"
1595 "B< void *>I<pgcookie>B<);>\n"
1598 #: build/C/man3/mpool.3:53
1600 msgid "B<void *mpool_new(MPOOL *>I<mp>B<, pgno_t *>I<pgnoaddr>B<);>\n"
1601 msgstr "B<void *mpool_new(MPOOL *>I<mp>B<, pgno_t *>I<pgnoaddr>B<);>\n"
1604 #: build/C/man3/mpool.3:55
1606 msgid "B<void *mpool_get(MPOOL *>I<mp>B<, pgno_t >I<pgno>B<, unsigned int >I<flags>B<);>\n"
1607 msgstr "B<void *mpool_get(MPOOL *>I<mp>B<, pgno_t >I<pgno>B<, unsigned int >I<flags>B<);>\n"
1610 #: build/C/man3/mpool.3:57
1612 msgid "B<int mpool_put(MPOOL *>I<mp>B<, void *>I<pgaddr>B<, unsigned int >I<flags>B<);>\n"
1613 msgstr "B<int mpool_put(MPOOL *>I<mp>B<, void *>I<pgaddr>B<, unsigned int >I<flags>B<);>\n"
1616 #: build/C/man3/mpool.3:59
1618 msgid "B<int mpool_sync(MPOOL *>I<mp>B<);>\n"
1619 msgstr "B<int mpool_sync(MPOOL *>I<mp>B<);>\n"
1622 #: build/C/man3/mpool.3:61
1624 msgid "B<int mpool_close(MPOOL *>I<mp>B<);>\n"
1625 msgstr "B<int mpool_close(MPOOL *>I<mp>B<);>\n"
1628 #: build/C/man3/mpool.3:74
1630 "I<Mpool> is the library interface intended to provide page oriented buffer "
1631 "management of files. The buffers may be shared between processes."
1633 "I<mpool> は、ファイルに対するページ指向のバッファー管理を実装した ライブラリ"
1637 #: build/C/man3/mpool.3:95
1639 "The function B<mpool_open>() initializes a memory pool. The I<key> "
1640 "argument is the byte string used to negotiate between multiple processes "
1641 "wishing to share buffers. If the file buffers are mapped in shared memory, "
1642 "all processes using the same key will share the buffers. If I<key> is NULL, "
1643 "the buffers are mapped into private memory. The I<fd> argument is a file "
1644 "descriptor for the underlying file, which must be seekable. If I<key> is "
1645 "non-NULL and matches a file already being mapped, the I<fd> argument is "
1648 "関数 B<mpool_open>() はメモリープールを初期化する。 I<key> 引数はバイト文字"
1649 "列であり、バッファーを共有したい複数プロセス間 でのネゴシエーションに使われ"
1650 "る。 ファイルバッファーが共有メモリーにマップされると、 同じキーを使うプロセ"
1651 "スは全てバッファーを共有する。 I<key> が NULL だと、バッファーはプライベート"
1652 "なメモリーに割り付けられる。 I<fd> 引数はもとになるファイルのファイルディスク"
1653 "リプターである。 このファイルディスクリプターはシーク可能でなくてはならな"
1654 "い。 I<key> が NULL でなく、かつ既にマップされているファイルにマッチした場"
1655 "合、 I<fd> 引数は無視される。"
1658 #: build/C/man3/mpool.3:106
1660 "The I<pagesize> argument is the size, in bytes, of the pages into which the "
1661 "file is broken up. The I<maxcache> argument is the maximum number of pages "
1662 "from the underlying file to cache at any one time. This value is not "
1663 "relative to the number of processes which share a file's buffers, but will "
1664 "be the largest value specified by any of the processes sharing the file."
1666 "I<pagesize> 引数はバイト単位でのページサイズであり、ファイルはこのサイズに分"
1667 "割される。 I<maxcache> 引数は基ファイルをキャッシュするときに用いる最大ページ"
1668 "数である。 この値はファイルバッファーを共有しているプロセスの数には関係ない"
1669 "が、 ファイルを共有するプロセスが指定したうちの最大値が実際に用いられる。"
1672 #: build/C/man3/mpool.3:122
1674 "The B<mpool_filter>() function is intended to make transparent input and "
1675 "output processing of the pages possible. If the I<pgin> function is "
1676 "specified, it is called each time a buffer is read into the memory pool from "
1677 "the backing file. If the I<pgout> function is specified, it is called each "
1678 "time a buffer is written into the backing file. Both functions are called "
1679 "with the I<pgcookie> pointer, the page number and a pointer to the page to "
1680 "being read or written."
1682 "関数 B<mpool_filter>() は透過的なページ入出力処理を可能にする。 関数 "
1683 "I<pgin> が指定されていると、 ファイルからメモリープールに読み込まれる度にこの"
1684 "関数が呼び出される。 関数 I<pgout> が指定されていと、 バッファーからファイル"
1685 "に書き出される度にこの関数が呼び出される。 どちらの関数も、 I<pgcookie> ポイ"
1686 "ンター、ページ数、読み書きされるページへのポインターを引数にとる。"
1689 #: build/C/man3/mpool.3:135
1691 "The function B<mpool_new>() takes an I<MPOOL> pointer and an address as "
1692 "arguments. If a new page can be allocated, a pointer to the page is "
1693 "returned and the page number is stored into the I<pgnoaddr> address. "
1694 "Otherwise, NULL is returned and I<errno> is set."
1696 "関数 B<mpool_new>() は I<MPOOL> ポインターとアドレスを引数にとる。 新しい"
1697 "ページが割り当て可能な場合、ページへのポインターが返され、 ページ数が "
1698 "I<pgnoaddr> アドレスに納められる。 割り当てが不可能な場合は NULL が返され、 "
1702 #: build/C/man3/mpool.3:148
1704 "The function B<mpool_get>() takes an I<MPOOL> pointer and a page number as "
1705 "arguments. If the page exists, a pointer to the page is returned. "
1706 "Otherwise, NULL is returned and I<errno> is set. The I<flags> argument is "
1707 "not currently used."
1709 "関数 B<mpool_get>() は I<MPOOL> ポインターとページ数を引数にとる。ページが存"
1710 "在していると、 ページへのポインターが返される。 存在していないと NULL が返さ"
1711 "れ、 I<errno> がセットされる。 I<flags> 引き数は現在使用されていない。"
1714 #: build/C/man3/mpool.3:160
1716 "The function B<mpool_put>() unpins the page referenced by I<pgaddr>. "
1717 "I<pgaddr> must be an address previously returned by B<mpool_get>() or "
1718 "B<mpool_new>(). The flag value is specified by ORing any of the following "
1721 "関数 B<mpool_put>() は I<pgaddr> が参照するページを解放する。 I<pgaddr> は以"
1722 "前に B<mpool_get>() か B<mpool_new>() が返したアドレスでなければならない。 "
1723 "flag の値は以下の値の論理和で指定する。"
1726 #: build/C/man3/mpool.3:160
1728 msgid "B<MPOOL_DIRTY>"
1729 msgstr "B<MPOOL_DIRTY>"
1732 #: build/C/man3/mpool.3:163
1733 msgid "The page has been modified and needs to be written to the backing file."
1734 msgstr "ページは変更されており、ファイルに書き出す必要がある。"
1737 #: build/C/man3/mpool.3:166
1738 msgid "B<mpool_put>() returns 0 on success and -1 if an error occurs."
1739 msgstr "B<mpool_put>() は成功すると 0 を、エラーがあると -1 を返す。"
1742 #: build/C/man3/mpool.3:175
1744 "The function B<mpool_sync>() writes all modified pages associated with the "
1745 "I<MPOOL> pointer to the backing file. B<mpool_sync>() returns 0 on success "
1746 "and -1 if an error occurs."
1748 "関数 B<mpool_sync>() は I<MPOOL> ポインターの示すページのうち、 変更されたも"
1749 "のを全てファイルに書き出す。 B<mpool_sync>() は成功すると 0 を、エラーがある"
1753 #: build/C/man3/mpool.3:185
1755 "The B<mpool_close>() function free's up any allocated memory associated "
1756 "with the memory pool cookie. Modified pages are B<not> written to the "
1757 "backing file. B<mpool_close>() returns 0 on success and -1 if an error "
1760 "関数 B<mpool_close>() はメモリープールクッキーの示す割り当て済みのメモリーを"
1761 "解放する。 変更されたページはファイルにB<書き出されない>。 I<mpool_close ()> "
1762 "は成功すると 0 を、エラーがあると -1 を返す。"
1765 #: build/C/man3/mpool.3:192
1767 "The B<mpool_open>() function may fail and set I<errno> for any of the "
1768 "errors specified for the library routine B<malloc>(3)."
1770 "関数 B<mpool_open>() は失敗するとライブラリルーチン B<malloc>(3) で指定され"
1771 "ているエラーに応じた I<errno> をセットする。"
1774 #: build/C/man3/mpool.3:198
1776 "The B<mpool_get>() function may fail and set I<errno> for the following:"
1777 msgstr "関数 B<mpool_get>() は失敗すると次のような I<errno> をセットする。"
1780 #: build/C/man3/mpool.3:201
1781 msgid "The requested record doesn't exist."
1782 msgstr "要求のあったレコードは存在しない。"
1785 #: build/C/man3/mpool.3:213
1787 "The B<mpool_new>() and B<mpool_get>() functions may fail and set I<errno> "
1788 "for any of the errors specified for the library routines B<read>(2), "
1789 "B<write>(2), and B<malloc>(3)."
1791 "関数 B<mpool_new>() と B<mpool_get>() は失敗するとライブラリルーチン "
1792 "B<read>(2), B<write>(2), B<malloc>(3) で指定されているエラーに応じた "
1796 #: build/C/man3/mpool.3:220
1798 "The B<mpool_sync>() function may fail and set I<errno> for any of the "
1799 "errors specified for the library routine B<write>(2)."
1801 "関数 B<mpool_sync>() は失敗するとライブラリルーチン B<write>(2) で指定され"
1802 "ているエラーに応じた I<errno> をセットする。"
1805 #: build/C/man3/mpool.3:227
1807 "The B<mpool_close>() function may fail and set I<errno> for any of the "
1808 "errors specified for the library routine B<free>(3)."
1810 "関数 B<mpool_close>() は失敗するとライブラリルーチン B<free>(3) で指定され"
1811 "ているエラーに応じた I<errno> をセットする。"
1814 #: build/C/man3/mpool.3:227
1816 msgid "CONFORMING TO"
1820 #: build/C/man3/mpool.3:230
1821 msgid "Not in POSIX.1-2001. Present on the BSDs."
1822 msgstr "POSIX.1-2001 にはない。 BSD 系に存在する。"
1825 #: build/C/man3/mpool.3:235
1826 msgid "B<btree>(3), B<dbopen>(3), B<hash>(3), B<recno>(3)"
1827 msgstr "B<btree>(3), B<dbopen>(3), B<hash>(3), B<recno>(3)"
1830 #: build/C/man3/recno.3:36
1836 #: build/C/man3/recno.3:40
1837 msgid "recno - record number database access method"
1838 msgstr "recno - レコード番号データベースへのアクセスメソッド"
1841 #: build/C/man3/recno.3:62
1843 "The routine B<dbopen>(3) is the library interface to database files. One "
1844 "of the supported file formats is record number files. The general "
1845 "description of the database access methods is in B<dbopen>(3), this manual "
1846 "page describes only the recno-specific information."
1848 "ルーチン B<dbopen>(3) はデータベースファイルに対するライブラリインターフェー"
1849 "スである。 サポートされているファイルフォーマットの一つに、 レコード番号ファ"
1850 "イル (record number file: recno file) がある。 データベースへのアクセスメソッ"
1851 "ドに関する一般的な記述は B<dbopen>(3), に書かれている。 このマニュアルページ"
1852 "では recno 特有の情報についてのみ記述する。"
1855 #: build/C/man3/recno.3:71
1857 "The record number data structure is either variable or fixed-length records "
1858 "stored in a flat-file format, accessed by the logical record number. The "
1859 "existence of record number five implies the existence of records one through "
1860 "four, and the deletion of record number one causes record number five to be "
1861 "renumbered to record number four, as well as the cursor, if positioned after "
1862 "record number one, to shift down one record."
1864 "レコード番号データ構造は、フラットなファイル形式に格納された 可変長/固定長レ"
1865 "コードからなり、論理レコード番号でアクセスされる。 レコード番号 5 があれば、"
1866 "レコード番号 1 から 4 も存在する。 レコード番号 1 を削除すると、レコード番号 "
1867 "5 は 4 に付け替えられ、 カーソルも移動する。レコード番号 1 以降のものは一つ繰"
1871 #: build/C/man3/recno.3:77
1873 "The recno access-method-specific data structure provided to B<dbopen>(3) is "
1874 "defined in the I<E<lt>db.hE<gt>> include file as follows:"
1876 "B<dbopen>(3) で使う recno アクセスメソッドに特有のデータ構造体は、 "
1877 "I<E<lt>db.hE<gt>> インクルードファイルで次のように定義されている。"
1880 #: build/C/man3/recno.3:89
1883 "typedef struct {\n"
1884 " unsigned long flags;\n"
1885 " unsigned int cachesize;\n"
1886 " unsigned int psize;\n"
1889 " unsigned char bval;\n"
1893 "typedef struct {\n"
1894 " unsigned long flags;\n"
1895 " unsigned int cachesize;\n"
1896 " unsigned int psize;\n"
1899 " unsigned char bval;\n"
1904 #: build/C/man3/recno.3:93
1905 msgid "The elements of this structure are defined as follows:"
1906 msgstr "この構造体の要素を以下に示す。"
1909 #: build/C/man3/recno.3:98
1911 msgid "B<R_FIXEDLEN>"
1912 msgstr "B<R_FIXEDLEN>"
1915 #: build/C/man3/recno.3:109
1917 "The records are fixed-length, not byte delimited. The structure element "
1918 "I<reclen> specifies the length of the record, and the structure element "
1919 "I<bval> is used as the pad character. Any records, inserted into the "
1920 "database, that are less than I<reclen> bytes long are automatically padded."
1922 "レコード長が固定であり、バイト区切りではない。 構造体の要素 I<reclen> はレ"
1923 "コードの長さを指定する。また、要素 I<bval> は埋め文字 (pad character) を指定"
1924 "する。 データベースに入れられたレコードの内 I<reclen> バイトに満たないもので"
1925 "は、残りの部分に埋め文字が自動的に入る。"
1928 #: build/C/man3/recno.3:109
1934 #: build/C/man3/recno.3:122
1936 "In the interface specified by B<dbopen>(3), the sequential record retrieval "
1937 "fills in both the caller's key and data structures. If the B<R_NOKEY> flag "
1938 "is specified, the I<cursor> routines are not required to fill in the key "
1939 "structure. This permits applications to retrieve records at the end of "
1940 "files without reading all of the intervening records."
1942 "B<dbopen>(3) で指定されたインターフェイスでは、シーケンシャルなレコード取得"
1943 "は 呼び出しキーとデータ構造体の両方を埋めていく。 B<R_NOKEY> フラグが指定され"
1944 "ていると、キー構造体を埋めるのに I<cursor> ルーチンを必要としない。 これを用"
1945 "いれば、アプリケーションがファイルの終りの方を取得する際に、 その途中のレコー"
1949 #: build/C/man3/recno.3:122
1951 msgid "B<R_SNAPSHOT>"
1952 msgstr "B<R_SNAPSHOT>"
1955 #: build/C/man3/recno.3:128
1957 "This flag requires that a snapshot of the file be taken when B<dbopen>(3) "
1958 "is called, instead of permitting any unmodified records to be read from the "
1961 "このフラグを指定すると、 B<dbopen>(3) の呼び出しの際、 オリジナルファイルか"
1962 "ら変更されていないレコードを読む代わりに、 ファイルの snapshot を用いる。"
1965 #: build/C/man3/recno.3:138
1967 "A suggested maximum size, in bytes, of the memory cache. This value is "
1968 "B<only> advisory, and the access method will allocate more memory rather "
1969 "than fail. If I<cachesize> is 0 (no size is specified), a default cache is "
1972 "想定されるメモリーキャッシュの最大サイズ (バイト単位)。 この値は B<あくまで> "
1973 "参考であり、アクセスメソッドはこの値を越えたメモリーの 割り当てに成功すること"
1974 "もある。 I<cachesize> が 0 (あるいは指定されていない) の場合、デフォルトの"
1978 #: build/C/man3/recno.3:150
1980 "The recno access method stores the in-memory copies of its records in a "
1981 "btree. This value is the size (in bytes) of the pages used for nodes in "
1982 "that tree. If I<psize> is 0 (no page size is specified), a page size is "
1983 "chosen based on the underlying filesystem I/O block size. See B<btree>(3) "
1984 "for more information."
1986 "recno アクセスメソッドは、自身のレコードのコピーをメモリー内部に btree で保存"
1987 "している。 この値は、その btree 中のノードに対して用いられる ページサイズ (バ"
1988 "イト単位) である。 I<psize> が 0 (あるいは指定されていない) の場合、 ファイル"
1989 "システムの I/O ブロックサイズを基にして ページサイズが決められる。 詳細は "
1993 #: build/C/man3/recno.3:158
1999 #: build/C/man3/recno.3:161
2000 msgid "The length of a fixed-length record."
2001 msgstr "固定レコード長の長さ。"
2004 #: build/C/man3/recno.3:161
2010 #: build/C/man3/recno.3:169
2012 "The delimiting byte to be used to mark the end of a record for variable-"
2013 "length records, and the pad character for fixed-length records. If no value "
2014 "is specified, newlines (\"\\en\") are used to mark the end of variable-"
2015 "length records and fixed-length records are padded with spaces."
2017 "可変レコード長において、 レコードの終りを示す区切りバイト (区切り文字) であ"
2018 "る。 固定レコード長では埋め文字として使われる。 値が指定されていないと、 可変"
2019 "レコード長のレコードの終りには改行 (\"\\en\") が使われる。 固定レコード長のレ"
2020 "コードは空白 (space) で埋められる。"
2023 #: build/C/man3/recno.3:169
2029 #: build/C/man3/recno.3:179
2031 "The recno access method stores the in-memory copies of its records in a "
2032 "btree. If I<bfname> is non-NULL, it specifies the name of the btree file, "
2033 "as if specified as the filename for a B<dbopen>(3) of a btree file."
2035 "recno アクセスメソッドは、 自身のレコードのコピーをメモリー内部で btree に保"
2036 "存している。 I<bfname> が NULL でない場合、これは btree ファイル名 (btree "
2037 "ファイルを B<dbopen>(3) する時に指定するファイル名) を指定する。"
2040 #: build/C/man3/recno.3:197
2042 "The data part of the key/data pair used by the I<recno> access method is the "
2043 "same as other access methods. The key is different. The I<data> field of "
2044 "the key should be a pointer to a memory location of type I<recno_t>, as "
2045 "defined in the I<E<lt>db.hE<gt>> include file. This type is normally the "
2046 "largest unsigned integral type available to the implementation. The I<size> "
2047 "field of the key should be the size of that type."
2049 "I<recno> アクセスメソッドで使われるキー/データ対のデータ部分は、 他のアクセス"
2050 "メソッドと同じである。 しかしキーは異なっている。 キーの I<data> フィールド"
2051 "は I<recno_t> 型の、メモリー位置へのポインターでなければならない。 "
2052 "I<recno_t> は I<E<lt>db.hE<gt>> インクルードファイルで定義されている。 この型"
2053 "は通常、その実装で利用可能な最大の符号無し整数である。 キーの I<size> フィー"
2057 #: build/C/man3/recno.3:202
2059 "Because there can be no metadata associated with the underlying recno access "
2060 "method files, any changes made to the default values (e.g., fixed record "
2061 "length or byte separator value) must be explicitly specified each time the "
2064 "recno アクセスメソッドのファイルに関連づけられる メタデータは存在できないか"
2065 "ら、 デフォルト値 (固定レコード長やセパレータ文字など) に対する変更はファイ"
2066 "ルを開く毎に明示的に指定しなければならない。"
2069 #: build/C/man3/recno.3:210
2071 "In the interface specified by B<dbopen>(3), using the I<put> interface to "
2072 "create a new record will cause the creation of multiple, empty records if "
2073 "the record number is more than one greater than the largest record currently "
2076 "B<dbopen>(3) で指定されたインターフェイスでは、 I<put> インターフェイスを"
2077 "使って新しいレコードを作成するときに、 指定したレコード番号がデータベース中に"
2078 "存在している最大レコード番号より 一つ以上大きいと、 空のレコードが同時にでき"
2082 #: build/C/man3/recno.3:218
2084 "The I<recno> access method routines may fail and set I<errno> for any of the "
2085 "errors specified for the library routine B<dbopen>(3) or the following:"
2087 "I<recno> アクセスメソッドルーチンは失敗すると B<dbopen>(3) で指定されている"
2088 "エラーに応じた I<errno> か、 あるいは以下に示す I<errno> をセットする。"
2091 #: build/C/man3/recno.3:222
2093 "An attempt was made to add a record to a fixed-length database that was too "
2095 msgstr "固定長データベースにレコードを追加するとき、データが長すぎた。"
2098 #: build/C/man3/recno.3:229
2099 msgid "B<btree>(3), B<dbopen>(3), B<hash>(3), B<mpool>(3)"
2100 msgstr "B<btree>(3), B<dbopen>(3), B<hash>(3), B<mpool>(3)"
2103 #: build/C/man3/recno.3:233
2105 "I<Document Processing in a Relational Database System>, Michael Stonebraker, "
2106 "Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. "
2107 "UCB/ERL M82/32, May 1982."
2109 "I<Document Processing in a Relational Database System>, Michael Stonebraker, "
2110 "Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum No. "
2111 "UCB/ERL M82/32, May 1982."