3 .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4 .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
6 .\" Manual: Netatalk 2.2
7 .\" Source: Netatalk 2.2
10 .TH "DBD" "1" "12 Oct 2010" "Netatalk 2.2" "Netatalk 2.2"
11 .\" -----------------------------------------------------------------
12 .\" * set default formatting
13 .\" -----------------------------------------------------------------
14 .\" disable hyphenation
16 .\" disable justification (adjust text to left margin only)
18 .\" -----------------------------------------------------------------
19 .\" * MAIN CONTENT STARTS HERE *
20 .\" -----------------------------------------------------------------
22 dbd \- CNID database maintenance
24 .HP \w'\fBdbd\fR\fB\fR\ 'u
25 \fBdbd\fR\fB\fR [\-evx] {\-d\ [\-i] | \-s\ [\-c|\-n] | \-r\ [\-c|\-f] | \-u} \fIvolumepath\fR
29 can dump, scan, reindex and rebuild
31 dbd CNID databases\&. It must be run with appropiate permissions i\&.e\&. as root\&.
34 can be run on active volumes, but
35 \fBdbd \-rf\fR, which wipes the db before rebuilding it, checks and enforces that the chosen volume is not in use\&.
40 Dump CNID database\&. With
41 \fB\-i \fRdump indexes too\&.
56 Compare CNIDs in database with volume
67 Test if \&.AppleDouble directories exist
78 Test if AppleDouble files exist
89 Report orphaned AppleDouble files
100 Report directories inside \&.AppleDouble directories
111 Check name encoding by roundtripping, log on error
122 Check for orphaned CNIDs in database (requires
134 Open and close adouble files
141 Don\'t check \&.AppleDouble stuff, only check orphaned\&.
143 Don\'t open CNID database, skip CNID checks, only traverse filesystem
149 Rebuild volume\&. With
151 wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
161 Sync CNIDSs from database with volume
172 Ensure \&.AppleDouble directories exist
183 Ensure AppleDouble files exist
194 Delete orphaned AppleDouble files
205 Report directories inside \&.AppleDouble directories
216 Check name encoding by roundtripping, log on error
227 Delete orphaned CNIDs in database (requires
239 Open and close adouble files
246 Don\'t create \&.AppleDouble stuff, only cleanup orphaned\&.
249 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
260 Opens the database which triggers any necessary upgrades, then closes and exits\&.
266 Only work on inactive volumes and lock them (exclusive)
271 Rebuild indexes (just for completeness, mostly useless!)
280 In order to be able to run
282 reconstructing the CNIDs in the database from the
284 files, make sure you\'ve run a
286 rebuild sometimes before, where the CNIDs then would have been synched between database and
290 Also be careful about the option
291 \fBnocnidcache\fR\&. Avoid this option if at all possible, because if prevents you from being able to use
293 .SH "CNID BACKGROUND"
295 The CNID backends maintains name to ID mappings\&. If you change a filename outside afpd(8) (shell, samba), the CNID db will not know and not reflect that change\&. Netatalk tries to recover from such inconsistencies as gracefully as possible\&. The mechanisms to resolve such inconsistencies may fail sometimes, though, as this is not an easy task to accomplish\&. E\&.g\&. if several names in the path to the file or directory have changed, things may go wrong\&.
297 If you change a lot of filenames at once, chances are higher that the afpds fallback mechanisms fail, i\&.e\&. files will be assigned new IDs, even though the file hasn\'t changed\&.