X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman8%2Fcnid_metad.8.tmpl;h=64e5b3cc8fe77fbb1ff0ec5241e487a3eab3ac17;hb=10e48480c42be4415898d951a47187214740664d;hp=77761f8adf3953341e7afd79a0169a01b1c88173;hpb=ecfc96169ab669b578e53fa8e13592934fe37788;p=netatalk.git diff --git a/man/man8/cnid_metad.8.tmpl b/man/man8/cnid_metad.8.tmpl index 77761f8a..64e5b3cc 100644 --- a/man/man8/cnid_metad.8.tmpl +++ b/man/man8/cnid_metad.8.tmpl @@ -1,66 +1,80 @@ -.TH cnid_metad 8 "28 Nov 2003" 2.0.0 Netatalk -.SH NAME +'\" t +.\" Title: cnid_metad +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 21 Mar 2012 +.\" Manual: Netatalk 3.0 +.\" Source: Netatalk 3.0 +.\" Language: English +.\" +.TH "CNID_METAD" "8" "21 Mar 2012" "Netatalk 3.0" "Netatalk 3.0" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" cnid_metad \- start cnid_dbd daemons on request -.SH SYNOPSIS -\fBcnid_metad\fR [\-d] [ \-h \fBhostname\fR ] [ \-p \fBport\fR ] [ \-u \fBuser\fR ] [ \-g \fBgroup\fR ] [ \-s \fBcnid_dbdpathname\fR ] -.SH DESCRIPTION -cnid_metad waits for requests from \fIafpd\fR to start up instances of the \fIcnid_dbd\fR -daemon. It keeps track of the status of a \fIcnid_dbd\fR -instance once started and will restart it if necessary. -cnid_metad is normally started at boot time from -\fB/etc/rc\fR or equivalent and runs until shutdown. -\fIafpd\fR needs to be configured with the -\fB\-cnidserver\fR option in \fIafpd.conf\fR -in order to access \fIcnid_metad.\fR It is -possible to run more than one instance of cnid_metad on -the same machine if different values for the interface and/or port are -specified with the \fB\-h\fR and \fB\-p\fR options. -.SH OPTIONS -.TP +.SH "SYNOPSIS" +.HP \w'\fBcnid_metad\fR\fB\fR\fBcnid_metad\fR\fB\fR\ 'u +\fBcnid_metad\fR\fB\fR [\-d] [\-F\ \fIconfiguration\ file\fR] +.br +\fBcnid_metad\fR\fB\fR \-v | \-V +.SH "DESCRIPTION" +.PP +\fBcnid_metad\fR +waits for requests from +\fBafpd\fR +to start up instances of the +\fBcnid_dbd\fR +daemon\&. It keeps track of the status of a +\fBcnid_dbd\fR +instance once started and will restart it if necessary\&. +\fBcnid_metad\fR +is normally started at boot time from +/etc/rc +or equivalent and runs until shutdown\&. +.SH "OPTIONS" +.PP \fB\-d\fR -\fIcnid_metad will remain in the foreground -and\fR will also leave the standard input, standard output -and standard error file descriptors open. Useful for debugging. -.TP -\fB\-h\fR\fI hostname\fR -Use \fIhostname\fR as the network -interface for requests as opposed to the default \fIlocalhost -\fR\&. -.TP -\fB\-p\fR\fI port\fR -Use \fIport\fR as the port number for -reqests. Default is 4700. -.TP -\fB\-u\fR\fI user\fR -Switch to the userid of \fIuser\fR -before serving requests. This userid will be inherited by all -\fIcnid_dbd\fR daemon processes started. -.TP -\fB\-u\fR\fI group\fR -Switch to the groupid of \fIgroup\fR -before serving requests. This groupid will be inherited by all -\fIcnid_dbd\fR daemon processes started. -Both \fIuser\fR and \fIgroup\fR -must be specified as strings. -.TP -\fB\-s\fR\fI cnid_dbd pathname\fR -Use \fIcnid_dbd pathname\fR as the -pathname of the executeable of the \fIcnid_dbd\fR -daemon. The default is \fI:SBINDIR:/cnid_dbd.\fR -.SH CAVEATS -The number of \fIcnid_dbd\fR subprocecesses -is currently limited to 128. This restriction will be lifted in the -future. +.RS 4 +\fBcnid_metad will remain in the foreground and\fR +will also leave the standard input, standard output and standard error file descriptors open\&. Useful for debugging\&. +.RE +.PP +\fB\-F\fR \fIconfiguration file\fR +.RS 4 +Use +\fIconfiguration file\fR +as the configuration file\&. The default is +\fI:ETCDIR:/afp\&.conf\fR\&. +.RE .PP -cnid_metad does not block or catch any signals -apart from SIGPIPE. It will therefore exit on most signals received. This -will also cause all instances of \fIcnid_dbd's\fR -started by that cnid_metad to exit gracefully. Since -state about and IPC access to the subprocesses is only maintained in -memory by cnid_metad this is desired behaviour. As soon -as cnid_metad is restarted \fIafpd\fR -processes will transparently reconnect. +\fB\-v, \-V\fR +.RS 4 +Show version and exit\&. +.RE +.SH "CAVEATS" +.PP +\fBcnid_metad\fR +does not block or catch any signals apart from SIGPIPE\&. It will therefore exit on most signals received\&. This will also cause all instances of +\fBcnid_dbd\'s\fR +started by that +\fBcnid_metad\fR +to exit gracefully\&. Since state about and IPC access to the subprocesses is only maintained in memory by +\fBcnid_metad\fR +this is desired behaviour\&. As soon as +\fBcnid_metad\fR +is restarted +\fBafpd\fR +processes will transparently reconnect\&. .SH "SEE ALSO" +.PP \fBcnid_dbd\fR(8), -\fBafpd\fR(8) - +\fBafpd\fR(8), +\fBdbd\fR(1)