zerodds-spy 1.0.0-rc.1

ZeroDDS Topic-Spy — abonniert beliebige DDS-Topics und dumpt Samples (hex / size / count).
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

# zerodds-spy

Subscribe to a **DDS topic** and dump samples — like `tcpdump` for DDS.

The tool starts a `DcpsRuntime`, registers an untyped reader on the
named topic, and prints metadata + an optional hex snippet of every
incoming sample until you Ctrl-C, hit a sample-count limit, or a
duration elapses.

## Usage

```bash
# Subscribe to topic Foo on default domain (0) until Ctrl-C
zerodds-spy -t Foo

# Capture exactly 50 samples
zerodds-spy -t Foo -n 50

# 10s burst, dump only first 8 hex bytes per sample
zerodds-spy -t Foo --duration 10s --hex 8

# Subscribe on domain 5
zerodds-spy -d 5 -t Sensor/Stream/A
```

| Flag                | Meaning                                            | Default                |
|---------------------|----------------------------------------------------|------------------------|
| `-d, --domain`      | DDS Domain ID                                      | 0                      |
| `-t, --topic`       | Topic name (REQUIRED)                              | —                      |
| `-n, --count`       | Stop after N samples                               | unlimited              |
| `--duration`        | Stop after duration (`5`, `30s`, `2m`, `1h`)       | until SIGINT           |
| `-x, --hex`         | First BYTES of payload as hex (0 = no hex)         | 32                     |

## Output

Each sample is printed as one line:

```text
[     1] writer=000003c2 bytes=64 deadbeef cafebabe 12345678 90abcdef
[     2] writer=000003c2 bytes=64 deadbeef cafebabe 12345678 90abcdef
...
```

Lifecycle markers (Disposed / Unregistered) are printed as
`[lifecycle] <kind>`.

## Exit Codes

| Code | Meaning           |
|------|-------------------|
| 0    | Success           |
| 2    | CLI parse error   |
| 3    | DDS / I/O error   |