Penguin
Recent Changes
Annotated edit history of updatedb(1) version 1, including all changes. View license author blame.
Rev Author # Line
1 perry 1 UPDATEDB
2 !!!UPDATEDB
3 NAME
4 SYNOPSIS
5 DESCRIPTION
6 OPTIONS
7 SEE ALSO
8 ----
9 !!NAME
10
11
12 updatedb - update a file name database
13 !!SYNOPSIS
14
15
16 __updatedb [[__''options''__]__
17 !!DESCRIPTION
18
19
20 This manual page documents the GNU version of
21 __updatedb__, which updates file name databases used by
22 GNU __locate__. The file name databases contain lists of
23 files that were in particular directory trees when the
24 databases were last updated. The file name of the default
25 database is determined when __locate__ and
26 __updatedb__ are configured and installed. The frequency
27 with which the databases are updated and the directories for
28 which they contain entries depend on how often
29 __updatedb__ is run, and with which
30 arguments.
31
32
33 In networked environments, it often makes sense to build a
34 database at the root of each filesystem, containing the
35 entries for that filesystem. __updatedb__ is then run for
36 each filesystem on the fileserver where that filesystem is
37 on a local disk, to prevent thrashing the network. Users can
38 select which databases __locate__ searches using an
39 environment variable or command line option; see
40 __locate__(1L). Databases can not be concatenated
41 together.
42
43
44 The file name database format changed starting with GNU
45 __find__ and __locate__ version 4.0 to allow machines
46 with diffent byte orderings to share the databases. The new
47 GNU __locate__ can read both the old and new database
48 formats. However, old versions of __locate__ and
49 __find__ produce incorrect results if given a new-format
50 database.
51 !!OPTIONS
52
53
54 __--localpaths='__''path1
55 path2...''__'__
56
57
58 Non-network directories to put in the database. Default is
59 /.
60
61
62 __--netpaths='__''path1
63 path2...''__'__
64
65
66 Network (NFS, AFS, RFS, etc.) directories to put in the
67 database. The environment variable __NETPATHS__ also sets
68 this value. Default is none.
69
70
71 __--prunepaths='__''path1
72 path2...''__'__
73
74
75 Directories to not put in the database, which would
76 otherwise be. The environment variable __PRUNEPATHS__
77 also sets this value. Default is /tmp /usr/tmp /var/tmp
78 /afs.
79
80
81 __--prunefs='__''path...''__'__
82
83
84 File systems to not put in the database, which would
85 otherwise be. Note that files are pruned when a file system
86 is reached; Any file system mounted under an undesired file
87 system will be ignored. The environment variable
88 __PRUNEFS__ also sets this value. Default is ''nfs NFS
89 proc''.
90
91
92 __--output=__''dbfile''
93
94
95 The database file to build. Default is system-dependent. In
96 Debian GNU/Linux, the default is
97 /var/lib/locate/locatedb.
98
99
100 __--localuser=__''user''
101
102
103 The user to search non-network directories as, using
104 su(1). Default is to search the non-network
105 directories as the current user. You can also use the
106 environment variable __LOCALUSER__ to set this
107 user.
108
109
110 __--netuser=__''user''
111
112
113 The user to search network directories as, using
114 su(1). Default is __daemon__. You can also use the
115 environment variable __NETUSER__ to set this
116 user.
117
118
119 __--old-format__
120
121
122 Create the database in the old format instead of the new
123 one.
124
125
126 __--version__
127
128
129 Print the version number of __updatedb__ and
130 exit.
131
132
133 ''--help''
134
135
136 Print a summary of the options to __updatedb__ and
137 exit.
138 !!SEE ALSO
139
140
141 __find__(1L), __locate__(1L), __locatedb__(5L),
142 __xargs__(1L) __Finding Files__ (on-line in Info, or
143 printed)
144 ----
This page is a man page (or other imported legacy content). We are unable to automatically determine the license status of this page.