tb(4) [bsd man page]

TB(4)							     Kernel Interfaces Manual							     TB(4)

NAME

       tb - line discipline for digitizing devices

SYNOPSIS

       /sys/conf/SYSTEM:
	    NTB  1    # RS232 interface for Genisco/Hitachi tablets

DESCRIPTION

       This  line  discipline  provides  a polled interface to many common digitizing devices which are connected to a host through a serial line.
       When these devices stream data at high speed, the use of the line discipline is critical in minimizing the number  of  samples  that  would
       otherwise be lost due to buffer exhaustion in the tty(4) handler.

       The line discipline is enabled by a sequence:

	    #include <sys/tablet.h>
	    int ldisc = TBLDISC, fildes; ...
	    ioctl(fildes, TIOCSETD, &ldisc);

       A typical application program then polls the digitizing device by reading a binary data structure which contains: the current X and Y posi-
       tions (in the device coordinate space), up-down status of the buttons or pen stylus, proximity information (when available), and a count of
       the  number  of samples received from the input device since it was opened.  In addition, devices such as the GTCO append tilt and pressure
       information to the end of the aforementioned structure.	For the Polhemus 3-D digitizer the structure read is completely  different.  Refer
       to the include file for a complete description.

       While  in  tablet mode, normal teletype input and output functions take place.  Thus, if an 8 bit output data path is desired, it is neces-
       sary to prepare the output line by putting it into RAW mode using ioctl(2).  This must be done before changing the  discipline  with  TIOC-
       SETD, as most ioctl(2) calls are disabled while in tablet line-discipline mode.

       The  line  discipline supports ioctl(2) requests to get/set the operating mode, and to get/set the tablet type and operating mode by or-ing
       the two values together.

       The line discipline supports digitizing devices which are compatible with Hitachi, GTCO, or Polhemus protocol formats.  For  Hitachi  there
       are several formats with that used in the newer model HDG-1111B the most common.

SEE ALSO

       tty(4)

DIAGNOSTICS

       None.

3rd Berkeley Distribution					  August 1, 1987							     TB(4)

LDATTACH(8)						     Linux Programmer's Manual						       LDATTACH(8)

NAME

       ldattach - attach a line discipline to a serial line

SYNOPSIS

       ldattach [-dhV78neo12] [-s speed] ldisc device

DESCRIPTION

       The  ldattach  daemon  opens the specified device file (which should refer to a serial device) and attaches the line discipline ldisc to it
       for processing of the sent and/or received data.  It then goes into the background keeping the device open  so  that  the  line	discipline
       stays loaded.

       The line discipline ldisc may be specified either by name or by number.

       In order to detach the line discipline, kill(1) the ldattach process.

       With no arguments, ldattach prints usage information.

LINE DISCIPLINES

       Depending on the kernel release, the following line disciplines are supported:

       TTY(0) The  default  line discipline, providing transparent operation (raw mode) as well as the habitual terminal line editing capabilities
	      (cooked mode).

       SLIP(1)
	      Serial Line IP (SLIP) protocol processor for transmitting TCP/IP packets over serial lines.

       MOUSE(2)
	      Device driver for RS232 connected pointing devices (serial mice).

       PPP(3) Point to Point Protocol (PPP) processor for transmitting network packets over serial lines.

       STRIP(4)

       AX25(5)

       X25(6) Line driver for transmitting X.25 packets over asynchronous serial lines.

       6PACK(7)

       R3964(9)
	      Driver for Simatic R3964 module.

       IRDA(11)
	      Linux IrDa (infrared data transmission) driver - see http://irda.sourceforge.net/

       HDLC(13)
	      Synchronous HDLC driver.

       SYNC_PPP(14)
	      Synchronous PPP driver.

       HCI(15)
	      Bluetooth HCI UART driver.

       GIGASET_M101(16)
	      Driver for Siemens Gigaset M101 serial DECT adapter.

       PPS(18)
	      Driver for serial line Pulse Per Second (PPS) source.

OPTIONS

       -d | --debug
	      Causes ldattach to stay in the foreground so that it can be interrupted or  debugged,  and  to  print  verbose  messages	about  its
	      progress to the standard error output.

       -h | --help
	      Prints a usage message and exits.

       -V | --version
	      Prints the program version.

       -s value | --speed value
	      Set the speed of the serial line to the specified value.

       -7 | --sevenbits
	      Sets the character size of the serial line to 7 bits.

       -8 | --eightbits
	      Sets the character size of the serial line to 8 bits.

       -n | --noparity
	      Sets the parity of the serial line to none.

       -e | --evenparity
	      Sets the parity of the serial line to even.

       -o | --oddparity
	      Sets the parity of the serial line to odd.

       -1 | --onestopbit
	      Sets the number of stop bits of the serial line to one.

       -2 | --twostopbits
	      Sets the number of stop bits of the serial line to two.

SEE ALSO

       inputattach(1), ttys(4)

AUTHOR

       Tilman Schmidt (tilman@imap.cc)

AVAILABILITY

       The ldattach command is part of the util-linux-ng package and is available from ftp://ftp.kernel.org/pub/linux/utils/util-linux-ng/.

Linux 2.6							  14 January 2008						       LDATTACH(8)