From 53b5f8144122011cbe91813513bab666a077af82 Mon Sep 17 00:00:00 2001 From: Ning Sun Date: Wed, 22 Jul 2026 11:55:33 +0800 Subject: [PATCH] docs(man): add save and replay examples The SAVED SESSIONS section and OPTIONS entries for --save/--replay landed in #32, but the EXAMPLES section only covered pcap/mitm/TUI-filter usage. Add three examples mirroring the README so the manpage stands alone: tapgres --save session.jsonl tapgres --replay session.jsonl --tui tapgres --replay session.jsonl -Y 'message.type == "Query"' --- man/sections.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/man/sections.md b/man/sections.md index 91fa463..cd56828 100644 --- a/man/sections.md +++ b/man/sections.md @@ -116,6 +116,19 @@ Show only server-to-client errors and notices: tapgres -Y 'message.direction == "b2f" and message.type matches "^Error|Notice$"' +Tee every decoded record to a versioned JSONL session while still capturing +live. Recording happens before display filtering and the TUI history cap: + + tapgres --save session.jsonl + +Reopen a saved session in the TUI without starting capture: + + tapgres --replay session.jsonl --tui + +Replay recorded traffic through a display filter, exactly as with a live tap: + + tapgres --replay session.jsonl -Y 'message.type == "Query"' + Grant capture privileges without running as root (pcap mode): sudo setcap cap_net_raw+ep $(which tapgres)