Skip to main content

파일 충돌 해결

[심층 연결] 파일 포함/제외 패턴 집합 확장하기.

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

CodeQL은(는) 다음 리포지토리 유형에 사용할 수 있습니다.

이 기사에서

데이터 재사용 코드ql-cli.man-pages-version-note %}

개요

Shell
codeql resolve files <options>... -- <dir>

Description

          \[심층 연결] 파일 포함/제외 패턴 집합 확장하기.

이 내부 처리 명령은 경로로 식별된 여러 파일을 처리하는 하위 명령의 명령줄 매개변수를 확장하는 역할을 합니다. 기본적으로 모든 파일이 포함되므로, 필터 인수 없이 이 명령을 실행하면 디렉터리 내의 모든 파일이 수집됩니다.

          `--include`, `--exclude` 및 `--prune` 옵션은 모두 글롭 패턴을 사용하며, 다음 와일드카드 문자를 활용할 수 있습니다.
  • 단일 "?"는 슬래시(/ 또는 )를 제외한 임의의 문자 하나와 일치합니다.
  • 단일 "*"는 슬래시/백슬래시를 제외한 모든 문자 수와 일치합니다.
  • 패턴 "**"는 0개 이상의 전체 디렉터리 구성 요소와 일치합니다.

Options

기본 옵션

<dir>

검색할 디렉터리입니다.

--format=<fmt>

          `text`
          _(기본값)_ 또는 `json` 중에서 출력 형식을 선택합니다.

수집할 파일 집합을 제한하는 옵션입니다.

--include-extension=<.ext>

검색 디렉터리 트리에서 지정된 확장자를 가진 모든 파일을 포함합니다. 일반적으로 확장자 앞에 점(.)을 포함해야 합니다. 예를 들어, --include-extension .xml을 전달하면 ".xml" 확장자를 가진 모든 파일이 포함됩니다. 이 옵션은 부정된 --include 옵션과 호환되지 않습니다.

--include=<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-]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`부터 사용할 수 있습니다.