LinuxNode v0.2.4

Copyright (C) 1996 by Tomi Manninen.

This is a simple node frontend for Linux kernel AX.25, NETROM,
ROSE and TCP. It's based on pms.c by Alan Cox (GW4PTS) but has been
heavily modified since. It's probably not very well tested, not
pretty, not very flexible and it is certainly not ready! However
I think it's already somewhat usable.

Node is intended to be called from ax25d or inetd. It doesn't need
any command line arguments.

/etc/ax25/ax25d.conf should have something like this in it:

  # AX.25
  [OH2BNS VIA 144]
  default  * * * * * *  -    root  /usr/bin/node  node

  # NETROM
  <netrom>
  default  * * * * * *  -    root  /usr/bin/node  node

/etc/inetd.conf could have something like this in it:

  # Set up LinuxNode to listen at telnet port
  telnet  stream  tcp     nowait  root    /usr/bin/node     node

Note that LinuxNode should always be run as root. Otherwise outgoing
connects won't work. Also ping needs a raw socket which requires root
priviledges.

LinuxNode can also be called from command line. It then uses kernel
axassociation table to find a call associated to the user. Again
for outgoing connects (and ping) to work LinuxNode needs to be
installed setuid root.

Edit /etc/ax25/node.conf and /etc/ax25/node.perms for your
particular system.

LinuxNode uses the LOG_LOCAL7 syslog facility to log its messages to
the system log. In my RedHat distribution almost all syslog messages
are by default forwarded to /var/log/messages file. If LinuxNode is
used in a busy multiport environment and with LogLevel set to log
everything, it can produce quite a lot of output to the system logs.
I therefore forward all messages from LinuxNode to a separate file.
This can be done in /etc/syslog.conf with something like this:

# Log anything (except mail) of level info or higher.
# Don't log private authentication messages!
# Don't log LinuxNode messages either.
*.info;mail.none;authpriv.none;local7.none	/var/log/messages

# LinuxNode messages
local7.*					/var/log/node

Remember to create the logfile and to send a SIGHUP to syslogd after
you make the changes.

TODO:

     Lots of things (I suppose... Does anyone have any suggestions?).

-- 
Tomi Manninen
OH2BNS@OH2RBI.FIN.EU
tomi.manninen@hut.fi
