/[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.37 Revision 1.43
1# Copyright 1999-2007 Gentoo Foundation 1# Copyright 1999-2007 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.37 2008/02/02 14:31:42 hollow Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/depend.apache.eclass,v 1.43 2008/02/06 23:45:13 hollow Exp $
4 4
5# @ECLASS: depend.apache.eclass 5# @ECLASS: depend.apache.eclass
6# @MAINTAINER: apache-devs@gentoo.org 6# @MAINTAINER: apache-devs@gentoo.org
7# @BLURB: Functions to allow ebuilds to depend on apache 7# @BLURB: Functions to allow ebuilds to depend on apache
8# @DESCRIPTION: 8# @DESCRIPTION:
9# This eclass handles depending on apache in a sane way and providing 9# This eclass handles depending on apache in a sane way and provides information
10# information about where certain interfaces are located. 10# about where certain binaries and configuration files are located.
11# 11#
12# @NOTE: If you use this, be sure you use the need_* call after you have defined 12# To make use of this eclass simply call one of the need/want_apache functions
13# described below. Make sure you use the need/want_apache call after you have
13# DEPEND and RDEPEND. Also note that you can not rely on the automatic 14# defined DEPEND and RDEPEND. Also note that you can not rely on the automatic
14# RDEPEND=DEPEND that portage does if you use this eclass. 15# RDEPEND=DEPEND that portage does if you use this eclass.
15# 16#
16# See bug 107127 for more information. 17# See Bug 107127 for more information.
18#
19# @EXAMPLE:
20#
21# Here is an example of an ebuild depending on apache:
22#
23# @CODE
24# DEPEND="virtual/Perl-CGI"
25# RDEPEND="${DEPEND}"
26# need_apache2
27# @CODE
28#
29# Another example which demonstrates non-standard IUSE options for optional
30# apache support:
31#
32# @CODE
33# DEPEND="server? ( virtual/Perl-CGI )"
34# RDEPEND="${DEPEND}"
35# want_apache2 server
36# @CODE
17 37
18inherit multilib 38inherit multilib
19 39
20# ============================================================================== 40# ==============================================================================
21# INTERNAL VARIABLES 41# INTERNAL VARIABLES
22# ============================================================================== 42# ==============================================================================
23 43
24# @ECLASS-VARIABLE: APACHE_VERSION 44# @ECLASS-VARIABLE: APACHE_VERSION
25# @DESCRIPTION: 45# @DESCRIPTION:
26# Stores the version of apache we are going to be ebuilding. This variable is 46# Stores the version of apache we are going to be ebuilding.
27# set by the need_apache functions. 47# This variable is set by the want/need_apache functions.
28 48
29# @ECLASS-VARIABLE: APXS 49# @ECLASS-VARIABLE: APXS
30# @DESCRIPTION: 50# @DESCRIPTION:
31# Paths to the apxs tool 51# Path to the apxs tool.
52# This variable is set by the want/need_apache functions.
32 53
54# @ECLASS-VARIABLE: APACHE_BIN
55# @DESCRIPTION:
56# Path to the apache binary.
57# This variable is set by the want/need_apache functions.
58
33# @ECLASS-VARIABLE: APACHECTL 59# @ECLASS-VARIABLE: APACHE_CTL
34# @DESCRIPTION: 60# @DESCRIPTION:
35# Path to the apachectl tool 61# Path to the apachectl tool.
62# This variable is set by the want/need_apache functions.
36 63
37# @ECLASS-VARIABLE: APACHE_BASEDIR 64# @ECLASS-VARIABLE: APACHE_BASEDIR
38# @DESCRIPTION: 65# @DESCRIPTION:
39# Path to the server root directory 66# Path to the server root directory.
67# This variable is set by the want/need_apache functions.
40 68
41# @ECLASS-VARIABLE: APACHE_CONFDIR 69# @ECLASS-VARIABLE: APACHE_CONFDIR
42# @DESCRIPTION: 70# @DESCRIPTION:
43# Path to the configuration file directory 71# Path to the configuration file directory.
72# This variable is set by the want/need_apache functions.
44 73
45# @ECLASS-VARIABLE: APACHE_MODULES_CONFDIR 74# @ECLASS-VARIABLE: APACHE_MODULES_CONFDIR
46# @DESCRIPTION: 75# @DESCRIPTION:
47# Path where module configuration files are kept 76# Path where module configuration files are kept.
77# This variable is set by the want/need_apache functions.
48 78
49# @ECLASS-VARIABLE: APACHE_VHOSTS_CONFDIR 79# @ECLASS-VARIABLE: APACHE_VHOSTS_CONFDIR
50# @DESCRIPTION: 80# @DESCRIPTION:
51# Path where virtual host configuration files are kept 81# Path where virtual host configuration files are kept.
82# This variable is set by the want/need_apache functions.
52 83
53# @ECLASS-VARIABLE: APACHE_MODULESDIR 84# @ECLASS-VARIABLE: APACHE_MODULESDIR
54# @DESCRIPTION: 85# @DESCRIPTION:
55# Path where we install modules 86# Path where we install modules.
87# This variable is set by the want/need_apache functions.
56 88
57# @ECLASS-VARIABLE: APACHE_DEPEND 89# @ECLASS-VARIABLE: APACHE_DEPEND
58# @DESCRIPTION: 90# @DESCRIPTION:
59# Dependencies for Apache 91# Dependencies for Apache
60APACHE_DEPEND="www-servers/apache" 92APACHE_DEPEND="www-servers/apache"
66 98
67# @ECLASS-VARIABLE: APACHE2_2_DEPEND 99# @ECLASS-VARIABLE: APACHE2_2_DEPEND
68# @DESCRIPTION: 100# @DESCRIPTION:
69# Dependencies for Apache 2.2.x 101# Dependencies for Apache 2.2.x
70APACHE2_2_DEPEND="=www-servers/apache-2.2*" 102APACHE2_2_DEPEND="=www-servers/apache-2.2*"
71
72# @ECLASS-VARIABLE: WANT_APACHE_DEPEND
73# @DESCRIPTION:
74# Dependency magic based on useflag to use the right DEPEND
75WANT_APACHE_DEPEND="apache2? ( ${APACHE_DEPEND} )"
76
77# @ECLASS-VARIABLE: WANT_APACHE2_DEPEND
78# @DESCRIPTION:
79# Dependency magic based on useflag to use the right DEPEND
80WANT_APACHE2_DEPEND="apache2? ( ${APACHE2_DEPEND} )"
81
82# @ECLASS-VARIABLE: WANT_APACHE2_2_DEPEND
83# @DESCRIPTION:
84# Dependency magic based on useflag to use the right DEPEND
85WANT_APACHE2_2_DEPEND="apache2? ( ${APACHE2_2_DEPEND} )"
86 103
87# ============================================================================== 104# ==============================================================================
88# INTERNAL FUNCTIONS 105# INTERNAL FUNCTIONS
89# ============================================================================== 106# ==============================================================================
90 107
93 110
94 # WARNING: Do not use these variables with anything that is put 111 # WARNING: Do not use these variables with anything that is put
95 # into the dependency cache (DEPEND/RDEPEND/etc) 112 # into the dependency cache (DEPEND/RDEPEND/etc)
96 APACHE_VERSION="2" 113 APACHE_VERSION="2"
97 APXS="/usr/sbin/apxs2" 114 APXS="/usr/sbin/apxs2"
115 APACHE_BIN="/usr/sbin/apache2"
98 APACHECTL="/usr/sbin/apache2ctl" 116 APACHE_CTL="/usr/sbin/apache2ctl"
117 APACHE_INCLUDEDIR="/usr/include/apache2"
99 APACHE_BASEDIR="/usr/$(get_libdir)/apache2" 118 APACHE_BASEDIR="/usr/$(get_libdir)/apache2"
100 APACHE_CONFDIR="/etc/apache2" 119 APACHE_CONFDIR="/etc/apache2"
101 APACHE_MODULES_CONFDIR="${APACHE_CONFDIR}/modules.d" 120 APACHE_MODULES_CONFDIR="${APACHE_CONFDIR}/modules.d"
102 APACHE_VHOSTS_CONFDIR="${APACHE_CONFDIR}/vhosts.d" 121 APACHE_VHOSTS_CONFDIR="${APACHE_CONFDIR}/vhosts.d"
103 APACHE_MODULESDIR="${APACHE_BASEDIR}/modules" 122 APACHE_MODULESDIR="${APACHE_BASEDIR}/modules"
111# ============================================================================== 130# ==============================================================================
112# PUBLIC FUNCTIONS 131# PUBLIC FUNCTIONS
113# ============================================================================== 132# ==============================================================================
114 133
115# @FUNCTION: want_apache 134# @FUNCTION: want_apache
135# @USAGE: [myiuse]
136# @DESCRIPTION:
137# An ebuild calls this to get the dependency information for optional apache
138# support. If the myiuse parameter is not given it defaults to apache2.
139want_apache() {
140 debug-print-function $FUNCNAME $*
141 want_apache2 "$@"
142}
143
144# @FUNCTION: want_apache2
145# @USAGE: [myiuse]
116# @DESCRIPTION: 146# @DESCRIPTION:
117# An ebuild calls this to get the dependency information for optional apache-2.x 147# An ebuild calls this to get the dependency information for optional apache-2.x
118# support. 148# support. If the myiuse parameter is not given it defaults to apache2.
119want_apache2() { 149want_apache2() {
120 debug-print-function $FUNCNAME $* 150 debug-print-function $FUNCNAME $*
121 151
122 IUSE="${IUSE} apache2" 152 local myiuse=${1:-apache2}
153 IUSE="${IUSE} ${myiuse}"
123 DEPEND="${DEPEND} ${WANT_APACHE2_DEPEND}" 154 DEPEND="${DEPEND} ${myiuse}? ( ${APACHE2_DEPEND} )"
124 RDEPEND="${RDEPEND} ${WANT_APACHE2_DEPEND}" 155 RDEPEND="${RDEPEND} ${myiuse}? ( ${APACHE2_DEPEND} )"
125 156
126 if use apache2 ; then 157 if use ${myiuse} ; then
127 _init_apache2 158 _init_apache2
128 else 159 else
129 _init_no_apache 160 _init_no_apache
130 fi 161 fi
131} 162}
132 163
133# @FUNCTION: want_apache 164# @FUNCTION: want_apache2_2
165# @USAGE: [myiuse]
134# @DESCRIPTION: 166# @DESCRIPTION:
135# An ebuild calls this to get the dependency information for optional 167# An ebuild calls this to get the dependency information for optional
136# apache-2.2.x support. 168# apache-2.2.x support. If the myiuse parameter is not given it defaults to
169# apache2.
137want_apache2_2() { 170want_apache2_2() {
138 debug-print-function $FUNCNAME $* 171 debug-print-function $FUNCNAME $*
139 172
140 IUSE="${IUSE} apache2" 173 local myiuse=${1:-apache2}
174 IUSE="${IUSE} ${myiuse}"
141 DEPEND="${DEPEND} ${WANT_APACHE2_2_DEPEND}" 175 DEPEND="${DEPEND} ${myiuse}? ( ${APACHE2_2_DEPEND} )"
142 RDEPEND="${RDEPEND} ${WANT_APACHE2_2_DEPEND}" 176 RDEPEND="${RDEPEND} ${myiuse}? ( ${APACHE2_2_DEPEND} )"
143 177
144 if use apache2 ; then 178 if use ${myiuse} ; then
145 _init_apache2 179 _init_apache2
146 else 180 else
147 _init_no_apache 181 _init_no_apache
148 fi 182 fi
149} 183}
150 184
151# @FUNCTION: want_apache 185# @FUNCTION: need_apache
152# @DESCRIPTION: 186# @DESCRIPTION:
153# An ebuild calls this to get the dependency information for optional apache 187# An ebuild calls this to get the dependency information for apache.
154# support.
155want_apache() { 188need_apache() {
189 debug-print-function $FUNCNAME $*
156 want_apache2 190 need_apache2
157} 191}
158 192
159# @FUNCTION: need_apache2 193# @FUNCTION: need_apache2
160# @DESCRIPTION: 194# @DESCRIPTION:
161# Works like need_apache, but its used by modules that only support 195# An ebuild calls this to get the dependency information for apache-2.x.
162# apache 2.x and do not work with other versions.
163need_apache2() { 196need_apache2() {
164 debug-print-function $FUNCNAME $* 197 debug-print-function $FUNCNAME $*
165 198
166 DEPEND="${DEPEND} ${APACHE2_DEPEND}" 199 DEPEND="${DEPEND} ${APACHE2_DEPEND}"
167 RDEPEND="${RDEPEND} ${APACHE2_DEPEND}" 200 RDEPEND="${RDEPEND} ${APACHE2_DEPEND}"
168 _init_apache2 201 _init_apache2
169} 202}
170 203
171# @FUNCTION: need_apache2_2 204# @FUNCTION: need_apache2_2
172# @DESCRIPTION: 205# @DESCRIPTION:
173# Works like need_apache, but its used by modules that only support 206# An ebuild calls this to get the dependency information for apache-2.2.x.
174# apache 2.2.x and do not work with other versions.
175need_apache2_2() { 207need_apache2_2() {
176 debug-print-function $FUNCNAME $* 208 debug-print-function $FUNCNAME $*
177 209
178 DEPEND="${DEPEND} ${APACHE2_2_DEPEND}" 210 DEPEND="${DEPEND} ${APACHE2_2_DEPEND}"
179 RDEPEND="${RDEPEND} ${APACHE2_2_DEPEND}" 211 RDEPEND="${RDEPEND} ${APACHE2_2_DEPEND}"
180 _init_apache2 212 _init_apache2
181} 213}
182 214
183# @FUNCTION: need_apache 215# @FUNCTION: has_apache_threads
216# @USAGE: [myflag]
184# @DESCRIPTION: 217# @DESCRIPTION:
185# An ebuild calls this to get the dependency information for apache. An 218# An ebuild calls this to make sure thread-safety is enabled if apache has been
186# ebuild should use this in order for future changes to the build infrastructure 219# built with a threaded MPM. If the myflag parameter is not given it defaults to
187# to happen seamlessly. All an ebuild needs to do is include the line 220# threads.
188# need_apache somewhere. 221has_apache_threads() {
189need_apache() { 222 debug-print-function $FUNCNAME $*
190 need_apache2 223
224 if ! built_with_use www-servers/apache threads ; then
225 return
226 fi
227
228 local myflag="${1:-threads}"
229
230 if ! use ${myflag} ; then
231 echo
232 eerror "You need to enable USE flag '${myflag}' to build a thread-safe version"
233 eerror "of ${CATEGORY}/${PN} for use with www-servers/apache"
234 die "Need missing USE flag '${myflag}'"
235 fi
191} 236}
237
238# @FUNCTION: has_apache_threads_in
239# @USAGE: <myforeign> [myflag]
240# @DESCRIPTION:
241# An ebuild calls this to make sure thread-safety is enabled in a foreign
242# package if apache has been built with a threaded MPM. If the myflag parameter
243# is not given it defaults to threads.
244has_apache_threads_in() {
245 debug-print-function $FUNCNAME $*
246
247 if ! built_with_use www-servers/apache threads ; then
248 return
249 fi
250
251 local myforeign="$1"
252 local myflag="${2:-threads}"
253
254 if ! built_with_use ${myforeign} ${myflag} ; then
255 echo
256 eerror "You need to enable USE flag '${myflag}' in ${myforeign} to"
257 eerror "build a thread-safe version of ${CATEGORY}/${PN} for use"
258 eerror "with www-servers/apache"
259 die "Need missing USE flag '${myflag}' in ${myforeign}"
260 fi
261}

Legend:
Removed from v.1.37  
changed lines
  Added in v.1.43

  ViewVC Help
Powered by ViewVC 1.1.20