diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-15 19:43:11 +0000 |
commit | fc22b3d6507c6745911b9dfcc68f1e665ae13dbc (patch) | |
tree | ce1e3bce06471410239a6f41282e328770aa404a /templates/man3/dbopen.3.pot | |
parent | Initial commit. (diff) | |
download | manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.tar.xz manpages-l10n-fc22b3d6507c6745911b9dfcc68f1e665ae13dbc.zip |
Adding upstream version 4.22.0.upstream/4.22.0
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'templates/man3/dbopen.3.pot')
-rw-r--r-- | templates/man3/dbopen.3.pot | 853 |
1 files changed, 853 insertions, 0 deletions
diff --git a/templates/man3/dbopen.3.pot b/templates/man3/dbopen.3.pot new file mode 100644 index 00000000..4201cd8c --- /dev/null +++ b/templates/man3/dbopen.3.pot @@ -0,0 +1,853 @@ +# 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: 2024-03-01 16:54+0100\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=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "dbopen" +msgstr "" + +#. type: TH +#: archlinux mageia-cauldron +#, no-wrap +msgid "2023-10-31" +msgstr "" + +#. type: TH +#: archlinux mageia-cauldron +#, no-wrap +msgid "Linux man-pages 6.06" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "dbopen - database access methods" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "LIBRARY" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "Standard C library (I<libc>, I<-lc>)" +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, 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" +"B<#include E<lt>fcntl.hE<gt>>\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, 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: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"I<Note well>: This page documents interfaces provided up until glibc 2.1. " +"Since glibc 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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, 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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<type>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The type of the underlying access method (and file format)." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<close>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<del>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "A pointer to a routine to remove key/data pairs from the database." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The argument I<flag> may be set to the following value:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_CURSOR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"Delete the record referenced by the cursor. The cursor must have previously " +"been initialized." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<fd>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<get>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<put>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "A pointer to a routine to store key/data pairs in the database." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The argument I<flag> may be set to one of the following values:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"Replace the key/data pair referenced by the cursor. The cursor must have " +"previously been initialized." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_IAFTER>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_IBEFORE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_NOOVERWRITE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "Enter the new key/data pair only if the key does not previously exist." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_SETCURSOR>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 true only if the keys are ordered and independent, record " +"numbers for example." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<seq>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The flag value B<must> be set to one of the following values:" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_FIRST>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"The first key/data pair of the database is returned, and the cursor is set " +"or initialized to reference it." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_LAST>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_NEXT>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_PREV>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<sync>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The flag value may be set to the following value:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<R_RECNOSYNC>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"I<sync> routines return -1 on error (setting I<errno>) and 0 on success." +msgstr "" + +#. type: SS +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "Key/data pairs" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "" +"typedef struct {\n" +" void *data;\n" +" size_t size;\n" +"} DBT;\n" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The elements of the I<DBT> structure are defined as follows:" +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<data>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "A pointer to a byte string." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "I<size>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "The length of the byte string." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "ERRORS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<EFTYPE>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "A file is incorrectly formatted." +msgstr "" + +#. type: TP +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "B<EINVAL>" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"The I<fd> routines will fail and set I<errno> to B<ENOENT> for in memory " +"databases." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "BUGS" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +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 +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"The file descriptor interface is a kludge and will be deleted in a future " +"version of the interface." +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"None of the access methods provide any form of concurrent access, locking, " +"or transactions." +msgstr "" + +#. type: SH +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "B<btree>(3), B<hash>(3), B<mpool>(3), B<recno>(3)" +msgstr "" + +#. type: Plain text +#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6 +#: opensuse-tumbleweed +msgid "" +"I<LIBTP: Portable, Modular Transactions for UNIX>, Margo Seltzer, Michael " +"Olson, USENIX proceedings, Winter 1992." +msgstr "" + +#. type: TH +#: debian-bookworm debian-unstable opensuse-leap-15-6 opensuse-tumbleweed +#, no-wrap +msgid "2022-12-04" +msgstr "" + +#. type: TH +#: debian-bookworm +#, no-wrap +msgid "Linux man-pages 6.03" +msgstr "" + +#. type: TH +#: debian-unstable opensuse-tumbleweed +#, no-wrap +msgid "Linux man-pages 6.05.01" +msgstr "" + +#. type: TH +#: opensuse-leap-15-6 +#, no-wrap +msgid "Linux man-pages 6.04" +msgstr "" |