This version of the AX.25 Utilities includes support for the Rose protocol.
In order to be able to compile the utilities a copy of the Rose header file
is needed. Unless you are using ax25-module-4 or later you will need that
header file, for your convenience a copy is located in the lib directory. If
you are using ax25-module-4 or later then you should delete (or rename) this
file and install the axattach.c patch that is found in the ax25-module-4 tar
file as instructed by the README in that distribution. So briefly, here is
what you do:

IF Linux kernel version earlier than 2.0.12 THEN
	GET ax25-utils-2.0a instead
	EXIT
END-IF

IF Linux kernel source code patched with ax25-module-4 or later THEN
	DELETE lib/rose.h
END-IF

IF Linux kernel source code patched with any ax25-module-x THEN
	PATCH ax25/axattach.c with patch in ax25-module-x
END-IF

RUN make config
RUN make
RUN make install

EXIT

Please note that the ncurses package must be installed for these utilities
to compile. To check for its existence, see if there is a directory named
/usr/include/ncurses on your system, if it exists then you have ncurses
(probably). If it does not exist check the file /usr/include/curses.h, if it
contains text like 'ncurses' or 'NCURSES' then you are probably OK too. If
both of these fail, you must get ncurses from your favourite internet site
or CD-ROM.

First type "configure" which runs a shell script which will determine the
layout of your system. If it is unable to proceed it will give an
informative error message as to why and exit. The type "make" to create the
binaries, and "make install" to copy the binaries and manual pages into
their final resting places. Doing a "make installconf" will install the
default configuration files, this is not done automatically so as not to
overwrite existing files. A "make clean" will remove the .o files and any
editor backup files left hanging around, "make distclean" does the same as
"make clean" and in addition deletes the binaries too.

With this release the locations of the binaries, manual pages and the
configuration files has been changed. There is no overlap between the old
and new locations, however leaving the old binaries untouched will result in
problems due to the order of the PATH variable may mean that the newer
versions may not be used. I have therefore created a shell script called
'convax25' which will copy the old configuration files to the new location,
rename two of those files in the process, rename all the old binaries to to
NAME.old and delete the old manual pages.

If you are an existing AX.25 Utilities user do:

make config
make
make install
make installconf
convax25

and if you are a new AX.25 Utilities user do:

make config
make
make install
make installconf

Then go into the directory /etc/ax25 and modify the congiguration files you
find there.

The actual source code has been split into the directories apps, ax25, lib
and netrom. Most of the names are self evident, but a little explanation is
in order. The lib directory contains the configuration utilities and some
randomly useful utilities that may be of use to other people writing AX.25
and NET/ROM code for Linux, these utility routines are collected into a
library named axlib.a which is needed by programs in the other directories.

The netrom directory contains source that is specific to NET/ROM protocol
management. The ax25 directory contains code that is specific to AX.25
protocol management and is *needed* for any work with the kernel AX.25 code.
The apps directory is user level code that may be used with both AX.25 and
NET/ROM.

Jonathan G4KLX
