118 lines
3.1 KiB
Markdown
118 lines
3.1 KiB
Markdown
---
|
|
title: resolve ram
|
|
versions: # DO NOT MANUALLY EDIT. CHANGES WILL BE OVERWRITTEN BY A 🤖
|
|
fpt: '*'
|
|
ghec: '*'
|
|
ghes: '*'
|
|
topics:
|
|
- Code Security
|
|
- Code scanning
|
|
- CodeQL
|
|
type: reference
|
|
product: '{% data reusables.gated-features.codeql %}'
|
|
autogenerated: codeql-cli
|
|
intro: '[Deep plumbing] Prepare RAM options.'
|
|
redirect_from:
|
|
- /code-security/codeql-cli/manual/resolve-ram
|
|
---
|
|
|
|
|
|
<!-- Content after this section is automatically generated -->
|
|
|
|
{% data reusables.codeql-cli.man-pages-version-note %}
|
|
|
|
## Synopsis
|
|
|
|
```shell copy
|
|
codeql resolve ram [--ram=<MB>] <options>...
|
|
```
|
|
|
|
## Description
|
|
|
|
\[Deep plumbing] Prepare RAM options.
|
|
|
|
This deep plumbing command prepares appropriate command-line options to
|
|
start a subcommand that will execute a QL query evaluator. It knows
|
|
appropriate heuristics for deciding whether to keep some of the
|
|
configured memory outside the Java heap.
|
|
|
|
In particular, this should be used to find appropriate `-J-Xmx` and
|
|
`--off-heap-ram` options before starting a query server based on a
|
|
desired _total_ RAM amount.
|
|
|
|
## Options
|
|
|
|
### Primary Options
|
|
|
|
#### `--format=<fmt>`
|
|
|
|
Select output format. Choices include:
|
|
|
|
`lines` _(default)_: Print command-line arguments on one line each.
|
|
|
|
`json`: Print them as a JSON array.
|
|
|
|
### Options from the invoking command's command line
|
|
|
|
#### `-M, --ram=<MB>`
|
|
|
|
The query evaluator will try hard to keep its total memory footprint
|
|
below this value. (However, for large databases it is possible that the
|
|
threshold may be broken by file-backed memory maps, which can be swapped
|
|
to disk in case of memory pressure).
|
|
|
|
The value should be at least 2048 MB; smaller values will be
|
|
transparently rounded up.
|
|
|
|
#### `--dataset=<directory>`
|
|
|
|
\[Advanced] Tune the RAM settings appropriately for querying the given
|
|
dataset, taking into account components of RAM usage that scale with the
|
|
size of the database. If this is not given, a generic default size will
|
|
be assumed.
|
|
|
|
### Common options
|
|
|
|
#### `-h, --help`
|
|
|
|
Show this help text.
|
|
|
|
#### `-J=<opt>`
|
|
|
|
\[Advanced] Give option to the JVM running the command.
|
|
|
|
(Beware that options containing spaces will not be handled correctly.)
|
|
|
|
#### `-v, --verbose`
|
|
|
|
Incrementally increase the number of progress messages printed.
|
|
|
|
#### `-q, --quiet`
|
|
|
|
Incrementally decrease the number of progress messages printed.
|
|
|
|
#### `--verbosity=<level>`
|
|
|
|
\[Advanced] Explicitly set the verbosity level to one of errors,
|
|
warnings, progress, progress+, progress++, progress+++. Overrides `-v`
|
|
and `-q`.
|
|
|
|
#### `--logdir=<dir>`
|
|
|
|
\[Advanced] Write detailed logs to one or more files in the given
|
|
directory, with generated names that include timestamps and the name of
|
|
the running subcommand.
|
|
|
|
(To write a log file with a name you have full control over, instead
|
|
give `--log-to-stderr` and redirect stderr as desired.)
|
|
|
|
#### `--common-caches=<dir>`
|
|
|
|
\[Advanced] Controls the location of cached data on disk that will
|
|
persist between several runs of the CLI, such as downloaded QL packs and
|
|
compiled query plans. If not set explicitly, this defaults to a
|
|
directory named `.codeql` in the user's home directory; it will be
|
|
created if it doesn't already exist.
|
|
|
|
Available since `v2.15.2`.
|