beautypg.com

Appendix c. lcom(1), Name, Synopsis – Comtrol DM ATS-LNX User Manual

Page 60: Description, Channel modes, Options, Name synopsis description, Channel modes options

background image

Appendix C. lcom(1)

60

Appendix C. lcom(1)

Name

lcom(1) - multi-port serial I/O test program.

Synopsis

lcom [options] [dev [...]]

Description

lcom is a program that can open multiple serial ports or TCP/IP connections and
exercise them in different ways. lcom uses ncurses to provide a text-mode
windowed user interface. Each open channel (tty device or TCP/IP connection is
displayed in its own window. Each window has a status line at the top and the
remainder of the window displays data received on that channel (unless the quiet
flag is selected for that window).

Channel Modes

Each of the channels will be in one of the following modes:

test

The test mode performs a rudimentary self-test on the connection using an

external loopback connector. Modem control lines are exercised for tty

devices, and a block of data is transmitted to the port and will be verified

when it is received back from the loopback connector. The results of the

tests are displayed in the channel's window (data is not displayed).

echo

The echo mode transmits any data it receives. Received data is displayed

unless the quiet flag is set.

term

The terminal mode acts as a simple dumb terminal. Received data is

displayed and any input received from the keyboard is transmitted.

mon

The monitor mode displays received data (unless the quiet flag is set). No

data is transmitted.

tput

The throughput mode transmits a continuous stream of test data and

optionally verifies receive data against the pattern that was transmitted.

If the verify option is enabled, the test will fail (and stop) if received data

doesn't match.

All of the modes maintain transmit and receive byte counts and calculate transmit
and receive throughput (averaged over 5-second intervals).

Options

A summary of command-line options will be displayed if lcom is invoked with the
-? option. That summary is authoritative. If there are discrepancies between the
displayed summary and this manual page, believe the summary.

The available command-line options are:

-x level

Specifies a debugging level from 0 (least verbose) to 9 (most verbose).

-B

Use the top window border for status information rather than using

the first line of the window interior.

-a

Automatically raises the active window to the top when a different

window is made active.