Struct Candidate 

pub struct Candidate { /* private fields */ }

A newly spawned candidate is disposable until its selection commits. Dropping a selected candidate only reaps it; it never terminates the daemon.

Implementations

impl Candidate

pub fn new(process: Child) -> Self

Take ownership immediately after spawning a staged candidate.

With local this also opens the candidate’s exit handle, while nothing has waited for the child, so the handle follows this process even if its PID is reused after a later reap.

pub fn id(&self) -> ProcessId

OS process identity used by the live verifier.

pub fn try_wait(&mut self) -> Result<Option<ExitStatus>>

Observe whether the candidate exited before readiness.

pub fn exit_handle(&mut self) -> Result<&mut ProcessHandle>

The candidate’s exit as an event, for a verifier that waits on it between probes instead of sleeping. The handle is opened by Self::new; this fails if that could not be done, and Self::wait_until then asks the child directly.

pub fn wait_until(&mut self, deadline: Instant) -> Result<Option<ExitStatus>>

Block until the candidate exits or deadline passes: its exit status, or None while it still runs.

pub fn selected(&mut self)

Mark the selection boundary before doing repairable follow-up work.

Trait Implementations

impl Drop for Candidate

fn drop(&mut self)

Stop an unselected candidate. Dropping its process then reaps it.

fn pin_drop(self: Pin<&mut Self>)

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

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl From<DaemonChild> for Candidate

Available on crate feature launch only.

A daemon started by DaemonCommand as a candidate: dropped before Candidate::selected, it is stopped. Take its readiness channel first; the candidate keeps it but does not give it out.

fn from(daemon: DaemonChild) -> Self

Converts to this type from the input type.