IMS registration
ims_registrationDetermines whether each UE is registered on IMS and explains registration failures, helping diagnose why a UE cannot register or whether it is registered for SMS or voice.
Instructions
IMS registration per UE: whether each UE is registered on IMS and, if not, why.
Use it for "why can't this UE register" or "is it registered for SMS/voice"; for calls
use sip_dialogs, for SMS over IMS sms_over_ims. Built from every
SIP REGISTER transaction in the capture (public identity in the To header); the legs of one REGISTER through the
CSCFs (same Call-ID and CSeq) count once, copies of a packet are told apart from
retransmissions. Each row has the REGISTER transactions, Contact feature tags (smsip,
MMTel), implicit IMPUs, third-party REGISTERs and a verdict (registered, expired,
deregistered, challenge-loop, failed, in_progress, unknown) with reasons. impu keeps
users whose IMPU, IMPI or P-Associated-URI contain it; imsi keeps IMSI-based identities;
filter is ANDed with the REGISTER filter.
More detail: resource schema://tools/ims_registration.
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": "ims_registration"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Same forms as start | |
| impu | No | IMS public identity (sip: or tel: URI, or part of it) | |
| 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 | |
| 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 | ||
| returned | No | ||
| capture_end | No | ||
| next_offset | No | ||
| total_found | No | ||
| registrations | No | rows with keys: impu, impi, first_time, first_frame, last_time, verdict, reasons, registered_until, time_to_register_ms, user_agent, contact, feature_tags, smsip, mmtel, sec_agree, associated_uris, service_route, path_header, counts, transactions, third_party, reg_event_notifies, reg_subscriptions | |
| total_matched | No | ||
| packets_matched | No | ||
| packets_scanned | No | ||
| total_is_lower_bound | No |