X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=man%2Fman8%2Fatalkd.8.tmpl;h=819e3889623e5350c4b5ff91e40ba1a0c976b45a;hb=6145c1c31a1a2494fe6ad7ca65f9c2a63a05b07d;hp=42ac78f10a48757e0a69e858e84305c6767b788d;hpb=ecfc96169ab669b578e53fa8e13592934fe37788;p=netatalk.git diff --git a/man/man8/atalkd.8.tmpl b/man/man8/atalkd.8.tmpl index 42ac78f1..819e3889 100644 --- a/man/man8/atalkd.8.tmpl +++ b/man/man8/atalkd.8.tmpl @@ -1,75 +1,109 @@ -.TH atalkd 8 "06 Sep 2004" 2.0.0 Netatalk -.SH NAME +'\" t +.\" Title: atalkd +.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] +.\" Generator: DocBook XSL Stylesheets v1.75.2 +.\" Date: 06 Sep 2004 +.\" Manual: Netatalk 2.2 +.\" Source: Netatalk 2.2 +.\" Language: English +.\" +.TH "ATALKD" "8" "06 Sep 2004" "Netatalk 2.2" "Netatalk 2.2" +.\" ----------------------------------------------------------------- +.\" * set default formatting +.\" ----------------------------------------------------------------- +.\" disable hyphenation +.nh +.\" disable justification (adjust text to left margin only) +.ad l +.\" ----------------------------------------------------------------- +.\" * MAIN CONTENT STARTS HERE * +.\" ----------------------------------------------------------------- +.SH "NAME" atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager -.SH SYNOPSIS -\fBatalkd\fR [\-f \fBconfigfile\fR] [\-1] [\-2] -.SH DESCRIPTION -atalkd is responsible for all user level -AppleTalk network management. This includes routing, name registration and -lookup, zone lookup, and the AppleTalk Echo Protocol (similar to -\fBping\fR(8)). atalkd is typically started at boot -time, out of \fB/etc/rc\fR. It first reads from its -configuration file, \fB:ETCDIR:/atalkd.conf\fR. If there is -no configuration file, atalkd will attempt to configure -all available interfaces and will create a configuration file. The file -consists of a series of interfaces, one per line. Lines with `#' in the -first column are ignored, as are blank lines. The syntax is +.SH "SYNOPSIS" +.HP \w'\fBatalkd\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\ 'u +\fBatalkd\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR [\-f\ \fIconfigfile\fR] [\-1] [\-2] +.SH "DESCRIPTION" .PP -\fIinterface\fR [ \fB\-seed\fR ] -[ \fB\-phase\fR \fInumber\fR ] [ -\fB\-net\fR \fInet\-range\fR ] [ -\fB\-addr\fR \fIaddress\fR ] [ -\fB\-zone\fR \fIzonename\fR ] ... +\fBatalkd\fR +is responsible for all user level AppleTalk network management\&. This includes routing, name registration and lookup, zone lookup, and the AppleTalk Echo Protocol (similar to +\fBping\fR(8))\&. +\fBatalkd\fR +is typically started at boot time, out of +/etc/rc\&. It first reads from its configuration file, +:ETCDIR:/atalkd\&.conf\&. If there is no configuration file, +\fBatalkd\fR +will attempt to configure all available interfaces and will create a configuration file\&. The file consists of a series of interfaces, one per line\&. Lines with `#\' in the first column are ignored, as are blank lines\&. The syntax is .PP -Note that all fields except the interface are optional. The loopback -interface is configured automatically. If \fB\-seed\fR is -specified, all other fields must be present. Also, -atalkd will exit during bootstrap\%ping, if a router -disagrees with its seed information. If \fB\-seed\fR is not -given, all other information may be overriden during auto\-configuration. -If no \fB\-phase\fR option is given, the default phase as given -on the command line is used (the default is 2). If \fB\-addr\fR -is given and \fB\-net\fR is not, a net\-range of one is -assumed. +\fIinterface\fR +[ +\fB\-seed\fR +] [ +\fB\-phase\fR +\fInumber\fR +] [ +\fB\-net\fR +\fInet\-range\fR +] [ +\fB\-addr\fR +\fIaddress\fR +] [ +\fB\-zone\fR +\fIzonename\fR +] \&.\&.\&. .PP -The first \-zone directive for each interface is the ``default'' -zone. Under Phase 1, there is only one zone. Under Phase 2, all routers on -the network are configured with the default zone and must agree. -atalkd maps ``*'' to the default zone of the first -interface. Note: The default zone for a machine is determined by the -configuration of the local routers; to appear in a non\-default zone, each -service, e.g. afpd, must individually specify the -desired zone. See also \fBnbp_name\fR(3). -.SH ROUTING -If you are connecting a netatalk router to an existing AppleTalk -internet, you should first contact your local network administrators to -obtain appropriate network addresses. +Note that all fields except the interface are optional\&. The loopback interface is configured automatically\&. If +\fB\-seed\fR +is specified, all other fields must be present\&. Also, +\fBatalkd\fR +will exit during bootstrap\%ping, if a router disagrees with its seed information\&. If +\fB\-seed\fR +is not given, all other information may be overriden during auto\-configuration\&. If no +\fB\-phase\fR +option is given, the default phase as given on the command line is used (the default is 2)\&. If +\fB\-addr\fR +is given and +\fB\-net\fR +is not, a net\-range of one is assumed\&. .PP -atalkd can provide routing between interfaces by -configuring multiple interfaces. Each interface must be assigned a unique -net\-range between 1 and 65279 (0 and 65535 are illegal, and addresses -between 65280 and 65534 are reserved for startup). It is best to choose -the smallest useful net\-range, i.e. if you have three machines on an -Ethernet, don't chose a net\-range of 1000\-2000. Each net\-range may have an -arbitrary list of zones associated with it. -.SH EXAMPLES -Below is an example configuration file for a sun4/40. The machine -has two interfaces, ``le0'' and ``le1''. The ``le0'' interface is -configured automatically from other routers on the network. The machine is -the only router for the ``le1'' interface. +The first \-zone directive for each interface is the ``default\'\' zone\&. Under Phase 1, there is only one zone\&. Under Phase 2, all routers on the network are configured with the default zone and must agree\&. +\fBatalkd\fR +maps ``*\'\' to the default zone of the first interface\&. Note: The default zone for a machine is determined by the configuration of the local routers; to appear in a non\-default zone, each service, e\&.g\&. +\fBafpd\fR, must individually specify the desired zone\&. See also +\fBnbp_name\fR(3)\&. +.SH "ROUTING" .PP +If you are connecting a netatalk router to an existing AppleTalk internet, you should first contact your local network administrators to obtain appropriate network addresses\&. +.PP +\fBatalkd\fR +can provide routing between interfaces by configuring multiple interfaces\&. Each interface must be assigned a unique net\-range +between 1 and 65279 (0 and 65535 are illegal, and addresses between 65280 and 65534 are reserved for startup)\&. It is best to choose the smallest useful net\-range, i\&.e\&. if you have three machines on an Ethernet, don\'t chose a net\-range of 1000\-2000\&. Each net\-range may have an arbitrary list of zones associated with it\&. +.SH "EXAMPLES" +.PP +Below is an example configuration file for a sun4/40\&. The machine has two interfaces, ``le0\'\' and ``le1\'\'\&. The ``le0\'\' interface is configured automatically from other routers on the network\&. The machine is the only router for the ``le1\'\' interface\&. +.PP +.if n \{\ +.RS 4 +.\} .nf le0 le1 \-seed \-net 9461\-9471 \-zone netatalk \-zone Argus .fi - -atalkd -automatically acts as a router if there is more than one interface. -.SH FILES -\fB:ETCDIR:/atalkd.conf\fR configuration file -.SH BUGS -On some systems, atalkd can not be -restarted. +.if n \{\ +.RE +.\} +.sp +\fBatalkd\fR +automatically acts as a router if there is more than one interface\&. +.SH "FILES" +.PP +:ETCDIR:/atalkd\&.conf +configuration file +.SH "BUGS" +.PP +On some systems, +\fBatalkd\fR +can not be restarted\&. .SH "SEE ALSO" +.PP \fBatalkd.conf\fR(5) -