Enum Command 

#[non_exhaustive]
pub enum Command {
    Send {
        signal: RawNumber,
        signal_origin: Option<Field>,
        targets: Vec<Field>,
    },
    Print {
        signals: Vec<Field>,
        verbose: bool,
    },
}

Parsed command line arguments

Design notes

Command::Print::signals contains raw operands received as command-line arguments. Since determining whether a number represents a signal number or an exit status falls within the semantics of print, these operands remain unconverted to specific signals by the time arguments are parsed as Command::Print. In contrast, Command::Send requires signal name validation during command-line option parsing, so even when signals are specified by name, Command::Send::signal already contains a signal converted to its numerical value.

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.

Send

Sends a signal to processes

Fields

signal: RawNumber

Signal to send

This signal number may represent an invalid signal if it was specified by number on the command line.

signal_origin: Option<Field>

Parameter that specified the signal, if any

targets: Vec<Field>

Target processes

Print

Lists signal names or descriptions

Fields

signals: Vec<Field>

Signals to list

Field values can be:

• Signal names, e.g., HUP, TERM;
• Signal numbers, e.g., 1, 15; or
• Exit statuses representing signals, e.g., 386 for SIGINT.

If empty, all signals are listed.

verbose: bool

Whether to print descriptions

Implementations

impl Command

pub async fn execute<S>(&self, env: &mut Env<S>) -> Result

where S: Fcntl + Isatty + SendSignal + Signals + Write,

Executes the built-in.

Trait Implementations

impl Clone for Command

fn clone(&self) -> Command

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Command

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

Formats the value using the given formatter.

impl PartialEq for Command

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Command

impl StructuralPartialEq for Command