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 desig-
       nates 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 con-
       figured as a non-seed port.

       One and only one port must be designated as the home  port
       by  an asterisk 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 col-
       umn the first field, <name> is the zone name which must be
       no longer  than  32  characters.   A  list  of  interfaces
       assigned  to  that  zone name, separated by colons, follow
       the zone name.  The home zone must be designated by  plac-
       ing  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 inter-

       When the home port is is on a "secondary" port (ie, a con-
       fig 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  net-
       work,  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:*
        :one last zone:en0:en2

FILES

       /etc/appletalk.cfg
           Configuration file

       /usr/sbin/appletalk
           Executable file

SEE ALSO

       appletalk(8)