Adding upstream version 4.22.0.upstream/4.22.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 453 insertions, 0 deletions

diff --git a/templates/man3/btree.3.pot b/templates/man3/btree.3.pot
new file mode 100644
index 00000000..1a4dad45
--- /dev/null
+++ b/templates/man3/btree.3.pot
@@ -0,0 +1,453 @@
+# 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:53+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 "btree"
+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 ""
+
+#. .UC 7
+#. 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 "btree - btree database access method"
+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"
+"#include E<lt>db.hE<gt>>\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 ""
+"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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"The btree data structure is a sorted, balanced tree structure storing "
+"associated key/data pairs."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, 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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "The elements of this structure are as follows:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<flags>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid "The flag value is specified by ORing any of the following values:"
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "B<R_DUP>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<cachesize>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, 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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"The maximum number of keys which will be stored on any single page.  Not "
+"currently implemented."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<minkeypage>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<psize>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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 64\\ KiB.  "
+"If I<psize> is 0 (no page size is specified), a page size is chosen based on "
+"the underlying filesystem I/O block size."
+msgstr ""
+
+#. type: TP
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<compare>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<prefix>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+#, no-wrap
+msgid "I<lorder>"
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"Forward sequential scans of a tree are from the least key to the greatest."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+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
+#: 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 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
+#: 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 "Only big and little endian byte order is supported."
+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<dbopen>(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<The Ubiquitous B-tree>, Douglas Comer, ACM Comput. Surv. 11, 2 (June "
+"1979), 121-138."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"I<Prefix B-trees>, Bayer and Unterauer, ACM Transactions on Database "
+"Systems, Vol. 2, 1 (March 1977), 11-26."
+msgstr ""
+
+#. type: Plain text
+#: archlinux debian-bookworm debian-unstable mageia-cauldron opensuse-leap-15-6
+#: opensuse-tumbleweed
+msgid ""
+"I<The Art of Computer Programming Vol. 3: Sorting and Searching>, D.E. "
+"Knuth, 1968, pp 471-480."
+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 ""