updatedb - generate locate pathname database

updatedb generates the locate pathname database that is used by locate(1), find(1), and tw(1). Sufficient privilege is required to change the system locate database.

This implemenation is a script that generates a tw(1) command that does all the work.

-a, --auto-home

Include the nis(1) auto.home auto mounter home directories in /home. NOTE: this causes the home directories to be mounted and may swamp the mount table.

-d, --directory|localpaths="dir1 dir2 ..."

Local directories to include in the database. If the first dir is + then the default list is appended. The default value is /.

-i, --ignore-errors

Omit inaccessible files and directory error messages.

-k, --keep="dir1 dir2 ..."

Directories to retain in the database; used to override --nocrossdevice. If any of the paths are symbolic links then they are followed. If the first dir is + then the default list is appended. The default value is /home /usr/local /usr/common.

-l, --local

Do not descend into non-local filesystem directories.

-r, --netpaths="dir1 dir2 ..."

Network directories to include in the database. Currently equivalent to --localpaths.

-p, --prunepaths|drop="dir1 dir2 ..."

Directories to exclude from the database. If the first dir is + then the default list is appended. The default value is /afs /backup /dev /proc /tmp /usr/tmp /var/tmp.

-o, --output|codes=dbfile

The path of the generated database. The default value is lib/find/codes .

-P, --public

Omit files that are not publicly readable and directories that are not publicly searchable.

-u, --user|netuser=user

The user id used to search directories.

-m, --dir-format

Generate a database similar to --gnu-format, except that directories are marked for efficient implementations of find(1) and tw(1). This is the default database format.

-g, --gnu-format

Generate a machine independent gnu locate(1) compatible database.

-O, --old-format

Generate a database compatible with the obsolete fastfind(1). This format has a machine dependent encoding.

-D, --depth=level

Limit the directory traversal depth to level.

-X, --crossdevice

Retain subdirectories that cross device boundaries. On by default; -X means --nocrossdevice.

-n, --show

Show the underlying the tw(1) command but do not execute.

lib/find/codes

Default locate database on $PATH.

If you run updatedb as root then protected directory contents may be visible to everyone via the database. Use the --public option to limit the database to publically visible files and directories.

locate(1), fastfind(1), find(1), nis(1), tw(1)

version

updatedb (AT&T Labs Research) 2003-11-14

author

Glenn Fowler <gsf@research.att.com >

copyright

Copyright © 1989-2012 AT&T Intellectual Property

license

http://www.eclipse.org/org/documents/epl-v10.html