Enum JobOperation 

#[non_exhaustive]
pub enum JobOperation {
    Hello,
    Start {
        id: JobId,
        command: ExecRequest,
        no_stdin: bool,
        input_base64: Option<String>,
        timeout_ms: Option<u64>,
    },
    List {
        all: bool,
        limit: usize,
        cursor: Option<JobId>,
    },
    Inspect {
        id: JobId,
    },
    Read {
        id: JobId,
        after: u64,
        attachment: Option<String>,
    },
    Attach {
        id: JobId,
        attachment: String,
        read_only: bool,
    },
    Detach {
        id: JobId,
        attachment: String,
    },
    Renew {
        id: JobId,
        attachment: String,
    },
    Write {
        id: JobId,
        attachment: String,
        data_base64: String,
    },
    Resize {
        id: JobId,
        attachment: String,
        rows: u16,
        cols: u16,
    },
    Signal {
        id: JobId,
        signal: i32,
    },
    Eof {
        id: JobId,
    },
}

Host-only operations. None waits for a process to exit or for output to become available.

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.

Hello

Discover support without creating a process.

Start

Admit a launch exactly once for this ID and command fingerprint.

Fields

id: JobId

Client-generated random identity and idempotency key.

command: ExecRequest

Existing guest command contract.

no_stdin: bool

Close guest stdin immediately after confirmed spawn.

input_base64: Option<String>

Optional finite pipe input (at most 64 KiB), followed by EOF.

timeout_ms: Option<u64>

Host-enforced elapsed execution limit in milliseconds.

List

List active or all retained jobs.

Fields

all: bool

Include terminal records.

limit: usize

Maximum page size (1..=100).

cursor: Option<JobId>

Continue after this identity.

Inspect

Inspect one retained job.

Fields

id: JobId

Owning job identity.

Read

Read bounded output, optionally renewing an attachment lease.

Fields

id: JobId

Owning job identity.

after: u64

Resume strictly after this output sequence.

attachment: Option<String>

Opaque attachment lease token.

Attach

Acquire one attachment. Reusing the same token is idempotent.

Fields

id: JobId

Owning job identity.

attachment: String

Opaque attachment lease token.

read_only: bool

Observe without acquiring input ownership.

Detach

Release an attachment without EOF or process termination.

Fields

id: JobId

Owning job identity.

attachment: String

Lease to release.

Renew

Keep an attachment alive without consuming output.

Fields

id: JobId

Owning job identity.

attachment: String

Lease to renew.

Write

Queue input for the current input-owning attachment.

Fields

id: JobId

Owning job identity.

attachment: String

Opaque attachment lease token.

data_base64: String

Original input bytes encoded as base64.

Resize

Resize the terminal for the input-owning attachment.

Fields

id: JobId

Owning job identity.

attachment: String

Opaque attachment lease token.

rows: u16

Nonzero terminal row count.

cols: u16

Nonzero terminal column count.

Signal

Send a Linux guest process-group signal.

Fields

id: JobId

Owning job identity.

signal: i32

Linux guest signal number.

Eof

Close a pipe after already admitted input; invalid for PTYs.

Fields

id: JobId

Owning job identity.

Trait Implementations

impl Clone for JobOperation

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JobOperation

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JobOperation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for JobOperation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.