ATCONFIG(1M) K-Talk by Xinet (18 Nov 1997 8.2) ATCONFIG(1M)
NAME
/usr/etc/appletalk/atconfig - enable AppleTalk on an
interface
SYNOPSIS
atconfig intr [-net n] [-optnet n] [-optstart sn -optend en]
[-node d] [-start sn -end en] [-phase {1,2}] [-f] [-D]
atconfig -clear
DESCRIPTION
The atconfig command enables AppleTalk on an interface. It
is similar in function to ifconfig(1m). When atconfig is
run, the interface uses the Apple Address Resolution
Protocol (AARP) to determine its net and node number. When
run on the loopback lo0, atconfig sets the net and node of a
local pseudo-network. Specifying a intr of "default" will
configure the first interface in the ifaddr list. All
numeric arguments may be specified in hexadecimal by
prepending them with a 0x. The flags are defined as
follows:
-net n
Specifies that atconfig will use net number n. If a net
number is specified, and it conflicts with net
information gathered from RTMP packets, EINVAL will be
returned. A net number must be specified when
configuring the loopback interface (lo0).
-optnet n
Specifies that atconfig will use net number n, net
range n-n. This differs from -net in that if there is
another router using a different net number, no error
message will be returned. If -optstart and -optend
are used, they specify a network range to be used only
if it does not conflict with an existing router.
These modes are useful for configuring K-Talk on a
network where other AppleTalk routers exist, but are
not reliable.
-node d
This specifies that AARP will begin trying to acquire a
node number at node d. If the node number is not
specified, it defaults to 128 (0x80). It does not
specify the actual node number obtained, only where to
start.
-start sn -end en
This specifies the start and end of the network range.
These arguments are only used when you want to set up
an extended network range (more than one node number)
for a Phase II network. If the start and end are not
specified, atconfig defaults to the range already in
Page 1 (printed 3/13/98)
ATCONFIG(1M) K-Talk by Xinet (18 Nov 1997 8.2) ATCONFIG(1M)
use on the network (if there are other routers), or to
provisional mode there are no other routers. In
provisional mode, network range 65280-65534 (the
provisional range) is used. This will allow K-Talk to
communicate with other AppleTalk devices on an
Ethertalk network with no routers.
-phase {1,2}
This argument sets the phase of the interface to either
Phase 1 or Phase 2. Attempts to set the phase in
conflict to a pre-existing phase will return
EPROTOTYPE. atinfo(1) can be used to display the
phase(s) in which it is possible to bring up an
interface. The default is Phase 2 if no other routers
are present and a phase argument is not specified.
-f specifies that atconfig will use the specified net
number for the local pseudo-net even if it already
appears in routing tables. This option is used to
maintain single numbers for the pseudo-net when there
are routers that do not properly process delete-route
packets.
-D causes debugging information to be printed first when
the flag is encountered in the command line, and again
when the arguments have been processed. It is mostly
used to check argument parsing.
-clear
is used to reset all AppleTalk kernel information. It
should be done only when all AppleTalk services have
been halted (with an atinit halt). It will clear all
interface configuration information, as well as the
AARP and routing tables. After clearing the interface,
you should wait for 10 seconds to allow the routing
tables to be rebuilt before running any additional
atconfig commands. The main use of the -clear option
is to clear a configuration when you plan to switch
your network configuration.
DIAGNOSTICS
atconfig: old-style arguments. New command would be: ...
The arguments passed to atconfig were in the
format of old versions of atconfig A new-style
command line will be printed to ease conversion.
atconfig: permission denied
You must be root to configure interfaces.
atconfig: socket: ...
atconfig could not open an AppleTalk socket. This
Page 2 (printed 3/13/98)
ATCONFIG(1M) K-Talk by Xinet (18 Nov 1997 8.2) ATCONFIG(1M)
usually means that AppleTalk is not installed in
the kernel.
atconfig: invalid interface xx
The specified interface is not valid. Use
atinfo(1) to get a list of the interfaces.
atconfig: interface xx already configured
The interface is already configured. You must
clear it with atconfig -clear before you can
configure it again.
atconfig: no net number specified on net with no other routers
This means that you did not specify a net number
on a network that does not have any other
AppleTalk routers. You need to specify a network
number with a -net flag. To do this, edit
/usr/etc/appletalk/services and change the
atconfig line for the interface.
<= endnet
atconfig: illegal parameters start=x net=y end=z. startnet<= net
One of the parameters startnet, endnet, or net is
invalid. Usually means that you set a net number
that was not within the existing network range.
To fix this, edit /usr/etc/appletalk/services and
remove the conflicting -net argument from the
atconfig line for the interface.
atconfig: SIOSETADDR failed (xx): ...
The ioctl to set the address failed. Usually this
means that the parameters specified conflict with
configurations already existing on the network.
atconfig: K-Talk kernel modules not loaded
If you are running a system with loadable kernel
modules, the loading of the kernel modules failed.
Check for error messages from atalkmodload. If
you are not running a system with loadable kernel
modules, then you are running a non-AppleTalking
kernel. Use mkkernel to build an AppleTalking
kernel, copy it to /, and reboot.
CAVEATS
The first interface to be successfully configured becomes
your default interface. This is the interface where
AppleTalk services are registered.
FILES
Page 3 (printed 3/13/98)
ATCONFIG(1M) K-Talk by Xinet (18 Nov 1997 8.2) ATCONFIG(1M)
/usr/etc/appletalk/services The file where atconfig
commands are placed.
SEE ALSO
atinfo(1)
Page 4 (printed 3/13/98)