Fuchsia.dash

新增時間：16 天

通訊協定

啟動器

定義於 fuchsia.dash/launcher.fidl

ExploreComponentOverPty

啟動 dash 程序，範圍限定為具有指定路徑名稱的元件，轉送指定的 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」網址搭配使用的解析器。

已淘汰：20

要求

名稱類型
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 和通訊端之間傳輸位元組。

新增日期：20 位

要求

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

回應

名稱類型
payload Launcher_ExplorePackageOverSocket2_Result

OnTerminated

當殼層終止時，就會觸發這個事件。

回應

名稱類型
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>

ENUMS

DashNamespaceLayout 嚴格

類型：uint32

定義於 fuchsia.dash/launcher.fidl

為破折號程序建立的命名空間版面配置。

名稱值說明
1

所有執行個體目錄都會在子目錄底下建立巢狀結構，例如：命名空間位於 /ns 下方、傳出的目錄位於 /out 下方，等等。
2

執行個體命名空間是破折號殼層的根層級。 Fuchsia 中的多個 ELF 二進位檔和程式庫假設 svc 和 dev 等目錄將位於根層級。因此，這個版面配置應比在殼層中執行 Fuchsia ELF 二進位檔的巢狀結構更相容。

FuchsiaPkgResolver 彈性

類型：uint32

定義於 fuchsia.dash/launcher.fidl

套件解析器可用於解析採用 fuchsia-pkg 配置的套件網址。

新增日期：20 位

名稱值說明
1

解析 blobfs 的基本套件。
2

解析 blobfs 和任何已設定的遠端存放區的基本、快取或宇宙套件。

LauncherError strict

類型：uint32

定義於 fuchsia.dash/launcher.fidl

啟動器通訊協定的標準錯誤

名稱值說明
1

啟動器發生不明錯誤
2

啟動器無法剖析 Moniker
3

找不到與路徑名稱相符的執行個體
4

使用 fuchsia.sys2.RealmQuery 時發生錯誤
5

使用 fuchsia.process.Launcher 時發生錯誤
6

載入破折號二進位檔時發生錯誤
7

涉及 PTY 時發生錯誤
8

執行個體未處於已解析狀態，因此無法探索
9

使用 fuchsia.pkg.PackageResolver 時發生錯誤
10

解析工具套件時發生錯誤
11

啟動器無法剖析網址
12

從工具套件讀取二進位檔時發生錯誤
13

二進位名稱重複
14

使用 fuchsia.process.Resolver 時發生錯誤
15

使用 fuchsia.kernel.VmexResource 時發生錯誤
16

解決要探索的套件時發生錯誤。

聯合國

Launcher_ExploreComponentOverPty_Result 嚴格

定義於 fuchsia.dash/launcher.fidl

序數Variant類型說明
response Launcher_ExploreComponentOverPty_Response
err LauncherError

Launcher_ExploreComponentOverSocket_Result 嚴格

定義於 fuchsia.dash/launcher.fidl

序數Variant類型說明
response Launcher_ExploreComponentOverSocket_Response
err LauncherError

Launcher_ExplorePackageOverSocket2_Result 嚴格

定義於 fuchsia.dash/launcher.fidl

序數Variant類型說明
response Launcher_ExplorePackageOverSocket2_Response
err LauncherError

Launcher_ExplorePackageOverSocket_Result 嚴格

定義於 fuchsia.dash/launcher.fidl

序數Variant類型說明
response Launcher_ExplorePackageOverSocket_Response
err LauncherError

業者

名稱值類型說明
MAX_URLS 20 uint64

允許傳送至啟動器的網址數量上限。