Enum Dispatched 

#[non_exhaustive]
pub enum Dispatched {
    Invitation(Invitation),
    OutOfDialog(Incoming),
}

What the dispatcher could not place itself, handed to the application.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Invitation(Invitation)

An INVITE that belongs to no live call: an incoming call.

Answering, ringing or rejecting it is the application’s decision — the dispatcher takes none of them. Its inbox is already routed, so nothing that arrives while the application decides can be missed.

OutOfDialog(Incoming)

A request outside any dialog whose method this stack advertises but that matched no route: an OPTIONS ping.

Surfaced rather than refused because the Allow a 405 would carry (sipx_sip::update::ALLOW) names it, and answering 405 to a method the same message says is supported tells the peer two different things at once. What answers an OPTIONS is a user agent (sipx_ua::Agent::answer), which the call framework does not have.

A CANCEL never arrives here (S-23). It is the one advertised method the dispatcher can place itself, because RFC 3261 §9.2 says exactly what to do with it and both halves of the answer are the dispatcher’s to give: the 200 OK on the CANCEL’s own transaction, and the 487 Request Terminated on the INVITE transaction it withdraws. One that matches no pending INVITE transaction is answered 481 rather than handed over, because there is nothing an application could usefully decide about a transaction this stack does not have.

Trait Implementations

impl Debug for Dispatched

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.