# SOME DESCRIPTIVE TITLE # Copyright (C) YEAR Free Software Foundation, Inc. # This file is distributed under the same license as the PACKAGE package. # FIRST AUTHOR , YEAR. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: PACKAGE VERSION\n" "POT-Creation-Date: 2023-06-27 19:35+0200\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" "Language: \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: debian-bookworm debian-unstable #, no-wrap msgid "LOCATEDB" msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "locatedb - front-compressed file name database" msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "This manual page documents the format of file name databases for the GNU " "version of B. The file name databases contain lists of files that " "were in particular directory trees when the databases were last updated." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "There can be multiple databases. Users can select which databases B " "searches using an environment variable or command line option; see " "B(1). The system administrator can choose the file name of the " "default database, the frequency with which the databases are updated, and " "the directories for which they contain entries. Normally, file name " "databases are updated by running the B program periodically, " "typically nightly; see B(1)." msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "GNU LOCATE02 database format" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "This is the default format of databases produced by B. The " "B program runs B to compress the list of file names using " "front-compression, which reduces the database size by a factor of 4 to 5. " "Front-compression (also known as incremental encoding) works as follows." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "The database entries are a sorted list (case-insensitively, for users' " "convenience). Since the list is sorted, each entry is likely to share a " "prefix (initial string) with the previous entry. Each database entry begins " "with an signed offset-differential count byte, which is the additional " "number of characters of prefix of the preceding entry to use beyond the " "number that the preceding entry is using of its predecessor. (The counts " "can be negative.) Following the count is a null-terminated ASCII remainder " "\\(em the part of the name that follows the shared prefix." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "If the offset-differential count is larger than can be stored in a signed " "byte (\\(+-127), the byte has the value 0x80 (binary 10000000) and the " "actual count follows in a 2-byte word, with the high byte first (network " "byte order). This count can also be negative (the sign bit being in the " "first of the two bytes)." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Every database begins with a dummy entry for a file called `LOCATE02', which " "B checks for to ensure that the database file has the correct " "format; it ignores the entry in doing the search." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Databases cannot be concatenated together, even if the first (dummy) entry " "is trimmed from all but the first database. This is because the offset-" "differential count in the first entry of the second and following databases " "will be wrong." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "In the future, the data within the locate database may not be sorted in any " "particular order. To obtain sorted results, pipe the output of B " "through B." msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "slocate database format" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "The B program uses a database format similar to, but not quite the " "same as, GNU B. The first byte of the database specifies its " "I I. If the security level is 0, B will read, " "match and print filenames on the basis of the information in the database " "only. However, if the security level byte is 1, B omits entries " "from its output if the invoking user is unable to access them. The second " "byte of the database is zero. The second byte is followed by the first " "database entry. The first entry in the database is not preceded by any " "differential count or dummy entry. Instead the differential count for the " "first item is assumed to be zero." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Starting with the second entry (if any) in the database, data is interpreted " "as for the GNU LOCATE02 format." msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "Old Locate Database format" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "There is also an old database format, used by Unix B and B " "programs and earlier releases of the GNU ones. B runs programs " "called B and B to produce old-format databases. The old " "format differs from the above description in the following ways. Instead of " "each entry starting with an offset-differential count byte and ending with a " "null, byte values from 0 through 28 indicate offset-differential counts from " "-14 through 14. The byte value indicating that a long offset-differential " "count follows is 0x1e (30), not 0x80. The long counts are stored in host " "byte order, which is not necessarily network byte order, and host integer " "word size, which is usually 4 bytes. They also represent a count 14 less " "than their value. The database lines have no termination byte; the start of " "the next line is indicated by its first byte having a value \\(E= 30." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "In addition, instead of starting with a dummy entry, the old database format " "starts with a 256 byte table containing the 128 most common bigrams in the " "file list. A bigram is a pair of adjacent bytes. Bytes in the database " "that have the high bit set are indexes (with the high bit cleared) into the " "bigram table. The bigram and offset-differential count coding makes these " "databases 20\\(en25% smaller than the new format, but makes them not 8-bit " "clean. Any byte in a file name that is in the ranges used for the special " "codes is replaced in the database by a question mark, which not " "coincidentally is the shell wildcard to match a single character." msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "EXAMPLE" msgstr "" #. with nulls changed to newlines: #. type: Plain text #: debian-bookworm debian-unstable #, no-wrap msgid "" "Input to B:\n" "/usr/src\n" "/usr/src/cmd/aardvark.c\n" "/usr/src/cmd/armadillo.c\n" "/usr/tmp/zoo\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable #, no-wrap msgid "" "Length of the longest prefix of the preceding entry to share:\n" "0 /usr/src\n" "8 /cmd/aardvark.c\n" "14 rmadillo.c\n" "5 tmp/zoo\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Output from B, with trailing nulls changed to newlines and count " "bytes made printable:" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable #, no-wrap msgid "" "0 LOCATE02\n" "0 /usr/src\n" "8 /cmd/aardvark.c\n" "6 rmadillo.c\n" "-9 tmp/zoo\n" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable #, no-wrap msgid "(6 = 14 - 8, and -9 = 5 - 14)\n" msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "REPORTING BUGS" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "GNU findutils online help: Ehttps://www.gnu.org/software/findutils/#get-" "helpE" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Report any translation bugs to Ehttps://translationproject.org/team/E" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "Report any other issue via the form at the GNU Savannah bug tracker:" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "Ehttps://savannah.gnu.org/bugs/?group=findutilsE" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "General topics about the GNU findutils package are discussed at the I mailing list:" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "Ehttps://lists.gnu.org/mailman/listinfo/bug-findutilsE" msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "COPYRIGHT" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Copyright \\(co 1994-2022 Free Software Foundation, Inc. License GPLv3+: " "GNU GPL version 3 or later Ehttps://gnu.org/licenses/gpl.htmlE." msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "This is free software: you are free to change and redistribute it. There is " "NO WARRANTY, to the extent permitted by law." msgstr "" #. type: SH #: debian-bookworm debian-unstable #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "B(1), B(1), B(1), B(5)" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "" "Full documentation Ehttps://www.gnu.org/software/findutils/locatedbE" msgstr "" #. type: Plain text #: debian-bookworm debian-unstable msgid "or available locally via: B" msgstr ""