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