← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/findutils/gutsy-proposed

« back to all changes in this revision

Viewing changes to locate/updatedb.1

  • Committer: Bazaar Package Importer
  • Author(s): Andreas Metzler
  • Date: 2005-07-04 11:37:37 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20050704113737-ll89ui8be35r0pir
Tags: 4.2.22-2
http://bugs.debian.org/315343
http://bugs.debian.org/315136
* Remove locatedb on purge. (Closes: #315343)
* revert regex-syntax back to emacs-re. (Closes: #315136) Future versions
  will allow to select this by commandline parameter.

Show diffs side-by-side

added added

removed removed

Lines of Context:
locate/updatedb.1
1
 
.TH UPDATEDB 1L \" -*- nroff -*-
 
1
.TH UPDATEDB 1 \" -*- nroff -*-
2
2
.SH NAME
3
3
updatedb \- update a file name database
4
4
.SH SYNOPSIS
23
23
is then run for each filesystem on the fileserver where that
24
24
filesystem is on a local disk, to prevent thrashing the network.
25
25
Users can select which databases \fBlocate\fP searches using an
26
 
environment variable or command line option; see \fBlocate\fP(1L).
 
26
environment variable or command line option; see \fBlocate\fP(1).
27
27
Databases can not be concatenated together.
28
28
.P
29
29
The file name database format changed starting with GNU
30
30
.B find
31
31
and
32
32
.B locate
33
 
version 4.0 to allow machines with diffent byte orderings to share
 
33
version 4.0 to allow machines with different byte orderings to share
34
34
the databases.  The new GNU
35
35
.B locate
36
36
can read both the old and new database formats.
41
41
produce incorrect results if given a new-format database.
42
42
.SH OPTIONS
43
43
.TP
 
44
.B \-\-findoptions='\fI\-option1 \-option2...\fP'
 
45
Global options to pass on to \fBfind\fP.
 
46
The environment variable \fBFINDOPTIONS\fP also sets this value.
 
47
Default is none.
 
48
.TP
44
49
.B \-\-localpaths='\fIpath1 path2...\fP'
45
50
Non-network directories to put in the database.
46
51
Default is /.
67
72
.B \-\-output=\fIdbfile\fP
68
73
The database file to build.
69
74
Default is system-dependent.  In Debian GNU/Linux, the default
70
 
is /var/lib/locate/locatedb.
 
75
is /var/cache/locate/locatedb.
71
76
.TP
72
77
.B \-\-localuser=\fIuser\fP
73
78
The user to search non-network directories as, using \fBsu\fP(1).
92
97
.B updatedb
93
98
and exit.
94
99
.SH "SEE ALSO"
95
 
\fBfind\fP(1L), \fBlocate\fP(1L), \fBlocatedb\fP(5L), \fBxargs\fP(1L)
 
100
\fBfind\fP(1), \fBlocate\fP(1), \fBlocatedb\fP(5), \fBxargs\fP(1)
96
101
\fBFinding Files\fP (on-line in Info, or printed)
 
102
.SH "BUGS"
 
103
.P
 
104
The 
 
105
.B updatedb
 
106
program correctly handles filenames containing newlines,
 
107
but only if the system's sort command has a working
 
108
.I \-z
 
109
option.  If you suspect that 
 
110
.B locate
 
111
may need to return filenames containing newlines, consider using its
 
112
.I \-\-null 
 
113
option.
 
114
.P
 
115
The best way to report a bug is to use the form at
 
116
http://savannah.gnu.org/bugs/?group=findutils.  
 
117
The reason for this is that you will then be able to track progress in
 
118
fixing the problem.   Other comments about \fBupdatedb\fP(1) and about
 
119
the findutils package in general can be sent to the 
 
120
.I bug-findutils
 
121
mailing list.  To join the list, send email to 
 
122
.IR bug-findutils-request@gnu.org .