์ฐธ๊ณ ํญ๋ชฉ
์ด ์ฝํ ์ธ ๋ CodeQL CLI์ ์ต์ ๋ฆด๋ฆฌ์ค์ ๋ํด ์ค๋ช ํฉ๋๋ค. ์ด ์์์ ๋ํ ์์ธํ ๋ด์ฉ์ https://github.com/github/codeql-cli-binaries/releases์(๋ฅผ) ์ฐธ์กฐํ์ธ์.
์ด์ ๋ฆด๋ฆฌ์ค์์ ์ด ๋ช
๋ น์ ์ฌ์ฉํ ์ ์๋ ์ต์
์ ์ธ๋ถ ์ ๋ณด๋ฅผ ๋ณด๋ ค๋ฉด ํฐ๋ฏธ๋์์ ์ต์
์ ์ฌ์ฉํ์ฌ --help
๋ช
๋ น์ ์คํํฉ๋๋ค.
๊ฐ์
codeql resolve languages <options>...
codeql resolve languages <options>...
์ค๋ช
์ค์น๋ CodeQL ์ถ์ถ๊ธฐ ํฉ์ ๋์ดํฉ๋๋ค.
JSON ์ถ๋ ฅ์ ์ ํํ ์ํ๋ก ์คํํ๋ฉด ์ด ๋ช ๋ น์ ๊ฐ ์ถ์ถ๊ธฐ ํฉ ์ด๋ฆ์ ๋ํด ์ฌ๋ฌ ์์น๋ฅผ ๋ณด๊ณ ํ ์ ์์ต๋๋ค. ์ด ๊ฒฝ์ฐ ํฉ์ ๋จ์ผ ๊ฒ์ ์์ ๋ด์์ ์ถฉ๋ํ๋ ์์น๊ฐ ์์ผ๋ฏ๋ก ์ค์ ๋ก ํ์ธํ ์ ์์ต๋๋ค. ํธ์ถ์๋ ์ค์ ์์น๋ฅผ ์ฌ์ฉํ์ฌ ์ ์ ํ ์ค๋ฅ ๋ฉ์์ง ํ์์ ์ง์ ํ ์ ์์ต๋๋ค.
์ต์
๊ธฐ๋ณธ ์ต์
--search-path=<dir>[:<dir>...]
์ถ์ถ๊ธฐ ํฉ์ ์ฐพ์ ์ ์๋ ๋๋ ํฐ๋ฆฌ ๋ชฉ๋ก์ ๋๋ค. ๋๋ ํฐ๋ฆฌ๋ ์ถ์ถ๊ธฐ ํฉ ์์ฒด ๋๋ ์ฆ์ ํ์ ๋๋ ํฐ๋ฆฌ๋ก ์ถ์ถ๊ธฐ๋ฅผ ํฌํจ ํ๋ ๋๋ ํฐ๋ฆฌ ์ ์์ต๋๋ค.
๊ฒฝ๋ก์ ์ฌ๋ ค ๋๋ ํฐ๋ฆฌ ํธ๋ฆฌ๊ฐ ํฌํจ๋ ๊ฒฝ์ฐ ํด๋น ์์๋ ์ฐ์ ์์๋ฅผ ์ ์ํฉ๋๋ค. ๋์ ์ด๋ฆ์ด ๋๋ ํฐ๋ฆฌ ํธ๋ฆฌ ์ค ํ๋ ์ด์์์ ์ผ์นํ๋ ๊ฒฝ์ฐ ์ง์ ๋ ์ฒซ ๋ฒ์งธ ํธ๋ฆฌ๊ฐ ์ฐ์ ์ ์ผ๋ก ์ ์ฉ๋ฉ๋๋ค.
CodeQL ๋๊ตฌ ์ฒด์ธ ์์ฒด์ ํจ๊ป ๋ฒ๋ค๋ก ์ ๊ณต๋๋ ์ถ์ถ๊ธฐ๋ ํญ์ ์ฐพ์ ์ ์์ง๋ง ๋ณ๋๋ก ๋ถ์ฐ๋ ์ถ์ถ๊ธฐ๋ฅผ ์ฌ์ฉํด์ผ ํ๋ ๊ฒฝ์ฐ, ์ด ์ต์
์ ์ ๊ณตํด์ผ ํฉ๋๋ค(์๋๋ฉด ์ฌ์ฉ์๋ณ ๊ตฌ์ฑ ํ์ผ์์ --search-path
์(๋ฅผ) ์ค์นํ๋ ๊ฒ์ด ๋ ์ข์ต๋๋ค).
(์ฐธ๊ณ : Windows์์๋ ๊ฒฝ๋ก ๊ตฌ๋ถ ๊ธฐํธ๊ฐ ;
์
๋๋ค.)
--[no-]filter-to-languages-with-queries
๊ธฐ๋ณธ ์ฟผ๋ฆฌ๊ฐ ์๋ ์ธ์ด๋ง ๋์ดํฉ๋๋ค.
v2.23.0
๋ถํฐ ์ฌ์ฉํ ์ ์์ต๋๋ค.
--format=<fmt>
์ถ๋ ฅ ํ์์ ์ ํํฉ๋๋ค. ๋ค์์ ์ ํํ ์ ์์ต๋๋ค.
text
(๊ธฐ๋ณธ๊ฐ): ์ถ์ถ๊ธฐ ํฉ์ ๊ฒฝ๋ก๋ฅผ ํ์ค ์ถ๋ ฅ์ผ๋ก ์ถ๋ ฅํฉ๋๋ค.
json
: ์ถ์ถ๊ธฐ ํฉ์ ๊ฒฝ๋ก๋ฅผ JSON ๋ฌธ์์ด๋ก ์ถ๋ ฅํฉ๋๋ค.
betterjson
: ์ถ์ถ๊ธฐ ํฉ์ ๋ํ ์ธ๋ถ ์ ๋ณด๋ฅผ JSON ๋ฌธ์์ด๋ก ์ถ๋ ฅํฉ๋๋ค.
์ผ๋ฐ ์ต์
-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
๋ถํฐ ์ฌ์ฉํ ์ ์์ต๋๋ค.