Using bsd.port.mk
.include <bsd.port.mk> or a variant is included in all ports makefiles. Under no circumstances should you write anything below the definition. Instead, use bsd.port.pre.mk before your changes and bsd.port.post.mk at the end. Choose either bsd.port.mk or the pre/post combination, but do not mix the two approaches.
Here is a list of important variables that can aid in developing ports. These are included in bsd.port.pre.mk.
| Variable | Description |
|---|---|
| ARCH | The architecture as returned by uname -m (e.g., i386) |
| OPSYS | The operating system type, as returned by uname -s (e.g., MidnightBSD) |
| OSREL | The release version of the operating system (e.g., 0.1 or 0.2) |
| OSVERSION | The numeric version of the operating system; the same as __FreeBSD_version. In the future, __MidnightBSD_version will be used. Do not rely on this value. |
| PORTOBJFORMAT | The object format of the system (elf or aout; note that aout is deprecated.) |
| LOCALBASE | The base of the ``local'' tree (e.g., /usr/local/) |
| X11BASE | The base of the ``X11'' tree (e.g., /usr/X11R6) |
| PREFIX | Where the port installs itself . |
Note: If you have to define the variables USE_IMAKE, USE_X_PREFIX, or MASTERDIR, do so before including bsd.port.pre.mk.
Here are some examples of things you can do with bsd.port.pre.mk:
# no need to compile lang/perl5 if perl5 is already in system
.if ${OSVERSION} > 300003
BROKEN= perl is in system
.endif
# only one shlib version number for ELF
.if ${PORTOBJFORMAT} == "elf"
TCL_LIB_FILE= ${TCL_LIB}.${SHLIB_MAJOR}
.else
TCL_LIB_FILE= ${TCL_LIB}.${SHLIB_MAJOR}.${SHLIB_MINOR}
.endif
# software already makes link for ELF, but not for a.out
post-install:
.if ${PORTOBJFORMAT} == "aout"
${LN} -sf liblinpack.so.1.0 ${PREFIX}/lib/liblinpack.so
.endif
# Detect MidightBSD version
.if ${OSREL} == "0.1"
BROKEN= man page does not install on 0.1-RELEASE
.endif
Use tab instead of spaces after BROKEN= and TCL_LIB_FILE=.
Portions of this document are derived from the FreeBSD Porters Handbook. http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/porting-versions.html