fuchsia.dash

协议

启动器

在 fuchsia.dash/launcher.fidl 中定义

ExploreComponentOverPty

启动范围限定为具有给定名称的组件的短划线进程，转发给定的 stdio PTY。

请求

名称	类型
moniker	string
pty	fuchsia.hardware.pty/Device
tool_urls	vector<string>[20]
command	string?
ns_layout	DashNamespaceLayout

响应

名称	类型
payload	Launcher_ExploreComponentOverPty_Result

ExploreComponentOverSocket

启动范围限定为具有给定名称的组件的短划线进程，转发给定的 stdio 套接字。

短划线启动器会隐式创建 PTY，并在 PTY 和套接字之间传输字节。

请求

名称	类型
moniker	string
socket	handle<socket>
tool_urls	vector<string>[20]
command	string?
ns_layout	DashNamespaceLayout

响应

名称	类型
payload	Launcher_ExploreComponentOverSocket_Result

ExplorePackageOverSocket

启动一个短划线进程，将指定的 [sub]软件包加载到位于 /pkg 的命名空间中，并转发给定的 stdio 套接字。

短划线启动器会隐式创建 PTY，并在 PTY 和套接字之间传输字节。

始终使用 fuchsia.dash/FuchsiaPkgResolver.FULL 解析架构为“fuchsia-pkg”的软件包网址。 请改用 fuchsia.dash/Launcher.ExplorePackageOverSocket2 来选择要与“fuchsia-pkg”网址搭配使用的解析器。

请求

名称	类型
url	string
subpackages	vector<string>
socket	handle<socket>
tool_urls	vector<string>[20]
command	string?

响应

名称	类型
payload	Launcher_ExplorePackageOverSocket_Result

ExplorePackageOverSocket2

启动一个短划线进程，将指定的 [sub]软件包加载到位于 /pkg 的命名空间中，并转发给定的 stdio 套接字。

短划线启动器会隐式创建 PTY，并在 PTY 和套接字之间传输字节。

请求

名称	类型
fuchsia_pkg_resolver	FuchsiaPkgResolver
url	string
subpackages	vector<string>
socket	handle<socket>
tool_urls	vector<string>[20]
command	string?

响应

名称	类型
payload	Launcher_ExplorePackageOverSocket2_Result

OnTerminated

此事件会在 shell 终止时触发。

响应

名称	类型
return_code	int32

结构

Launcher_ExploreComponentOverPty_Response

在 fuchsia.dash/launcher.fidl 中定义

<EMPTY>

Launcher_ExploreComponentOverSocket_Response

在 fuchsia.dash/launcher.fidl 中定义

<EMPTY>

Launcher_ExplorePackageOverSocket2_Response

在 fuchsia.dash/launcher.fidl 中定义

<EMPTY>

Launcher_ExplorePackageOverSocket_Response

在 fuchsia.dash/launcher.fidl 中定义

<EMPTY>

枚举

Dash 命名空间布局 strict

类型：uint32

在 fuchsia.dash/launcher.fidl 中定义

要为 Dash 进程创建的命名空间布局。

名称	值	说明
NEST_ALL_INSTANCE_DIRS	1	所有实例目录都嵌套在子目录下。例如，命名空间位于 /ns 下，传出 dir 位于 /out 下，等等。
INSTANCE_NAMESPACE_IS_ROOT	2	实例命名空间是信息中心 shell 的根目录。 Fuchsia 中的一些 ELF 二进制文件和库假定 svc 和 dev 等目录位于根目录下。因此，对于在 shell 中运行 Fuchsia ELF 二进制文件，此布局应该比嵌套更兼容。

FuchsiaPkgResolver 灵活

类型：uint32

在 fuchsia.dash/launcher.fidl 中定义

软件包解析器可用于通过 fuchsia-pkg 架构解析软件包网址。

名称	值	说明
BASE	1	通过 blobfs 解析基础软件包。
FULL	2	从 blobfs 以及任何已配置的远程仓库中解析基础软件包、缓存软件包或 Universe 软件包。

LauncherError严格

类型：uint32

在 fuchsia.dash/launcher.fidl 中定义

启动器协议的标准错误

名称	值	说明
内部	1	启动器遇到未知错误
BAD_MONIKER	2	启动器无法解析 Monik
INSTANCE_NOT_FOUND	3	未找到与名称匹配的实例
REALM_QUERY	4	使用 fuchsia.sys2.RealmQuery 时出错
PROCESS_LAUNCHER	5	使用 fuchsia.process.Launcher 时出错
DASH_BINARY	6	加载短划线二进制文件时出错
PTY	7	发生了涉及 PTY 的错误
INSTANCE_NOT_RESOLVED	8	实例未处于已解析状态，因此没有要探索的内容
PACKAGE_RESOLVER	9	使用 fuchsia.pkg.PackageResolver 时出错
TOOLS_CANNOT_RESOLVE	10	解析工具软件包时出错
BAD_URL	11	启动器无法解析网址
TOOLS_BINARY_READ	12	从工具软件包中读取二进制文件时出错
NON_UNIQUE_BINARY_NAME	13	二进制文件名称重复
PROCESS_RESOLVER	14	使用 fuchsia.process.Resolver 时出错
VMEX_RESOURCE	15	使用 fuchsia.kernel.VmexResource 时出错
RESOLVE_TARGET_PACKAGE	16	解析要浏览的软件包时出错。

联合

Launcher_ExploreComponentOverPty_Result 严格

在 fuchsia.dash/launcher.fidl 中定义

序数	变体	类型	说明
1	response	Launcher_ExploreComponentOverPty_Response
2	err	LauncherError

Launcher_ExploreComponentOverSocket_Result 严格

在 fuchsia.dash/launcher.fidl 中定义

序数	变体	类型	说明
1	response	Launcher_ExploreComponentOverSocket_Response
2	err	LauncherError

Launcher_ExplorePackageOverSocket2_Result 严格

在 fuchsia.dash/launcher.fidl 中定义

序数	变体	类型	说明
1	response	Launcher_ExplorePackageOverSocket2_Response
2	err	LauncherError

Launcher_ExplorePackageOverSocket_Result 严格

在 fuchsia.dash/launcher.fidl 中定义

序数	变体	类型	说明
1	response	Launcher_ExplorePackageOverSocket_Response
2	err	LauncherError

常量

名称	值	类型	说明
MAX_URLS	20	uint64	允许发送到启动器的网址数量上限。