TCP connections (refused, filtered, who closed)
tcp_connectionsList TCP connection attempts from a packet capture and classify each outcome—connected, refused, filtered, prohibited, or unreachable—to show whether a host and port are reachable.
Instructions
Can this host reach that port, and if not, is it refused, filtered or
prohibited? One row per TCP connection attempt (a SYN with a new initial sequence
number is a new attempt, the same one a retry; mirrored copies are dropped first)
with outcome: connected, refused (the server side answered the SYN with a reset:
nothing listens, or a firewall rejects with a reset), filtered (no answer at all: a
firewall drops it or the host is down; near_capture_end when the capture stopped
less than 3 s after the last SYN), prohibited (ICMP administratively prohibited
quoting the SYN), unreachable (another ICMP unreachable or TTL exceeded),
reset_during_handshake, handshake_incomplete (SYN-ACK never acknowledged), one_sided
(only one direction captured; not a failure) or seen_midway. Failed attempts come first; view="destinations" groups them per server
address and port with issues. server, client (IP addresses) and port (the server
port) narrow the attempts; outcome keeps one outcome; filter is a display filter ANDed
with tcp || icmp errors. For loss, windows and MTU inside a connection use tcp_health.
More detail: resource schema://tools/tcp_connections.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "tcp_connections"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| port | No | Server TCP port | |
| view | No | connections (one row per attempt) or destinations (per server and port) | connections |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| client | No | Client IP address | |
| filter | No | Extra display filter, ANDed | |
| offset | No | Rows to skip (next_offset) | |
| output | No | summary: all but rows, plus 3 rows (<8 KB) | rows |
| redact | No | Replace subscriber identifiers in this result with tokens; ids+ips hides every IP too | off |
| server | No | Server IP address | |
| columns | No | Row keys to keep (frame keys stay) | |
| outcome | No | Keep one outcome: connected, refused, filtered, prohibited, unreachable, reset_during_handshake, ... | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | ||
| count | No | ||
| error | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| has_more | No | ||
| returned | No | ||
| connections | No | rows with keys: stream, client, server, outcome, missing_direction, near_capture_end, syns, syn_retries, syn_retry_gaps_s, connect_ms, bytes_client_to_server, bytes_server_to_client, packets, duration_s, closed_by, completeness, icmp, reset_frame, first, first_frame, last_frame, copies_dropped | |
| next_offset | No | ||
| total_found | No | ||
| destinations | No | rows with keys: server, connections, attempts, connected, refused, filtered, prohibited, unreachable, reset_during_handshake, handshake_incomplete, one_sided, seen_midway, failed_then_connected_elsewhere, success_rate, syn_retries, connect_ms_p50, connect_ms_max, duration_s_p50, clients, max_concurrent, first_frame, issues | |
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |