-.TH CNID_METAD 8 "28 Nov 2003" ":NETATALK_VERSION:"
-
-.SH NAME
+'\" t
+.\" Title: cnid_metad
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
+.\" Date: 23 Apr 2009
+.\" Manual: Netatalk 2.0.4
+.\" Source: Netatalk 2.0.4
+.\" Language: English
+.\"
+.TH "CNID_METAD" "8" "23 Apr 2009" "Netatalk 2\&.0\&.4" "Netatalk 2.0.4"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
cnid_metad \- start cnid_dbd daemons on request
-.SH SYNOPSIS
-.B cnid_metad
-[
-.B -d
-]
-[
-.B -h
-.I hostname
-]
-[
-.B -p
-.I port
-]
-[
-.B -u
-.I user
-]
-[
-.B -g
-.I group
-]
-[
-.B -s
-.I cnid_dbd pathname
-]
-.SH DESCRIPTION
-.B cnid_metad
+.SH "SYNOPSIS"
+.HP \w'\fBcnid_metad\fR\fB\fR\ 'u
+\fBcnid_metad\fR\fB\fR [\-d] [\-h\ \fIhostname\fR] [\-p\ \fIport\fR] [\-u\ \fIuser\fR] [\-g\ \fIgroup\fR] [\-s\ \fIcnid_dbdpathname\fR]
+.SH "DESCRIPTION"
+.PP
+\fBcnid_metad\fR
waits for requests from
-.BR afpd
+\fBafpd\fR
to start up instances of the
-.BR cnid_dbd
-daemon. It keeps track of the status of a
-.BR cnid_dbd
-instance once started and will restart it if necessary.
-.B cnid_metad
+\fBcnid_dbd\fR
+daemon\&. It keeps track of the status of a
+\fBcnid_dbd\fR
+instance once started and will restart it if necessary\&.
+\fBcnid_metad\fR
is normally started at boot time from
-.BR /etc/rc
-or equivalent and runs until shutdown.
-.BR afpd
-needs to be configured with the
-.B -cnidserver
+/etc/rc
+or equivalent and runs until shutdown\&.
+\fBafpd\fR
+needs to be configured with the
+\fB\-cnidserver\fR
option in
-.BR afpd.conf
+\fBafpd\&.conf\fR
in order to access
-.B cnid_metad.
+\fBcnid_metad\&.\fR
It is possible to run more than one instance of
-.B cnid_metad
+\fBcnid_metad\fR
on the same machine if different values for the interface and/or port are specified with the
-.B -h
+\fB\-h\fR
and
-.B -p
-options.
-
-.SH OPTIONS
-.TP
-.B \-d
-.B cnid_metad will remain in the foreground and
-will also leave the standard input, standard output and standard error
-file descriptors open. Useful for debugging.
-.TP
-.BI \-h " hostname"
-Use
-.I hostname
-as the network interface for requests as opposed to
-the default
-.B "localhost".
-.TP
-.BI \-p " port"
-Use
-.I port
-as the
-port number for reqests. Default is 4700.
-.TP
-.BI \-u " user"
-Switch to the userid of
-.I user
-before serving requests. This userid will be
-inherited by all
-.BR cnid_dbd
-daemon processes started.
-.TP
-.BI \-u " group"
-Switch to the groupid of
-.I group
-before serving requests. This groupid will be inherited by all
-.BR cnid_dbd
-daemon processes started. Both
-.I user
-and
-.I group
-must be specified as strings.
-.TP
-.BI \-s " cnid_dbd pathname"
-Use
-.I cnid_dbd pathname
-as the pathname
-of the executeable of the
-.BR cnid_dbd
-daemon. The default is
-.IR :SBINDIR:/cnid_dbd.
-.SH CAVEATS
-The number of
-.BR cnid_dbd
-subprocecesses is currently limited to 128. This restriction will be
-lifted in the future.
-.LP
-.B cnid_metad
-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
-.BR cnid_dbd's
-started by that
-.B cnid_metad
-to exit gracefully.
-Since state about and IPC access to the
-subprocesses is only maintained in memory by
-.B cnid_metad
-this is desired behaviour. As soon as
-.B cnid_metad
-is restarted
-.BR afpd
-processes will transparently reconnect.
-
-.SH SEE ALSO
-.BR cnid_dbd (1),
-.BR afpd (8)
-
-
-
-
-
-
+\fB\-p\fR
+options\&.
+.SH "OPTIONS"
+.PP
+\fB\-d\fR
+.RS 4
+\fBcnid_metad will remain in the foreground and\fR
+will also leave the standard input, standard output and standard error file descriptors open\&. Useful for debugging\&.
+.RE
+.PP
+\fB\-h\fR\fI hostname\fR
+.RS 4
+Use
+\fIhostname\fR
+as the network interface for requests as opposed to the default
+\fBlocalhost \fR\&.
+.RE
+.PP
+\fB\-p\fR\fI port\fR
+.RS 4
+Use
+\fIport\fR
+as the port number for reqests\&. Default is 4700\&.
+.RE
+.PP
+\fB\-u\fR\fI user\fR
+.RS 4
+Switch to the userid of
+\fIuser\fR
+before serving requests\&. This userid will be inherited by all
+\fBcnid_dbd\fR
+daemon processes started\&.
+.RE
+.PP
+\fB\-u\fR\fI group\fR
+.RS 4
+Switch to the groupid of
+\fIgroup\fR
+before serving requests\&. This groupid will be inherited by all
+\fBcnid_dbd\fR
+daemon processes started\&. Both
+\fIuser\fR
+and
+\fIgroup\fR
+must be specified as strings\&.
+.RE
+.PP
+\fB\-s\fR\fI cnid_dbd pathname\fR
+.RS 4
+Use
+\fIcnid_dbd pathname\fR
+as the pathname of the executeable of the
+\fBcnid_dbd\fR
+daemon\&. The default is
+\fI:SBINDIR:/cnid_dbd\&.\fR
+.RE
+.SH "CAVEATS"
+.PP
+The number of
+\fBcnid_dbd\fR
+subprocecesses is currently limited to 512\&.
+.PP
+\fBcnid_metad\fR
+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
+\fBcnid_dbd\'s\fR
+started by that
+\fBcnid_metad\fR
+to exit gracefully\&. Since state about and IPC access to the subprocesses is only maintained in memory by
+\fBcnid_metad\fR
+this is desired behaviour\&. As soon as
+\fBcnid_metad\fR
+is restarted
+\fBafpd\fR
+processes will transparently reconnect\&.
+.SH "SEE ALSO"
+.PP
+\fBcnid_dbd\fR(8),
+\fBafpd\fR(8)
projects / netatalk.git / blobdiff