*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> atconfig (1)              


     ATCONFIG(1M)     K-Talk by	Xinet (10/14/99	10.1)	  ATCONFIG(1M)

     NAME    [Toc]    [Back]
	  /usr/etc/appletalk/atconfig -	enable AppleTalk on an

     SYNOPSIS    [Toc]    [Back]
	  atconfig intr	[-net n] [-optnet n] [-optstart	sn -optend en]
	  [-node d] [-start sn -end en]	[-f] [-D]
	  atconfig -clear
	  atconfig -attach intr

     DESCRIPTION    [Toc]    [Back]
	  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

	  -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

	  -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 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).
	       If the start and	end are	not specified, atconfig

     Page 1					    (printed 5/15/100)

     ATCONFIG(1M)     K-Talk by	Xinet (10/14/99	10.1)	  ATCONFIG(1M)

	       defaults	to the range already in	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

	  -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

	  -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.

	       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.

	       is used on Streams implementations (currently, only
	       Solaris)	to make	an interface ``known'' by the
	       AppleTalk Protocol, but does not	configure it.  This is
	       used to allow routing packets through on	an interface
	       in order	to determine the prefered net range.  On these
	       systems,	an interface will not show up in the atinfo(1)
	       list until it has either	been attached or configured.

     DIAGNOSTICS    [Toc]    [Back]
	  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: ...

     Page 2					    (printed 5/15/100)

     ATCONFIG(1M)     K-Talk by	Xinet (10/14/99	10.1)	  ATCONFIG(1M)

		    atconfig could not open an AppleTalk socket.  This
		    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.

	  atconfig: illegal parameters start=x net=y end=z.  startnet <= net <=	endnet
		    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    [Toc]    [Back]
	  The first interface to be successfully configured becomes
	  your default interface.  This	is the interface where
	  AppleTalk services are registered.

     FILES    [Toc]    [Back]

     Page 3					    (printed 5/15/100)

     ATCONFIG(1M)     K-Talk by	Xinet (10/14/99	10.1)	  ATCONFIG(1M)

	  /usr/etc/appletalk/services	The file where atconfig
					commands are placed.

     SEE ALSO    [Toc]    [Back]

     Page 4					    (printed 5/15/100)

[ Back ]
 Similar pages
Name OS Title
atinfo IRIX print the AppleTalk information for each interface
atalk OpenBSD AppleTalk Protocol Family
atservers IRIX print AppleTalk services
getzones IRIX print AppleTalk zones
atping IRIX ping an AppleTalk node
papstatus IRIX AppleTalk Printer Status program
ddp Linux Linux AppleTalk protocol implementation
nbpd IRIX AppleTalk Name Binding Protocol daemon
atstat IRIX dump the AppleTalk tables and statistics
myzone IRIX print the host's AppleTalk zone
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service