Struct fidl_fuchsia_process::LauncherProxy

pub struct LauncherProxy { /* private fields */ }

Implementations

impl LauncherProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.process/Launcher.

pub fn take_event_stream(&self) -> LauncherEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn launch( &self, info: LaunchInfo ) -> QueryResponseFut<(i32, Option<Process>)>

Creates and starts the process described by info.

After processing this message, the Launcher is reset to its initial state and is ready to launch another process.

process is present if, and only if, status is ZX_OK.

pub fn create_without_starting( &self, info: LaunchInfo ) -> QueryResponseFut<(i32, Option<Box<ProcessStartData>>)>

Creates the process described by info but does not start it.

After processing this message, the Launcher is reset to its initial state and is ready to launch another process.

The caller is responsible for calling zx_process_start using the data in ProcessStartData to actually start the process.

data is present if, and only if, status is ZX_OK.

pub fn add_args(&self, args: &[Vec<u8>]) -> Result<(), Error>

Adds the given arguments to the command-line for the process.

Calling this method multiple times concatenates the arguments.

pub fn add_environs(&self, environ: &[Vec<u8>]) -> Result<(), Error>

Adds the given variables to the environment variables for the process.

Calling this method multiple times concatenates the variables.

pub fn add_names(&self, names: Vec<NameInfo>) -> Result<(), Error>

Adds the given names to the namespace for the process.

The paths in the namespace must be non-overlapping. See https://fuchsia.dev/fuchsia-src/concepts/process/namespaces for details.

Calling this method multiple times concatenates the names.

pub fn add_handles(&self, handles: Vec<HandleInfo>) -> Result<(), Error>

Adds the given handles to the startup handles for the process.

Calling this method multiple times concatenates the handles.

pub fn set_options(&self, options: u32) -> Result<(), Error>

Sets the options with which the process is created.

Calling this method multiple times will overwrite the current options.

Trait Implementations

impl Clone for LauncherProxy

fn clone(&self) -> LauncherProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for LauncherProxy

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

Formats the value using the given formatter.

impl LauncherProxyInterface for LauncherProxy

type LaunchResponseFut = QueryResponseFut<(i32, Option<Process>)>

fn launch(&self, info: LaunchInfo) -> Self::LaunchResponseFut

type CreateWithoutStartingResponseFut = QueryResponseFut<(i32, Option<Box<ProcessStartData>>)>

fn create_without_starting( &self, info: LaunchInfo ) -> Self::CreateWithoutStartingResponseFut

fn add_args(&self, args: &[Vec<u8>]) -> Result<(), Error>

fn add_environs(&self, environ: &[Vec<u8>]) -> Result<(), Error>

fn add_names(&self, names: Vec<NameInfo>) -> Result<(), Error>

fn add_handles(&self, handles: Vec<HandleInfo>) -> Result<(), Error>

fn set_options(&self, options: u32) -> Result<(), Error>

impl Proxy for LauncherProxy

type Protocol = LauncherMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.