man/man8/cnid_metad.8.tmpl

   1 .TH cnid_metad 8  28\ Nov\ 2003 "Netatalk 2.0-beta2"
   2 .SH NAME
   3 cnid_metad \- start cnid_dbd daemons on request
   4 .SH SYNOPSIS
   5 \fBcnid_metad\fR [\-d] [ \-h \fBhostname\fR ] [ \-p \fBport\fR ] [ \-u \fBuser\fR ] [ \-g \fBgroup\fR ] [ \-s \fBcnid_dbdpathname\fR ]
   6 .SH DESCRIPTION
   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.
  18 .SH OPTIONS
  19 .TP
  20 \fB\-d\fR
  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.
  24 .TP
  25 \fB\-h\fR\fI hostname\fR
  26 Use \fIhostname\fR as the network
  27 interface for requests as opposed to the default \fIlocalhost
  28 \fR.TP
  29 \fB\-p\fR\fI port\fR
  30 Use \fIport\fR as the port number for
  31 reqests. Default is 4700.
  32 .TP
  33 \fB\-u\fR\fI user\fR
  34 Switch to the userid of \fIuser\fR
  35 before serving requests. This userid will be inherited by all
  36 \fIcnid_dbd\fR daemon processes started.
  37 .TP
  38 \fB\-u\fR\fI group\fR
  39 Switch to the groupid of \fIgroup\fR
  40 before serving requests. This groupid will be inherited by all
  41 \fIcnid_dbd\fR daemon processes started.
  42 Both \fIuser\fR and \fIgroup\fR
  43 must be specified as strings.
  44 .TP
  45 \fB\-s\fR\fI cnid_dbd pathname\fR
  46 Use \fIcnid_dbd pathname\fR as the
  47 pathname of the executeable of the \fIcnid_dbd\fR
  48 daemon. The default is \fI:SBINDIR:/cnid_dbd.\fR
  49 .SH CAVEATS
  50 The number of \fIcnid_dbd\fR subprocecesses
  51 is currently limited to 128. This restriction will be lifted in the
  52 future.
  53 .PP
  54 cnid_metad does not block or catch any signals
  55 apart from SIGPIPE. It will therefore exit on most signals received. This
  56 will also cause all instances of \fIcnid_dbd's\fR
  57 started by that cnid_metad to exit gracefully. Since
  58 state about and IPC access to the subprocesses is only maintained in
  59 memory by cnid_metad this is desired behaviour. As soon
  60 as cnid_metad is restarted \fIafpd\fR
  61 processes will transparently reconnect.
  62 .SH SEE\ ALSO
  63 \fBcnid_dbd\fR(8),
  64 \fBafpd\fR(8)