aboutsummaryrefslogtreecommitdiff
path: root/sbin/comcontrol/comcontrol.8
diff options
context:
space:
mode:
authorAndrey A. Chernov <ache@FreeBSD.org>1993-12-10 19:27:16 +0000
committerAndrey A. Chernov <ache@FreeBSD.org>1993-12-10 19:27:16 +0000
commit875d6b8f3182cd2c2419499b4af24ebaf3648731 (patch)
treead9c275309feea1b20578e028c9cc2c5378de639 /sbin/comcontrol/comcontrol.8
parent9bfbbf452b8d834140e8c2d41b098d558dc3335f (diff)
downloadsrc-875d6b8f3182cd2c2419499b4af24ebaf3648731.tar.gz
src-875d6b8f3182cd2c2419499b4af24ebaf3648731.zip
Man page added.
Notes
Notes: svn path=/head/; revision=840
Diffstat (limited to 'sbin/comcontrol/comcontrol.8')
-rw-r--r--sbin/comcontrol/comcontrol.873
1 files changed, 73 insertions, 0 deletions
diff --git a/sbin/comcontrol/comcontrol.8 b/sbin/comcontrol/comcontrol.8
new file mode 100644
index 000000000000..4ecce67aea29
--- /dev/null
+++ b/sbin/comcontrol/comcontrol.8
@@ -0,0 +1,73 @@
+.Dd December 10, 1993
+.Dt COMCONTROL 8
+.Os FreeBSD
+.Sh NAME
+.Nm comcontrol
+.Nd "control the bidirectional status of a sio port and waiting time after DTR drop"
+.Sh SYNOPSIS
+.Nm comcontrol
+.Ar sio_special_device
+.Op Cm bidir | Fl bidir
+.Op Cm dtrwait Ar ticks
+.Sh DESCRIPTION
+.Nm Comcontrol
+is used to examine and modify the bidirectional status
+of a specified
+sio communications port
+and its waiting time after DTR drop.
+By default (if
+.Ar sio_special_device
+only specified),
+.Nm comcontrol
+will print the current port state
+(if kernel was built with
+.Cm options COM_BIDIR )
+as either
+.Cm bidir
+to indicate that bidirectional operation is enabled or
+.Fl bidir
+to indicate that it is disabled, string
+.Cm dtrwait
+and current waiting time in ticks
+after DTR drop.
+To modify the status of the port or waiting time, simply
+specify the desired new state
+and/or new waiting time
+on the command line. All users with
+read access to the
+.Ar sio_special_device
+can use
+.Nm comcontrol
+to get the port's status and current waiting time.
+Only root can set a port's status and waiting time.
+By default, each port is initially unidirectional, waiting time is 50 ticks.
+.Pp
+The standard way to use
+.Nm comcontrol
+is to put invocations of it in the
+.Ar /etc/rc.local
+startup script.
+.Sh SEE ALSO
+.Xr sio 4
+.Sh FILES
+.Bl -tag -width Pa
+.It Pa /dev/sio??
+.Sh DIAGNOSTICS
+.Cm TIOCMSBIDIR: Inappropriate ioctl for device.
+.Pp
+This indicates attempt to change port status on
+a non-sio special device file,
+or the kernel has not been built with
+.Cm options COM_BIDIR .
+For more information concerning reconfiguration
+of your kernel see
+.Ar /usr/src/sys/i386/doc/config_options.doc.
+.Sh AUTHOR
+Christopher G. Demetriou
+.Sh BUGS
+It is strongly recommended that you do *not*
+change the bidirectional status of a port while there are programs
+using the port. Read that as: if you do, and it breaks, don't yell
+at me; that's a really weird thing to do.
+.Sh HISTORY
+Originally part of cgd's com package patches, version 0.2.1, to 386BSD 0.1.