2nd pkgsrc one conference Aug. 9, 2014

1. pkgsrc Internals
tools, wapper and buildlink
OBATA Akio (obache@NetBSD.org)
Aug. 9, 2014
2nd pkgsrc one conference

2. 起こりうる問題
様々な環境で make install
必要なツールを事前に用意
必要ないものを拾わない
微妙なツールのふるまい
などなど
01 29

3. pkgsrc framework
tools
wrapper
buildlink
02 29

4. tools
構築や実行時に必要なツールの扱い
存在場所・名前
依存関係
振る舞い
USE_TOOLS+= perl:run gawk
03 29

5. what tools is supported?
Not documented anywhere! 文書化すべき
04 29

6. tool dependency
pkgsrc
bootstrap
build (default)
run
05 29

7. tool:pkgsrc
pkgsrc フレームワーク利用
普通は関係ない
bootstrap で準備されいてるはず
06 29

8. tool:bootstrap
build 始める前に必要
普通は関係ない
distfile を fetch
hash の計算
07 29

9. tool:build
build に必要
TOOL_DEPENDS
cross build に影響
08 29

10. tool:run
実行時に必要
full依存と解釈される
cross 時に???
09 29

11. how to work?
${TOOLS_DIR}/bin
${WRKDIR}/.tools/bin
PATH の先頭に追加
symbolic link
wrapper
alias
10 29

12. How defined (F/W)?
TOOLS_XXXX.<tool>=???
ALIASES ARGS CMD
DEPENDS IGNORE
PATH PLATFORM
PREFIX SCRIPT
SCRIPT_DFLT
VALUE_GNU
see pkgsrc/mk/tools/
11 29

13. TOOLS_PLATFORM.<tool>
環境ごとのツールの場所
pkgsrc/mk/tools.${OPSYS}.mk
sh builtin は名前だけ
引数付もある
ないものは pkgsrc から
12 29

14. TOOLS_CMD.<tool>
${TOOLS_DIR} の下へのパス
標準: ${TOOLS_DIR}/bin/<tool>
13 29

15. TOOLS_ALIASES.<tool>
tool の別名一覧
gawk: awk => gawk
autoconf213: autoconf => autoconf-2.13
TOOLS_CMD へのsymlink
14 29

16. TOOLS_PATH.<tool>
本物のtoolへの参照
full path だったりなかったり
TOOLS_PLATFORM.<tool>の一番前
値によってTOOLS_CMD変わる
フルパス→symlink
名前→wrapper
↑それは標準ルール
15 29

17. TOOLS_ARGS.<tool>
tool を呼び出すときの引数
mkdir -p とか
TOOLS_PLATFORM.<tool>の後ろ部分
指定あると wrapper
TOOLS_PATH.<tool> TOOLS_ARGS.<tool> $@
= TOOLS_SCRIPT_DFLT.<tool>
16 29

18. TOOLS_SCRIPT.<tool>
任意の wrapper 作成
one liner または scirpt file名
振る舞いの差異を吸収
入出力のフィルタ
環境変数の隠ぺい・偽装
17 29

19. TOOLS_VALUE_GNU.<tool>
GNU configure 向けの変数用
_TOOLS_VARNAME_GNU.<tool> に変数名
一覧
cofigure 時に変数に値として設定
普通は TOOLS_CMDLINE.<tool>
= TOOLS_PATH.<tool> TOOLS_ARGS.<tool>
フルパスだったりいろいろ
18 29

20. TOOLS_DEPENDS.<tool>
pkgsrcから入れる場合の依存関係
普通の DEPENDS の書式
<TOOL>_REQD
19 29

21. TOOLS_IGNORE.<tool>
USE_TOOLS にあっても無視
宣言するだけでよい
循環依存を防止
20 29

22. TOOLS_PREFIX.<tool>
pkgsrcから入れた場合のPREFIX
計算して求められるmk/find-prefix.mk
TOOLS_PATH.<tool> に使う
21 29

23. special shortcut
普通は TOOLS_CREATE+=fooだが
TOOLS_NOOP
TOOLS_BROKEN
TOOLS_GNU_MISSING
TOOLS_FAIL
22 29

24. TOOLS_NOOP
何もしないで成功する
不要なtoolを無視
でもbuildは続けたい
23 29

25. TOOLS_BROKEN
何もしないで失敗する
不要なtoolを無視
build は止めたい
24 29

26. TOOLS_GNU_MISSING
GNU auto* tool の missing
GNU missing への symlink
GNU auto* tool 用
patch 当てたとき
25 29

27. TOOLS_FAIL
失敗してwarning
Please add USE_TOOLS+=<tool> to...
開発者向け
26 29

28. tool variable
_TOOLS_VARNAME.<tool>
単純な変数でtoolのpath参照
ex. awk = AWK
TOOLS_${v} = TOOLS_PATH.<tool>
TOOLS_CMDLINE_${v} =
TOOLS_CMDLINE.<tool>
tool 作成前に利用可能
バイナリパッケージに埋め込み
27 29

29. prefer pkgsrc/native?
_TOOLS_USE_PKGSRC.<tool>
yes
no
undocumented
28 29

30. 続く?
案外面倒だった
pkgsrc framework の tool の説明
wrapper, buildlink は次回以降
29 29