man/man8/atalkd.8.tmpl

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