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: 14 Sep 2012
   6 .\"    Manual: Netatalk 3.0
   7 .\"    Source: Netatalk 3.0
   8 .\"  Language: English
   9 .\"
  10 .TH "DBD" "1" "14 Sep 2012" "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|\-C]  | \-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 Compare CNIDs in database with volume, test if \&.AppleDouble directories exist, test if AppleDouble files exist, report orphaned AppleDouble files, report directories inside \&.AppleDouble directories, check name encoding, heck for orphaned CNIDs in database (requires
  49 \fB\-e\fR)\&.
  50 Options:
  51 .PP
  52 \-c
  53 .RS 4
  54 Don\'t check \&.AppleDouble stuff, only check orphaned\&.
  55 .RE
  56 .PP
  57 \-n
  58 .RS 4
  59 Don\'t open CNID database, skip CNID checks, only traverse filesystem
  60 .RE
  61 .RE
  62 .PP
  63 \-r
  64 .RS 4
  65 Rebuild volume:
  66 .sp
  67 Sync CNIDSs from database with volume, ensure \&.AppleDouble directories exist, ensure AppleDouble files exist, delete orphaned AppleDouble files, report directories inside \&.AppleDouble directories, check name encoding by roundtripping, delete orphaned CNIDs in database (requires
  68 \fB\-e\fR)\&.
  69 Options:
  70 .PP
  71 \-C
  72 .RS 4
  73 Converts volume from adouble:v2 to adouble:ea
  74 .RE
  75 .PP
  76 \-c
  77 .RS 4
  78 Don\'t create \&.AppleDouble stuff, only cleanup orphaned\&.
  79 .RE
  80 .PP
  81 \-f
  82 .RS 4
  83 Wipe database and rebuild from IDs stored in AppleDouble files, only available for volumes without
  84 \fBnocnidcache\fR
  85 option\&. Implies
  86 \fB\-e\fR\&.
  87 .RE
  88 .RE
  89 .PP
  90 \-u
  91 .RS 4
  92 Upgrade:
  93 .sp
  94 Opens the database which triggers any necessary upgrades, then closes and exits\&.
  95 .RE
  96 .SH "OPTIONS"
  97 .PP
  98 \-e
  99 .RS 4
 100 Only work on inactive volumes and lock them (exclusive)
 101 .RE
 102 .PP
 103 \-x
 104 .RS 4
 105 Rebuild indexes (just for completeness, mostly useless!)
 106 .RE
 107 .PP
 108 \-v
 109 .RS 4
 110 verbose
 111 .RE
 112 .SH "WARNING"
 113 .PP
 114 In order to be able to run
 115 \fB\-rf\fR
 116 reconstructing the CNIDs in the database from the
 117 \fIAppleDouble\fR
 118 files, make sure you\'ve run a
 119 \fB\-r\fR
 120 rebuild sometimes before, where the CNIDs then would have been synched between database and
 121 \fIAppleDouble\fR
 122 files\&.
 123 .PP
 124 Also be careful about the option
 125 \fBnocnidcache\fR\&. Avoid this option if at all possible, because if prevents you from being able to use
 126 \fB\-f\fR\&.
 127 .SH "CNID BACKGROUND"
 128 .PP
 129 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\&.
 130 .PP
 131 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\&.
 132 .SH "SEE ALSO"
 133 .PP
 134 \fBcnid_metad\fR(8),
 135 \fBcnid_dbd\fR(8)