Search:
wiki:sniffring
Last modified 19 months ago Last modified on 02/26/12 12:45:08

# Earthworm Module: sniffring

Contributed by: Lynn Dietz at USGS, Menlo Park

## Function

Latches onto a user-defined transport ring, reads every message and prints logo to screen.

## Details

Sniffring is a command line debugging tool that latches onto a user-specified transport ring and reads every message on that ring. It prints to screen the logo, sequence # and length of the message, followed by the message itself (except for binary waveform messages).

    Usage 1:  sniffring [-n]
    Usage 2:  sniffring [-n]
    Usage 3:  sniffring [-n]  verbose
    Usage 4:  sniffring [-n]     verbose
    Sniffring shows full ring, inst and module names if 'v' or
    'verbose' is specified as the final parameter. Otherwise you'll
    see numeric IDs for these three, as defined in earthworm*.d files.
    (Modules from external installations are not identified other than by number.)
    A new option is -n to not flush the ring of all messages first, must be before ringname if used
    the default is to flush the ring of all messages and only show those that come in after invocation

Example Output:

    >sniffring WAVE_RING
    1163352566 Received <inst: 4> <mod:100> <type: 3> <seq: 89> <Length: 16>
    1163352566 3400
    1163352577 Received <inst: 4> <mod:132> <type: 3> <seq: 57> <Length: 16>
    1163352577 5404

    1163352579 Received <inst: 4> <mod:100> <type: 19> <seq: 47> <Length: 2064>
    1163352581 Received <inst: 4> <mod:100> <type: 19> <seq: 48> <Length: 2064>
    1163352581 Received <inst: 4> <mod:100> <type: 19> <seq: 49> <Length: 2064>
    1163352584 Received <inst: 4> <mod:100> <type: 19> <seq: 50> <Length: 2064>
    1163352586 Received <inst: 4> <mod:100> <type: 19> <seq: 51> <Length: 2064>
    1163352586 Received <inst: 4> <mod:100> <type: 19> <seq: 52> <Length: 2064>
    1163352587 Received <inst: 59> <mod: 50> <type: 19> <seq:134> <Length: 86>
    1163352587 Received <inst: 59> <mod: 50> <type: 19> <seq:135> <Length: 86>
    1163352587 Received <inst: 59> <mod: 50> <type: 19> <seq:136> <Length: 86>
    1163352588 Received <inst: 59> <mod: 50> <type: 19> <seq:137> <Length: 86>
    1163352588 Received <inst: 59> <mod: 50> <type: 19> <seq:138> <Length: 86>
    1163352588 Received <inst: 59> <mod: 50> <type: 19> <seq:139> <Length: 86>
    1163352588 Received <inst: 59> <mod: 50> <type: 19> <seq:140> <Length: 86>
    1163352588 Received <inst: 59> <mod: 50> <type: 19> <seq:141> <Length: 86>
    1163352588 Received <inst: 4> <mod:129> <type: 3> <seq:154> <Length: 15>
    1163352588 324

    1163352588 Received <inst: 4> <mod:134> <type: 3> <seq:254> <Length: 13>
    1163352588 0

    1163352588 Received <inst: 4> <mod: 18> <type: 3> <seq:254> <Length: 11>
    1163352588

    1163352589 Received <inst: 4> <mod:100> <type: 19> <seq: 53> <Length: 2064>

## Helpful Hints

### Download in other formats:

- Plain Text