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 maintanance
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\&.
36 Dump CNID database\&. With
37 \fB\-i \fRdump indexes too\&.
52 Compare CNIDs in database with volume
63 Test if \&.AppleDouble directories exist
74 Test if AppleDouble files exist
85 Report orphaned AppleDouble files
96 Report directories inside \&.AppleDouble directories
107 Check name encoding by roundtripping, log on error
118 Check for orphaned CNIDs in database (requires
130 Open and close adouble files
137 Don\'t check \&.AppleDouble stuff, only check orphaned\&.
139 Don\'t open CNID database, skip CNID checks, only traverse filesystem
145 Rebuild volume\&. With
147 wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
157 Sync CNIDSs from database with volume
168 Ensure \&.AppleDouble directories exist
179 Ensure AppleDouble files exist
190 Delete orphaned AppleDouble files
201 Report directories inside \&.AppleDouble directories
212 Check name encoding by roundtripping, log on error
223 Delete orphaned CNIDs in database (requires
235 Open and close adouble files
242 Don\'t create \&.AppleDouble stuff, only cleanup orphaned\&.
245 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
256 Before installing an upgraded version of Netatalk that is linked against a newer BerkeleyDB lib, run `dbd \-u \&.\&.\&.` from the OLD Netatalk pior to upgrading on all volumes\&. This removes the BerkleyDB environment\&. On exit cnid_dbd does this automatically, so normally calling dbd \-u should not be necessary !
262 Only work on inactive volumes and lock them (exclusive)
267 Rebuild indexes (just for completeness, mostly useless!)
276 In order to be able to run
278 reconstructing the CNIDs in the database from the
280 files, make sure you\'ve run a
282 rebuild sometimes before, where the CNIDs then would have been synched between database and
286 Also be careful about the option
287 \fBnocnidcache\fR\&. Avoid this option if at all possible, because if prevents you from being able to use
289 .SH "CNID BACKGROUND"
291 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\&.
293 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\&.