Software: mlocate Version: 0.26 File: doc/mlocate.db.5 Patch: Yes Warnings from "groff -b -ww -mandoc -z ...": :33: warning: can't find font `SM' :56: warning: can't find font `b' Space at end of lines removed. # Output from "nroff" should (usually) have only the left margin adjusted (".ad l"). Otherwise the space between words can be too long. Output for a manual should (usually) have the right margin ragged (".ad l"), as it is not (usually) intended for a book or other professional printing medium. # Sometimes a small change in space between a roman and an italic character is needed (use ".RI" or ".IR" macros). # Remove spaces at end of lines. # Patch: --- mlocate.db.5 2012-08-29 19:17:53.000000000 +0000 +++ mlocate.db.5.new 2012-10-20 21:45:29.092616029 +0000 @@ -7,8 +7,8 @@ .\" GNU General Public License v.2. .\" .\" This program is distributed in the hope that it will be useful, but WITHOUT -.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or -.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for +.\" ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or +.\" FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for .\" more details. .\" .\" You should have received a copy of the GNU General Public License along @@ -30,7 +30,9 @@ 1 byte for file format version (\fB0\fR), 1 byte for the \*(lqrequire visibility\*(rq flag (\fB0\fR or \fB1\fR), 2 bytes padding, -and a \f(SMNUL\fR-terminated path name of the root of the database. +and a +.SM NUL\c +-terminated path name of the root of the database. The header is followed by a \fIconfiguration block\fR, included to ensure databases are not reused @@ -39,10 +41,13 @@ The size of the configuration block in bytes is stored in the file header. The configuration block is a sequence of \fIvariable assignments\fR, ordered by variable name. -Each +Each .I variable assignment -consists of a \f(SMNUL\fR-terminated variable name -and an ordered list of \f(SMNUL\fR-terminated values. +consists of a +.SM NUL\c +-terminated variable name and an ordered list of +.SM NUL\c +-terminated values. The value list is terminated by one more .SM NUL character. @@ -53,7 +58,7 @@ Currently defined variables are: .TP \fBprune_bind_mounts\fR -A single entry, the value of \fbPRUNE_BIND_MOUNTS\fR; one of the strings +A single entry, the value of \fBPRUNE_BIND_MOUNTS\fR; one of the strings .B 0 or \fB1\fR. @@ -77,7 +82,9 @@ .I directory time (nanoseconds) in big endian (0 if unknown, less than 1,000,000,000), 4 bytes padding, -and a \f(SMNUL\fR-terminated path name of the the directory. +and a +.SM NUL\c +-terminated path name of the the directory. Directory contents, a sequence of .I file entries sorted by name, follow. @@ -89,7 +96,7 @@ .B st_mtime of the directory. .BR updatedb (8) -uses the original data if the +uses the original data if the .I directory time in the database and in the file system match exactly. .I Directory time @@ -103,12 +110,16 @@ .TP \fB0\fR A non-directory file. -Followed by a \f(SMNUL\fR-terminated file (not path) name. +Followed by a +.SM NUL\c +-terminated file (not path) name. .TP \fB1\fR A subdirectory. -Followed by a \f(SMNUL\fR-terminated file (not path) name. +Followed by a +.SM NUL\c +-terminated file (not path) name. .TP \fB2\fR