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.1
7 .\" Source: Netatalk 2.1
10 .TH "DBD" "1" "23 Dec 2009" "Netatalk 2.1" "Netatalk 2.1"
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\&.
140 Don\'t open CNID database, skip CNID checks, only traverse filesystem
146 Rebuild volume\&. With
148 wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
158 Sync CNIDSs from database with volume
169 Ensure \&.AppleDouble directories exist
180 Ensure AppleDouble files exist
191 Delete orphaned AppleDouble files
202 Report directories inside \&.AppleDouble directories
213 Check name encoding by roundtripping, log on error
224 Delete orphaned CNIDs in database (requires
236 Open and close adouble files
243 Don\'t create \&.AppleDouble stuff, only cleanup orphaned\&.
246 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
257 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 !
263 Only work on inactive volumes and lock them (exclusive)
268 Rebuild indexes (just for completeness, mostly useless!)
277 In order to be able to run
279 reconstructing the CNIDs in the database from the
281 files, make sure you\'ve run a
283 rebuild sometimes before, where the CNIDs then would have been synched between database and
287 Also be careful about the option
288 \fBnocnidcache\fR\&. Avoid this option if at all possible, because if prevents you from being able to use
290 .SH "CNID BACKGROUND"
292 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\&.
294 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\&.