PROTOCOLS
Manager
Defined in fuchsia.starnix.runner/manager.fidl
ProxyWakeChannel
Creates a pass-through proxy that forwards messages between the container_channel
and the
remote_channel
.
If any messages arrive on remote_channel
while the container is suspended via
SuspendContainer
, the container will be resumed and resume_event
will be signaled with
ZX_EVENT_SIGNALED
. Any suspend call that is made while that signal is present on
resume_event
will wake immediately. The container is responsible for clearing
ZX_EVENT_SIGNALED
.
Request
Name | Type |
---|---|
payload |
ManagerProxyWakeChannelRequest
|
RegisterWakeWatcher
Registers an eventpair that will be signaled when the container is suspended or resumed. The signals are ASLEEP(USER_1) and AWAKE(USER_0).
The kernel returns AWAKE upon initial registration of the eventpair.
Request
Name | Type |
---|---|
payload |
ManagerRegisterWakeWatcherRequest
|
Response
Name | Type |
---|---|
payload |
Manager_RegisterWakeWatcher_Result
|
Resume
Resumes all suspended Starnix kernels.
Request
Name | Type |
---|---|
payload |
ManagerResumeRequest
|
Suspend
Suspends all the running Starnix kernels. Returns after all processes have been suspended.
Request
Name | Type |
---|---|
payload |
ManagerSuspendRequest
|
Response
Name | Type |
---|---|
payload |
Manager_Suspend_Result
|
SuspendContainer
Suspends the container running in job
.
The call will return successfully when wake_event
has been signaled. Returns
an error if wake_locks
is signaled at the end of suspension, or an error is
encountered when suspending the container's processes.
Request
Name | Type |
---|---|
payload |
ManagerSuspendContainerRequest
|
Response
Name | Type |
---|---|
payload |
Manager_SuspendContainer_Result
|
STRUCTS
Manager_RegisterWakeWatcher_Response
Defined in fuchsia.starnix.runner/manager.fidl
<EMPTY>
Manager_Suspend_Response
Defined in fuchsia.starnix.runner/manager.fidl
<EMPTY>
ENUMS
SuspendError flexible
Type: uint32
Defined in fuchsia.starnix.runner/manager.fidl
Name | Value | Description |
---|---|---|
WAKE_LOCKS_EXIST |
1 |
|
SUSPEND_FAILURE |
2 |
TABLES
ManagerProxyWakeChannelRequest resource
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
container_job |
handle<job>
|
The job of the container that holds the other end of |
2 |
container_channel |
handle<channel>
|
The channel endpoint that is connected to the container. |
3 |
remote_channel |
handle<channel>
|
The channel endpoint that is connected to a component outside the container. |
4 |
resume_event |
handle<eventpair>
|
The event that will be signaled when a message appears on |
5 |
name |
string:1024
|
The name of the proxy, used for debugging purposes. |
ManagerRegisterWakeWatcherRequest resource
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
watcher |
handle<eventpair>
|
The event that will be signaled when the container's wake status changes. |
ManagerResumeRequest
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Field | Type | Description |
---|
ManagerSuspendContainerRequest resource
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
container_job |
handle<job>
|
The job of the container to suspend. |
2 |
wake_locks |
handle<eventpair>
|
The event that is used to signal whether or not there are any active wake locks in the container. |
ManagerSuspendRequest
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Field | Type | Description |
---|
Manager_SuspendContainer_Response
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Field | Type | Description |
---|---|---|---|
1 |
suspend_time |
zx/Duration
|
The amount of time spent in the suspend state. It is used for tracking suspend stats in the Starnix kernel. |
UNIONS
Manager_RegisterWakeWatcher_Result strict
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Manager_RegisterWakeWatcher_Response
|
|
3 |
framework_err |
internal
|
Manager_SuspendContainer_Result strict
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Manager_SuspendContainer_Response
|
|
2 |
err |
SuspendError
|
|
3 |
framework_err |
internal
|
Manager_Suspend_Result strict
Defined in fuchsia.starnix.runner/manager.fidl
Ordinal | Variant | Type | Description |
---|---|---|---|
1 |
response |
Manager_Suspend_Response
|
|
3 |
framework_err |
internal
|
CONSTANTS
Name | Value | Type | Description |
---|---|---|---|
PROXY_NAME_LEN |
1024
|
uint32 |