/[gentoo-x86]/eclass/eutils.eclass
Gentoo

Diff of /eclass/eutils.eclass

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

Revision 1.301 Revision 1.443
1# Copyright 1999-2007 Gentoo Foundation 1# Copyright 1999-2015 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/eutils.eclass,v 1.301 2008/04/05 22:38:26 zmedico Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/eutils.eclass,v 1.443 2015/03/20 18:22:05 vapier Exp $
4 4
5# @ECLASS: eutils.eclass 5# @ECLASS: eutils.eclass
6# @MAINTAINER: 6# @MAINTAINER:
7# base-system@gentoo.org 7# base-system@gentoo.org
8# @BLURB: many extra (but common) functions that are used in ebuilds 8# @BLURB: many extra (but common) functions that are used in ebuilds
13# home rather than having multiple ebuilds implementing the same thing. 13# home rather than having multiple ebuilds implementing the same thing.
14# 14#
15# Due to the nature of this eclass, some functions may have maintainers 15# Due to the nature of this eclass, some functions may have maintainers
16# different from the overall eclass! 16# different from the overall eclass!
17 17
18inherit multilib portability 18if [[ -z ${_EUTILS_ECLASS} ]]; then
19_EUTILS_ECLASS=1
19 20
20DESCRIPTION="Based on the ${ECLASS} eclass" 21inherit multilib toolchain-funcs
22
23if has "${EAPI:-0}" 0 1 2; then
21 24
22# @FUNCTION: epause 25# @FUNCTION: epause
23# @USAGE: [seconds] 26# @USAGE: [seconds]
24# @DESCRIPTION: 27# @DESCRIPTION:
25# Sleep for the specified number of seconds (default of 5 seconds). Useful when 28# Sleep for the specified number of seconds (default of 5 seconds). Useful when
26# printing a message the user should probably be reading and often used in 29# printing a message the user should probably be reading and often used in
27# conjunction with the ebeep function. If the EPAUSE_IGNORE env var is set, 30# conjunction with the ebeep function. If the EPAUSE_IGNORE env var is set,
28# don't wait at all. 31# don't wait at all. Defined in EAPIs 0 1 and 2.
29epause() { 32epause() {
30 [[ -z ${EPAUSE_IGNORE} ]] && sleep ${1:-5} 33 [[ -z ${EPAUSE_IGNORE} ]] && sleep ${1:-5}
31} 34}
32 35
33# @FUNCTION: ebeep 36# @FUNCTION: ebeep
34# @USAGE: [number of beeps] 37# @USAGE: [number of beeps]
35# @DESCRIPTION: 38# @DESCRIPTION:
36# Issue the specified number of beeps (default of 5 beeps). Useful when 39# Issue the specified number of beeps (default of 5 beeps). Useful when
37# printing a message the user should probably be reading and often used in 40# printing a message the user should probably be reading and often used in
38# conjunction with the epause function. If the EBEEP_IGNORE env var is set, 41# conjunction with the epause function. If the EBEEP_IGNORE env var is set,
39# don't beep at all. 42# don't beep at all. Defined in EAPIs 0 1 and 2.
40ebeep() { 43ebeep() {
41 local n 44 local n
42 if [[ -z ${EBEEP_IGNORE} ]] ; then 45 if [[ -z ${EBEEP_IGNORE} ]] ; then
43 for ((n=1 ; n <= ${1:-5} ; n++)) ; do 46 for ((n=1 ; n <= ${1:-5} ; n++)) ; do
44 echo -ne "\a" 47 echo -ne "\a"
47 sleep 1 50 sleep 1
48 done 51 done
49 fi 52 fi
50} 53}
51 54
55else
56
57ebeep() {
58 ewarn "QA Notice: ebeep is not defined in EAPI=${EAPI}, please file a bug at http://bugs.gentoo.org"
59}
60
61epause() {
62 ewarn "QA Notice: epause is not defined in EAPI=${EAPI}, please file a bug at http://bugs.gentoo.org"
63}
64
65fi
66
67# @FUNCTION: eqawarn
68# @USAGE: [message]
69# @DESCRIPTION:
70# Proxy to ewarn for package managers that don't provide eqawarn and use the PM
71# implementation if available. Reuses PORTAGE_ELOG_CLASSES as set by the dev
72# profile.
73if ! declare -F eqawarn >/dev/null ; then
74 eqawarn() {
75 has qa ${PORTAGE_ELOG_CLASSES} && ewarn "$@"
76 :
77 }
78fi
79
52# @FUNCTION: ecvs_clean 80# @FUNCTION: ecvs_clean
53# @USAGE: [list of dirs] 81# @USAGE: [list of dirs]
54# @DESCRIPTION: 82# @DESCRIPTION:
55# Remove CVS directories recursiveley. Useful when a source tarball contains 83# Remove CVS directories recursiveley. Useful when a source tarball contains
56# internal CVS directories. Defaults to $PWD. 84# internal CVS directories. Defaults to $PWD.
68esvn_clean() { 96esvn_clean() {
69 [[ -z $* ]] && set -- . 97 [[ -z $* ]] && set -- .
70 find "$@" -type d -name '.svn' -prune -print0 | xargs -0 rm -rf 98 find "$@" -type d -name '.svn' -prune -print0 | xargs -0 rm -rf
71} 99}
72 100
73# Default directory where patches are located 101# @FUNCTION: estack_push
102# @USAGE: <stack> [items to push]
103# @DESCRIPTION:
104# Push any number of items onto the specified stack. Pick a name that
105# is a valid variable (i.e. stick to alphanumerics), and push as many
106# items as you like onto the stack at once.
107#
108# The following code snippet will echo 5, then 4, then 3, then ...
109# @CODE
110# estack_push mystack 1 2 3 4 5
111# while estack_pop mystack i ; do
112# echo "${i}"
113# done
114# @CODE
115estack_push() {
116 [[ $# -eq 0 ]] && die "estack_push: incorrect # of arguments"
117 local stack_name="_ESTACK_$1_" ; shift
118 eval ${stack_name}+=\( \"\$@\" \)
119}
120
121# @FUNCTION: estack_pop
122# @USAGE: <stack> [variable]
123# @DESCRIPTION:
124# Pop a single item off the specified stack. If a variable is specified,
125# the popped item is stored there. If no more items are available, return
126# 1, else return 0. See estack_push for more info.
127estack_pop() {
128 [[ $# -eq 0 || $# -gt 2 ]] && die "estack_pop: incorrect # of arguments"
129
130 # We use the fugly _estack_xxx var names to avoid collision with
131 # passing back the return value. If we used "local i" and the
132 # caller ran `estack_pop ... i`, we'd end up setting the local
133 # copy of "i" rather than the caller's copy. The _estack_xxx
134 # garbage is preferable to using $1/$2 everywhere as that is a
135 # bit harder to read.
136 local _estack_name="_ESTACK_$1_" ; shift
137 local _estack_retvar=$1 ; shift
138 eval local _estack_i=\${#${_estack_name}\[@\]}
139 # Don't warn -- let the caller interpret this as a failure
140 # or as normal behavior (akin to `shift`)
141 [[ $(( --_estack_i )) -eq -1 ]] && return 1
142
143 if [[ -n ${_estack_retvar} ]] ; then
144 eval ${_estack_retvar}=\"\${${_estack_name}\[${_estack_i}\]}\"
145 fi
146 eval unset ${_estack_name}\[${_estack_i}\]
147}
148
149# @FUNCTION: evar_push
150# @USAGE: <variable to save> [more vars to save]
151# @DESCRIPTION:
152# This let's you temporarily modify a variable and then restore it (including
153# set vs unset semantics). Arrays are not supported at this time.
154#
155# This is meant for variables where using `local` does not work (such as
156# exported variables, or only temporarily changing things in a func).
157#
158# For example:
159# @CODE
160# evar_push LC_ALL
161# export LC_ALL=C
162# ... do some stuff that needs LC_ALL=C set ...
163# evar_pop
164#
165# # You can also save/restore more than one var at a time
166# evar_push BUTTERFLY IN THE SKY
167# ... do stuff with the vars ...
168# evar_pop # This restores just one var, SKY
169# ... do more stuff ...
170# evar_pop 3 # This pops the remaining 3 vars
171# @CODE
172evar_push() {
173 local var val
174 for var ; do
175 [[ ${!var+set} == "set" ]] \
176 && val=${!var} \
177 || val="unset_76fc3c462065bb4ca959f939e6793f94"
178 estack_push evar "${var}" "${val}"
179 done
180}
181
182# @FUNCTION: evar_push_set
183# @USAGE: <variable to save> [new value to store]
184# @DESCRIPTION:
185# This is a handy shortcut to save and temporarily set a variable. If a value
186# is not specified, the var will be unset.
187evar_push_set() {
188 local var=$1
189 evar_push ${var}
190 case $# in
191 1) unset ${var} ;;
192 2) printf -v "${var}" '%s' "$2" ;;
193 *) die "${FUNCNAME}: incorrect # of args: $*" ;;
194 esac
195}
196
197# @FUNCTION: evar_pop
198# @USAGE: [number of vars to restore]
199# @DESCRIPTION:
200# Restore the variables to the state saved with the corresponding
201# evar_push call. See that function for more details.
202evar_pop() {
203 local cnt=${1:-bad}
204 case $# in
205 0) cnt=1 ;;
206 1) isdigit "${cnt}" || die "${FUNCNAME}: first arg must be a number: $*" ;;
207 *) die "${FUNCNAME}: only accepts one arg: $*" ;;
208 esac
209
210 local var val
211 while (( cnt-- )) ; do
212 estack_pop evar val || die "${FUNCNAME}: unbalanced push"
213 estack_pop evar var || die "${FUNCNAME}: unbalanced push"
214 [[ ${val} == "unset_76fc3c462065bb4ca959f939e6793f94" ]] \
215 && unset ${var} \
216 || printf -v "${var}" '%s' "${val}"
217 done
218}
219
220# @FUNCTION: eshopts_push
221# @USAGE: [options to `set` or `shopt`]
222# @DESCRIPTION:
223# Often times code will want to enable a shell option to change code behavior.
224# Since changing shell options can easily break other pieces of code (which
225# assume the default state), eshopts_push is used to (1) push the current shell
226# options onto a stack and (2) pass the specified arguments to set.
227#
228# If the first argument is '-s' or '-u', we assume you want to call `shopt`
229# rather than `set` as there are some options only available via that.
230#
231# A common example is to disable shell globbing so that special meaning/care
232# may be used with variables/arguments to custom functions. That would be:
233# @CODE
234# eshopts_push -o noglob
235# for x in ${foo} ; do
236# if ...some check... ; then
237# eshopts_pop
238# return 0
239# fi
240# done
241# eshopts_pop
242# @CODE
243eshopts_push() {
244 if [[ $1 == -[su] ]] ; then
245 estack_push eshopts "$(shopt -p)"
246 [[ $# -eq 0 ]] && return 0
247 shopt "$@" || die "${FUNCNAME}: bad options to shopt: $*"
248 else
249 estack_push eshopts $-
250 [[ $# -eq 0 ]] && return 0
251 set "$@" || die "${FUNCNAME}: bad options to set: $*"
252 fi
253}
254
255# @FUNCTION: eshopts_pop
256# @USAGE:
257# @DESCRIPTION:
258# Restore the shell options to the state saved with the corresponding
259# eshopts_push call. See that function for more details.
260eshopts_pop() {
261 local s
262 estack_pop eshopts s || die "${FUNCNAME}: unbalanced push"
263 if [[ ${s} == "shopt -"* ]] ; then
264 eval "${s}" || die "${FUNCNAME}: sanity: invalid shopt options: ${s}"
265 else
266 set +$- || die "${FUNCNAME}: sanity: invalid shell settings: $-"
267 set -${s} || die "${FUNCNAME}: sanity: unable to restore saved shell settings: ${s}"
268 fi
269}
270
271# @FUNCTION: eumask_push
272# @USAGE: <new umask>
273# @DESCRIPTION:
274# Set the umask to the new value specified while saving the previous
275# value onto a stack. Useful for temporarily changing the umask.
276eumask_push() {
277 estack_push eumask "$(umask)"
278 umask "$@" || die "${FUNCNAME}: bad options to umask: $*"
279}
280
281# @FUNCTION: eumask_pop
282# @USAGE:
283# @DESCRIPTION:
284# Restore the previous umask state.
285eumask_pop() {
286 [[ $# -eq 0 ]] || die "${FUNCNAME}: we take no options"
287 local s
288 estack_pop eumask s || die "${FUNCNAME}: unbalanced push"
289 umask ${s} || die "${FUNCNAME}: sanity: could not restore umask: ${s}"
290}
291
292# @FUNCTION: isdigit
293# @USAGE: <number> [more numbers]
294# @DESCRIPTION:
295# Return true if all arguments are numbers.
296isdigit() {
297 local d
298 for d ; do
299 [[ ${d:-bad} == *[!0-9]* ]] && return 1
300 done
301 return 0
302}
303
304# @VARIABLE: EPATCH_SOURCE
305# @DESCRIPTION:
306# Default directory to search for patches.
74EPATCH_SOURCE="${WORKDIR}/patch" 307EPATCH_SOURCE="${WORKDIR}/patch"
75# Default extension for patches 308# @VARIABLE: EPATCH_SUFFIX
309# @DESCRIPTION:
310# Default extension for patches (do not prefix the period yourself).
76EPATCH_SUFFIX="patch.bz2" 311EPATCH_SUFFIX="patch.bz2"
77# Default options for patch 312# @VARIABLE: EPATCH_OPTS
313# @DESCRIPTION:
314# Options to pass to patch. Meant for ebuild/package-specific tweaking
315# such as forcing the patch level (-p#) or fuzz (-F#) factor. Note that
316# for single patch tweaking, you can also pass flags directly to epatch.
317EPATCH_OPTS=""
318# @VARIABLE: EPATCH_COMMON_OPTS
319# @DESCRIPTION:
320# Common options to pass to `patch`. You probably should never need to
321# change these. If you do, please discuss it with base-system first to
322# be sure.
323# @CODE
78# Set -g0 to keep RCS, ClearCase, Perforce and SCCS happy. Bug #24571 324# -g0 - keep RCS, ClearCase, Perforce and SCCS happy #24571
79# Set --no-backup-if-mismatch so we don't leave '.orig' files behind. 325# --no-backup-if-mismatch - do not leave .orig files behind
80# Set -E to automatically remove empty files. 326# -E - automatically remove empty files
327# @CODE
81EPATCH_OPTS="-g0 -E --no-backup-if-mismatch" 328EPATCH_COMMON_OPTS="-g0 -E --no-backup-if-mismatch"
329# @VARIABLE: EPATCH_EXCLUDE
330# @DESCRIPTION:
82# List of patches not to apply. Not this is only file names, 331# List of patches not to apply. Note this is only file names,
83# and not the full path .. 332# and not the full path. Globs accepted.
84EPATCH_EXCLUDE="" 333EPATCH_EXCLUDE=""
334# @VARIABLE: EPATCH_SINGLE_MSG
335# @DESCRIPTION:
85# Change the printed message for a single patch. 336# Change the printed message for a single patch.
86EPATCH_SINGLE_MSG="" 337EPATCH_SINGLE_MSG=""
338# @VARIABLE: EPATCH_MULTI_MSG
339# @DESCRIPTION:
87# Change the printed message for multiple patches. 340# Change the printed message for multiple patches.
88EPATCH_MULTI_MSG="Applying various patches (bugfixes/updates) ..." 341EPATCH_MULTI_MSG="Applying various patches (bugfixes/updates) ..."
89# Force applying bulk patches even if not following the style: 342# @VARIABLE: EPATCH_FORCE
90# 343# @DESCRIPTION:
91# ??_${ARCH}_foo.${EPATCH_SUFFIX} 344# Only require patches to match EPATCH_SUFFIX rather than the extended
92# 345# arch naming style.
93EPATCH_FORCE="no" 346EPATCH_FORCE="no"
347# @VARIABLE: EPATCH_USER_EXCLUDE
348# @DEFAULT_UNSET
349# @DESCRIPTION:
350# List of patches not to apply. Note this is only file names,
351# and not the full path. Globs accepted.
94 352
95# This function is for bulk patching, or in theory for just one 353# @FUNCTION: epatch
96# or two patches. 354# @USAGE: [options] [patches] [dirs of patches]
355# @DESCRIPTION:
356# epatch is designed to greatly simplify the application of patches. It can
357# process patch files directly, or directories of patches. The patches may be
358# compressed (bzip/gzip/etc...) or plain text. You generally need not specify
359# the -p option as epatch will automatically attempt -p0 to -p4 until things
360# apply successfully.
97# 361#
98# It should work with .bz2, .gz, .zip and plain text patches. 362# If you do not specify any patches/dirs, then epatch will default to the
99# Currently all patches should be the same format. 363# directory specified by EPATCH_SOURCE.
100# 364#
101# You do not have to specify '-p' option to patch, as it will 365# Any options specified that start with a dash will be passed down to patch
102# try with -p0 to -p5 until it succeed, or fail at -p5. 366# for this specific invocation. As soon as an arg w/out a dash is found, then
367# arg processing stops.
103# 368#
104# Above EPATCH_* variables can be used to control various defaults, 369# When processing directories, epatch will apply all patches that match:
105# bug they should be left as is to ensure an ebuild can rely on 370# @CODE
106# them for. 371# if ${EPATCH_FORCE} != "yes"
107#
108# Patches are applied in current directory.
109#
110# Bulk Patches should preferibly have the form of:
111#
112# ??_${ARCH}_foo.${EPATCH_SUFFIX} 372# ??_${ARCH}_foo.${EPATCH_SUFFIX}
373# else
374# *.${EPATCH_SUFFIX}
375# @CODE
376# The leading ?? are typically numbers used to force consistent patch ordering.
377# The arch field is used to apply patches only for the host architecture with
378# the special value of "all" means apply for everyone. Note that using values
379# other than "all" is highly discouraged -- you should apply patches all the
380# time and let architecture details be detected at configure/compile time.
113# 381#
114# For example: 382# If EPATCH_SUFFIX is empty, then no period before it is implied when searching
383# for patches to apply.
115# 384#
116# 01_all_misc-fix.patch.bz2 385# Refer to the other EPATCH_xxx variables for more customization of behavior.
117# 02_sparc_another-fix.patch.bz2
118#
119# This ensures that there are a set order, and you can have ARCH
120# specific patches.
121#
122# If you however give an argument to epatch(), it will treat it as a
123# single patch that need to be applied if its a file. If on the other
124# hand its a directory, it will set EPATCH_SOURCE to this.
125#
126# <azarah@gentoo.org> (10 Nov 2002)
127#
128epatch() { 386epatch() {
129 _epatch_draw_line() { 387 _epatch_draw_line() {
388 # create a line of same length as input string
130 [[ -z $1 ]] && set "$(printf "%65s" '')" 389 [[ -z $1 ]] && set "$(printf "%65s" '')"
131 echo "${1//?/=}" 390 echo "${1//?/=}"
132 } 391 }
133 _epatch_assert() { local _pipestatus=${PIPESTATUS[*]}; [[ ${_pipestatus// /} -eq 0 ]] ; }
134 local PIPE_CMD=""
135 local STDERR_TARGET="${T}/$$.out"
136 local PATCH_TARGET="${T}/$$.patch"
137 local PATCH_SUFFIX=""
138 local SINGLE_PATCH="no"
139 local x=""
140 392
141 unset P4CONFIG P4PORT P4USER # keep perforce at bay #56402 393 unset P4CONFIG P4PORT P4USER # keep perforce at bay #56402
142 394
143 if [ "$#" -gt 1 ] 395 # First process options. We localize the EPATCH_OPTS setting
144 then 396 # from above so that we can pass it on in the loop below with
397 # any additional values the user has specified.
398 local EPATCH_OPTS=( ${EPATCH_OPTS[*]} )
399 while [[ $# -gt 0 ]] ; do
400 case $1 in
401 -*) EPATCH_OPTS+=( "$1" ) ;;
402 *) break ;;
403 esac
404 shift
405 done
406
407 # Let the rest of the code process one user arg at a time --
408 # each arg may expand into multiple patches, and each arg may
409 # need to start off with the default global EPATCH_xxx values
410 if [[ $# -gt 1 ]] ; then
145 local m="" 411 local m
146 for m in "$@" ; do 412 for m in "$@" ; do
147 epatch "${m}" 413 epatch "${m}"
148 done 414 done
149 return 0 415 return 0
150 fi 416 fi
151 417
152 if [ -n "$1" -a -f "$1" ] 418 local SINGLE_PATCH="no"
153 then 419 # no args means process ${EPATCH_SOURCE}
420 [[ $# -eq 0 ]] && set -- "${EPATCH_SOURCE}"
421
422 if [[ -f $1 ]] ; then
154 SINGLE_PATCH="yes" 423 SINGLE_PATCH="yes"
155 424 set -- "$1"
156 local EPATCH_SOURCE="$1" 425 # Use the suffix from the single patch (localize it); the code
426 # below will find the suffix for us
157 local EPATCH_SUFFIX="${1##*\.}" 427 local EPATCH_SUFFIX=$1
158 428
159 elif [ -n "$1" -a -d "$1" ] 429 elif [[ -d $1 ]] ; then
160 then 430 # We have to force sorting to C so that the wildcard expansion is consistent #471666.
161 # Allow no extension if EPATCH_FORCE=yes ... used by vim for example ... 431 evar_push_set LC_COLLATE C
162 if [ "${EPATCH_FORCE}" = "yes" ] && [ -z "${EPATCH_SUFFIX}" ] 432 # Some people like to make dirs of patches w/out suffixes (vim).
433 set -- "$1"/*${EPATCH_SUFFIX:+."${EPATCH_SUFFIX}"}
434 evar_pop
435
436 elif [[ -f ${EPATCH_SOURCE}/$1 ]] ; then
437 # Re-use EPATCH_SOURCE as a search dir
438 epatch "${EPATCH_SOURCE}/$1"
439 return $?
440
441 else
442 # sanity check ... if it isn't a dir or file, wtf man ?
443 [[ $# -ne 0 ]] && EPATCH_SOURCE=$1
444 echo
445 eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:"
446 eerror
447 eerror " ${EPATCH_SOURCE}"
448 eerror " ( ${EPATCH_SOURCE##*/} )"
449 echo
450 die "Cannot find \$EPATCH_SOURCE!"
451 fi
452
453 # Now that we know we're actually going to apply something, merge
454 # all of the patch options back in to a single variable for below.
455 EPATCH_OPTS="${EPATCH_COMMON_OPTS} ${EPATCH_OPTS[*]}"
456
457 local PIPE_CMD
458 case ${EPATCH_SUFFIX##*\.} in
459 xz) PIPE_CMD="xz -dc" ;;
460 lzma) PIPE_CMD="lzma -dc" ;;
461 bz2) PIPE_CMD="bzip2 -dc" ;;
462 gz|Z|z) PIPE_CMD="gzip -dc" ;;
463 ZIP|zip) PIPE_CMD="unzip -p" ;;
464 *) ;;
465 esac
466
467 [[ ${SINGLE_PATCH} == "no" ]] && einfo "${EPATCH_MULTI_MSG}"
468
469 local x
470 for x in "$@" ; do
471 # If the patch dir given contains subdirs, or our EPATCH_SUFFIX
472 # didn't match anything, ignore continue on
473 [[ ! -f ${x} ]] && continue
474
475 local patchname=${x##*/}
476
477 # Apply single patches, or forced sets of patches, or
478 # patches with ARCH dependant names.
479 # ???_arch_foo.patch
480 # Else, skip this input altogether
481 local a=${patchname#*_} # strip the ???_
482 a=${a%%_*} # strip the _foo.patch
483 if ! [[ ${SINGLE_PATCH} == "yes" || \
484 ${EPATCH_FORCE} == "yes" || \
485 ${a} == all || \
486 ${a} == ${ARCH} ]]
163 then 487 then
164 local EPATCH_SOURCE="$1/*" 488 continue
489 fi
490
491 # Let people filter things dynamically
492 if [[ -n ${EPATCH_EXCLUDE}${EPATCH_USER_EXCLUDE} ]] ; then
493 # let people use globs in the exclude
494 eshopts_push -o noglob
495
496 local ex
497 for ex in ${EPATCH_EXCLUDE} ; do
498 if [[ ${patchname} == ${ex} ]] ; then
499 einfo " Skipping ${patchname} due to EPATCH_EXCLUDE ..."
500 eshopts_pop
501 continue 2
502 fi
503 done
504
505 for ex in ${EPATCH_USER_EXCLUDE} ; do
506 if [[ ${patchname} == ${ex} ]] ; then
507 einfo " Skipping ${patchname} due to EPATCH_USER_EXCLUDE ..."
508 eshopts_pop
509 continue 2
510 fi
511 done
512
513 eshopts_pop
514 fi
515
516 if [[ ${SINGLE_PATCH} == "yes" ]] ; then
517 if [[ -n ${EPATCH_SINGLE_MSG} ]] ; then
518 einfo "${EPATCH_SINGLE_MSG}"
519 else
520 einfo "Applying ${patchname} ..."
521 fi
165 else 522 else
166 local EPATCH_SOURCE="$1/*.${EPATCH_SUFFIX}" 523 einfo " ${patchname} ..."
167 fi 524 fi
168 else 525
169 if [[ ! -d ${EPATCH_SOURCE} ]] || [[ -n $1 ]] ; then 526 # Handle aliased patch command #404447 #461568
170 if [ -n "$1" -a "${EPATCH_SOURCE}" = "${WORKDIR}/patch" ] 527 local patch="patch"
171 then 528 eval $(alias patch 2>/dev/null | sed 's:^alias ::')
172 EPATCH_SOURCE="$1" 529
530 # most of the time, there will only be one run per unique name,
531 # but if there are more, make sure we get unique log filenames
532 local STDERR_TARGET="${T}/${patchname}.out"
533 if [[ -e ${STDERR_TARGET} ]] ; then
534 STDERR_TARGET="${T}/${patchname}-$$.out"
535 fi
536
537 printf "***** %s *****\nPWD: %s\nPATCH TOOL: %s -> %s\nVERSION INFO:\n%s\n\n" \
538 "${patchname}" \
539 "${PWD}" \
540 "${patch}" \
541 "$(type -P "${patch}")" \
542 "$(${patch} --version)" \
543 > "${STDERR_TARGET}"
544
545 # Decompress the patch if need be
546 local count=0
547 local PATCH_TARGET
548 if [[ -n ${PIPE_CMD} ]] ; then
549 PATCH_TARGET="${T}/$$.patch"
550 echo "PIPE_COMMAND: ${PIPE_CMD} ${x} > ${PATCH_TARGET}" >> "${STDERR_TARGET}"
551
552 if ! (${PIPE_CMD} "${x}" > "${PATCH_TARGET}") >> "${STDERR_TARGET}" 2>&1 ; then
553 echo
554 eerror "Could not extract patch!"
555 #die "Could not extract patch!"
556 count=5
557 break
173 fi 558 fi
559 else
560 PATCH_TARGET=${x}
561 fi
174 562
563 # Check for absolute paths in patches. If sandbox is disabled,
564 # people could (accidently) patch files in the root filesystem.
565 # Or trigger other unpleasantries #237667. So disallow -p0 on
566 # such patches.
567 local abs_paths=$(egrep -n '^[-+]{3} /' "${PATCH_TARGET}" | awk '$2 != "/dev/null" { print }')
568 if [[ -n ${abs_paths} ]] ; then
569 count=1
570 printf "NOTE: skipping -p0 due to absolute paths in patch:\n%s\n" "${abs_paths}" >> "${STDERR_TARGET}"
571 fi
572 # Similar reason, but with relative paths.
573 local rel_paths=$(egrep -n '^[-+]{3} [^ ]*[.][.]/' "${PATCH_TARGET}")
574 if [[ -n ${rel_paths} ]] ; then
175 echo 575 echo
176 eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:" 576 eerror "Rejected Patch: ${patchname} !"
577 eerror " ( ${PATCH_TARGET} )"
177 eerror 578 eerror
178 eerror " ${EPATCH_SOURCE}" 579 eerror "Your patch uses relative paths '../':"
179 eerror " ( ${EPATCH_SOURCE##*/} )" 580 eerror "${rel_paths}"
180 echo 581 echo
181 die "Cannot find \$EPATCH_SOURCE!" 582 die "you need to fix the relative paths in patch"
182 fi
183
184 local EPATCH_SOURCE="${EPATCH_SOURCE}/*.${EPATCH_SUFFIX}"
185 fi 583 fi
186 584
187 case ${EPATCH_SUFFIX##*\.} in 585 # Dynamically detect the correct -p# ... i'm lazy, so shoot me :/
188 bz2) 586 local patch_cmd
189 PIPE_CMD="bzip2 -dc" 587 while [[ ${count} -lt 5 ]] ; do
190 PATCH_SUFFIX="bz2" 588 patch_cmd="${patch} -p${count} ${EPATCH_OPTS}"
191 ;;
192 gz|Z|z)
193 PIPE_CMD="gzip -dc"
194 PATCH_SUFFIX="gz"
195 ;;
196 ZIP|zip)
197 PIPE_CMD="unzip -p"
198 PATCH_SUFFIX="zip"
199 ;;
200 *)
201 PIPE_CMD="cat"
202 PATCH_SUFFIX="patch"
203 ;;
204 esac
205 589
206 if [ "${SINGLE_PATCH}" = "no" ] 590 # Generate some useful debug info ...
207 then 591 (
208 einfo "${EPATCH_MULTI_MSG}" 592 _epatch_draw_line "***** ${patchname} *****"
209 fi 593 echo
210 for x in ${EPATCH_SOURCE} 594 echo "PATCH COMMAND: ${patch_cmd} < '${PATCH_TARGET}'"
211 do 595 echo
212 # New ARCH dependant patch naming scheme ... 596 _epatch_draw_line "***** ${patchname} *****"
213 # 597 ${patch_cmd} --dry-run -f < "${PATCH_TARGET}" 2>&1
214 # ???_arch_foo.patch 598 ret=$?
215 # 599 echo
216 if [ -f ${x} ] && \ 600 echo "patch program exited with status ${ret}"
217 ([ "${SINGLE_PATCH}" = "yes" -o "${x/_all_}" != "${x}" -o "${x/_${ARCH}_}" != "${x}" ] || \ 601 exit ${ret}
218 [ "${EPATCH_FORCE}" = "yes" ]) 602 ) >> "${STDERR_TARGET}"
219 then
220 local count=0
221 local popts="${EPATCH_OPTS}"
222 local patchname=${x##*/}
223 603
224 if [ -n "${EPATCH_EXCLUDE}" ] 604 if [ $? -eq 0 ] ; then
225 then 605 (
226 if [ "${EPATCH_EXCLUDE/${patchname}}" != "${EPATCH_EXCLUDE}" ] 606 _epatch_draw_line "***** ${patchname} *****"
227 then 607 echo
228 continue 608 echo "ACTUALLY APPLYING ${patchname} ..."
609 echo
610 _epatch_draw_line "***** ${patchname} *****"
611 ${patch_cmd} < "${PATCH_TARGET}" 2>&1
612 ret=$?
613 echo
614 echo "patch program exited with status ${ret}"
615 exit ${ret}
616 ) >> "${STDERR_TARGET}"
617
618 if [ $? -ne 0 ] ; then
619 echo
620 eerror "A dry-run of patch command succeeded, but actually"
621 eerror "applying the patch failed!"
622 #die "Real world sux compared to the dreamworld!"
623 count=5
229 fi 624 fi
625 break
230 fi 626 fi
231 627
232 if [ "${SINGLE_PATCH}" = "yes" ] 628 : $(( count++ ))
233 then
234 if [ -n "${EPATCH_SINGLE_MSG}" ]
235 then
236 einfo "${EPATCH_SINGLE_MSG}"
237 else
238 einfo "Applying ${patchname} ..."
239 fi
240 else
241 einfo " ${patchname} ..."
242 fi
243
244 echo "***** ${patchname} *****" > ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
245 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
246
247 # Allow for prefix to differ ... im lazy, so shoot me :/
248 while [ "${count}" -lt 5 ]
249 do
250 # Generate some useful debug info ...
251 _epatch_draw_line "***** ${patchname} *****" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
252 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
253
254 if [ "${PATCH_SUFFIX}" != "patch" ]
255 then
256 echo -n "PIPE_COMMAND: " >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
257 echo "${PIPE_CMD} ${x} > ${PATCH_TARGET}" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
258 else
259 PATCH_TARGET="${x}"
260 fi
261
262 echo -n "PATCH COMMAND: " >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
263 echo "patch -p${count} ${popts} < ${PATCH_TARGET}" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
264
265 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
266 _epatch_draw_line "***** ${patchname} *****" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
267
268 if [ "${PATCH_SUFFIX}" != "patch" ]
269 then
270 if ! (${PIPE_CMD} ${x} > ${PATCH_TARGET}) >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 2>&1
271 then
272 echo
273 eerror "Could not extract patch!"
274 #die "Could not extract patch!"
275 count=5
276 break
277 fi
278 fi
279
280 if (cat ${PATCH_TARGET} | patch -p${count} ${popts} --dry-run -f ; _epatch_assert) >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 2>&1
281 then
282 _epatch_draw_line "***** ${patchname} *****" > ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
283 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
284 echo "ACTUALLY APPLYING ${patchname} ..." >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
285 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
286 _epatch_draw_line "***** ${patchname} *****" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
287
288 cat ${PATCH_TARGET} | patch -p${count} ${popts} >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real 2>&1
289 _epatch_assert
290
291 if [ "$?" -ne 0 ]
292 then
293 cat ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
294 echo
295 eerror "A dry-run of patch command succeeded, but actually"
296 eerror "applying the patch failed!"
297 #die "Real world sux compared to the dreamworld!"
298 count=5
299 fi
300
301 rm -f ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
302
303 break
304 fi
305
306 count=$((count + 1))
307 done 629 done
308 630
309 if [ "${PATCH_SUFFIX}" != "patch" ] 631 # if we had to decompress the patch, delete the temp one
310 then 632 if [[ -n ${PIPE_CMD} ]] ; then
311 rm -f ${PATCH_TARGET} 633 rm -f "${PATCH_TARGET}"
312 fi 634 fi
313 635
314 if [ "${count}" -eq 5 ] 636 if [[ ${count} -ge 5 ]] ; then
315 then
316 echo 637 echo
317 eerror "Failed Patch: ${patchname} !" 638 eerror "Failed Patch: ${patchname} !"
318 eerror " ( ${PATCH_TARGET} )" 639 eerror " ( ${PATCH_TARGET} )"
319 eerror 640 eerror
320 eerror "Include in your bugreport the contents of:" 641 eerror "Include in your bugreport the contents of:"
321 eerror 642 eerror
322 eerror " ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}" 643 eerror " ${STDERR_TARGET}"
323 echo 644 echo
324 die "Failed Patch: ${patchname}!" 645 die "Failed Patch: ${patchname}!"
325 fi 646 fi
326 647
327 rm -f ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 648 # if everything worked, delete the full debug patch log
649 rm -f "${STDERR_TARGET}"
328 650
651 # then log away the exact stuff for people to review later
652 cat <<-EOF >> "${T}/epatch.log"
653 PATCH: ${x}
654 CMD: ${patch_cmd}
655 PWD: ${PWD}
656
657 EOF
329 eend 0 658 eend 0
330 fi
331 done 659 done
332 if [ "${SINGLE_PATCH}" = "no" ] 660
333 then 661 [[ ${SINGLE_PATCH} == "no" ]] && einfo "Done with patching"
334 einfo "Done with patching" 662 : # everything worked
663}
664
665# @FUNCTION: epatch_user
666# @USAGE:
667# @DESCRIPTION:
668# Applies user-provided patches to the source tree. The patches are
669# taken from /etc/portage/patches/<CATEGORY>/<P-PR|P|PN>[:SLOT]/, where the first
670# of these three directories to exist will be the one to use, ignoring
671# any more general directories which might exist as well. They must end
672# in ".patch" to be applied.
673#
674# User patches are intended for quick testing of patches without ebuild
675# modifications, as well as for permanent customizations a user might
676# desire. Obviously, there can be no official support for arbitrarily
677# patched ebuilds. So whenever a build log in a bug report mentions that
678# user patches were applied, the user should be asked to reproduce the
679# problem without these.
680#
681# Not all ebuilds do call this function, so placing patches in the
682# stated directory might or might not work, depending on the package and
683# the eclasses it inherits and uses. It is safe to call the function
684# repeatedly, so it is always possible to add a call at the ebuild
685# level. The first call is the time when the patches will be
686# applied.
687#
688# Ideally, this function should be called after gentoo-specific patches
689# have been applied, so that their code can be modified as well, but
690# before calls to e.g. eautoreconf, as the user patches might affect
691# autotool input files as well.
692epatch_user() {
693 [[ $# -ne 0 ]] && die "epatch_user takes no options"
694
695 # Allow multiple calls to this function; ignore all but the first
696 local applied="${T}/epatch_user.log"
697 [[ -e ${applied} ]] && return 2
698
699 # don't clobber any EPATCH vars that the parent might want
700 local EPATCH_SOURCE check base=${PORTAGE_CONFIGROOT%/}/etc/portage/patches
701 for check in ${CATEGORY}/{${P}-${PR},${P},${PN}}{,:${SLOT}}; do
702 EPATCH_SOURCE=${base}/${CTARGET}/${check}
703 [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${CHOST}/${check}
704 [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${check}
705 if [[ -d ${EPATCH_SOURCE} ]] ; then
706 EPATCH_SOURCE=${EPATCH_SOURCE} \
707 EPATCH_SUFFIX="patch" \
708 EPATCH_FORCE="yes" \
709 EPATCH_MULTI_MSG="Applying user patches from ${EPATCH_SOURCE} ..." \
710 epatch
711 echo "${EPATCH_SOURCE}" > "${applied}"
712 return 0
335 fi 713 fi
714 done
715 echo "none" > "${applied}"
716 return 1
336} 717}
337 718
338# @FUNCTION: emktemp 719# @FUNCTION: emktemp
339# @USAGE: [temp dir] 720# @USAGE: [temp dir]
340# @DESCRIPTION: 721# @DESCRIPTION:
368 TMPDIR="${topdir}" mktemp -dt tmp.XXXXXXXXXX 749 TMPDIR="${topdir}" mktemp -dt tmp.XXXXXXXXXX
369 fi 750 fi
370 fi 751 fi
371} 752}
372 753
373# @FUNCTION: egetent
374# @USAGE: <database> <key>
375# @MAINTAINER:
376# base-system@gentoo.org (Linux)
377# Joe Jezak <josejx@gmail.com> (OS X)
378# usata@gentoo.org (OS X)
379# Aaron Walker <ka0ttic@gentoo.org> (FreeBSD)
380# @DESCRIPTION:
381# Small wrapper for getent (Linux), nidump (Mac OS X),
382# and pw (FreeBSD) used in enewuser()/enewgroup()
383egetent() {
384 case ${CHOST} in
385 *-darwin*)
386 case "$2" in
387 *[!0-9]*) # Non numeric
388 nidump $1 . | awk -F":" "{ if (\$1 ~ /^$2$/) {print \$0;exit;} }"
389 ;;
390 *) # Numeric
391 nidump $1 . | awk -F":" "{ if (\$3 == $2) {print \$0;exit;} }"
392 ;;
393 esac
394 ;;
395 *-freebsd*|*-dragonfly*)
396 local opts action="user"
397 [[ $1 == "passwd" ]] || action="group"
398
399 # lookup by uid/gid
400 if [[ $2 == [[:digit:]]* ]] ; then
401 [[ ${action} == "user" ]] && opts="-u" || opts="-g"
402 fi
403
404 pw show ${action} ${opts} "$2" -q
405 ;;
406 *-netbsd*|*-openbsd*)
407 grep "$2:\*:" /etc/$1
408 ;;
409 *)
410 type -p nscd >& /dev/null && nscd -i "$1"
411 getent "$1" "$2"
412 ;;
413 esac
414}
415
416# @FUNCTION: enewuser
417# @USAGE: <user> [uid] [shell] [homedir] [groups] [params]
418# @DESCRIPTION:
419# Same as enewgroup, you are not required to understand how to properly add
420# a user to the system. The only required parameter is the username.
421# Default uid is (pass -1 for this) next available, default shell is
422# /bin/false, default homedir is /dev/null, there are no default groups,
423# and default params sets the comment as 'added by portage for ${PN}'.
424enewuser() {
425 case ${EBUILD_PHASE} in
426 unpack|compile|test|install)
427 eerror "'enewuser()' called from '${EBUILD_PHASE}()' which is not a pkg_* function."
428 eerror "Package fails at QA and at life. Please file a bug."
429 die "Bad package! enewuser is only for use in pkg_* functions!"
430 esac
431
432 # get the username
433 local euser=$1; shift
434 if [[ -z ${euser} ]] ; then
435 eerror "No username specified !"
436 die "Cannot call enewuser without a username"
437 fi
438
439 # lets see if the username already exists
440 if [[ -n $(egetent passwd "${euser}") ]] ; then
441 return 0
442 fi
443 einfo "Adding user '${euser}' to your system ..."
444
445 # options to pass to useradd
446 local opts=
447
448 # handle uid
449 local euid=$1; shift
450 if [[ -n ${euid} && ${euid} != -1 ]] ; then
451 if [[ ${euid} -gt 0 ]] ; then
452 if [[ -n $(egetent passwd ${euid}) ]] ; then
453 euid="next"
454 fi
455 else
456 eerror "Userid given but is not greater than 0 !"
457 die "${euid} is not a valid UID"
458 fi
459 else
460 euid="next"
461 fi
462 if [[ ${euid} == "next" ]] ; then
463 for ((euid = 101; euid <= 999; euid++)); do
464 [[ -z $(egetent passwd ${euid}) ]] && break
465 done
466 fi
467 opts="${opts} -u ${euid}"
468 einfo " - Userid: ${euid}"
469
470 # handle shell
471 local eshell=$1; shift
472 if [[ ! -z ${eshell} ]] && [[ ${eshell} != "-1" ]] ; then
473 if [[ ! -e ${ROOT}${eshell} ]] ; then
474 eerror "A shell was specified but it does not exist !"
475 die "${eshell} does not exist in ${ROOT}"
476 fi
477 if [[ ${eshell} == */false || ${eshell} == */nologin ]] ; then
478 eerror "Do not specify ${eshell} yourself, use -1"
479 die "Pass '-1' as the shell parameter"
480 fi
481 else
482 for shell in /sbin/nologin /usr/sbin/nologin /bin/false /usr/bin/false /dev/null ; do
483 [[ -x ${ROOT}${shell} ]] && break
484 done
485
486 if [[ ${shell} == "/dev/null" ]] ; then
487 eerror "Unable to identify the shell to use, proceeding with userland default."
488 case ${USERLAND} in
489 GNU) shell="/bin/false" ;;
490 BSD) shell="/sbin/nologin" ;;
491 Darwin) shell="/usr/sbin/nologin" ;;
492 *) die "Unable to identify the default shell for userland ${USERLAND}"
493 esac
494 fi
495
496 eshell=${shell}
497 fi
498 einfo " - Shell: ${eshell}"
499 opts="${opts} -s ${eshell}"
500
501 # handle homedir
502 local ehome=$1; shift
503 if [[ -z ${ehome} ]] || [[ ${ehome} == "-1" ]] ; then
504 ehome="/dev/null"
505 fi
506 einfo " - Home: ${ehome}"
507 opts="${opts} -d ${ehome}"
508
509 # handle groups
510 local egroups=$1; shift
511 if [[ ! -z ${egroups} ]] ; then
512 local oldifs=${IFS}
513 local defgroup="" exgroups=""
514
515 export IFS=","
516 for g in ${egroups} ; do
517 export IFS=${oldifs}
518 if [[ -z $(egetent group "${g}") ]] ; then
519 eerror "You must add group ${g} to the system first"
520 die "${g} is not a valid GID"
521 fi
522 if [[ -z ${defgroup} ]] ; then
523 defgroup=${g}
524 else
525 exgroups="${exgroups},${g}"
526 fi
527 export IFS=","
528 done
529 export IFS=${oldifs}
530
531 opts="${opts} -g ${defgroup}"
532 if [[ ! -z ${exgroups} ]] ; then
533 opts="${opts} -G ${exgroups:1}"
534 fi
535 else
536 egroups="(none)"
537 fi
538 einfo " - Groups: ${egroups}"
539
540 # handle extra and add the user
541 local oldsandbox=${SANDBOX_ON}
542 export SANDBOX_ON="0"
543 case ${CHOST} in
544 *-darwin*)
545 ### Make the user
546 if [[ -z $@ ]] ; then
547 dscl . create /users/${euser} uid ${euid}
548 dscl . create /users/${euser} shell ${eshell}
549 dscl . create /users/${euser} home ${ehome}
550 dscl . create /users/${euser} realname "added by portage for ${PN}"
551 ### Add the user to the groups specified
552 local oldifs=${IFS}
553 export IFS=","
554 for g in ${egroups} ; do
555 dscl . merge /groups/${g} users ${euser}
556 done
557 export IFS=${oldifs}
558 else
559 einfo "Extra options are not supported on Darwin yet"
560 einfo "Please report the ebuild along with the info below"
561 einfo "eextra: $@"
562 die "Required function missing"
563 fi
564 ;;
565 *-freebsd*|*-dragonfly*)
566 if [[ -z $@ ]] ; then
567 pw useradd ${euser} ${opts} \
568 -c "added by portage for ${PN}" \
569 die "enewuser failed"
570 else
571 einfo " - Extra: $@"
572 pw useradd ${euser} ${opts} \
573 "$@" || die "enewuser failed"
574 fi
575 ;;
576
577 *-netbsd*)
578 if [[ -z $@ ]] ; then
579 useradd ${opts} ${euser} || die "enewuser failed"
580 else
581 einfo " - Extra: $@"
582 useradd ${opts} ${euser} "$@" || die "enewuser failed"
583 fi
584 ;;
585
586 *-openbsd*)
587 if [[ -z $@ ]] ; then
588 useradd -u ${euid} -s ${eshell} \
589 -d ${ehome} -c "Added by portage for ${PN}" \
590 -g ${egroups} ${euser} || die "enewuser failed"
591 else
592 einfo " - Extra: $@"
593 useradd -u ${euid} -s ${eshell} \
594 -d ${ehome} -c "Added by portage for ${PN}" \
595 -g ${egroups} ${euser} "$@" || die "enewuser failed"
596 fi
597 ;;
598
599 *)
600 if [[ -z $@ ]] ; then
601 useradd ${opts} ${euser} \
602 -c "added by portage for ${PN}" \
603 || die "enewuser failed"
604 else
605 einfo " - Extra: $@"
606 useradd ${opts} ${euser} "$@" \
607 || die "enewuser failed"
608 fi
609 ;;
610 esac
611
612 if [[ ! -e ${ROOT}/${ehome} ]] ; then
613 einfo " - Creating ${ehome} in ${ROOT}"
614 mkdir -p "${ROOT}/${ehome}"
615 chown ${euser} "${ROOT}/${ehome}"
616 chmod 755 "${ROOT}/${ehome}"
617 fi
618
619 export SANDBOX_ON=${oldsandbox}
620}
621
622# @FUNCTION: enewgroup
623# @USAGE: <group> [gid]
624# @DESCRIPTION:
625# This function does not require you to understand how to properly add a
626# group to the system. Just give it a group name to add and enewgroup will
627# do the rest. You may specify the gid for the group or allow the group to
628# allocate the next available one.
629enewgroup() {
630 case ${EBUILD_PHASE} in
631 unpack|compile|test|install)
632 eerror "'enewgroup()' called from '${EBUILD_PHASE}()' which is not a pkg_* function."
633 eerror "Package fails at QA and at life. Please file a bug."
634 die "Bad package! enewgroup is only for use in pkg_* functions!"
635 esac
636
637 # get the group
638 local egroup="$1"; shift
639 if [ -z "${egroup}" ]
640 then
641 eerror "No group specified !"
642 die "Cannot call enewgroup without a group"
643 fi
644
645 # see if group already exists
646 if [[ -n $(egetent group "${egroup}") ]]; then
647 return 0
648 fi
649 einfo "Adding group '${egroup}' to your system ..."
650
651 # options to pass to useradd
652 local opts=
653
654 # handle gid
655 local egid="$1"; shift
656 if [ ! -z "${egid}" ]
657 then
658 if [ "${egid}" -gt 0 ]
659 then
660 if [ -z "`egetent group ${egid}`" ]
661 then
662 if [[ "${CHOST}" == *-darwin* ]]; then
663 opts="${opts} ${egid}"
664 else
665 opts="${opts} -g ${egid}"
666 fi
667 else
668 egid="next available; requested gid taken"
669 fi
670 else
671 eerror "Groupid given but is not greater than 0 !"
672 die "${egid} is not a valid GID"
673 fi
674 else
675 egid="next available"
676 fi
677 einfo " - Groupid: ${egid}"
678
679 # handle extra
680 local eextra="$@"
681 opts="${opts} ${eextra}"
682
683 # add the group
684 local oldsandbox="${SANDBOX_ON}"
685 export SANDBOX_ON="0"
686 case ${CHOST} in
687 *-darwin*)
688 if [ ! -z "${eextra}" ];
689 then
690 einfo "Extra options are not supported on Darwin/OS X yet"
691 einfo "Please report the ebuild along with the info below"
692 einfo "eextra: ${eextra}"
693 die "Required function missing"
694 fi
695
696 # If we need the next available
697 case ${egid} in
698 *[!0-9]*) # Non numeric
699 for ((egid = 101; egid <= 999; egid++)); do
700 [[ -z $(egetent group ${egid}) ]] && break
701 done
702 esac
703 dscl . create /groups/${egroup} gid ${egid}
704 dscl . create /groups/${egroup} passwd '*'
705 ;;
706
707 *-freebsd*|*-dragonfly*)
708 case ${egid} in
709 *[!0-9]*) # Non numeric
710 for ((egid = 101; egid <= 999; egid++)); do
711 [[ -z $(egetent group ${egid}) ]] && break
712 done
713 esac
714 pw groupadd ${egroup} -g ${egid} || die "enewgroup failed"
715 ;;
716
717 *-netbsd*)
718 case ${egid} in
719 *[!0-9]*) # Non numeric
720 for ((egid = 101; egid <= 999; egid++)); do
721 [[ -z $(egetent group ${egid}) ]] && break
722 done
723 esac
724 groupadd -g ${egid} ${egroup} || die "enewgroup failed"
725 ;;
726
727 *)
728 groupadd ${opts} ${egroup} || die "enewgroup failed"
729 ;;
730 esac
731 export SANDBOX_ON="${oldsandbox}"
732}
733
734# @FUNCTION: edos2unix 754# @FUNCTION: edos2unix
735# @USAGE: <file> [more files ...] 755# @USAGE: <file> [more files ...]
736# @DESCRIPTION: 756# @DESCRIPTION:
737# A handy replacement for dos2unix, recode, fixdos, etc... This allows you 757# A handy replacement for dos2unix, recode, fixdos, etc... This allows you
738# to remove all of these text utilities from DEPEND variables because this 758# to remove all of these text utilities from DEPEND variables because this
739# is a script based solution. Just give it a list of files to convert and 759# is a script based solution. Just give it a list of files to convert and
740# they will all be changed from the DOS CRLF format to the UNIX LF format. 760# they will all be changed from the DOS CRLF format to the UNIX LF format.
741edos2unix() { 761edos2unix() {
742 echo "$@" | xargs sed -i 's/\r$//' 762 [[ $# -eq 0 ]] && return 0
763 sed -i 's/\r$//' -- "$@" || die
743} 764}
744 765
766# @FUNCTION: make_desktop_entry
767# @USAGE: make_desktop_entry(<command>, [name], [icon], [type], [fields])
768# @DESCRIPTION:
745# Make a desktop file ! 769# Make a .desktop file.
746# Great for making those icons in kde/gnome startmenu !
747# Amaze your friends ! Get the women ! Join today !
748# 770#
749# make_desktop_entry(<command>, [name], [icon], [type], [path]) 771# @CODE
750#
751# binary: what command does the app run with ? 772# binary: what command does the app run with ?
752# name: the name that will show up in the menu 773# name: the name that will show up in the menu
753# icon: give your little like a pretty little icon ... 774# icon: the icon to use in the menu entry
754# this can be relative (to /usr/share/pixmaps) or 775# this can be relative (to /usr/share/pixmaps) or
755# a full path to an icon 776# a full path to an icon
756# type: what kind of application is this ? for categories: 777# type: what kind of application is this?
778# for categories:
757# http://standards.freedesktop.org/menu-spec/latest/apa.html 779# http://standards.freedesktop.org/menu-spec/latest/apa.html
758# path: if your app needs to startup in a specific dir 780# if unset, function tries to guess from package's category
781# fields: extra fields to append to the desktop file; a printf string
782# @CODE
759make_desktop_entry() { 783make_desktop_entry() {
760 [[ -z $1 ]] && eerror "make_desktop_entry: You must specify the executable" && return 1 784 [[ -z $1 ]] && die "make_desktop_entry: You must specify the executable"
761 785
762 local exec=${1} 786 local exec=${1}
763 local name=${2:-${PN}} 787 local name=${2:-${PN}}
764 local icon=${3:-${PN}} 788 local icon=${3:-${PN}}
765 local type=${4} 789 local type=${4}
766 local path=${5} 790 local fields=${5}
767 791
768 if [[ -z ${type} ]] ; then 792 if [[ -z ${type} ]] ; then
769 local catmaj=${CATEGORY%%-*} 793 local catmaj=${CATEGORY%%-*}
770 local catmin=${CATEGORY##*-} 794 local catmin=${CATEGORY##*-}
771 case ${catmaj} in 795 case ${catmaj} in
772 app) 796 app)
773 case ${catmin} in 797 case ${catmin} in
774 accessibility) type=Accessibility;; 798 accessibility) type="Utility;Accessibility";;
775 admin) type=System;; 799 admin) type=System;;
776 antivirus) type=System;; 800 antivirus) type=System;;
777 arch) type=Archiving;; 801 arch) type="Utility;Archiving";;
778 backup) type=Archiving;; 802 backup) type="Utility;Archiving";;
779 cdr) type=DiscBurning;; 803 cdr) type="AudioVideo;DiscBurning";;
780 dicts) type=Dictionary;; 804 dicts) type="Office;Dictionary";;
781 doc) type=Documentation;; 805 doc) type=Documentation;;
782 editors) type=TextEditor;; 806 editors) type="Utility;TextEditor";;
783 emacs) type=TextEditor;; 807 emacs) type="Development;TextEditor";;
784 emulation) type=Emulator;; 808 emulation) type="System;Emulator";;
785 laptop) type=HardwareSettings;; 809 laptop) type="Settings;HardwareSettings";;
786 office) type=Office;; 810 office) type=Office;;
787 pda) type=PDA;; 811 pda) type="Office;PDA";;
788 vim) type=TextEditor;; 812 vim) type="Development;TextEditor";;
789 xemacs) type=TextEditor;; 813 xemacs) type="Development;TextEditor";;
790 *) type=;;
791 esac 814 esac
792 ;; 815 ;;
793 816
794 dev) 817 dev)
795 type="Development" 818 type="Development"
796 ;; 819 ;;
797 820
798 games) 821 games)
799 case ${catmin} in 822 case ${catmin} in
800 action|fps) type=ActionGame;; 823 action|fps) type=ActionGame;;
801 arcade) type=ArcadeGame;; 824 arcade) type=ArcadeGame;;
802 board) type=BoardGame;; 825 board) type=BoardGame;;
803 emulation) type=Emulator;; 826 emulation) type=Emulator;;
804 kids) type=KidsGame;; 827 kids) type=KidsGame;;
805 puzzle) type=LogicGame;; 828 puzzle) type=LogicGame;;
806 roguelike) type=RolePlaying;; 829 roguelike) type=RolePlaying;;
807 rpg) type=RolePlaying;; 830 rpg) type=RolePlaying;;
808 simulation) type=Simulation;; 831 simulation) type=Simulation;;
809 sports) type=SportsGame;; 832 sports) type=SportsGame;;
810 strategy) type=StrategyGame;; 833 strategy) type=StrategyGame;;
811 *) type=;;
812 esac 834 esac
813 type="Game;${type}" 835 type="Game;${type}"
814 ;; 836 ;;
815 837
816 gnome) 838 gnome)
825 type="Network;Email" 847 type="Network;Email"
826 ;; 848 ;;
827 849
828 media) 850 media)
829 case ${catmin} in 851 case ${catmin} in
852 gfx)
830 gfx) type=Graphics;; 853 type=Graphics
854 ;;
855 *)
856 case ${catmin} in
831 radio) type=Tuner;; 857 radio) type=Tuner;;
832 sound) type=Audio;; 858 sound) type=Audio;;
833 tv) type=TV;; 859 tv) type=TV;;
834 video) type=Video;; 860 video) type=Video;;
835 *) type=;; 861 esac
862 type="AudioVideo;${type}"
863 ;;
836 esac 864 esac
837 type="AudioVideo;${type}"
838 ;; 865 ;;
839 866
840 net) 867 net)
841 case ${catmin} in 868 case ${catmin} in
842 dialup) type=Dialup;; 869 dialup) type=Dialup;;
843 ftp) type=FileTransfer;; 870 ftp) type=FileTransfer;;
844 im) type=InstantMessaging;; 871 im) type=InstantMessaging;;
845 irc) type=IRCClient;; 872 irc) type=IRCClient;;
846 mail) type=Email;; 873 mail) type=Email;;
847 news) type=News;; 874 news) type=News;;
848 nntp) type=News;; 875 nntp) type=News;;
849 p2p) type=FileTransfer;; 876 p2p) type=FileTransfer;;
850 *) type=;; 877 voip) type=Telephony;;
851 esac 878 esac
852 type="Network;${type}" 879 type="Network;${type}"
853 ;; 880 ;;
854 881
855 sci) 882 sci)
856 case ${catmin} in 883 case ${catmin} in
857 astro*) type=Astronomy;; 884 astro*) type=Astronomy;;
858 bio*) type=Biology;; 885 bio*) type=Biology;;
859 calc*) type=Calculator;; 886 calc*) type=Calculator;;
860 chem*) type=Chemistry;; 887 chem*) type=Chemistry;;
861 elec*) type=Electronics;; 888 elec*) type=Electronics;;
862 geo*) type=Geology;; 889 geo*) type=Geology;;
863 math*) type=Math;; 890 math*) type=Math;;
864 physics) type=Physics;; 891 physics) type=Physics;;
865 visual*) type=DataVisualization;; 892 visual*) type=DataVisualization;;
866 *) type=;;
867 esac 893 esac
868 type="Science;${type}" 894 type="Education;Science;${type}"
869 ;; 895 ;;
870 896
871 sys) 897 sys)
872 type="System" 898 type="System"
873 ;; 899 ;;
874 900
875 www) 901 www)
876 case ${catmin} in 902 case ${catmin} in
877 client) type=WebBrowser;; 903 client) type=WebBrowser;;
878 *) type=;;
879 esac 904 esac
880 type="Network" 905 type="Network;${type}"
881 ;; 906 ;;
882 907
883 *) 908 *)
884 type= 909 type=
885 ;; 910 ;;
886 esac 911 esac
887 fi 912 fi
913 local slot=${SLOT%/*}
888 if [ "${SLOT}" == "0" ] ; then 914 if [[ ${slot} == "0" ]] ; then
889 local desktop_name="${PN}" 915 local desktop_name="${PN}"
890 else 916 else
891 local desktop_name="${PN}-${SLOT}" 917 local desktop_name="${PN}-${slot}"
892 fi 918 fi
893 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop" 919 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop"
894 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop 920 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop
895 921
922 # Don't append another ";" when a valid category value is provided.
923 type=${type%;}${type:+;}
924
925 eshopts_push -s extglob
926 if [[ -n ${icon} && ${icon} != /* ]] && [[ ${icon} == *.xpm || ${icon} == *.png || ${icon} == *.svg ]]; then
927 ewarn "As described in the Icon Theme Specification, icon file extensions are not"
928 ewarn "allowed in .desktop files if the value is not an absolute path."
929 icon=${icon%.@(xpm|png|svg)}
930 fi
931 eshopts_pop
932
896 cat <<-EOF > "${desktop}" 933 cat <<-EOF > "${desktop}"
897 [Desktop Entry] 934 [Desktop Entry]
898 Version=1.0
899 Name=${name} 935 Name=${name}
900 Type=Application 936 Type=Application
901 Comment=${DESCRIPTION} 937 Comment=${DESCRIPTION}
902 Exec=${exec} 938 Exec=${exec}
903 TryExec=${exec%% *} 939 TryExec=${exec%% *}
904 Icon=${icon} 940 Icon=${icon}
905 Categories=${type}; 941 Categories=${type}
906 EOF 942 EOF
907 943
908 [[ ${path} ]] && echo "Path=${path}" >> "${desktop}" 944 if [[ ${fields:-=} != *=* ]] ; then
945 # 5th arg used to be value to Path=
946 ewarn "make_desktop_entry: update your 5th arg to read Path=${fields}"
947 fields="Path=${fields}"
948 fi
949 [[ -n ${fields} ]] && printf '%b\n' "${fields}" >> "${desktop}"
909 950
910 ( 951 (
911 # wrap the env here so that the 'insinto' call 952 # wrap the env here so that the 'insinto' call
912 # doesn't corrupt the env of the caller 953 # doesn't corrupt the env of the caller
913 insinto /usr/share/applications 954 insinto /usr/share/applications
914 doins "${desktop}" 955 doins "${desktop}"
915 ) 956 ) || die "installing desktop file failed"
957}
958
959# @FUNCTION: _eutils_eprefix_init
960# @INTERNAL
961# @DESCRIPTION:
962# Initialized prefix variables for EAPI<3.
963_eutils_eprefix_init() {
964 has "${EAPI:-0}" 0 1 2 && : ${ED:=${D}} ${EPREFIX:=} ${EROOT:=${ROOT}}
916} 965}
917 966
918# @FUNCTION: validate_desktop_entries 967# @FUNCTION: validate_desktop_entries
919# @USAGE: [directories] 968# @USAGE: [directories]
920# @MAINTAINER: 969# @MAINTAINER:
921# Carsten Lohrke <carlo@gentoo.org> 970# Carsten Lohrke <carlo@gentoo.org>
922# @DESCRIPTION: 971# @DESCRIPTION:
923# Validate desktop entries using desktop-file-utils 972# Validate desktop entries using desktop-file-utils
924validate_desktop_entries() { 973validate_desktop_entries() {
974 _eutils_eprefix_init
925 if [[ -x /usr/bin/desktop-file-validate ]] ; then 975 if [[ -x "${EPREFIX}"/usr/bin/desktop-file-validate ]] ; then
926 einfo "Checking desktop entry validity" 976 einfo "Checking desktop entry validity"
927 local directories="" 977 local directories=""
928 for d in /usr/share/applications $@ ; do 978 for d in /usr/share/applications $@ ; do
929 [[ -d ${D}${d} ]] && directories="${directories} ${D}${d}" 979 [[ -d ${ED}${d} ]] && directories="${directories} ${ED}${d}"
930 done 980 done
931 if [[ -n ${directories} ]] ; then 981 if [[ -n ${directories} ]] ; then
932 for FILE in $(find ${directories} -name "*\.desktop" \ 982 for FILE in $(find ${directories} -name "*\.desktop" \
933 -not -path '*.hidden*' | sort -u 2>/dev/null) 983 -not -path '*.hidden*' | sort -u 2>/dev/null)
934 do 984 do
935 local temp=$(desktop-file-validate ${FILE} | grep -v "warning:" | \ 985 local temp=$(desktop-file-validate ${FILE} | grep -v "warning:" | \
936 sed -e "s|error: ||" -e "s|${FILE}:|--|g" ) 986 sed -e "s|error: ||" -e "s|${FILE}:|--|g" )
937 [[ -n $temp ]] && elog ${temp/--/${FILE/${D}/}:} 987 [[ -n $temp ]] && elog ${temp/--/${FILE/${ED}/}:}
938 done 988 done
939 fi 989 fi
940 echo "" 990 echo ""
941 else 991 else
942 einfo "Passing desktop entry validity check. Install dev-util/desktop-file-utils, if you want to help to improve Gentoo." 992 einfo "Passing desktop entry validity check. Install dev-util/desktop-file-utils, if you want to help to improve Gentoo."
943 fi 993 fi
944} 994}
945 995
946# @FUNCTION: make_session_desktop 996# @FUNCTION: make_session_desktop
947# @USAGE: <title> <command> 997# @USAGE: <title> <command> [command args...]
948# @DESCRIPTION: 998# @DESCRIPTION:
949# Make a GDM/KDM Session file. The title is the file to execute to start the 999# Make a GDM/KDM Session file. The title is the file to execute to start the
950# Window Manager. The command is the name of the Window Manager. 1000# Window Manager. The command is the name of the Window Manager.
1001#
1002# You can set the name of the file via the ${wm} variable.
951make_session_desktop() { 1003make_session_desktop() {
952 [[ -z $1 ]] && eerror "make_session_desktop: You must specify the title" && return 1 1004 [[ -z $1 ]] && eerror "$0: You must specify the title" && return 1
953 [[ -z $2 ]] && eerror "make_session_desktop: You must specify the command" && return 1 1005 [[ -z $2 ]] && eerror "$0: You must specify the command" && return 1
954 1006
955 local title=$1 1007 local title=$1
956 local command=$2 1008 local command=$2
957 local desktop=${T}/${wm}.desktop 1009 local desktop=${T}/${wm:-${PN}}.desktop
1010 shift 2
958 1011
959 cat <<-EOF > "${desktop}" 1012 cat <<-EOF > "${desktop}"
960 [Desktop Entry] 1013 [Desktop Entry]
961 Name=${title} 1014 Name=${title}
962 Comment=This session logs you into ${title} 1015 Comment=This session logs you into ${title}
963 Exec=${command} 1016 Exec=${command} $*
964 TryExec=${command} 1017 TryExec=${command}
965 Type=Application 1018 Type=XSession
966 EOF 1019 EOF
967 1020
968 ( 1021 (
969 # wrap the env here so that the 'insinto' call 1022 # wrap the env here so that the 'insinto' call
970 # doesn't corrupt the env of the caller 1023 # doesn't corrupt the env of the caller
1012 insinto /usr/share/applications 1065 insinto /usr/share/applications
1013 newins "$@" 1066 newins "$@"
1014 ) 1067 )
1015} 1068}
1016 1069
1017# @FUNCTION: doicon 1070# @FUNCTION: _iconins
1018# @USAGE: <list of icons> 1071# @INTERNAL
1019# @DESCRIPTION: 1072# @DESCRIPTION:
1020# Install the list of icons into the icon directory (/usr/share/pixmaps). 1073# function for use in doicon and newicon
1021# This is useful in conjunction with creating desktop/menu files. 1074_iconins() {
1022doicon() {
1023 ( 1075 (
1024 # wrap the env here so that the 'insinto' call 1076 # wrap the env here so that the 'insinto' call
1025 # doesn't corrupt the env of the caller 1077 # doesn't corrupt the env of the caller
1026 local i j ret 1078 local funcname=$1; shift
1027 insinto /usr/share/pixmaps 1079 local size dir
1028 for i in "$@" ; do 1080 local context=apps
1029 if [[ -f ${i} ]] ; then 1081 local theme=hicolor
1030 doins "${i}" 1082
1031 ((ret+=$?)) 1083 while [[ $# -gt 0 ]] ; do
1032 elif [[ -d ${i} ]] ; then 1084 case $1 in
1033 for j in "${i}"/*.png ; do 1085 -s|--size)
1034 doins "${j}" 1086 if [[ ${2%%x*}x${2%%x*} == "$2" ]] ; then
1035 ((ret+=$?)) 1087 size=${2%%x*}
1036 done
1037 else 1088 else
1038 ((++ret)) 1089 size=${2}
1039 fi 1090 fi
1040 done
1041 exit ${ret}
1042 )
1043}
1044
1045# @FUNCTION: newicon
1046# @USAGE: <icon> <newname>
1047# @DESCRIPTION:
1048# Like all other new* functions, install the specified icon as newname.
1049newicon() {
1050 (
1051 # wrap the env here so that the 'insinto' call
1052 # doesn't corrupt the env of the caller
1053 insinto /usr/share/pixmaps
1054 newins "$@"
1055 )
1056}
1057
1058# for internal use only (unpack_pdv and unpack_makeself)
1059find_unpackable_file() {
1060 local src=$1
1061 if [[ -z ${src} ]] ; then
1062 src=${DISTDIR}/${A}
1063 else
1064 if [[ -e ${DISTDIR}/${src} ]] ; then
1065 src=${DISTDIR}/${src}
1066 elif [[ -e ${PWD}/${src} ]] ; then
1067 src=${PWD}/${src}
1068 elif [[ -e ${src} ]] ; then
1069 src=${src}
1070 fi
1071 fi
1072 [[ ! -e ${src} ]] && return 1
1073 echo "${src}"
1074}
1075
1076# @FUNCTION: unpack_pdv
1077# @USAGE: <file to unpack> <size of off_t>
1078# @DESCRIPTION:
1079# Unpack those pesky pdv generated files ...
1080# They're self-unpacking programs with the binary package stuffed in
1081# the middle of the archive. Valve seems to use it a lot ... too bad
1082# it seems to like to segfault a lot :(. So lets take it apart ourselves.
1083#
1084# You have to specify the off_t size ... I have no idea how to extract that
1085# information out of the binary executable myself. Basically you pass in
1086# the size of the off_t type (in bytes) on the machine that built the pdv
1087# archive.
1088#
1089# One way to determine this is by running the following commands:
1090#
1091# @CODE
1092# strings <pdv archive> | grep lseek
1093# strace -elseek <pdv archive>
1094# @CODE
1095#
1096# Basically look for the first lseek command (we do the strings/grep because
1097# sometimes the function call is _llseek or something) and steal the 2nd
1098# parameter. Here is an example:
1099#
1100# @CODE
1101# vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek
1102# lseek
1103# vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin
1104# lseek(3, -4, SEEK_END) = 2981250
1105# @CODE
1106#
1107# Thus we would pass in the value of '4' as the second parameter.
1108unpack_pdv() {
1109 local src=$(find_unpackable_file "$1")
1110 local sizeoff_t=$2
1111
1112 [[ -z ${src} ]] && die "Could not locate source for '$1'"
1113 [[ -z ${sizeoff_t} ]] && die "No idea what off_t size was used for this pdv :("
1114
1115 local shrtsrc=$(basename "${src}")
1116 echo ">>> Unpacking ${shrtsrc} to ${PWD}"
1117 local metaskip=$(tail -c ${sizeoff_t} "${src}" | hexdump -e \"%i\")
1118 local tailskip=$(tail -c $((${sizeoff_t}*2)) "${src}" | head -c ${sizeoff_t} | hexdump -e \"%i\")
1119
1120 # grab metadata for debug reasons
1121 local metafile=$(emktemp)
1122 tail -c +$((${metaskip}+1)) "${src}" > "${metafile}"
1123
1124 # rip out the final file name from the metadata
1125 local datafile=$(tail -c +$((${metaskip}+1)) "${src}" | strings | head -n 1)
1126 datafile=$(basename "${datafile}")
1127
1128 # now lets uncompress/untar the file if need be
1129 local tmpfile=$(emktemp)
1130 tail -c +$((${tailskip}+1)) ${src} 2>/dev/null | head -c 512 > ${tmpfile}
1131
1132 local iscompressed=$(file -b "${tmpfile}")
1133 if [[ ${iscompressed:0:8} == "compress" ]] ; then
1134 iscompressed=1
1135 mv ${tmpfile}{,.Z}
1136 gunzip ${tmpfile}
1137 else
1138 iscompressed=0
1139 fi
1140 local istar=$(file -b "${tmpfile}")
1141 if [[ ${istar:0:9} == "POSIX tar" ]] ; then
1142 istar=1
1143 else
1144 istar=0
1145 fi
1146
1147 #for some reason gzip dies with this ... dd cant provide buffer fast enough ?
1148 #dd if=${src} ibs=${metaskip} count=1 \
1149 # | dd ibs=${tailskip} skip=1 \
1150 # | gzip -dc \
1151 # > ${datafile}
1152 if [ ${iscompressed} -eq 1 ] ; then
1153 if [ ${istar} -eq 1 ] ; then
1154 tail -c +$((${tailskip}+1)) ${src} 2>/dev/null \
1155 | head -c $((${metaskip}-${tailskip})) \
1156 | tar -xzf -
1157 else
1158 tail -c +$((${tailskip}+1)) ${src} 2>/dev/null \
1159 | head -c $((${metaskip}-${tailskip})) \
1160 | gzip -dc \
1161 > ${datafile}
1162 fi
1163 else
1164 if [ ${istar} -eq 1 ] ; then
1165 tail -c +$((${tailskip}+1)) ${src} 2>/dev/null \
1166 | head -c $((${metaskip}-${tailskip})) \
1167 | tar --no-same-owner -xf -
1168 else
1169 tail -c +$((${tailskip}+1)) ${src} 2>/dev/null \
1170 | head -c $((${metaskip}-${tailskip})) \
1171 > ${datafile}
1172 fi
1173 fi
1174 true
1175 #[ -s "${datafile}" ] || die "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')"
1176 #assert "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')"
1177}
1178
1179# @FUNCTION: unpack_makeself
1180# @USAGE: [file to unpack] [offset] [tail|dd]
1181# @DESCRIPTION:
1182# Unpack those pesky makeself generated files ...
1183# They're shell scripts with the binary package tagged onto
1184# the end of the archive. Loki utilized the format as does
1185# many other game companies.
1186#
1187# If the file is not specified, then ${A} is used. If the
1188# offset is not specified then we will attempt to extract
1189# the proper offset from the script itself.
1190unpack_makeself() {
1191 local src_input=${1:-${A}}
1192 local src=$(find_unpackable_file "${src_input}")
1193 local skip=$2
1194 local exe=$3
1195
1196 [[ -z ${src} ]] && die "Could not locate source for '${src_input}'"
1197
1198 local shrtsrc=$(basename "${src}")
1199 echo ">>> Unpacking ${shrtsrc} to ${PWD}"
1200 if [[ -z ${skip} ]] ; then
1201 local ver=$(grep -a '#.*Makeself' "${src}" | awk '{print $NF}')
1202 local skip=0
1203 exe=tail
1204 case ${ver} in 1091 case ${size} in
1205 1.5.*|1.6.0-nv) # tested 1.5.{3,4,5} ... guessing 1.5.x series is same 1092 16|22|24|32|36|48|64|72|96|128|192|256|512)
1206 skip=$(grep -a ^skip= "${src}" | cut -d= -f2) 1093 size=${size}x${size};;
1207 ;; 1094 scalable)
1208 2.0|2.0.1)
1209 skip=$(grep -a ^$'\t'tail "${src}" | awk '{print $2}' | cut -b2-)
1210 ;;
1211 2.1.1)
1212 skip=$(grep -a ^offset= "${src}" | awk '{print $2}' | cut -b2-)
1213 let skip="skip + 1"
1214 ;;
1215 2.1.2)
1216 skip=$(grep -a ^offset= "${src}" | awk '{print $3}' | head -n 1)
1217 let skip="skip + 1"
1218 ;;
1219 2.1.3)
1220 skip=`grep -a ^offset= "${src}" | awk '{print $3}'`
1221 let skip="skip + 1"
1222 ;;
1223 2.1.4|2.1.5)
1224 skip=$(grep -a offset=.*head.*wc "${src}" | awk '{print $3}' | head -n 1)
1225 skip=$(head -n ${skip} "${src}" | wc -c)
1226 exe="dd"
1227 ;; 1095 ;;
1228 *) 1096 *)
1229 eerror "I'm sorry, but I was unable to support the Makeself file." 1097 eerror "${size} is an unsupported icon size!"
1230 eerror "The version I detected was '${ver}'." 1098 exit 1;;
1231 eerror "Please file a bug about the file ${shrtsrc} at"
1232 eerror "http://bugs.gentoo.org/ so that support can be added."
1233 die "makeself version '${ver}' not supported"
1234 ;;
1235 esac 1099 esac
1236 debug-print "Detected Makeself version ${ver} ... using ${skip} as offset" 1100 shift 2;;
1237 fi 1101 -t|--theme)
1238 case ${exe} in 1102 theme=${2}
1239 tail) exe="tail -n +${skip} '${src}'";; 1103 shift 2;;
1240 dd) exe="dd ibs=${skip} skip=1 obs=1024 conv=sync if='${src}'";; 1104 -c|--context)
1241 *) die "makeself cant handle exe '${exe}'" 1105 context=${2}
1242 esac 1106 shift 2;;
1243
1244 # lets grab the first few bytes of the file to figure out what kind of archive it is
1245 local tmpfile=$(emktemp)
1246 eval ${exe} 2>/dev/null | head -c 512 > "${tmpfile}"
1247 local filetype=$(file -b "${tmpfile}")
1248 case ${filetype} in
1249 *tar\ archive*)
1250 eval ${exe} | tar --no-same-owner -xf -
1251 ;;
1252 bzip2*)
1253 eval ${exe} | bzip2 -dc | tar --no-same-owner -xf -
1254 ;;
1255 gzip*)
1256 eval ${exe} | tar --no-same-owner -xzf -
1257 ;;
1258 compress*)
1259 eval ${exe} | gunzip | tar --no-same-owner -xf -
1260 ;;
1261 *) 1107 *)
1262 eerror "Unknown filetype \"${filetype}\" ?"
1263 false
1264 ;;
1265 esac
1266 assert "failure unpacking (${filetype}) makeself ${shrtsrc} ('${ver}' +${skip})"
1267}
1268
1269# @FUNCTION: check_license
1270# @USAGE: [license]
1271# @DESCRIPTION:
1272# Display a license for user to accept. If no license is
1273# specified, then ${LICENSE} is used.
1274check_license() {
1275 local lic=$1
1276 if [ -z "${lic}" ] ; then
1277 lic="${PORTDIR}/licenses/${LICENSE}"
1278 else
1279 if [ -e "${PORTDIR}/licenses/${lic}" ] ; then
1280 lic="${PORTDIR}/licenses/${lic}"
1281 elif [ -e "${PWD}/${lic}" ] ; then
1282 lic="${PWD}/${lic}"
1283 elif [ -e "${lic}" ] ; then
1284 lic="${lic}"
1285 fi
1286 fi
1287 [ ! -f "${lic}" ] && die "Could not find requested license ${lic}"
1288 local l="`basename ${lic}`"
1289
1290 # here is where we check for the licenses the user already
1291 # accepted ... if we don't find a match, we make the user accept
1292 local shopts=$-
1293 local alic
1294 set -o noglob #so that bash doesn't expand "*"
1295 for alic in ${ACCEPT_LICENSE} ; do
1296 if [[ ${alic} == ${l} ]]; then
1297 set +o noglob; set -${shopts} #reset old shell opts
1298 return 0
1299 fi
1300 done
1301 set +o noglob; set -$shopts #reset old shell opts
1302
1303 local licmsg=$(emktemp)
1304 cat <<-EOF > ${licmsg}
1305 **********************************************************
1306 The following license outlines the terms of use of this
1307 package. You MUST accept this license for installation to
1308 continue. When you are done viewing, hit 'q'. If you
1309 CTRL+C out of this, the install will not run!
1310 **********************************************************
1311
1312 EOF
1313 cat ${lic} >> ${licmsg}
1314 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}"
1315 einfon "Do you accept the terms of this license (${l})? [yes/no] "
1316 read alic
1317 case ${alic} in
1318 yes|Yes|y|Y)
1319 return 0
1320 ;;
1321 *)
1322 echo;echo;echo
1323 eerror "You MUST accept the license to continue! Exiting!"
1324 die "Failed to accept license"
1325 ;;
1326 esac
1327}
1328
1329# @FUNCTION: cdrom_get_cds
1330# @USAGE: <file on cd1> [file on cd2] [file on cd3] [...]
1331# @DESCRIPTION:
1332# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates
1333# the whole 'non-interactive' policy, but damnit I want CD support !
1334#
1335# With these cdrom functions we handle all the user interaction and
1336# standardize everything. All you have to do is call cdrom_get_cds()
1337# and when the function returns, you can assume that the cd has been
1338# found at CDROM_ROOT.
1339#
1340# The function will attempt to locate a cd based upon a file that is on
1341# the cd. The more files you give this function, the more cds
1342# the cdrom functions will handle.
1343#
1344# Normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2',
1345# etc... If you want to give the cds better names, then just export
1346# the appropriate CDROM_NAME variable before calling cdrom_get_cds().
1347# Use CDROM_NAME for one cd, or CDROM_NAME_# for multiple cds. You can
1348# also use the CDROM_NAME_SET bash array.
1349#
1350# For those multi cd ebuilds, see the cdrom_load_next_cd() function.
1351cdrom_get_cds() {
1352 # first we figure out how many cds we're dealing with by
1353 # the # of files they gave us
1354 local cdcnt=0
1355 local f=
1356 for f in "$@" ; do
1357 ((++cdcnt))
1358 export CDROM_CHECK_${cdcnt}="$f"
1359 done
1360 export CDROM_TOTAL_CDS=${cdcnt}
1361 export CDROM_CURRENT_CD=1
1362
1363 # now we see if the user gave use CD_ROOT ...
1364 # if they did, let's just believe them that it's correct
1365 if [[ -n ${CD_ROOT}${CD_ROOT_1} ]] ; then
1366 local var=
1367 cdcnt=0
1368 while [[ ${cdcnt} -lt ${CDROM_TOTAL_CDS} ]] ; do
1369 ((++cdcnt))
1370 var="CD_ROOT_${cdcnt}"
1371 [[ -z ${!var} ]] && var="CD_ROOT"
1372 if [[ -z ${!var} ]] ; then 1108 if [[ -z ${size} ]] ; then
1373 eerror "You must either use just the CD_ROOT" 1109 insinto /usr/share/pixmaps
1374 eerror "or specify ALL the CD_ROOT_X variables." 1110 else
1375 eerror "In this case, you will need ${CDROM_TOTAL_CDS} CD_ROOT_X variables." 1111 insinto /usr/share/icons/${theme}/${size}/${context}
1376 die "could not locate CD_ROOT_${cdcnt}"
1377 fi 1112 fi
1378 done
1379 export CDROM_ROOT=${CD_ROOT_1:-${CD_ROOT}}
1380 einfo "Found CD #${CDROM_CURRENT_CD} root at ${CDROM_ROOT}"
1381 export CDROM_SET=-1
1382 for f in ${CDROM_CHECK_1//:/ } ; do
1383 ((++CDROM_SET))
1384 [[ -e ${CD_ROOT}/${f} ]] && break
1385 done
1386 export CDROM_MATCH=${f}
1387 return
1388 fi
1389 1113
1390 # User didn't help us out so lets make sure they know they can 1114 if [[ ${funcname} == doicon ]] ; then
1391 # simplify the whole process ...
1392 if [[ ${CDROM_TOTAL_CDS} -eq 1 ]] ; then
1393 einfo "This ebuild will need the ${CDROM_NAME:-cdrom for ${PN}}"
1394 echo
1395 einfo "If you do not have the CD, but have the data files"
1396 einfo "mounted somewhere on your filesystem, just export"
1397 einfo "the variable CD_ROOT so that it points to the"
1398 einfo "directory containing the files."
1399 echo
1400 einfo "For example:"
1401 einfo "export CD_ROOT=/mnt/cdrom"
1402 echo
1403 else
1404 if [[ -n ${CDROM_NAME_SET} ]] ; then
1405 # Translate the CDROM_NAME_SET array into CDROM_NAME_#
1406 cdcnt=0
1407 while [[ ${cdcnt} -lt ${CDROM_TOTAL_CDS} ]] ; do
1408 ((++cdcnt))
1409 export CDROM_NAME_${cdcnt}="${CDROM_NAME_SET[$((${cdcnt}-1))]}"
1410 done
1411 fi
1412
1413 einfo "This package will need access to ${CDROM_TOTAL_CDS} cds."
1414 cdcnt=0
1415 while [[ ${cdcnt} -lt ${CDROM_TOTAL_CDS} ]] ; do
1416 ((++cdcnt))
1417 var="CDROM_NAME_${cdcnt}"
1418 [[ ! -z ${!var} ]] && einfo " CD ${cdcnt}: ${!var}"
1419 done
1420 echo
1421 einfo "If you do not have the CDs, but have the data files"
1422 einfo "mounted somewhere on your filesystem, just export"
1423 einfo "the following variables so they point to the right place:"
1424 einfon ""
1425 cdcnt=0
1426 while [[ ${cdcnt} -lt ${CDROM_TOTAL_CDS} ]] ; do
1427 ((++cdcnt))
1428 echo -n " CD_ROOT_${cdcnt}"
1429 done
1430 echo
1431 einfo "Or, if you have all the files in the same place, or"
1432 einfo "you only have one cdrom, you can export CD_ROOT"
1433 einfo "and that place will be used as the same data source"
1434 einfo "for all the CDs."
1435 echo
1436 einfo "For example:"
1437 einfo "export CD_ROOT_1=/mnt/cdrom"
1438 echo
1439 fi
1440
1441 export CDROM_SET=""
1442 export CDROM_CURRENT_CD=0
1443 cdrom_load_next_cd
1444}
1445
1446# @FUNCTION: cdrom_load_next_cd
1447# @DESCRIPTION:
1448# Some packages are so big they come on multiple CDs. When you're done reading
1449# files off a CD and want access to the next one, just call this function.
1450# Again, all the messy details of user interaction are taken care of for you.
1451# Once this returns, just read the variable CDROM_ROOT for the location of the
1452# mounted CD. Note that you can only go forward in the CD list, so make sure
1453# you only call this function when you're done using the current CD.
1454cdrom_load_next_cd() {
1455 local var
1456 ((++CDROM_CURRENT_CD))
1457
1458 unset CDROM_ROOT
1459 var=CD_ROOT_${CDROM_CURRENT_CD}
1460 [[ -z ${!var} ]] && var="CD_ROOT"
1461 if [[ -z ${!var} ]] ; then 1115 if [[ -f $1 ]] ; then
1462 var="CDROM_CHECK_${CDROM_CURRENT_CD}" 1116 doins "${1}"
1463 _cdrom_locate_file_on_cd ${!var} 1117 elif [[ -d $1 ]] ; then
1464 else 1118 shopt -s nullglob
1465 export CDROM_ROOT=${!var} 1119 doins "${1}"/*.{png,svg}
1466 fi 1120 shopt -u nullglob
1467
1468 einfo "Found CD #${CDROM_CURRENT_CD} root at ${CDROM_ROOT}"
1469}
1470
1471# this is used internally by the cdrom_get_cds() and cdrom_load_next_cd()
1472# functions. this should *never* be called from an ebuild.
1473# all it does is try to locate a give file on a cd ... if the cd isn't
1474# found, then a message asking for the user to insert the cdrom will be
1475# displayed and we'll hang out here until:
1476# (1) the file is found on a mounted cdrom
1477# (2) the user hits CTRL+C
1478_cdrom_locate_file_on_cd() {
1479 local mline=""
1480 local showedmsg=0 showjolietmsg=0
1481
1482 while [[ -z ${CDROM_ROOT} ]] ; do
1483 local i=0
1484 local -a cdset=(${*//:/ })
1485 if [[ -n ${CDROM_SET} ]] ; then
1486 cdset=(${cdset[${CDROM_SET}]})
1487 fi
1488
1489 while [[ -n ${cdset[${i}]} ]] ; do
1490 local dir=$(dirname ${cdset[${i}]})
1491 local file=$(basename ${cdset[${i}]})
1492
1493 local point= node= fs= foo=
1494 while read point node fs foo ; do
1495 [[ " cd9660 iso9660 udf " != *" ${fs} "* ]] && \
1496 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \
1497 && continue
1498 point=${point//\040/ }
1499 [[ ! -d ${point}/${dir} ]] && continue
1500 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue
1501 export CDROM_ROOT=${point}
1502 export CDROM_SET=${i}
1503 export CDROM_MATCH=${cdset[${i}]}
1504 return
1505 done <<< "$(get_mounts)"
1506
1507 ((++i))
1508 done
1509
1510 echo
1511 if [[ ${showedmsg} -eq 0 ]] ; then
1512 if [[ ${CDROM_TOTAL_CDS} -eq 1 ]] ; then
1513 if [[ -z ${CDROM_NAME} ]] ; then
1514 einfo "Please insert+mount the cdrom for ${PN} now !"
1515 else 1121 else
1516 einfo "Please insert+mount the ${CDROM_NAME} cdrom now !" 1122 eerror "${1} is not a valid file/directory!"
1123 exit 1
1517 fi 1124 fi
1518 else 1125 else
1519 if [[ -z ${CDROM_NAME_1} ]] ; then 1126 break
1520 einfo "Please insert+mount cd #${CDROM_CURRENT_CD} for ${PN} now !"
1521 else
1522 local var="CDROM_NAME_${CDROM_CURRENT_CD}"
1523 einfo "Please insert+mount the ${!var} cdrom now !"
1524 fi
1525 fi 1127 fi
1526 showedmsg=1 1128 shift 1;;
1527 fi 1129 esac
1528 einfo "Press return to scan for the cd again"
1529 einfo "or hit CTRL+C to abort the emerge."
1530 echo
1531 if [[ ${showjolietmsg} -eq 0 ]] ; then
1532 showjolietmsg=1
1533 else
1534 ewarn "If you are having trouble with the detection"
1535 ewarn "of your CD, it is possible that you do not have"
1536 ewarn "Joliet support enabled in your kernel. Please"
1537 ewarn "check that CONFIG_JOLIET is enabled in your kernel."
1538 ebeep 5
1539 fi
1540 read || die "something is screwed with your system"
1541 done 1130 done
1131 if [[ ${funcname} == newicon ]] ; then
1132 newins "$@"
1133 fi
1134 ) || die
1135}
1136
1137# @FUNCTION: doicon
1138# @USAGE: [options] <icons>
1139# @DESCRIPTION:
1140# Install icon into the icon directory /usr/share/icons or into
1141# /usr/share/pixmaps if "--size" is not set.
1142# This is useful in conjunction with creating desktop/menu files.
1143#
1144# @CODE
1145# options:
1146# -s, --size
1147# !!! must specify to install into /usr/share/icons/... !!!
1148# size of the icon, like 48 or 48x48
1149# supported icon sizes are:
1150# 16 22 24 32 36 48 64 72 96 128 192 256 scalable
1151# -c, --context
1152# defaults to "apps"
1153# -t, --theme
1154# defaults to "hicolor"
1155#
1156# icons: list of icons
1157#
1158# example 1: doicon foobar.png fuqbar.svg suckbar.png
1159# results in: insinto /usr/share/pixmaps
1160# doins foobar.png fuqbar.svg suckbar.png
1161#
1162# example 2: doicon -s 48 foobar.png fuqbar.png blobbar.png
1163# results in: insinto /usr/share/icons/hicolor/48x48/apps
1164# doins foobar.png fuqbar.png blobbar.png
1165# @CODE
1166doicon() {
1167 _iconins ${FUNCNAME} "$@"
1168}
1169
1170# @FUNCTION: newicon
1171# @USAGE: [options] <icon> <newname>
1172# @DESCRIPTION:
1173# Like doicon, install the specified icon as newname.
1174#
1175# @CODE
1176# example 1: newicon foobar.png NEWNAME.png
1177# results in: insinto /usr/share/pixmaps
1178# newins foobar.png NEWNAME.png
1179#
1180# example 2: newicon -s 48 foobar.png NEWNAME.png
1181# results in: insinto /usr/share/icons/hicolor/48x48/apps
1182# newins foobar.png NEWNAME.png
1183# @CODE
1184newicon() {
1185 _iconins ${FUNCNAME} "$@"
1542} 1186}
1543 1187
1544# @FUNCTION: strip-linguas 1188# @FUNCTION: strip-linguas
1545# @USAGE: [<allow LINGUAS>|<-i|-u> <directories of .po files>] 1189# @USAGE: [<allow LINGUAS>|<-i|-u> <directories of .po files>]
1546# @DESCRIPTION: 1190# @DESCRIPTION:
1553# of the lists. 1197# of the lists.
1554strip-linguas() { 1198strip-linguas() {
1555 local ls newls nols 1199 local ls newls nols
1556 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then 1200 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then
1557 local op=$1; shift 1201 local op=$1; shift
1558 ls=$(find "$1" -name '*.po' -exec basename {} .po \;); shift 1202 ls=$(find "$1" -name '*.po' -exec basename {} .po ';'); shift
1559 local d f 1203 local d f
1560 for d in "$@" ; do 1204 for d in "$@" ; do
1561 if [[ ${op} == "-u" ]] ; then 1205 if [[ ${op} == "-u" ]] ; then
1562 newls=${ls} 1206 newls=${ls}
1563 else 1207 else
1564 newls="" 1208 newls=""
1565 fi 1209 fi
1566 for f in $(find "$d" -name '*.po' -exec basename {} .po \;) ; do 1210 for f in $(find "$d" -name '*.po' -exec basename {} .po ';') ; do
1567 if [[ ${op} == "-i" ]] ; then 1211 if [[ ${op} == "-i" ]] ; then
1568 hasq ${f} ${ls} && newls="${newls} ${f}" 1212 has ${f} ${ls} && newls="${newls} ${f}"
1569 else 1213 else
1570 hasq ${f} ${ls} || newls="${newls} ${f}" 1214 has ${f} ${ls} || newls="${newls} ${f}"
1571 fi 1215 fi
1572 done 1216 done
1573 ls=${newls} 1217 ls=${newls}
1574 done 1218 done
1575 else 1219 else
1577 fi 1221 fi
1578 1222
1579 nols="" 1223 nols=""
1580 newls="" 1224 newls=""
1581 for f in ${LINGUAS} ; do 1225 for f in ${LINGUAS} ; do
1582 if hasq ${f} ${ls} ; then 1226 if has ${f} ${ls} ; then
1583 newls="${newls} ${f}" 1227 newls="${newls} ${f}"
1584 else 1228 else
1585 nols="${nols} ${f}" 1229 nols="${nols} ${f}"
1586 fi 1230 fi
1587 done 1231 done
1588 [[ -n ${nols} ]] \ 1232 [[ -n ${nols} ]] \
1589 && ewarn "Sorry, but ${PN} does not support the LINGUAs:" ${nols} 1233 && einfo "Sorry, but ${PN} does not support the LINGUAS:" ${nols}
1590 export LINGUAS=${newls:1} 1234 export LINGUAS=${newls:1}
1591} 1235}
1592 1236
1593# @FUNCTION: preserve_old_lib 1237# @FUNCTION: preserve_old_lib
1594# @USAGE: <libs to preserve> [more libs] 1238# @USAGE: <libs to preserve> [more libs]
1598# would break packages that link against it. Most people get around this 1242# would break packages that link against it. Most people get around this
1599# by using the portage SLOT mechanism, but that is not always a relevant 1243# by using the portage SLOT mechanism, but that is not always a relevant
1600# solution, so instead you can call this from pkg_preinst. See also the 1244# solution, so instead you can call this from pkg_preinst. See also the
1601# preserve_old_lib_notify function. 1245# preserve_old_lib_notify function.
1602preserve_old_lib() { 1246preserve_old_lib() {
1247 _eutils_eprefix_init
1603 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then 1248 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then
1604 eerror "preserve_old_lib() must be called from pkg_preinst() only" 1249 eerror "preserve_old_lib() must be called from pkg_preinst() only"
1605 die "Invalid preserve_old_lib() usage" 1250 die "Invalid preserve_old_lib() usage"
1606 fi 1251 fi
1607 [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]" 1252 [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]"
1609 # let portage worry about it 1254 # let portage worry about it
1610 has preserve-libs ${FEATURES} && return 0 1255 has preserve-libs ${FEATURES} && return 0
1611 1256
1612 local lib dir 1257 local lib dir
1613 for lib in "$@" ; do 1258 for lib in "$@" ; do
1614 [[ -e ${ROOT}/${lib} ]] || continue 1259 [[ -e ${EROOT}/${lib} ]] || continue
1615 dir=${lib%/*} 1260 dir=${lib%/*}
1616 dodir ${dir} || die "dodir ${dir} failed" 1261 dodir ${dir} || die "dodir ${dir} failed"
1617 cp "${ROOT}"/${lib} "${D}"/${lib} || die "cp ${lib} failed" 1262 cp "${EROOT}"/${lib} "${ED}"/${lib} || die "cp ${lib} failed"
1618 touch "${D}"/${lib} 1263 touch "${ED}"/${lib}
1619 done 1264 done
1620} 1265}
1621 1266
1622# @FUNCTION: preserve_old_lib_notify 1267# @FUNCTION: preserve_old_lib_notify
1623# @USAGE: <libs to notify> [more libs] 1268# @USAGE: <libs to notify> [more libs]
1630 fi 1275 fi
1631 1276
1632 # let portage worry about it 1277 # let portage worry about it
1633 has preserve-libs ${FEATURES} && return 0 1278 has preserve-libs ${FEATURES} && return 0
1634 1279
1280 _eutils_eprefix_init
1281
1635 local lib notice=0 1282 local lib notice=0
1636 for lib in "$@" ; do 1283 for lib in "$@" ; do
1637 [[ -e ${ROOT}/${lib} ]] || continue 1284 [[ -e ${EROOT}/${lib} ]] || continue
1638 if [[ ${notice} -eq 0 ]] ; then 1285 if [[ ${notice} -eq 0 ]] ; then
1639 notice=1 1286 notice=1
1640 ewarn "Old versions of installed libraries were detected on your system." 1287 ewarn "Old versions of installed libraries were detected on your system."
1641 ewarn "In order to avoid breaking packages that depend on these old libs," 1288 ewarn "In order to avoid breaking packages that depend on these old libs,"
1642 ewarn "the libraries are not being removed. You need to run revdep-rebuild" 1289 ewarn "the libraries are not being removed. You need to run revdep-rebuild"
1643 ewarn "in order to remove these old dependencies. If you do not have this" 1290 ewarn "in order to remove these old dependencies. If you do not have this"
1644 ewarn "helper program, simply emerge the 'gentoolkit' package." 1291 ewarn "helper program, simply emerge the 'gentoolkit' package."
1645 ewarn 1292 ewarn
1646 fi 1293 fi
1647 ewarn " # revdep-rebuild --library ${lib##*/}" 1294 ewarn " # revdep-rebuild --library '${lib}' && rm '${lib}'"
1648 done 1295 done
1649 if [[ ${notice} -eq 1 ]] ; then
1650 ewarn
1651 ewarn "Once you've finished running revdep-rebuild, it should be safe to"
1652 ewarn "delete the old libraries. Here is a copy & paste for the lazy:"
1653 for lib in "$@" ; do
1654 ewarn " # rm '${lib}'"
1655 done
1656 fi
1657} 1296}
1658 1297
1659# @FUNCTION: built_with_use 1298# @FUNCTION: built_with_use
1660# @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags> 1299# @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags>
1661# @DESCRIPTION: 1300# @DESCRIPTION:
1301#
1302# Deprecated: Use EAPI 2 use deps in DEPEND|RDEPEND and with has_version calls.
1303#
1662# A temporary hack until portage properly supports DEPENDing on USE 1304# A temporary hack until portage properly supports DEPENDing on USE
1663# flags being enabled in packages. This will check to see if the specified 1305# flags being enabled in packages. This will check to see if the specified
1664# DEPEND atom was built with the specified list of USE flags. The 1306# DEPEND atom was built with the specified list of USE flags. The
1665# --missing option controls the behavior if called on a package that does 1307# --missing option controls the behavior if called on a package that does
1666# not actually support the defined USE flags (aka listed in IUSE). 1308# not actually support the defined USE flags (aka listed in IUSE).
1667# The default is to abort (call die). The -a and -o flags control 1309# The default is to abort (call die). The -a and -o flags control
1668# the requirements of the USE flags. They correspond to "and" and "or" 1310# the requirements of the USE flags. They correspond to "and" and "or"
1669# logic. So the -a flag means all listed USE flags must be enabled 1311# logic. So the -a flag means all listed USE flags must be enabled
1670# while the -o flag means at least one of the listed fIUSE flags must be 1312# while the -o flag means at least one of the listed IUSE flags must be
1671# enabled. The --hidden option is really for internal use only as it 1313# enabled. The --hidden option is really for internal use only as it
1672# means the USE flag we're checking is hidden expanded, so it won't be found 1314# means the USE flag we're checking is hidden expanded, so it won't be found
1673# in IUSE like normal USE flags. 1315# in IUSE like normal USE flags.
1674# 1316#
1675# Remember that this function isn't terribly intelligent so order of optional 1317# Remember that this function isn't terribly intelligent so order of optional
1676# flags matter. 1318# flags matter.
1677built_with_use() { 1319built_with_use() {
1320 _eutils_eprefix_init
1678 local hidden="no" 1321 local hidden="no"
1679 if [[ $1 == "--hidden" ]] ; then 1322 if [[ $1 == "--hidden" ]] ; then
1680 hidden="yes" 1323 hidden="yes"
1681 shift 1324 shift
1682 fi 1325 fi
1696 1339
1697 local PKG=$(best_version $1) 1340 local PKG=$(best_version $1)
1698 [[ -z ${PKG} ]] && die "Unable to resolve $1 to an installed package" 1341 [[ -z ${PKG} ]] && die "Unable to resolve $1 to an installed package"
1699 shift 1342 shift
1700 1343
1701 local USEFILE=${ROOT}/var/db/pkg/${PKG}/USE 1344 local USEFILE=${EROOT}/var/db/pkg/${PKG}/USE
1702 local IUSEFILE=${ROOT}/var/db/pkg/${PKG}/IUSE 1345 local IUSEFILE=${EROOT}/var/db/pkg/${PKG}/IUSE
1703 1346
1704 # if the IUSE file doesn't exist, the read will error out, we need to handle 1347 # if the IUSE file doesn't exist, the read will error out, we need to handle
1705 # this gracefully 1348 # this gracefully
1706 if [[ ! -e ${USEFILE} ]] || [[ ! -e ${IUSEFILE} && ${hidden} == "no" ]] ; then 1349 if [[ ! -e ${USEFILE} ]] || [[ ! -e ${IUSEFILE} && ${hidden} == "no" ]] ; then
1707 case ${missing_action} in 1350 case ${missing_action} in
1753# http://bugs.gentoo.org/73450 1396# http://bugs.gentoo.org/73450
1754epunt_cxx() { 1397epunt_cxx() {
1755 local dir=$1 1398 local dir=$1
1756 [[ -z ${dir} ]] && dir=${S} 1399 [[ -z ${dir} ]] && dir=${S}
1757 ebegin "Removing useless C++ checks" 1400 ebegin "Removing useless C++ checks"
1758 local f 1401 local f p any_found
1759 find "${dir}" -name configure | while read f ; do 1402 while IFS= read -r -d '' f; do
1760 patch --no-backup-if-mismatch -p0 "${f}" "${PORTDIR}/eclass/ELT-patches/nocxx/nocxx.patch" > /dev/null 1403 for p in "${PORTDIR}"/eclass/ELT-patches/nocxx/*.patch ; do
1404 if patch --no-backup-if-mismatch -p1 "${f}" "${p}" >/dev/null ; then
1405 any_found=1
1406 break
1407 fi
1761 done 1408 done
1409 done < <(find "${dir}" -name configure -print0)
1410
1411 if [[ -z ${any_found} ]]; then
1412 eqawarn "epunt_cxx called unnecessarily (no C++ checks to punt)."
1413 fi
1762 eend 0 1414 eend 0
1763} 1415}
1764 1416
1765# @FUNCTION: make_wrapper 1417# @FUNCTION: make_wrapper
1766# @USAGE: <wrapper> <target> [chdir] [libpaths] [installpath] 1418# @USAGE: <wrapper> <target> [chdir] [libpaths] [installpath]
1768# Create a shell wrapper script named wrapper in installpath 1420# Create a shell wrapper script named wrapper in installpath
1769# (defaults to the bindir) to execute target (default of wrapper) by 1421# (defaults to the bindir) to execute target (default of wrapper) by
1770# first optionally setting LD_LIBRARY_PATH to the colon-delimited 1422# first optionally setting LD_LIBRARY_PATH to the colon-delimited
1771# libpaths followed by optionally changing directory to chdir. 1423# libpaths followed by optionally changing directory to chdir.
1772make_wrapper() { 1424make_wrapper() {
1425 _eutils_eprefix_init
1773 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5 1426 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5
1774 local tmpwrapper=$(emktemp) 1427 local tmpwrapper=$(emktemp)
1428
1429 (
1430 echo '#!/bin/sh'
1431 [[ -n ${chdir} ]] && printf 'cd "%s"\n' "${EPREFIX}${chdir}"
1432 if [[ -n ${libdir} ]] ; then
1433 local var
1434 if [[ ${CHOST} == *-darwin* ]] ; then
1435 var=DYLD_LIBRARY_PATH
1436 else
1437 var=LD_LIBRARY_PATH
1438 fi
1439 cat <<-EOF
1440 if [ "\${${var}+set}" = "set" ] ; then
1441 export ${var}="\${${var}}:${EPREFIX}${libdir}"
1442 else
1443 export ${var}="${EPREFIX}${libdir}"
1444 fi
1445 EOF
1446 fi
1775 # We don't want to quote ${bin} so that people can pass complex 1447 # We don't want to quote ${bin} so that people can pass complex
1776 # things as $bin ... "./someprog --args" 1448 # things as ${bin} ... "./someprog --args"
1449 printf 'exec %s "$@"\n' "${bin/#\//${EPREFIX}/}"
1777 cat << EOF > "${tmpwrapper}" 1450 ) > "${tmpwrapper}"
1778#!/bin/sh
1779cd "${chdir:-.}"
1780if [ -n "${libdir}" ] ; then
1781 if [ "\${LD_LIBRARY_PATH+set}" = "set" ] ; then
1782 export LD_LIBRARY_PATH="\${LD_LIBRARY_PATH}:${libdir}"
1783 else
1784 export LD_LIBRARY_PATH="${libdir}"
1785 fi
1786fi
1787exec ${bin} "\$@"
1788EOF
1789 chmod go+rx "${tmpwrapper}" 1451 chmod go+rx "${tmpwrapper}"
1452
1790 if [[ -n ${path} ]] ; then 1453 if [[ -n ${path} ]] ; then
1791 ( 1454 (
1792 exeinto "${path}" 1455 exeinto "${path}"
1793 newexe "${tmpwrapper}" "${wrapper}" 1456 newexe "${tmpwrapper}" "${wrapper}"
1794 ) || die 1457 ) || die
1795 else 1458 else
1796 newbin "${tmpwrapper}" "${wrapper}" || die 1459 newbin "${tmpwrapper}" "${wrapper}" || die
1797 fi 1460 fi
1798} 1461}
1462
1463# @FUNCTION: path_exists
1464# @USAGE: [-a|-o] <paths>
1465# @DESCRIPTION:
1466# Check if the specified paths exist. Works for all types of paths
1467# (files/dirs/etc...). The -a and -o flags control the requirements
1468# of the paths. They correspond to "and" and "or" logic. So the -a
1469# flag means all the paths must exist while the -o flag means at least
1470# one of the paths must exist. The default behavior is "and". If no
1471# paths are specified, then the return value is "false".
1472path_exists() {
1473 local opt=$1
1474 [[ ${opt} == -[ao] ]] && shift || opt="-a"
1475
1476 # no paths -> return false
1477 # same behavior as: [[ -e "" ]]
1478 [[ $# -eq 0 ]] && return 1
1479
1480 local p r=0
1481 for p in "$@" ; do
1482 [[ -e ${p} ]]
1483 : $(( r += $? ))
1484 done
1485
1486 case ${opt} in
1487 -a) return $(( r != 0 )) ;;
1488 -o) return $(( r == $# )) ;;
1489 esac
1490}
1491
1492# @FUNCTION: in_iuse
1493# @USAGE: <flag>
1494# @DESCRIPTION:
1495# Determines whether the given flag is in IUSE. Strips IUSE default prefixes
1496# as necessary.
1497#
1498# Note that this function should not be used in the global scope.
1499in_iuse() {
1500 debug-print-function ${FUNCNAME} "${@}"
1501 [[ ${#} -eq 1 ]] || die "Invalid args to ${FUNCNAME}()"
1502
1503 local flag=${1}
1504 local liuse=( ${IUSE} )
1505
1506 has "${flag}" "${liuse[@]#[+-]}"
1507}
1508
1509# @FUNCTION: use_if_iuse
1510# @USAGE: <flag>
1511# @DESCRIPTION:
1512# Return true if the given flag is in USE and IUSE.
1513#
1514# Note that this function should not be used in the global scope.
1515use_if_iuse() {
1516 in_iuse $1 || return 1
1517 use $1
1518}
1519
1520# @FUNCTION: usex
1521# @USAGE: <USE flag> [true output] [false output] [true suffix] [false suffix]
1522# @DESCRIPTION:
1523# Proxy to declare usex for package managers or EAPIs that do not provide it
1524# and use the package manager implementation when available (i.e. EAPI >= 5).
1525# If USE flag is set, echo [true output][true suffix] (defaults to "yes"),
1526# otherwise echo [false output][false suffix] (defaults to "no").
1527if has "${EAPI:-0}" 0 1 2 3 4; then
1528 usex() { use "$1" && echo "${2-yes}$4" || echo "${3-no}$5" ; } #382963
1529fi
1530
1531# @FUNCTION: prune_libtool_files
1532# @USAGE: [--all|--modules]
1533# @DESCRIPTION:
1534# Locate unnecessary libtool files (.la) and libtool static archives
1535# (.a) and remove them from installation image.
1536#
1537# By default, .la files are removed whenever the static linkage can
1538# either be performed using pkg-config or doesn't introduce additional
1539# flags.
1540#
1541# If '--modules' argument is passed, .la files for modules (plugins) are
1542# removed as well. This is usually useful when the package installs
1543# plugins and the plugin loader does not use .la files.
1544#
1545# If '--all' argument is passed, all .la files are removed without
1546# performing any heuristic on them. You shouldn't ever use that,
1547# and instead report a bug in the algorithm instead.
1548#
1549# The .a files are only removed whenever corresponding .la files state
1550# that they should not be linked to, i.e. whenever these files
1551# correspond to plugins.
1552#
1553# Note: if your package installs both static libraries and .pc files
1554# which use variable substitution for -l flags, you need to add
1555# pkg-config to your DEPEND.
1556prune_libtool_files() {
1557 debug-print-function ${FUNCNAME} "$@"
1558
1559 local removing_all removing_modules opt
1560 _eutils_eprefix_init
1561 for opt; do
1562 case "${opt}" in
1563 --all)
1564 removing_all=1
1565 removing_modules=1
1566 ;;
1567 --modules)
1568 removing_modules=1
1569 ;;
1570 *)
1571 die "Invalid argument to ${FUNCNAME}(): ${opt}"
1572 esac
1573 done
1574
1575 local f
1576 local queue=()
1577 while IFS= read -r -d '' f; do # for all .la files
1578 local archivefile=${f/%.la/.a}
1579
1580 # The following check is done by libtool itself.
1581 # It helps us avoid removing random files which match '*.la',
1582 # see bug #468380.
1583 if ! sed -n -e '/^# Generated by .*libtool/q0;4q1' "${f}"; then
1584 continue
1585 fi
1586
1587 [[ ${f} != ${archivefile} ]] || die 'regex sanity check failed'
1588 local reason= pkgconfig_scanned=
1589 local snotlink=$(sed -n -e 's:^shouldnotlink=::p' "${f}")
1590
1591 if [[ ${snotlink} == yes ]]; then
1592
1593 # Remove static libs we're not supposed to link against.
1594 if [[ -f ${archivefile} ]]; then
1595 einfo "Removing unnecessary ${archivefile#${D%/}} (static plugin)"
1596 queue+=( "${archivefile}" )
1597 fi
1598
1599 # The .la file may be used by a module loader, so avoid removing it
1600 # unless explicitly requested.
1601 if [[ ${removing_modules} ]]; then
1602 reason='module'
1603 fi
1604
1605 else
1606
1607 # Remove .la files when:
1608 # - user explicitly wants us to remove all .la files,
1609 # - respective static archive doesn't exist,
1610 # - they are covered by a .pc file already,
1611 # - they don't provide any new information (no libs & no flags).
1612
1613 if [[ ${removing_all} ]]; then
1614 reason='requested'
1615 elif [[ ! -f ${archivefile} ]]; then
1616 reason='no static archive'
1617 elif [[ ! $(sed -nre \
1618 "s/^(dependency_libs|inherited_linker_flags)='(.*)'$/\2/p" \
1619 "${f}") ]]; then
1620 reason='no libs & flags'
1621 else
1622 if [[ ! ${pkgconfig_scanned} ]]; then
1623 # Create a list of all .pc-covered libs.
1624 local pc_libs=()
1625 if [[ ! ${removing_all} ]]; then
1626 local pc
1627 local tf=${T}/prune-lt-files.pc
1628 local pkgconf=$(tc-getPKG_CONFIG)
1629
1630 while IFS= read -r -d '' pc; do # for all .pc files
1631 local arg libs
1632
1633 # Use pkg-config if available (and works),
1634 # fallback to sed.
1635 if ${pkgconf} --exists "${pc}" &>/dev/null; then
1636 sed -e '/^Requires:/d' "${pc}" > "${tf}"
1637 libs=$(${pkgconf} --libs "${tf}")
1638 else
1639 libs=$(sed -ne 's/^Libs://p' "${pc}")
1640 fi
1641
1642 for arg in ${libs}; do
1643 if [[ ${arg} == -l* ]]; then
1644 if [[ ${arg} == '*$*' ]]; then
1645 eqawarn "${FUNCNAME}: variable substitution likely failed in ${pc}"
1646 eqawarn "(arg: ${arg})"
1647 eqawarn "Most likely, you need to add virtual/pkgconfig to DEPEND."
1648 fi
1649
1650 pc_libs+=( lib${arg#-l}.la )
1651 fi
1652 done
1653 done < <(find "${D}" -type f -name '*.pc' -print0)
1654
1655 rm -f "${tf}"
1656 fi
1657
1658 pkgconfig_scanned=1
1659 fi # pkgconfig_scanned
1660
1661 has "${f##*/}" "${pc_libs[@]}" && reason='covered by .pc'
1662 fi # removal due to .pc
1663
1664 fi # shouldnotlink==no
1665
1666 if [[ ${reason} ]]; then
1667 einfo "Removing unnecessary ${f#${D%/}} (${reason})"
1668 queue+=( "${f}" )
1669 fi
1670 done < <(find "${ED}" -xtype f -name '*.la' -print0)
1671
1672 if [[ ${queue[@]} ]]; then
1673 rm -f "${queue[@]}"
1674 fi
1675}
1676
1677# @FUNCTION: einstalldocs
1678# @DESCRIPTION:
1679# Install documentation using DOCS and HTML_DOCS.
1680#
1681# If DOCS is declared and non-empty, all files listed in it are
1682# installed. The files must exist, otherwise the function will fail.
1683# In EAPI 4 and subsequent EAPIs DOCS may specify directories as well,
1684# in other EAPIs using directories is unsupported.
1685#
1686# If DOCS is not declared, the files matching patterns given
1687# in the default EAPI implementation of src_install will be installed.
1688# If this is undesired, DOCS can be set to empty value to prevent any
1689# documentation from being installed.
1690#
1691# If HTML_DOCS is declared and non-empty, all files and/or directories
1692# listed in it are installed as HTML docs (using dohtml).
1693#
1694# Both DOCS and HTML_DOCS can either be an array or a whitespace-
1695# separated list. Whenever directories are allowed, '<directory>/.' may
1696# be specified in order to install all files within the directory
1697# without creating a sub-directory in docdir.
1698#
1699# Passing additional options to dodoc and dohtml is not supported.
1700# If you needed such a thing, you need to call those helpers explicitly.
1701einstalldocs() {
1702 debug-print-function ${FUNCNAME} "${@}"
1703
1704 local dodoc_opts=-r
1705 has ${EAPI} 0 1 2 3 && dodoc_opts=
1706
1707 if ! declare -p DOCS &>/dev/null ; then
1708 local d
1709 for d in README* ChangeLog AUTHORS NEWS TODO CHANGES \
1710 THANKS BUGS FAQ CREDITS CHANGELOG ; do
1711 if [[ -s ${d} ]] ; then
1712 dodoc "${d}" || die
1713 fi
1714 done
1715 elif [[ $(declare -p DOCS) == "declare -a"* ]] ; then
1716 if [[ ${DOCS[@]} ]] ; then
1717 dodoc ${dodoc_opts} "${DOCS[@]}" || die
1718 fi
1719 else
1720 if [[ ${DOCS} ]] ; then
1721 dodoc ${dodoc_opts} ${DOCS} || die
1722 fi
1723 fi
1724
1725 if [[ $(declare -p HTML_DOCS 2>/dev/null) == "declare -a"* ]] ; then
1726 if [[ ${HTML_DOCS[@]} ]] ; then
1727 dohtml -r "${HTML_DOCS[@]}" || die
1728 fi
1729 else
1730 if [[ ${HTML_DOCS} ]] ; then
1731 dohtml -r ${HTML_DOCS} || die
1732 fi
1733 fi
1734
1735 return 0
1736}
1737
1738check_license() { die "you no longer need this as portage supports ACCEPT_LICENSE itself"; }
1739
1740# @FUNCTION: optfeature
1741# @USAGE: <short description> <package atom to match> [other atoms]
1742# @DESCRIPTION:
1743# Print out a message suggesting an optional package (or packages) which
1744# provide the described functionality
1745#
1746# The following snippet would suggest app-misc/foo for optional foo support,
1747# app-misc/bar or app-misc/baz[bar] for optional bar support
1748# and either both app-misc/a and app-misc/b or app-misc/c for alphabet support.
1749# @CODE
1750# optfeature "foo support" app-misc/foo
1751# optfeature "bar support" app-misc/bar app-misc/baz[bar]
1752# optfeature "alphabet support" "app-misc/a app-misc/b" app-misc/c
1753# @CODE
1754optfeature() {
1755 debug-print-function ${FUNCNAME} "$@"
1756 local i j msg
1757 local desc=$1
1758 local flag=0
1759 shift
1760 for i; do
1761 for j in ${i}; do
1762 if has_version "${j}"; then
1763 flag=1
1764 else
1765 flag=0
1766 break
1767 fi
1768 done
1769 if [[ ${flag} -eq 1 ]]; then
1770 break
1771 fi
1772 done
1773 if [[ ${flag} -eq 0 ]]; then
1774 for i; do
1775 msg=" "
1776 for j in ${i}; do
1777 msg+=" ${j} and"
1778 done
1779 msg="${msg:0: -4} for ${desc}"
1780 elog "${msg}"
1781 done
1782 fi
1783}
1784
1785fi

Legend:
Removed from v.1.301  
changed lines
  Added in v.1.443

  ViewVC Help
Powered by ViewVC 1.1.20