Merge commit 'brent/master'
[freebsd-src/fkvm-freebsd.git] / sbin / comcontrol / comcontrol.8
blob87a7630582e36802aeedb566510256c3d81191bf
1 .\" $FreeBSD$
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 5 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.d/serial
47 startup script.
48 .Sh FILES
49 .Bl -tag -width /dev/ttyd? -compact
50 .It Pa /dev/ttyd?
51 dialin devices, hardwired terminals
52 .It Pa /dev/cuad?
53 dialout devices
54 .El
55 .Sh SEE ALSO
56 .Xr stty 1 ,
57 .Xr sio 4
58 .Sh HISTORY
59 Originally part of cgd's com package patches, version 0.2.1, to
60 .Bx 386 0.1 .
61 Once controlled bidirectional capabilities.
62 Little is left to control now
63 that these capabilities are standard.
64 .Sh AUTHORS
65 .An Christopher G. Demetriou