/[gentoo-x86]/eclass/depend.apache.eclass
Gentoo

Diff of /eclass/depend.apache.eclass

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.23 Revision 1.45
1# Copyright 1999-2005 Gentoo Foundation 1# Copyright 1999-2009 Gentoo Foundation
2# Distributed under the terms of the GNU General Public License v2 2# Distributed under the terms of the GNU General Public License v2
3# $Header: /var/cvsroot/gentoo-x86/eclass/depend.apache.eclass,v 1.23 2005/09/19 00:03:55 vericgar Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/depend.apache.eclass,v 1.45 2009/05/26 16:41:56 arfrever Exp $
4
5# @ECLASS: depend.apache.eclass
6# @MAINTAINER:
7# apache-devs@gentoo.org
8# @BLURB: Functions to allow ebuilds to depend on apache
9# @DESCRIPTION:
10# This eclass handles depending on apache in a sane way and provides information
11# about where certain binaries and configuration files are located.
12#
13# To make use of this eclass simply call one of the need/want_apache functions
14# described below. Make sure you use the need/want_apache call after you have
15# defined DEPEND and RDEPEND. Also note that you can not rely on the automatic
16# RDEPEND=DEPEND that portage does if you use this eclass.
17#
18# See Bug 107127 for more information.
19#
20# @EXAMPLE:
21#
22# Here is an example of an ebuild depending on apache:
23#
24# @CODE
25# DEPEND="virtual/Perl-CGI"
26# RDEPEND="${DEPEND}"
27# need_apache2
28# @CODE
29#
30# Another example which demonstrates non-standard IUSE options for optional
31# apache support:
32#
33# @CODE
34# DEPEND="server? ( virtual/Perl-CGI )"
35# RDEPEND="${DEPEND}"
36# want_apache2 server
37#
38# pkg_setup() {
39# depend.apache_pkg_setup server
40# }
41# @CODE
4 42
5inherit multilib 43inherit multilib
6 44
7###### 45# ==============================================================================
8## Apache Common Variables 46# INTERNAL VARIABLES
9## 47# ==============================================================================
10## These are internal variables used by this, and other apache-related eclasses,
11## and thus should not need to be used by the ebuilds themselves (the ebuilds
12## should know what version of Apache they are building against).
13######
14 48
15#### 49# @ECLASS-VARIABLE: APACHE_VERSION
16## APACHE_VERSION 50# @DESCRIPTION:
17##
18## Stores the version of apache we are going to be ebuilding. This variable is 51# Stores the version of apache we are going to be ebuilding.
19## set by the need_apache{|1|2} functions. 52# This variable is set by the want/need_apache functions.
20##
21## This needs to stay as '1' until apache2 is on by default -- although it
22## doesn't matter much as it's set by the need_apache functions.
23####
24APACHE_VERSION='1'
25 53
26#### 54# @ECLASS-VARIABLE: APXS
27## APXS1, APXS2 55# @DESCRIPTION:
28##
29## Paths to the apxs tools 56# Path to the apxs tool.
30#### 57# This variable is set by the want/need_apache functions.
31APXS1="/usr/sbin/apxs"
32APXS2="/usr/sbin/apxs2"
33 58
34#### 59# @ECLASS-VARIABLE: APACHE_BIN
35## APACHECTL1, APACHECTL2 60# @DESCRIPTION:
36## 61# Path to the apache binary.
62# This variable is set by the want/need_apache functions.
63
64# @ECLASS-VARIABLE: APACHE_CTL
65# @DESCRIPTION:
37## Paths to the apachectl tools 66# Path to the apachectl tool.
38#### 67# This variable is set by the want/need_apache functions.
39APACHECTL1="/usr/sbin/apachectl"
40APACHECTL2="/usr/sbin/apache2ctl"
41 68
42#### 69# @ECLASS-VARIABLE: APACHE_BASEDIR
43## APACHE1_BASEDIR, APACHE2_BASEDIR 70# @DESCRIPTION:
44##
45## Paths to the server root directories 71# Path to the server root directory.
46#### 72# This variable is set by the want/need_apache functions.
47#APACHE1_BASEDIR="/usr/$(get_libdir)/apache"
48#APACHE2_BASEDIR="/usr/$(get_libdir)/apache2"
49APACHE1_BASEDIR="/usr/lib/apache"
50APACHE2_BASEDIR="/usr/lib/apache2"
51 73
52#### 74# @ECLASS-VARIABLE: APACHE_CONFDIR
53## APACHE1_CONFDIR, APACHE2_CONFDIR 75# @DESCRIPTION:
54##
55## Paths to the configuration file directories (usually under 76# Path to the configuration file directory.
56## $APACHE?_BASEDIR/conf) 77# This variable is set by the want/need_apache functions.
57####
58APACHE1_CONFDIR="/etc/apache"
59APACHE2_CONFDIR="/etc/apache2"
60 78
61#### 79# @ECLASS-VARIABLE: APACHE_MODULES_CONFDIR
62## APACHE1_MODULES_CONFDIR, APACHE2_MODULES_CONFDIR 80# @DESCRIPTION:
63##
64## Paths where module configuration files are kept 81# Path where module configuration files are kept.
65#### 82# This variable is set by the want/need_apache functions.
66APACHE1_MODULES_CONFDIR="${APACHE1_CONFDIR}/modules.d"
67APACHE2_MODULES_CONFDIR="${APACHE2_CONFDIR}/modules.d"
68 83
69#### 84# @ECLASS-VARIABLE: APACHE_VHOSTS_CONFDIR
70## APACHE1_VHOSTDIR, APACHE2_VHOSTDIR 85# @DESCRIPTION:
71##
72## Paths where virtual host configuration files are kept 86# Path where virtual host configuration files are kept.
73#### 87# This variable is set by the want/need_apache functions.
74APACHE1_VHOSTDIR="${APACHE1_CONFDIR}/vhosts.d"
75APACHE2_VHOSTDIR="${APACHE2_CONFDIR}/vhosts.d"
76 88
77#### 89# @ECLASS-VARIABLE: APACHE_MODULESDIR
78## APACHE1_MODULESDIR, APACHE2_MODULESDIR 90# @DESCRIPTION:
79##
80## Paths where we install modules 91# Path where we install modules.
81#### 92# This variable is set by the want/need_apache functions.
93
94# @ECLASS-VARIABLE: APACHE_DEPEND
95# @DESCRIPTION:
96# Dependencies for Apache
97APACHE_DEPEND="www-servers/apache"
98
99# @ECLASS-VARIABLE: APACHE2_DEPEND
100# @DESCRIPTION:
101# Dependencies for Apache 2.x
102APACHE2_DEPEND="=www-servers/apache-2*"
103
104# @ECLASS-VARIABLE: APACHE2_2_DEPEND
105# @DESCRIPTION:
106# Dependencies for Apache 2.2.x
107APACHE2_2_DEPEND="=www-servers/apache-2.2*"
108
109# ==============================================================================
110# INTERNAL FUNCTIONS
111# ==============================================================================
112
113_init_apache2() {
114 debug-print-function $FUNCNAME $*
115
116 # WARNING: Do not use these variables with anything that is put
117 # into the dependency cache (DEPEND/RDEPEND/etc)
118 APACHE_VERSION="2"
119 APXS="/usr/sbin/apxs2"
120 APACHE_BIN="/usr/sbin/apache2"
121 APACHE_CTL="/usr/sbin/apache2ctl"
122 APACHE_INCLUDEDIR="/usr/include/apache2"
123 APACHE_BASEDIR="/usr/$(get_libdir)/apache2"
124 APACHE_CONFDIR="/etc/apache2"
125 APACHE_MODULES_CONFDIR="${APACHE_CONFDIR}/modules.d"
126 APACHE_VHOSTS_CONFDIR="${APACHE_CONFDIR}/vhosts.d"
82APACHE1_MODULESDIR="${APACHE1_BASEDIR}/modules" 127 APACHE_MODULESDIR="${APACHE_BASEDIR}/modules"
83APACHE2_MODULESDIR="${APACHE2_BASEDIR}/modules"
84
85####
86## APACHE1_DEPEND, APACHE2_DEPEND
87##
88## Dependencies for apache 1.x and apache 2.x
89## - apache2 must be at least version 2.0.54-r30, this is lowest version
90## containing our new overall changes -- trapni (Jan 21 2005)
91## - apache1 must be at least version 1.3.33-r10, but how to
92## define the DEPEND here? (FIXME) -- trapni (Jan 21 2005)
93## - currently not possible - bug #4315 -- vericgar (Jan 21 2005)
94####
95APACHE1_DEPEND="=net-www/apache-1*"
96APACHE2_DEPEND=">=net-www/apache-2.0.54-r30"
97
98####
99## APACHE_DEPEND
100##
101## Dependency magic based on useflags to use the right DEPEND
102####
103
104NEED_APACHE_DEPEND="apache2? ( ${APACHE2_DEPEND} ) !apache2? ( ${APACHE1_DEPEND} )"
105WANT_APACHE_DEPEND="apache2? ( ${APACHE2_DEPEND} ) !apache2? ( apache? ( ${APACHE1_DEPEND} ) )"
106
107####
108# uses_apache1()
109#
110# sets up all of the environment variables required by an apache1 module
111####
112
113uses_apache1() {
114 APACHE_VERSION='1'
115 APXS="$APXS1"
116 USE_APACHE2=
117 APACHECTL="${APACHECTL1}"
118 APACHE_BASEDIR="${APACHE1_BASEDIR}"
119 APACHE_CONFDIR="${APACHE1_CONFDIR}"
120 APACHE_MODULES_CONFDIR="${APACHE1_MODULES_CONFDIR}"
121 APACHE_VHOSTSDIR="${APACHE1_VHOSTSDIR}"
122 APACHE_MODULESDIR="${APACHE1_MODULESDIR}"
123} 128}
124 129
125#### 130_init_no_apache() {
126# uses_apache2() 131 debug-print-function $FUNCNAME $*
127#
128# sets up all of the environment variables required by an apache2 module
129####
130
131uses_apache2() {
132 APACHE_VERSION='2'
133 USE_APACHE2=2
134 APXS="$APXS2"
135 APACHECTL="${APACHECTL2}"
136 APACHE_BASEDIR="${APACHE2_BASEDIR}"
137 APACHE_CONFDIR="${APACHE2_CONFDIR}"
138 APACHE_MODULES_CONFDIR="${APACHE2_MODULES_CONFDIR}"
139 APACHE_VHOSTSDIR="${APACHE2_VHOSTSDIR}"
140 APACHE_MODULESDIR="${APACHE2_MODULESDIR}"
141}
142
143doesnt_use_apache() {
144 APACHE_VERSION='0' 132 APACHE_VERSION="0"
145 USE_APACHE=
146} 133}
147 134
148#### 135# ==============================================================================
149## need_apache1 136# PUBLIC FUNCTIONS
150## 137# ==============================================================================
138
139# @FUNCTION: depend.apache_pkg_setup
140# @USAGE: [myiuse]
141# @DESCRIPTION:
142# An ebuild calls this in pkg_setup() to initialize variables for optional
143# apache-2.x support. If the myiuse parameter is not given it defaults to
144# apache2.
145depend.apache_pkg_setup() {
146 debug-print-function $FUNCNAME $*
147
148 if [[ "${EBUILD_PHASE}" != "setup" ]]; then
149 die "$FUNCNAME() should be called in pkg_setup()"
150 fi
151
152 local myiuse=${1:-apache2}
153 if has ${myiuse} ${IUSE}; then
154 if use ${myiuse}; then
155 _init_apache2
156 else
157 _init_no_apache
158 fi
159 fi
160}
161
162# @FUNCTION: want_apache
163# @USAGE: [myiuse]
164# @DESCRIPTION:
165# An ebuild calls this to get the dependency information for optional apache
166# support. If the myiuse parameter is not given it defaults to apache2.
167# An ebuild should additionally call depend.apache_pkg_setup() in pkg_setup()
168# with the same myiuse parameter.
169want_apache() {
170 debug-print-function $FUNCNAME $*
171 want_apache2 "$@"
172}
173
174# @FUNCTION: want_apache2
175# @USAGE: [myiuse]
176# @DESCRIPTION:
177# An ebuild calls this to get the dependency information for optional apache-2.x
178# support. If the myiuse parameter is not given it defaults to apache2.
179# An ebuild should additionally call depend.apache_pkg_setup() in pkg_setup()
180# with the same myiuse parameter.
181want_apache2() {
182 debug-print-function $FUNCNAME $*
183
184 local myiuse=${1:-apache2}
185 IUSE="${IUSE} ${myiuse}"
186 DEPEND="${DEPEND} ${myiuse}? ( ${APACHE2_DEPEND} )"
187 RDEPEND="${RDEPEND} ${myiuse}? ( ${APACHE2_DEPEND} )"
188}
189
190# @FUNCTION: want_apache2_2
191# @USAGE: [myiuse]
192# @DESCRIPTION:
193# An ebuild calls this to get the dependency information for optional
194# apache-2.2.x support. If the myiuse parameter is not given it defaults to
195# apache2.
196# An ebuild should additionally call depend.apache_pkg_setup() in pkg_setup()
197# with the same myiuse parameter.
198want_apache2_2() {
199 debug-print-function $FUNCNAME $*
200
201 local myiuse=${1:-apache2}
202 IUSE="${IUSE} ${myiuse}"
203 DEPEND="${DEPEND} ${myiuse}? ( ${APACHE2_2_DEPEND} )"
204 RDEPEND="${RDEPEND} ${myiuse}? ( ${APACHE2_2_DEPEND} )"
205}
206
207# @FUNCTION: need_apache
208# @DESCRIPTION:
151## An ebuild calls this to get the dependency information 209# An ebuild calls this to get the dependency information for apache.
152## for apache-1.x. An ebuild should use this in order for
153## future changes to the build infrastructure to happen
154## seamlessly. All an ebuild needs to do is include the
155## line need_apache1 somewhere.
156####
157need_apache1() { 210need_apache() {
158 debug-print-function need_apache1 211 debug-print-function $FUNCNAME $*
159
160 DEPEND="${DEPEND} ${APACHE1_DEPEND}"
161 RDEPEND="${RDEPEND} ${APACHE1_DEPEND}"
162 APACHE_VERSION='1'
163}
164
165####
166## need_apache2 212 need_apache2
167## 213}
214
215# @FUNCTION: need_apache2
216# @DESCRIPTION:
168## An ebuild calls this to get the dependency information 217# An ebuild calls this to get the dependency information for apache-2.x.
169## for apache-2.x. An ebuild should use this in order for
170## future changes to the build infrastructure to happen
171## seamlessly. All an ebuild needs to do is include the
172## line need_apache1 somewhere.
173####
174need_apache2() { 218need_apache2() {
175 debug-print-function need_apache2 219 debug-print-function $FUNCNAME $*
176 220
177 DEPEND="${DEPEND} ${APACHE2_DEPEND}" 221 DEPEND="${DEPEND} ${APACHE2_DEPEND}"
178 RDEPEND="${RDEPEND} ${APACHE2_DEPEND}" 222 RDEPEND="${RDEPEND} ${APACHE2_DEPEND}"
179 APACHE_VERSION='2' 223 _init_apache2
180} 224}
181 225
182#### 226# @FUNCTION: need_apache2_2
183## DO NOT CHANGE THIS FUNCTION UNLESS YOU UNDERSTAND THE CONSEQUENCES IT 227# @DESCRIPTION:
184## WILL HAVE ON THE CACHE! There MUST be a apache2? () block in DEPEND for 228# An ebuild calls this to get the dependency information for apache-2.2.x.
185## things to work correct in the dependency calculation stage.
186####
187need_apache() { 229need_apache2_2() {
188 debug-print-function need_apache 230 debug-print-function $FUNCNAME $*
189 231
190 IUSE="${IUSE} apache2"
191 DEPEND="${DEPEND} ${NEED_APACHE_DEPEND}" 232 DEPEND="${DEPEND} ${APACHE2_2_DEPEND}"
192 RDEPEND="${RDEPEND} ${NEED_APACHE_DEPEND}" 233 RDEPEND="${RDEPEND} ${APACHE2_2_DEPEND}"
193 if useq apache2; then 234 _init_apache2
194 uses_apache2 235}
236
237# @FUNCTION: has_apache
238# @DESCRIPTION:
239# An ebuild calls this to get runtime variables for an indirect apache
240# dependency without USE-flag, in which case want_apache does not work.
241# DO NOT call this function in global scope.
242has_apache() {
243 debug-print-function $FUNCNAME $*
244
245 if has_version '>=www-servers/apache-2'; then
246 _init_apache2
195 else 247 else
196 uses_apache1 248 _init_no_apache
197 fi 249 fi
198} 250}
199 251
200want_apache() { 252# @FUNCTION: has_apache_threads
201 debug-print-function want_apache 253# @USAGE: [myflag]
254# @DESCRIPTION:
255# An ebuild calls this to make sure thread-safety is enabled if apache has been
256# built with a threaded MPM. If the myflag parameter is not given it defaults to
257# threads.
258has_apache_threads() {
259 debug-print-function $FUNCNAME $*
202 260
203 IUSE="${IUSE} apache apache2" 261 if ! built_with_use www-servers/apache threads; then
204 DEPEND="${DEPEND} ${WANT_APACHE_DEPEND}" 262 return
205 RDEPEND="${DEPEND} ${WANT_APACHE_DEPEND}"
206 if useq apache2 ; then
207 uses_apache2
208 elif useq apache ; then
209 uses_apache1
210 else
211 doesnt_use_apache
212 fi 263 fi
264
265 local myflag="${1:-threads}"
266
267 if ! use ${myflag}; then
268 echo
269 eerror "You need to enable USE flag '${myflag}' to build a thread-safe version"
270 eerror "of ${CATEGORY}/${PN} for use with www-servers/apache"
271 die "Need missing USE flag '${myflag}'"
272 fi
213} 273}
274
275# @FUNCTION: has_apache_threads_in
276# @USAGE: <myforeign> [myflag]
277# @DESCRIPTION:
278# An ebuild calls this to make sure thread-safety is enabled in a foreign
279# package if apache has been built with a threaded MPM. If the myflag parameter
280# is not given it defaults to threads.
281has_apache_threads_in() {
282 debug-print-function $FUNCNAME $*
283
284 if ! built_with_use www-servers/apache threads; then
285 return
286 fi
287
288 local myforeign="$1"
289 local myflag="${2:-threads}"
290
291 if ! built_with_use ${myforeign} ${myflag}; then
292 echo
293 eerror "You need to enable USE flag '${myflag}' in ${myforeign} to"
294 eerror "build a thread-safe version of ${CATEGORY}/${PN} for use"
295 eerror "with www-servers/apache"
296 die "Need missing USE flag '${myflag}' in ${myforeign}"
297 fi
298}
299
300EXPORT_FUNCTIONS pkg_setup

Legend:
Removed from v.1.23  
changed lines
  Added in v.1.45

  ViewVC Help
Powered by ViewVC 1.1.20