참고 항목
이 콘텐츠는 CodeQL CLI의 최신 릴리스에 대해 설명합니다. 이 요소에 대한 자세한 내용은 https://github.com/github/codeql-cli-binaries/releases을(를) 참조하세요.
이전 릴리스에서 이 명령에 사용할 수 있는 옵션의 세부 정보를 보려면 터미널에서 옵션을 사용하여 --help 명령을 실행합니다.
개요
codeql resolve files <options>... -- <dir>
codeql resolve files <options>... -- <dir>
Description
\[심층 연결] 파일 포함/제외 GLOB 집합을 확장합니다.
이 연결 명령은 경로로 식별되는 여러 파일에 대해 동작하는 하위 명령의 명령줄 매개변수를 확장하는 역할을 합니다. 기본적으로 모든 파일이 포함되므로, 필터 인수 없이 이 명령을 실행하면 해당 디렉터리의 모든 파일을 수집하게 됩니다.
--include, --exclude 및 --prune 옵션에는 다음과 같은 와일드카드 문자를 포함한 GLOB 패턴을 사용할 수 있습니다.
- 단일 “?”는 슬래시와 백슬래시를 제외한 모든 문자와 일치합니다.
- 단일 "*"는 슬래시/백슬래시를 제외한 모든 문자 수와 일치합니다.
- 패턴 "**"는 0개 이상의 전체 디렉터리 구성 요소와 일치합니다.
Options
기본 옵션
<dir>
검색할 디렉터리입니다.
--format=<fmt>
text(기본값) 또는 json 중에서 출력 형식을 선택합니다.
수집한 파일 집합을 제한하는 옵션
--include-extension=<.ext>
지정한 확장자를 가진 검색 디렉터리 트리 내의 모든 파일을 포함합니다. 일반적으로 파일 확장자는 앞에 점을 포함해야 합니다.
예를 들어 --include-extension .xml 전달에는 ".xml" 확장명을 갖는 모든 파일이 포함됩니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.
--include=<glob>
검색 디렉터리 트리에서 지정된 GLOB 패턴과 일치하는 모든 파일 및 디렉터리를 각각의 상대 경로를 사용하여 포함합니다. GLOB가 ! 문자로 시작하는 경우 일치하는 파일 및 디렉터리는 제외됩니다.
`--include` 옵션은 순서대로 처리되며, 이후 옵션이 이전 옵션을 재정의할 수 있습니다. 예를 들어 `--include ** --include !sub/*.ts --include sub/main.*`는 `sub/main.ts`를 포함하고(`sub/main.*`에 의해 포함되기 때문), `sub/index.ts`를 제외하며(`!sub/*.ts`에 의해 제외되기 때문) `sub/test.js`를 포함합니다(이후에 제외되지 않고 `**`에 의해 포함되기 때문).
--also-match=<glob>
검색 디렉터리에서 각 파일과 디렉터리의 상대 경로를 기준으로, 모든 결과가 지정된 GLOB 패턴과 일치하도록 요구합니다. 이 옵션은 --include와 구조 및 해석이 동일하지만 --include와 함께 적용되는 별도의 GLOB 시퀀스를 지정합니다.
--exclude=<glob>
검색 디렉터리에서 지정된 GLOB 패턴과 일치하는 모든 파일 및 디렉터리를 각 항목의 상대 경로를 기준으로 제외합니다. 이 옵션은 모든 포함 옵션을 무시합니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.
--prune=<glob>
검색 디렉터리에서 지정된 GLOB 패턴과 일치하는 모든 파일 및 디렉터리를 각 항목의 상대 경로를 기준으로 제외합니다. 이 옵션은 모든 포함 옵션을 무시합니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.
--size-limit=<bytes>
지정된 크기를 초과하는 모든 파일은 제외합니다. 크기 제한은 바이트 단위 또는 ‘k’ 접미사를 사용하는 KiB(키비바이트), ‘m’ 접미사를 사용하는 MiB(메비바이트), ‘g’ 접미사를 사용하는 GiB(기비바이트)로 표시됩니다. 이 옵션은 모든 포함 옵션을 무시합니다.
--total-size-limit=<bytes>
확인된 모든 파일의 총 크기가 지정된 제한을 초과할 경우 명령이 오류와 함께 종료됩니다. 크기 제한은 바이트 단위 또는 ‘k’ 접미사를 사용하는 KiB(키비바이트), ‘m’ 접미사를 사용하는 MiB(메비바이트), ‘g’ 접미사를 사용하는 GiB(기비바이트)로 표시됩니다.
--[no-]follow-symlinks
대상에 대한 바로 가기 링크를 따라갑니다.
--[no-]find-any
모든 일치 항목이 아니라 최대 한 개의 일치 항목만 찾습니다.
v2.11.3부터 사용할 수 있습니다.
일반 옵션
-h, --help
이 도움말 텍스트를 표시합니다.
-J=<opt>
\[고급] 명령을 실행하는 JVM에 옵션을 제공합니다.
(옵션에 공백이 포함될 경우 처리가 정상적으로 이루어지지 않을 수 있으니 주의가 필요합니다.)
-v, --verbose
출력되는 진행률 메시지의 수를 점차 늘립니다.
-q, --quiet
출력되는 진행 상황 메시지의 빈도를 점차 줄여나갑니다.
--verbosity=<level>
\[고급] 세부 정보 표시 수준을 명시적으로 오류, 경고, 진행률, 진행률+, 진행률++, 진행률+++ 중 하나로 설정합니다.
`-v` 및 `-q`를 재정의합니다.
--logdir=<dir>
\[고급] 지정된 디렉터리에 하나 이상의 상세 로그 파일을 생성하며, 파일 이름에는 타임스탬프와 실행 중인 하위 명령 이름이 포함됩니다.
(로그 파일 이름을 직접 지정하려면 대신 --log-to-stderr 를 사용하고 stderr를 원하는 위치로 리디렉션하세요.)
--common-caches=<dir>
\[고급] 다운로드한 QL 팩과 컴파일된 쿼리 계획 등, CLI를 여러 번 실행해도 유지되는 디스크에 캐시된 데이터의 위치를 제어합니다. 명시적으로 설정하지 않으면, 기본적으로 사용자의 홈 디렉터리에 지정된 `.codeql` 이름의 디렉터리로 설정됩니다. 디렉터리가 아직 존재하지 않는 경우, 새로 생성됩니다.
v2.15.2부터 사용할 수 있습니다.