HamBSD Manual Pages


Manual Page Search Parameters

KISS(4) Device Drivers Manual KISS(4)

kissKISS line discipline

pseudo-device kiss

The kiss line discipline can be attached to serial lines to communicate with a TNC, including the following:

The TNC must already be in KISS mode before the line discipline is activated. Refer to the documentation for your TNC to find how to do this. It may be possible to perform automatic initialisation using a chat(8) script. When this line discipline is first attached, it will in turn attach to the first available ekiss(4) network interface, or any other interface that has registered with the line discipline.

For general use, once the interface has been created and configured, the line discipline can be attached using ldattach(8). For example, assuming the TNC is connected to /dev/cua00 at 1200 baud:

$ ldattach -s 1200 kiss cua00

The line discipline is also enabled by the following sequence:

#include <sys/ioctl.h>
int ldisc = KISSDISC, fd; ...
ioctl(fd, TIOCSETD, &ldisc);

Input and output on the serial line is then intercepted and handled by the kernel, and will not be available via the read(2) and write(2) system calls.

The line discipline is aware of multi-drop in as far as incoming data on all ports will be accepted and will not trigger error conditions. The additional commands, acknowledge or polled mode, are not implemented. All data will be sent on port 0.

tty(4), ldattach(8)

September 1, 2019 HamBSD-current