Man page - meson(1)

Packages contains this manual

Package:  meson
apt-get install meson

Manuals in package:
• meson(1)
Documentations in package:
• meson

Available languages:

en ja

Manual

MESON

名 前
説 明
セ ッ ト ア ッ プ コ マ ン ド
オ プ シ ョ ン :
configure コ マ ン ド
イ ン ト ロ ス ペ ク ト (introspect) コ マ ン ド
オ プ シ ョ ン :
テ ス ト コ マ ン ド
オ プ シ ョ ン :
ラ ッ プ (wrap) コ マ ン ド
コ マ ン ド
終 了 ス テ ー タ ス
関 連 項 目

---

名 前

meson - 生 産 性 の 高 い ビ ル ド シ ス テ ム

説 明

Meson は プ ロ グ ラ マ ー の 生 産 性 を 最 適 化 す る た め に 設 計 さ れ た ビ ル ド シ ス テ ム で す 。 こ れ を 実 現 す る た め に 、 最 新 の ソ フ ト ウ ェ ア 開 発 ツ ー ル や 技 法 を 、 簡 単 に す ぐ 利 用 で き る 機 能 を 提 供 し て い ま す 。 そ れ は た と え ば 、 ユ ニ ッ ト テ ス ト 、 網 羅 性 レ ポ ー ト 、 Valgrind、 Ccache な ど で す 。

メ イ ン の 実 行 コ マ ン ド meson に は 数 多 く の サ ブ コ マ ン ド が あ り 、 こ れ に よ っ て 全 機 能 の 利 用 が 可 能 に な り ま す 。

セ ッ ト ア ッ プ コ マ ン ド

Meson を 用 い る の は 実 に 簡 単 で す 。 ビ ル ド シ ス テ ム の ほ と ん ど に お い て 、 普 通 は 二 段 階 プ ロ セ ス を 実 現 し ま す 。 一 度 め は Meson を 実 行 し て ビ ル ド 設 定 を 行 い ま す 。

meson setup [ options ] [ build directory ] [ source directory ]

な お ビ ル ド デ ィ レ ク ト リ は 、 ソ ー ス デ ィ レ ク ト リ と は 別 の と こ ろ に し な け れ ば な り ま せ ん 。 Meson で は ソ ー ス デ ィ レ ク ト リ 内 で の ビ ル ド に は 対 応 し て い な い た め 、 こ れ を 行 う と エ ラ ー が 発 生 し ま す 。

設 定 ス テ ッ プ が 正 常 処 理 さ れ た ら 、 ビ ル ド デ ィ レ ク ト リ 内 に お い て 実 際 の ビ ル ド コ マ ン ド を 実 行 し て ソ ー ス を ビ ル ド で き ま す 。 Meson の デ フ ォ ル ト の バ ッ ク エ ン ド は Ninja で す 。 こ れ は 以 下 の よ う に し て 起 動 で き ま す 。

ninja [ target ]

Meson コ マ ン ド を 実 行 す る の は 、 ビ ル ド デ ィ レ ク ト リ に お い て 最 初 に 設 定 を 行 う 一 度 だ け で す 。 こ れ を 行 っ た ら 、 次 は ビ ル ド コ マ ン ド を 実 行 す る だ け で す 。 Meson は ソ ー ス ツ リ ー 内 の 変 更 を 自 動 的 に 検 出 し て 、 プ ロ ジ ェ ク ト ビ ル ド に 必 要 と な る フ ァ イ ル を す べ て 再 生 成 し ま す 。

セ ッ ト ア ッ プ コ マ ン ド を 実 行 す る の が デ フ ォ ル ト の 動 作 で す 。 特 に 何 か コ マ ン ド が 指 定 さ れ な い 限 り 、 Meson は セ ッ ト ア ッ プ を 行 う も の と し て 動 作 し ま す 。 セ ッ ト ア ッ プ コ マ ン ド を 用 い な く て も 、 ビ ル ド デ ィ レ ク ト リ は 以 下 の よ う に し て セ ッ ト ア ッ プ す る こ と が で き ま す 。

meson [ options ] [ build directory ] [ source directory ]

オ プ シ ョ ン :

--version

バ ー ジ ョ ン 番 号 を 表 示 し ま す 。

--help

コ マ ン ド ラ イ ン ヘ ル プ を 表 示 し ま す 。

configure コ マ ン ド

meson configure は 、 コ マ ン ド ラ イ ン か ら Meson プ ロ ジ ェ ク ト を 設 定 す る も の で す 。 そ の 利 用 の 仕 方 は 以 下 の よ う に 簡 単 で す 。

meson configure [ build directory ] [ options to set ]

ビ ル ド デ ィ レ ク ト リ が 省 略 さ れ た 場 合 は 、 カ レ ン ト デ ィ レ ク ト リ が 用 い ら れ ま す 。

パ ラ メ ー タ ー が 何 も 設 定 さ れ な か っ た 場 合 、 meson configure は す べ て の ビ ル ド オ プ シ ョ ン の 値 を コ ン ソ ー ル に 出 力 し ま す 。

値 を 設 定 す る に は 、 以 下 の よ う に コ マ ン ド ラ イ ン 引 数 -D を 利 用 し ま す 。

meson configure -Dopt1=value1 -Dopt2=value2

イ ン ト ロ ス ペ ク ト (introspect) コ マ ン ド

Meson の introspect は 、 他 の ツ ー ル 、 た と え ば IDE な ど と の 連 携 を 簡 単 に 実 現 す る よ う に 設 計 さ れ た コ マ ン ド で す 。 こ の コ マ ン ド の 出 力 は JSON 形 式 で す 。

meson introspect [ build directory ] [ option ]

ビ ル ド デ ィ レ ク ト リ が 省 略 さ れ た 場 合 は 、 カ レ ン ト デ ィ レ ク ト リ が 用 い ら れ ま す 。

オ プ シ ョ ン :

--targets

ト ッ プ レ ベ ル タ ー ゲ ッ ト (実 行 モ ジ ュ ー ル 、 ラ イ ブ ラ リ な ど ) を す べ て 表 示 し ま す 。

--target-files

指 定 さ れ た タ ー ゲ ッ ト に 対 す る ソ ー ス フ ァ イ ル を 表 示 し ま す 。

--buildsystem-files

ビ ル ド シ ス テ ム を 構 成 す る フ ァ イ ル (meson.build、 meson_options.txt な ど ) を す べ て 表 示 し ま す 。

--tests

ユ ニ ッ ト テ ス ト を す べ て 表 示 し ま す 。

--help

コ マ ン ド ラ イ ン ヘ ル プ を 表 示 し ま す 。

テ ス ト コ マ ン ド

meson test は Meson を 利 用 し て プ ロ ジ ェ ク ト の テ ス ト ス イ ー ト を 実 行 す る ヘ ル パ ー ツ ー ル で す 。 テ ス ト 実 行 を 行 う デ フ ォ ル ト の 方 法 は 、 以 下 の よ う に デ フ ォ ル ト の ビ ル ド コ マ ン ド を 実 行 す る こ と で す 。

ninja [ test ]

meson test で は 、 テ ス ト 実 行 に 対 し て 機 能 豊 富 な ツ ー ル セ ッ ト を 提 供 し て い ま す 。

meson test は バ ッ ク エ ン ド と し て Ninja を 利 用 す る 場 合 に は 、 テ ス ト 実 行 に 必 要 と な る タ ー ゲ ッ ト を 自 動 的 に 再 ビ ル ド し ま す 。 ビ ル ド に 失 敗 す る と meson test は 終 了 コ ー ド と し て 125 を 返 し ま す 。 こ の 返 り 値 コ ー ド は git bisect run に あ た っ て 、 カ レ ン ト な コ ミ ッ ト を ス キ ッ プ し ま す 。 し た が っ て git を 用 い た bisect 処 理 は 、 以 下 の よ う に わ か り や す く 実 現 で き ま す 。

git bisect run meson test -C build_dir

オ プ シ ョ ン :

--repeat

指 定 さ れ た 回 数 分 だ け テ ス ト を 実 行 し ま す 。

	--gdb		gdb の も と で テ ス ト を 実 行 し ま す 。
	--list		利 用 可 能 な テ ス ト を す べ て 一 覧 表 示 し ま す 。

--wrapper

指 定 さ れ た ラ ッ パ ー (た と え ば valgrind) 経 由 に よ り す べ て の テ ス ト を 起 動 し ま す 。

-C

テ ス ト 実 施 前 に 、 指 定 さ れ た デ ィ レ ク ト リ に 移 動 し ま す (こ れ は ビ ル ド デ ィ レ ク ト リ の 最 上 位 で な け れ ば な り ま せ ん )。

--suite

こ の ス イ ー ト に お い て テ ス ト を 実 行 し ま す 。

--no-suite

こ の ス イ ー ト の 中 で は テ ス ト を 実 行 し ま せ ん 。

--no-stdsplit

テ ス ト ロ グ に お い て stderr と stdout を 分 割 し ま せ ん 。

--benchmark

テ ス ト の 代 わ り に ベ ン チ マ ー ク を 実 行 し ま す 。

--logbase

テ ス ト ロ グ 出 力 に 利 用 す る フ ァ イ ル の ベ ー ス 名 を 指 定 し ま す 。

--num-processes

テ ス ト 実 行 に お け る 同 時 並 行 処 理 数 を 指 定 し ま す 。

--verbose

stdout と stderr に リ ダ イ レ ク ト し ま せ ん 。

-t

テ ス ト に お け る タ イ ム ア ウ ト 値 の 乗 数 を 指 定 し ま す (通 常 Valgrind に 対 し て は 100 な ど と し ま す )。

--setup

指 定 さ れ た テ ス ト の セ ッ ト ア ッ プ を 用 い ま す 。

ラ ッ プ (wrap) コ マ ン ド

ラ ッ プ ツ ー ル (wraptool) は 、 オ ン ラ イ ン の wrabdb サ ー ビ ス を 利 用 し て 、 ソ ー ス の 依 存 関 係 を 管 理 す る ヘ ル パ ー ユ ー テ ィ リ テ ィ ー で す 。

meson wrap < command > [ options ]

こ の コ マ ン ド は 、 プ ロ ジ ェ ク ト の 最 上 位 ソ ー ス デ ィ レ ク ト リ に お い て 実 行 す る こ と が 必 要 で す 。

コ マ ン ド

	list		利 用 可 能 な プ ロ ジ ェ ク ト の 一 覧 を 表 示 し ま す 。
	search		プ ロ ジ ェ ク ト 名 で 検 索 し ま す 。

install

プ ロ ジ ェ ク ト を 指 定 さ れ た 名 前 を 用 い て イ ン ス ト ー ル し ま す 。

	update		指 定 さ れ た プ ロ ジ ェ ク ト を 、 利 用 可 能 な 最 新 バ ー ジ ョ ン に ア ッ プ デ ー ト し ま す 。
	info		指 定 さ れ た プ ロ ジ ェ ク ト の 利 用 可 能 バ ー ジ ョ ン を 表 示 し ま す 。
	status		現 在 利 用 さ れ て い る サ ブ プ ロ ジ ェ ク ト に 対 し て 、 イ ン ス ト ー ル さ れ て い る 、 ま た は 利 用 可 能 な バ ー ジ ョ ン を 表 示 し ま す 。

終 了 ス テ ー タ ス

	0		正 常 終 了 。
	1		利 用 エ ラ ー 。 つ ま り meson.build の 解 析 ま た は 実 行 エ ラ ー 。
	2		内 部 エ ラ ー 。
	125		meson test に お い て 必 要 な タ ー ゲ ッ ト が 再 ビ ル ド で き な か っ た こ と を 表 し ま す 。

関 連 項 目

http://mesonbuild.com/

https://wrapdb.mesonbuild.com/

---