appletalk.cfg(5) appletalk.cfg(5)
NAME
appletalk.cfg
DESCRIPTION
appletalk.cfg is the default configuration file read by the appletalk
command when AppleTalk is being configured to perform routing or multi-
homing.
SYNTAX
This section describes the syntax for /etc/appletalk.cfg, which is the
default configuration file used by the appletalk command to specify
interfaces, also known as "ports", and zones, when the "-r" or the "-x"
option is entered. Note that in multi-homing (-x) mode, only non-seed
interfaces may be specified. In routing (-r) mode, seed interfaces,
zones, and non-seed interfaces may be specified.
A pound (#) character in the first column of a line designates that
line as a comment.
Fields within an entry are separated by colons (:).
The format for interface definitions is as follows:
<if>:<start>:<end>
where <if> is a valid interface (e.g. en1) and <start> and <end> are
the starting and ending network numbers for that interface. If the
<end> value is omitted the ending network is assumed to be the same as
the <start> value. if no network values are supplied, the port will be
configured as a non-seed port.
One and only one port must be designated as the home port by an aster-
isk in the last field of an entry. Valid home port designations are
shown below:
en5:45:50:*
en9:*
The format for zone name entries is as follows:
:<name>:<if1>:<if2>:...<ifn>
Zone entries must begin with a colon (:) in the first column the first
field, <name> is the zone name which must be no longer than 32 charac-
ters. A list of interfaces assigned to that zone name, separated by
colons, follow the zone name. The home zone must be designated by
placing an asterisk in the last field of the entry as for the home port
above. There must be only one home zone and the home port must be
listed in this entry.
If there is only one zone assigned to the home seed interface, it will
automatically be chosen as the home zone, even if there is no trailing
asterisk.
When the home port is is on a "secondary" port (ie, a config line like
"en1:*") then the home zone will be whatever the seed router for that
network is providing. This is a valid configuration.
When AppleTalk is configured to run in multi-home or router mode, there
must be at least one "primary" (seed) router on each segment, otherwise
a "secondary" (non-seed) router won't get it's network range and zone
list for that port.
A seed port must have one or more zones associated (seeded) with it.
Note that the same zone name can be used on one or more ports. Zones
cannot be associated with ports that are non-seed.
A global network made of several segments will have at least one zone.
If only one zone is present in the network, a zone list will not appear
in the MacOS "Chooser", however the zone name does exist and is
exchanged by routers.
Entries for zones and interfaces can be intermixed throughout the file.
Note: all values are in decimal except where noted.
EXAMPLES
Below are some sample valid configurations:
#
# example 1:
#
en2:10:19:*
:home zone en2:en2:*
:2nd et2 zone:en2
en3:20:29
:en3 zone:en3
#
# example 2: (all non-seed)
#
en0:
en2:
en3:*
#
# example 3:
#
en0:10:20
en1:21:*
en2:31:40
en3:
:only zone for en1:en1:*
:another zone:en0:en2
:still another:en2
:one last zone:en0:en2
FILES
/etc/appletalk.cfg
Configuration file
/usr/sbin/appletalk
Executable file
SEE ALSO
appletalk(8)
appletalk.cfg(5)
Mac OS X 10.5 - Generated Sun Oct 28 21:43:41 EDT 2007