man/man1/dbd.1

   1 '\" t
   2 .\"     Title: dbd
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
   5 .\"      Date: 23 Dec 2009
   6 .\"    Manual: Netatalk 2.1
   7 .\"    Source: Netatalk 2.1
   8 .\"  Language: English
   9 .\"
  10 .TH "DBD" "1" "23 Dec 2009" "Netatalk 2.1" "Netatalk 2.1"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 dbd \- CNID database maintanance
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBdbd\fR\fB\fR\ 'u
  25 \fBdbd\fR\fB\fR [\-evx] {\-d\ [\-i]  | \-s\ [n]  | \-r\ [\-f]  | \-u} \fIvolumepath\fR
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBdbd\fR
  29 can dump, scan, reindex and rebuild
  30 \fINetatalk\fR
  31 dbd CNID databases\&. It must be run with appropiate permissions i\&.e\&. as root\&.
  32 .SH "COMMANDS"
  33 .PP
  34 \-d
  35 .RS 4
  36 Dump CNID database\&. With
  37 \fB\-i \fRdump indexes too\&.
  38 .RE
  39 .PP
  40 \-s
  41 .RS 4
  42 Scan volume:
  43 .sp
  44 .RS 4
  45 .ie n \{\
  46 \h'-04'\(bu\h'+03'\c
  47 .\}
  48 .el \{\
  49 .sp -1
  50 .IP \(bu 2.3
  51 .\}
  52 Compare CNIDs in database with volume
  53 .RE
  54 .sp
  55 .RS 4
  56 .ie n \{\
  57 \h'-04'\(bu\h'+03'\c
  58 .\}
  59 .el \{\
  60 .sp -1
  61 .IP \(bu 2.3
  62 .\}
  63 Test if \&.AppleDouble directories exist
  64 .RE
  65 .sp
  66 .RS 4
  67 .ie n \{\
  68 \h'-04'\(bu\h'+03'\c
  69 .\}
  70 .el \{\
  71 .sp -1
  72 .IP \(bu 2.3
  73 .\}
  74 Test if AppleDouble files exist
  75 .RE
  76 .sp
  77 .RS 4
  78 .ie n \{\
  79 \h'-04'\(bu\h'+03'\c
  80 .\}
  81 .el \{\
  82 .sp -1
  83 .IP \(bu 2.3
  84 .\}
  85 Report orphaned AppleDouble files
  86 .RE
  87 .sp
  88 .RS 4
  89 .ie n \{\
  90 \h'-04'\(bu\h'+03'\c
  91 .\}
  92 .el \{\
  93 .sp -1
  94 .IP \(bu 2.3
  95 .\}
  96 Report directories inside \&.AppleDouble directories
  97 .RE
  98 .sp
  99 .RS 4
 100 .ie n \{\
 101 \h'-04'\(bu\h'+03'\c
 102 .\}
 103 .el \{\
 104 .sp -1
 105 .IP \(bu 2.3
 106 .\}
 107 Check name encoding by roundtripping, log on error
 108 .RE
 109 .sp
 110 .RS 4
 111 .ie n \{\
 112 \h'-04'\(bu\h'+03'\c
 113 .\}
 114 .el \{\
 115 .sp -1
 116 .IP \(bu 2.3
 117 .\}
 118 Check for orphaned CNIDs in database (requires
 119 \fB\-e\fR)
 120 .RE
 121 .sp
 122 .RS 4
 123 .ie n \{\
 124 \h'-04'\(bu\h'+03'\c
 125 .\}
 126 .el \{\
 127 .sp -1
 128 .IP \(bu 2.3
 129 .\}
 130 Open and close adouble files
 131 .RE
 132 .RS 4
 133 .PP
 134 Options:
 135 .RS 4
 136 \fB\-n\fR
 137 Don\'t open CNID database, skip CNID checks, only traverse filesystem
 138 .RE
 139 .RE
 140 .PP
 141 \-r
 142 .RS 4
 143 Rebuild volume\&. With
 144 \fB\-f\fR
 145 wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
 146 .sp
 147 .RS 4
 148 .ie n \{\
 149 \h'-04'\(bu\h'+03'\c
 150 .\}
 151 .el \{\
 152 .sp -1
 153 .IP \(bu 2.3
 154 .\}
 155 Sync CNIDSs from database with volume
 156 .RE
 157 .sp
 158 .RS 4
 159 .ie n \{\
 160 \h'-04'\(bu\h'+03'\c
 161 .\}
 162 .el \{\
 163 .sp -1
 164 .IP \(bu 2.3
 165 .\}
 166 Ensure \&.AppleDouble directories exist
 167 .RE
 168 .sp
 169 .RS 4
 170 .ie n \{\
 171 \h'-04'\(bu\h'+03'\c
 172 .\}
 173 .el \{\
 174 .sp -1
 175 .IP \(bu 2.3
 176 .\}
 177 Ensure AppleDouble files exist
 178 .RE
 179 .sp
 180 .RS 4
 181 .ie n \{\
 182 \h'-04'\(bu\h'+03'\c
 183 .\}
 184 .el \{\
 185 .sp -1
 186 .IP \(bu 2.3
 187 .\}
 188 Delete orphaned AppleDouble files
 189 .RE
 190 .sp
 191 .RS 4
 192 .ie n \{\
 193 \h'-04'\(bu\h'+03'\c
 194 .\}
 195 .el \{\
 196 .sp -1
 197 .IP \(bu 2.3
 198 .\}
 199 Report directories inside \&.AppleDouble directories
 200 .RE
 201 .sp
 202 .RS 4
 203 .ie n \{\
 204 \h'-04'\(bu\h'+03'\c
 205 .\}
 206 .el \{\
 207 .sp -1
 208 .IP \(bu 2.3
 209 .\}
 210 Check name encoding by roundtripping, log on error
 211 .RE
 212 .sp
 213 .RS 4
 214 .ie n \{\
 215 \h'-04'\(bu\h'+03'\c
 216 .\}
 217 .el \{\
 218 .sp -1
 219 .IP \(bu 2.3
 220 .\}
 221 Delete orphaned CNIDs in database (requires
 222 \fB\-e\fR)
 223 .RE
 224 .sp
 225 .RS 4
 226 .ie n \{\
 227 \h'-04'\(bu\h'+03'\c
 228 .\}
 229 .el \{\
 230 .sp -1
 231 .IP \(bu 2.3
 232 .\}
 233 Open and close adouble files
 234 .RE
 235 .RS 4
 236 .PP
 237 Options:
 238 .RS 4
 239 \fB\-f\fR
 240 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
 241 \fBnocnidcache\fR
 242 option\&. Implies
 243 \fB\-e\fR\&.
 244 .RE
 245 .RE
 246 .PP
 247 \-u
 248 .RS 4
 249 Prepare upgrade:
 250 .sp
 251 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 !
 252 .RE
 253 .SH "OPTIONS"
 254 .PP
 255 \-e
 256 .RS 4
 257 Only work on inactive volumes and lock them (exclusive)
 258 .RE
 259 .PP
 260 \-x
 261 .RS 4
 262 Rebuild indexes (just for completeness, mostly useless!)
 263 .RE
 264 .PP
 265 \-v
 266 .RS 4
 267 verbose
 268 .RE
 269 .SH "WARNING"
 270 .PP
 271 In order to be able to run
 272 \fB\-rf\fR
 273 reconstructing the CNIDs in the database from the
 274 \fIAppleDouble\fR
 275 files, make sure you\'ve run a
 276 \fB\-r\fR
 277 rebuild sometimes before, where the CNIDs then would have been synched between database and
 278 \fIAppleDouble\fR
 279 files\&.
 280 .PP
 281 Also be careful about the option
 282 \fBnocnidcache\fR\&. Avoid this option if at all possible, because if prevents you from being able to use
 283 \fB\-f\fR\&.
 284 .SH "CNID BACKGROUND"
 285 .PP
 286 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\&.
 287 .PP
 288 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\&.
 289 .SH "SEE ALSO"
 290 .PP
 291 \fBcnid_metad\fR(8),
 292 \fBcnid_dbd\fR(8)