# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the PACKAGE package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: PACKAGE VERSION\n"
"POT-Creation-Date: 2012-05-01 04:38+0900\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=CHARSET\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: TH
#: build/C/man3/btree.3:34
#, no-wrap
msgid "BTREE"
msgstr ""

#. type: TH
#: build/C/man3/btree.3:34 build/C/man3/dbopen.3:34 build/C/man3/hash.3:34 build/C/man3/recno.3:34
#, no-wrap
msgid "2012-04-23"
msgstr ""

#. type: TH
#: build/C/man3/btree.3:34 build/C/man3/dbopen.3:34 build/C/man3/hash.3:34 build/C/man3/mpool.3:34 build/C/man3/recno.3:34
#, no-wrap
msgid "Linux Programmer's Manual"
msgstr ""

#. type: SH
#: build/C/man3/btree.3:36 build/C/man3/dbopen.3:36 build/C/man3/hash.3:36 build/C/man3/mpool.3:36 build/C/man3/recno.3:36
#, no-wrap
msgid "NAME"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:38
msgid "btree - btree database access method"
msgstr ""

#. type: SH
#: build/C/man3/btree.3:38 build/C/man3/dbopen.3:38 build/C/man3/hash.3:38 build/C/man3/mpool.3:38 build/C/man3/recno.3:38
#, no-wrap
msgid "SYNOPSIS"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:43 build/C/man3/hash.3:43 build/C/man3/recno.3:43
#, no-wrap
msgid ""
"B<#include E<lt>sys/types.hE<gt>\n"
"#include E<lt>db.hE<gt>>\n"
msgstr ""

#. type: SH
#: build/C/man3/btree.3:45 build/C/man3/dbopen.3:48 build/C/man3/hash.3:45 build/C/man3/mpool.3:60 build/C/man3/recno.3:45
#, no-wrap
msgid "DESCRIPTION"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:52 build/C/man3/dbopen.3:55 build/C/man3/hash.3:52 build/C/man3/mpool.3:67 build/C/man3/recno.3:52
msgid ""
"I<Note well>: This page documents interfaces provided in glibc up until "
"version 2.1.  Since version 2.2, glibc no longer provides these interfaces.  "
"Probably, you are looking for the APIs provided by the I<libdb> library "
"instead."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:60
msgid ""
"The routine B<dbopen>(3)  is the library interface to database files.  One "
"of the supported file formats is btree files.  The general description of "
"the database access methods is in B<dbopen>(3), this manual page describes "
"only the btree specific information."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:63
msgid ""
"The btree data structure is a sorted, balanced tree structure storing "
"associated key/data pairs."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:69
msgid ""
"The btree access method specific data structure provided to B<dbopen>(3)  is "
"defined in the I<E<lt>db.hE<gt>> include file as follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:82
#, no-wrap
msgid ""
"typedef struct {\n"
"    unsigned long flags;\n"
"    unsigned int  cachesize;\n"
"    int           maxkeypage;\n"
"    int           minkeypage;\n"
"    unsigned int  psize;\n"
"    int         (*compare)(const DBT *key1, const DBT *key2);\n"
"    size_t      (*prefix)(const DBT *key1, const DBT *key2);\n"
"    int           lorder;\n"
"} BTREEINFO;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:86 build/C/man3/hash.3:83
msgid "The elements of this structure are as follows:"
msgstr ""

#. type: TP
#: build/C/man3/btree.3:86
#, no-wrap
msgid "I<flags>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:89 build/C/man3/recno.3:95
msgid "The flag value is specified by ORing any of the following values:"
msgstr ""

#. type: TP
#: build/C/man3/btree.3:90
#, no-wrap
msgid "B<R_DUP>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:109
msgid ""
"Permit duplicate keys in the tree, that is, permit insertion if the key to "
"be inserted already exists in the tree.  The default behavior, as described "
"in B<dbopen>(3), is to overwrite a matching key when inserting a new key or "
"to fail if the B<R_NOOVERWRITE> flag is specified.  The B<R_DUP> flag is "
"overridden by the B<R_NOOVERWRITE> flag, and if the B<R_NOOVERWRITE> flag is "
"specified, attempts to insert duplicate keys into the tree will fail."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:119
msgid ""
"If the database contains duplicate keys, the order of retrieval of key/data "
"pairs is undefined if the I<get> routine is used, however, I<seq> routine "
"calls with the B<R_CURSOR> flag set will always return the logical \"first\" "
"of any group of duplicate keys."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:120 build/C/man3/hash.3:100 build/C/man3/recno.3:127
#, no-wrap
msgid "I<cachesize>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:135
msgid ""
"A suggested maximum size (in bytes) of the memory cache.  This value is "
"I<only> advisory, and the access method will allocate more memory rather "
"than fail.  Since every search examines the root page of the tree, caching "
"the most recently used pages substantially improves access time.  In "
"addition, physical writes are delayed as long as possible, so a moderate "
"cache can reduce the number of I/O operations significantly.  Obviously, "
"using a cache increases (but only increases) the likelihood of corruption or "
"lost data if the system crashes while a tree is being modified.  If "
"I<cachesize> is 0 (no size is specified) a default cache is used."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:135
#, no-wrap
msgid "I<maxkeypage>"
msgstr ""

#.  The maximum number of keys which will be stored on any single page.
#.  Because of the way the btree data structure works,
#.  .I maxkeypage
#.  must always be greater than or equal to 2.
#.  If
#.  .I maxkeypage
#.  is 0 (no maximum number of keys is specified) the page fill factor is
#.  made as large as possible (which is almost invariably what is wanted).
#. type: Plain text
#: build/C/man3/btree.3:147
msgid ""
"The maximum number of keys which will be stored on any single page.  Not "
"currently implemented."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:147
#, no-wrap
msgid "I<minkeypage>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:157
msgid ""
"The minimum number of keys which will be stored on any single page.  This "
"value is used to determine which keys will be stored on overflow pages, that "
"is, if a key or data item is longer than the pagesize divided by the "
"minkeypage value, it will be stored on overflow pages instead of in the page "
"itself.  If I<minkeypage> is 0 (no minimum number of keys is specified) a "
"value of 2 is used."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:157 build/C/man3/recno.3:136
#, no-wrap
msgid "I<psize>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:165
msgid ""
"Page size is the size (in bytes) of the pages used for nodes in the tree.  "
"The minimum page size is 512 bytes and the maximum page size is 64K.  If "
"I<psize> is 0 (no page size is specified) a page size is chosen based on the "
"underlying file system I/O block size."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:165
#, no-wrap
msgid "I<compare>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:177
msgid ""
"Compare is the key comparison function.  It must return an integer less "
"than, equal to, or greater than zero if the first key argument is considered "
"to be respectively less than, equal to, or greater than the second key "
"argument.  The same comparison function must be used on a given tree every "
"time it is opened.  If I<compare> is NULL (no comparison function is "
"specified), the keys are compared lexically, with shorter keys considered "
"less than longer keys."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:177
#, no-wrap
msgid "I<prefix>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:196
msgid ""
"Prefix is the prefix comparison function.  If specified, this routine must "
"return the number of bytes of the second key argument which are necessary to "
"determine that it is greater than the first key argument.  If the keys are "
"equal, the key length should be returned.  Note, the usefulness of this "
"routine is very data-dependent, but, in some data sets can produce "
"significantly reduced tree sizes and search times.  If I<prefix> is NULL (no "
"prefix function is specified), I<and> no comparison function is specified, a "
"default lexical comparison routine is used.  If I<prefix> is NULL and a "
"comparison routine is specified, no prefix comparison is done."
msgstr ""

#. type: TP
#: build/C/man3/btree.3:196 build/C/man3/hash.3:115 build/C/man3/recno.3:148
#, no-wrap
msgid "I<lorder>"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:204 build/C/man3/recno.3:156
msgid ""
"The byte order for integers in the stored database metadata.  The number "
"should represent the order as an integer; for example, big endian order "
"would be the number 4,321.  If I<lorder> is 0 (no order is specified) the "
"current host order is used."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:215
msgid ""
"If the file already exists (and the B<O_TRUNC> flag is not specified), the "
"values specified for the arguments I<flags>, I<lorder> and I<psize> are "
"ignored in favor of the values used when the tree was created."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:217
msgid "Forward sequential scans of a tree are from the least key to the greatest."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:223
msgid ""
"Space freed up by deleting key/data pairs from the tree is never reclaimed, "
"although it is normally made available for reuse.  This means that the btree "
"storage structure is grow-only.  The only solutions are to avoid excessive "
"deletions, or to create a fresh tree periodically from a scan of an existing "
"one."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:229
msgid ""
"Searches, insertions, and deletions in a btree will all complete in O lg "
"base N where base is the average fill factor.  Often, inserting ordered data "
"into btrees results in a low fill factor.  This implementation has been "
"modified to make ordered insertion the best case, resulting in a much better "
"than normal page fill factor."
msgstr ""

#. type: SH
#: build/C/man3/btree.3:229 build/C/man3/dbopen.3:478 build/C/man3/hash.3:149 build/C/man3/mpool.3:183 build/C/man3/recno.3:208
#, no-wrap
msgid "ERRORS"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:236
msgid ""
"The I<btree> access method routines may fail and set I<errno> for any of the "
"errors specified for the library routine B<dbopen>(3)."
msgstr ""

#. type: SH
#: build/C/man3/btree.3:236 build/C/man3/dbopen.3:540 build/C/man3/hash.3:156 build/C/man3/recno.3:220
#, no-wrap
msgid "BUGS"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:238 build/C/man3/recno.3:222
msgid "Only big and little endian byte order is supported."
msgstr ""

#. type: SH
#: build/C/man3/btree.3:238 build/C/man3/dbopen.3:551 build/C/man3/hash.3:158 build/C/man3/mpool.3:228 build/C/man3/recno.3:222
#, no-wrap
msgid "SEE ALSO"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:243
msgid "B<dbopen>(3), B<hash>(3), B<mpool>(3), B<recno>(3)"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:246
msgid ""
"I<The Ubiquitous B-tree>, Douglas Comer, ACM Comput. Surv. 11, 2 (June "
"1979), 121-138."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:250
msgid ""
"I<Prefix B-trees>, Bayer and Unterauer, ACM Transactions on Database "
"Systems, Vol. 2, 1 (March 1977), 11-26."
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:253
msgid ""
"I<The Art of Computer Programming Vol. 3: Sorting and Searching>, "
"D.E. Knuth, 1968, pp 471-480."
msgstr ""

#. type: SH
#: build/C/man3/btree.3:253 build/C/man3/dbopen.3:559 build/C/man3/hash.3:169 build/C/man3/mpool.3:233 build/C/man3/recno.3:231
#, no-wrap
msgid "COLOPHON"
msgstr ""

#. type: Plain text
#: build/C/man3/btree.3:260 build/C/man3/dbopen.3:566 build/C/man3/hash.3:176 build/C/man3/mpool.3:240 build/C/man3/recno.3:238
msgid ""
"This page is part of release 3.40 of the Linux I<man-pages> project.  A "
"description of the project, and information about reporting bugs, can be "
"found at http://www.kernel.org/doc/man-pages/."
msgstr ""

#. type: TH
#: build/C/man3/dbopen.3:34
#, no-wrap
msgid "DBOPEN"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:38
msgid "dbopen - database access methods"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:43
#, no-wrap
msgid ""
"B<#include E<lt>sys/types.hE<gt>>\n"
"B<#include E<lt>limits.hE<gt>>\n"
"B<#include E<lt>db.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:47
#, no-wrap
msgid ""
"B<DB *dbopen(const char *>I<file>B<, int >I<flags>B<, int >I<mode>B<, DBTYPE "
">I<type>B<,>\n"
"B<           const void *>I<openinfo>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:69
msgid ""
"B<dbopen>()  is the library interface to database files.  The supported file "
"formats are btree, hashed and UNIX file oriented.  The btree format is a "
"representation of a sorted, balanced tree structure.  The hashed format is "
"an extensible, dynamic hashing scheme.  The flat-file format is a byte "
"stream file with fixed or variable length records.  The formats and file "
"format specific information are described in detail in their respective "
"manual pages B<btree>(3), B<hash>(3)  and B<recno>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:78
msgid ""
"B<dbopen>()  opens I<file> for reading and/or writing.  Files never intended "
"to be preserved on disk may be created by setting the I<file> argument to "
"NULL."
msgstr ""

#. Three additional options may be specified by ORing
#. them into the
#. .I flags
#. argument.
#. .TP
#. DB_LOCK
#. Do the necessary locking in the database to support concurrent access.
#. If concurrent access isn't needed or the database is read-only this
#. flag should not be set, as it tends to have an associated performance
#. penalty.
#. .TP
#. DB_SHMEM
#. Place the underlying memory pool used by the database in shared
#. memory.
#. Necessary for concurrent access.
#. .TP
#. DB_TXN
#. Support transactions in the database.
#. The DB_LOCK and DB_SHMEM flags must be set as well.
#. type: Plain text
#: build/C/man3/dbopen.3:118
msgid ""
"The I<flags> and I<mode> arguments are as specified to the B<open>(2)  "
"routine, however, only the B<O_CREAT>, B<O_EXCL>, B<O_EXLOCK>, "
"B<O_NONBLOCK>, B<O_RDONLY>, B<O_RDWR>, B<O_SHLOCK>, and B<O_TRUNC> flags are "
"meaningful.  (Note, opening a database file B<O_WRONLY> is not possible.)"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:131
msgid ""
"The I<type> argument is of type I<DBTYPE> (as defined in the "
"I<E<lt>db.hE<gt>> include file) and may be set to B<DB_BTREE>, B<DB_HASH>, "
"or B<DB_RECNO>."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:140
msgid ""
"The I<openinfo> argument is a pointer to an access method specific structure "
"described in the access method's manual page.  If I<openinfo> is NULL, each "
"access method will use defaults appropriate for the system and the access "
"method."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:151
msgid ""
"B<dbopen>()  returns a pointer to a I<DB> structure on success and NULL on "
"error.  The I<DB> structure is defined in the I<E<lt>db.hE<gt>> include "
"file, and contains at least the following fields:"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:167
#, no-wrap
msgid ""
"typedef struct {\n"
"    DBTYPE type;\n"
"    int (*close)(const DB *db);\n"
"    int (*del)(const DB *db, const DBT *key, unsigned int flags);\n"
"    int (*fd)(const DB *db);\n"
"    int (*get)(const DB *db, DBT *key, DBT *data,\n"
"               unsigned int flags);\n"
"    int (*put)(const DB *db, DBT *key, const DBT *data,\n"
"               unsigned int flags);\n"
"    int (*sync)(const DB *db, unsigned int flags);\n"
"    int (*seq)(const DB *db, DBT *key, DBT *data,\n"
"               unsigned int flags);\n"
"} DB;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:175
msgid ""
"These elements describe a database type and a set of functions performing "
"various actions.  These functions take a pointer to a structure as returned "
"by B<dbopen>(), and sometimes one or more pointers to key/data structures "
"and a flag value."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:175
#, no-wrap
msgid "I<type>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:178
msgid "The type of the underlying access method (and file format)."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:178
#, no-wrap
msgid "I<close>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:192
msgid ""
"A pointer to a routine to flush any cached information to disk, free any "
"allocated resources, and close the underlying file(s).  Since key/data pairs "
"may be cached in memory, failing to sync the file with a I<close> or I<sync> "
"function may result in inconsistent or lost information.  I<close> routines "
"return -1 on error (setting I<errno>)  and 0 on success."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:192
#, no-wrap
msgid "I<del>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:195
msgid "A pointer to a routine to remove key/data pairs from the database."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:199
msgid "The argument I<flag> may be set to the following value:"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:200 build/C/man3/dbopen.3:256 build/C/man3/dbopen.3:356
#, no-wrap
msgid "B<R_CURSOR>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:204
msgid ""
"Delete the record referenced by the cursor.  The cursor must have previously "
"been initialized."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:212
msgid ""
"I<delete> routines return -1 on error (setting I<errno>), 0 on success, and "
"1 if the specified I<key> was not in the file."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:212
#, no-wrap
msgid "I<fd>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:234
msgid ""
"A pointer to a routine which returns a file descriptor representative of the "
"underlying database.  A file descriptor referencing the same file will be "
"returned to all processes which call B<dbopen>()  with the same I<file> "
"name.  This file descriptor may be safely used as an argument to the "
"B<fcntl>(2)  and B<flock>(2)  locking functions.  The file descriptor is not "
"necessarily associated with any of the underlying files used by the access "
"method.  No file descriptor is available for in memory databases.  I<fd> "
"routines return -1 on error (setting I<errno>), and the file descriptor on "
"success."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:234
#, no-wrap
msgid "I<get>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:248
msgid ""
"A pointer to a routine which is the interface for keyed retrieval from the "
"database.  The address and length of the data associated with the specified "
"I<key> are returned in the structure referenced by I<data>.  I<get> routines "
"return -1 on error (setting I<errno>), 0 on success, and 1 if the I<key> was "
"not in the file."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:248
#, no-wrap
msgid "I<put>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:251
msgid "A pointer to a routine to store key/data pairs in the database."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:255
msgid "The argument I<flag> may be set to one of the following values:"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:260
msgid ""
"Replace the key/data pair referenced by the cursor.  The cursor must have "
"previously been initialized."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:260
#, no-wrap
msgid "B<R_IAFTER>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:271
msgid ""
"Append the data immediately after the data referenced by I<key>, creating a "
"new key/data pair.  The record number of the appended key/data pair is "
"returned in the I<key> structure.  (Applicable only to the B<DB_RECNO> "
"access method.)"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:271
#, no-wrap
msgid "B<R_IBEFORE>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:282
msgid ""
"Insert the data immediately before the data referenced by I<key>, creating a "
"new key/data pair.  The record number of the inserted key/data pair is "
"returned in the I<key> structure.  (Applicable only to the B<DB_RECNO> "
"access method.)"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:282
#, no-wrap
msgid "B<R_NOOVERWRITE>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:285
msgid "Enter the new key/data pair only if the key does not previously exist."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:285
#, no-wrap
msgid "B<R_SETCURSOR>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:294
msgid ""
"Store the key/data pair, setting or initializing the position of the cursor "
"to reference it.  (Applicable only to the B<DB_BTREE> and B<DB_RECNO> access "
"methods.)"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:304
msgid ""
"B<R_SETCURSOR> is available only for the B<DB_BTREE> and B<DB_RECNO> access "
"methods because it implies that the keys have an inherent order which does "
"not change."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:314
msgid ""
"B<R_IAFTER> and B<R_IBEFORE> are available only for the B<DB_RECNO> access "
"method because they each imply that the access method is able to create new "
"keys.  This is only true if the keys are ordered and independent, record "
"numbers for example."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:319
msgid ""
"The default behavior of the I<put> routines is to enter the new key/data "
"pair, replacing any previously existing key."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:327
msgid ""
"I<put> routines return -1 on error (setting I<errno>), 0 on success, and 1 "
"if the B<R_NOOVERWRITE> I<flag> was set and the key already exists in the "
"file."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:327
#, no-wrap
msgid "I<seq>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:338
msgid ""
"A pointer to a routine which is the interface for sequential retrieval from "
"the database.  The address and length of the key are returned in the "
"structure referenced by I<key>, and the address and length of the data are "
"returned in the structure referenced by I<data>."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:351
msgid ""
"Sequential key/data pair retrieval may begin at any time, and the position "
"of the \"cursor\" is not affected by calls to the I<del>, I<get>, I<put>, or "
"I<sync> routines.  Modifications to the database during a sequential scan "
"will be reflected in the scan, that is, records inserted behind the cursor "
"will not be returned while records inserted in front of the cursor will be "
"returned."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:355
msgid "The flag value B<must> be set to one of the following values:"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:369
msgid ""
"The data associated with the specified key is returned.  This differs from "
"the I<get> routines in that it sets or initializes the cursor to the "
"location of the key as well.  (Note, for the B<DB_BTREE> access method, the "
"returned key is not necessarily an exact match for the specified key.  The "
"returned key is the smallest key greater than or equal to the specified key, "
"permitting partial key matches and range searches.)"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:369
#, no-wrap
msgid "B<R_FIRST>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:373
msgid ""
"The first key/data pair of the database is returned, and the cursor is set "
"or initialized to reference it."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:373
#, no-wrap
msgid "B<R_LAST>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:382
msgid ""
"The last key/data pair of the database is returned, and the cursor is set or "
"initialized to reference it.  (Applicable only to the B<DB_BTREE> and "
"B<DB_RECNO> access methods.)"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:382
#, no-wrap
msgid "B<R_NEXT>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:388
msgid ""
"Retrieve the key/data pair immediately after the cursor.  If the cursor is "
"not yet set, this is the same as the B<R_FIRST> flag."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:388
#, no-wrap
msgid "B<R_PREV>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:399
msgid ""
"Retrieve the key/data pair immediately before the cursor.  If the cursor is "
"not yet set, this is the same as the B<R_LAST> flag.  (Applicable only to "
"the B<DB_BTREE> and B<DB_RECNO> access methods.)"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:410
msgid ""
"B<R_LAST> and B<R_PREV> are available only for the B<DB_BTREE> and "
"B<DB_RECNO> access methods because they each imply that the keys have an "
"inherent order which does not change."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:423
msgid ""
"I<seq> routines return -1 on error (setting I<errno>), 0 on success and 1 if "
"there are no key/data pairs less than or greater than the specified or "
"current key.  If the B<DB_RECNO> access method is being used, and if the "
"database file is a character special file and no complete key/data pairs are "
"currently available, the I<seq> routines return 2."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:423
#, no-wrap
msgid "I<sync>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:429
msgid ""
"A pointer to a routine to flush any cached information to disk.  If the "
"database is in memory only, the I<sync> routine has no effect and will "
"always succeed."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:431
msgid "The flag value may be set to the following value:"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:432
#, no-wrap
msgid "B<R_RECNOSYNC>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:444
msgid ""
"If the B<DB_RECNO> access method is being used, this flag causes the sync "
"routine to apply to the btree file which underlies the recno file, not the "
"recno file itself.  (See the I<bfname> field of the B<recno>(3)  manual page "
"for more information.)"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:450
msgid "I<sync> routines return -1 on error (setting I<errno>)  and 0 on success."
msgstr ""

#. type: SS
#: build/C/man3/dbopen.3:450
#, no-wrap
msgid "Key/Data Pairs"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:453
msgid ""
"Access to all file types is based on key/data pairs.  Both keys and data are "
"represented by the following data structure:"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:460
#, no-wrap
msgid ""
"typedef struct {\n"
"    void  *data;\n"
"    size_t size;\n"
"} DBT;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:466
msgid "The elements of the I<DBT> structure are defined as follows:"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:466
#, no-wrap
msgid "I<data>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:469
msgid "A pointer to a byte string."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:469
#, no-wrap
msgid "I<size>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:472
msgid "The length of the byte string."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:478
msgid ""
"Key and data byte strings may reference strings of essentially unlimited "
"length although any two of them must fit into available memory at the same "
"time.  It should be noted that the access methods provide no guarantees "
"about byte string alignment."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:488
msgid ""
"The B<dbopen>()  routine may fail and set I<errno> for any of the errors "
"specified for the library routines B<open>(2)  and B<malloc>(3)  or the "
"following:"
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:488
#, no-wrap
msgid "B<EFTYPE>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:491
msgid "A file is incorrectly formatted."
msgstr ""

#. type: TP
#: build/C/man3/dbopen.3:491 build/C/man3/mpool.3:196 build/C/man3/recno.3:216
#, no-wrap
msgid "B<EINVAL>"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:498
msgid ""
"A parameter has been specified (hash function, pad byte etc.) that is "
"incompatible with the current file specification or which is not meaningful "
"for the function (for example, use of the cursor without prior "
"initialization) or there is a mismatch between the version number of file "
"and the software."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:510
msgid ""
"The I<close> routines may fail and set I<errno> for any of the errors "
"specified for the library routines B<close>(2), B<read>(2), B<write>(2), "
"B<free>(3), or B<fsync>(2)."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:525
msgid ""
"The I<del>, I<get>, I<put> and I<seq> routines may fail and set I<errno> for "
"any of the errors specified for the library routines B<read>(2), "
"B<write>(2), B<free>(3)  or B<malloc>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:533
msgid ""
"The I<fd> routines will fail and set I<errno> to B<ENOENT> for in memory "
"databases."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:540
msgid ""
"The I<sync> routines may fail and set I<errno> for any of the errors "
"specified for the library routine B<fsync>(2)."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:545
msgid ""
"The typedef I<DBT> is a mnemonic for \"data base thang\", and was used "
"because no-one could think of a reasonable name that wasn't already used."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:548
msgid ""
"The file descriptor interface is a kludge and will be deleted in a future "
"version of the interface."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:551
msgid ""
"None of the access methods provide any form of concurrent access, locking, "
"or transactions."
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:556
msgid "B<btree>(3), B<hash>(3), B<mpool>(3), B<recno>(3)"
msgstr ""

#. type: Plain text
#: build/C/man3/dbopen.3:559
msgid ""
"I<LIBTP: Portable, Modular Transactions for UNIX>, Margo Seltzer, Michael "
"Olson, USENIX proceedings, Winter 1992."
msgstr ""

#. type: TH
#: build/C/man3/hash.3:34
#, no-wrap
msgid "HASH"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:38
msgid "hash - hash database access method"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:60
msgid ""
"The routine B<dbopen>(3)  is the library interface to database files.  One "
"of the supported file formats is hash files.  The general description of the "
"database access methods is in B<dbopen>(3), this manual page describes only "
"the hash specific information."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:62
msgid "The hash data structure is an extensible, dynamic hashing scheme."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:68
msgid ""
"The access method specific data structure provided to B<dbopen>(3)  is "
"defined in the I<E<lt>db.hE<gt>> include file as follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:79
#, no-wrap
msgid ""
"typedef struct {\n"
"    unsigned int       bsize;\n"
"    unsigned int       ffactor;\n"
"    unsigned int       nelem;\n"
"    unsigned int       cachesize;\n"
"    uint32_t         (*hash)(const void *, size_t);\n"
"    int         lorder;\n"
"} HASHINFO;\n"
msgstr ""

#. type: TP
#: build/C/man3/hash.3:83
#, no-wrap
msgid "I<bsize>"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:88
msgid ""
"defines the hash table bucket size, and is, by default, 256 bytes.  It may "
"be preferable to increase the page size for disk-resident tables and tables "
"with large data items."
msgstr ""

#. type: TP
#: build/C/man3/hash.3:88
#, no-wrap
msgid "I<ffactor>"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:94
msgid ""
"indicates a desired density within the hash table.  It is an approximation "
"of the number of keys allowed to accumulate in any one bucket, determining "
"when the hash table grows or shrinks.  The default value is 8."
msgstr ""

#. type: TP
#: build/C/man3/hash.3:94
#, no-wrap
msgid "I<nelem>"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:100
msgid ""
"is an estimate of the final size of the hash table.  If not set or set too "
"low, hash tables will expand gracefully as keys are entered, although a "
"slight performance degradation may be noticed.  The default value is 1."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:106
msgid ""
"is the suggested maximum size, in bytes, of the memory cache.  This value is "
"I<only advisory>, and the access method will allocate more memory rather "
"than fail."
msgstr ""

#. type: TP
#: build/C/man3/hash.3:106
#, no-wrap
msgid "I<hash>"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:115
msgid ""
"is a user-defined hash function.  Since no hash function performs equally "
"well on all possible data, the user may find that the built-in hash function "
"does poorly on a particular data set.  A user-specified hash functions must "
"take two arguments (a pointer to a byte string and a length) and return a "
"32-bit quantity to be used as the hash value."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:125
msgid ""
"is the byte order for integers in the stored database metadata.  The number "
"should represent the order as an integer; for example, big endian order "
"would be the number 4,321.  If I<lorder> is 0 (no order is specified) the "
"current host order is used.  If the file already exists, the specified value "
"is ignored and the value specified when the tree was created is used."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:137
msgid ""
"If the file already exists (and the B<O_TRUNC> flag is not specified), the "
"values specified for I<bsize>, I<ffactor>, I<lorder>, and I<nelem> are "
"ignored and the values specified when the tree was created are used."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:142
msgid ""
"If a hash function is specified, I<hash_open> will attempt to determine if "
"the hash function specified is the same as the one with which the database "
"was created, and will fail if it is not."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:149
msgid ""
"Backward-compatible interfaces to the routines described in B<dbm>(3), and "
"B<ndbm>(3)  are provided, however these interfaces are not compatible with "
"previous file formats."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:156
msgid ""
"The I<hash> access method routines may fail and set I<errno> for any of the "
"errors specified for the library routine B<dbopen>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:158
msgid "Only big and little endian byte order are supported."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:163
msgid "B<btree>(3), B<dbopen>(3), B<mpool>(3), B<recno>(3)"
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:166
msgid ""
"I<Dynamic Hash Tables>, Per-Ake Larson, Communications of the ACM, April "
"1988."
msgstr ""

#. type: Plain text
#: build/C/man3/hash.3:169
msgid ""
"I<A New Hash Package for UNIX>, Margo Seltzer, USENIX Proceedings, Winter "
"1991."
msgstr ""

#. type: TH
#: build/C/man3/mpool.3:34
#, no-wrap
msgid "MPOOL"
msgstr ""

#. type: TH
#: build/C/man3/mpool.3:34
#, no-wrap
msgid "2012-04-26"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:38
msgid "mpool - shared memory buffer pool"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:42
#, no-wrap
msgid ""
"B<#include E<lt>db.hE<gt>>\n"
"B<#include E<lt>mpool.hE<gt>>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:45
#, no-wrap
msgid ""
"B<MPOOL *mpool_open(DBT *>I<key>B<, int >I<fd>B<, pgno_t >I<pagesize>B<, "
"pgno_t >I<maxcache>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:49
#, no-wrap
msgid ""
"B<void mpool_filter(MPOOL *>I<mp>B<, void (*pgin)(void *, pgno_t, void "
"*),>\n"
"B<                  void (*>I<pgout>B<)(void *, pgno_t, void *),>\n"
"B<                  void *>I<pgcookie>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:51
#, no-wrap
msgid "B<void *mpool_new(MPOOL *>I<mp>B<, pgno_t *>I<pgnoaddr>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:53
#, no-wrap
msgid ""
"B<void *mpool_get(MPOOL *>I<mp>B<, pgno_t >I<pgno>B<, unsigned int "
">I<flags>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:55
#, no-wrap
msgid ""
"B<int mpool_put(MPOOL *>I<mp>B<, void *>I<pgaddr>B<, unsigned int "
">I<flags>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:57
#, no-wrap
msgid "B<int mpool_sync(MPOOL *>I<mp>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:59
#, no-wrap
msgid "B<int mpool_close(MPOOL *>I<mp>B<);>\n"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:72
msgid ""
"I<Mpool> is the library interface intended to provide page oriented buffer "
"management of files.  The buffers may be shared between processes."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:93
msgid ""
"The function B<mpool_open>()  initializes a memory pool.  The I<key> "
"argument is the byte string used to negotiate between multiple processes "
"wishing to share buffers.  If the file buffers are mapped in shared memory, "
"all processes using the same key will share the buffers.  If I<key> is NULL, "
"the buffers are mapped into private memory.  The I<fd> argument is a file "
"descriptor for the underlying file, which must be seekable.  If I<key> is "
"non-NULL and matches a file already being mapped, the I<fd> argument is "
"ignored."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:104
msgid ""
"The I<pagesize> argument is the size, in bytes, of the pages into which the "
"file is broken up.  The I<maxcache> argument is the maximum number of pages "
"from the underlying file to cache at any one time.  This value is not "
"relative to the number of processes which share a file's buffers, but will "
"be the largest value specified by any of the processes sharing the file."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:120
msgid ""
"The B<mpool_filter>()  function is intended to make transparent input and "
"output processing of the pages possible.  If the I<pgin> function is "
"specified, it is called each time a buffer is read into the memory pool from "
"the backing file.  If the I<pgout> function is specified, it is called each "
"time a buffer is written into the backing file.  Both functions are called "
"with the I<pgcookie> pointer, the page number and a pointer to the page to "
"being read or written."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:133
msgid ""
"The function B<mpool_new>()  takes an I<MPOOL> pointer and an address as "
"arguments.  If a new page can be allocated, a pointer to the page is "
"returned and the page number is stored into the I<pgnoaddr> address.  "
"Otherwise, NULL is returned and I<errno> is set."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:146
msgid ""
"The function B<mpool_get>()  takes an I<MPOOL> pointer and a page number as "
"arguments.  If the page exists, a pointer to the page is returned.  "
"Otherwise, NULL is returned and I<errno> is set.  The I<flags> argument is "
"not currently used."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:158
msgid ""
"The function B<mpool_put>()  unpins the page referenced by I<pgaddr>.  "
"I<pgaddr> must be an address previously returned by B<mpool_get>()  or "
"B<mpool_new>().  The flag value is specified by ORing any of the following "
"values:"
msgstr ""

#. type: TP
#: build/C/man3/mpool.3:158
#, no-wrap
msgid "B<MPOOL_DIRTY>"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:161
msgid "The page has been modified and needs to be written to the backing file."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:164
msgid "B<mpool_put>()  returns 0 on success and -1 if an error occurs."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:173
msgid ""
"The function B<mpool_sync>()  writes all modified pages associated with the "
"I<MPOOL> pointer to the backing file.  B<mpool_sync>()  returns 0 on success "
"and -1 if an error occurs."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:183
msgid ""
"The B<mpool_close>()  function free's up any allocated memory associated "
"with the memory pool cookie.  Modified pages are B<not> written to the "
"backing file.  B<mpool_close>()  returns 0 on success and -1 if an error "
"occurs."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:190
msgid ""
"The B<mpool_open>()  function may fail and set I<errno> for any of the "
"errors specified for the library routine B<malloc>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:196
msgid "The B<mpool_get>()  function may fail and set I<errno> for the following:"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:199
msgid "The requested record doesn't exist."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:211
msgid ""
"The B<mpool_new>()  and B<mpool_get>()  functions may fail and set I<errno> "
"for any of the errors specified for the library routines B<read>(2), "
"B<write>(2), and B<malloc>(3)."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:218
msgid ""
"The B<mpool_sync>()  function may fail and set I<errno> for any of the "
"errors specified for the library routine B<write>(2)."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:225
msgid ""
"The B<mpool_close>()  function may fail and set I<errno> for any of the "
"errors specified for the library routine B<free>(3)."
msgstr ""

#. type: SH
#: build/C/man3/mpool.3:225
#, no-wrap
msgid "CONFORMING TO"
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:228
msgid "Not in POSIX.1-2001.  Present on the BSDs."
msgstr ""

#. type: Plain text
#: build/C/man3/mpool.3:233
msgid "B<btree>(3), B<dbopen>(3), B<hash>(3), B<recno>(3)"
msgstr ""

#. type: TH
#: build/C/man3/recno.3:34
#, no-wrap
msgid "RECNO"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:38
msgid "recno - record number database access method"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:60
msgid ""
"The routine B<dbopen>(3)  is the library interface to database files.  One "
"of the supported file formats is record number files.  The general "
"description of the database access methods is in B<dbopen>(3), this manual "
"page describes only the recno specific information."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:69
msgid ""
"The record number data structure is either variable or fixed-length records "
"stored in a flat-file format, accessed by the logical record number.  The "
"existence of record number five implies the existence of records one through "
"four, and the deletion of record number one causes record number five to be "
"renumbered to record number four, as well as the cursor, if positioned after "
"record number one, to shift down one record."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:75
msgid ""
"The recno access method specific data structure provided to B<dbopen>(3)  is "
"defined in the I<E<lt>db.hE<gt>> include file as follows:"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:87
#, no-wrap
msgid ""
"typedef struct {\n"
"    unsigned long flags;\n"
"    unsigned int  cachesize;\n"
"    unsigned int  psize;\n"
"    int           lorder;\n"
"    size_t        reclen;\n"
"    unsigned char bval;\n"
"    char         *bfname;\n"
"} RECNOINFO;\n"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:91
msgid "The elements of this structure are defined as follows:"
msgstr ""

#. type: TP
#: build/C/man3/recno.3:91
#, no-wrap
msgid "flags"
msgstr ""

#. type: TP
#: build/C/man3/recno.3:96
#, no-wrap
msgid "B<R_FIXEDLEN>"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:107
msgid ""
"The records are fixed-length, not byte delimited.  The structure element "
"I<reclen> specifies the length of the record, and the structure element "
"I<bval> is used as the pad character.  Any records, inserted into the "
"database, that are less than I<reclen> bytes long are automatically padded."
msgstr ""

#. type: TP
#: build/C/man3/recno.3:107
#, no-wrap
msgid "B<R_NOKEY>"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:120
msgid ""
"In the interface specified by B<dbopen>(3), the sequential record retrieval "
"fills in both the caller's key and data structures.  If the B<R_NOKEY> flag "
"is specified, the I<cursor> routines are not required to fill in the key "
"structure.  This permits applications to retrieve records at the end of "
"files without reading all of the intervening records."
msgstr ""

#. type: TP
#: build/C/man3/recno.3:120
#, no-wrap
msgid "B<R_SNAPSHOT>"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:126
msgid ""
"This flag requires that a snapshot of the file be taken when B<dbopen>(3)  "
"is called, instead of permitting any unmodified records to be read from the "
"original file."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:136
msgid ""
"A suggested maximum size, in bytes, of the memory cache.  This value is "
"B<only> advisory, and the access method will allocate more memory rather "
"than fail.  If I<cachesize> is 0 (no size is specified) a default cache is "
"used."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:148
msgid ""
"The recno access method stores the in-memory copies of its records in a "
"btree.  This value is the size (in bytes) of the pages used for nodes in "
"that tree.  If I<psize> is 0 (no page size is specified) a page size is "
"chosen based on the underlying file system I/O block size.  See B<btree>(3)  "
"for more information."
msgstr ""

#. type: TP
#: build/C/man3/recno.3:156
#, no-wrap
msgid "I<reclen>"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:159
msgid "The length of a fixed-length record."
msgstr ""

#. type: TP
#: build/C/man3/recno.3:159
#, no-wrap
msgid "I<bval>"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:167
msgid ""
"The delimiting byte to be used to mark the end of a record for "
"variable-length records, and the pad character for fixed-length records.  If "
"no value is specified, newlines (\"\\en\") are used to mark the end of "
"variable-length records and fixed-length records are padded with spaces."
msgstr ""

#. type: TP
#: build/C/man3/recno.3:167
#, no-wrap
msgid "I<bfname>"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:177
msgid ""
"The recno access method stores the in-memory copies of its records in a "
"btree.  If I<bfname> is non-NULL, it specifies the name of the btree file, "
"as if specified as the filename for a B<dbopen>(3)  of a btree file."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:195
msgid ""
"The data part of the key/data pair used by the I<recno> access method is the "
"same as other access methods.  The key is different.  The I<data> field of "
"the key should be a pointer to a memory location of type I<recno_t>, as "
"defined in th I<E<lt>db.hE<gt>> include file.  This type is normally the "
"largest unsigned integral type available to the implementation.  The I<size> "
"field of the key should be the size of that type."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:200
msgid ""
"Because there can be no metadata associated with the underlying recno access "
"method files, any changes made to the default values (e.g., fixed record "
"length or byte separator value) must be explicitly specified each time the "
"file is opened."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:208
msgid ""
"In the interface specified by B<dbopen>(3), using the I<put> interface to "
"create a new record will cause the creation of multiple, empty records if "
"the record number is more than one greater than the largest record currently "
"in the database."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:216
msgid ""
"The I<recno> access method routines may fail and set I<errno> for any of the "
"errors specified for the library routine B<dbopen>(3)  or the following:"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:220
msgid ""
"An attempt was made to add a record to a fixed-length database that was too "
"large to fit."
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:227
msgid "B<btree>(3), B<dbopen>(3), B<hash>(3), B<mpool>(3)"
msgstr ""

#. type: Plain text
#: build/C/man3/recno.3:231
msgid ""
"I<Document Processing in a Relational Database System>, Michael Stonebraker, "
"Heidi Stettner, Joseph Kalash, Antonin Guttman, Nadene Lynn, Memorandum "
"No. UCB/ERL M82/32, May 1982."
msgstr ""
