X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman8%2Fcnid_dbd.8.tmpl;h=347921efa17139e8f3b1b3c4e5637372443f93ea;hb=87c988fcf9692a803058ee67244fa957438ea6b2;hp=5fc967a55bd7f8f21a37ef63b90ae696ad3223b7;hpb=11da95a136d88d6ada4982e37aaee98beb15aa8f;p=netatalk.git diff --git a/man/man8/cnid_dbd.8.tmpl b/man/man8/cnid_dbd.8.tmpl index 5fc967a5..347921ef 100644 --- a/man/man8/cnid_dbd.8.tmpl +++ b/man/man8/cnid_dbd.8.tmpl @@ -2,12 +2,12 @@ .\" Title: cnid_dbd .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.75.2 -.\" Date: 21 Mar 2009 -.\" Manual: Netatalk 2.1 -.\" Source: Netatalk 2.1 +.\" Date: 01 Jan 2012 +.\" Manual: Netatalk 3.0 +.\" Source: Netatalk 3.0 .\" Language: English .\" -.TH "CNID_DBD" "8" "21 Mar 2009" "Netatalk 2.1" "Netatalk 2.1" +.TH "CNID_DBD" "8" "01 Jan 2012" "Netatalk 3.0" "Netatalk 3.0" .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- @@ -21,8 +21,10 @@ .SH "NAME" cnid_dbd \- implement access to CNID databases through a dedicated daemon process .SH "SYNOPSIS" -.HP \w'\fBcnid_dbd\fR\fB\fR\fB\fR\fB\fR\ 'u -\fBcnid_dbd\fR\fB\fR\fB\fR\fB\fR \fIdbdir\fR \fIctrlfd\fR \fIclntfd\fR \fIlogconfig_string\fR +.HP \w'\fBcnid_dbd\fR\fB\fR\fB\fR\fB\fR\fBcnid_dbd\fR\fB\fR\ 'u +\fBcnid_dbd\fR\fB\fR\fB\fR\fB\fR +.br +\fBcnid_dbd\fR\fB\fR \-v | \-V .SH "DESCRIPTION" .PP \fBcnid_dbd\fR @@ -41,7 +43,7 @@ backend\&. \fBcnid_dbd\fR is never started via the command line or system startup scripts but only by the \fBcnid_metad\fR -daemon\&. There is at most one instance of +daemon\&. There is one instance of \fBcnid_dbd\fR per netatalk volume\&. .PP @@ -53,11 +55,6 @@ database library and uses transactionally protected updates\&. The backend with transactions will avoid corruption of the CNID database even if the system crashes unexpectedly\&. .PP \fBcnid_dbd\fR -uses the same on\-disk database format as the -\fBcdb\fR -backend\&. It is therefore possible to switch between the two backends as necessary\&. -.PP -\fBcnid_dbd\fR inherits the effective userid and groupid from \fBcnid_metad\fR on startup, which is normally caused by @@ -83,13 +80,6 @@ via the filedescriptor \fIctrlfd\fR\&. .PP \fBcnid_dbd\fR -uses -\fBlogconfig_string\fR -which is passed from -\fBcnid_metad\fR -to configure its logging output\&. -.PP -\fBcnid_dbd\fR can be configured to run forever or to exit after a period of inactivity\&. If \fBcnid_dbd\fR receives a TERM or an INT signal it will exit cleanly after flushing dirty database buffers to disk and closing @@ -105,13 +95,19 @@ database subsystem will create files named log\&.xxxxxxxxxx in the database home \fBlogfile_autoremove\fR option is specified in the \fIdb_param\fR -configuration file (see below)\&. +configuration file (see below) with a value of 0 (default 1)\&. .PP Do not use \fBcnid_dbd\fR for databases on NFS mounted file systems\&. It makes the whole point of securing database changes properly moot\&. Use the dbdir: Option in the appropriate \fBAppleVolumes\fR configuration file to put the database onto a local disk\&. +.SH "OPTIONS" +.PP +\fB\-v, \-V\fR +.RS 4 +Show version and exit\&. +.RE .SH "CONFIGURATION" .PP \fBcnid_dbd\fR @@ -180,7 +176,11 @@ exits\&. Default: 600\&. Set this to 0 to disable the timeout\&. .RE .SH "UPDATING" .PP -In order to update between Netatalk releases using different BerkeleyDB library versions, follow this steps: +Note that the first version to appear +\fIafter\fR +Netatalk 2\&.1 ie Netatalk 2\&.1\&.1, will support BerkeleyDB updates on the fly without manual intervention\&. In other words Netatalk 2\&.1 does contain code to prepare the BerkeleyDB database for upgrades and to upgrade it in case it has been prepared before\&. That means it can\'t upgrade a 2\&.0\&.x version because that one didn\'t prepare the database\&. +.PP +In order to update between older Netatalk releases using different BerkeleyDB library versions, follow this steps: .sp .RS 4 .ie n \{\ @@ -239,10 +239,6 @@ Again using the new BerkeleyDB utilities run .\} Start the the new version of Netatalk .RE -.PP -Note that the first version to appear -\fIafter\fR -Netatalk 2\&.1 ie Netatalk 2\&.1\&.1, will support BerkeleyDB updates on the fly without manual intervention\&. In other words Netatalk 2\&.1 does contain code to prepare the BerkeleyDB database for upgrades and to upgrade it in case it has been prepared before\&. That means it can\'t upgrade a 2\&.0\&.x version because that one didn\'t prepare the database\&. .SH "SEE ALSO" .PP \fBcnid_metad\fR(8),