]> arthur.barton.de Git - netatalk.git/blob - doc/manpages/man1/dbd.1.xml
Support for using $u username variable in AFP volume definitions
[netatalk.git] / doc / manpages / man1 / dbd.1.xml
1 <?xml version="1.0" encoding="UTF-8"?>
2 <refentry id="dbd.1">
3   <refmeta>
4     <refentrytitle>dbd</refentrytitle>
5
6     <manvolnum>1</manvolnum>
7
8     <refmiscinfo class="date">28 Dec 2012</refmiscinfo>
9
10     <refmiscinfo class="source">@NETATALK_VERSION@</refmiscinfo>
11   </refmeta>
12
13   <refnamediv>
14     <refname>dbd</refname>
15
16     <refpurpose>CNID database maintenance</refpurpose>
17   </refnamediv>
18
19   <refsynopsisdiv>
20     <cmdsynopsis>
21       <command>dbd<indexterm>
22           <primary>dbd</primary>
23         </indexterm></command>
24
25       <arg choice="opt">-cfFstuvV</arg>
26
27       <arg choice="plain"><replaceable>volumepath</replaceable></arg>
28     </cmdsynopsis>
29   </refsynopsisdiv>
30
31   <refsect1>
32     <title>Description</title>
33
34     <para><command>dbd</command> scans all file and directories of AFP
35     volumes, updating the CNID database of the volume. It must be run with
36     appropriate permissions i.e. as root..</para>
37   </refsect1>
38
39   <refsect1>
40     <title>Options</title>
41
42     <variablelist>
43       <varlistentry>
44         <term>-c</term>
45
46         <listitem>
47           <para>convert from adouble:v2 to adouble:ea</para>
48         </listitem>
49       </varlistentry>
50
51       <varlistentry>
52         <term>-f</term>
53
54         <listitem>
55           <para>delete and recreate CNID database</para>
56         </listitem>
57       </varlistentry>
58
59       <varlistentry>
60         <term>-F</term>
61
62         <listitem>
63           <para>location of the afp.conf config file</para>
64         </listitem>
65       </varlistentry>
66
67       <varlistentry>
68         <term>-s</term>
69
70         <listitem>
71           <para>scan volume: treat the volume as read only and don't perform
72           any filesystem modifications</para>
73         </listitem>
74       </varlistentry>
75
76       <varlistentry>
77         <term>-t</term>
78
79         <listitem>
80           <para>show statistics while running</para>
81         </listitem>
82       </varlistentry>
83
84       <varlistentry>
85         <term>-u</term>
86
87         <listitem>
88           <para>username for use with AFP volumes using user variable $u</para>
89         </listitem>
90       </varlistentry>
91
92       <varlistentry>
93         <term>-v</term>
94
95         <listitem>
96           <para>verbose</para>
97         </listitem>
98       </varlistentry>
99
100       <varlistentry>
101         <term>-V</term>
102
103         <listitem>
104           <para>display version info</para>
105         </listitem>
106       </varlistentry>
107     </variablelist>
108   </refsect1>
109
110   <refsect1>
111     <title>CNID background</title>
112
113     <para>The CNID backends maintains name to ID mappings. If you change a
114     filename outside afpd(8) (shell, samba), the CNID database will not
115     reflect that change. Netatalk tries to recover from such inconsistencies
116     as gracefully as possible.</para>
117   </refsect1>
118
119   <refsect1>
120     <title>See also</title>
121
122     <para><citerefentry>
123         <refentrytitle>cnid_metad</refentrytitle>
124
125         <manvolnum>8</manvolnum>
126       </citerefentry>, <citerefentry>
127         <refentrytitle>cnid_dbd</refentrytitle>
128
129         <manvolnum>8</manvolnum>
130       </citerefentry></para>
131   </refsect1>
132 </refentry>