此内容描述了 CodeQL CLI 的最新版本。有关此版本的更多信息,请参阅 https://github.com/github/codeql-cli-binaries/releases。
要在较早版本中查看此命令可用的选项的详细信息,请在终端中使用 --help
选项运行该命令。
概要
codeql resolve languages <options>...
codeql resolve languages <options>...
描述
列出已安装的 CodeQL 提取器包。
当使用选择的 JSON 输出运行时,此命令可以为每个提取器包名称报告多个位置。发生这种情况时,这意味着该包在一个搜索元素中具有冲突的位置,因此实际上无法解析。调用者可以使用实际位置来格式化适当的错误消息。
选项
主要选项
--search-path=<dir>[:<dir>...]
可以找到提取器包的目录列表。这些目录可以是提取器包本身,也可以是包含提取器作为直接子目录的目录。
如果路径包含多个目录树,则它们的顺序定义它们之间的优先级:如果目标语言在多个目录树中匹配,则首先给出的目录树优先。
与 CodeQL 工具链捆绑在一起的提取器将始终被找到,但是如果您需要使用单独分发的提取器,则需要使用此选项(或者更好的是,在每个用户的配置文件中设置--search-path
)。
(注意:在 Windows 上,路径分隔符为;
)。
--format=<fmt>
选择输出格式。选项包括
text
(默认):将提取器包的路径打印到标准输出。
json
:将提取器包的路径打印为 JSON 字符串。
betterjson
:将提取器包的详细信息打印为 JSON 字符串。
常用选项
-h, --help
显示此帮助文本。
-J=<opt>
[高级] 向运行命令的 JVM 提供选项。
(注意,包含空格的选项将无法正确处理。)
-v, --verbose
递增地增加打印的进度消息数量。
-q, --quiet
递减地减少打印的进度消息数量。
--verbosity=<level>
[高级] 将详细程度明确设置为 errors、warnings、progress、progress+、progress++、progress+++ 之一。覆盖-v
和 -q
。
--logdir=<dir>
[高级] 将详细日志写入给定目录中的一个或多个文件中,生成的名称包括时间戳和正在运行的子命令的名称。
(要写入名称完全受您控制的日志文件,请改用--log-to-stderr
并根据需要重定向 stderr。)
--common-caches=<dir>
[高级] 控制磁盘上缓存数据的存储位置,这些数据将在 CLI 的多次运行之间持续存在,例如下载的 QL 包和已编译的查询计划。如果未显式设置,则默认为用户主目录中名为.codeql
的目录;如果该目录不存在,则会创建它。
自v2.15.2
起可用。