Skip to main content

파일 충돌 해결

[심층 연결] 파일 포함/제외 GLOB 집합을 확장합니다.

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

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

이 문서의 내용

참고 항목

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

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

개요

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