diff options
author | davidn <davidn@FreeBSD.org> | 1997-03-13 04:21:44 +0000 |
---|---|---|
committer | davidn <davidn@FreeBSD.org> | 1997-03-13 04:21:44 +0000 |
commit | f70c2b4238992a82dac18d6f2f58d8c92c9f2466 (patch) | |
tree | 00a8bcd1d8504d62005a788a8d35b08ac18109a3 /usr.sbin/stallion/stlstats | |
parent | 9abc695c321d2a457a978f41163113a6b99e7956 (diff) | |
download | FreeBSD-src-f70c2b4238992a82dac18d6f2f58d8c92c9f2466.zip FreeBSD-src-f70c2b4238992a82dac18d6f2f58d8c92c9f2466.tar.gz |
Submitted by: Greg Ungerer <gerg@stallion.oz.au>
Add manpages for stl, stli drivers.
Add manpages for stlload, stlstats.
Update stli bootcode.
Update stlload, stlstats to revision 1.0.0 from author.
Diffstat (limited to 'usr.sbin/stallion/stlstats')
-rw-r--r-- | usr.sbin/stallion/stlstats/Makefile | 4 | ||||
-rw-r--r-- | usr.sbin/stallion/stlstats/stlstats.8 | 131 | ||||
-rw-r--r-- | usr.sbin/stallion/stlstats/stlstats.c | 4 |
3 files changed, 135 insertions, 4 deletions
diff --git a/usr.sbin/stallion/stlstats/Makefile b/usr.sbin/stallion/stlstats/Makefile index 347b4e9..8f1b8e7 100644 --- a/usr.sbin/stallion/stlstats/Makefile +++ b/usr.sbin/stallion/stlstats/Makefile @@ -1,7 +1,7 @@ -# $Id$ +# $Id: Makefile,v 1.3 1997/02/22 16:13:48 peter Exp $ PROG= stlstats -NOMAN= #oops +MAN8= stlstats.8 LDADD= -lncurses DPADD= ${LIBNCURSES} diff --git a/usr.sbin/stallion/stlstats/stlstats.8 b/usr.sbin/stallion/stlstats/stlstats.8 new file mode 100644 index 0000000..b2b925e --- /dev/null +++ b/usr.sbin/stallion/stlstats/stlstats.8 @@ -0,0 +1,131 @@ +.\" Copyright (c) 1996 Greg Ungerer (gerg@stallion.oz.au). +.\" All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Greg Ungerer. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.Dd December 2, 1996 +.Os FreeBSD +.Dt STLSTATS 8 i386 +.Sh NAME +.Nm stlstats +.Nd "Stallion Technologies multiport serial statistics display" +.Sh SYNOPSIS +.Nm stlstats +.Op Fl hVi +.Op Fl c Ar control-device +.Op Fl b Ar board-number +.Op Fl p Ar port-number +.Op Fl d Ar port-device +.Sh DESCRIPTION +.Nm stlstats +is used to display statistical information about the ports on Stallion +Technologies multiport serial boards. +.Pp +.Nm stlstats +normally runs as a full screen menu driven application. +A help line is displayed at the bottom of each screen with the valid +input keys for this screen. +.Pp +Generally the digit keys ('0' through '9') specify the number of the +device to display statistics for. +Where digits alone are not enough to access all possible devices +(for example on 16 port panels) then the first letters of the alphabet +are used to access the remaining devices. +The letters 'a' through 'f' are used to access devices 10 through 15. +.Pp +The 'q' key is always used to move back to the previous level screen. +The escape key can also be used to move back to the previous screen. +.Pp +The first screen is a display of all ports on panel 0 of board 0. +Values displayed on this screen are a summary of the information for +each port. The statistics displayed are: driver and TTY state flags, +termios flags (cflags, iflags, oflags, lflags), RS-232 signal values +(as per TIOCM signal defines), total transmit and receive character +counts. +.Pp +From this screen you can look at summary information +about each panel and board installed in the system. +Each board is accessed by the digit keys ('0' through '7'), +while panels of each board can be cycled through using the 'n' key. +.Pp +The per port screen displays some detailed information about a +particular port. +This is accessed from the board screen using the 'p' key. +The first port displayed will be port 0. +To display other ports use the digit and alphabetic keys +('0' through '9' and 'a' through 'f'). +This screen displays: driver and TTY state flags, hardware ID, +termios flags (cflags, iflags, oflags, lflags), +total transmitted and received character counts, +current transmit and receive characters buffered, +receiver error counts (overruns, parity, framing, lost), +software flow control characters transmitted and received, +hardware flow control actions taken, +count of transmitted and received breaks, +modem signal transitions and +current RS-232 signal states. +.Pp +The options are: +.Bl -tag -width xxxxxxx +.It Fl h +Output usage information. +.It Fl V +Output version information. +.It Fl i +Output only the board type information. +This output is useful for scripts or other programs that need to know +a little bit about the board (for example an automated download script). +.Nm stlstats +will not enter full screen interactive mode. +.It Fl c Ar control-device +Specify the board control device through which to gather port statistics. +The default is /dev/staliomem0. +.It Fl b Ar board-number +Specify the board number to display first. +The default is to display board 0. +.It Fl p Ar port-number +Specify the port number to display first. +.Nm stlstats +will go straight into the port display screen (bypassing board display) +when this option is used. +.It Fl d Ar port-device +Specify the port special device file (the /dev/ttyXXX file) to +display first. +The board screen is bypassed and the port statistics screen is shown +immediately on start up. +.El +.Sh FILES +.Bl -tag -width /dev/staliomem0 +.It Pa /dev/staliomem0 +driver control device used for statistics collection +.Sh SEE ALSO +.Xr stl 4 , +.Xr stli 4 , +.Xr stlload 8 +.Sh HISTORY +This program was originally developed by Greg Ungerer (gerg@stallion.com). diff --git a/usr.sbin/stallion/stlstats/stlstats.c b/usr.sbin/stallion/stlstats/stlstats.c index e6e304f..7c52636 100644 --- a/usr.sbin/stallion/stlstats/stlstats.c +++ b/usr.sbin/stallion/stlstats/stlstats.c @@ -33,7 +33,7 @@ * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. * - * $Id$ + * $Id: stlstats.c,v 1.4 1997/02/22 16:13:50 peter Exp $ */ /*****************************************************************************/ @@ -53,7 +53,7 @@ /*****************************************************************************/ -char *version = "0.0.5"; +char *version = "1.0.0"; char *defdevice = "/dev/staliomem0"; char *progname; |