fuchsia.session

PROTOCOLS

Launcher

Defined in fuchsia.session/launcher.fidl

A protocol used to launch sessions.

Launch

Launches the session detailed in configuration.

If a session is currently running, the component associated with the running session will be destroyed.

• configuration describes the session to launch.

• error LaunchError.INVALID_ARGS if configuration.session_url is not set.
• error LaunchError.NOT_FOUND if configuration.session_url could not be resolved.
• error LaunchError.DESTROY_COMPONENT_FAILED if an existing session component could not be destroyed. The existing session remains running at this point.
• error LaunchError.CREATE_COMPONENT_FAILED if the session component could not be started. No session will be running at this point.

Request

Name	Type
configuration	LaunchConfiguration

Response

Name	Type
result	Launcher_Launch_Result

Restarter

Defined in fuchsia.session/restarter.fidl

A protocol used to restart the currently running session.

Restart

Restarts the session.

• error RestartError.NOT_RUNNING if there is no currently running session to restart.
• error RestartError.DESTROY_COMPONENT_FAILED if an existing session component could not be destroyed. The existing session remains running at this point.
• error RestartError.CREATE_COMPONENT_FAILED if the session component could not be started. No session will be running at this point.

Request

<EMPTY>

Response

Name	Type
result	Restarter_Restart_Result

STRUCTS

Launcher_Launch_Response

Defined in fuchsia.session/launcher.fidl

<EMPTY>

Restarter_Restart_Response

Defined in fuchsia.session/restarter.fidl

<EMPTY>

ENUMS

LaunchError flexible

Type: uint32

Defined in fuchsia.session/launcher.fidl

An error that occurs when launching a session.

Name	Value	Description
INVALID_ARGS	1	The session's LaunchConfiguration is malformed.
NOT_FOUND	2	There was an error resolving the session's component URL.
DESTROY_COMPONENT_FAILED	3	The session component could not be destroyed.
CREATE_COMPONENT_FAILED	4	The session component could not be created.

RestartError flexible

Type: uint32

Defined in fuchsia.session/restarter.fidl

An error that occurs when restarting a session.

Name	Value	Description
NOT_RUNNING	1	There is no currently running session to restart.
NOT_FOUND	2	There was an error resolving the session's component URL.
DESTROY_COMPONENT_FAILED	3	The session component could not be destroyed.
CREATE_COMPONENT_FAILED	4	The session component could not be created.

TABLES

LaunchConfiguration

Defined in fuchsia.session/launcher.fidl

Describes a session to launch.

Ordinal	Field	Type	Description
1	session_url	string[4096]	The component URL of the session.

UNIONS

Launcher_Launch_Result strict

Defined in fuchsia.session/launcher.fidl

Ordinal	Variant	Type	Description
1	response	Launcher_Launch_Response
2	err	LaunchError

Restarter_Restart_Result strict

Defined in fuchsia.session/restarter.fidl

Ordinal	Variant	Type	Description
1	response	Restarter_Restart_Response
2	err	RestartError