AX.25 support utilities
-----------------------

This is my newer set of AX.25 utilities. This time they are vaguely useful
as opposed to demonstrations.

The tools are:

axaddarp [ipaddr] [callsign]

	Add a permanent arp entry for an AX.25 address. This is often needed
	when talking to thenet nodes.

axarp			

	List AX.25 arp table entries. Although the standard 'arp' program 
	can display AX.25 entries this one also displays the callsigns in
	readable format.

axattach [interface] [callsign]

	Attach a SLIP interface in KISS mode to what is normally a tty line
	connected to a TNC in KISS mode. The hardware parameters and ip 
	parameters of the interface are unchanged. This program should be 
	run in the background. To down an interface send its axattach
	process	a SIGKILL. 
	To set up the ip properties use ifconfig on the interface. For 
	example I do:

		ifconfig sl0 44.131.10.6 netmask 255.255.0.0 broadcast \
			44.131.255.255 arp mtu 257 up

	Once this is done you can route ip packets via the interface in the
	same way as any other ip interface layer.

	BUGS:
	There ought to be a single config file this program reads and sets
	all the IP and hardware parameters from.
	
axdelarp [ipaddr]

	Delete an AX.25 arp entry. Actually it should work for any arp entry
	now.

axl [-p port]

	Listen for connections on an AX.25 port. Each connection is accepted
 	and /usr/local/ax25/pms/bin/pms is executed. The PMS is scarecely 
	begun as yet.

beacon ["text"]

	Output a beacon message every 30 minutes. The message is directed at
	 'IDENT' and is sent on all AX.25 ports configured.

call [-d] [-p port] [-w window] [callsign]

	Call is the general purpose AX.25 connection program. As is normal
	in AX.25 it runs entirely in line mode. All CR/LF translation is done
	transparently. The options are

	-d		Turn on socket level debugging
	-p port 	Select a port to use (the default is 1)
	-w window	Specify a specific AX.25 window for this
			connection.

	The call program interprets lines beginning with a '~' specially.
	The following '~' escapes are available.

	~?		List escapes
	~~		A ~ symbol
	~Z		Suspend program
	~.		Close connection
	~! [command]	Run a command
	~o [filename]	Open a logfile (default 'logfile.txt')
	~c		Close the logfile
	~u [filename]	Upload a file (ASCII upload)

	The program provides no terminal emulation features. These are left
	up to the console facilities of the terminal in use. The program is 
	however '8 bit clean'.

	BUGS:
	YAPP and a certain amount of 7plus support in the program itself
	would be a great boon.


listen

	A demonstration of how to use SOCK_PACKET to tap all AX.25 frames at
	RAW interface level. The program then does some simple decoding of 
	frames and presents a running trace of network events.



Configuration

Only one file is currently used for configuration. This is the file
'/usr/local/ax25/etc/ports'. This is an ascii file containing one line for
each AX.25 port in order. The line is formatted as follows

	callsign baudrate window frequency

Currently much of this information is not used.