man/man8/cnid_metad.8.in

   1 '\" t
   2 .\"     Title: cnid_metad
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.78.0 <http://docbook.sf.net/>
   5 .\"      Date: 23 Mar 2012
   6 .\"    Manual: @NETATALK_VERSION@
   7 .\"    Source: @NETATALK_VERSION@
   8 .\"  Language: English
   9 .\"
  10 .TH "CNID_METAD" "8" "23 Mar 2012" "@NETATALK_VERSION@" "@NETATALK_VERSION@"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 cnid_metad \- start cnid_dbd daemons on request
  32 .SH "SYNOPSIS"
  33 .HP \w'\fBcnid_metad\fR\fB\fR\fBcnid_metad\fR\fB\fR\ 'u
  34 \fBcnid_metad\fR\fB\fR [\-d] [\-F\ \fIconfiguration\ file\fR]
  35 .br
  36 \fBcnid_metad\fR\fB\fR \-v | \-V
  37 .SH "DESCRIPTION"
  38 .PP
  39 \fBcnid_metad\fR
  40 waits for requests from
  41 \fBafpd\fR
  42 to start up instances of the
  43 \fBcnid_dbd\fR
  44 daemon\&. It keeps track of the status of a
  45 \fBcnid_dbd\fR
  46 instance once started and will restart it if necessary\&.
  47 \fBcnid_metad\fR
  48 is normally started at boot time by
  49 \fBnetatalk\fR(8) and runs until shutdown\&.
  50 .SH "OPTIONS"
  51 .PP
  52 \fB\-d\fR
  53 .RS 4
  54 \fBcnid_metad will remain in the foreground and\fR
  55 will also leave the standard input, standard output and standard error file descriptors open\&. Useful for debugging\&.
  56 .RE
  57 .PP
  58 \fB\-F\fR \fIconfiguration file\fR
  59 .RS 4
  60 Use
  61 \fIconfiguration file\fR
  62 as the configuration file\&. The default is
  63 \fI@pkgconfdir@/afp\&.conf\fR\&.
  64 .RE
  65 .PP
  66 \fB\-v, \-V\fR
  67 .RS 4
  68 Show version and exit\&.
  69 .RE
  70 .SH "CAVEATS"
  71 .PP
  72 \fBcnid_metad\fR
  73 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
  74 \fBcnid_dbd\*(Aqs\fR
  75 started by that
  76 \fBcnid_metad\fR
  77 to exit gracefully\&. Since state about and IPC access to the subprocesses is only maintained in memory by
  78 \fBcnid_metad\fR
  79 this is desired behaviour\&. As soon as
  80 \fBcnid_metad\fR
  81 is restarted
  82 \fBafpd\fR
  83 processes will transparently reconnect\&.
  84 .SH "SEE ALSO"
  85 .PP
  86 \fBnetatalk\fR(8),
  87 \fBcnid_dbd\fR(8),
  88 \fBafpd\fR(8),
  89 \fBdbd\fR(1),
  90 \fBafp.conf\fR(5)