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.75.2 <http://docbook.sf.net/>
   5 .\"      Date: 12 Oct 2010
   6 .\"    Manual: Netatalk 3.0
   7 .\"    Source: Netatalk 3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "DBD" "1" "12 Oct 2010" "Netatalk 3.0" "Netatalk 3.0"
  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 maintenance
  23 .SH "SYNOPSIS"
  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
  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 \fBdbd\fR
  33 \fB\-s|\-r\fR
  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\&.
  36 .SH "COMMANDS"
  37 .PP
  38 \-d
  39 .RS 4
  40 Dump CNID database\&. With
  41 \fB\-i \fRdump indexes too\&.
  42 .RE
  43 .PP
  44 \-s
  45 .RS 4
  46 Scan volume:
  47 .sp
  48 .RS 4
  49 .ie n \{\
  50 \h'-04'\(bu\h'+03'\c
  51 .\}
  52 .el \{\
  53 .sp -1
  54 .IP \(bu 2.3
  55 .\}
  56 Compare CNIDs in database with volume
  57 .RE
  58 .sp
  59 .RS 4
  60 .ie n \{\
  61 \h'-04'\(bu\h'+03'\c
  62 .\}
  63 .el \{\
  64 .sp -1
  65 .IP \(bu 2.3
  66 .\}
  67 Test if \&.AppleDouble directories exist
  68 .RE
  69 .sp
  70 .RS 4
  71 .ie n \{\
  72 \h'-04'\(bu\h'+03'\c
  73 .\}
  74 .el \{\
  75 .sp -1
  76 .IP \(bu 2.3
  77 .\}
  78 Test if AppleDouble files exist
  79 .RE
  80 .sp
  81 .RS 4
  82 .ie n \{\
  83 \h'-04'\(bu\h'+03'\c
  84 .\}
  85 .el \{\
  86 .sp -1
  87 .IP \(bu 2.3
  88 .\}
  89 Report orphaned AppleDouble files
  90 .RE
  91 .sp
  92 .RS 4
  93 .ie n \{\
  94 \h'-04'\(bu\h'+03'\c
  95 .\}
  96 .el \{\
  97 .sp -1
  98 .IP \(bu 2.3
  99 .\}
 100 Report directories inside \&.AppleDouble directories
 101 .RE
 102 .sp
 103 .RS 4
 104 .ie n \{\
 105 \h'-04'\(bu\h'+03'\c
 106 .\}
 107 .el \{\
 108 .sp -1
 109 .IP \(bu 2.3
 110 .\}
 111 Check name encoding by roundtripping, log on error
 112 .RE
 113 .sp
 114 .RS 4
 115 .ie n \{\
 116 \h'-04'\(bu\h'+03'\c
 117 .\}
 118 .el \{\
 119 .sp -1
 120 .IP \(bu 2.3
 121 .\}
 122 Check for orphaned CNIDs in database (requires
 123 \fB\-e\fR)
 124 .RE
 125 .sp
 126 .RS 4
 127 .ie n \{\
 128 \h'-04'\(bu\h'+03'\c
 129 .\}
 130 .el \{\
 131 .sp -1
 132 .IP \(bu 2.3
 133 .\}
 134 Open and close adouble files
 135 .RE
 136 .RS 4
 137 .PP
 138 Options:
 139 .RS 4
 140 \fB\-c\fR
 141 Don\'t check \&.AppleDouble stuff, only check orphaned\&.
 142 \fB\-n\fR
 143 Don\'t open CNID database, skip CNID checks, only traverse filesystem
 144 .RE
 145 .RE
 146 .PP
 147 \-r
 148 .RS 4
 149 Rebuild volume\&. With
 150 \fB\-f\fR
 151 wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
 152 .sp
 153 .RS 4
 154 .ie n \{\
 155 \h'-04'\(bu\h'+03'\c
 156 .\}
 157 .el \{\
 158 .sp -1
 159 .IP \(bu 2.3
 160 .\}
 161 Sync CNIDSs from database with volume
 162 .RE
 163 .sp
 164 .RS 4
 165 .ie n \{\
 166 \h'-04'\(bu\h'+03'\c
 167 .\}
 168 .el \{\
 169 .sp -1
 170 .IP \(bu 2.3
 171 .\}
 172 Ensure \&.AppleDouble directories exist
 173 .RE
 174 .sp
 175 .RS 4
 176 .ie n \{\
 177 \h'-04'\(bu\h'+03'\c
 178 .\}
 179 .el \{\
 180 .sp -1
 181 .IP \(bu 2.3
 182 .\}
 183 Ensure AppleDouble files exist
 184 .RE
 185 .sp
 186 .RS 4
 187 .ie n \{\
 188 \h'-04'\(bu\h'+03'\c
 189 .\}
 190 .el \{\
 191 .sp -1
 192 .IP \(bu 2.3
 193 .\}
 194 Delete orphaned AppleDouble files
 195 .RE
 196 .sp
 197 .RS 4
 198 .ie n \{\
 199 \h'-04'\(bu\h'+03'\c
 200 .\}
 201 .el \{\
 202 .sp -1
 203 .IP \(bu 2.3
 204 .\}
 205 Report directories inside \&.AppleDouble directories
 206 .RE
 207 .sp
 208 .RS 4
 209 .ie n \{\
 210 \h'-04'\(bu\h'+03'\c
 211 .\}
 212 .el \{\
 213 .sp -1
 214 .IP \(bu 2.3
 215 .\}
 216 Check name encoding by roundtripping, log on error
 217 .RE
 218 .sp
 219 .RS 4
 220 .ie n \{\
 221 \h'-04'\(bu\h'+03'\c
 222 .\}
 223 .el \{\
 224 .sp -1
 225 .IP \(bu 2.3
 226 .\}
 227 Delete orphaned CNIDs in database (requires
 228 \fB\-e\fR)
 229 .RE
 230 .sp
 231 .RS 4
 232 .ie n \{\
 233 \h'-04'\(bu\h'+03'\c
 234 .\}
 235 .el \{\
 236 .sp -1
 237 .IP \(bu 2.3
 238 .\}
 239 Open and close adouble files
 240 .RE
 241 .RS 4
 242 .PP
 243 Options:
 244 .RS 4
 245 \fB\-c\fR
 246 Don\'t create \&.AppleDouble stuff, only cleanup orphaned\&.
 247
 248 \fB\-f\fR
 249 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
 250 \fBnocnidcache\fR
 251 option\&. Implies
 252 \fB\-e\fR\&.
 253 .RE
 254 .RE
 255 .PP
 256 \-u
 257 .RS 4
 258 Upgrade:
 259 .sp
 260 Opens the database which triggers any necessary upgrades, then closes and exits\&.
 261 .RE
 262 .SH "OPTIONS"
 263 .PP
 264 \-e
 265 .RS 4
 266 Only work on inactive volumes and lock them (exclusive)
 267 .RE
 268 .PP
 269 \-x
 270 .RS 4
 271 Rebuild indexes (just for completeness, mostly useless!)
 272 .RE
 273 .PP
 274 \-v
 275 .RS 4
 276 verbose
 277 .RE
 278 .SH "WARNING"
 279 .PP
 280 In order to be able to run
 281 \fB\-rf\fR
 282 reconstructing the CNIDs in the database from the
 283 \fIAppleDouble\fR
 284 files, make sure you\'ve run a
 285 \fB\-r\fR
 286 rebuild sometimes before, where the CNIDs then would have been synched between database and
 287 \fIAppleDouble\fR
 288 files\&.
 289 .PP
 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
 292 \fB\-f\fR\&.
 293 .SH "CNID BACKGROUND"
 294 .PP
 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\&.
 296 .PP
 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\&.
 298 .SH "SEE ALSO"
 299 .PP
 300 \fBcnid_metad\fR(8),
 301 \fBcnid_dbd\fR(8)