以下に掲げるのは、 pkgsrc/graphics/tiff における buildlink3.mk の実例です。

# $NetBSD: buildlink3.mk,v 1.16 2009/03/20 19:24:45 joerg Exp $

BUILDLINK_TREE+=	tiff

.if !defined(TIFF_BUILDLINK3_MK)
TIFF_BUILDLINK3_MK:=

BUILDLINK_API_DEPENDS.tiff+=	tiff>=3.6.1
BUILDLINK_ABI_DEPENDS.tiff+=	tiff>=3.7.2nb1
BUILDLINK_PKGSRCDIR.tiff?=	../../graphics/tiff

.include "../../devel/zlib/buildlink3.mk"
.include "../../graphics/jpeg/buildlink3.mk"
.endif # TIFF_BUILDLINK3_MK

BUILDLINK_TREE+=	-tiff

ヘッダーとフッターで、 BUILDLINK_TREE の値を操作しています。 この変数は、パッケージの依存関係を辿るために、 すべての buildlink3.mk ファイルの間で、 共通に使われます。

本体の節では、多重のインクルードを防いだうえで、 pkg への依存性をどのように追加するかを制御しています。 いくつもの重要な変数がこの節で設定されます。

以下の各変数はすべて、二つ目の (多重のインクルードを防いでいる) 節において、 任意に定義されるものであり、どのパッケージのファイルを ${BUILDLINK_DIR} からシンボリックリンクするか、および、 シンボリックリンクによってファイル名をどのように変換するか、 を制御します。

この節では、 pkg のライブラリー依存性として必要な buildlink3.mk をすべてインクルードすることができます。 ここで buildlink3.mk ファイルをインクルードすると、 pkg の buildlink3.mk ファイルがインクルードされる場合はいつも、 これらへの依存性のためのヘッダーやライブラリーも、 ${BUILDLINK_DIR} からシンボリックリンクされることになります。 依存性が追加されるのは、 buildlink3.mk ファイルを直接インクルードした場合だけです。

パッケージを更新した際に BUILDLINK_API_DEPENDS.pkg に列挙されている依存性のバージョンを上げる必要があるのは、 その更新で API やヘッダーファイルへのインターフェースが変わった場合です。

このような場合は、 BUILDLINK_API_DEPENDS.pkg を調節して、最低限、新しいパッケージのバージョンを要するようにします。 場合によっては、新しいバージョンに依存するパッケージの PKGREVISION を上げる必要があることがあります。 また、依存しているパッケージに buildlink3.mk ファイルがある場合は、 BUILDLINK_API_DEPENDS.pkg も調節します。これは、pkgsrc が適切なパッケージの依存性を求めるようにして、 ソースからの構築時に古いパッケージに依存したりしないようにするために、 必要なことです。

BUILDLINK_ABI_DEPENDS.pkg を上げるのは、バイナリーインターフェースや、 インストールされている共有ライブラリーのいずれかの soname (ライブラリーのバージョンのメジャー番号) が変わった場合です。 これは、これらを使うバイナリーパッケージが、 適切なパッケージの依存性を求めるようにして、 必要な共有ライブラリーをもたない古いパッケージに依存したりしないようにするために、 必要なことです。

BUILDLINK_ABI_DEPENDS および ABI_DEPENDS の定義を含めた、 他のパッケージへの依存性について、さらなる情報は、 Section 19.1.6, “依存性の処理”をご覧ください。

なお、必要もないのにパッケージを削除したり再構築したりするようなことのないよう、 BUILDLINK_API_DEPENDS.pkg や BUILDLINK_ABI_DEPENDS.pkg の調節は、事前に熟考するようにしてください。 多くの場合、新しいバージョンのパッケージは、 従前の依存性のままでも問題なく動作します。

また、 BUILDLINK_ABI_DEPENDS.pkg は、 BUILDLINK_API_DEPENDS.pkg と同じ値となる場合には設定する必要はありません。

以下に掲げるのは、builtin.mk ファイルの推奨テンプレートです。

.if !defined(IS_BUILTIN.foo)
#
# IS_BUILTIN.foo is set to "yes" or "no" depending on whether "foo"
# genuinely exists in the system or not.
#
IS_BUILTIN.foo?=        no

# BUILTIN_PKG.foo should be set here if "foo" is built-in and its package
# version can be determined.
#
.  if !empty(IS_BUILTIN.foo:M[yY][eE][sS])
BUILTIN_PKG.foo?=       foo-1.0
.  endif
.endif  # IS_BUILTIN.foo

.if !defined(USE_BUILTIN.foo)
USE_BUILTIN.foo?=       ${IS_BUILTIN.foo}
.  if defined(BUILTIN_PKG.foo)
.    for _depend_ in ${BUILDLINK_API_DEPENDS.foo}
.      if !empty(USE_BUILTIN.foo:M[yY][eE][sS])
USE_BUILTIN.foo!=                                                       \
        ${PKG_ADMIN} pmatch '${_depend_}' ${BUILTIN_PKG.foo}            \
        && ${ECHO} "yes" || ${ECHO} "no"
.      endif
.    endfor
.  endif
.endif  # USE_BUILTIN.foo

CHECK_BUILTIN.foo?=     no
.if !empty(CHECK_BUILTIN.foo:M[nN][oO])
#
# Here we place code that depends on whether USE_BUILTIN.foo is set to
# "yes" or "no".
#
.endif  # CHECK_BUILTIN.foo

最初の節では、pkg がベースシステムに実際に存在するかどうかに応じて、 IS_BUILTIN.pkg を設定しています。これは、ベースシステムに pkg 相当の機能のソフトウェアが存在するかどうかではありません。 この変数を “yes” にするのは、 このパッケージそのものがベースシステムの一部として附属する場合だけです。 この変数は、builtin.mk ファイルの内部でのみ使われます。

二つ目の節では、pkg がベースシステムに存在する場合 (つまり IS_BUILTIN.pkg が “yes” の場合)、 BUILTIN_PKG.pkg をそのバージョンに設定しています。この変数は、builtin.mk ファイルの内部でのみ使われます。

三つ目の節では、 USE_BUILTIN.pkg を設定しており、これはすべての builtin.mk ファイルで必須です。 この節のコードは、ベースシステム附属のソフトウェアが、 BUILDLINK_API_DEPENDS.pkg で列挙されている依存性を満たすのに十分かどうかを判別する必要があります。 この判別は、たいていは、 BUILTIN_PKG.pkg を、 BUILDLINK_API_DEPENDS.pkg の各依存性と比較することでおこなわれます。 USE_BUILTIN.pkg は、builtin.mk ファイルの終わりまでに、 適切な値に設定する必要があります。なお、たとえ IS_BUILTIN.pkg が “no” であっても、 USE_BUILTIN.pkg は “yes” にすることができます。なぜなら、 ベースシステム附属のソフトウェアが依存パッケージに十分似ており、 代替可能であるという判断もできるからです。

最後の節は CHECK_BUILTIN.pkg に守られており、前の節で設定された USE_BUILTIN.pkg の値を使うコードをインクルードします。たいていの場合、ここでインクルードするのは、 たとえば依存性への制約の追加や、${BUILDLINK_DIR} からシンボリックリンクされるファイルのリストの (BUILDLINK_FILES.pkg を使った) 追加などです。

パッケージの構築時に、 依存性を満たすソフトウェアとして組み込み (ネイティブ) のものを使うか pkgsrc のものを使うかを、 大域的な設定に応じて切替えることができます。 この制御は、PREFER_PKGSRC および PREFER_NATIVE を設定することでおこないます。 この両変数は、“yes”, “no” またはパッケージのリストを値として持ちます。 PREFER_PKGSRC は pkgsrc 版のソフトウェアを使うことを、 PREFER_NATIVE で組み込み版を使うことを、 それぞれ指示します。この設定は、 対象パッケージではどちらを使うのがもっとも適当かに応じて、 PREFER_PKGSRC か PREFER_NATIVE のいずれかで指定します。 あるパッケージがどちらにも設定されていない場合、 または両方で設定されている場合は、 PREFER_PKGSRC が PREFER_NATIVE より優先します。たとえば、 NetBSD システムの最も基本的な要素を除き、 すべて pkgsrc 版のソフトウェアを使うこととする場合、 以下のように設定することができます。

PREFER_PKGSRC=  yes
PREFER_NATIVE=  getopt skey tcp_wrappers

あるパッケージを PREFER_NATIVE のリストに加えるには、そのパッケージに builtin.mk ファイルがある必要があります。 このファイルがない場合は、リストに加えても単に無視されます。