diff options
Diffstat (limited to 'kiss')
| -rw-r--r-- | kiss/Makefile.am | 3 | ||||
| -rw-r--r-- | kiss/Makefile.in | 8 | ||||
| -rw-r--r-- | kiss/kissattach.8 | 50 | ||||
| -rw-r--r-- | kiss/kissattach.c | 12 | ||||
| -rw-r--r-- | kiss/kissnetd.8 | 26 | ||||
| -rw-r--r-- | kiss/kissparms.8 | 70 | ||||
| -rw-r--r-- | kiss/kissparms.c | 14 | ||||
| -rw-r--r-- | kiss/mkiss.8 | 66 | ||||
| -rw-r--r-- | kiss/net2kiss.8 | 45 |
9 files changed, 289 insertions, 5 deletions
diff --git a/kiss/Makefile.am b/kiss/Makefile.am index 7a130da..82db252 100644 --- a/kiss/Makefile.am +++ b/kiss/Makefile.am @@ -3,6 +3,9 @@ installconf: sbin_PROGRAMS = kissattach kissnetd kissparms mkiss net2kiss +LDADD= $(AX25_LIB) + man_MANS = kissattach.8 kissnetd.8 kissparms.8 mkiss.8 net2kiss.8 +EXTRA_DIST = $(man_MANS) diff --git a/kiss/Makefile.in b/kiss/Makefile.in index 883ef04..ba5b17c 100644 --- a/kiss/Makefile.in +++ b/kiss/Makefile.in @@ -58,15 +58,23 @@ NORMAL_UNINSTALL = : PRE_UNINSTALL = : POST_UNINSTALL = : AWK = @AWK@ +AX25IO_LIB = @AX25IO_LIB@ +AX25_LIB = @AX25_LIB@ CC = @CC@ MAKEINFO = @MAKEINFO@ NCURSES_LIB = @NCURSES_LIB@ PACKAGE = @PACKAGE@ +UTIL_LIB = @UTIL_LIB@ VERSION = @VERSION@ +Z_LIB = @Z_LIB@ sbin_PROGRAMS = kissattach kissnetd kissparms mkiss net2kiss +LDADD = $(AX25_LIB) + man_MANS = kissattach.8 kissnetd.8 kissparms.8 mkiss.8 net2kiss.8 + +EXTRA_DIST = $(man_MANS) mkinstalldirs = $(SHELL) $(top_srcdir)/mkinstalldirs CONFIG_HEADER = ../config.h CONFIG_CLEAN_FILES = diff --git a/kiss/kissattach.8 b/kiss/kissattach.8 new file mode 100644 index 0000000..eabc2a1 --- /dev/null +++ b/kiss/kissattach.8 @@ -0,0 +1,50 @@ +.TH KISSATTACH 8 "13 October 1996" Linux "Linux System Managers Manual" +.SH NAME +kissattach \- Attach a KISS interface +.SH SYNOPSIS +.B kissattach [-i inetaddr] [-l] [-m mtu] [-v] tty port +.SH DESCRIPTION +.LP +Attach a KISS interface to what is normally a tty line connected to a TNC in +KISS mode. This program will turn itself into a background process. To down +an interface send its kissattach process a SIGKILL. +.LP +.B Kissattach +takes many of the parameters for the port from the axports(5) file. If the +speed parameter in the file is not equal to zero then it is used for the +serial port speed, a zero value means that no speed is set. The paclen +parameter is used for the device mtu unless overridden by a value on the +command line. +.LP +The tty argument will typically be that of a serial port with a KISS TNC +attached, although it could be a psuedo tty or a KISS port emulator such as +an SCC card. The port arguments is the name of a port as given in the +axports(5) file. +.SH OPTIONS +.TP 16 +.BI "\-i inetaddr" +Set the internet address of the interface. This address may either be a +dotted decimal address or a host name. +.TP 16 +.BI \-l +Log messages to the system log, the default is not to. +.TP 16 +.BI "\-m mtu" +Sets the mtu of the interface. If this value is not given then the value is +taken from the paclen parameter in axports. +.TP 16 +.BI \-v +Display the version. +.SH "SEE ALSO" +.BR kill (1), +.BR stty (1), +.BR ax25 (4), +.BR axparms (4), +.BR axports (5), +.BR ifconfig (8). +.SH AUTHOR +.nf +Alan Cox GW4PTS <alan@cymru.net> +.br +Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk> +.fi diff --git a/kiss/kissattach.c b/kiss/kissattach.c index 149c2bd..0c80fe4 100644 --- a/kiss/kissattach.c +++ b/kiss/kissattach.c @@ -10,21 +10,29 @@ #include <netdb.h> #include <syslog.h> +#include <config.h> + #include <sys/types.h> #include <sys/stat.h> #include <sys/socket.h> #include <sys/ioctl.h> #include <net/if.h> +#ifdef HAVE_NETAX25_AX25_H #include <netax25/ax25.h> +#else +#include <netax25/kernel_ax25.h> +#endif +#ifdef HAVE_NETROSE_ROSE_H #include <netrose/rose.h> +#else +#include <netax25/kernel_rose.h> +#endif #include <netax25/daemon.h> #include <netax25/axlib.h> #include <netax25/ttyutils.h> -#include <config.h> - #include "../pathnames.h" static char *callsign; diff --git a/kiss/kissnetd.8 b/kiss/kissnetd.8 new file mode 100644 index 0000000..d069ac9 --- /dev/null +++ b/kiss/kissnetd.8 @@ -0,0 +1,26 @@ +.TH KISSNETD 8 "13 October 1996" Linux "Linux System Managers Manual" +.SH NAME +kissnetd \- Create a virtual network. +.SH SYNOPSIS +.B kissnetd [-f size] [-v] tty... +.SH DESCRIPTION +.LP +.B Kissnetd +allows the creation of a virtual network of AX.25 systems that use the KISS +protocol. Each tty named on the command line is opened and any KISS frames +received on tty is copied to the other ttys. This allows a number of AX.25 +systems to share the same packets. +.SH OPTIONS +.TP 10 +.BI "\-f size" +This sets the maximum KISS frame size that the program will handle. The +default is 512 bytes which will be adequate under most circumstances. +.TP 10 +.BI \-v +Enables verbose mode, tracing of data passed is sent to standard output. +.SH "SEE ALSO" +.BR kissattach (8), +.BR kissparms (8), +.BR mkiss (8). +.SH AUTHOR +Frederic Rible F1OAT <frible@teaser.fr> diff --git a/kiss/kissparms.8 b/kiss/kissparms.8 new file mode 100644 index 0000000..ee004de --- /dev/null +++ b/kiss/kissparms.8 @@ -0,0 +1,70 @@ +.TH KISSPARMS 8 "15 October 1996" Linux "Linux System Managers Manual" +.SH NAME +kissparms \- Configure KISS TNCs. +.SH SYNOPSIS +.B kissparms -p <port> [-f y|n] [-h hw] [-l txtail] [-r pers] [-s slot] [-t txd] [-e feclevel] [-v] [-x] +.SH DESCRIPTION +.LP +.B Kissparms +is used to dynamically configure KISS TNCs that have been setup for AX.25 +use by +.B kissattach. +This program uses the packet interface to allow it to communicate with the +KISS TNC without interrupting the AX.25 data stream. Therefore the KISS +parameters may be set at any time during the operation of the AX.25 port. +.LP +A full description of the KISS protocol can be found in the ARRL 6th Computer +Networking Conference papers pp 38-43. While use of the Tx Tail value is +now deprecated, it has been included to satisfy the requirements of users of +old TNC firmware. +.LP +Although this utility was originally designed for controlling KISS TNCs +connected to a serial port, it is used by a number of other Linux packet +radio devices such as the Z8530 SCC driver for controlling their parameters +in exactly the same manner. Therefore +.B kissparms +functionality extends to more than KISS TNCs. +.SH OPTIONS +.TP 12 +.BI "\-p port" +Sets the port that is being configured. +.TP 12 +.BI "\-f y|n" +This sets the TNC into either full duplex ``y'', or half duplex ``n'' mode. +.TP 12 +.BI "\-h hardware" +This is used to set hardware specific parameters. +.TP 12 +.BI "\-e FEC error correction level" +Sets the FEC error correction level in a DSP card based modem (KISS parameter +8). Larger correction level means better noise resistance, but slower +throughput on a good connection. This is an experimental feature found in a +QPSK modem for the Motorola DSP56001 based DSP4 and EVM cards only. +.TP 12 +.BI "\-l txtail" +Sets the TX Tail time in milliseconds. Note that the command to the TNC only +operates in steps of ten milliseconds, so only use values like 10, 20 etc. +.TP 12 +.BI "\-r persist" +Sets the persist value. This parameter is scaled to the range 0 to 255. +.TP 12 +.BI "\-s slottime" +Sets the slottime in milliseconds. Note that the command to the TNC only +operates in steps of ten milliseconds, so only use values like 10, 20 etc. +.TP 12 +.BI "\-t txdelay" +Sets the TX Delay in milliseconds. Note that the command to the TNC only +operates in steps of ten milliseconds, so only use values like 10, 20 etc. +.TP 12 +.BI \-v +Display the version. +.TP 12 +.BI \-x +Takes the TNC out of KISS mode back into ``normal'' mode. This command is +manufacturer specific but works in many cases. This option overrides all +options except the port number. +.SH "SEE ALSO" +.BR axports (5), +.BR kissattach (8). +.SH AUTHOR +Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk> diff --git a/kiss/kissparms.c b/kiss/kissparms.c index 0a1a101..d761f55 100644 --- a/kiss/kissparms.c +++ b/kiss/kissparms.c @@ -3,15 +3,23 @@ #include <unistd.h> #include <string.h> +#include <config.h> + #include <sys/socket.h> #include <netinet/in.h> #include <net/if.h> #include <net/ethernet.h> +#ifdef HAVE_NETAX25_AX25_H #include <netax25/ax25.h> -#include <netax25/axconfig.h> - -#include <config.h> +#else +#include <netax25/kernel_ax25.h> +#endif +#ifdef HAVE_NETROSE_ROSE_H +#include <netrose/rose.h> +#else +#include <netax25/kernel_rose.h> +#endif #define PARAM_TXDELAY 1 #define PARAM_PERSIST 2 diff --git a/kiss/mkiss.8 b/kiss/mkiss.8 new file mode 100644 index 0000000..4c6c973 --- /dev/null +++ b/kiss/mkiss.8 @@ -0,0 +1,66 @@ +.TH MKISS 8 "05 January 1997" Linux "Linux System Managers Manual" +.SH NAME +mkiss \- Attach a multi KISS interface +.SH SYNOPSIS +.B mkiss [-c] [-h] [-l] [-s speed] [-p] [-v] ttyinterface pty... +.SH DESCRIPTION +.LP +.B Mkiss +allows dual port TNCs or multiple TNCs sharing the same serial port to be +used with the Linux AX.25 kernel software. The AX.25 softare has no support +for dual port TNCs or multiple TNCs charing the same serial line. The +different ports are addressed by encoding the port number in the control +byte of every kiss frame. +.B Mkiss +watches a serial port, and routes kiss frames to/from the pseudo ttys. The +other side of the pseudo ttys are then attached with +.B kissattach +as normal. +.sp 1 +Statistics about the operation of +.B mkiss +may be obtained by sending the SIGUSR1 signal to the running program. On +reception of such a signal +.B mkiss +will print a set of statistics to the system log if logging has been +enabled. +.sp 1 +Although mention is made of using pseudo ttys as the last arguments, +these devices may be normal serial ports. However +.B mkiss +provides no way in which to set their speed, the speed must therefore be set +by some other method. +.SH OPTIONS +.TP 10 +.BI \-c +This enables a one-byte checksum on each incoming and outgoing KISS frame on +the serial port. This checksum is used by G8BPQ KISS roms to maintain the +integrity of KISS frames. +.TP 10 +.BI \-h +Enables hardware handshaking on the serial line to the TNC. The KISS +specification states that no hardware flow control shall be used so the +default is off. But some KISS implementations do use hardware flow control. +.TP 10 +.BI \-l +Enables system logging, the default is off. +.TP 10 +.BI "\-s speed" +Set the speed of the serial port. +.TP 10 +.BI "\-p" +Enables polling. Polled mode is used by G8BPQ KISS roms to prevent +contention on systems where multiple TNCs share the same serial line. +.TP 10 +.BI \-v +Display the version. +.SH "SEE ALSO" +.BR kissattach (8), +.BR ifconfig (8), +.BR kill (1). +.SH AUTHORS +Tomi Manninen OH2BNS <tpmannin@cc.hut.fi> +.br +Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk> +.br +Kevin Uhlir N0BEL <kevinu@flochart.com> diff --git a/kiss/net2kiss.8 b/kiss/net2kiss.8 new file mode 100644 index 0000000..040f164 --- /dev/null +++ b/kiss/net2kiss.8 @@ -0,0 +1,45 @@ +.TH NET2KISS 8 "15 October 1996" "" "" +.SH NAME +net2kiss \- convert a network AX.25 driver to a KISS stream on a pseudo-tty +.SH SYNOPSIS +.B "net2kiss [-sfzva] [-i ifname] ptyname" +.br +.SH DESCRIPTION +.B net2kiss +takes AX.25 packets from an AX.25 kernel network interface and converts them +into a KISS data stream via a pseudo-tty. +.SH PARAMETERS +.TP +.B ptyname +specifies the path to the pseudo-tty. +.SH OPTIONS +.TP +.B "\-i ifname" +specifies the name of the kernel AX.25 network interface. The default +is bc0. +.TP +.B \-s +tells net2kiss to search by itself for a free pseudoterminal, open the +master side and create a symlink named by -p to the slave side. +.TP +.B \-f +can be used in conjunction with -s to force the creation of the symlink +even if the target file does already exist. +.TP +.B \-v +Verbose output. Displays error messages during operation and decoded +packets to stdout. +.TP +.B \-z +put the network interface into promiscious mode. +.TP +.B \-a +receive every packet instead of only AX.25 from the kernel AX.25 network +interface. +.SH BUGS +None known. +.SH SEE ALSO +.BR ifconfig (8), +.BR kissattach (8). +.SH AUTHORS +Thomas M. Sailer, HB9JNX/AE4WA, <sailer@ife.ee.ethz.ch> |