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