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

These are the same utilities before with minor bugfixes and some donated
support from G4KLX. Please see the README in src and note that the new
listen command is subject to the KA9Q license _NOT_ the GNU one.

Changes:
	o	G4KLX provided a much smarter 'listen' and added speed to
		the axattach program.
	o	Fixed missing NULL in config.c so -p 4445 says no such port
		rather than segmentation fault.
	o	Missing '*' in axattach caused. This was nasty and caused
		output of invalid callsigns with lowercase callsign 
		specification.
	o	Manuals updated to reflect my new address.
	o	Manuals rejigged and cleaned up. Structure chnaged to keep
		all common 'man' programs happy.
	o	axarp,axaddarp,axdelarp no longer used ('arp' understands)


To configure

	edit /usr/local/ax25/etc/ports and follow the example for your
	configuration. Note that the pms is as yet unfinished and also
	contains hard coded references to me (alter and recompile if
	you want to use it)

To install

	cd /usr/local/ax25/src
	make install

	edit /usr/lib/manpath.conf and add /usr/local/ax25/man to the
	path.

	either by hand or in your boot up scripts add something like

	/usr/local/ax25/bin/axattach /dev/ttyS0 GW4PTS &
	sleep 1
	/sbin/ifconfig sl0 44.131.10.6 netmask 255.255.0.0 broadcast 44.131.10.255 arp mtu 216
	/sbin/route add 44.131.10.0

	

The tools are:

axassociate [callsign] [username]

	Allows you to set up user/callsign maps for a multiuser machine.

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

axsetcall [tty] [callsign]

	Change callsign on a port.

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)
	~yu [filename]  YAPP upload
	~yd [filename]  YAPP download

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


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.
