BSD 4_3 release

[unix-history] / usr / man / man4 / bk.4

diff --git a/usr/man/man4/bk.4 b/usr/man/man4/bk.4
index 91dec8b..52542bb 100644 (file)
--- a/usr/man/man4/bk.4
+++ b/usr/man/man4/bk.4
@@ -1,14 +1,15 @@
-.TH BK 4
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)bk.4        6.1 (Berkeley) 5/15/85
+.\"
+.TH BK 4 "May 15, 1985"

 .UC 4
 .SH NAME
 .UC 4
 .SH NAME

-bk \- line discipline for machine-machine communication
+bk \- line discipline for machine-machine communication (obsolete)

 .SH SYNOPSIS
 .SH SYNOPSIS

-.B #include <sgtty.h>
-.PP
-.B int ldisc = NETLDISC, fildes;
-\&...
-.PP
-.B ioctl(fildes, TIOCSETD, &ldisc);
+.B pseudo-device bk

 .SH DESCRIPTION
 This line discipline provides a replacement for the old and new
 tty drivers described in
 .SH DESCRIPTION
 This line discipline provides a replacement for the old and new
 tty drivers described in


@@ -16,10 +17,8 @@ tty drivers described in
 when high speed output to
 and especially input from another machine is to be transmitted
 over a asynchronous communications line.  The discipline
 when high speed output to
 and especially input from another machine is to be transmitted
 over a asynchronous communications line.  The discipline

-was designed for use by the Berkeley network
-.IR net (1)
-but is
-well suited to uploading of data from microprocessors into
+was designed for use by the Berkeley network.
+It may be suitable for uploading of data from microprocessors into

 the system.  If you are going to send data over asynchronous
 communications lines at high speed into the system, you must
 use this discipline, as the system otherwise may detect high
 the system.  If you are going to send data over asynchronous
 communications lines at high speed into the system, you must
 use this discipline, as the system otherwise may detect high


@@ -27,6 +26,16 @@ input data rates on terminal lines and disables the lines;
 in any case the processing of such data when normal terminal
 mechanisms are involved saturates the system.
 .PP
 in any case the processing of such data when normal terminal
 mechanisms are involved saturates the system.
 .PP

+The line discipline is enabled by a sequence:
+.PP
+.nf
+.ft B
+       #include <sgtty.h>
+       int ldisc = NETLDISC, fildes; ...
+       ioctl(fildes, TIOCSETD, &ldisc);
+.fi
+.ft R
+.PP

 A typical application program then reads a sequence of lines from
 the terminal port, checking header and sequencing information on each
 line and acknowledging receipt of each line to the sender, who then
 A typical application program then reads a sequence of lines from
 the terminal port, checking header and sequencing information on each
 line and acknowledging receipt of each line to the sender, who then


@@ -35,13 +44,14 @@ data and a smaller amount of control information will be received on
 each handshake.
 .PP
 The old standard teletype discipline can be restored by doing:
 each handshake.
 .PP
 The old standard teletype discipline can be restored by doing:

-.sp
+.PP
+.nf

 .ft B
 .ft B

-ldisc = OTTYDISC;
-
-ioctl(fildes, TIOCSETD, &ldisc);
+       ldisc = OTTYDISC;
+       ioctl(fildes, TIOCSETD, &ldisc);
+.fi

 .ft R
 .ft R

-.sp
+.PP

 While in networked mode, normal teletype 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
 While in networked mode, normal teletype 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


@@ -65,10 +75,9 @@ User level programs should provide sequencing and checksums on the
 information to guarantee accurate data transfer.
 .SH "SEE ALSO"
 tty(4)
 information to guarantee accurate data transfer.
 .SH "SEE ALSO"
 tty(4)

+.SH DIAGNOSTICS
+None.

 .SH BUGS
 .SH BUGS

-A standard program and protocol should be defined for
-uploading data from microprocessors, so that havoc doesn't
-result.
-.PP
-A full 8-bit input path should be provided with a mechanism
-for escaping newlines into an input packet.
+The Purdue uploading line discipline, which provides 8 bits and uses
+timeout's to terminate uploading should be incorporated into the standard
+system, as it is much more suitable for microprocessor connections.