4.3BSD manual page from sam

SCCS-vsn: share/man/man4/man4.vax/tb.4 6.1

diff --git a/usr/src/share/man/man4/man4.vax/tb.4 b/usr/src/share/man/man4/man4.vax/tb.4
new file mode 100644 (file)
index 0000000..a14a252
--- /dev/null
+++ b/usr/src/share/man/man4/man4.vax/tb.4
@@ -0,0 +1,66 @@
+.\" Copyright (c) 1986 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)tb.4        6.1 (Berkeley) %G%
+.\"
+.TH TB 4 ""
+.UC 6
+.SH NAME
+tb \- line discipline for digitizing devices
+.SH SYNOPSIS
+.B pseudo-device tb
+.SH 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 discpline is critical in minimizing the number of samples
+that would otherwise be lost due to buffer exhaustion in the
+.IR tty (4)
+handler.
+.PP
+The line discipline is enabled by a sequence:
+.PP
+.nf
+.ft B
+       #include <sys/tablet.h>
+       int ldisc = TBLDISC, fildes; ...
+       ioctl(fildes, TIOCSETD, &ldisc);
+.fi
+.ft R
+.PP
+A typical application program then polls the digitizing device by
+reading a binary data structure which contains: the current X and
+Y positions (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 Polehmus 3-D digitizer
+the structure read is completely different, refer to the
+include file for a complete description.
+.PP
+While in tablet mode, normal teletype input and output functions take place.
+Thus, if an 8 bit output data path is desired, it is necessary
+to prepare the output line by putting it into RAW mode using
+.IR ioctl (2).
+This must be done
+.B before
+changing the discipline with TIOCSETD, as most
+.IR ioctl (2)
+calls are disabled while in network line-discipline mode.
+.PP
+The line discipline supports
+.IR ioctl (2)
+requests to get/set the operating mode, and to get/set the tablet type
+and operating mode by \fIor\fP-ing the two values together.
+.PP
+The line discpline 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.
+.SH "SEE ALSO"
+tty(4)
+.SH DIAGNOSTICS
+None.