iquery - Fuchsia Inspect API 查詢工具包
劇情概要
iquery [--format <format>] <command> [<args>]
說明
iquery 是一項公用程式程式，可檢查透過 Inspect API 公開的元件節點。外掛程式接受一組選項和一個指令，其中包含各自的選項。
為避免在殼層逸出某些字元或其他字元的選取器中偵錯問題，建議您一律以單引號或雙引號括住選取器，讓殼層以原始字串的形式傳送至 iquery。
選項
--format
輸出內容的顯示格式。
接受的格式：
text：預設，適合人為閱讀json：適合用於機器讀取
--help
列印使用資訊。
指令
list
列出公開檢查元件的所有元件 (相對於封存者接收事件的來源範圍)。
v1：這是領域路徑加上領域名稱。
v2：這是沒有執行個體 ID 的路徑名稱。
使用範例：
$ iquery list
bootstrap/device_manager
core/archivist
...
--manifest
您為資訊清單檔案指定的名稱。如果指定此屬性，則輸出內容只會包含網址包含指定名稱的元件。
--with-url
同時列印路徑名稱和啟動元件的網址。
--help
列印 list 的使用資訊。
list-files [<monikers...>]
列出包含指定 paths 下包含檢查資料的所有檔案。
這個指令會檢查的檔案如下：
fuchsia.inspect.Tree：服務檔案。程式庫檢查資料的標準方法檢查匯出資料的方式。*.inspect：含有檢查資料的 VMO 檔案。Dart 檢查程式庫匯出檢查資料的標準方式。fuchsia.inspect.deprecated.Inspect：服務檔案。Go 程式庫匯出檢查資料的標準方式。
使用範例：
$ iquery list-files bootstrap/archivist bootstrap/driver_manager
bootstrap/archivist
fuchsia.inspect.Tree
bootstrap/driver_manager
class/display-coordinator/000.inspect
class/input-report/000.inspect
class/input-report/001.inspect
class/misc/000.inspect
class/pci-root/000.inspect
class/pci/000.inspect
class/sysmem/481.inspect
driver_manager/driver_host/10171/root.inspect
...
--help
列印 list-files 的使用資訊。
selectors [<selectors...>]
列出所有可用的完整選取器 (元件選取器 + 樹狀結構選取器)。
如有提供元件選取器，系統只會顯示該元件的選取器。
如果提供完整選取器 (元件 + 樹狀結構)，會列出指定節點下的所有選取器。
使用範例：
$ iquery selectors 'core/archivist:root/fuchsia.inspect.Health' 'core/timekeeper'
core/archivist:root/fuchsia.inspect.Health:start_timestamp_nanos
core/archivist:root/fuchsia.inspect.Health:status
core/timekeeper:root/current:system_uptime_monotonic_nanos
core/timekeeper:root/current:utc_nanos
core/timekeeper:root:start_time_monotonic_nanos
--manifest
您為資訊清單檔案指定的名稱。如果指定此屬性，則輸出內容只會包含網址包含指定名稱的元件。
--help
列印關於 selectors 的使用資訊
show [<selectors...>]
列印與指定選取器相符的檢查階層。
使用範例：
$ iquery show 'archivist.cm:root/fuchsia.inspect.Health' 'core/timekeeper'
core/archivist:
root:
fuchsia.inspect.Health:
start_timestamp_nanos = 30305104656
status = OK
core/timekeeper:
root:
start_time_monotonic_nanos = 30347000053
current:
system_uptime_monotonic_nanos = 61617527688648
utc_nanos = 1591119246552989779
--manifest
您為資訊清單檔案指定的名稱。如果指定此屬性，則輸出內容只會包含網址包含指定名稱的元件。
--file
我們感興趣的檔案名稱。如有提供，則輸出內容只會包含來自特定元件的資料，而這些元件會在其 Out/diagnostics 目錄下公開檢查。
--help
列印 show 的使用資訊。