New USES=uniquefiles to make files or directories unique

by adding a prefix or suffix to them.

Files listed in UNIQUE_PREFIX_FILES will receive the prefix
set via UNIQUE_PREFIX. The same applies to UNIQUE_SUFFIX_FILES,
but with the chosen UNIQUE_SUFFIX. UNIQUE_PREFIX and
UNIQUE_SUFFIX are set to PKGNAMEPREFIX and PKGNAMESUFFIX by
default.
The uniquefiles USES enables ports to name files in special
ways, e.g. by outlining that the port does not support X11
(-nox11). A binary named bin/foo thus can be easily renamed
to bin/foo-featureA via

USES=                 uniquefiles
UNIQUE_SUFFIX=        -featureA
UNIQUE_SUFFIX_FILES=  bin/foo

The uniquefiles USES automatically adjusts the plist at
installation time. There is no need to consider the prefix
or suffix in the pkg-plist file itself. If the original name
of the renamed file is bin/foo, this exact name should be put
into pkg-plist.

The dirs argument to USES=uniquefiles will cause certain
standard directories, such as DOCSDIR or EXAMPLESDIR to be
prepended with the UNIQUE_PREFIX. The change to the directories
will hapen prior to configuring or building the port, so that
the port Makefile as well as the port's build logic are aware
of the changed name.

Since the uniquefiles USES effectively manipulates the port's
installation and file layout, it will only be available for
stagedir-aware ports. Ports with NO_STAGE=yes will be unable
to use the uniquefiles USES.

Reviewed by:	portmgr@
Approved by:	portmgr@
This commit is contained in:
Marcus von Appen 2014-01-11 16:52:34 +00:00
parent 5a8d78cbce
commit 78b8b9e4ba
Notes: svn2git 2021-03-31 03:12:20 +00:00
svn path=/head/; revision=339436
3 changed files with 243 additions and 5 deletions

38
CHANGES
View File

@ -10,6 +10,44 @@ in the release notes and/or placed into UPDATING.
All ports committers are allowed to commit to this file.
20140111:
AUTHOR: mva@FreeBSD.org
New USES=uniquefiles to make files or directories unique
by adding a prefix or suffix to them.
Files listed in UNIQUE_PREFIX_FILES will receive the prefix
set via UNIQUE_PREFIX. The same applies to UNIQUE_SUFFIX_FILES,
but with the chosen UNIQUE_SUFFIX. UNIQUE_PREFIX and
UNIQUE_SUFFIX are set to PKGNAMEPREFIX and PKGNAMESUFFIX by
default.
The uniquefiles USES enables ports to name files in special
ways, e.g. by outlining that the port does not support X11
(-nox11). A binary named bin/foo thus can be easily renamed
to bin/foo-featureA via
USES= uniquefiles
UNIQUE_SUFFIX= -featureA
UNIQUE_SUFFIX_FILES= bin/foo
The uniquefiles USES automatically adjusts the plist at
installation time. There is no need to consider the prefix
or suffix in the pkg-plist file itself. If the original name
of the renamed file is bin/foo, this exact name should be put
into pkg-plist.
The dirs argument to USES=uniquefiles will cause certain
standard directories, such as DOCSDIR or EXAMPLESDIR to be
prepended with the UNIQUE_PREFIX. The change to the directories
will hapen prior to configuring or building the port, so that
the port Makefile as well as the port's build logic are aware
of the changed name.
Since the uniquefiles USES effectively manipulates the port's
installation and file layout, it will only be available for
stagedir-aware ports. Ports with NO_STAGE=yes will be unable
to use the uniquefiles USES.
20131218:
AUTHOR: mva@FreeBSD.org

199
Mk/Uses/uniquefiles.mk Normal file
View File

@ -0,0 +1,199 @@
# -*- tab-width: 4; -*-
# ex: ts=4
#
# $FreeBSD$
#
# Make files or directories 'unique', by adding a prefix or suffix.
#
# MAINTAINER: portmgr@FreeBSD.org
#
# Feature: uniquefiles
# Usage: USES=uniquefiles or USES=uniquefiles:ARGS
# Valid ARGS: dirs
#
# dirs: The port needs a prefix (and only a prefix) based on
# UNIQUE_PREFIX for the standard directories
# DOCSDIR, EXAMPLESDIR, DATADIR, WWWDIR, ETCDIR
#
# Variables for ports:
#
# UNIQUE_PREFIX - The prefix to be used for directories and files.
# Default: ${PKGNAMEPREFIX}.
# UNIQUE_PREFIX_FILES - A list of files that need to be prefixed.
# Default: empty
# UNIQUE_SUFFIX - The suffix to be used for files.
# Default: ${PKGNAMESUFFIX}.
# UNIQUE_SUFFIX_FILES - A list of files that need to be suffixed.
# Default: empty
#
# Variables for the ports framework, but NOT individual ports:
#
# UNIQUE_DEFAULT_LINKS - When set to "yes", symlinks of the original
# filenames are also created pointing to their
# UNIQUE_* counterparts.
# This is useful for supporting multiple logical
# instances from a single physical port, but where
# you want to mark only *one* of those instances to
# provide original filenames.
#
# category/py-foo, installed as:
#
# py27-foo for Python 2.7 (DEFAULT_VERSION)
# py33-foo for Python 3.3
#
# Results in:
#
# py27-foo
# bin/foo-2.7 (UNIQUE_SUFFIX)
# bin/foo -> bin/foo-2.7 (symlinked original filename)
# py33-foo creates:
# bin/foo-3.3 (UNIQUE_SUFFIX)
#
# Default: no
#
# UNIQUE_FIND_PREFIX_FILES - A shell command to be executed to find files for
# the specific port. This has to return a
# list of files to be iterated over.
# Default: empty
#
# UNIQUE_FIND_SUFFIX_FILES - A shell command to be executed to find files for
# the specific port. This has to return a
# list of files to be iterated over.
# Default: empty
#
# NOTE: multiple logical instances are not supported by pkg and the original
# pkg_tools at the moment.
#
.if !defined(_INCLUDE_USES_UNIQUEFILES_MK)
_INCLUDE_USES_UNIQUEFILES_MK= yes
.if defined(NO_STAGE)
BROKEN= uniquefiles USES can only be used for stage-safe ports
.endif
.if !defined(uniquefiles_ARGS)
uniquefiles_ARGS= #empty
.endif
UNIQUE_PREFIX?= ${PKGNAMEPREFIX}
UNIQUE_SUFFIX?= ${PKGNAMESUFFIX}
UNIQUE_PREFIX_FILES?= # empty
UNIQUE_SUFFIX_FILES?= # empty
.if ${uniquefiles_ARGS:Mdirs}
DOCSDIR= ${PREFIX}/share/doc/${UNIQUE_PREFIX}${PORTNAME}
EXAMPLESDIR=${PREFIX}/share/examples/${UNIQUE_PREFIX}${PORTNAME}
DATADIR= ${PREFIX}/share/${UNIQUE_PREFIX}${PORTNAME}
WWWDIR= ${PREFIX}/www/${UNIQUE_PREFIX}${PORTNAME}
ETCDIR= ${PREFIX}/etc/${UNIQUE_PREFIX}${PORTNAME}
.endif
UNIQUE_DEFAULT_LINKS?= no
UNIQUE_FIND_PREFIX_FILES?= # empty
UNIQUE_FIND_SUFFIX_FILES?= # empty
.if defined(_POSTMKINCLUDED) && !defined(_INCLUDE_USES_UNIQUEFILES_POST_MK)
_INCLUDE_USES_UNIQUEFILES_POST_MK= yes
_UNIQUEPKGLIST= ${WRKDIR}/.PLIST.uniquefiles
.if ${UNIQUE_DEFAULT_LINKS} == yes
_DO_CONDITIONAL_SYMLINK= \
if [ ! -e ${STAGEDIR}${PREFIX}/$${fname} ]; then \
${ECHO_MSG} " $${newf} --> @$${fname}"; \
${LN} -s ${PREFIX}/$${newf} ${STAGEDIR}${PREFIX}/$${fname}; \
${ECHO_CMD} LINKED:$${newf}:$${fname} >> ${_UNIQUEPKGLIST}; \
fi
.else
# We are not symlinking the renamed binary.
_DO_CONDITIONAL_SYMLINK= ${DO_NADA}
.endif
move-uniquefiles:
.if ${UNIQUE_PREFIX_FILES} || ${UNIQUE_FIND_PREFIX_FILES}
@${ECHO_MSG} "===> Moving prefixed files around";
.endif
.for entry in ${UNIQUE_PREFIX_FILES}
@fname=${entry}; \
if [ -e ${STAGEDIR}${PREFIX}/$${fname} ]; then \
newf=$${fname%/*}/${UNIQUE_PREFIX}$${fname##*/} ; \
${ECHO_MSG} " $${fname} --> $${newf}" ; \
${MV} ${STAGEDIR}${PREFIX}/$${fname} ${STAGEDIR}${PREFIX}/$${newf}; \
${ECHO_CMD} MOVED:$${fname}:$${newf} >> ${_UNIQUEPKGLIST}; \
${_DO_CONDITIONAL_SYMLINK}; \
else \
${ECHO_MSG} "Makefile error: UNIQUE (prefix): $${fname} not found"; \
${FALSE}; \
fi;
.endfor
.if ${UNIQUE_FIND_PREFIX_FILES}
@for fname in `${UNIQUE_FIND_PREFIX_FILES}`; do \
if [ -e ${STAGEDIR}${PREFIX}/$${fname} ]; then \
newf=$${fname%/*}/${UNIQUE_PREFIX}$${fname##*/} ; \
${ECHO_MSG} " $${fname} --> $${newf}" ; \
${MV} ${STAGEDIR}${PREFIX}/$${fname} ${STAGEDIR}${PREFIX}/$${newf}; \
${ECHO_CMD} MOVED:$${fname}:$${newf} >> ${_UNIQUEPKGLIST}; \
${_DO_CONDITIONAL_SYMLINK}; \
else \
${ECHO_MSG} "Makefile error: UNIQUE (prefix): $${fname} not found"; \
${FALSE}; \
fi; \
done;
.endif
.if ${UNIQUE_SUFFIX_FILES} || ${UNIQUE_FIND_SUFFIX_FILES}
@${ECHO_MSG} "===> Moving suffixed files around";
.endif
.for entry in ${UNIQUE_SUFFIX_FILES}
@fname=${entry}; \
if [ -e ${STAGEDIR}${PREFIX}/$${fname} ]; then \
newf=$${fname%/*}/$${fname##*/}${UNIQUE_SUFFIX}; \
${ECHO_MSG} " $${fname} --> $${newf}"; \
${MV} ${STAGEDIR}${PREFIX}/$${fname} ${STAGEDIR}${PREFIX}/$${newf}; \
${ECHO_CMD} MOVED:$${fname}:$${newf} >> ${_UNIQUEPKGLIST}; \
${_DO_CONDITIONAL_SYMLINK}; \
else \
${ECHO_MSG} "Makefile error: UNIQUE (suffix): $${fname} not found"; \
${FALSE}; \
fi;
.endfor
.if ${UNIQUE_FIND_SUFFIX_FILES}
@for fname in `${UNIQUE_FIND_SUFFIX_FILES}`; do \
if [ -e ${STAGEDIR}${PREFIX}/$${fname} ]; then \
newf=$${fname%/*}/$${fname##*/}${UNIQUE_SUFFIX}; \
${ECHO_MSG} " $${fname} --> $${newf}"; \
${MV} ${STAGEDIR}${PREFIX}/$${fname} ${STAGEDIR}${PREFIX}/$${newf}; \
${ECHO_CMD} MOVED:$${fname}:$${newf} >> ${_UNIQUEPKGLIST}; \
${_DO_CONDITIONAL_SYMLINK}; \
else \
${ECHO_MSG} "Makefile error: UNIQUE (suffix): $${fname} not found"; \
${FALSE}; \
fi; \
done;
.endif
# Using .if exists(${_UNIQUEPKGPLIST} below instead of the sh test
# does not work in poudriere. It works fine on the CLI, though...
move-uniquefiles-plist:
@if [ -e ${_UNIQUEPKGLIST} ]; then \
orgIFS=$$IFS; IFS=":"; while read command entry newentry; do \
IFS=$$orgIFS; \
case $${command} in \
MOVED) \
${REINPLACE_CMD} -e "s|^$${entry}$$|$${newentry}|" ${TMPPLIST}; \
;; \
LINKED) \
${AWK} '$$0 ~ pe { print; print ne ;next }1' \
pe="$${entry}" ne="$${newentry}" \
${TMPPLIST} > ${TMPPLIST}.uniquefilestmp; \
${MV} ${TMPPLIST}.uniquefilestmp ${TMPPLIST}; \
;; \
*) ;; \
esac; \
IFS=":"; \
done < ${_UNIQUEPKGLIST}; \
fi
.endif # defined(_POSTMKINCLUDED)
.endif # _INCLUDE_USES_UNIQUEFILES_MK

View File

@ -6451,19 +6451,20 @@ _STAGE_SEQ= stage-message stage-dir run-depends lib-depends apply-slist pre-ins
.if defined(NEED_ROOT)
_STAGE_SUSEQ= create-users-groups do-install desktop-file-post-install kmod-post-install \
shared-mime-post-install webplugin-post-install \
post-install post-install-script post-stage compress-man \
post-install post-install-script move-uniquefiles post-stage compress-man \
install-rc-script install-ldconfig-file install-license \
install-desktop-entries add-plist-info add-plist-docs add-plist-examples \
add-plist-data add-plist-post fix-plist-sequence
add-plist-data add-plist-post move-uniquefiles-plist fix-plist-sequence
.if defined(DEVELOPER)
_STAGE_SUSEQ+= stage-qa
.endif
.else
_STAGE_SEQ+= create-users-groups do-install desktop-file-post-install kmod-post-install \
shared-mime-post-install webplugin-post-install post-install post-install-script \
post-stage compress-man install-rc-script install-ldconfig-file install-license \
install-desktop-entries add-plist-info add-plist-docs add-plist-examples \
add-plist-data add-plist-post fix-plist-sequence
move-uniquefiles post-stage compress-man install-rc-script install-ldconfig-file \
install-license install-desktop-entries add-plist-info add-plist-docs \
add-plist-examples add-plist-data add-plist-post move-uniquefiles-plist \
fix-plist-sequence
.if defined(DEVELOPER)
_STAGE_SEQ+= stage-qa
.endif