Enum SimctlError 

#[non_exhaustive]
pub enum SimctlError {
    Spawn(Error),
    NonZeroExit {
        subcommand: String,
        argv: Vec<String>,
        code: i32,
        stderr: String,
        wall_ms: u64,
    },
    Malformed {
        subcommand: String,
        detail: String,
    },
    Timeout {
        subcommand: String,
        ms: u64,
    },
    CaptureBackpressure {
        retry_after: Duration,
    },
}

Failure variants for any xcrun simctl invocation.

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.

Spawn(Error)

Failed to spawn the xcrun process itself (PATH lookup / fork failure).

NonZeroExit

xcrun simctl <sub> exited non-zero.

v1.0.7 §D2 — carries the full argv and wall_ms so the Display impl surfaces every argument the consumer needs to reproduce or file a precise upstream bug. Prior versions reported only the subcommand name (e.g., "spawn") without telling the caller which binary or paths simctl was asked to touch. See .claude/rfcs/1.0.7-observability-layer.md §D2.

Fields

subcommand: String

Subcommand name (e.g. "boot", "launch").

argv: Vec<String>

Full argv passed to xcrun simctl (excludes the xcrun simctl prefix itself; includes subcommand + all args).

Since smix 1.0.7.

code: i32

Exit code from xcrun simctl.

stderr: String

Captured stderr (truncated for log-friendliness).

wall_ms: u64

Wall-clock milliseconds the invocation ran before failing.

Since smix 1.0.7.

Malformed

xcrun simctl <sub> exited 0 but stdout didn’t match the expected shape.

Fields

subcommand: String

Subcommand name.

detail: String

Parser-side detail.

Timeout

xcrun simctl <sub> did not complete within the deadline.

Fields

subcommand: String

Subcommand name.

ms: u64

Deadline that was exceeded (milliseconds).

CaptureBackpressure

The screenshot pacer’s circuit is open — a recent screenshot wall time exceeded the circuit threshold, or a screenshot failed. Callers should back off for retry_after and try again. See screenshot_pacer::ScreenshotPacer and .claude/rfcs/1.0.4-sim-health-and-backpressure.md §D3.

Since smix 1.0.4.

Fields

retry_after: Duration

Suggested minimum delay before the next attempt.

Implementations

impl SimctlError

pub fn non_zero_exit( subcommand: impl Into<String>, code: i32, stderr: impl Into<String>, ) -> Self

v1.0.7 §D2 — synthetic NonZeroExit for callers translating a foreign subprocess error into SimctlError (e.g. AndroidDeviceControl adapting adb failures). Fills argv = [subcommand] + wall_ms = 0; when the caller has a real argv, prefer the struct literal.

Trait Implementations

impl Debug for SimctlError

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

Formats the value using the given formatter.

impl Display for SimctlError

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

Formats the value using the given formatter.

impl Error for SimctlError

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<Error> for SimctlError

fn from(source: Error) -> Self

Converts to this type from the input type.