| 1 | # Copyright 1999-2003 Gentoo Technologies, Inc. |
1 | # Copyright 1999-2006 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/webapp.eclass,v 1.1 2003/10/07 21:54:46 stuart Exp $ |
3 | # $Header: /var/cvsroot/gentoo-x86/eclass/webapp.eclass,v 1.59 2008/02/23 23:54:40 hollow Exp $ |
| 4 | # |
4 | # |
| 5 | # eclass/webapp.eclass |
5 | # @ECLASS: webapp.eclass |
|
|
6 | # @MAINTAINER: |
|
|
7 | # web-apps@gentoo.org |
| 6 | # Eclass for installing applications to run under a web server |
8 | # @BLURB: functions for installing applications to run under a web server |
| 7 | # |
9 | # @DESCRIPTION: |
|
|
10 | # The webapp eclass contains functions to handle web applications with |
| 8 | # Part of the implementation of GLEP #11 |
11 | # webapp-config. Part of the implementation of GLEP #11 |
| 9 | # |
|
|
| 10 | # Author(s) Stuart Herbert <stuart@gentoo.org> |
|
|
| 11 | # |
|
|
| 12 | # ------------------------------------------------------------------------ |
|
|
| 13 | # |
|
|
| 14 | # Please do not make modifications to this file without checking with a |
|
|
| 15 | # member of the web-apps herd first! |
|
|
| 16 | # |
|
|
| 17 | # ------------------------------------------------------------------------ |
|
|
| 18 | # |
|
|
| 19 | # THIS IS A BETA RELEASE ONLY. ALL DETAILS ARE SUBJECT TO CHANGE BEFORE |
|
|
| 20 | # WE ARE READY TO START PORTING EVERYTHING TO THIS ECLASS |
|
|
| 21 | # |
|
|
| 22 | # ------------------------------------------------------------------------ |
|
|
| 23 | |
12 | |
| 24 | ECLASS=webapp |
13 | # @ECLASS-VARIABLE: WEBAPP_NO_AUTO_INSTALL |
| 25 | INHERITED="$INHERITED $ECLASS" |
14 | # @DESCRIPTION: |
| 26 | #DEPEND="${DEPEND} net-www/apache" |
15 | # An ebuild sets this to `yes' if an automatic installation and/or upgrade is |
|
|
16 | # not possible. The ebuild should overwrite pkg_postinst() and explain the |
|
|
17 | # reason for this BEFORE calling webapp_pkg_postinst(). |
|
|
18 | [[ "${WEBAPP_NO_AUTO_INSTALL}" == "yes" ]] || IUSE="vhosts" |
|
|
19 | |
| 27 | SLOT="${PVR}" |
20 | SLOT="${PVR}" |
| 28 | IUSE="$IUSE vhosts" |
21 | DEPEND=">=app-admin/webapp-config-1.50.15" |
|
|
22 | RDEPEND="${DEPEND}" |
| 29 | |
23 | |
| 30 | if [ -f /usr/share/webapp-config/settings.sh ] ; then |
24 | EXPORT_FUNCTIONS pkg_postinst pkg_setup src_install pkg_prerm |
| 31 | . /usr/share/webapp-config/settings.sh |
25 | |
|
|
26 | INSTALL_DIR="/${PN}" |
|
|
27 | IS_UPGRADE=0 |
|
|
28 | IS_REPLACE=0 |
|
|
29 | |
|
|
30 | INSTALL_CHECK_FILE="installed_by_webapp_eclass" |
|
|
31 | SETUP_CHECK_FILE="setup_by_webapp_eclass" |
|
|
32 | |
|
|
33 | ETC_CONFIG="${ROOT}etc/vhosts/webapp-config" |
|
|
34 | WEBAPP_CONFIG="${ROOT}usr/sbin/webapp-config" |
|
|
35 | WEBAPP_CLEANER="${ROOT}usr/sbin/webapp-cleaner" |
|
|
36 | |
|
|
37 | # ============================================================================== |
|
|
38 | # INTERNAL FUNCTIONS |
|
|
39 | # ============================================================================== |
|
|
40 | |
|
|
41 | # Load the config file /etc/vhosts/webapp-config |
|
|
42 | # Supports both the old bash version, and the new python version |
|
|
43 | webapp_read_config() { |
|
|
44 | debug-print-function $FUNCNAME $* |
|
|
45 | |
|
|
46 | if has_version '>=app-admin/webapp-config-1.50'; then |
|
|
47 | ENVVAR=$(${WEBAPP_CONFIG} --query ${PN} ${PVR}) || die "Could not read settings from webapp-config!" |
|
|
48 | eval ${ENVVAR} |
|
|
49 | else |
|
|
50 | . ${ETC_CONFIG} || die "Unable to read ${ETC_CONFIG}" |
| 32 | fi |
51 | fi |
|
|
52 | } |
| 33 | |
53 | |
| 34 | EXPORT_FUNCTIONS pkg_setup src_install |
|
|
| 35 | |
|
|
| 36 | # ------------------------------------------------------------------------ |
|
|
| 37 | # INTERNAL FUNCTION - USED BY THIS ECLASS ONLY |
|
|
| 38 | # |
|
|
| 39 | # Check whether a specified file exists within the image/ directory |
54 | # Check whether a specified file exists in the given directory (`.' by default) |
| 40 | # or not. |
|
|
| 41 | # |
|
|
| 42 | # @param $1 - file to look for |
|
|
| 43 | # @return 0 on success, never returns on an error |
|
|
| 44 | # ------------------------------------------------------------------------ |
|
|
| 45 | |
|
|
| 46 | function webapp_checkfileexists () |
55 | webapp_checkfileexists() { |
| 47 | { |
56 | debug-print-function $FUNCNAME $* |
| 48 | if [ ! -e ${D}/$1 ]; then |
57 | |
|
|
58 | local my_prefix=${2:+${2}/} |
|
|
59 | |
|
|
60 | if [[ ! -e "${my_prefix}${1}" ]]; then |
| 49 | msg="ebuild fault: file $1 not found in ${D}" |
61 | msg="ebuild fault: file '${1}' not found" |
| 50 | eerror "$msg" |
62 | eerror "$msg" |
| 51 | eerror "Please report this as a bug at http://bugs.gentoo.org/" |
63 | eerror "Please report this as a bug at http://bugs.gentoo.org/" |
| 52 | die "$msg" |
64 | die "$msg" |
| 53 | fi |
65 | fi |
| 54 | } |
66 | } |
| 55 | |
67 | |
| 56 | # ------------------------------------------------------------------------ |
68 | webapp_check_installedat() { |
| 57 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
69 | debug-print-function $FUNCNAME $* |
|
|
70 | ${WEBAPP_CONFIG} --show-installed -h localhost -d "${INSTALL_DIR}" 2> /dev/null |
|
|
71 | } |
|
|
72 | |
|
|
73 | webapp_strip_appdir() { |
|
|
74 | debug-print-function $FUNCNAME $* |
|
|
75 | echo "${1#${MY_APPDIR}/}" |
|
|
76 | } |
|
|
77 | |
|
|
78 | webapp_strip_d() { |
|
|
79 | debug-print-function $FUNCNAME $* |
|
|
80 | echo "${1#${D}}" |
|
|
81 | } |
|
|
82 | |
|
|
83 | webapp_strip_cwd() { |
|
|
84 | debug-print-function $FUNCNAME $* |
|
|
85 | echo "${1/#.\///}" |
|
|
86 | } |
|
|
87 | |
|
|
88 | webapp_getinstalltype() { |
|
|
89 | debug-print-function $FUNCNAME $* |
|
|
90 | |
|
|
91 | if ! has vhosts ${IUSE} || use vhosts; then |
|
|
92 | return |
|
|
93 | fi |
|
|
94 | |
|
|
95 | local my_output |
|
|
96 | my_output="$(webapp_check_installedat)" |
|
|
97 | |
|
|
98 | if [[ $? -eq 0 ]]; then |
|
|
99 | # something is already installed there |
|
|
100 | # make sure it isn't the same version |
|
|
101 | |
|
|
102 | local my_pn="$(echo ${my_output} | awk '{ print $1 }')" |
|
|
103 | local my_pvr="$(echo ${my_output} | awk '{ print $2 }')" |
|
|
104 | |
|
|
105 | REMOVE_PKG="${my_pn}-${my_pvr}" |
|
|
106 | |
|
|
107 | if [[ "${my_pn}" == "${PN}" ]]; then |
|
|
108 | if [[ "${my_pvr}" != "${PVR}" ]]; then |
|
|
109 | elog "This is an upgrade" |
|
|
110 | IS_UPGRADE=1 |
|
|
111 | else |
|
|
112 | elog "This is a re-installation" |
|
|
113 | IS_REPLACE=1 |
|
|
114 | fi |
|
|
115 | else |
|
|
116 | elog "${my_output} is installed there" |
|
|
117 | fi |
|
|
118 | else |
|
|
119 | elog "This is an installation" |
|
|
120 | fi |
|
|
121 | } |
|
|
122 | |
|
|
123 | # ============================================================================== |
|
|
124 | # PUBLIC FUNCTIONS |
|
|
125 | # ============================================================================== |
|
|
126 | |
|
|
127 | # @FUNCTION: need_httpd |
|
|
128 | # @DESCRIPTION: |
|
|
129 | # Call this function AFTER your ebuild's DEPEND line if any of the available |
|
|
130 | # webservers are able to run this application. |
|
|
131 | need_httpd() { |
|
|
132 | DEPEND="${DEPEND} |
|
|
133 | || ( virtual/httpd-basic virtual/httpd-cgi virtual/httpd-fastcgi )" |
|
|
134 | } |
|
|
135 | |
|
|
136 | # @FUNCTION: need_httpd_cgi |
|
|
137 | # @DESCRIPTION: |
|
|
138 | # Call this function AFTER your ebuild's DEPEND line if any of the available |
|
|
139 | # CGI-capable webservers are able to run this application. |
|
|
140 | need_httpd_cgi() { |
|
|
141 | DEPEND="${DEPEND} |
|
|
142 | || ( virtual/httpd-cgi virtual/httpd-fastcgi )" |
|
|
143 | } |
|
|
144 | |
|
|
145 | # @FUNCTION: need_httpd_fastcgi |
|
|
146 | # @DESCRIPTION: |
|
|
147 | # Call this function AFTER your ebuild's DEPEND line if any of the available |
|
|
148 | # FastCGI-capabale webservers are able to run this application. |
|
|
149 | need_httpd_fastcgi() { |
|
|
150 | DEPEND="${DEPEND} |
|
|
151 | virtual/httpd-fastcgi" |
|
|
152 | } |
|
|
153 | |
|
|
154 | # @FUNCTION: webapp_configfile |
|
|
155 | # @USAGE: <file> [more files ...] |
|
|
156 | # @DESCRIPTION: |
|
|
157 | # Mark a file config-protected for a web-based application. |
|
|
158 | webapp_configfile() { |
|
|
159 | debug-print-function $FUNCNAME $* |
|
|
160 | |
|
|
161 | local m |
|
|
162 | for m in "$@"; do |
|
|
163 | webapp_checkfileexists "${m}" "${D}" |
|
|
164 | |
|
|
165 | local my_file="$(webapp_strip_appdir "${m}")" |
|
|
166 | my_file="$(webapp_strip_cwd "${my_file}")" |
|
|
167 | |
|
|
168 | elog "(config) ${my_file}" |
|
|
169 | echo "${my_file}" >> ${D}/${WA_CONFIGLIST} |
|
|
170 | done |
|
|
171 | } |
|
|
172 | |
|
|
173 | # @FUNCTION: webapp_hook_script |
|
|
174 | # @USAGE: <file> |
|
|
175 | # @DESCRIPTION: |
|
|
176 | # Install a script that will run after a virtual copy is created, and |
|
|
177 | # before a virtual copy has been removed. |
|
|
178 | webapp_hook_script() { |
|
|
179 | debug-print-function $FUNCNAME $* |
|
|
180 | |
|
|
181 | webapp_checkfileexists "${1}" |
|
|
182 | |
|
|
183 | elog "(hook) ${1}" |
|
|
184 | cp "${1}" "${D}/${MY_HOOKSCRIPTSDIR}/$(basename "${1}")" || die "Unable to install ${1} into ${D}/${MY_HOOKSCRIPTSDIR}/" |
|
|
185 | chmod 555 "${D}/${MY_HOOKSCRIPTSDIR}/$(basename "${1}")" |
|
|
186 | } |
|
|
187 | |
|
|
188 | # @FUNCTION: webapp_postinst_txt |
|
|
189 | # @USAGE: <lang> <file> |
|
|
190 | # @DESCRIPTION: |
|
|
191 | # Install a text file containing post-installation instructions. |
|
|
192 | webapp_postinst_txt() { |
|
|
193 | debug-print-function $FUNCNAME $* |
|
|
194 | |
|
|
195 | webapp_checkfileexists "${2}" |
|
|
196 | |
|
|
197 | elog "(info) ${2} (lang: ${1})" |
|
|
198 | cp "${2}" "${D}/${MY_APPDIR}/postinst-${1}.txt" |
|
|
199 | } |
|
|
200 | |
|
|
201 | # @FUNCTION: webapp_postupgrade_txt |
|
|
202 | # @USAGE: <lang> <file> |
|
|
203 | # @DESCRIPTION: |
|
|
204 | # Install a text file containing post-upgrade instructions. |
|
|
205 | webapp_postupgrade_txt() { |
|
|
206 | debug-print-function $FUNCNAME $* |
|
|
207 | |
|
|
208 | webapp_checkfileexists "${2}" |
|
|
209 | |
|
|
210 | elog "(info) ${2} (lang: ${1})" |
|
|
211 | cp "${2}" "${D}/${MY_APPDIR}/postupgrade-${1}.txt" |
|
|
212 | } |
|
|
213 | |
|
|
214 | # helper for webapp_serverowned() |
|
|
215 | _webapp_serverowned() { |
|
|
216 | debug-print-function $FUNCNAME $* |
|
|
217 | |
|
|
218 | webapp_checkfileexists "${1}" "${D}" |
|
|
219 | local my_file="$(webapp_strip_appdir "${1}")" |
|
|
220 | my_file="$(webapp_strip_cwd "${my_file}")" |
|
|
221 | |
|
|
222 | elog "(server owned) ${my_file}" |
|
|
223 | echo "${my_file}" >> "${D}/${WA_SOLIST}" |
|
|
224 | } |
|
|
225 | |
|
|
226 | # @FUNCTION: webapp_serverowned |
|
|
227 | # @USAGE: [-R] <file> [more files ...] |
|
|
228 | # @DESCRIPTION: |
|
|
229 | # Identify a file which must be owned by the webserver's user:group settings. |
|
|
230 | # The ownership of the file is NOT set until the application is installed using |
|
|
231 | # the webapp-config tool. If -R is given directories are handled recursively. |
|
|
232 | webapp_serverowned() { |
|
|
233 | debug-print-function $FUNCNAME $* |
|
|
234 | |
|
|
235 | local a m |
|
|
236 | if [[ "${1}" == "-R" ]]; then |
|
|
237 | shift |
|
|
238 | for m in "$@"; do |
|
|
239 | find "${D}${m}" | while read a; do |
|
|
240 | a=$(webapp_strip_d "${a}") |
|
|
241 | _webapp_serverowned "${a}" |
|
|
242 | done |
|
|
243 | done |
|
|
244 | else |
|
|
245 | for m in "$@"; do |
|
|
246 | _webapp_serverowned "${m}" |
|
|
247 | done |
|
|
248 | fi |
|
|
249 | } |
|
|
250 | |
|
|
251 | # @FUNCTION: webapp_server_configfile |
|
|
252 | # @USAGE: <server> <file> [new name] |
|
|
253 | # @DESCRIPTION: |
|
|
254 | # Install a configuration file for the webserver. You need to specify a |
|
|
255 | # webapp-config supported <server>. if no new name is given `basename $2' is |
|
|
256 | # used by default. Note: this function will automagically prepend $1 to the |
|
|
257 | # front of your config file's name. |
|
|
258 | webapp_server_configfile() { |
|
|
259 | debug-print-function $FUNCNAME $* |
|
|
260 | |
|
|
261 | webapp_checkfileexists "${2}" |
|
|
262 | |
|
|
263 | # WARNING: |
|
|
264 | # |
|
|
265 | # do NOT change the naming convention used here without changing all |
|
|
266 | # the other scripts that also rely upon these names |
|
|
267 | |
|
|
268 | local my_file="${1}-${3:-$(basename "${2}")}" |
|
|
269 | |
|
|
270 | elog "(${1}) config file '${my_file}'" |
|
|
271 | cp "${2}" "${D}/${MY_SERVERCONFIGDIR}/${my_file}" |
|
|
272 | } |
|
|
273 | |
|
|
274 | # @FUNCTION: webapp_sqlscript |
|
|
275 | # @USAGE: <db> <file> [version] |
|
|
276 | # @DESCRIPTION: |
|
|
277 | # Install a SQL script that creates/upgrades a database schema for the web |
|
|
278 | # application. Currently supported database engines are mysql and postgres. |
|
|
279 | # If a version is given the script should upgrade the database schema from |
|
|
280 | # the given version to $PVR. |
|
|
281 | webapp_sqlscript() { |
|
|
282 | debug-print-function $FUNCNAME $* |
|
|
283 | |
|
|
284 | webapp_checkfileexists "${2}" |
|
|
285 | |
|
|
286 | dodir "${MY_SQLSCRIPTSDIR}/${1}" |
|
|
287 | |
|
|
288 | # WARNING: |
|
|
289 | # |
|
|
290 | # do NOT change the naming convention used here without changing all |
|
|
291 | # the other scripts that also rely upon these names |
|
|
292 | |
|
|
293 | if [[ -n "${3}" ]]; then |
|
|
294 | elog "(${1}) upgrade script for ${PN}-${3} to ${PVR}" |
|
|
295 | cp "${2}" "${D}${MY_SQLSCRIPTSDIR}/${1}/${3}_to_${PVR}.sql" |
|
|
296 | chmod 600 "${D}${MY_SQLSCRIPTSDIR}/${1}/${3}_to_${PVR}.sql" |
|
|
297 | else |
|
|
298 | elog "(${1}) create script for ${PN}-${PVR}" |
|
|
299 | cp "${2}" "${D}/${MY_SQLSCRIPTSDIR}/${1}/${PVR}_create.sql" |
|
|
300 | chmod 600 "${D}/${MY_SQLSCRIPTSDIR}/${1}/${PVR}_create.sql" |
|
|
301 | fi |
|
|
302 | } |
|
|
303 | |
|
|
304 | # @FUNCTION: webapp_src_preinst |
|
|
305 | # @DESCRIPTION: |
|
|
306 | # You need to call this function in src_install() BEFORE anything else has run. |
|
|
307 | # For now we just create required webapp-config directories. |
|
|
308 | webapp_src_preinst() { |
|
|
309 | debug-print-function $FUNCNAME $* |
|
|
310 | |
|
|
311 | dodir "${MY_HTDOCSDIR}" |
|
|
312 | dodir "${MY_HOSTROOTDIR}" |
|
|
313 | dodir "${MY_CGIBINDIR}" |
|
|
314 | dodir "${MY_ICONSDIR}" |
|
|
315 | dodir "${MY_ERRORSDIR}" |
|
|
316 | dodir "${MY_SQLSCRIPTSDIR}" |
|
|
317 | dodir "${MY_HOOKSCRIPTSDIR}" |
|
|
318 | dodir "${MY_SERVERCONFIGDIR}" |
|
|
319 | } |
|
|
320 | |
|
|
321 | # ============================================================================== |
|
|
322 | # EXPORTED FUNCTIONS |
|
|
323 | # ============================================================================== |
|
|
324 | |
|
|
325 | # @FUNCTION: webapp_pkg_setup |
|
|
326 | # @DESCRIPTION: |
|
|
327 | # The default pkg_setup() for this eclass. This will gather required variables |
|
|
328 | # from webapp-config and check if there is an application installed to |
|
|
329 | # `${ROOT}/var/www/localhost/htdocs/${PN}/' if USE=vhosts is not set. |
| 58 | # |
330 | # |
| 59 | # Identify a file which must be owned by the webserver's user:group |
331 | # You need to call this function BEFORE anything else has run in your custom |
| 60 | # settings. |
332 | # pkg_setup(). |
|
|
333 | webapp_pkg_setup() { |
|
|
334 | debug-print-function $FUNCNAME $* |
|
|
335 | |
|
|
336 | # to test whether or not the ebuild has correctly called this function |
|
|
337 | # we add an empty file to the filesystem |
|
|
338 | # |
|
|
339 | # we used to just set a variable in the shell script, but we can |
|
|
340 | # no longer rely on Portage calling both webapp_pkg_setup() and |
|
|
341 | # webapp_src_install() within the same shell process |
|
|
342 | touch "${T}/${SETUP_CHECK_FILE}" |
|
|
343 | |
|
|
344 | # special case - some ebuilds *do* need to overwride the SLOT |
|
|
345 | if [[ "${SLOT}+" != "${PVR}+" && "${WEBAPP_MANUAL_SLOT}" != "yes" ]]; then |
|
|
346 | die "Set WEBAPP_MANUAL_SLOT=\"yes\" if you need to SLOT manually" |
|
|
347 | fi |
|
|
348 | |
|
|
349 | # pull in the shared configuration file |
|
|
350 | G_HOSTNAME="localhost" |
|
|
351 | webapp_read_config |
|
|
352 | |
|
|
353 | local my_dir="${ROOT}${VHOST_ROOT}/${MY_HTDOCSBASE}/${PN}" |
|
|
354 | |
|
|
355 | # if USE=vhosts is enabled OR no application is installed we're done here |
|
|
356 | if ! has vhosts ${IUSE} || use vhosts || [[ ! -d "${my_dir}" ]]; then |
|
|
357 | return |
|
|
358 | fi |
|
|
359 | |
|
|
360 | local my_output |
|
|
361 | my_output="$(webapp_check_installedat)" |
|
|
362 | |
|
|
363 | if [[ $? -ne 0 ]]; then |
|
|
364 | # okay, whatever is there, it isn't webapp-config-compatible |
|
|
365 | echo |
|
|
366 | ewarn |
|
|
367 | ewarn "You already have something installed in ${my_dir}" |
|
|
368 | ewarn |
|
|
369 | ewarn "Whatever is in ${my_dir}, it's not" |
|
|
370 | ewarn "compatible with webapp-config." |
|
|
371 | ewarn |
|
|
372 | ewarn "This ebuild may be overwriting important files." |
|
|
373 | ewarn |
|
|
374 | echo |
|
|
375 | ebeep 10 |
|
|
376 | elif [[ "$(echo ${my_output} | awk '{ print $1 }')" != "${PN}" ]]; then |
|
|
377 | echo |
|
|
378 | eerror "You already have ${my_output} installed in ${my_dir}" |
|
|
379 | eerror |
|
|
380 | eerror "I cannot upgrade a different application" |
|
|
381 | eerror |
|
|
382 | echo |
|
|
383 | die "Cannot upgrade contents of ${my_dir}" |
|
|
384 | fi |
|
|
385 | |
|
|
386 | } |
|
|
387 | |
|
|
388 | # @FUNCTION: webapp_src_install |
|
|
389 | # @DESCRIPTION: |
|
|
390 | # This is the default src_install(). For now, we just make sure that root owns |
|
|
391 | # everything, and that there are no setuid files. |
| 61 | # |
392 | # |
| 62 | # The ownership of the file is NOT set until the application is installed |
393 | # You need to call this function AFTER everything else has run in your custom |
| 63 | # using the webapp-config tool. |
394 | # src_install(). |
| 64 | # |
395 | webapp_src_install() { |
| 65 | # @param $1 - file to be owned by the webserver user:group combo |
396 | debug-print-function $FUNCNAME $* |
|
|
397 | |
|
|
398 | # to test whether or not the ebuild has correctly called this function |
|
|
399 | # we add an empty file to the filesystem |
|
|
400 | # |
|
|
401 | # we used to just set a variable in the shell script, but we can |
|
|
402 | # no longer rely on Portage calling both webapp_src_install() and |
|
|
403 | # webapp_pkg_postinst() within the same shell process |
|
|
404 | touch "${D}/${MY_APPDIR}/${INSTALL_CHECK_FILE}" |
|
|
405 | |
|
|
406 | # sanity checks, to catch bugs in the ebuild |
|
|
407 | if [[ ! -f "${T}/${SETUP_CHECK_FILE}" ]]; then |
|
|
408 | eerror |
|
|
409 | eerror "This ebuild did not call webapp_pkg_setup() at the beginning" |
|
|
410 | eerror "of the pkg_setup() function" |
|
|
411 | eerror |
|
|
412 | eerror "Please log a bug on http://bugs.gentoo.org" |
|
|
413 | eerror |
|
|
414 | eerror "You should use emerge -C to remove this package, as the" |
|
|
415 | eerror "installation is incomplete" |
|
|
416 | eerror |
|
|
417 | die "Ebuild did not call webapp_pkg_setup() - report to http://bugs.gentoo.org" |
|
|
418 | fi |
|
|
419 | |
|
|
420 | chown -R "${VHOST_DEFAULT_UID}:${VHOST_DEFAULT_GID}" "${D}/" |
|
|
421 | chmod -R u-s "${D}/" |
|
|
422 | chmod -R g-s "${D}/" |
|
|
423 | |
|
|
424 | keepdir "${MY_PERSISTDIR}" |
|
|
425 | fowners "root:0" "${MY_PERSISTDIR}" |
|
|
426 | fperms 755 "${MY_PERSISTDIR}" |
|
|
427 | } |
|
|
428 | |
|
|
429 | # @FUNCTION: webapp_pkg_postinst |
|
|
430 | # @DESCRIPTION: |
|
|
431 | # The default pkg_postinst() for this eclass. This installs the web application to |
|
|
432 | # `${ROOT}/var/www/localhost/htdocs/${PN}/' if USE=vhosts is not set. Otherwise |
|
|
433 | # display a short notice how to install this application with webapp-config. |
| 66 | # |
434 | # |
| 67 | # ------------------------------------------------------------------------ |
435 | # You need to call this function AFTER everything else has run in your custom |
|
|
436 | # pkg_postinst(). |
|
|
437 | webapp_pkg_postinst() { |
|
|
438 | debug-print-function $FUNCNAME $* |
| 68 | |
439 | |
| 69 | function webapp_serverowned () |
440 | webapp_read_config |
| 70 | { |
|
|
| 71 | webapp_checkfileexists $1 |
|
|
| 72 | echo "$1" >> $WA_SOLIST |
|
|
| 73 | } |
|
|
| 74 | |
441 | |
| 75 | # ------------------------------------------------------------------------ |
442 | # sanity checks, to catch bugs in the ebuild |
| 76 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
443 | if [[ ! -f "${ROOT}${MY_APPDIR}/${INSTALL_CHECK_FILE}" ]]; then |
| 77 | # |
444 | eerror |
| 78 | # Identify a config file for a web-based application. |
445 | eerror "This ebuild did not call webapp_src_install() at the end" |
| 79 | # |
446 | eerror "of the src_install() function" |
| 80 | # @param $1 - config file |
447 | eerror |
| 81 | # ------------------------------------------------------------------------ |
448 | eerror "Please log a bug on http://bugs.gentoo.org" |
|
|
449 | eerror |
|
|
450 | eerror "You should use emerge -C to remove this package, as the" |
|
|
451 | eerror "installation is incomplete" |
|
|
452 | eerror |
|
|
453 | die "Ebuild did not call webapp_src_install() - report to http://bugs.gentoo.org" |
|
|
454 | fi |
| 82 | |
455 | |
| 83 | function webapp_configfile () |
456 | if has vhosts ${IUSE}; then |
| 84 | { |
457 | if ! use vhosts; then |
| 85 | webapp_checkfileexists $1 |
458 | echo |
| 86 | echo "$1" >> $WA_CONFIGLIST |
459 | elog "vhosts USE flag not set - auto-installing using webapp-config" |
| 87 | } |
|
|
| 88 | |
460 | |
| 89 | # ------------------------------------------------------------------------ |
461 | G_HOSTNAME="localhost" |
| 90 | # EXPORTED FUNCTION - FOR USE IN EBUILDS |
462 | webapp_read_config |
| 91 | # |
|
|
| 92 | # Identify a script file (usually, but not always PHP or Perl) which is |
|
|
| 93 | # |
|
|
| 94 | # Files in this list may be modified to #! the required CGI engine when |
|
|
| 95 | # installed by webapp-config tool in the future. |
|
|
| 96 | # |
|
|
| 97 | # @param $1 - the cgi engine to use |
|
|
| 98 | # @param $2 - the script file that could run under a cgi-bin |
|
|
| 99 | # |
|
|
| 100 | # ------------------------------------------------------------------------ |
|
|
| 101 | |
463 | |
| 102 | function webapp_runbycgibin () |
464 | local my_mode=-I |
| 103 | { |
465 | webapp_getinstalltype |
| 104 | webapp_checkfileexists $2 |
|
|
| 105 | echo "$1 $2" >> $WA_RUNBYCGIBINLIST |
|
|
| 106 | } |
|
|
| 107 | |
466 | |
| 108 | # ------------------------------------------------------------------------ |
467 | if [[ "${IS_REPLACE}" == "1" ]]; then |
| 109 | # EXPORTED FUNCTION - call from inside your ebuild's src_install AFTER |
468 | elog "${PN}-${PVR} is already installed - replacing" |
| 110 | # everything else has run |
469 | my_mode=-I |
| 111 | # |
470 | elif [[ "${IS_UPGRADE}" == "1" ]]; then |
| 112 | # For now, we just make sure that root owns everything, and that there |
471 | elog "${REMOVE_PKG} is already installed - upgrading" |
| 113 | # are no setuid files. I'm sure this will change significantly before |
472 | my_mode=-U |
| 114 | # the final version! |
473 | else |
| 115 | # ------------------------------------------------------------------------ |
474 | elog "${PN}-${PVR} is not installed - using install mode" |
|
|
475 | fi |
| 116 | |
476 | |
| 117 | function webapp_src_install () |
477 | my_cmd="${WEBAPP_CONFIG} ${my_mode} -h localhost -u root -d ${INSTALL_DIR} ${PN} ${PVR}" |
| 118 | { |
478 | elog "Running ${my_cmd}" |
| 119 | chown -R root:root ${D}/ |
479 | ${my_cmd} |
| 120 | chmod -R u-s ${D}/ |
|
|
| 121 | chmod -R g-s ${D}/ |
|
|
| 122 | } |
|
|
| 123 | |
480 | |
| 124 | # ------------------------------------------------------------------------ |
481 | echo |
| 125 | # EXPORTED FUNCTION - call from inside your ebuild's pkg_setup AFTER |
482 | local cleaner="${WEBAPP_CLEANER} -p -C ${PN}" |
| 126 | # everything else has run |
483 | einfo "Running ${cleaner}" |
| 127 | # |
484 | ${cleaner} |
| 128 | # If 'vhosts' USE flag is not set, auto-install this app |
485 | else |
| 129 | # |
486 | elog |
| 130 | # ------------------------------------------------------------------------ |
487 | elog "The 'vhosts' USE flag is switched ON" |
|
|
488 | elog "This means that Portage will not automatically run webapp-config to" |
|
|
489 | elog "complete the installation." |
|
|
490 | elog |
|
|
491 | elog "To install ${PN}-${PVR} into a virtual host, run the following command:" |
|
|
492 | elog |
|
|
493 | elog " webapp-config -I -h <host> -d ${PN} ${PN} ${PVR}" |
|
|
494 | elog |
|
|
495 | elog "For more details, see the webapp-config(8) man page" |
|
|
496 | fi |
|
|
497 | else |
|
|
498 | elog |
|
|
499 | elog "This ebuild does not support the 'vhosts' USE flag." |
|
|
500 | elog "This means that Portage will not automatically run webapp-config to" |
|
|
501 | elog "complete the installation." |
|
|
502 | elog |
|
|
503 | elog "To install ${PN}-${PVR} into a virtual host, run the following command:" |
|
|
504 | elog |
|
|
505 | elog " webapp-config -I -h <host> -d ${PN} ${PN} ${PVR}" |
|
|
506 | elog |
|
|
507 | elog "For more details, see the webapp-config(8) man page" |
|
|
508 | fi |
|
|
509 | } |
| 131 | |
510 | |
| 132 | function webapp_pkg_setup () |
511 | # @FUNCTION: webapp_pkg_prerm |
| 133 | { |
512 | # @DESCRIPTION: |
| 134 | use vhosts || webapp-config -u root -d /var/www/localhost/htdocs/${PN}/ ${PN} |
513 | # This is the default pkg_prerm() for this eclass. If USE=vhosts is not set |
|
|
514 | # remove all installed copies of this web application. Otherwise instruct the |
|
|
515 | # user to manually remove those copies. See bug #136959. |
|
|
516 | webapp_pkg_prerm() { |
|
|
517 | debug-print-function $FUNCNAME $* |
|
|
518 | |
|
|
519 | local my_output= |
|
|
520 | my_output="$(${WEBAPP_CONFIG} --list-installs ${PN} ${PVR})" |
|
|
521 | [[ $? -ne 0 ]] && return |
|
|
522 | |
|
|
523 | local x |
|
|
524 | if has vhosts ${IUSE} && ! use vhosts; then |
|
|
525 | echo "${my_output}" | while read x; do |
|
|
526 | if [[ -f "${x}"/.webapp ]]; then |
|
|
527 | . "${x}"/.webapp |
|
|
528 | if [[ -n "${WEB_HOSTNAME}" && -n "${WEB_INSTALLDIR}" ]]; then |
|
|
529 | ${WEBAPP_CONFIG} -C -h ${WEB_HOSTNAME} -d ${WEB_INSTALLDIR} |
|
|
530 | fi |
|
|
531 | else |
|
|
532 | ewarn "Cannot find file ${x}/.webapp" |
|
|
533 | fi |
|
|
534 | done |
|
|
535 | elif [[ "${my_output}" != "" ]]; then |
|
|
536 | echo |
|
|
537 | ewarn |
|
|
538 | ewarn "Don't forget to use webapp-config to remove any copies of" |
|
|
539 | ewarn "${PN}-${PVR} installed in" |
|
|
540 | ewarn |
|
|
541 | |
|
|
542 | echo "${my_output}" | while read x; do |
|
|
543 | if [[ -f "${x}"/.webapp ]]; then |
|
|
544 | ewarn " ${x}" |
|
|
545 | else |
|
|
546 | ewarn "Cannot find file ${x}/.webapp" |
|
|
547 | fi |
|
|
548 | done |
|
|
549 | |
|
|
550 | ewarn |
|
|
551 | echo |
|
|
552 | fi |
|
|
553 | } |