-.TH ATALKD 8 "17 Nov 1995" "netatalk 1.3"
-.SH NAME
+'\" t
+.\" Title: atalkd
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
+.\" Date: 06 Sep 2004
+.\" Manual: Netatalk 2.1
+.\" Source: Netatalk 2.1
+.\" Language: English
+.\"
+.TH "ATALKD" "8" "06 Sep 2004" "Netatalk 2.1" "Netatalk 2.1"
+.\" -----------------------------------------------------------------
+.\" * 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
-.B :SBINDIR:/atalkd
-[
-.B -f
-.I configfile
-] [
-.B -1
-|
-.B -2
-]
-.SH DESCRIPTION
-.B 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
-.BR ping (8)).
-.B atalkd
+.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
+\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
-.B /etc/rc.
-It first reads from its configuration file,
-.BR :ETCDIR:/atalkd.conf .
-If there is no configuration file,
-.B 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
-.RB ` # '
-in the first column are ignored, as are blank lines. The syntax is
-.RS
-.sp
-.I interface
+/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
+\fIinterface\fR
[
-.B -seed
+\fB\-seed\fR
] [
-.B -phase
-.I number
+\fB\-phase\fR
+\fInumber\fR
] [
-.B -net
-.I net-range
+\fB\-net\fR
+\fInet\-range\fR
] [
-.B -addr
-.I address
+\fB\-addr\fR
+\fIaddress\fR
] [
-.B -zone
-.I zonename
-] ...
-.sp
-.RE
-Note that all field except the
-.I interface
-are optional. The loopback interface is configured automatically. If
-.B -seed
-is specified, all other fields must be present. Also,
-.B atalkd
-will exit during bootstrapping, if a router disagrees with its seed
-information. If
-.B -seed
-is not given, all other information may be overriden during
-auto-configuration. If no
-.B -phase
-option is given, the default phase as given on the command line is used
-(the default is 2). If
-.B -addr
+\fB\-zone\fR
+\fIzonename\fR
+] \&.\&.\&.
+.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,
+\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
-.B -net
-is not, a
-.I net-range
-of one is assumed.
-.LP
-The first
-.B -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.
-.B 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.
-.BR afpd ,
-must individually specify the desired zone. See also
-.BR nbp_name (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.
-.LP
-.B atalkd
-can provide routing between interfaces by configuring multiple
-interfaces. Each interface must be assigned a unique
-.I 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
-.IR net-range ,
-i.e. if you have three machines on an Ethernet, don't chose a
-.I net-range
-of 1000-2000. Each
-.I net-range
-may have an arbitrary list of zones associated with it.
-.SH EXAMPLE
-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.
-.sp
-.RS
+\fB\-net\fR
+is not, a net\-range of one is assumed\&.
+.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\&.
+\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
+ le0
+ le1 \-seed \-net 9461\-9471 \-zone netatalk \-zone Argus
.fi
+.if n \{\
.RE
+.\}
.sp
-.B atalkd
-automatically acts as a router if there is more than one interface.
-.SH FILES
-.TP 30
-.B :ETCDIR:/atalkd.conf
+\fBatalkd\fR
+automatically acts as a router if there is more than one interface\&.
+.SH "FILES"
+.PP
+:ETCDIR:/atalkd\&.conf
configuration file
-.SH BUGS
-On some systems, atalkd can not be restarted.
+.SH "BUGS"
+.PP
+On some systems,
+\fBatalkd\fR
+can not be restarted\&.
+.SH "SEE ALSO"
+.PP
+\fBatalkd.conf\fR(5)
projects / netatalk.git / blobdiff