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: 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\ [\-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 .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\-c\fR
 137 Don\'t check \&.AppleDouble stuff, only check orphaned\&.
 138
 139 \fB\-n\fR
 140 Don\'t open CNID database, skip CNID checks, only traverse filesystem
 141 .RE
 142 .RE
 143 .PP
 144 \-r
 145 .RS 4
 146 Rebuild volume\&. With
 147 \fB\-f\fR
 148 wipe database and rebuild from CNIIDs stored in AppleDouble files\&.
 149 .sp
 150 .RS 4
 151 .ie n \{\
 152 \h'-04'\(bu\h'+03'\c
 153 .\}
 154 .el \{\
 155 .sp -1
 156 .IP \(bu 2.3
 157 .\}
 158 Sync CNIDSs from database with volume
 159 .RE
 160 .sp
 161 .RS 4
 162 .ie n \{\
 163 \h'-04'\(bu\h'+03'\c
 164 .\}
 165 .el \{\
 166 .sp -1
 167 .IP \(bu 2.3
 168 .\}
 169 Ensure \&.AppleDouble directories exist
 170 .RE
 171 .sp
 172 .RS 4
 173 .ie n \{\
 174 \h'-04'\(bu\h'+03'\c
 175 .\}
 176 .el \{\
 177 .sp -1
 178 .IP \(bu 2.3
 179 .\}
 180 Ensure AppleDouble files exist
 181 .RE
 182 .sp
 183 .RS 4
 184 .ie n \{\
 185 \h'-04'\(bu\h'+03'\c
 186 .\}
 187 .el \{\
 188 .sp -1
 189 .IP \(bu 2.3
 190 .\}
 191 Delete orphaned AppleDouble files
 192 .RE
 193 .sp
 194 .RS 4
 195 .ie n \{\
 196 \h'-04'\(bu\h'+03'\c
 197 .\}
 198 .el \{\
 199 .sp -1
 200 .IP \(bu 2.3
 201 .\}
 202 Report directories inside \&.AppleDouble directories
 203 .RE
 204 .sp
 205 .RS 4
 206 .ie n \{\
 207 \h'-04'\(bu\h'+03'\c
 208 .\}
 209 .el \{\
 210 .sp -1
 211 .IP \(bu 2.3
 212 .\}
 213 Check name encoding by roundtripping, log on error
 214 .RE
 215 .sp
 216 .RS 4
 217 .ie n \{\
 218 \h'-04'\(bu\h'+03'\c
 219 .\}
 220 .el \{\
 221 .sp -1
 222 .IP \(bu 2.3
 223 .\}
 224 Delete orphaned CNIDs in database (requires
 225 \fB\-e\fR)
 226 .RE
 227 .sp
 228 .RS 4
 229 .ie n \{\
 230 \h'-04'\(bu\h'+03'\c
 231 .\}
 232 .el \{\
 233 .sp -1
 234 .IP \(bu 2.3
 235 .\}
 236 Open and close adouble files
 237 .RE
 238 .RS 4
 239 .PP
 240 Options:
 241 .RS 4
 242 \fB\-c\fR
 243 Don\'t create \&.AppleDouble stuff, only cleanup orphaned\&.
 244
 245 \fB\-f\fR
 246 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
 247 \fBnocnidcache\fR
 248 option\&. Implies
 249 \fB\-e\fR\&.
 250 .RE
 251 .RE
 252 .PP
 253 \-u
 254 .RS 4
 255 Prepare upgrade:
 256 .sp
 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 !
 258 .RE
 259 .SH "OPTIONS"
 260 .PP
 261 \-e
 262 .RS 4
 263 Only work on inactive volumes and lock them (exclusive)
 264 .RE
 265 .PP
 266 \-x
 267 .RS 4
 268 Rebuild indexes (just for completeness, mostly useless!)
 269 .RE
 270 .PP
 271 \-v
 272 .RS 4
 273 verbose
 274 .RE
 275 .SH "WARNING"
 276 .PP
 277 In order to be able to run
 278 \fB\-rf\fR
 279 reconstructing the CNIDs in the database from the
 280 \fIAppleDouble\fR
 281 files, make sure you\'ve run a
 282 \fB\-r\fR
 283 rebuild sometimes before, where the CNIDs then would have been synched between database and
 284 \fIAppleDouble\fR
 285 files\&.
 286 .PP
 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
 289 \fB\-f\fR\&.
 290 .SH "CNID BACKGROUND"
 291 .PP
 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\&.
 293 .PP
 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\&.
 295 .SH "SEE ALSO"
 296 .PP
 297 \fBcnid_metad\fR(8),
 298 \fBcnid_dbd\fR(8)