lcm-spy(1)

NAME
lcm-spy - traffic inspection tool

SYNOPSIS

lcm-spy [options]

DESCRIPTION

lcm-spy is the Lightweight Communications and Marshalling traffic inspection utility. It is a graphical tool for viewing messages received on an LCM network, and is analagous to tools like Ethereal/Wireshark and tcpdump in that it is able to inspect all LCM messages received and provide information and statistics on the channels used. When given appropriate LCM type definitions, lcm-spy is able to automatically detect and decode messages, and can display the individual fields of recognized messages. lcm-spy is limited to displaying statistics for unrecognized messages. lcm-spy collects the following statistics for each channel:

-   Channel name

-   Number of messages received

-   Message Rate (Hz)

-   Bandwidth (KB/s) On its own, this information can often be used to verify that messages are being transmitted on the expected channels, and at the expected data rates.

OPTIONS
The following options are provided by lcm-spy

-l, --lcm-url=URL
    Use the specified LCM URL

-h, --help
    Shows some help text and exits

AUTOMATIC MESSAGE DECODING
If a Java class generated by lcm-gen for an LCM type definition is contained within a JAR file that is on the Java classpath, lcm-spy automatically detects the class and uses Java reflection to insert the corresponding LCM type definitions into a type database. Subsequently, lcm-spy is able to automatically recognize and decode messages received that correspond to all such types.

SEE ALSO
lcm-gen(1)

AUTHORS
This manual page was written by Albert Huang <ashuang@alum.mit.edu>. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts and no Back-Cover Texts.