man/man8/atalkd.8.tmpl

   1 '\" t
   2 .\"     Title: atalkd
   3 .\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.74.3 <http://docbook.sf.net/>
   5 .\"      Date: 06 Sep 2004
   6 .\"    Manual: Netatalk 2.1
   7 .\"    Source: Netatalk 2.1
   8 .\"  Language: English
   9 .\"
  10 .TH "ATALKD" "8" "06 Sep 2004" "Netatalk 2.1" "Netatalk 2.1"
  11 .\" -----------------------------------------------------------------
  12 .\" * set default formatting
  13 .\" -----------------------------------------------------------------
  14 .\" disable hyphenation
  15 .nh
  16 .\" disable justification (adjust text to left margin only)
  17 .ad l
  18 .\" -----------------------------------------------------------------
  19 .\" * MAIN CONTENT STARTS HERE *
  20 .\" -----------------------------------------------------------------
  21 .SH "NAME"
  22 atalkd \- AppleTalk RTMP, NBP, ZIP, and AEP manager
  23 .SH "SYNOPSIS"
  24 .HP \w'\fBatalkd\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\ 'u
  25 \fBatalkd\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR\fB\fR [\-f\ \fIconfigfile\fR] [\-1] [\-2]
  26 .SH "DESCRIPTION"
  27 .PP
  28 \fBatalkd\fR
  29 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
  30 \fBping\fR(8))\&.
  31 \fBatalkd\fR
  32 is typically started at boot time, out of
  33 /etc/rc\&. It first reads from its configuration file,
  34 :ETCDIR:/atalkd\&.conf\&. If there is no configuration file,
  35 \fBatalkd\fR
  36 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
  37 .PP
  38 \fIinterface\fR
  39 [
  40 \fB\-seed\fR
  41 ] [
  42 \fB\-phase\fR
  43 \fInumber\fR
  44 ] [
  45 \fB\-net\fR
  46 \fInet\-range\fR
  47 ] [
  48 \fB\-addr\fR
  49 \fIaddress\fR
  50 ] [
  51 \fB\-zone\fR
  52 \fIzonename\fR
  53 ] \&.\&.\&.
  54 .PP
  55 Note that all fields except the interface are optional\&. The loopback interface is configured automatically\&. If
  56 \fB\-seed\fR
  57 is specified, all other fields must be present\&. Also,
  58 \fBatalkd\fR
  59 will exit during bootstrap\%ping, if a router disagrees with its seed information\&. If
  60 \fB\-seed\fR
  61 is not given, all other information may be overriden during auto\-configuration\&. If no
  62 \fB\-phase\fR
  63 option is given, the default phase as given on the command line is used (the default is 2)\&. If
  64 \fB\-addr\fR
  65 is given and
  66 \fB\-net\fR
  67 is not, a net\-range of one is assumed\&.
  68 .PP
  69 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\&.
  70 \fBatalkd\fR
  71 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\&.
  72 \fBafpd\fR, must individually specify the desired zone\&. See also
  73 \fBnbp_name\fR(3)\&.
  74 .SH "ROUTING"
  75 .PP
  76 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\&.
  77 .PP
  78 \fBatalkd\fR
  79 can provide routing between interfaces by configuring multiple interfaces\&. Each interface must be assigned a unique net\-range
  80 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\&.
  81 .SH "EXAMPLES"
  82 .PP
  83 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\&.
  84 .PP
  85 .if n \{\
  86 .RS 4
  87 .\}
  88 .nf
  89    le0
  90    le1 \-seed \-net 9461\-9471 \-zone netatalk \-zone Argus
  91 .fi
  92 .if n \{\
  93 .RE
  94 .\}
  95 .sp
  96 \fBatalkd\fR
  97 automatically acts as a router if there is more than one interface\&.
  98 .SH "FILES"
  99 .PP
 100 :ETCDIR:/atalkd\&.conf
 101 configuration file
 102 .SH "BUGS"
 103 .PP
 104 On some systems,
 105 \fBatalkd\fR
 106 can not be restarted\&.
 107 .SH "SEE ALSO"
 108 .PP
 109 \fBatalkd.conf\fR(5)