Files
kumomta/docs/reference/kcli/trace-smtp-server.md
Wez Furlong 41291a4afb docs: mark generated pages with an @generated marker
The documentation generators now stamp each page they emit with an
@generated comment so that tooling can tell generated pages apart from
hand-written ones. Update the table-of-contents generator to skip YAML
front matter when picking a page title, since the marker is now stored
there.
2026-10-05 13:22:26 +01:00

45 lines
1.3 KiB
Markdown

---
# @generated by kcli markdown-help
tags:
- ops
- debugging
---
# kcli trace-smtp-server
Trace incoming connections made to the SMTP service.
This is a diagnostic tool for the server operator.
Connections are logged in real time.
Take care to use an appropriate `--source` when using this with a live busy server, as you will be overwhelmed by the traffic.
**Usage:** `kcli trace-smtp-server [OPTIONS]`
## Options
* `--source <SOURCE>` — Add a source (in CIDR format) to the list of source addresses that we want to filter by. If any are specified, then only connections made from a matching address will be traced. If no sources are specified, any/all incoming SMTP connections will be traced.
Can be used multiple times to add multiple candidate addresses.
Eg: --source 10.0.0.1 --source 192.168.1.0/24
* `--color <COLOR>` — Whether to colorize the output
Default value: `tty`
Possible values: `tty`, `yes`, `no`
* `--only-new` — Trace only newly opened sessions; ignore data from previously opened sessions
* `--only-one` — Trace the first session that we observe, ignoring all others
* `--terse` — Abbreviate especially the read side of the transaction trace, which is useful when examining high traffic and/or large message transmission