man/man8/atalkd.8.tmpl

   1 .TH atalkd 8 "06 Sep 2004" 2.0.3 Netatalk
   2 .SH NAME
   3 atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager
   4 .SH SYNOPSIS
   5 \fBatalkd\fR [\-f \fBconfigfile\fR] [\-1] [\-2]
   6 .SH DESCRIPTION
   7 atalkd is responsible for all user level
   8 AppleTalk network management. This includes routing, name registration and
   9 lookup, zone lookup, and the AppleTalk Echo Protocol (similar to
  10 \fBping\fR(8)). atalkd is typically started at boot
  11 time, out of \fB/etc/rc\fR. It first reads from its
  12 configuration file, \fB:ETCDIR:/atalkd.conf\fR. If there is
  13 no configuration file, atalkd will attempt to configure
  14 all available interfaces and will create a configuration file. The file
  15 consists of a series of interfaces, one per line. Lines with `#' in the
  16 first column are ignored, as are blank lines. The syntax is
  17 .PP
  18 \fIinterface\fR [ \fB\-seed\fR ]
  19 [ \fB\-phase\fR \fInumber\fR ] [
  20 \fB\-net\fR \fInet\-range\fR ] [
  21 \fB\-addr\fR \fIaddress\fR ] [
  22 \fB\-zone\fR \fIzonename\fR ] ...
  23 .PP
  24 Note that all fields except the interface are optional. The loopback
  25 interface is configured automatically. If \fB\-seed\fR is
  26 specified, all other fields must be present. Also,
  27 atalkd will exit during bootstrap\%ping, if a router
  28 disagrees with its seed information. If \fB\-seed\fR is not
  29 given, all other information may be overriden during auto\-configuration.
  30 If no \fB\-phase\fR option is given, the default phase as given
  31 on the command line is used (the default is 2). If \fB\-addr\fR
  32 is given and \fB\-net\fR is not, a net\-range of one is
  33 assumed.
  34 .PP
  35 The first \-zone directive for each interface is the ``default''
  36 zone. Under Phase 1, there is only one zone. Under Phase 2, all routers on
  37 the network are configured with the default zone and must agree.
  38 atalkd maps ``*'' to the default zone of the first
  39 interface. Note: The default zone for a machine is determined by the
  40 configuration of the local routers; to appear in a non\-default zone, each
  41 service, e.g. afpd, must individually specify the
  42 desired zone. See also \fBnbp_name\fR(3).
  43 .SH ROUTING
  44 If you are connecting a netatalk router to an existing AppleTalk
  45 internet, you should first contact your local network administrators to
  46 obtain appropriate network addresses.
  47 .PP
  48 atalkd can provide routing between interfaces by
  49 configuring multiple interfaces. Each interface must be assigned a unique
  50 net\-range between 1 and 65279 (0 and 65535 are illegal, and addresses
  51 between 65280 and 65534 are reserved for startup). It is best to choose
  52 the smallest useful net\-range, i.e. if you have three machines on an
  53 Ethernet, don't chose a net\-range of 1000\-2000. Each net\-range may have an
  54 arbitrary list of zones associated with it.
  55 .SH EXAMPLES
  56 Below is an example configuration file for a sun4/40. The machine
  57 has two interfaces, ``le0'' and ``le1''. The ``le0'' interface is
  58 configured automatically from other routers on the network. The machine is
  59 the only router for the ``le1'' interface.
  60 .PP
  61 .nf
  62    le0
  63    le1 \-seed \-net 9461\-9471 \-zone netatalk \-zone Argus
  64 .fi
  65
  66 atalkd
  67 automatically acts as a router if there is more than one interface.
  68 .SH FILES
  69 \fB:ETCDIR:/atalkd.conf\fR configuration file
  70 .SH BUGS
  71 On some systems, atalkd can not be
  72 restarted.
  73 .SH "SEE ALSO"
  74 \fBatalkd.conf\fR(5)
  75