ICMP errors
icmp_errorsExtract and group every ICMP and ICMPv6 error in a capture by sender, kind, and quoted flow to identify unreachables, firewall rejects, fragmentation needs, or TTL loops.
Instructions
Every ICMP and ICMPv6 error in the capture: who sends unreachables, about which
flows, is a firewall rejecting, is fragmentation needed somewhere, is TTL exceeded a
traceroute or a routing loop? Rows group the errors per sender, kind and quoted
flow (source, destination, protocol; the destination ports are listed): kind is
net_unreachable, host_unreachable, protocol_unreachable, port_unreachable,
frag_needed (with mtu), packet_too_big (ICMPv6, with mtu), admin_prohibited,
ttl_exceeded, reassembly_timeout, source_quench, redirect, parameter_problem,
no_route, address_unreachable or source_route_failed; with count, first/last frame,
the quoted IP ID and quoted_flow_seen (the frame of the original packet when the
capture holds it, IPv4 only). Also by_sender, echo (requests and replies) and issues. sender is an IP
address; about an address or address:port of the quoted flow (either end); kind keeps one
kind; filter is a display filter ANDed with the ICMP error and echo types.
More detail: resource schema://tools/icmp_errors.
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": "icmp_errors"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| kind | No | Keep one kind: net_unreachable, host_unreachable, protocol_unreachable, port_unreachable, frag_needed, ... | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| about | No | IP address inside the quoted packet | |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| 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 |
| sender | No | IP address that sent the ICMP errors | |
| columns | No | Row keys to keep (frame keys stay) | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| echo | No | ||
| count | No | ||
| error | No | ||
| errors | No | rows with keys: sender, kind, error, family, type, code, count, mtu, mtus, quoted, quoted_ip_id, quoted_flow_seen, first, last, first_frame, last_frame | |
| issues | No | ||
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | ||
| has_more | No | ||
| returned | No | ||
| by_sender | No | ||
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| display_filter | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |