zerodds-pcap 1.0.0-rc.1

ZeroDDS pcap-Tool — parsiert RTPS-Submessages aus PCAP-Captures (offline-only, kein DDS-Setup).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# zerodds-pcap

Offline pcap parser — extracts and decodes **RTPS submessages** from
existing pcap captures (e.g. captured with `tcpdump`, `dumpcap`, or
Wireshark). No DDS runtime, no live capture.

The tool finds the `RTPS` magic word inside each packet's payload (so
it works for any L2/L3/L4 combination — Ethernet, Linux SLL, NULL —
without explicit parsing) and then runs the full ZeroDDS RTPS decoder.

## Usage

```bash
# Capture some DDS traffic with tcpdump
sudo tcpdump -i any -w /tmp/dds.pcap 'udp portrange 7400-7500'

# Print every RTPS frame
zerodds-pcap parse /tmp/dds.pcap

# Aggregate counts per submessage kind
zerodds-pcap stats /tmp/dds.pcap
```

## Sub-Commands

| Sub-Command         | Action                                                    |
|---------------------|-----------------------------------------------------------|
| `parse <FILE>`      | Print every RTPS frame with submessage list               |
| `stats <FILE>`      | Print aggregate counts per submessage kind                |

## Output Example

```text
pcap: linktype=1 snaplen=65535 version=2.4
[    1] ts=1715000000.123456 guid_prefix=01020304... submessages=2
    · INFO_TIMESTAMP
    · DATA
[    2] ts=1715000000.234567 guid_prefix=05060708... submessages=1
    · HEARTBEAT
done · frames=42 rtps=12
```

## Exit Codes

| Code | Meaning                            |
|------|------------------------------------|
| 0    | Success                            |
| 2    | CLI parse error                    |
| 3    | File / pcap / RTPS decode error    |

## Limits

- Only `libpcap` format is supported (PCAPNG is a future extension).
- VLAN-tagged frames work as long as `RTPS` magic is in the captured
  payload; jumbo frames work up to the configured snaplen.