Skip to main content

resolve ram

[Deep plumbing] 准备 RAM 选项。

谁可以使用此功能?

GitHub CodeQL 在安装后按用户授权。 根据许可证限制,只能将 CodeQL 用于某些任务。 有关详细信息,请参阅“关于 CodeQL CLI”。

如果你有 GitHub Advanced Security 许可证,则可以使用 CodeQL 进行自动分析、持续集成和持续交付。 有关详细信息,请参阅“关于 GitHub 高级安全性”。

本文内容

此内容描述了 CodeQL CLI 的最新版本。 有关此版本的详细信息,请参阅 https://github.com/github/codeql-cli-binaries/releases

若要查看早期版本中此命令可用选项的详细信息,请在终端中使用 --help 选项运行命令。

摘要

Shell
codeql resolve ram [--ram=<MB>] <options>...

说明

[Deep plumbing] 准备 RAM 选项。

此深度管道命令准备适当的命令行选项,用于启动将执行 QL 查询计算器的子命令。 此命令了解适当的试探法,这些方法用于确定是否将一些已配置的内存保留在 Java 堆之外。

具体而言,这应该用于在根据所需 RAM 总量启动查询服务器之前查找合适的 -J-Xmx--off-heap-ram 选项。

选项

主要选项

--format=<fmt>

选择输出格式。 选项包括:

lines(默认值):输出每一行上的命令行参数。

json:以 JSON 数组格式输出它们。

调用命令的命令行中的选项

-M, --ram=<MB>

查询计算器将努力将其总内存占用情况保持在此值以下。 (但对于大型数据库而言,阈值可能会被文件支持的内存图破坏,如果出现内存压力,可以交换到磁盘)。

该值应至少为 2048 MB;较小的值将以透明方式向上舍入。

--dataset=<directory>

[高级] 适当调整 RAM 设置以查询给定数据集,同时考虑随数据库大小而变化的 RAM 使用情况组件。 如果未提供此值,则假定采用泛型默认大小。

常用选项

-h, --help

显示此帮助文本。

-J=<opt>

[高级] 为运行命令的 JVM 提供选项。

(请注意,无法正确处理包含空格的选项。)

-v, --verbose

以增量方式增加输出的进度消息数。

-q, --quiet

以增量方式减少输出的进度消息数。

--verbosity=<level>

[高级] 将详细级别显式设置为“错误”、“警告”、“进度”、“进度+”、“进度++”、“进度+++”之一。 重写 -v-q

--logdir=<dir>

[高级] 将详细日志写入给定目录中的一个或多个文件,其中生成的名称包括时间戳和正在运行的子命令的名称。

(若要使用可以完全控制的名称编写日志文件,请根据需要提供 --log-to-stderr 并重定向 stderr。)

--common-caches=<dir>

[高级] 控制磁盘上缓存数据的位置,此位置会在多次运行 CLI(例如下载的 QL 包和已编译查询计划)期间暂留。 如果未明确设置,则默认为用户主目录中名为 .codeql 的目录;如果尚不存在,则会创建该目录。

v2.15.2 起可用。