From 875d6b8f3182cd2c2419499b4af24ebaf3648731 Mon Sep 17 00:00:00 2001 From: "Andrey A. Chernov" Date: Fri, 10 Dec 1993 19:27:16 +0000 Subject: [PATCH] Man page added. --- sbin/comcontrol/Makefile | 2 +- sbin/comcontrol/comcontrol.8 | 73 +++++++++++++++++++++++++++++++ sbin/i386/comcontrol/Makefile | 2 +- sbin/i386/comcontrol/comcontrol.8 | 73 +++++++++++++++++++++++++++++++ 4 files changed, 148 insertions(+), 2 deletions(-) create mode 100644 sbin/comcontrol/comcontrol.8 create mode 100644 sbin/i386/comcontrol/comcontrol.8 diff --git a/sbin/comcontrol/Makefile b/sbin/comcontrol/Makefile index 46179428a7e7..abc8d0a7f81f 100644 --- a/sbin/comcontrol/Makefile +++ b/sbin/comcontrol/Makefile @@ -1,6 +1,6 @@ # @(#)Makefile 5.4 (Berkeley) 6/5/91 PROG= comcontrol -NOMAN= noman +MAN8= comcontrol.8 .include 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. diff --git a/sbin/i386/comcontrol/Makefile b/sbin/i386/comcontrol/Makefile index 46179428a7e7..abc8d0a7f81f 100644 --- a/sbin/i386/comcontrol/Makefile +++ b/sbin/i386/comcontrol/Makefile @@ -1,6 +1,6 @@ # @(#)Makefile 5.4 (Berkeley) 6/5/91 PROG= comcontrol -NOMAN= noman +MAN8= comcontrol.8 .include diff --git a/sbin/i386/comcontrol/comcontrol.8 b/sbin/i386/comcontrol/comcontrol.8 new file mode 100644 index 000000000000..4ecce67aea29 --- /dev/null +++ b/sbin/i386/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.