์ฐธ๊ณ ํญ๋ชฉ
์ด ์ฝํ ์ธ ๋ CodeQL CLI์ ์ต์ ๋ฆด๋ฆฌ์ค์ ๋ํด ์ค๋ช ํฉ๋๋ค. ์ด ์์์ ๋ํ ์์ธํ ๋ด์ฉ์ https://github.com/github/codeql-cli-binaries/releases์(๋ฅผ) ์ฐธ์กฐํ์ธ์.
์ด์ ๋ฆด๋ฆฌ์ค์์ ์ด ๋ช
๋ น์ ์ฌ์ฉํ ์ ์๋ ์ต์
์ ์ธ๋ถ ์ ๋ณด๋ฅผ ๋ณด๋ ค๋ฉด ํฐ๋ฏธ๋์์ ์ต์
์ ์ฌ์ฉํ์ฌ --help
๋ช
๋ น์ ์คํํฉ๋๋ค.
๊ฐ์
codeql resolve ram [--ram=<MB>] <options>...
codeql resolve ram [--ram=<MB>] <options>...
์ค๋ช
[์ฌ์ธต ์ฐ๊ฒฐ] RAM ์ต์ ์ ์ค๋นํฉ๋๋ค.
์ด ์ฌ์ธต ์ฐ๊ฒฐ ๋ช ๋ น์ QL ์ฟผ๋ฆฌ ํ๊ฐ๊ธฐ๋ฅผ ์คํํ ํ์ ๋ช ๋ น์ ์์ํ๋ ์ ์ ํ ๋ช ๋ น์ค ์ต์ ์ ์ค๋นํฉ๋๋ค. ๊ตฌ์ฑ๋ ๋ฉ๋ชจ๋ฆฌ ์ค ์ผ๋ถ๋ฅผ Java ํ ์ธ๋ถ์ ์ ์งํ ์ง ์ฌ๋ถ๋ฅผ ๊ฒฐ์ ํ๊ธฐ ์ํ ์ ์ ํ ๊ฒฝํ์ ์ ๊ทผ ๋ฐฉ์์ ์๊ณ ์์ต๋๋ค.
ํนํ ์ํ๋ ์ด RAM ์์ ๋ฐ๋ผ ์ฟผ๋ฆฌ ์๋ฒ๋ฅผ ์์ํ๊ธฐ ์ ์ ์ ์ ํ -J-Xmx
๋ฐ --off-heap-ram
์ต์
์ ์ฐพ๋ ๋ฐ ์ฌ์ฉํด์ผ ํฉ๋๋ค.
์ต์
๊ธฐ๋ณธ ์ต์
--format=<fmt>
์ถ๋ ฅ ํ์์ ์ ํํฉ๋๋ค. ๋ค์์ ์ ํํ ์ ์์ต๋๋ค.
lines
(๊ธฐ๋ณธ๊ฐ): ๋ช
๋ น์ค ์ธ์๋ฅผ ๊ฐ๊ฐ ํ ์ค๋ก ์ถ๋ ฅํฉ๋๋ค.
json
: JSON ๋ฐฐ์ด๋ก ์ถ๋ ฅํฉ๋๋ค.
ํธ์ถํ๋ ๋ช ๋ น์ ๋ช ๋ น์ค ์ต์
-M, --ram=<MB>
์ฟผ๋ฆฌ ํ๊ฐ๊ธฐ๋ ์ด ๋ฉ๋ชจ๋ฆฌ ๊ณต๊ฐ์ ์ด ๊ฐ ์๋๋ก ์ ์งํ๊ธฐ ์ํด ์ด์ฌํ ๋ ธ๋ ฅํฉ๋๋ค. (๊ทธ๋ฌ๋ ํฐ ๋ฐ์ดํฐ๋ฒ ์ด์ค์ ๊ฒฝ์ฐ ๋ฉ๋ชจ๋ฆฌ๊ฐ ๋ถ์กฑํ๋ฉด ๋์คํฌ๋ก ๊ตํํ ์ ์๋ ํ์ผ ์ง์ ๋ฉ๋ชจ๋ฆฌ ๋งต์ผ๋ก ์๊ณ๊ฐ์ด ์์๋ ์ ์์ต๋๋ค.)
๊ฐ์ 2048MB ์ด์์ด์ด์ผ ํฉ๋๋ค. ์์ ๊ฐ์ ํฌ๋ช ํ๊ฒ ๋ฐ์ฌ๋ฆผ๋ฉ๋๋ค.
--dataset=<directory>
[๊ณ ๊ธ] ์ง์ ๋ ๋ฐ์ดํฐ ์ธํธ๋ฅผ ์ฟผ๋ฆฌํ๋ ๋ฐ ์ ํฉํ RAM ์ค์ ์ ์กฐ์ ํ๊ณ , ๋ฐ์ดํฐ๋ฒ ์ด์ค ํฌ๊ธฐ๋ก ํฌ๊ธฐ๋ฅผ ์กฐ์ ํ๋ RAM ์ฌ์ฉ์ ๊ตฌ์ฑ ์์๋ฅผ ๊ณ ๋ คํฉ๋๋ค. ์ด ๊ฐ์ ์ง์ ํ์ง ์์ผ๋ฉด ์ ๋ค๋ฆญ ๊ธฐ๋ณธ ํฌ๊ธฐ๋ก ๊ฐ์ฃผ๋ฉ๋๋ค.
์ผ๋ฐ ์ต์
-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
๋ถํฐ ์ฌ์ฉํ ์ ์์ต๋๋ค.