statserial

STATSERIAL(1)                    User Commands                   STATSERIAL(1)



NAME
       statserial - display serial port modem status lines


SYNOPSIS
       statserial [-n |  -d | -x] <device-name>


DESCRIPTION
       Statserial  displays  a  table  of  the  signals on a standard 9-pin or
       25-pin serial port, and indicates the status of the handshaking  lines.
       It can be useful for debugging problems with serial ports or modems.

       The  optional device-name parameter is the full name of the device file
       for the serial port in question. If not specified, the default is taken
       from the environment variable MODEM if set, otherwise /dev/cua1.



COMMAND-LINE OPTIONS
       Each of the command line options is mutually exclusive.


       -n   Normally statserial will loop continuously, updating the status at
            one second intervals; you can exit using Control-C. The -n  option
            disables looping.


       -d     With this option the status of the modem is printed as a decimal
            number. The bits are encoded  as  follows  (XXX  indicates  unused
            bits):

            +---+---+---+---+---+---+---+---+---+
            | 8 | 7 | 6 | 5 | 4 | 3 | 2 | 1 | 0 |
            +---+---+---+---+---+---+---+---+---+
            |DSR|RI |DCD|CTS|XXX|XXX|RTS|DTR|XXX|
            +---+---+---+---+---+---+---+---+---+


       -x   This  option  is the same as -d, except that the output is in hex-
            adecimal.


BUGS/LIMITATIONS
       Statserial only works with devices that support the TIOCMGET ioctl.

       You need permission to read the device file.

       The device file may be locked if other applications are using it.


AUTHOR
       Statserial was written by Jeff Tranter (Jeff_Tranter@Mitel.COM),  later
       updated  by  Frank  Baumgart  (godot@uni-paderborn.de)  and is released
       under the conditions of the GNU General Public License.  See  the  file
       COPYING and notes in the source code for details.


SEE ALSO
       setserial(8) stty(1)
       /usr/src/linux/drivers/char/serial.c /usr/include/linux/termios.h



Linux                          17 December 1994                  STATSERIAL(1)