man/man8/cnid_metad.8.tmpl

   1 .TH cnid_metad 8 "28 Nov 2003" 2.0.0 Netatalk
   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\&.
  29 .TP
  30 \fB\-p\fR\fI port\fR
  31 Use \fIport\fR as the port number for
  32 reqests. Default is 4700.
  33 .TP
  34 \fB\-u\fR\fI user\fR
  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.
  38 .TP
  39 \fB\-u\fR\fI group\fR
  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.
  45 .TP
  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
  50 .SH CAVEATS
  51 The number of \fIcnid_dbd\fR subprocecesses
  52 is currently limited to 128. This restriction will be lifted in the
  53 future.
  54 .PP
  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.
  63 .SH "SEE ALSO"
  64 \fBcnid_dbd\fR(8),
  65 \fBafpd\fR(8)
  66