Enum NodeError 

pub enum NodeError {
    Transport(TransportError),
    NameTooLong,
    Serialization,
    Deserialization,
    BufferTooSmall,
    ActionCreationFailed,
    ServiceRequestFailed,
    ServiceReplyFailed,
    Timeout,
    NotInitialized,
    RequestInFlight,
    NoSchedContextSlot,
    InvalidSchedContextBinding,
    NodeTableFull,
    ExecutorFull,
    BackendMismatch,
    ShutdownCallbacksFull,
    DeclaredDepthMismatch,
    DeclaredQosMismatch,
}

Error type for generic embedded node operations.

Not Copy — NodeError::Transport wraps a TransportError which carries owned diagnostic strings (Backend / BackendDynamic). Rust callers that matched on NodeError by value may need ref arms or .clone(); C/C++ callers are unaffected (they see an integer rcl_ret_t).

Variants

Transport(TransportError)

Transport-level error.

NameTooLong

Node name exceeds 64 bytes.

Serialization

CDR serialization failed.

Deserialization

CDR deserialization failed.

BufferTooSmall

Buffer too small for message.

ActionCreationFailed

Action server/client creation failed.

ServiceRequestFailed

Service request failed.

ServiceReplyFailed

Service reply failed.

Timeout

Operation timed out.

NotInitialized

A required subsystem has not been initialized (e.g. parameter services have not been registered on the executor).

RequestInFlight

The client / action client already has a request in flight that hasn’t been consumed. Phase 84.D3: fixes the hazard where dropping a Promise without awaiting its reply left the stale reply queued to be delivered to the next call. Resolve by either polling the existing promise to completion or calling reset_in_flight().

NoSchedContextSlot

Phase 110.B — create_sched_context ran out of slots (MAX_SC exceeded).

InvalidSchedContextBinding

Phase 110.B — bind_handle_to_sched_context was called with an out-of-range handle, an empty entry slot, or an unknown SchedContextId.

NodeTableFull

Phase 104.C.2 — Executor::node_builder(...).build() was called when the per-Executor node table is full (NROS_EXECUTOR_MAX_NODES reached).

ExecutorFull

Issue 0095 — the executor’s fixed callback-entry table is full (NROS_EXECUTOR_MAX_CBS, default 4): a timer / subscription / service / action could not claim a slot. Distinct from BufferTooSmall so the register seam can name the knob.

BackendMismatch

Phase 104.C.2 — requested RMW backend does not match the Executor’s open session (single-session restriction lifts in Phase 104.C.3 when the per-Node session cache lands).

ShutdownCallbacksFull

Issue 0790 — the shutdown-hook table for the requested phase is full (NROS_EXECUTOR_MAX_SHUTDOWN_CBS, default 2). Distinct from ExecutorFull so the register seam can name the knob that is actually exhausted; the two tables are sized independently of MAX_CBS.

DeclaredDepthMismatch

phase-454 W10 — this subscription’s QoS history depth disagrees with the depth the system DECLARED for that topic in the contract sidecar.

Depth is a multiplier on the executor arena, so a declaration and an implementation that state two different numbers mean the image was sized for one of them and runs the other. C++ catches this at COMPILE time (NROS_SUBSCRIBE’s static_assert) and C at compile time where the depth is a constant expression; Rust has no macro seam at the subscribe site and its topic is a runtime &str, so this is where the same disagreement lands — at registration, before the subscription exists. The two numbers and the topic are logged by crate::declared_qos::check; this variant is the refusal.

DeclaredQosMismatch

issue 1256 — this subscription’s QoS RELIABILITY or DURABILITY disagrees with what the system DECLARED for that topic in the contract sidecar.

Not a sizing fault like NodeError::DeclaredDepthMismatch, an INTEROP one: an incompatible-QoS match never delivers, so a registration that contradicts its contract is a link that would silently carry nothing. Which policy and both values are logged by crate::declared_qos::check / crate::declared_qos::honour.

Trait Implementations

impl Clone for NodeError

fn clone(&self) -> NodeError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NodeError

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

Formats the value using the given formatter.

impl Display for NodeError

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

Formats the value using the given formatter.

impl Eq for NodeError

impl Error for NodeError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<DeserError> for NodeError

fn from(_: DeserError) -> Self

Converts to this type from the input type.

impl From<SerError> for NodeError

fn from(_: SerError) -> Self

Converts to this type from the input type.

impl From<TransportError> for NodeError

fn from(err: TransportError) -> Self

Converts to this type from the input type.

impl PartialEq for NodeError

fn eq(&self, other: &NodeError) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for NodeError