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

Diff of /eclass/eutils.eclass

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

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

Legend:
Removed from v.1.78  
changed lines
  Added in v.1.439

  ViewVC Help
Powered by ViewVC 1.1.20