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