1 .TH cnid_metad 8 "28 Nov 2003" 2.0.0 Netatalk
3 cnid_metad \- start cnid_dbd daemons on request
5 \fBcnid_metad\fR [\-d] [ \-h \fBhostname\fR ] [ \-p \fBport\fR ] [ \-u \fBuser\fR ] [ \-g \fBgroup\fR ] [ \-s \fBcnid_dbdpathname\fR ]
7 cnid_metad waits for requests from \fIafpd\fR to start up instances of the \fIcnid_dbd\fR
8 daemon. It keeps track of the status of a \fIcnid_dbd\fR
9 instance once started and will restart it if necessary.
10 cnid_metad is normally started at boot time from
11 \fB/etc/rc\fR or equivalent and runs until shutdown.
12 \fIafpd\fR needs to be configured with the
13 \fB\-cnidserver\fR option in \fIafpd.conf\fR
14 in order to access \fIcnid_metad.\fR It is
15 possible to run more than one instance of cnid_metad on
16 the same machine if different values for the interface and/or port are
17 specified with the \fB\-h\fR and \fB\-p\fR options.
21 \fIcnid_metad will remain in the foreground
22 and\fR will also leave the standard input, standard output
23 and standard error file descriptors open. Useful for debugging.
25 \fB\-h\fR\fI hostname\fR
26 Use \fIhostname\fR as the network
27 interface for requests as opposed to the default \fIlocalhost
31 Use \fIport\fR as the port number for
32 reqests. Default is 4700.
35 Switch to the userid of \fIuser\fR
36 before serving requests. This userid will be inherited by all
37 \fIcnid_dbd\fR daemon processes started.
40 Switch to the groupid of \fIgroup\fR
41 before serving requests. This groupid will be inherited by all
42 \fIcnid_dbd\fR daemon processes started.
43 Both \fIuser\fR and \fIgroup\fR
44 must be specified as strings.
46 \fB\-s\fR\fI cnid_dbd pathname\fR
47 Use \fIcnid_dbd pathname\fR as the
48 pathname of the executeable of the \fIcnid_dbd\fR
49 daemon. The default is \fI:SBINDIR:/cnid_dbd.\fR
51 The number of \fIcnid_dbd\fR subprocecesses
52 is currently limited to 128. This restriction will be lifted in the
55 cnid_metad does not block or catch any signals
56 apart from SIGPIPE. It will therefore exit on most signals received. This
57 will also cause all instances of \fIcnid_dbd's\fR
58 started by that cnid_metad to exit gracefully. Since
59 state about and IPC access to the subprocesses is only maintained in
60 memory by cnid_metad this is desired behaviour. As soon
61 as cnid_metad is restarted \fIafpd\fR
62 processes will transparently reconnect.