man/man8/cnid_metad.8.tmpl

   1 '\" t
   2 .\"     Title: cnid_metad
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
   5 .\"      Date: 23 Apr 2009
   6 .\"    Manual: Netatalk 2.0.4
   7 .\"    Source: Netatalk 2.0.4
   8 .\"  Language: English
   9 .\"
  10 .TH "CNID_METAD" "8" "23 Apr 2009" "Netatalk 2\&.0\&.4" "Netatalk 2.0.4"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 cnid_metad \- start cnid_dbd daemons on request
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBcnid_metad\fR\fB\fR\ 'u
  25 \fBcnid_metad\fR\fB\fR [\-d] [\-h\ \fIhostname\fR] [\-p\ \fIport\fR] [\-u\ \fIuser\fR] [\-g\ \fIgroup\fR] [\-s\ \fIcnid_dbdpathname\fR]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBcnid_metad\fR
  29 waits for requests from
  30 \fBafpd\fR
  31 to start up instances of the
  32 \fBcnid_dbd\fR
  33 daemon\&. It keeps track of the status of a
  34 \fBcnid_dbd\fR
  35 instance once started and will restart it if necessary\&.
  36 \fBcnid_metad\fR
  37 is normally started at boot time from
  38 /etc/rc
  39 or equivalent and runs until shutdown\&.
  40 \fBafpd\fR
  41 needs to be configured with the
  42 \fB\-cnidserver\fR
  43 option in
  44 \fBafpd\&.conf\fR
  45 in order to access
  46 \fBcnid_metad\&.\fR
  47 It is possible to run more than one instance of
  48 \fBcnid_metad\fR
  49 on the same machine if different values for the interface and/or port are specified with the
  50 \fB\-h\fR
  51 and
  52 \fB\-p\fR
  53 options\&.
  54 .SH "OPTIONS"
  55 .PP
  56 \fB\-d\fR
  57 .RS 4
  58 \fBcnid_metad will remain in the foreground and\fR
  59 will also leave the standard input, standard output and standard error file descriptors open\&. Useful for debugging\&.
  60 .RE
  61 .PP
  62 \fB\-h\fR\fI hostname\fR
  63 .RS 4
  64 Use
  65 \fIhostname\fR
  66 as the network interface for requests as opposed to the default
  67 \fBlocalhost \fR\&.
  68 .RE
  69 .PP
  70 \fB\-p\fR\fI port\fR
  71 .RS 4
  72 Use
  73 \fIport\fR
  74 as the port number for reqests\&. Default is 4700\&.
  75 .RE
  76 .PP
  77 \fB\-u\fR\fI user\fR
  78 .RS 4
  79 Switch to the userid of
  80 \fIuser\fR
  81 before serving requests\&. This userid will be inherited by all
  82 \fBcnid_dbd\fR
  83 daemon processes started\&.
  84 .RE
  85 .PP
  86 \fB\-u\fR\fI group\fR
  87 .RS 4
  88 Switch to the groupid of
  89 \fIgroup\fR
  90 before serving requests\&. This groupid will be inherited by all
  91 \fBcnid_dbd\fR
  92 daemon processes started\&. Both
  93 \fIuser\fR
  94 and
  95 \fIgroup\fR
  96 must be specified as strings\&.
  97 .RE
  98 .PP
  99 \fB\-s\fR\fI cnid_dbd pathname\fR
 100 .RS 4
 101 Use
 102 \fIcnid_dbd pathname\fR
 103 as the pathname of the executeable of the
 104 \fBcnid_dbd\fR
 105 daemon\&. The default is
 106 \fI:SBINDIR:/cnid_dbd\&.\fR
 107 .RE
 108 .SH "CAVEATS"
 109 .PP
 110 The number of
 111 \fBcnid_dbd\fR
 112 subprocecesses is currently limited to 512\&.
 113 .PP
 114 \fBcnid_metad\fR
 115 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
 116 \fBcnid_dbd\'s\fR
 117 started by that
 118 \fBcnid_metad\fR
 119 to exit gracefully\&. Since state about and IPC access to the subprocesses is only maintained in memory by
 120 \fBcnid_metad\fR
 121 this is desired behaviour\&. As soon as
 122 \fBcnid_metad\fR
 123 is restarted
 124 \fBafpd\fR
 125 processes will transparently reconnect\&.
 126 .SH "SEE ALSO"
 127 .PP
 128 \fBcnid_dbd\fR(8),
 129 \fBafpd\fR(8)