Initial import from FreeBSD RELENG_4:
[games.git] / sbin / comcontrol / comcontrol.8
1 .\" $FreeBSD: src/sbin/comcontrol/comcontrol.8,v 1.15.2.7 2002/08/21 18:58:13 trhodes Exp $
2 .Dd May 15, 1994
3 .Dt COMCONTROL 8
4 .Os
5 .Sh NAME
6 .Nm comcontrol
7 .Nd control a special tty device
8 .Sh SYNOPSIS
9 .Nm
10 .Ar special_device
11 .Op dtrwait Ar number
12 .Op drainwait Ar number
13 .Sh DESCRIPTION
14 The
15 .Nm
16 utility is used to examine and modify some of the special characteristics
17 of the specified tty device.
18 If no arguments other than the device (or "-" for stdin)
19 are specified,
20 it prints the settings of all controllable characteristics.
21 This usage requires only read access on the device.
22 Only the superuser can change the settings.
23 .Pp
24 The following options are available:
25 .Bl -tag -width indent
26 .It Cm dtrwait Ar number
27 Set the time to wait after dropping DTR
28 to the given number.
29 The units are hundredths of a second.
30 The default is 300 hundredths, i.e., 3 seconds.
31 This option needed mainly to set proper recover time after
32 modem reset.
33 .It Cm drainwait Ar number
34 Set the time to wait for output drain
35 to the given number.
36 The units are seconds.
37 The default is 0 minutes, 0 means
38 waiting forever.
39 This option needed mainly to specify upper limit of minutes
40 to prevent modem hanging.
41 .El
42 .Pp
43 The standard way to use
44 .Nm
45 is to put invocations of it in the
46 .Pa /etc/rc.serial
47 startup script.
48 .Sh SEE ALSO
49 .Xr stty 1 ,
50 .Xr sio 4
51 .Sh FILES
52 .Bl -tag -width /dev/ttyd? -compact
53 .It Pa /dev/ttyd?
54 dialin devices, hardwired terminals
55 .It Pa /dev/cuaa?
56 dialout devices
57 .El
58 .Sh AUTHORS
59 .An Christopher G. Demetriou
60 .Sh HISTORY
61 Originally part of cgd's com package patches, version 0.2.1, to
62 .Bx 386 0.1 .
63 Once controlled bidirectional capabilities.  Little is left to control now
64 that these capabilities are standard.