locate

NAME

SYNOPSIS

locate -c ( database | @group )

locate [ -r ] [ database | @group ] search

AVAILABILITY

DESCRIPTION

When the file search is started as GUI, always all available databases are searched, when started from the command line, the database or @group to search can be optionally specified.

To enable to find files, it is needed to frequently update the locate databases which contain the list of files.

To frequently update the database the wscheduler(1) command or a login script can be used for example.

See also NOTES section.

OPTIONS

-h

usage message.

-i

install the locate command to the 'Desktop' which allows searching files in all databases.

-u

uninstall the locate shortcut from the 'Desktop'.

-V

print locate version.

-l

list existing and searchable databases of locate in var/db/locate/.

-L

list all defined DATABASEs and @GROUPs in the configuration file.

-c

create/update databases that are used to query and find files.

The DRIVES database automatically contains all logical drives found on the system as returned by the drives(1) command in the console(1m).

-r

print relative path names in search result (default is to print absolute path names).

database

database name where to search file(s). If no database is given, all databases will be searched.

@group

group of databases as defined in the configuration file etc/locate.cfg.

The @ALL group always contains all defined DATABASE entries from the configuration file and can be used to create/update all databases at once (calling locate -c @ALL in wscheduler(1) for example).

search

file search query.

ENVIRONMENT

EXIT STATUS

0

no error.

1

database or @group not defined in the configuration file.

4

usage message displayed.

5

version message displayed.

FILES

var/db/locate/DATABASE.locdb

database file that contain the file list that are searched / created by locate.

etc/locate.cfg

configuration file to define the databases in the form:

  DATABASE="d:\dir\sub dir" e:\dir1 LABEL:\dir2

whereas the drives can also be defined as labels (see: lpath(3)) and any environment variable as well as the %INSTALLDIR% and %INSTALLDRIVE% variables can be used

and groups in the form:

  @GROUP=DATABASE1 DATABASE2 DATABASEN

Note that a DATABASE and @GROUP needs to be specified left aligned in upper case. However, on the commandline the names are not case sensitive.

EXAMPLES

SEE ALSO

NOTES

BUGS

AUTHOR

COPYRIGHT

This is free software; see WA2LWinTools/man/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.