Skip to main content

Esta versão do GitHub Enterprise Server será descontinuada em 2026-04-09. Nenhum lançamento de patch será feito, mesmo para questões críticas de segurança. Para obter melhor desempenho, segurança aprimorada e novos recursos, atualize para a última versão do GitHub Enterprise Server. Para obter ajuda com a atualização, entre em contato com o suporte do GitHub Enterprise.

Specifying command options in a CodeQL configuration file

Save time by adding your frequently used command options and custom CodeQL packs to a CodeQL configuration file.

Quem pode usar esse recurso?

O CodeQL está disponível para os seguintes tipos de repositórios:

Using a CodeQL configuration file

  1. Create and save a config file under your home (Linux and macOS) or user profile (Windows) directory in the .config/codeql/ subdirectory. For example, $HOME/.config/codeql/config.

  2. In the config file, specify the options you want to apply to your CodeQL commands. The syntax for specifying options is as follows:

    <command> <subcommand> <option> <value>
    
  3. To apply the same options to more than one command, you can:

    • Omit <subcommand>, which will specify the option for every relevant <subcommand>
    • Omit both <command> and <subcommand>, which will specify the option globally for every relevant <command> and <subcommand>

Observação

  • config files only accept spaces, not =, between option flags and values.
  • Specifying an option on the command line overrides any config value defined for that option.
  • To specify more than one option for a <command>, <subcommand>, or globally, use one line per option.

Examples

  • To output all analysis results generated by codeql database analyze as CSV format, you would specify:

    database analyze --format csv
    

    Here, you have to specify the command and subcommand to prevent any of the low-level commands that are executed during database analyze being passed the same --format option.

  • To define the RAM (4096 MB) and number of threads (4) to use when running CodeQL commands, specify the following, on separate lines:

    --ram 4096
    --threads 4
    
  • To globally specify a directory for CodeQL to scan for CodeQL packs (which is not a sibling of the installation directory), use:

    --search-path <path-to-directory>