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