


LOCATE(1L)                                             LOCATE(1L)


NNAAMMEE
       locate - list files in databases that match a pattern

SSYYNNOOPPSSIISS
       llooccaattee  [-d  path]  [--database=path] [--version] [--help]
       pattern...

DDEESSCCRRIIPPTTIIOONN
       This manual page documents the GNU version of llooccaattee.  For
       each  given pattern, llooccaattee searches one or more databases
       of file names and displays the file names that contain the
       pattern.  Patterns can contain shell-style metacharacters:
       `*', `?', and `[]'.  The metacharacters do not  treat  `/'
       or  `.'   specially.   Therefore,  a pattern `foo*bar' can
       match a file name that contains `foo3/bar', and a  pattern
       `*duck*'   can   match   a   file   name   that   contains
       `lake/.ducky'.   Patterns  that   contain   metacharacters
       should  be  quoted  to  protect them from expansion by the
       shell.

       If a pattern is a plain string -- it contains no metachar-
       acters  --  llooccaattee displays all file names in the database
       that contain that string anywhere.  If a pattern does con-
       tain  metacharacters, llooccaattee only displays file names that
       match the pattern exactly.  As  a  result,  patterns  that
       contain  metacharacters  should  usually begin with a `*',
       and will most often end with one as well.  The  exceptions
       are  patterns  that  are  intended to explicitly match the
       beginning or end of a file name.

       The file name databases contain lists of files  that  were
       on  the  system when the databases were last updated.  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; see uuppddaatteeddbb(1L).

OOPPTTIIOONNSS
       _-_d _p_a_t_h_, _-_-_d_a_t_a_b_a_s_e_=_p_a_t_h
              Instead   of   searching   the  default  file  name
              database, search the file name databases  in  _p_a_t_h,
              which  is  a  colon-separated list of database file
              names.  You can also use the  environment  variable
              LLOOCCAATTEE__PPAATTHH  to  set  the list of database files to
              search.  The option overrides the environment vari-
              able if both are used.

       The  file  name  database format changed starting with GNU
       ffiinndd and llooccaattee version 4.0 to allow machines with diffent
       byte  orderings  to  share the databases.  This version of
       llooccaattee can automatically recognize and read databases pro-
       duced for older versions of GNU llooccaattee or Unix versions of
       llooccaattee or ffiinndd.




                                                                1





LOCATE(1L)                                             LOCATE(1L)


       _-_-_h_e_l_p Print a summary of the options to llooccaattee and  exit.

       _-_-_v_e_r_s_i_o_n
              Print the version number of llooccaattee and exit.

EENNVVIIRROONNMMEENNTT
       LLOOCCAATTEE__PPAATTHH
              Colon-separated list of databases to search.

SSEEEE AALLSSOO
       ffiinndd(1L),  llooccaatteeddbb(5L),  uuppddaatteeddbb(1L),  xxaarrggss(1L) FFiinnddiinngg
       FFiilleess (on-line in Info, or printed)













































                                                                2


