Enum RunError

pub enum RunError {
    NoWaylandConnection(String),
    RegistryInit(String),
    EventLoop(String),
    MissingProtocol {
        name: &'static str,
        detail: String,
    },
}

Reasons crate::try_run (and therefore crate::run) can fail to bring up the event loop.

Every variant maps to a fatal failure during init: the Wayland connection, the calloop event loop, or one of the protocol bindings the runtime cannot operate without (wl_compositor, wl_shm, xdg_wm_base). Once init succeeds, the compositor disconnecting (BrokenPipe / ConnectionReset) is treated as a clean exit; any other runtime error during the dispatch loop still panics, since the surface is already on screen and the state machine cannot be unwound from this entry point.

Embedders that want a software-rendered fallback or that need to degrade gracefully should call crate::try_run and match on the variants instead of letting crate::run panic.

Variants

NoWaylandConnection(String)

WAYLAND_DISPLAY is unset, the socket is missing, or the compositor refused the handshake. Includes the detailed reason from the underlying wayland-client error.

RegistryInit(String)

The Wayland registry could not be enumerated. Almost always a compositor / driver bug — the registry is the first thing every Wayland client touches.

EventLoop(String)

calloop’s EventLoop::try_new or its Wayland source insertion failed (typically an io error talking to the kernel).

MissingProtocol

A required Wayland protocol is missing from the compositor. name is the wire-format protocol name; detail is the underlying bind error.

Fields

name: &'static str

detail: String

Trait Implementations

impl Debug for RunError

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

Formats the value using the given formatter.

impl Display for RunError

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

Formats the value using the given formatter.

impl Error for RunError

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.