1DBD(1)                           Netatalk 2.1                           DBD(1)
2
3
4

NAME

6       dbd - CNID database maintanance
7

SYNOPSIS

9       dbd [-evx] {-d [-i]  | -s [-c|-n]  | -r [-c|-f]  | -u} volumepath
10

DESCRIPTION

12       dbd can dump, scan, reindex and rebuild Netatalk dbd CNID databases. It
13       must be run with appropiate permissions i.e. as root.
14

COMMANDS

16       -d
17           Dump CNID database. With -i dump indexes too.
18
19       -s
20           Scan volume:
21
22           ·   Compare CNIDs in database with volume
23
24           ·   Test if .AppleDouble directories exist
25
26           ·   Test if AppleDouble files exist
27
28           ·   Report orphaned AppleDouble files
29
30           ·   Report directories inside .AppleDouble directories
31
32           ·   Check name encoding by roundtripping, log on error
33
34           ·   Check for orphaned CNIDs in database (requires -e)
35
36           ·   Open and close adouble files
37
38               Options:
39                   -c Don´t check .AppleDouble stuff, only check orphaned.
40
41                   -n Don´t open CNID database, skip CNID checks, only
42                   traverse filesystem
43
44           -r
45               Rebuild volume. With -f wipe database and rebuild from CNIIDs
46               stored in AppleDouble files.
47
48               ·   Sync CNIDSs from database with volume
49
50               ·   Ensure .AppleDouble directories exist
51
52               ·   Ensure AppleDouble files exist
53
54               ·   Delete orphaned AppleDouble files
55
56               ·   Report directories inside .AppleDouble directories
57
58               ·   Check name encoding by roundtripping, log on error
59
60               ·   Delete orphaned CNIDs in database (requires -e)
61
62               ·   Open and close adouble files
63
64                   Options:
65                       -c Don´t create .AppleDouble stuff, only cleanup
66                       orphaned.
67
68                       -f Wipe database and rebuild from IDs stored in
69                       AppleDouble files, only available for volumes without
70                       nocnidcache option. Implies -e.
71
72               -u
73                   Prepare upgrade:
74
75                   Before installing an upgraded version of Netatalk that is
76                   linked against a newer BerkeleyDB lib, run `dbd -u ...`
77                   from the OLD Netatalk pior to upgrading on all volumes.
78                   This removes the BerkleyDB environment. On exit cnid_dbd
79                   does this automatically, so normally calling dbd -u should
80                   not be necessary !
81

OPTIONS

83       -e
84           Only work on inactive volumes and lock them (exclusive)
85
86       -x
87           Rebuild indexes (just for completeness, mostly useless!)
88
89       -v
90           verbose
91

WARNING

93       In order to be able to run -rf reconstructing the CNIDs in the database
94       from the AppleDouble files, make sure you´ve run a -r rebuild sometimes
95       before, where the CNIDs then would have been synched between database
96       and AppleDouble files.
97
98       Also be careful about the option nocnidcache. Avoid this option if at
99       all possible, because if prevents you from being able to use -f.
100

CNID BACKGROUND

102       The CNID backends maintains name to ID mappings. If you change a
103       filename outside afpd(8) (shell, samba), the CNID db will not know and
104       not reflect that change. Netatalk tries to recover from such
105       inconsistencies as gracefully as possible. The mechanisms to resolve
106       such inconsistencies may fail sometimes, though, as this is not an easy
107       task to accomplish. E.g. if several names in the path to the file or
108       directory have changed, things may go wrong.
109
110       If you change a lot of filenames at once, chances are higher that the
111       afpds fallback mechanisms fail, i.e. files will be assigned new IDs,
112       even though the file hasn´t changed.
113

SEE ALSO

115       cnid_metad(8), cnid_dbd(8)
116
117
118
119Netatalk 2.1                      23 Dec 2009                           DBD(1)