iquery - Fuchsia Inspect API 查询工具包
剧情简介
iquery [--format <format>] <command> [<args>]
说明
iquery 是一个实用程序程序，用于检查通过 Inspect API 公开的组件节点。该方法接受一组选项和一个带有各自选项的命令。
在 shell 对某些字符进行转义时，为防止选择器出现难以调试的问题，建议始终将选择器用单引号或双引号引起来，以便 shell 将其作为原始字符串传递给 iquery。
选项
--format
输出内容的显示格式。
接受的格式：
text：默认，适合人类阅读json：适合机器阅读
--help
输出使用情况信息。
命令
list
列出公开 inspect 的所有组件（相对于归档程序接收事件的范围）。
对于 v1：这是大区路径加上大区名称。
对于 v2：这是不含实例 ID 的标识名。
用法示例：
$ iquery list
bootstrap/device_manager
core/archivist
...
--component
模糊搜索查询，可包含网址片段和标识片段。随附的位置参数选择器应省略组件选择器，因为它将从搜索结果中生成。
--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
--component
针对正在运行的组件（包括网址和名字片段）的模糊搜索查询。如果指定此参数，则输出仅包含网址包含指定名称的组件的标识名。
--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
--component
模糊搜索查询，可包含网址片段和标识片段。随附的位置参数选择器应省略组件选择器，因为它将从搜索结果中生成。
--file
我们感兴趣的文件名。如果提供此参数，输出将仅包含在 out/diagnostics 目录下的给定文件下公开 Inspect 的组件的数据。
--help
输出有关 show 的使用情况信息。