SMS over IMS
sms_over_imsExtract SMS over IMS from packet captures: parse SIP MESSAGE RP-DATA/RP-SMMA, pair RP-ACK/RP-ERROR, and filter by subscriber, number, or time.
Instructions
SMS over IMS (TS 24.341): SIP MESSAGE carrying application/vnd.3gpp.sms, one row
per RP-DATA or RP-SMMA. Each row gives direction (MO: RP-DATA from the UE with an
SMS-SUBMIT; MT: RP-DATA to the UE with an SMS-DELIVER or SMS-STATUS-REPORT), the RP
message reference, the SMSC address (smsc_digits), the TPDU (type, TP-MR,
TP-OA/TP-DA, status report requested, concatenation part, TP-Status of a status
report; never the text), the SIP response to the MESSAGE with its frame and delay,
and ack: the RP-ACK or RP-ERROR that answers it (paired by RP-MR and the UE's
identity, including the identities its REGISTER associated), with RP cause named,
the TPDU it carries and the SIP response to the MESSAGE that carried it. An MO
submit that asked for a status report gets status_report. ue_registration is the
UE's IMS registration from this capture and whether its Contact had +g.3gpp.smsip. number keeps rows naming
those digits, imsi rows whose identities contain it; filter is ANDed with the MESSAGE
filter.
More detail: resource schema://tools/sms_over_ims.
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": "sms_over_ims"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| imsi | No | IMSI, 6 to 15 digits | |
| path | Yes | Capture file (absolute, in an allowed dir) or open_capture handle | |
| limit | No | Most rows per page | |
| start | No | ISO 8601, epoch s, +Ns from start, -Ns from end | |
| filter | No | Extra display filter, ANDed | |
| number | No | Phone number digits found in From, To, Request-URI or P-Asserted-Identity | |
| 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 |
| columns | No | Row keys to keep (frame keys stay) | |
| esp_null | No | Read SIP in NULL-encrypted ESP | |
| max_output_kb | No | Lower output cap, KB |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| error | No | ||
| ipsec | No | keys: esp_packets, spis, decoded_null, unreadable, esp_null, hint | |
| offset | No | ||
| window | No | ||
| dropped | No | ||
| summary | No | ||
| has_more | No | ||
| messages | No | rows with keys: time, frame, direction, rp_message, rp_mr, call_id, request_uri, smsc_digits, tpdu, status_report_of_frame, sip_response, sip_response_frame, sip_response_ms, other_leg_statuses, legs, retransmissions, copies, ack, status_report, ue_registration, verdict, reasons | |
| returned | No | ||
| capture_end | No | ||
| next_offset | No | ||
| total_found | No | ||
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |