fuchsia.developer.console

The resolved package where the launcher looks for the program.

The path, relative to the package's directory, where the program to be launched is found.

INTERNAL

Launcher encountered an unspecified, unexpected error.

NOT_SUPPORTED

Received unknown interaction or configuration variant.

INVALID_NAMESPACE_PATH

An invalid path was provided for the namespace.

DUPLICATE_NAMESPACE_PATH

Duplicate namespace paths were provided for the namespace.

PROGRAM_LOAD_FAILED

Failed to load executable VMO from provided program information.

PROCESS_LAUNCH_FAILED

The process could be built, but launching it failed.

PTY_FAILED

Launcher failed to set up the PTY proxying mechanism.

1

The launched process name.

Generated automatically if absent.

2

Additional arguments to pass to the launched process.

The server computes argv0 automatically from program.

Interpreted as empty vector if absent.

3

The program to run.

Interpreted as Program.default_shell if absent.

4

The standard input/output handles given to the program.

No standard IO handles are given if absent.

7

Environment variables to set for the launched process.

Interpreted as empty vector if absent.

8

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.

9

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.

10

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.

1

Raw handles are provided to the program.

2

A zircon socket is used as data source and the data is forwarded to the program via a PTY device. Both stderr and stdout end up in the same socket.

1

2

1

The default developer shell is launched.

The default shell is controlled by product configuration. Thus, when selecting this program the server automatically fills:

• environment PATH variable.
• arguments for interactive vs not interactive sessions based on arguments given to LaunchOptions.

2

The provided program from some package is launched.

When from_package is used the provided package is automatically added to the namespace under /pkg.