#[non_exhaustive]pub enum TransactionState {
Nothing,
Calling,
Trying,
Proceeding,
Accepted,
Completed,
Confirmed,
Terminated,
}Expand description
SIP Transaction State
TransactionState represents the various states a SIP transaction can be in
during its lifecycle. These states implement the transaction state machines
defined in RFC 3261 for both client and server transactions, with the RFC 6026
Accepted state for INVITE 2xx response handling.
§States
Nothing- Initial state for client transactions createdCalling- Initial state for client transactions when request is sent or receivedTrying- Request has been sent/received, waiting for response/processingProceeding- Provisional response received/sent (1xx except 100 Trying)Accepted- INVITE transaction received/sent a 2xx final response (RFC 6026 §7.1/§7.2); server transaction waits for ACKs and absorbs 2xx retransmissions from the TU until Timer L fires; client transaction absorbs 2xx retransmissions from the server until Timer M fires.Completed- Final non-2xx response received/sent (RFC 3261 §17), waiting for ACK (server INVITE) or response retransmissions (client). For INVITE 2xx, seeAccepted(RFC 6026 supersedes RFC 3261 §17.2.1 paragraph 4 / §17.1.1.2).Confirmed- ACK received/sent for INVITE non-2xx (3xx-6xx) transactionsTerminated- Transaction has completed and is being cleaned up
§State Transitions
§Client Non-INVITE Transaction (RFC 3261 §17.1.2)
Nothing → Calling → Trying → Proceeding → Completed → Terminated§Client INVITE Transaction (RFC 3261 §17.1.1 + RFC 6026 §7.2)
Nothing → Calling → Trying → Proceeding ──2xx──→ Accepted ──Timer M──→ Terminated
│
└──3xx-6xx──→ Completed → Confirmed → Terminated§Server INVITE Transaction (RFC 3261 §17.2.1 + RFC 6026 §7.1)
Calling → Trying → Proceeding ──2xx──→ Accepted ──Timer L──→ Terminated
│
└──3xx-6xx──→ Completed ──ACK──→ Confirmed → Terminated§Server Non-INVITE Transaction (RFC 3261 §17.2.2)
Calling → Trying → Proceeding → Completed → Terminated§Examples
use rsipstack::transaction::TransactionState;
let state = TransactionState::Proceeding;
match state {
TransactionState::Nothing => println!("Transaction starting"),
TransactionState::Calling => println!("Request sent"),
TransactionState::Trying => println!("Request sent/received"),
TransactionState::Proceeding => println!("Provisional response"),
TransactionState::Accepted => println!("2xx accepted; waiting for Timer L/M"),
TransactionState::Completed => println!("Final non-2xx response"),
TransactionState::Confirmed => println!("ACK received/sent"),
TransactionState::Terminated => println!("Transaction complete"),
// `#[non_exhaustive]`: downstream code MUST keep a wildcard arm to
// remain forward-compatible with future state additions.
_ => println!("future RFC-extension state"),
}Variants (Non-exhaustive)§
This enum is marked as 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.
Nothing
Calling
Trying
Proceeding
Accepted
RFC 6026 §7.1 (server) / §7.2 (client): an INVITE transaction has sent or received
a 2xx final response. The server absorbs 2xx retransmissions from the TU and waits
for ACK until Timer L (= 64T1) fires; the client absorbs server-retransmitted 2xx
responses until Timer M (= 64T1) fires. Replaces the RFC 3261 §17.1.1.2 / §17.2.1
behaviour that incorrectly routed 2xx through the Completed state.
Completed
Confirmed
Terminated
Trait Implementations§
Source§impl Clone for TransactionState
impl Clone for TransactionState
Source§impl Debug for TransactionState
impl Debug for TransactionState
Source§impl Display for TransactionState
impl Display for TransactionState
Source§impl PartialEq for TransactionState
impl PartialEq for TransactionState
impl StructuralPartialEq for TransactionState
Auto Trait Implementations§
impl Freeze for TransactionState
impl RefUnwindSafe for TransactionState
impl Send for TransactionState
impl Sync for TransactionState
impl Unpin for TransactionState
impl UnsafeUnpin for TransactionState
impl UnwindSafe for TransactionState
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
fn instrument(self, span: Span) -> Instrumented<Self> ⓘ
Source§fn in_current_span(self) -> Instrumented<Self> ⓘ
fn in_current_span(self) -> Instrumented<Self> ⓘ
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read more