Struct LaunchOptions 

pub struct LaunchOptions {
    pub name: Option<String>,
    pub args: Option<Vec<String>>,
    pub program: Option<Program>,
    pub io_handles: Option<IoHandles>,
    pub env: Option<Vec<String>>,
    pub namespace_entries: Option<Vec<NameInfo>>,
    pub stopper: Option<EventPair>,
    pub directories_fixup: Option<bool>,
    /* private fields */
}

Options given to [Launcher.Launch].

Fields

name: Option<String>

The launched process name.

Generated automatically if absent.

args: Option<Vec<String>>

Additional arguments to pass to the launched process.

The server computes argv0 automatically from program.

Interpreted as empty vector if absent.

program: Option<Program>

The program to run.

Interpreted as Program.default_shell if absent.

io_handles: Option<IoHandles>

The standard input/output handles given to the program.

No standard IO handles are given if absent.

env: Option<Vec<String>>

Environment variables to set for the launched process.

Interpreted as empty vector if absent.

namespace_entries: Option<Vec<NameInfo>>

Extra namespace entries to give to the launched process.

Entries that collide with the default entries provided by the developer console override the defaults.

All namespace entry paths MUST start with a /, INVALID_NAMESPACE_PATH is returned otherwise.

Interpreted as empty vector if absent.

stopper: Option<EventPair>

An event pair that must be kept alive for the created process to be maintained.

Optional. If provided, the container job for the launched process is destroyed when the peer handle for stopper is closed.

directories_fixup: Option<bool>

Enables fixing up the launch namespace for the conventional shell namespace.

When using the /toolbox namespace for launching programs, it may be necessary to organize the directories given to toolbox so that they look like a “standardized” directory layout. This is a built-in feature that allows the server to provide this fix up which consists of walking /directories in the namespace and applying the following renaming rules:

• /directories/root-ssl-certificates => /config/ssl.
• /directories/build-info => /config/build_info.
• /directories/[any] => /[any].

Interpreted as false if absent.

Trait Implementations

impl Debug for LaunchOptions

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

Formats the value using the given formatter.

impl Decode<LaunchOptions, DefaultFuchsiaResourceDialect> for LaunchOptions

fn new_empty() -> Self

Creates a valid instance of Self. The specific value does not matter, since it will be overwritten by decode.

unsafe fn decode( &mut self, decoder: &mut Decoder<'_, DefaultFuchsiaResourceDialect>, offset: usize, depth: Depth, ) -> Result<()>

Decodes an object of type T from the decoder’s buffers into self.

impl Default for LaunchOptions

fn default() -> LaunchOptions

Returns the “default value” for a type.

impl Encode<LaunchOptions, DefaultFuchsiaResourceDialect> for &mut LaunchOptions

unsafe fn encode( self, encoder: &mut Encoder<'_, DefaultFuchsiaResourceDialect>, offset: usize, depth: Depth, ) -> Result<()>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID.

impl PartialEq for LaunchOptions

fn eq(&self, other: &LaunchOptions) -> 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 ResourceTypeMarker for LaunchOptions

type Borrowed<'a> = &'a mut LaunchOptions

The Rust type to use for encoding. This is a particular Encode<Self> type cheaply obtainable from &mut Self::Owned. There are three cases:

fn take_or_borrow<'a>( value: &'a mut <Self as TypeMarker>::Owned, ) -> Self::Borrowed<'a>

Cheaply converts from &mut Self::Owned to Self::Borrowed. For HandleBased types this is “take” (it returns an owned handle and replaces value with Handle::invalid), and for all other types it is “borrow” (just converts from one reference to another).

impl TypeMarker for LaunchOptions

type Owned = LaunchOptions

The owned Rust type which this FIDL type decodes into.

fn inline_align(_context: Context) -> usize

Returns the minimum required alignment of the inline portion of the encoded object. It must be a (nonzero) power of two.

fn inline_size(_context: Context) -> usize

Returns the size of the inline portion of the encoded object, including padding for alignment. Must be a multiple of inline_align.

fn encode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and encoding requires no validation. When true, we can optimize encoding arrays and vectors of Self::Owned to a single memcpy.

fn decode_is_copy() -> bool

Returns true if the memory layout of Self::Owned matches the FIDL wire format and decoding requires no validation. When true, we can optimize decoding arrays and vectors of Self::Owned to a single memcpy.

impl Standalone<DefaultFuchsiaResourceDialect> for LaunchOptions

impl StructuralPartialEq for LaunchOptions