opnsense-plugins/Mk/plugins.mk
2025-12-01 11:15:29 +01:00

372 lines
12 KiB
Makefile

# Copyright (c) 2015-2025 Franco Fichtner <franco@opnsense.org>
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# 1. Redistributions of source code must retain the above copyright
# notice, this list of conditions and the following disclaimer.
#
# 2. Redistributions in binary form must reproduce the above copyright
# notice, this list of conditions and the following disclaimer in the
# documentation and/or other materials provided with the distribution.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
# ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
# FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
# DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
# OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
# HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
# LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
# OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
# SUCH DAMAGE.
PLUGINSDIR?= ${.CURDIR}/../..
all: check
@cat ${.CURDIR}/${PLUGIN_DESC} | ${PAGER}
.include "defaults.mk"
.if exists(${GIT}) && exists(${GITVERSION})
PLUGIN_COMMIT!= ${GITVERSION}
.else
PLUGIN_COMMIT= unknown 0 undefined
.endif
PLUGIN_HASH?= ${PLUGIN_COMMIT:[3]}
PLUGIN_DESC= pkg-descr
PLUGIN_SCRIPTS= +PRE_INSTALL +POST_INSTALL \
+PRE_DEINSTALL +POST_DEINSTALL
PLUGIN_WWW?= https://opnsense.org/
PLUGIN_MAINTAINER?= N/A
PLUGIN_LICENSE?= BSD2CLAUSE
PLUGIN_TIER?= 3
PLUGIN_REVISION?= 0
PLUGIN_REQUIRES= PLUGIN_NAME PLUGIN_VERSION PLUGIN_COMMENT
.include "common.mk"
.include "git.mk"
.include "lint.mk"
.include "style.mk"
.include "sweep.mk"
check:
.for PLUGIN_REQUIRE in ${PLUGIN_REQUIRES}
. if "${${PLUGIN_REQUIRE}}" == ""
. error "${PLUGIN_REQUIRE} not set"
. endif
.endfor
_PLUGIN_COMMENT:= ${PLUGIN_COMMENT}
.if defined(_PLUGIN_DEVEL)
PLUGIN_DEVEL?:= ${_PLUGIN_DEVEL}
.else
.-include "devel.mk"
.endif
PLUGIN_PREFIX?= os-
PLUGIN_SUFFIX?= -devel
.for CONFLICT in ${PLUGIN_CONFLICTS}
PLUGIN_CONFLICTS+= ${CONFLICT}${PLUGIN_SUFFIX}
.endfor
.if !empty(PLUGIN_VARIANTS)
PLUGIN_VARIANT?= ${PLUGIN_VARIANTS:[1]}
.if "${PLUGIN_VARIANT}" == ""
.error Plugin variant cannot be empty
.else
PLUGIN_NAME:= ${${PLUGIN_VARIANT}_NAME}
.if empty(PLUGIN_NAME)
.error Plugin variant '${PLUGIN_VARIANT}' does not exist
.endif
.for _PLUGIN_VARIANT in ${PLUGIN_VARIANTS:N${PLUGIN_VARIANT}}
PLUGIN_CONFLICTS+= ${${_PLUGIN_VARIANT}_NAME}${PLUGIN_SUFFIX} \
${${_PLUGIN_VARIANT}_NAME}
.endfor
PLUGIN_DEPENDS+= ${${PLUGIN_VARIANT}_DEPENDS}
.if !empty(${PLUGIN_VARIANT}_COMMENT)
_PLUGIN_COMMENT:= ${${PLUGIN_VARIANT}_COMMENT}
.endif
.endif
.endif
.if !empty(PLUGIN_NAME)
PLUGIN_DIR?= ${.CURDIR:S/\// /g:[-2]}/${.CURDIR:S/\// /g:[-1]}
.endif
.if "${PLUGIN_DEVEL}" != ""
PLUGIN_CONFLICTS+= ${PLUGIN_NAME}
PLUGIN_PKGSUFFIX= ${PLUGIN_SUFFIX}
PLUGIN_TIER= 4
.else
PLUGIN_CONFLICTS+= ${PLUGIN_NAME}${PLUGIN_SUFFIX}
PLUGIN_PKGSUFFIX= # empty
.endif
PLUGIN_CONFLICTS:= ${PLUGIN_CONFLICTS:S/^/${PLUGIN_PREFIX}/g:O}
PLUGIN_PKGNAME= ${PLUGIN_PREFIX}${PLUGIN_NAME}${PLUGIN_PKGSUFFIX}
PLUGIN_PKGNAMES= ${PLUGIN_CONFLICTS} ${PLUGIN_PKGNAME}
.if "${PLUGIN_REVISION}" != "" && "${PLUGIN_REVISION}" != "0"
PLUGIN_PKGVERSION= ${PLUGIN_VERSION}_${PLUGIN_REVISION}
.else
PLUGIN_PKGVERSION= ${PLUGIN_VERSION}
.endif
manifest: check
@echo "name: ${PLUGIN_PKGNAME}"
@echo "version: \"${PLUGIN_PKGVERSION}\""
@echo "origin: opnsense/${PLUGIN_PKGNAME}"
@echo "comment: \"${_PLUGIN_COMMENT}\""
@echo "maintainer: \"${PLUGIN_MAINTAINER}\""
@echo "categories: [ \"${.CURDIR:S/\// /g:[-2]}\" ]"
@echo "www: \"${PLUGIN_WWW}\""
@echo "prefix: \"${LOCALBASE}\""
@echo "licenselogic: \"single\""
@echo "licenses: [ \"${PLUGIN_LICENSE}\" ]"
.if defined(PLUGIN_NO_ABI)
@echo "arch: \"${OSABIPREFIX:tl}:*:*\""
@echo "abi: \"${OSABIPREFIX}:*:*\""
.endif
.if defined(PLUGIN_DEPENDS)
@echo "deps: {"
@for PLUGIN_DEPEND in ${PLUGIN_DEPENDS}; do \
if ! ${PKG} query ' %n: { version: "%v", origin: "%o" }' \
$${PLUGIN_DEPEND}; then \
echo ">>> Missing dependency: $${PLUGIN_DEPEND}" >&2; \
exit 1; \
fi; \
done
@echo "}"
.endif
@if [ -f ${WRKSRC}${LOCALBASE}/opnsense/version/${PLUGIN_NAME} ]; then \
echo "annotations $$(cat ${WRKSRC}${LOCALBASE}/opnsense/version/${PLUGIN_NAME})"; \
fi
# Package scripts generation handling 101:
#
# "auto" generates automatic hooks that a plugin may need in order to
# reload on the fly. ".pre" and ".post" suffixed files can be used to
# extend the auto-generated content.
#
# "manual" overwrites the automatic script and also ignores ".pre" and
# ".post" files since they do not make sense in manual mode.
#
# Furthermore, variable replacement via %%PLUGIN_VAR%% takes place in
# "manual" as well as ".pre" and ".post" scripts provided.
scripts: check scripts-pre scripts-auto scripts-post scripts-manual
scripts-pre:
@for SCRIPT in ${PLUGIN_SCRIPTS}; do \
rm -f ${DESTDIR}/$${SCRIPT}; \
if [ -f ${.CURDIR}/$${SCRIPT}.pre ]; then \
sed ${SED_REPLACE} -- ${.CURDIR}/$${SCRIPT}.pre > \
${DESTDIR}/$${SCRIPT}; \
fi; \
done
scripts-auto:
@if [ -d ${.CURDIR}/src/etc/rc.syshook.d ]; then \
for SYSHOOK in early start; do \
for FILE in $$(cd ${.CURDIR}/src/etc/rc.syshook.d && \
find -s . -type f -name "*.$${SYSHOOK}"); do \
echo ${LOCALBASE}/etc/rc.syshook.d/$${FILE#./} >> \
${DESTDIR}/+POST_INSTALL; \
done; \
done; \
fi
@if [ -d ${.CURDIR}/src/opnsense/service/conf/actions.d ]; then \
cat ${TEMPLATESDIR}/actions.d >> ${DESTDIR}/+POST_INSTALL; \
fi
@if [ -d ${.CURDIR}/src/etc/rc.loader.d ]; then \
for SCRIPT in +POST_INSTALL +POST_DEINSTALL; do \
cat ${TEMPLATESDIR}/rc.loader.d >> \
${DESTDIR}/$${SCRIPT}; \
done; \
fi
@if [ -d ${.CURDIR}/src/opnsense/mvc/app/models ]; then \
for FILE in $$(cd ${.CURDIR}/src/opnsense/mvc/app/models && \
find -s . -depth 2 -type d); do \
cat ${TEMPLATESDIR}/models | \
sed "s:%%ARG%%:$${FILE#./}:g" >> \
${DESTDIR}/+POST_INSTALL; \
done; \
for SCRIPT in +POST_INSTALL +POST_DEINSTALL; do \
cat ${TEMPLATESDIR}/configure | \
sed "s:%%ARG%%:$${SCRIPT#+}:g" >> \
${DESTDIR}/$${SCRIPT}; \
done; \
fi
@if [ -d ${.CURDIR}/src/opnsense/service/templates ]; then \
for FILE in $$(cd ${.CURDIR}/src/opnsense/service/templates && \
find -s . -depth 2 -type d); do \
cat ${TEMPLATESDIR}/templates | \
sed "s:%%ARG%%:$${FILE#./}:g" >> \
${DESTDIR}/+POST_INSTALL; \
done; \
fi
@if [ -d ${.CURDIR}/src/opnsense/scripts/firmware/repos ]; then \
for FILE in $$(cd ${.CURDIR}/src && find -s \
opnsense/scripts/firmware/repos -type f); do \
echo "${LOCALBASE}/$${FILE#.}" >> ${DESTDIR}/+POST_INSTALL; \
done \
fi
scripts-post:
@for SCRIPT in ${PLUGIN_SCRIPTS}; do \
if [ -f ${.CURDIR}/$${SCRIPT}.post ]; then \
sed ${SED_REPLACE} -- ${.CURDIR}/$${SCRIPT}.post >> \
${DESTDIR}/$${SCRIPT}; \
fi; \
done
scripts-manual:
@for SCRIPT in ${PLUGIN_SCRIPTS}; do \
if [ -f ${.CURDIR}/$${SCRIPT} ]; then \
sed ${SED_REPLACE} -- ${.CURDIR}/$${SCRIPT} > \
${DESTDIR}/$${SCRIPT}; \
fi; \
done
install: check
@mkdir -p ${DESTDIR}${LOCALBASE}/opnsense/version
@if [ -d ${.CURDIR}/contrib ]; then ${MAKE} DESTDIR=$$(readlink -f ${DESTDIR}) -C ${.CURDIR}/contrib install; fi
@(cd ${.CURDIR}/src 2> /dev/null && find * -type f) | while read FILE; do \
tar -C ${.CURDIR}/src -cpf - "$${FILE}" | \
tar -C ${DESTDIR}${LOCALBASE} -xpf -; \
if [ "$${FILE%%.in}" != "$${FILE}" ]; then \
sed -i '' ${SED_REPLACE} "${DESTDIR}${LOCALBASE}/$${FILE}"; \
mv "${DESTDIR}${LOCALBASE}/$${FILE}" "${DESTDIR}${LOCALBASE}/$${FILE%%.in}"; \
FILE="$${FILE%%.in}"; \
fi; \
if [ "$${FILE%%.shadow}" != "$${FILE}" ]; then \
mv "${DESTDIR}${LOCALBASE}/$${FILE}" \
"${DESTDIR}${LOCALBASE}/$${FILE%%.shadow}.sample"; \
fi; \
if [ "$${FILE%%/*}" == "man" ]; then \
gzip -cn "${DESTDIR}${LOCALBASE}/$${FILE}" > \
"${DESTDIR}${LOCALBASE}/$${FILE}.gz"; \
rm "${DESTDIR}${LOCALBASE}/$${FILE}"; \
fi; \
done
@cat ${TEMPLATESDIR}/version | sed ${SED_REPLACE} > "${DESTDIR}${LOCALBASE}/opnsense/version/${PLUGIN_NAME}"
plist: check
@(if [ -d ${.CURDIR}/contrib ]; then \
${MAKE} -C ${.CURDIR}/contrib plist; \
fi; \
(cd ${.CURDIR}/src 2> /dev/null && find * -type f) | while read FILE; do \
if [ -f "$${FILE}.in" ]; then continue; fi; \
FILE="$${FILE%%.in}"; PREFIX=""; \
if [ "$${FILE%%.sample}" != "$${FILE}" ]; then \
PREFIX="@sample "; \
elif [ "$${FILE%%.shadow}" != "$${FILE}" ]; then \
FILE="$${FILE%%.shadow}.sample"; \
PREFIX="@shadow "; \
fi; \
if [ "$${FILE%%/*}" == "man" ]; then \
FILE="$${FILE}.gz"; \
fi; \
echo "$${PREFIX}${LOCALBASE}/$${FILE}"; \
done; \
echo "${LOCALBASE}/opnsense/version/${PLUGIN_NAME}" \
) | sort
description: check
@if [ -f ${.CURDIR}/${PLUGIN_DESC} ]; then \
cat ${.CURDIR}/${PLUGIN_DESC}; \
fi
metadata: check
@mkdir -p ${DESTDIR}
@${MAKE} DESTDIR=${DESTDIR} scripts
@${MAKE} DESTDIR=${DESTDIR} manifest > ${DESTDIR}/+MANIFEST
@${MAKE} DESTDIR=${DESTDIR} description > ${DESTDIR}/+DESC
@${MAKE} DESTDIR=${DESTDIR} plist > ${DESTDIR}/plist
collect: check
@(cd ${.CURDIR}/src 2> /dev/null && find * -type f) | while read FILE; do \
tar -C ${DESTDIR}${LOCALBASE} -cpf - "$${FILE}" | \
tar -C ${.CURDIR}/src -xpf -; \
done
remove: check
@(cd ${.CURDIR}/src 2> /dev/null && find * -type f) | while read FILE; do \
rm -f "${DESTDIR}${LOCALBASE}/$${FILE}"; \
done
@(cd ${.CURDIR}/src 2> /dev/null && find * -type d -depth) | while read DIR; do \
if [ -d "${DESTDIR}${LOCALBASE}/$${DIR}" ]; then \
rmdir "${DESTDIR}${LOCALBASE}/$${DIR}" 2> /dev/null || true; \
fi; \
done
package: check
@rm -rf ${WRKSRC}
@mkdir -p ${WRKSRC} ${PKGDIR}
.for DEP in ${PLUGIN_DEPENDS}
@if ! ${PKG} info ${DEP} > /dev/null; then ${PKG} install -yA ${DEP}; fi
.endfor
@echo -n ">>> Staging files for ${PLUGIN_PKGNAME}-${PLUGIN_PKGVERSION}..."
@${MAKE} DESTDIR=${WRKSRC} install
@echo " done"
@echo ">>> Generated version info for ${PLUGIN_PKGNAME}-${PLUGIN_PKGVERSION}:"
@cat ${WRKSRC}${LOCALBASE}/opnsense/version/${PLUGIN_NAME}
@echo -n ">>> Generating metadata for ${PLUGIN_PKGNAME}-${PLUGIN_PKGVERSION}..."
@${MAKE} DESTDIR=${WRKSRC} metadata
@echo " done"
@echo ">>> Packaging files for ${PLUGIN_PKGNAME}-${PLUGIN_PKGVERSION}:"
@PORTSDIR=${PLUGINSDIR} ${PKG} create -v -m ${WRKSRC} -r ${WRKSRC} \
-p ${WRKSRC}/plist -o ${PKGDIR}
upgrade-check: check
@rm -rf ${PKGDIR}
upgrade: upgrade-check package
.for NAME in ${PLUGIN_PKGNAMES}
@if ${PKG} info ${NAME} 2> /dev/null > /dev/null; then \
${PKG} delete -fy ${NAME}; \
fi
.endfor
@${PKG} add ${PKGDIR}/*.pkg
mount: check
mount_unionfs ${.CURDIR}/src ${DESTDIR}${LOCALBASE}
umount: check
umount -f "<above>:${.CURDIR}/src"
clean: check
@if [ -d ${.CURDIR}/src ]; then \
git reset -q ${.CURDIR}/src && \
git checkout -f ${.CURDIR}/src && \
git clean -xdqf ${.CURDIR}/src; \
fi
@rm -rf ${.CURDIR}/work
glint: sweep lint
revision:
@MAKE=${MAKE} ${SCRIPTSDIR}/revbump.sh ${.CURDIR}
test: check
.if exists(${TESTDIR})
@cd ${TESTDIR} && phpunit || true; \
rm -rf ${TESTDIR}/.phpunit.result.cache
.endif
commit:
@mkdir -p ${MFCDIR}
@/bin/echo -n "${.CURDIR:C/\// /g:[-2]}/${.CURDIR:C/\// /g:[-1]}: " > \
${MFCDIR}/.commitmsg && git commit -eF ${MFCDIR}/.commitmsg .
.PHONY: check