์ฐธ๊ณ ํญ๋ชฉ
์ด ์ฝํ ์ธ ๋ CodeQL CLI์ ์ต์ ๋ฆด๋ฆฌ์ค์ ๋ํด ์ค๋ช ํฉ๋๋ค. ์ด ์์์ ๋ํ ์์ธํ ๋ด์ฉ์ https://github.com/github/codeql-cli-binaries/releases์(๋ฅผ) ์ฐธ์กฐํ์ธ์.
์ด์ ๋ฆด๋ฆฌ์ค์์ ์ด ๋ช
๋ น์ ์ฌ์ฉํ ์ ์๋ ์ต์
์ ์ธ๋ถ ์ ๋ณด๋ฅผ ๋ณด๋ ค๋ฉด ํฐ๋ฏธ๋์์ ์ต์
์ ์ฌ์ฉํ์ฌ --help
๋ช
๋ น์ ์คํํฉ๋๋ค.
๊ฐ์
codeql query format [--output=<file>] [--in-place] [--backup=<ext>] <options>... -- <file>...
codeql query format [--output=<file>] [--in-place] [--backup=<ext>] <options>... -- <file>...
์ค๋ช
QL ์์ค ์ฝ๋๋ฅผ ์๋ ์์ ์ง์ ํฉ๋๋ค.
์ต์
๊ธฐ๋ณธ ์ต์
<file>...
์๋ ์์ ์ง์ ํ ํ๋ ์ด์์ .ql
๋๋ .qll
์๋ณธ ํ์ผ์
๋๋ค. ํ์ค ์
๋ ฅ์์ ์ฝ์ ์ ์๋๋ก ๋์๋ฅผ ์ง์ ํ ์ ์์ต๋๋ค.
-o, --output=<file>
ํ์ค ์ถ๋ ฅ ์คํธ๋ฆผ ๋์ ํ์์ด ์ง์ ๋ QL ์ฝ๋๋ฅผ ์ด ํ์ผ์ ๊ธฐ๋กํฉ๋๋ค. ์ ๋ ฅ์ด ๋ ์ด์์ธ ๊ฒฝ์ฐ ์ง์ ํด์๋ ์ ๋ฉ๋๋ค.
-i, --[no-]in-place
๊ฐ ์ ๋ ฅ ํ์ผ์ ํด๋น ๋ด์ฉ์ ํ์์ด ์ง์ ๋ ๋ฒ์ ์ผ๋ก ๋ฎ์ด์๋๋ค.
--[no-]check-only
์ถ๋ ฅ์ ๊ธฐ๋กํ๋ ๋์ ์
๋ ฅ ํ์ผ์ด ์ฌ๋ฐ๋ฅธ ํ์๊ณผ ๋ค๋ฅธ ๊ฒฝ์ฐ ์ํ 1๋ก ์ข
๋ฃํฉ๋๋ค. ์ด๋ค ํ์ผ์ด ๋ค๋ฅธ์ง ์๋ ค ์ฃผ๋ ๋ฉ์์ง๋ ์ฌ์ฉ์๊ฐ -qq
๋ ์ง์ ํ์ง ์๋ ํ ํ์ค ์ค๋ฅ๋ก ์ถ๋ ฅ๋ฉ๋๋ค.
-b, --backup=<ext>
์ด๋ฏธ ์กด์ฌํ๋ ํ์ผ์ ๊ธฐ๋กํ ๋๋ ์ด๋ฆ์ ์ด ํ์ฅ๋ช ์ ์ถ๊ฐํ์ฌ ๊ธฐ์กด ํ์ผ์ ์ด๋ฆ์ ๋ฐฑ์ ์ผ๋ก ๋ฐ๊ฟ๋๋ค. ๋ฐฑ์ ํ์ผ์ด ์ด๋ฏธ ์์ผ๋ฉด ์๋์ผ๋ก ์ญ์ ๋ฉ๋๋ค.
--no-syntax-errors
์ ๋ ฅ ํ์ผ์ด ๊ตฌ๋ฌธ์ ์ผ๋ก ์ฌ๋ฐ๋ฅธ QL์ด ์๋ ๊ฒฝ์ฐ ์ด๋ฏธ ํ์์ด ์ฌ๋ฐ๋ฅด๊ฒ ์ง์ ๋ ๊ฒ์ฒ๋ผ ๊ฐ์ฅํฉ๋๋ค. (์ผ๋ฐ์ ์ผ๋ก ์ด๋ฌํ ํ์ผ์ ๋ช ๋ น์ด ์ค๋ฅ ๋ฉ์์ง์ ํจ๊ป ์ข ๋ฃ๋๋๋ก ํฉ๋๋ค.)
์ผ๋ฐ ์ต์
-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
๋ถํฐ ์ฌ์ฉํ ์ ์์ต๋๋ค.