database trace-command

이 콘텐츠는 CodeQL CLI의 최신 릴리스에 대해 설명합니다. 이 요소에 대한 자세한 내용은 https://github.com/github/codeql-cli-binaries/releases을(를) 참조하세요.

이전 릴리스에서 이 명령에 사용할 수 있는 옵션의 세부 정보를 보려면 터미널에서 옵션을 사용하여 --help 명령을 실행합니다.

개요

Shell

codeql database trace-command [--threads=<num>] [--ram=<MB>] [--extractor-option=<extractor-option-name=value>] <options>... -- <database> <command>...

codeql database trace-command [--threads=<num>] [--ram=<MB>] [--extractor-option=<extractor-option-name=value>] <options>... -- <database> <command>...

설명

[연결] 추적된 빌드의 일부로 단일 명령을 실행합니다.

이렇게 하면 추적기에서 지정된 단일 명령줄을 실행하므로 일부 추출을 수행할 수 있지만 결과로 나타난 CodeQL 데이터베이스는 완료되지 않습니다.

옵션

기본 옵션

`<database>`

[필수] 생성 중인 CodeQL 데이터베이스의 경로입니다. codeql 데이터베이스 init을 사용하여 추출할 준비가 되어 있어야 합니다.

--db-cluster 옵션이 지정된 경우 데이터베이스 자체가 아니라 데이터베이스를 _포함_하는 디렉터리이며 이러한 모든 데이터베이스가 함께 처리됩니다.

`<command>...`

실행할 명령입니다. 프로세스를 만드는 데 사용되는 하나 이상의 인수로 구성됩니다. 인수와 인수 간의 혼동을 방지하기 위해 명령 인수를 나열하기 전에 '--' 인수를 전달하는 것이 좋습니다.

이 명령은 상태 코드 0으로 종료되어야 합니다. 다른 모든 종료 코드는 오류로 해석됩니다.

--index-traceless-dbs가 지정된 경우 명령을 생략할 수 있습니다.

`-j, --threads=<num>`

추출기에서 해당 스레드 수를 사용하도록 요청합니다. 이 옵션은 제안으로써 추출기로 전달됩니다. CODEQL_THREADS 환경 변수가 설정되면 환경 변수 값이 이 옵션보다 우선합니다.

0을 전달하여 컴퓨터의 코어당 하나의 스레드를 사용하거나 -_N_을 전달하여 _N_개의 코어를 사용하지 않은 상태로 둘 수 있습니다(하나 이상의 스레드를 계속 사용하는 경우 제외).

`-M, --ram=<MB>`

추출기에서 해당 메모리를 사용하도록 요청합니다. 이 옵션은 제안으로써 추출기로 전달됩니다. CODEQL_RAM 환경 변수가 설정되면 환경 변수 값이 이 옵션보다 우선합니다.

`--[no-]db-cluster`

명령줄에 지정된 디렉터리가 데이터베이스 자체가 아니라 생성 중인 하나 이상의 데이터베이스를 _포함_하는 디렉터리임을 나타냅니다. 이러한 데이터베이스는 함께 처리됩니다.

`--no-tracing`

[고급] 지정된 명령을 추적하지 않고 명령에 의존하여 필요한 모든 데이터를 직접 생성합니다.

`--extra-tracing-config=<tracing-config.lua>`

[고급] 추적기 구성 파일의 경로입니다. 빌드 추적기의 동작을 수정하는 데 사용할 수 있습니다. 빌드 명령의 일부로 실행되는 컴파일러 프로세스를 선택하고 다른 도구의 실행을 트리거하는 데 사용할 수 있습니다. 추출기는 대부분의 상황에서 작동해야 하는 기본 추적기 구성 파일을 제공합니다.

`--[no-]index-traceless-dbs`

지정된 명령 외에도 빌드 프로세스 추적에 의존하지 않는 추출기에 대해 기본 스크립트를 실행합니다. --db-cluster로 여러 언어에 대한 데이터베이스를 생성하는 경우 이 옵션은 codeql database trace-command을 정확히 한 번 호출할 때 지정해야 합니다.

`--[no-]use-build-mode`

데이터베이스의 빌드 모드에 따라 무엇을 실행할지 결정합니다. 이 옵션은 --index-traceless-dbs과(와) 함께 사용할 수 없습니다.

`--working-dir=<dir>`

[고급] 지정된 명령을 실행해야 하는 디렉터리입니다. 이 인수가 제공되지 않으면 명령이 codeql 데이터베이스 만들기에 전달된 --source-root 값(있는 경우)으로 실행됩니다. --source-root 인수가 제공되지 않으면 명령이 현재 작업 디렉터리에서 실행됩니다.

`--no-run-unnecessary-builds`

[고급] 생성 중인 데이터베이스가 빌드 프로세스 추적에 의존하는 추출기를 사용하는 경우에만 지정된 빌드 명령을 실행합니다. 이 옵션을 지정하지 않으면 다른 이유로 인해 부작용이 필요하다는 가정 하에 CodeQL이 필요하지 않은 경우에도 명령이 실행됩니다.

CodeQL 추출기에 대한 옵션을 설정합니다. extractor-option-name은(는) extractor_name.group1.group2.option_name 또는 group1.group2.option_name의 형식이어야 합니다. extractor_option_name이(가) 추출기 이름으로 시작하는 경우, 표시된 추출기는 group1.group2.option_name 옵션을 선언해야 합니다. 그렇지 않으면 옵션 group1.group2.option_name을 선언하는 모든 추출기에서 옵션을 설정합니다. value은(는) 줄을 포함하지 않는 모든 문자열일 수 있습니다.

이 명령줄 옵션을 반복적으로 사용하여 여러 추출기 옵션을 설정할 수 있습니다. 동일한 추출기 옵션에 여러 값을 제공하는 경우, 동작은 추출기 옵션이 예상하는 형식에 따라 달라집니다. 문자열 옵션은 제공된 마지막 값을 사용합니다. 배열 옵션은 제공된 모든 값을 순서대로 사용합니다. 이 명령줄 옵션을 사용하여 지정된 추출기 옵션은 추출기 옵션을 통해 --extractor-options-file이(가) 제공된 후에 처리됩니다.

codeql 데이터베이스 init 또는 codeql database begin-tracing에 전달되면 옵션이 간접 추적 환경에만 적용됩니다. 워크플로에서 codeql 데이터베이스 추적 명령을 호출하는 경우, 원하는 경우의 옵션도 전달해야 합니다.

각 추출기에서 선언한 옵션을 나열하는 방법을 포함하여 CodeQL 추출기 옵션에 대한 자세한 내용은 https://codeql.github.com/docs/codeql-cli/extractor-options을(를) 참조하세요.

누가 이 기능을 사용할 수 있나요?

이 문서의 내용

개요

설명

옵션

기본 옵션

`<database>`

`<command>...`

`-j, --threads=<num>`

`-M, --ram=<MB>`

`--[no-]db-cluster`

`--no-tracing`

`--extra-tracing-config=<tracing-config.lua>`

`--[no-]index-traceless-dbs`

`--[no-]use-build-mode`

`--working-dir=<dir>`

`--no-run-unnecessary-builds`

추출기 동작 제어 옵션

`-O, --extractor-option=<extractor-option-name=value>`

`--extractor-options-file=<extractor-options-bundle-file>`

일반 옵션

`-h, --help`

`-J=<opt>`

`-v, --verbose`

`-q, --quiet`

`--verbosity=<level>`

`--logdir=<dir>`

`--common-caches=<dir>`