source: trunk/debathena/debathena/config-package-dev/divert.mk @ 23076

Revision 23076, 5.6 KB checked in by tabbott, 16 years ago (diff)
Improve config-package-dev documentation and examples.
Line 
1# -*- mode: makefile; coding: utf-8 -*-
2# Copyright © 2007-2008 Anders Kaseorg <andersk@mit.edu> and
3#                       Tim Abbott <tabbott@mit.edu>
4#
5# This program is free software; you can redistribute it and/or
6# modify it under the terms of the GNU General Public License as
7# published by the Free Software Foundation; either version 2, or (at
8# your option) any later version.
9#
10# This program is distributed in the hope that it will be useful, but
11# WITHOUT ANY WARRANTY; without even the implied warranty of
12# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13# General Public License for more details.
14#
15# You should have received a copy of the GNU General Public License
16# along with this program; if not, write to the Free Software
17# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
18# 02111-1307 USA.
19
20# Don't include divert.mk in your rules files directly; instead use
21# config-package.mk.
22
23# divert.mk handles the low-level diversion logic.  It includes
24# divert.sh.in in the postinst and prerm scripts, and adds
25
26ifndef _cdbs_rules_divert
27_cdbs_rules_divert = 1
28
29include /usr/share/cdbs/1/rules/debhelper.mk
30
31CDBS_BUILD_DEPENDS := $(CDBS_BUILD_DEPENDS), config-package-dev (>= 4.5~)
32
33# divert.sh.in is included in the postinst/prerm scripts of packages
34# installing diversions using config-package-dev.
35DEB_DIVERT_SCRIPT = /usr/share/config-package-dev/divert.sh.in
36# script used to encode the path of a file uniquely in a valid virtual
37# package name.
38DEB_DIVERT_ENCODER = /usr/share/config-package-dev/encode
39
40DEB_DIVERT_PACKAGES += $(foreach package,$(DEB_ALL_PACKAGES), \
41    $(if $(DEB_TRANSFORM_FILES_$(package)),$(package), \
42    $(if $(DEB_REMOVE_FILES_$(package)),$(package), \
43    $(if $(DEB_UNREMOVE_FILES_$(package)),$(package), \
44    $(if $(DEB_UNDIVERT_FILES_$(package)),$(package), \
45    $(if $(DEB_DIVERT_FILES_$(package)),$(package)))))))
46
47ifeq ($(DEB_DIVERT_EXTENSION),)
48DEB_DIVERT_EXTENSION = .divert
49endif
50
51# Replace only the last instance of DEB_DIVERT_EXTENSION in the
52# filename, to make it possible to divert /path/foo.divert to
53# foo.divert.divert-orig
54divert_files_replace_name = $(shell echo $(1) | perl -pe 's/(.*)\Q$(DEB_DIVERT_EXTENSION)\E/$$1$(2)/')
55
56debian-divert/%: package = $(subst debian-divert/,,$@)
57debian-divert/%: divert_files = $(DEB_DIVERT_FILES_$(package)) $(DEB_TRANSFORM_FILES_$(package))
58debian-divert/%: divert_remove_files = $(DEB_REMOVE_FILES_$(package))
59debian-divert/%: divert_undivert_files = $(DEB_UNDIVERT_FILES_$(package))
60debian-divert/%: divert_unremove_files = $(DEB_UNREMOVE_FILES_$(package))
61debian-divert/%: divert_files_all = $(strip $(divert_files) $(divert_remove_files) $(divert_undivert_files) $(divert_unremove_files))
62debian-divert/%: divert_files_thispkg = $(strip $(divert_files) $(divert_remove_files))
63$(patsubst %,debian-divert/%,$(DEB_DIVERT_PACKAGES)) :: debian-divert/%:
64#   Writing shell scripts in makefiles sucks.  Remember to $$ shell
65#   variables and include \ at the end of each line.
66# Add code to postinst to add/remove diversions as appropriate
67        ( \
68            sed 's/#PACKAGE#/$(cdbs_curpkg)/g; s/#DEB_DIVERT_EXTENSION#/$(DEB_DIVERT_EXTENSION)/g' $(DEB_DIVERT_SCRIPT); \
69            $(if $(divert_files_all), \
70                echo 'if [ "$$1" = "configure" ]; then'; \
71                $(foreach file,$(divert_undivert_files), \
72                    $(if $(DEB_UNDIVERT_VERSION_$(file)),,\
73                        echo "ERROR!  Missing undivert version for $(file)!">&2; exit 1;) \
74                    echo -n "    if [ -n \"\$$2\" ] && dpkg --compare-versions \"\$$2\" '<<' "; \
75                    echo "'$(DEB_UNDIVERT_VERSION_$(file))'; then"; \
76                    echo "        undivert_unlink $(call divert_files_replace_name,$(file), )"; \
77                    echo "    fi";) \
78                $(foreach file,$(divert_unremove_files), \
79                    $(if $(DEB_UNREMOVE_VERSION_$(file)),,\
80                        echo "ERROR!  Missing unremove version for $(file)!">&2; exit 1;) \
81                    echo -n "    if [ -n \"\$$2\" ] && dpkg --compare-versions \"\$$2\" '<<' "; \
82                    echo "'$(DEB_UNREMOVE_VERSION_$(file))'; then"; \
83                    echo "        undivert_unremove $(file)"; \
84                    echo "    fi";) \
85                $(foreach file,$(divert_files), \
86                    echo "    divert_link $(call divert_files_replace_name,$(file), )";) \
87                $(foreach file,$(divert_remove_files), \
88                    mkdir -p $(DEB_DESTDIR)/usr/share/$(cdbs_curpkg); \
89                    echo "    divert_remove $(file) /usr/share/$(cdbs_curpkg)/`$(DEB_DIVERT_ENCODER) $(file)`";) \
90                echo 'fi'; \
91            ) \
92        ) >> $(CURDIR)/debian/$(cdbs_curpkg).postinst.debhelper
93# Add code to prerm script to undo diversions when package is removed.
94        ( \
95            sed 's/#PACKAGE#/$(cdbs_curpkg)/g; s/#DEB_DIVERT_EXTENSION#/$(DEB_DIVERT_EXTENSION)/g' $(DEB_DIVERT_SCRIPT); \
96            $(if $(divert_files_thispkg), \
97                echo 'if [ "$$1" = "remove" ]; then'; \
98                $(foreach file,$(divert_files), \
99                    echo "    undivert_unlink $(call divert_files_replace_name,$(file), )";) \
100                $(foreach file,$(divert_remove_files), \
101                    echo "    undivert_unremove $(file) $(cdbs_curpkg)";) \
102                echo 'fi'; \
103            ) \
104        ) >> $(CURDIR)/debian/$(cdbs_curpkg).prerm.debhelper
105# Add an encoding of the names of the diverted files to the Provides:
106# and Conflicts: lists.  This prevents two packages diverting the same
107# file from being installed simultaneously (it cannot work, and this
108# produces a much less ugly error).  Requires in debian/control:
109#   Provides: $(diverted-files)
110#   Conflicts: $(diverted-files)
111        ( \
112            echo -n "diverted-files="; \
113            $(foreach file,$(divert_files_thispkg),\
114                echo -n "diverts-"; \
115                ${DEB_DIVERT_ENCODER} "$(call divert_files_replace_name,$(file))"; \
116                echo -n ", ";) \
117            echo \
118        ) >> $(CURDIR)/debian/$(cdbs_curpkg).substvars
119
120$(patsubst %,binary-post-install/%,$(DEB_DIVERT_PACKAGES)) :: binary-post-install/%: debian-divert/%
121
122endif
Note: See TracBrowser for help on using the repository browser.