Plan 9 mk

• 1.0.0 mk 入門
• 1.1.0 ルール
• 1.2.0 変数
• 1.3.0 ファイルの取り込み
• 1.4.0 環境変数の参照
• 1.5.0 コメント
• 2.0.0 ルールや変数を二重に定義した場合の動作
• 3.0.0 未定義の変数を使用した場合の動作
• 4.0.0 複数のファイルから1つの実行ファイルを生成する場合
• 4.1.0 メタルール
• 4.2.0 名前リスト(namelist)
• 4.3.0 $prereq と $target
• 4.4.0 mkone mkmany mklib mksyslib
• 4.5.0 mkone を使用した mkfile の例
• 5.0.0 複数の実行ファイルを生成する場合
• 5.1.0 mkmany を使用した mkfile の例
• 6.0.0 mkfile のプロトタイプ
• 7.0.0 属性
• 7.1.0 V
• 7.2.0 N
• 7.3.0 Q
• 7.4.0 D
• 7.5.0 R
• 8.0.0 コマンド出力を変数に割り付ける
• 9.0.0 応用
• 9.1.0 mkh
• 10.0.0 Unix に移植された mk
• 11.0.0 終わりに
• 12.0.0 参考資料
• 13.0.0 参考文献

2003/11/05
Unix の make に対する Plan 9 のツールは mk である。Unix の make と異なり、Plan 9 の mk は Plan 9 のシェル rc との調和がはかられたツールである。mk はシンプルにして make よりも遙かに強力なツールである。

mk 入門

ルール

	8c a.c
	8l a.8

8.out: a.8
	8l a.8
a.8: a.c
	8c a.c

譜1

ターゲット: 依存ファイルの一覧
	処理

ターゲット:属性: 依存ファイルの一覧
	処理

の形式を持ったファイル生成規則の集まりである。(以下、「ルール」と言う)
前者の形式は makefile と同様であるが、後者の形式は makefile には存在しない。譜1に現れたのは前者の形式である。「ターゲット」は生成するファイルの名称であり、「依存ファイルの一覧」は、生成に必要なファイルの一覧である。この一覧は空白で区切って与える。「処理」は Plan 9 の標準シェル rc にそのまま渡される。処理の内容に関しては mk は関知しないので、コメントであっても、単に ; であっても、空白以外に何も書かれていなくても、構わない。「属性」に関しては後に解説する。
Unix の makefile が処理部を TAB で始まらなければならないのに対して Plan 9 の mkfile では単にインデントされていれば構わない。(当然の改善点です。Unix の makefile がどうかしている。)

書き方の注意

• ターゲットは複数書いてよい。その場合、空白で区切る。
  
• 依存ファイルの一覧の左の : の後には1つ以上の空白が必要である。
  

変数

LD=8l
CC=8c
O=8
$O.out: a.$O
	$LD a.$O
a.$O: a.c
	$CC a.c

譜2

ファイルの取り込み

</sys/src/mkfile.proto

CC=8c
LD=8l
O=8
AS=8a

/386/mkfile の内容

</$objtype/mkfile
$O.out: a.$O
	$LD a.$O
a.$O: a.c
	$CC a.c

譜3

環境変数の参照

コメント

ルールや変数を二重に定義した場合の動作

LD=8l
CC=8c
O=8
CFLAGS=
$O.out: a.$O
	$LD a.$O
a.$O: a.c
	$CC a.c
a.$O: a.c a.h
	$CC $CFLAGS a.c
CFLAGS=-w

譜4

LD=8l
CC=8c
O=8
CFLAGS=-w
$O.out: a.$O
	$LD a.$O
a.$O: a.c a.h
	$CC $CFLAGS a.c

譜5

未定義の変数を使用した場合の動作

LD=8l
CC=8c
O=8
$O.out: a.$O
	$LD a.$O
a.$O: a.c a.h $LIB
	$CC $CFLAGS a.c

譜6

複数のファイルから1つの実行ファイルを生成する場合

	8c a1.c
	8c a2.c
	8c a3.c
	8l a1.8 a2.8 a3.8

	8c a1.c a2.c a3.c

</$objtype/mkfile
OFILES=a1.$O a2.$O a3.$O
HFILES=a.h

$O.out: $OFILES
	$LD $prereq

%.$O: %.c $HFILES
	$CC $stem.c

譜7

メタルール

	%.$O: %.c
		$CC $stem.c

	a1.$O: a1.c
		$CC a1.c
	a2.$O: a2.c
		$CC a2.c
	a3.$O: a3.c
		$CC a3.c

	%.$O: %.c
		$CC %.c

• 例1: %.8 は a.8 や foo.8 にマッチする。この時の stem は各々 a と foo である。
  
• 例2: a%.8 は alice.8 にマッチし、その stem は lice であるが、a.8 や foo.8 にはマッチしない。
  

メタルールにおけるパターン表現は % の他に & と正規表現が存在する。& は % と同様の使い方をするが、% と異なり、/ と . にはマッチしない。正規表現については後に「属性」のところで解説する。

名前リスト(namelist)

</$objtype/mkfile
SRC=a1.c a2.c a3.c
OFILES=${SRC:%.c=%.$O}
HFILES=a.h

$O.out: $OFILES
	$LD $prereq

%.$O: %.c $HFILES
	$CC $stem.c

譜8

	OFILES=${SRC:%.c=%.$O}

	${変数: A%B=C%D}

$prereq と $target

	$O.out: $OFILES
		$LD $prereq

	$O.out: $OFILES $LIB
		$LD $prereq

	$O.out: $OFILES $LIB
		$LD -o $target $prereq

	$O.out: $OFILES $LIB
		$LD -o $O.out $prereq

mkone mkmany mklib mksyslib

• /sys/src/cmd/mkone
  
• /sys/src/cmd/mkmany
  
• /sys/src/cmd/mklib
  
• /sys/src/cmd/mksyslib
  

• TARG
  
• OFILES
  
• HFILES
  
• LIB
  
• BIN
  

mkone を使用した mkfile の例

</$objtype/mkfile
TARG=a
SRC=a1.c a2.c a3.c
HFILES=a.h
LIB=
BIN=$home/bin/$objtype
OFILES=${SRC:%.c=%.$O}
</sys/src/cmd/mkone
CFLAGS=-w

譜9

• mk
  
• mk install
  
• mk clean
  

複数の実行ファイルを生成する場合

</$objtype/mkfile
TARG=a b
HFILES=ab.h
SRC1=a1.c a2.c a3.c
SRC2=b1.c b2.c
PROGS=${TARG:%=$O.%}
OFILES1=${SRC1:%.c=%.$O}
OFILES2=${SRC2:%.c=%.$O}

all:V: $PROGS

$O.a: $OFILES1
	$LD -o $target $prereq
$O.b: $OFILES2
	$LD -o $target $prereq
%.$O: %.c $HFILES
  	$CC $CFLAGS $stem.c
CFLAGS=-w

譜10

	PROGS=$O.a $O.b
	OFILES1=a1.$O a2.$O a3.$O
	OFILES2=b1.$O b2.$O

生成する実行ファイルの名前がファイル名で与えられていれば(普通はそうであろう)、そしてa2.c a3.c b2.c に重複した関数名が存在しなければ、もっと簡潔な別の書き方が存在する。a1.c b1.c が関数 main を含むとせよ。そして $O.a1 $O.b1 を生成目標とせよ。

TARG=a1 b1
HFILES=ab.h
SRC=a2.c a3.c b2.c
PROGS=${TARG:%=$O.%}
OFILES=${SRC:%.c=%.$O}

all:V: $PROGS

$O.%: %.$O $OFILES
	$LD -o $target $prereq
%.$O: %.c $HFILES
  	$CC $CFLAGS $stem.c
CFLAGS=-w

譜11

mkmany を使用した mkfile の例

</$objtype/mkfile
TARG=a1 b1
HFILES=ab.h
SRC=a2.c a3.c b2.c
OFILES=${SRC:%.c=%.$O}

</sys/src/cmd/mkmany
CFLAGS=-w

譜12

mkfile のプロトタイプ

# mkfile template
</$objtype/mkfile

TARG=a
SRC=a.c b.c
OFILES=${SRC:%.c=%.$O}
HFILES=
LIB=
#BIN=/$objtype/bin
BIN=$home/bin/$objtype

# Select one of four:
</sys/src/cmd/mkone
#</sys/src/cmd/mkmany
#</sys/src/cmd/mklib
#</sys/src/cmd/mksyslib

CFLAGS=

譜13

属性

ターゲット:属性: 依存ファイルの一覧
	処理

V

N

Q

D

R

	%.$O:%.c

	(.+)\.$O:R: \1.c

コマンド出力を変数に割り付ける

変数=`{コマンド}

	V=${U:A%B=C%D}

	V=`{echo $U | sed 's/A(.*)B/C\1D/'}

応用

mkh

#!/usr/local/plan9/bin/mk -f /Users/arisawa/bin/mkh

T=`{ls *.tt}
S=${T:%.tt=%.html}
P=t2h

all:VQ: $S
%.html:D: %.tt
	$P $stem.tt >$target
clean:V:
	rm $S

譜14. /Users/arisawa/bin/mkh

Unix に移植された mk

From: "Russ Cox" <rsc@swtch.com>
Date: 2003.10.14  03:31:08 Japan
To: 9fans@cse.psu.edu
Subject: [9fans] plan 9 ports to unix (including libdraw)
Reply-To: 9fans@cse.psu.edu

I've been using Unix (FreeBSD) for day-to-day work for a few
weeks now, and have started to bring over some Plan 9 tools to make
life a bit more hospitable.

Mk was already done, and Scott Schwartz did sam over the summer.

...

http://pdos.lcs.mit.edu/~rsc/software/plan9/

Russ

Mac OSX で筆者がコンパイルしたものはここ

終わりに

参考資料

• mkone
• mkmany
• mk.pdf

参考文献

• Andrew G. Hume: "Maintaining Files on Plan 9 with mk", (Plan 9 - The documents - Volume Two, Second Edition)