Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

mkiss(8) [debian man page]

MKISS(8)						   Linux System Managers Manual 						  MKISS(8)

NAME

       mkiss - Attach a multi KISS interface

SYNOPSIS

       mkiss [-c] [-f] [-h] [-l] [-s speed] [-p pollrate] [-v] [-x n_ptmx] ttyinterface pty ..

DESCRIPTION

       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 soft-
       ware 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.  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 kissattach as normal.

       Statistics about the operation of mkiss may be obtained by sending the SIGUSR1 signal to the running program. On reception of such a signal
       mkiss will print a set of statistics to the system log if logging has been enabled.

       Although  mention  is  made of using pseudo ttys as the last arguments, these devices may be normal serial ports. However mkiss provides no
       way in which to set their speed, the speed must therefore be set by some other method.

       If the pty argument is "/dev/ptmx", then Unix98 behaviour will automaticaly take effekt. With Unix98 pty's, the slave pty name could not be
       forseen. That's why mkiss will print the corresponding slave pty name as a separate line on stdout.

       If  the	pty  name  is  the  special  name  "none",  no	pty  is opened. This is useful if you have multiport tnc like the KPC-9612 on i.e.
       /dev/ttyUSB0 and you only like to handle packets for the second port. The KPC has no option to configure the second tnc to listen  on  kiss
       port number 0. Thus, if you like to send all frames from the pty to the kiss port number 1, we need to tell mkiss to tag them for port num-
       ber 1. This is done by "mkiss /dev/ttyUSB0 none /dev/ptmx". Frames received with port number 0 are discarded.

OPTIONS

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

       -f	 This enables a 16-bit checksum on each incoming and outgoing KISS frame on the serial port. This checksum is used by Flexnet Node
		 and BayCom Mailbox to maintain the integrity of KISS frames.

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

       -l	 Enables system logging, the default is off.

       -s speed  Set the speed of the serial port.

       -p pollrate
		 Enables  polling.  Polled  mode  is  used  by G8BPQ KISS roms to prevent contention on systems where multiple TNCs share the same
		 serial line.  Pollrate is interval between polls (in 100ms units).

       -v	 Display the version.

       -x number This option is for Unix98 PTYs. It allocates "number" ptys; their names are written to stdout. When -x is used, the pty arguments
		 are optional. "mkiss -x 3 ttyname" is an comfortable alternative to "mkiss ttyname /dev/ptmx /dev/ptmx /dev/ptmx".

SEE ALSO

       kissattach(8), ifconfig(8), kill(1).

AUTHORS

       Tomi Manninen OH2BNS <oh2bns@sral.fi>
       Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk>
       Kevin Uhlir N0BEL <kevinu@flochart.com>

Linux								    4 July 1999 							  MKISS(8)

Check Out this Related Man Page

KISSATTACH(8)						   Linux System Managers Manual 					     KISSATTACH(8)

NAME

       kissattach, spattach - Attach a KISS or 6PACK interface

SYNOPSIS

       kissattach [-b] [-6] [-l] [-m mtu] [-v] tty port [inetaddr]

       spattach [-b] [-l] [-m mtu] [-v] tty port [inetaddr]

DESCRIPTION

       Attach  a  KISS or a 6PACK interface to what is normally a tty line connected to a TNC in KISS or 6PACK mode. This program will turn itself
       into a background process. To down an interface send its attach process a SIGTERM.

       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 over-
       ridden by a value on the command line.

       The tty argument will typically be that of a serial port with a KISS or 6PACK TNC attached, although it could be a pseudo  tty  or  a  KISS
       port  emulator  such  as  an  SCC  card. Kissattach supports BSD-style pseudo-terminals as well as the Unix98 pty's. If the tty argument is
       "/dev/ptmx", then Unix98 behaviour will automaticaly take effekt. With Unix98 pty's, the slave tty name could not be  forseen.  That's  why
       kissattach will print the corresponding slave pty name as a separate line on stdout.

       The port argument is the name of a port as given in the axports(5) file.

       The optional inetaddr argument is the IP address of the new interface. Some time it was mandatory argument (although due to historical rea-
       sons this restriction is lifted if the old -i option is used). But there's really not a need for  the  interface  to  have  an  IP  address
       assigned to.

OPTIONS

       -6	       Use the 6PACK line discipline instead of KISS. This is the default if the program is called as spattach.

       -i inetaddr     Set  the internet address of the interface. This address may either be a dotted decimal address or a host name. This option
		       is now depreciated and the program will complain about it, though still work.

       -l	       Log messages to the system log, the default is not to.

       -b	       Allow broadcasts on the interface (default no - because for e.g. samba broadcasts are a pain..)

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

       -v	       Display the version.

SEE ALSO

       kill(1), stty(1), ax25(4), axparms(4), axports(5), ifconfig(8).

AUTHOR

       Alan Cox GW4PTS <alan@cymru.net>
       Jonathan Naylor G4KLX <g4klx@g4klx.demon.co.uk>

Linux								    4 July 1999 						     KISSATTACH(8)
Man Page