fuchsia.inspect

新增：7

PROTOCOLS

InspectSink

在 fuchsia.inspect/inspect_sink.fidl 中定義

新增日期：16

代管

指示伺服器儲存提供的 VMO 來製作資料 可用於檢查讀者 這個 VMO 並未執行

這需在與元件架構的 收合 API 以在 IDLE 時停止，但仍確保 也可存取實用的診斷資訊

用戶端必須提供要做為不重複使用的 token 透過伺服器識別此 VMO這個符記是事件配對 用戶端必須提供這個事件組合的一端，並將保留到另一端 (或使用元件 API 託管控制代碼)。如果伺服器發現 PEER_CLOSED 會捨棄相關聯的 VMO 取得這組權杖

如果有任何必要引數未傳遞連線，系統就會 已打烊。

如要進一步瞭解如何停止 IDLE 元件，請參閱： https://fuchsia.dev/fuchsia-src/development/components/stop_idle

新增時間：HEAD

要求

名稱類型
payload InspectSinkEscrowRequest

FetchEscrow

指示伺服器傳回 (並停止追蹤) VMO 相關聯的 VMO 與給定憑證

此操作適用於元件重新啟動並想要擷取 檢查託管的資料。

如要進一步瞭解如何停止 IDLE 元件，請參閱： https://fuchsia.dev/fuchsia-src/development/components/stop_idle

新增時間：HEAD

要求

名稱類型
payload InspectSinkFetchEscrowRequest

回應

名稱類型
payload InspectSink_FetchEscrow_Result

發布

將控制代碼發布至fuchsia.inspect.Tree通訊協定 伺服器可用此工具讀取「檢查」資料，包括 Lazy 節點。

要求

名稱類型
payload InspectSinkPublishRequest

樹木

在 fuchsia.inspect/tree.fidl 中定義的

樹狀結構通訊協定代表檢查 VMO 的階層。

檢查檔案中儲存的連結值含有新值的參照 內含整體資料持續運作的具名檔案 階層通訊協定樹狀結構可讓用戶端請求這些已命名檔案， 只要代管元件仍存在

連結至特定樹木，就能保留該樹木居民的內容 在記憶體中建議客戶先深入研究樹木 才能降低記憶體用量放送元件可自由拒絕 ，避免無上限的記憶體使用行為。

GetContent

取得支援此樹狀結構檢查 VMO 的內容。

只要與 Tree 連線保持不變， 以確保寶樹仍然活著連線狀態後 則供應元件可以視需要清除 共用緩衝區。

供應元件可能會將不同的緩衝區傳回 GetContent 來處理相同樹狀結構的要求。

要求

<空白>

回應

名稱類型
content TreeContent

ListChildNames

逐一疊代屬於這個樹木的子項名稱。

呼叫 ListChildNames 和 OpenChild。

要求

名稱類型
tree_iterator server_end<TreeNameIterator>

OpenChild

依名稱開啟子項樹狀結構。

如果無法開啟子項目，系統就會關閉指定的要求。

要求

名稱類型
child_name TreeName
tree server_end<Tree>

TreeNameIterator

在 fuchsia.inspect/tree.fidl 中定義的

列出特定樹狀結構中子項名稱的疊代器通訊協定。

GetNext

取得下一批名稱。

傳回空白向量，並在沒有其他名稱的情況下關閉管道。 實作項目可能會在傳送最後一個批次後立即關閉管道。

要求

<空白>

回應

名稱類型
name vector<string>

結構

EscrowToken 資源

在 fuchsia.inspect/inspect_sink.fidl 中定義

新增時間：HEAD

欄位類型說明預設
token handle<eventpair> 無預設

資料表

InspectSinkEscrowRequest 資源

在 fuchsia.inspect/inspect_sink.fidl 中定義

Ordinal欄位類型說明
vmo EscrowedVmo

包含「檢查」伺服器會儲存資料的 VMO。 必要
token EscrowToken

識別此 VMO 並做為控制器的權杖 並停止在伺服器中儲存這個 VMO 必要
name string[4096]

用於識別這個 VMO 的選填名稱，且人類可讀。

選用
tree zx/Koid

先前提供的選用樹狀圖的選用參照 使用 Publish 載入伺服器伺服器會捨棄控點 進而觸發對等端在 樹狀結構伺服器如此一來，用戶端即可確保下列事項：

  • 快照中不會重複顯示樹狀資料和託管資料。
  • 呼叫端可知道何時該停止服務樹狀圖，從而阻止資料 不符合快照條件

如未提供 name，這項檢查的 name 將會是 與這個樹狀結構相關聯的資源

伺服器未追蹤任何與來源相關的帳號代碼 就會忽略此元件並視為 而不是提供其他提示

選用

InspectSinkFetchEscrowRequest 資源

在 fuchsia.inspect/inspect_sink.fidl 中定義

Ordinal欄位類型說明
token EscrowToken

與要擷取的 VMO taht 相關聯的權杖。如果這是 不會與任何 VMO 建立關聯，回應會是空白的。

必要
tree Tree

可供伺服器用來繼續讀取相關資料的控制代碼 與這個 VMO 互動元件先前為這個元件指定的名稱 但會維護這個 VMO這相當於呼叫 Publish 替換為傳回的 VMO，但會移除 如果系統讀取檢查資料時 元件會擷取 VMO 並發布樹狀結構。

選用

InspectSinkPublishRequest 資源

在 fuchsia.inspect/inspect_sink.fidl 中定義

Ordinal欄位類型說明
tree Tree

伺服器用於擷取「檢查」資料的樹狀結構。

如未提供，連線將會關閉。

必要
name string[4096]

從用戶端的角度識別這個樹狀結構的名稱。這個名稱 可以不必重複。多棵樹 系統會接受以相同名稱發布的內容，且不會覆寫 先前發布的樹木

選用

InspectSink_FetchEscrow_Response 資源

在 fuchsia.inspect/inspect_sink.fidl 中定義

Ordinal欄位類型說明
vmo EscrowedVmo

樹狀結構內容資源

在 fuchsia.inspect/tree.fidl 中定義的

特定「Inspect Tree」的內容。

Ordinal欄位類型說明
buffer fuchsia.mem/Buffer

包含檢查格式樹狀結構位元組的緩衝區。

聯合國

InspectSink_FetchEscrow_Result 嚴格 資源

在 fuchsia.inspect/inspect_sink.fidl 中定義

OrdinalVariant類型說明
response InspectSink_FetchEscrow_Response
framework_err internal

觀測站

名稱值類型說明
DEFAULT_TREE_NAME root String
新增日期：22
MAX_NAME_LENGTH 4096 uint64
新增日期：16
MAX_TREE_NAME_LENGTH 2040 uint64

檢查樹狀結構的長度上限，以格式指定。

別名

名稱值說明
EscrowedVmo zx/Handle
新增時間：HEAD
TreeName string[MAX_TREE_NAME_LENGTH]