Skip to content

docs(man): add save and replay examples #35

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
sunng87 merged 1 commit into from
Jul 22, 2026
Merged

docs(man): add save and replay examples #35

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions man/sections.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down