Merge branch 'vendor/LIBEDIT'
[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.4 2007/12/16 02:55:38 thomas 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.d/serial
48 startup script.
49 .Sh FILES
50 .Bl -tag -width /dev/ttyd? -compact
51 .It Pa /dev/ttyd?
52 dialin devices, hardwired terminals
53 .It Pa /dev/cuaa?
54 dialout devices
55 .El
56 .Sh SEE ALSO
57 .Xr stty 1 ,
58 .Xr sio 4
59 .Sh HISTORY
60 Originally part of cgd's com package patches, version 0.2.1, to
61 .Bx 386 0.1 .
62 Once controlled bidirectional capabilities.  Little is left to control now
63 that these capabilities are standard.
64 .Sh AUTHORS
65 .An Christopher G. Demetriou