summaryrefslogtreecommitdiffstats
path: root/upstream/fedora-rawhide/man1/locate.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/fedora-rawhide/man1/locate.1')
-rw-r--r--upstream/fedora-rawhide/man1/locate.1270
1 files changed, 0 insertions, 270 deletions
diff --git a/upstream/fedora-rawhide/man1/locate.1 b/upstream/fedora-rawhide/man1/locate.1
deleted file mode 100644
index ef9ccf2d..00000000
--- a/upstream/fedora-rawhide/man1/locate.1
+++ /dev/null
@@ -1,270 +0,0 @@
-.\" A man page for locate(1). -*- nroff -*-
-.\"
-.\" Copyright (C) 2012 Red Hat, Inc. All rights reserved.
-.\"
-.\" This copyrighted material is made available to anyone wishing to use,
-.\" modify, copy, or redistribute it subject to the terms and conditions of the
-.\" 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
-.\" more details.
-.\"
-.\" You should have received a copy of the GNU General Public License along
-.\" with this program; if not, write to the Free Software Foundation, Inc.,
-.\" 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
-.\"
-.\" Author: Miloslav Trmac <mitr@redhat.com>
-.TH locate 1 "Sep 2012" mlocate
-
-.SH NAME
-locate \- find files by name
-
-.SH SYNOPSIS
-
-\fBlocate\fR [\fIOPTION\fR]... \fIPATTERN\fR...
-
-.SH DESCRIPTION
-.B locate
-reads one or more databases prepared by
-.BR updatedb (8)
-and writes file names matching at least one of the \fIPATTERN\fRs to standard
-output, one per line.
-
-If
-.B \-\-regex
-is not specified,
-\fIPATTERN\fRs can contain globbing characters.
-If any
-.I PATTERN
-contains no globbing characters,
-.B locate
-behaves as if the pattern were \fB*\fIPATTERN\fB*\fR.
-
-By default,
-.B locate
-does not check whether files found in database still exist
-(but it does require all parent directories to exist
-if the database was built with \fB\-\-require\-visibility no\fR).
-.B locate
-can never report files created after the most recent update of the relevant
-database.
-
-.SH EXIT STATUS
-.B locate
-exits with status 0 if any match was found or if
-.B locate
-was invoked with one of the \fB\-\-limit 0\fR, \fB\-\-help\fR,
-.B \-\-statistics
-or
-.B \-\-version
-options.
-If no match was found or a fatal error was encountered,
-.B locate
-exits with status 1.
-
-Errors encountered while reading a database are not fatal,
-search continues in other specified databases, if any.
-
-.SH OPTIONS
-.TP
-\fB\-A\fR, \fB\-\-all\fR
-Print only entries that match all \fIPATTERN\fRs
-instead of requiring only one of them to match.
-
-.TP
-\fB\-b\fR, \fB\-\-basename\fR
-Match only the base name against the specified patterns.
-This is the opposite of \fB\-\-wholename\fR.
-
-.TP
-\fB\-c\fR, \fB\-\-count\fR
-Instead of writing file names on standard output,
-write the number of matching entries only.
-
-.TP
-\fB\-d, \fB\-\-database\fR \fIDBPATH\fR
-Replace the default database with \fIDBPATH\fR.
-.I DBPATH
-is a \fB:\fR-separated list of database file names.
-If more than one
-.B \-\-database
-option is specified,
-the resulting path is a concatenation of the separate paths.
-
-An empty database file name is replaced by the default database.
-A database file name
-.B \-
-refers to the standard input.
-Note that a database can be read from the standard input only once.
-
-.TP
-\fB\-e\fR, \fB\-\-existing\fR
-Print only entries that refer to files existing at the time
-.B locate
-is run.
-
-.TP
-\fB\-L\fR, \fB\-\-follow\fR
-When checking whether files exist (if the
-.B \-\-existing
-option is specified),
-follow trailing symbolic links.
-This causes broken symbolic links to be omitted from the output.
-
-This is the default behavior.
-The opposite can be specified using \fB\-\-nofollow\fR.
-
-.TP
-\fB\-h\fR, \fB\-\-help\fR
-Write a summary of the available options to standard output
-and exit successfully.
-
-.TP
-\fB\-i\fR, \fB\-\-ignore\-case\fR
-Ignore case distinctions when matching patterns.
-
-.TP
-\fB\-l\fR, \fB\-\-limit\fR, \fB\-n\fR \fILIMIT\fR
-Exit successfully after finding
-.I LIMIT
-entries.
-If the
-.B \-\-count
-option is specified,
-the resulting count is also limited to \fILIMIT\fR.
-
-.TP
-\fB\-m\fR, \fB\-\-mmap\fR
-Ignored, for compatibility with
-.SM BSD
-and
-.SM GNU
-\fBlocate\fR.
-
-.TP
-\fB\-P\fR, \fB\-\-nofollow\fR, \fB\-H\fR
-When checking whether files exist (if the
-.B \-\-existing
-option is specified),
-do not follow trailing symbolic links.
-This causes broken symbolic links to be reported like other files.
-
-This is the opposite of \fB\-\-follow\fR.
-
-.TP
-\fB\-0\fR, \fB\-\-null\fR
-Separate the entries on output using the
-.SM ASCII NUL
-character instead of
-writing each entry on a separate line.
-This option is designed for interoperability with the
-.B \-\-null
-option of
-.SM GNU
-.BR xargs (1).
-
-.TP
-\fB\-S\fR, \fB\-\-statistics\fR
-Write statistics about each read database to standard output instead of
-searching for files
-and exit successfully.
-
-.TP
-\fB\-q\fR, \fB\-\-quiet\fR
-Write no messages about errors encountered while reading and processing
-databases.
-
-.TP
-\fB\-r\fR, \fB\-\-regexp\fR \fIREGEXP\fR
-Search for a basic regexp \fIREGEXP\fR.
-No \fIPATTERN\fRs are allowed if this option is used,
-but this option can be specified multiple times.
-
-.TP
-\fB\-\-regex\fR
-Interpret all \fIPATTERN\fRs as extended regexps.
-
-.TP
-\fB\-s\fR, \fB\-\-stdio\fR
-Ignored, for compatibility with
-.SM BSD
-and
-.SM GNU
-\fBlocate\fR.
-
-.TP
-\fB\-V\fR, \fB\-\-version\fR
-Write information about the version and license of
-.B locate
-on standard output and exit successfully.
-
-.TP
-\fB\-w\fR, \fB\-\-wholename\fR
-Match only the whole path name against the specified patterns.
-
-This is the default behavior.
-The opposite can be specified using \fB\-\-basename\fR.
-
-.SH EXAMPLES
-To search for a file named exactly
-.I NAME
-(not \fB*\fINAME\fB*\fR), use
-.RS
-.B locate -b
-\fB'\\\fINAME\fB'\fR
-.RE
-Because \fB\\\fR is a globbing character,
-this disables the implicit replacement of
-.I NAME
-by \fB*\fINAME\fB*\fR.
-
-.SH FILES
-.TP
-\fB/var/lib/mlocate/mlocate.db\fR
-The database searched by default.
-
-.SH ENVIRONMENT
-.TP
-\fBLOCATE_PATH\fR
-Path to additional databases,
-added after the default database or the databases specified using the
-.B \-\-database
-option.
-
-.SH NOTES
-The order in which the requested databases are processed is unspecified,
-which allows
-.B locate
-to reorder the database path for security reasons.
-
-.B locate
-attempts to be compatible to
-.B slocate
-(without the options used for creating databases) and
-.SM GNU
-\fBlocate\fR, in that order.
-This is the reason for the impractical default \fB\-\-follow\fR option
-and for the confusing set of \fB\-\-regex\fR and \fB\-\-regexp\fR options.
-
-The short spelling of the \fB\-r\fR option is incompatible to
-.SM GNU
-\fBlocate\fR,
-where it corresponds to the \fB\-\-regex\fR option.
-Use the long option names to avoid confusion.
-
-The
-.B LOCATE_PATH
-environment variable replaces the default database in
-.SM BSD
-and
-.SM GNU
-\fBlocate\fR,
-but it is added to other databases in this implementation and \fBslocate\fR.
-
-.SH AUTHOR
-Miloslav Trmac <mitr@redhat.com>
-
-.SH SEE ALSO
-.BR updatedb (8)