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

Diff of /eclass/eutils.eclass

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

Revision 1.275 Revision 1.360
1# Copyright 1999-2006 Gentoo Foundation 1# Copyright 1999-2011 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.275 2007/02/17 00:17:39 vapier Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/eutils.eclass,v 1.360 2011/08/07 23:35:28 vapier Exp $
4
5# @ECLASS: eutils.eclass
6# @MAINTAINER:
7# base-system@gentoo.org
8# @BLURB: many extra (but common) functions that are used in ebuilds
9# @DESCRIPTION:
10# The eutils eclass contains a suite of functions that complement
11# the ones that ebuild.sh already contain. The idea is that the functions
12# are not required in all ebuilds but enough utilize them to have a common
13# home rather than having multiple ebuilds implementing the same thing.
4# 14#
5# This eclass is for general purpose functions that most ebuilds 15# Due to the nature of this eclass, some functions may have maintainers
6# have to implement themselves. 16# different from the overall eclass!
7#
8# NB: If you add anything, please comment it!
9#
10# Maintainer: see each individual function, base-system@gentoo.org as default
11 17
12inherit multilib portability 18inherit multilib portability
13 19
14DESCRIPTION="Based on the ${ECLASS} eclass" 20DESCRIPTION="Based on the ${ECLASS} eclass"
15 21
16# Wait for the supplied number of seconds. If no argument is supplied, defaults 22if has "${EAPI:-0}" 0 1 2; then
17# to five seconds. If the EPAUSE_IGNORE env var is set, don't wait. If we're not 23
18# outputting to a terminal, don't wait. For compatability purposes, the argument 24# @FUNCTION: epause
19# must be an integer greater than zero. 25# @USAGE: [seconds]
20# Bug 62950, Ciaran McCreesh <ciaranm@gentoo.org> (05 Sep 2004) 26# @DESCRIPTION:
27# Sleep for the specified number of seconds (default of 5 seconds). Useful when
28# printing a message the user should probably be reading and often used in
29# conjunction with the ebeep function. If the EPAUSE_IGNORE env var is set,
30# don't wait at all. Defined in EAPIs 0 1 and 2.
21epause() { 31epause() {
22 [[ -z ${EPAUSE_IGNORE} ]] && sleep ${1:-5} 32 [[ -z ${EPAUSE_IGNORE} ]] && sleep ${1:-5}
23} 33}
24 34
25# Beep the specified number of times (defaults to five). If our output 35# @FUNCTION: ebeep
26# is not a terminal, don't beep. If the EBEEP_IGNORE env var is set, 36# @USAGE: [number of beeps]
27# don't beep. 37# @DESCRIPTION:
28# Bug 62950, Ciaran McCreesh <ciaranm@gentoo.org> (05 Sep 2004) 38# Issue the specified number of beeps (default of 5 beeps). Useful when
39# printing a message the user should probably be reading and often used in
40# conjunction with the epause function. If the EBEEP_IGNORE env var is set,
41# don't beep at all. Defined in EAPIs 0 1 and 2.
29ebeep() { 42ebeep() {
30 local n 43 local n
31 if [[ -z ${EBEEP_IGNORE} ]] ; then 44 if [[ -z ${EBEEP_IGNORE} ]] ; then
32 for ((n=1 ; n <= ${1:-5} ; n++)) ; do 45 for ((n=1 ; n <= ${1:-5} ; n++)) ; do
33 echo -ne "\a" 46 echo -ne "\a"
36 sleep 1 49 sleep 1
37 done 50 done
38 fi 51 fi
39} 52}
40 53
41# This function generate linker scripts in /usr/lib for dynamic 54else
42# libs in /lib. This is to fix linking problems when you have 55
43# the .so in /lib, and the .a in /usr/lib. What happens is that 56ebeep() {
44# in some cases when linking dynamic, the .a in /usr/lib is used 57 ewarn "QA Notice: ebeep is not defined in EAPI=${EAPI}, please file a bug at http://bugs.gentoo.org"
45# instead of the .so in /lib due to gcc/libtool tweaking ld's 58}
46# library search path. This cause many builds to fail. 59
47# See bug #4411 for more info. 60epause() {
48# 61 ewarn "QA Notice: epause is not defined in EAPI=${EAPI}, please file a bug at http://bugs.gentoo.org"
49# To use, simply call: 62}
50# 63
51# gen_usr_ldscript libfoo.so
52#
53# Note that you should in general use the unversioned name of
54# the library, as ldconfig should usually update it correctly
55# to point to the latest version of the library present.
56#
57# <azarah@gentoo.org> (26 Oct 2002)
58#
59gen_usr_ldscript() {
60 if [[ $(type -t _tc_gen_usr_ldscript) == "function" ]] ; then
61 _tc_gen_usr_ldscript "$@"
62 return $?
63 fi 64fi
64 65
65 ewarn "QA Notice: Please upgrade your ebuild to use toolchain-funcs" 66# @FUNCTION: eqawarn
66 ewarn "QA Notice: rather than gen_usr_ldscript() from eutils" 67# @USAGE: [message]
68# @DESCRIPTION:
69# Proxy to einfo for package managers that don't provide eqawarn and use the PM
70# implementation if available.
71if ! declare -F eqawarn >/dev/null ; then
72 eqawarn() {
73 einfo "$@"
74 }
75fi
67 76
68 local lib libdir=$(get_libdir) 77# @FUNCTION: ecvs_clean
69 # Just make sure it exists 78# @USAGE: [list of dirs]
70 dodir /usr/${libdir} 79# @DESCRIPTION:
80# Remove CVS directories recursiveley. Useful when a source tarball contains
81# internal CVS directories. Defaults to $PWD.
82ecvs_clean() {
83 [[ -z $* ]] && set -- .
84 find "$@" -type d -name 'CVS' -prune -print0 | xargs -0 rm -rf
85 find "$@" -type f -name '.cvs*' -print0 | xargs -0 rm -rf
86}
71 87
72 for lib in "${@}" ; do 88# @FUNCTION: esvn_clean
73 cat > "${D}/usr/${libdir}/${lib}" <<-END_LDSCRIPT 89# @USAGE: [list of dirs]
74 /* GNU ld script 90# @DESCRIPTION:
75 Since Gentoo has critical dynamic libraries 91# Remove .svn directories recursiveley. Useful when a source tarball contains
76 in /lib, and the static versions in /usr/lib, 92# internal Subversion directories. Defaults to $PWD.
77 we need to have a "fake" dynamic lib in /usr/lib, 93esvn_clean() {
78 otherwise we run into linking problems. 94 [[ -z $* ]] && set -- .
95 find "$@" -type d -name '.svn' -prune -print0 | xargs -0 rm -rf
96}
79 97
80 See bug http://bugs.gentoo.org/4411 for more info. 98# @FUNCTION: eshopts_push
81 */ 99# @USAGE: [options to `set` or `shopt`]
82 GROUP ( /${libdir}/${lib} ) 100# @DESCRIPTION:
83 END_LDSCRIPT 101# Often times code will want to enable a shell option to change code behavior.
84 fperms a+x "/usr/${libdir}/${lib}" || die "could not change perms on ${lib}" 102# Since changing shell options can easily break other pieces of code (which
103# assume the default state), eshopts_push is used to (1) push the current shell
104# options onto a stack and (2) pass the specified arguments to set.
105#
106# If the first argument is '-s' or '-u', we assume you want to call `shopt`
107# rather than `set` as there are some options only available via that.
108#
109# A common example is to disable shell globbing so that special meaning/care
110# may be used with variables/arguments to custom functions. That would be:
111# @CODE
112# eshopts_push -o noglob
113# for x in ${foo} ; do
114# if ...some check... ; then
115# eshopts_pop
116# return 0
117# fi
85 done 118# done
119# eshopts_pop
120# @CODE
121eshopts_push() {
122 # have to assume __ESHOPTS_SAVE__ isn't screwed with
123 # as a `declare -a` here will reset its value
124 local i=${#__ESHOPTS_SAVE__[@]}
125 if [[ $1 == -[su] ]] ; then
126 __ESHOPTS_SAVE__[$i]=$(shopt -p)
127 [[ $# -eq 0 ]] && return 0
128 shopt "$@" || die "eshopts_push: bad options to shopt: $*"
129 else
130 __ESHOPTS_SAVE__[$i]=$-
131 [[ $# -eq 0 ]] && return 0
132 set "$@" || die "eshopts_push: bad options to set: $*"
133 fi
86} 134}
87 135
136# @FUNCTION: eshopts_pop
137# @USAGE:
138# @DESCRIPTION:
139# Restore the shell options to the state saved with the corresponding
140# eshopts_push call. See that function for more details.
141eshopts_pop() {
142 [[ $# -ne 0 ]] && die "eshopts_pop takes no arguments"
143 local i=$(( ${#__ESHOPTS_SAVE__[@]} - 1 ))
144 [[ ${i} -eq -1 ]] && die "eshopts_{push,pop}: unbalanced pair"
145 local s=${__ESHOPTS_SAVE__[$i]}
146 unset __ESHOPTS_SAVE__[$i]
147 if [[ ${s} == "shopt -"* ]] ; then
148 eval "${s}" || die "eshopts_pop: sanity: invalid shopt options: ${s}"
149 else
150 set +$- || die "eshopts_pop: sanity: invalid shell settings: $-"
151 set -${s} || die "eshopts_pop: sanity: unable to restore saved shell settings: ${s}"
152 fi
153}
88 154
89# Default directory where patches are located 155# @VARIABLE: EPATCH_SOURCE
156# @DESCRIPTION:
157# Default directory to search for patches.
90EPATCH_SOURCE="${WORKDIR}/patch" 158EPATCH_SOURCE="${WORKDIR}/patch"
91# Default extension for patches 159# @VARIABLE: EPATCH_SUFFIX
160# @DESCRIPTION:
161# Default extension for patches (do not prefix the period yourself).
92EPATCH_SUFFIX="patch.bz2" 162EPATCH_SUFFIX="patch.bz2"
163# @VARIABLE: EPATCH_OPTS
164# @DESCRIPTION:
93# Default options for patch 165# Default options for patch:
166# @CODE
94# Set -g0 to keep RCS, ClearCase, Perforce and SCCS happy. Bug #24571 167# -g0 - keep RCS, ClearCase, Perforce and SCCS happy #24571
95# Set --no-backup-if-mismatch so we don't leave '.orig' files behind. 168# --no-backup-if-mismatch - do not leave .orig files behind
96# Set -E to automatically remove empty files. 169# -E - automatically remove empty files
170# @CODE
97EPATCH_OPTS="-g0 -E --no-backup-if-mismatch" 171EPATCH_OPTS="-g0 -E --no-backup-if-mismatch"
172# @VARIABLE: EPATCH_EXCLUDE
173# @DESCRIPTION:
98# List of patches not to apply. Not this is only file names, 174# List of patches not to apply. Note this is only file names,
99# and not the full path .. 175# and not the full path. Globs accepted.
100EPATCH_EXCLUDE="" 176EPATCH_EXCLUDE=""
177# @VARIABLE: EPATCH_SINGLE_MSG
178# @DESCRIPTION:
101# Change the printed message for a single patch. 179# Change the printed message for a single patch.
102EPATCH_SINGLE_MSG="" 180EPATCH_SINGLE_MSG=""
181# @VARIABLE: EPATCH_MULTI_MSG
182# @DESCRIPTION:
103# Change the printed message for multiple patches. 183# Change the printed message for multiple patches.
104EPATCH_MULTI_MSG="Applying various patches (bugfixes/updates) ..." 184EPATCH_MULTI_MSG="Applying various patches (bugfixes/updates) ..."
105# Force applying bulk patches even if not following the style: 185# @VARIABLE: EPATCH_FORCE
106# 186# @DESCRIPTION:
107# ??_${ARCH}_foo.${EPATCH_SUFFIX} 187# Only require patches to match EPATCH_SUFFIX rather than the extended
108# 188# arch naming style.
109EPATCH_FORCE="no" 189EPATCH_FORCE="no"
110 190
111# This function is for bulk patching, or in theory for just one 191# @FUNCTION: epatch
112# or two patches. 192# @USAGE: [patches] [dirs of patches]
193# @DESCRIPTION:
194# epatch is designed to greatly simplify the application of patches. It can
195# process patch files directly, or directories of patches. The patches may be
196# compressed (bzip/gzip/etc...) or plain text. You generally need not specify
197# the -p option as epatch will automatically attempt -p0 to -p5 until things
198# apply successfully.
113# 199#
114# It should work with .bz2, .gz, .zip and plain text patches. 200# If you do not specify any options, then epatch will default to the directory
115# Currently all patches should be the same format. 201# specified by EPATCH_SOURCE.
116# 202#
117# You do not have to specify '-p' option to patch, as it will 203# When processing directories, epatch will apply all patches that match:
118# try with -p0 to -p5 until it succeed, or fail at -p5. 204# @CODE
119# 205# if ${EPATCH_FORCE} != "yes"
120# Above EPATCH_* variables can be used to control various defaults,
121# bug they should be left as is to ensure an ebuild can rely on
122# them for.
123#
124# Patches are applied in current directory.
125#
126# Bulk Patches should preferibly have the form of:
127#
128# ??_${ARCH}_foo.${EPATCH_SUFFIX} 206# ??_${ARCH}_foo.${EPATCH_SUFFIX}
207# else
208# *.${EPATCH_SUFFIX}
209# @CODE
210# The leading ?? are typically numbers used to force consistent patch ordering.
211# The arch field is used to apply patches only for the host architecture with
212# the special value of "all" means apply for everyone. Note that using values
213# other than "all" is highly discouraged -- you should apply patches all the
214# time and let architecture details be detected at configure/compile time.
129# 215#
130# For example: 216# If EPATCH_SUFFIX is empty, then no period before it is implied when searching
217# for patches to apply.
131# 218#
132# 01_all_misc-fix.patch.bz2 219# Refer to the other EPATCH_xxx variables for more customization of behavior.
133# 02_sparc_another-fix.patch.bz2
134#
135# This ensures that there are a set order, and you can have ARCH
136# specific patches.
137#
138# If you however give an argument to epatch(), it will treat it as a
139# single patch that need to be applied if its a file. If on the other
140# hand its a directory, it will set EPATCH_SOURCE to this.
141#
142# <azarah@gentoo.org> (10 Nov 2002)
143#
144epatch() { 220epatch() {
145 _epatch_draw_line() { 221 _epatch_draw_line() {
222 # create a line of same length as input string
146 [[ -z $1 ]] && set "$(printf "%65s" '')" 223 [[ -z $1 ]] && set "$(printf "%65s" '')"
147 echo "${1//?/=}" 224 echo "${1//?/=}"
148 } 225 }
149 _epatch_assert() { local _pipestatus=${PIPESTATUS[*]}; [[ ${_pipestatus// /} -eq 0 ]] ; }
150 local PIPE_CMD=""
151 local STDERR_TARGET="${T}/$$.out"
152 local PATCH_TARGET="${T}/$$.patch"
153 local PATCH_SUFFIX=""
154 local SINGLE_PATCH="no"
155 local x=""
156 226
157 unset P4CONFIG P4PORT P4USER # keep perforce at bay #56402 227 unset P4CONFIG P4PORT P4USER # keep perforce at bay #56402
158 228
159 if [ "$#" -gt 1 ] 229 # Let the rest of the code process one user arg at a time --
160 then 230 # each arg may expand into multiple patches, and each arg may
231 # need to start off with the default global EPATCH_xxx values
232 if [[ $# -gt 1 ]] ; then
161 local m="" 233 local m
162 for m in "$@" ; do 234 for m in "$@" ; do
163 epatch "${m}" 235 epatch "${m}"
164 done 236 done
165 return 0 237 return 0
166 fi 238 fi
167 239
168 if [ -n "$1" -a -f "$1" ] 240 local SINGLE_PATCH="no"
169 then 241 # no args means process ${EPATCH_SOURCE}
242 [[ $# -eq 0 ]] && set -- "${EPATCH_SOURCE}"
243
244 if [[ -f $1 ]] ; then
170 SINGLE_PATCH="yes" 245 SINGLE_PATCH="yes"
171 246 set -- "$1"
172 local EPATCH_SOURCE="$1" 247 # Use the suffix from the single patch (localize it); the code
248 # below will find the suffix for us
173 local EPATCH_SUFFIX="${1##*\.}" 249 local EPATCH_SUFFIX=$1
174 250
175 elif [ -n "$1" -a -d "$1" ] 251 elif [[ -d $1 ]] ; then
176 then 252 # Some people like to make dirs of patches w/out suffixes (vim)
177 # Allow no extension if EPATCH_FORCE=yes ... used by vim for example ... 253 set -- "$1"/*${EPATCH_SUFFIX:+."${EPATCH_SUFFIX}"}
178 if [ "${EPATCH_FORCE}" = "yes" ] && [ -z "${EPATCH_SUFFIX}" ] 254
255 elif [[ -f ${EPATCH_SOURCE}/$1 ]] ; then
256 # Re-use EPATCH_SOURCE as a search dir
257 epatch "${EPATCH_SOURCE}/$1"
258 return $?
259
260 else
261 # sanity check ... if it isn't a dir or file, wtf man ?
262 [[ $# -ne 0 ]] && EPATCH_SOURCE=$1
263 echo
264 eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:"
265 eerror
266 eerror " ${EPATCH_SOURCE}"
267 eerror " ( ${EPATCH_SOURCE##*/} )"
268 echo
269 die "Cannot find \$EPATCH_SOURCE!"
270 fi
271
272 local PIPE_CMD
273 case ${EPATCH_SUFFIX##*\.} in
274 xz) PIPE_CMD="xz -dc" ;;
275 lzma) PIPE_CMD="lzma -dc" ;;
276 bz2) PIPE_CMD="bzip2 -dc" ;;
277 gz|Z|z) PIPE_CMD="gzip -dc" ;;
278 ZIP|zip) PIPE_CMD="unzip -p" ;;
279 *) ;;
280 esac
281
282 [[ ${SINGLE_PATCH} == "no" ]] && einfo "${EPATCH_MULTI_MSG}"
283
284 local x
285 for x in "$@" ; do
286 # If the patch dir given contains subdirs, or our EPATCH_SUFFIX
287 # didn't match anything, ignore continue on
288 [[ ! -f ${x} ]] && continue
289
290 local patchname=${x##*/}
291
292 # Apply single patches, or forced sets of patches, or
293 # patches with ARCH dependant names.
294 # ???_arch_foo.patch
295 # Else, skip this input altogether
296 local a=${patchname#*_} # strip the ???_
297 a=${a%%_*} # strip the _foo.patch
298 if ! [[ ${SINGLE_PATCH} == "yes" || \
299 ${EPATCH_FORCE} == "yes" || \
300 ${a} == all || \
301 ${a} == ${ARCH} ]]
179 then 302 then
180 local EPATCH_SOURCE="$1/*" 303 continue
304 fi
305
306 # Let people filter things dynamically
307 if [[ -n ${EPATCH_EXCLUDE} ]] ; then
308 # let people use globs in the exclude
309 eshopts_push -o noglob
310
311 local ex
312 for ex in ${EPATCH_EXCLUDE} ; do
313 if [[ ${patchname} == ${ex} ]] ; then
314 eshopts_pop
315 continue 2
316 fi
317 done
318
319 eshopts_pop
320 fi
321
322 if [[ ${SINGLE_PATCH} == "yes" ]] ; then
323 if [[ -n ${EPATCH_SINGLE_MSG} ]] ; then
324 einfo "${EPATCH_SINGLE_MSG}"
325 else
326 einfo "Applying ${patchname} ..."
327 fi
181 else 328 else
182 local EPATCH_SOURCE="$1/*.${EPATCH_SUFFIX}" 329 einfo " ${patchname} ..."
183 fi 330 fi
184 else 331
185 if [ ! -d ${EPATCH_SOURCE} ] || [ -n "$1" ] 332 # most of the time, there will only be one run per unique name,
186 then 333 # but if there are more, make sure we get unique log filenames
187 if [ -n "$1" -a "${EPATCH_SOURCE}" = "${WORKDIR}/patch" ] 334 local STDERR_TARGET="${T}/${patchname}.out"
188 then 335 if [[ -e ${STDERR_TARGET} ]] ; then
189 EPATCH_SOURCE="$1" 336 STDERR_TARGET="${T}/${patchname}-$$.out"
337 fi
338
339 printf "***** %s *****\n\n" "${patchname}" > "${STDERR_TARGET}"
340
341 # Decompress the patch if need be
342 local count=0
343 local PATCH_TARGET
344 if [[ -n ${PIPE_CMD} ]] ; then
345 PATCH_TARGET="${T}/$$.patch"
346 echo "PIPE_COMMAND: ${PIPE_CMD} ${x} > ${PATCH_TARGET}" >> "${STDERR_TARGET}"
347
348 if ! (${PIPE_CMD} "${x}" > "${PATCH_TARGET}") >> "${STDERR_TARGET}" 2>&1 ; then
349 echo
350 eerror "Could not extract patch!"
351 #die "Could not extract patch!"
352 count=5
353 break
190 fi 354 fi
355 else
356 PATCH_TARGET=${x}
357 fi
191 358
359 # Check for absolute paths in patches. If sandbox is disabled,
360 # people could (accidently) patch files in the root filesystem.
361 # Or trigger other unpleasantries #237667. So disallow -p0 on
362 # such patches.
363 local abs_paths=$(egrep -n '^[-+]{3} /' "${PATCH_TARGET}" | awk '$2 != "/dev/null" { print }')
364 if [[ -n ${abs_paths} ]] ; then
365 count=1
366 printf "NOTE: skipping -p0 due to absolute paths in patch:\n%s\n" "${abs_paths}" >> "${STDERR_TARGET}"
367 fi
368 # Similar reason, but with relative paths.
369 local rel_paths=$(egrep -n '^[-+]{3} [^ ]*[.][.]/' "${PATCH_TARGET}")
370 if [[ -n ${rel_paths} ]] ; then
371 eqawarn "QA Notice: Your patch uses relative paths '../'."
372 eqawarn " In the future this will cause a failure."
373 eqawarn "${rel_paths}"
374 fi
375
376 # Dynamically detect the correct -p# ... i'm lazy, so shoot me :/
377 while [[ ${count} -lt 5 ]] ; do
378 # Generate some useful debug info ...
379 (
380 _epatch_draw_line "***** ${patchname} *****"
192 echo 381 echo
193 eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:" 382 echo "PATCH COMMAND: patch -p${count} ${EPATCH_OPTS} < '${PATCH_TARGET}'"
383 echo
384 _epatch_draw_line "***** ${patchname} *****"
385 patch -p${count} ${EPATCH_OPTS} --dry-run -f < "${PATCH_TARGET}" 2>&1
386 ret=$?
387 echo
388 echo "patch program exited with status ${ret}"
389 exit ${ret}
390 ) >> "${STDERR_TARGET}"
391
392 if [ $? -eq 0 ] ; then
393 (
394 _epatch_draw_line "***** ${patchname} *****"
395 echo
396 echo "ACTUALLY APPLYING ${patchname} ..."
397 echo
398 _epatch_draw_line "***** ${patchname} *****"
399 patch -p${count} ${EPATCH_OPTS} < "${PATCH_TARGET}" 2>&1
400 ret=$?
401 echo
402 echo "patch program exited with status ${ret}"
403 exit ${ret}
404 ) >> "${STDERR_TARGET}"
405
406 if [ $? -ne 0 ] ; then
407 echo
408 eerror "A dry-run of patch command succeeded, but actually"
409 eerror "applying the patch failed!"
410 #die "Real world sux compared to the dreamworld!"
411 count=5
412 fi
413 break
414 fi
415
416 : $(( count++ ))
417 done
418
419 # if we had to decompress the patch, delete the temp one
420 if [[ -n ${PIPE_CMD} ]] ; then
421 rm -f "${PATCH_TARGET}"
422 fi
423
424 if [[ ${count} -ge 5 ]] ; then
425 echo
426 eerror "Failed Patch: ${patchname} !"
427 eerror " ( ${PATCH_TARGET} )"
194 eerror 428 eerror
195 eerror " ${EPATCH_SOURCE}" 429 eerror "Include in your bugreport the contents of:"
196 eerror " ( ${EPATCH_SOURCE##*/} )" 430 eerror
431 eerror " ${STDERR_TARGET}"
197 echo 432 echo
198 die "Cannot find \$EPATCH_SOURCE!"
199 fi
200
201 local EPATCH_SOURCE="${EPATCH_SOURCE}/*.${EPATCH_SUFFIX}"
202 fi
203
204 case ${EPATCH_SUFFIX##*\.} in
205 bz2)
206 PIPE_CMD="bzip2 -dc"
207 PATCH_SUFFIX="bz2"
208 ;;
209 gz|Z|z)
210 PIPE_CMD="gzip -dc"
211 PATCH_SUFFIX="gz"
212 ;;
213 ZIP|zip)
214 PIPE_CMD="unzip -p"
215 PATCH_SUFFIX="zip"
216 ;;
217 *)
218 PIPE_CMD="cat"
219 PATCH_SUFFIX="patch"
220 ;;
221 esac
222
223 if [ "${SINGLE_PATCH}" = "no" ]
224 then
225 einfo "${EPATCH_MULTI_MSG}"
226 fi
227 for x in ${EPATCH_SOURCE}
228 do
229 # New ARCH dependant patch naming scheme ...
230 #
231 # ???_arch_foo.patch
232 #
233 if [ -f ${x} ] && \
234 ([ "${SINGLE_PATCH}" = "yes" -o "${x/_all_}" != "${x}" -o "${x/_${ARCH}_}" != "${x}" ] || \
235 [ "${EPATCH_FORCE}" = "yes" ])
236 then
237 local count=0
238 local popts="${EPATCH_OPTS}"
239 local patchname=${x##*/}
240
241 if [ -n "${EPATCH_EXCLUDE}" ]
242 then
243 if [ "${EPATCH_EXCLUDE/${patchname}}" != "${EPATCH_EXCLUDE}" ]
244 then
245 continue
246 fi
247 fi
248
249 if [ "${SINGLE_PATCH}" = "yes" ]
250 then
251 if [ -n "${EPATCH_SINGLE_MSG}" ]
252 then
253 einfo "${EPATCH_SINGLE_MSG}"
254 else
255 einfo "Applying ${patchname} ..."
256 fi
257 else
258 einfo " ${patchname} ..."
259 fi
260
261 echo "***** ${patchname} *****" > ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
262 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
263
264 # Allow for prefix to differ ... im lazy, so shoot me :/
265 while [ "${count}" -lt 5 ]
266 do
267 # Generate some useful debug info ...
268 _epatch_draw_line "***** ${patchname} *****" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
269 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
270
271 if [ "${PATCH_SUFFIX}" != "patch" ]
272 then
273 echo -n "PIPE_COMMAND: " >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
274 echo "${PIPE_CMD} ${x} > ${PATCH_TARGET}" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
275 else
276 PATCH_TARGET="${x}"
277 fi
278
279 echo -n "PATCH COMMAND: " >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
280 echo "patch -p${count} ${popts} < ${PATCH_TARGET}" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
281
282 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
283 _epatch_draw_line "***** ${patchname} *****" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
284
285 if [ "${PATCH_SUFFIX}" != "patch" ]
286 then
287 if ! (${PIPE_CMD} ${x} > ${PATCH_TARGET}) >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 2>&1
288 then
289 echo
290 eerror "Could not extract patch!"
291 #die "Could not extract patch!"
292 count=5
293 break
294 fi
295 fi
296
297 if (cat ${PATCH_TARGET} | patch -p${count} ${popts} --dry-run -f ; _epatch_assert) >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 2>&1
298 then
299 _epatch_draw_line "***** ${patchname} *****" > ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
300 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
301 echo "ACTUALLY APPLYING ${patchname} ..." >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
302 echo >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
303 _epatch_draw_line "***** ${patchname} *****" >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
304
305 cat ${PATCH_TARGET} | patch -p${count} ${popts} >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real 2>&1
306 _epatch_assert
307
308 if [ "$?" -ne 0 ]
309 then
310 cat ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real >> ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}
311 echo
312 eerror "A dry-run of patch command succeeded, but actually"
313 eerror "applying the patch failed!"
314 #die "Real world sux compared to the dreamworld!"
315 count=5
316 fi
317
318 rm -f ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}.real
319
320 break
321 fi
322
323 count=$((count + 1))
324 done
325
326 if [ "${PATCH_SUFFIX}" != "patch" ]
327 then
328 rm -f ${PATCH_TARGET}
329 fi
330
331 if [ "${count}" -eq 5 ]
332 then
333 echo
334 eerror "Failed Patch: ${patchname} !"
335 eerror " ( ${PATCH_TARGET} )"
336 eerror
337 eerror "Include in your bugreport the contents of:"
338 eerror
339 eerror " ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/}"
340 echo
341 die "Failed Patch: ${patchname}!" 433 die "Failed Patch: ${patchname}!"
342 fi 434 fi
343 435
344 rm -f ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 436 # if everything worked, delete the patch log
345 437 rm -f "${STDERR_TARGET}"
346 eend 0 438 eend 0
347 fi
348 done 439 done
349 if [ "${SINGLE_PATCH}" = "no" ] 440
350 then 441 [[ ${SINGLE_PATCH} == "no" ]] && einfo "Done with patching"
351 einfo "Done with patching" 442 : # everything worked
443}
444epatch_user() {
445 [[ $# -ne 0 ]] && die "epatch_user takes no options"
446
447 # don't clobber any EPATCH vars that the parent might want
448 local EPATCH_SOURCE check base=${PORTAGE_CONFIGROOT%/}/etc/portage/patches
449 for check in {${CATEGORY}/${PF},${CATEGORY}/${P},${CATEGORY}/${PN}}; do
450 EPATCH_SOURCE=${base}/${CTARGET}/${check}
451 [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${CHOST}/${check}
452 [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${check}
453 if [[ -d ${EPATCH_SOURCE} ]] ; then
454 EPATCH_SOURCE=${EPATCH_SOURCE} \
455 EPATCH_SUFFIX="patch" \
456 EPATCH_FORCE="yes" \
457 EPATCH_MULTI_MSG="Applying user patches from ${EPATCH_SOURCE} ..." \
458 epatch
459 return 0
352 fi 460 fi
461 done
462 return 1
353} 463}
354 464
465# @FUNCTION: emktemp
466# @USAGE: [temp dir]
467# @DESCRIPTION:
355# Cheap replacement for when debianutils (and thus mktemp) 468# Cheap replacement for when debianutils (and thus mktemp)
356# does not exist on the users system 469# does not exist on the users system.
357# vapier@gentoo.org
358#
359# Takes just 1 optional parameter (the directory to create tmpfile in)
360emktemp() { 470emktemp() {
361 local exe="touch" 471 local exe="touch"
362 [[ $1 == -d ]] && exe="mkdir" && shift 472 [[ $1 == -d ]] && exe="mkdir" && shift
363 local topdir=$1 473 local topdir=$1
364 474
366 [[ -z ${T} ]] \ 476 [[ -z ${T} ]] \
367 && topdir="/tmp" \ 477 && topdir="/tmp" \
368 || topdir=${T} 478 || topdir=${T}
369 fi 479 fi
370 480
371 if [[ -z $(type -p mktemp) ]] ; then 481 if ! type -P mktemp > /dev/null ; then
482 # system lacks `mktemp` so we have to fake it
372 local tmp=/ 483 local tmp=/
373 while [[ -e ${tmp} ]] ; do 484 while [[ -e ${tmp} ]] ; do
374 tmp=${topdir}/tmp.${RANDOM}.${RANDOM}.${RANDOM} 485 tmp=${topdir}/tmp.${RANDOM}.${RANDOM}.${RANDOM}
375 done 486 done
376 ${exe} "${tmp}" || ${exe} -p "${tmp}" 487 ${exe} "${tmp}" || ${exe} -p "${tmp}"
377 echo "${tmp}" 488 echo "${tmp}"
378 else 489 else
490 # the args here will give slightly wierd names on BSD,
491 # but should produce a usable file on all userlands
379 if [[ ${exe} == "touch" ]] ; then 492 if [[ ${exe} == "touch" ]] ; then
380 [[ ${USERLAND} == "GNU" ]] \
381 && mktemp -p "${topdir}" \
382 || TMPDIR="${topdir}" mktemp -t tmp 493 TMPDIR="${topdir}" mktemp -t tmp.XXXXXXXXXX
383 else 494 else
384 [[ ${USERLAND} == "GNU" ]] \
385 && mktemp -d "${topdir}" \
386 || TMPDIR="${topdir}" mktemp -dt tmp 495 TMPDIR="${topdir}" mktemp -dt tmp.XXXXXXXXXX
387 fi
388 fi 496 fi
497 fi
389} 498}
390 499
500# @FUNCTION: egetent
501# @USAGE: <database> <key>
502# @MAINTAINER:
503# base-system@gentoo.org (Linux)
504# Joe Jezak <josejx@gmail.com> (OS X)
505# usata@gentoo.org (OS X)
506# Aaron Walker <ka0ttic@gentoo.org> (FreeBSD)
507# @DESCRIPTION:
391# Small wrapper for getent (Linux), nidump (Mac OS X), 508# Small wrapper for getent (Linux),
509# nidump (< Mac OS X 10.5), dscl (Mac OS X 10.5),
392# and pw (FreeBSD) used in enewuser()/enewgroup() 510# and pw (FreeBSD) used in enewuser()/enewgroup()
393# Joe Jezak <josejx@gmail.com> and usata@gentoo.org
394# FBSD stuff: Aaron Walker <ka0ttic@gentoo.org>
395#
396# egetent(database, key)
397egetent() { 511egetent() {
398 case ${CHOST} in 512 case ${CHOST} in
399 *-darwin*) 513 *-darwin[678])
400 case "$2" in 514 case "$2" in
401 *[!0-9]*) # Non numeric 515 *[!0-9]*) # Non numeric
402 nidump $1 . | awk -F":" "{ if (\$1 ~ /^$2$/) {print \$0;exit;} }" 516 nidump $1 . | awk -F":" "{ if (\$1 ~ /^$2\$/) {print \$0;exit;} }"
403 ;; 517 ;;
404 *) # Numeric 518 *) # Numeric
405 nidump $1 . | awk -F":" "{ if (\$3 == $2) {print \$0;exit;} }" 519 nidump $1 . | awk -F":" "{ if (\$3 == $2) {print \$0;exit;} }"
520 ;;
521 esac
522 ;;
523 *-darwin*)
524 local mytype=$1
525 [[ "passwd" == $mytype ]] && mytype="Users"
526 [[ "group" == $mytype ]] && mytype="Groups"
527 case "$2" in
528 *[!0-9]*) # Non numeric
529 dscl . -read /$mytype/$2 2>/dev/null |grep RecordName
530 ;;
531 *) # Numeric
532 local mykey="UniqueID"
533 [[ $mytype == "Groups" ]] && mykey="PrimaryGroupID"
534 dscl . -search /$mytype $mykey $2 2>/dev/null
406 ;; 535 ;;
407 esac 536 esac
408 ;; 537 ;;
409 *-freebsd*|*-dragonfly*) 538 *-freebsd*|*-dragonfly*)
410 local opts action="user" 539 local opts action="user"
425 getent "$1" "$2" 554 getent "$1" "$2"
426 ;; 555 ;;
427 esac 556 esac
428} 557}
429 558
430# Simplify/standardize adding users to the system 559# @FUNCTION: enewuser
431# vapier@gentoo.org 560# @USAGE: <user> [uid] [shell] [homedir] [groups] [params]
432# 561# @DESCRIPTION:
433# enewuser(username, uid, shell, homedir, groups, extra options) 562# Same as enewgroup, you are not required to understand how to properly add
434# 563# a user to the system. The only required parameter is the username.
435# Default values if you do not specify any: 564# Default uid is (pass -1 for this) next available, default shell is
436# username: REQUIRED ! 565# /bin/false, default homedir is /dev/null, there are no default groups,
437# uid: next available (see useradd(8)) 566# and default params sets the comment as 'added by portage for ${PN}'.
438# note: pass -1 to get default behavior
439# shell: /bin/false
440# homedir: /dev/null
441# groups: none
442# extra: comment of 'added by portage for ${PN}'
443enewuser() { 567enewuser() {
444 case ${EBUILD_PHASE} in 568 case ${EBUILD_PHASE} in
445 unpack|compile|test|install) 569 unpack|compile|test|install)
446 eerror "'enewuser()' called from '${EBUILD_PHASE}()' which is not a pkg_* function." 570 eerror "'enewuser()' called from '${EBUILD_PHASE}()' which is not a pkg_* function."
447 eerror "Package fails at QA and at life. Please file a bug." 571 eerror "Package fails at QA and at life. Please file a bug."
615 fi 739 fi
616 ;; 740 ;;
617 741
618 *) 742 *)
619 if [[ -z $@ ]] ; then 743 if [[ -z $@ ]] ; then
620 useradd ${opts} ${euser} \ 744 useradd -r ${opts} \
621 -c "added by portage for ${PN}" \ 745 -c "added by portage for ${PN}" \
746 ${euser} \
622 || die "enewuser failed" 747 || die "enewuser failed"
623 else 748 else
624 einfo " - Extra: $@" 749 einfo " - Extra: $@"
625 useradd ${opts} ${euser} "$@" \ 750 useradd -r ${opts} "$@" \
751 ${euser} \
626 || die "enewuser failed" 752 || die "enewuser failed"
627 fi 753 fi
628 ;; 754 ;;
629 esac 755 esac
630 756
636 fi 762 fi
637 763
638 export SANDBOX_ON=${oldsandbox} 764 export SANDBOX_ON=${oldsandbox}
639} 765}
640 766
641# Simplify/standardize adding groups to the system 767# @FUNCTION: enewgroup
642# vapier@gentoo.org 768# @USAGE: <group> [gid]
643# 769# @DESCRIPTION:
644# enewgroup(group, gid) 770# This function does not require you to understand how to properly add a
645# 771# group to the system. Just give it a group name to add and enewgroup will
646# Default values if you do not specify any: 772# do the rest. You may specify the gid for the group or allow the group to
647# groupname: REQUIRED ! 773# allocate the next available one.
648# gid: next available (see groupadd(8))
649# extra: none
650enewgroup() { 774enewgroup() {
651 case ${EBUILD_PHASE} in 775 case ${EBUILD_PHASE} in
652 unpack|compile|test|install) 776 unpack|compile|test|install)
653 eerror "'enewgroup()' called from '${EBUILD_PHASE}()' which is not a pkg_* function." 777 eerror "'enewgroup()' called from '${EBUILD_PHASE}()' which is not a pkg_* function."
654 eerror "Package fails at QA and at life. Please file a bug." 778 eerror "Package fails at QA and at life. Please file a bug."
744 esac 868 esac
745 groupadd -g ${egid} ${egroup} || die "enewgroup failed" 869 groupadd -g ${egid} ${egroup} || die "enewgroup failed"
746 ;; 870 ;;
747 871
748 *) 872 *)
873 # We specify -r so that we get a GID in the system range from login.defs
749 groupadd ${opts} ${egroup} || die "enewgroup failed" 874 groupadd -r ${opts} ${egroup} || die "enewgroup failed"
750 ;; 875 ;;
751 esac 876 esac
752 export SANDBOX_ON="${oldsandbox}" 877 export SANDBOX_ON="${oldsandbox}"
753} 878}
754 879
755# Simple script to replace 'dos2unix' binaries 880# @FUNCTION: edos2unix
756# vapier@gentoo.org 881# @USAGE: <file> [more files ...]
757# 882# @DESCRIPTION:
758# edos2unix(file, <more files> ...) 883# A handy replacement for dos2unix, recode, fixdos, etc... This allows you
884# to remove all of these text utilities from DEPEND variables because this
885# is a script based solution. Just give it a list of files to convert and
886# they will all be changed from the DOS CRLF format to the UNIX LF format.
759edos2unix() { 887edos2unix() {
760 echo "$@" | xargs sed -i 's/\r$//' 888 echo "$@" | xargs sed -i 's/\r$//'
761} 889}
762
763
764##############################################################
765# START: Handle .desktop files and menu entries #
766# maybe this should be separated into a new eclass some time #
767# lanius@gentoo.org #
768##############################################################
769 890
770# Make a desktop file ! 891# Make a desktop file !
771# Great for making those icons in kde/gnome startmenu ! 892# Great for making those icons in kde/gnome startmenu !
772# Amaze your friends ! Get the women ! Join today ! 893# Amaze your friends ! Get the women ! Join today !
773# 894#
774# make_desktop_entry(<command>, [name], [icon], [type], [path]) 895# make_desktop_entry(<command>, [name], [icon], [type], [fields])
775# 896#
776# binary: what command does the app run with ? 897# binary: what command does the app run with ?
777# name: the name that will show up in the menu 898# name: the name that will show up in the menu
778# icon: give your little like a pretty little icon ... 899# icon: give your little like a pretty little icon ...
779# this can be relative (to /usr/share/pixmaps) or 900# this can be relative (to /usr/share/pixmaps) or
780# a full path to an icon 901# a full path to an icon
781# type: what kind of application is this ? for categories: 902# type: what kind of application is this ? for categories:
782# http://www.freedesktop.org/Standards/desktop-entry-spec 903# http://standards.freedesktop.org/menu-spec/latest/apa.html
783# path: if your app needs to startup in a specific dir 904# fields: extra fields to append to the desktop file; a printf string
784make_desktop_entry() { 905make_desktop_entry() {
785 [[ -z $1 ]] && eerror "make_desktop_entry: You must specify the executable" && return 1 906 [[ -z $1 ]] && die "make_desktop_entry: You must specify the executable"
786 907
787 local exec=${1} 908 local exec=${1}
788 local name=${2:-${PN}} 909 local name=${2:-${PN}}
789 local icon=${3:-${PN}.png} 910 local icon=${3:-${PN}}
790 local type=${4} 911 local type=${4}
791 local path=${5} 912 local fields=${5}
792 913
793 if [[ -z ${type} ]] ; then 914 if [[ -z ${type} ]] ; then
794 local catmaj=${CATEGORY%%-*} 915 local catmaj=${CATEGORY%%-*}
795 local catmin=${CATEGORY##*-} 916 local catmin=${CATEGORY##*-}
796 case ${catmaj} in 917 case ${catmaj} in
797 app) 918 app)
798 case ${catmin} in 919 case ${catmin} in
920 accessibility) type=Accessibility;;
799 admin) type=System;; 921 admin) type=System;;
922 antivirus) type=System;;
923 arch) type=Archiving;;
924 backup) type=Archiving;;
800 cdr) type=DiscBurning;; 925 cdr) type=DiscBurning;;
801 dicts) type=Dictionary;; 926 dicts) type=Dictionary;;
927 doc) type=Documentation;;
802 editors) type=TextEditor;; 928 editors) type=TextEditor;;
803 emacs) type=TextEditor;; 929 emacs) type=TextEditor;;
804 emulation) type=Emulator;; 930 emulation) type=Emulator;;
805 laptop) type=HardwareSettings;; 931 laptop) type=HardwareSettings;;
806 office) type=Office;; 932 office) type=Office;;
933 pda) type=PDA;;
807 vim) type=TextEditor;; 934 vim) type=TextEditor;;
808 xemacs) type=TextEditor;; 935 xemacs) type=TextEditor;;
809 *) type=;;
810 esac 936 esac
811 ;; 937 ;;
812 938
813 dev) 939 dev)
814 type="Development" 940 type="Development"
815 ;; 941 ;;
816 942
817 games) 943 games)
818 case ${catmin} in 944 case ${catmin} in
819 action|fps) type=ActionGame;; 945 action|fps) type=ActionGame;;
820 arcade) type=ArcadeGame;; 946 arcade) type=ArcadeGame;;
821 board) type=BoardGame;; 947 board) type=BoardGame;;
822 kids) type=KidsGame;;
823 emulation) type=Emulator;; 948 emulation) type=Emulator;;
949 kids) type=KidsGame;;
824 puzzle) type=LogicGame;; 950 puzzle) type=LogicGame;;
825 rpg) type=RolePlaying;;
826 roguelike) type=RolePlaying;; 951 roguelike) type=RolePlaying;;
952 rpg) type=RolePlaying;;
827 simulation) type=Simulation;; 953 simulation) type=Simulation;;
828 sports) type=SportsGame;; 954 sports) type=SportsGame;;
829 strategy) type=StrategyGame;; 955 strategy) type=StrategyGame;;
830 *) type=;;
831 esac 956 esac
832 type="Game;${type}" 957 type="Game;${type}"
833 ;; 958 ;;
834 959
960 gnome)
961 type="Gnome;GTK"
962 ;;
963
964 kde)
965 type="KDE;Qt"
966 ;;
967
835 mail) 968 mail)
836 type="Network;Email" 969 type="Network;Email"
837 ;; 970 ;;
838 971
839 media) 972 media)
840 case ${catmin} in 973 case ${catmin} in
974 gfx)
841 gfx) type=Graphics;; 975 type=Graphics
976 ;;
977 *)
978 case ${catmin} in
842 radio) type=Tuner;; 979 radio) type=Tuner;;
843 sound) type=Audio;; 980 sound) type=Audio;;
844 tv) type=TV;; 981 tv) type=TV;;
845 video) type=Video;; 982 video) type=Video;;
846 *) type=;; 983 esac
984 type="AudioVideo;${type}"
985 ;;
847 esac 986 esac
848 type="AudioVideo;${type}"
849 ;; 987 ;;
850 988
851 net) 989 net)
852 case ${catmin} in 990 case ${catmin} in
853 dialup) type=Dialup;; 991 dialup) type=Dialup;;
854 ftp) type=FileTransfer;; 992 ftp) type=FileTransfer;;
855 im) type=InstantMessaging;; 993 im) type=InstantMessaging;;
856 irc) type=IRCClient;; 994 irc) type=IRCClient;;
857 mail) type=Email;; 995 mail) type=Email;;
858 news) type=News;; 996 news) type=News;;
859 nntp) type=News;; 997 nntp) type=News;;
860 p2p) type=FileTransfer;; 998 p2p) type=FileTransfer;;
861 *) type=;; 999 voip) type=Telephony;;
862 esac 1000 esac
863 type="Network;${type}" 1001 type="Network;${type}"
864 ;; 1002 ;;
865 1003
866 sci) 1004 sci)
867 case ${catmin} in 1005 case ${catmin} in
868 astro*) type=Astronomy;; 1006 astro*) type=Astronomy;;
869 bio*) type=Biology;; 1007 bio*) type=Biology;;
870 calc*) type=Calculator;; 1008 calc*) type=Calculator;;
871 chem*) type=Chemistry;; 1009 chem*) type=Chemistry;;
1010 elec*) type=Electronics;;
872 geo*) type=Geology;; 1011 geo*) type=Geology;;
873 math*) type=Math;; 1012 math*) type=Math;;
874 *) type=;; 1013 physics) type=Physics;;
1014 visual*) type=DataVisualization;;
875 esac 1015 esac
876 type="Science;${type}" 1016 type="Education;Science;${type}"
1017 ;;
1018
1019 sys)
1020 type="System"
877 ;; 1021 ;;
878 1022
879 www) 1023 www)
880 case ${catmin} in 1024 case ${catmin} in
881 client) type=WebBrowser;; 1025 client) type=WebBrowser;;
882 *) type=;;
883 esac 1026 esac
884 type="Network" 1027 type="Network;${type}"
885 ;; 1028 ;;
886 1029
887 *) 1030 *)
888 type= 1031 type=
889 ;; 1032 ;;
895 local desktop_name="${PN}-${SLOT}" 1038 local desktop_name="${PN}-${SLOT}"
896 fi 1039 fi
897 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop" 1040 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop"
898 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop 1041 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop
899 1042
1043 # Don't append another ";" when a valid category value is provided.
1044 type=${type%;}${type:+;}
1045
1046 eshopts_push -s extglob
1047 if [[ -n ${icon} && ${icon} != /* ]] && [[ ${icon} == *.xpm || ${icon} == *.png || ${icon} == *.svg ]]; then
1048 ewarn "As described in the Icon Theme Specification, icon file extensions are not"
1049 ewarn "allowed in .desktop files if the value is not an absolute path."
1050 icon=${icon%.@(xpm|png|svg)}
1051 fi
1052 eshopts_pop
1053
900 cat <<-EOF > "${desktop}" 1054 cat <<-EOF > "${desktop}"
901 [Desktop Entry] 1055 [Desktop Entry]
902 Encoding=UTF-8
903 Version=0.9.2
904 Name=${name} 1056 Name=${name}
905 Type=Application 1057 Type=Application
906 Comment=${DESCRIPTION} 1058 Comment=${DESCRIPTION}
907 Exec=${exec} 1059 Exec=${exec}
908 TryExec=${exec%% *} 1060 TryExec=${exec%% *}
909 Path=${path}
910 Icon=${icon} 1061 Icon=${icon}
911 Categories=Application;${type}; 1062 Categories=${type}
912 EOF 1063 EOF
1064
1065 if [[ ${fields:-=} != *=* ]] ; then
1066 # 5th arg used to be value to Path=
1067 ewarn "make_desktop_entry: update your 5th arg to read Path=${fields}"
1068 fields="Path=${fields}"
1069 fi
1070 [[ -n ${fields} ]] && printf '%b\n' "${fields}" >> "${desktop}"
913 1071
914 ( 1072 (
915 # wrap the env here so that the 'insinto' call 1073 # wrap the env here so that the 'insinto' call
916 # doesn't corrupt the env of the caller 1074 # doesn't corrupt the env of the caller
917 insinto /usr/share/applications 1075 insinto /usr/share/applications
918 doins "${desktop}" 1076 doins "${desktop}"
919 ) 1077 ) || die "installing desktop file failed"
920} 1078}
921 1079
922# Make a GDM/KDM Session file 1080# @FUNCTION: validate_desktop_entries
923# 1081# @USAGE: [directories]
924# make_session_desktop(<title>, <command>) 1082# @MAINTAINER:
925# title: File to execute to start the Window Manager 1083# Carsten Lohrke <carlo@gentoo.org>
926# command: Name of the Window Manager 1084# @DESCRIPTION:
1085# Validate desktop entries using desktop-file-utils
1086validate_desktop_entries() {
1087 if [[ -x /usr/bin/desktop-file-validate ]] ; then
1088 einfo "Checking desktop entry validity"
1089 local directories=""
1090 for d in /usr/share/applications $@ ; do
1091 [[ -d ${D}${d} ]] && directories="${directories} ${D}${d}"
1092 done
1093 if [[ -n ${directories} ]] ; then
1094 for FILE in $(find ${directories} -name "*\.desktop" \
1095 -not -path '*.hidden*' | sort -u 2>/dev/null)
1096 do
1097 local temp=$(desktop-file-validate ${FILE} | grep -v "warning:" | \
1098 sed -e "s|error: ||" -e "s|${FILE}:|--|g" )
1099 [[ -n $temp ]] && elog ${temp/--/${FILE/${D}/}:}
1100 done
1101 fi
1102 echo ""
1103 else
1104 einfo "Passing desktop entry validity check. Install dev-util/desktop-file-utils, if you want to help to improve Gentoo."
1105 fi
1106}
927 1107
1108# @FUNCTION: make_session_desktop
1109# @USAGE: <title> <command> [command args...]
1110# @DESCRIPTION:
1111# Make a GDM/KDM Session file. The title is the file to execute to start the
1112# Window Manager. The command is the name of the Window Manager.
1113#
1114# You can set the name of the file via the ${wm} variable.
928make_session_desktop() { 1115make_session_desktop() {
929 [[ -z $1 ]] && eerror "make_session_desktop: You must specify the title" && return 1 1116 [[ -z $1 ]] && eerror "$0: You must specify the title" && return 1
930 [[ -z $2 ]] && eerror "make_session_desktop: You must specify the command" && return 1 1117 [[ -z $2 ]] && eerror "$0: You must specify the command" && return 1
931 1118
932 local title=$1 1119 local title=$1
933 local command=$2 1120 local command=$2
934 local desktop=${T}/${wm}.desktop 1121 local desktop=${T}/${wm:-${PN}}.desktop
1122 shift 2
935 1123
936 cat <<-EOF > "${desktop}" 1124 cat <<-EOF > "${desktop}"
937 [Desktop Entry] 1125 [Desktop Entry]
938 Encoding=UTF-8
939 Name=${title} 1126 Name=${title}
940 Comment=This session logs you into ${title} 1127 Comment=This session logs you into ${title}
941 Exec=${command} 1128 Exec=${command} $*
942 TryExec=${command} 1129 TryExec=${command}
943 Type=Application 1130 Type=XSession
944 EOF 1131 EOF
945 1132
946 ( 1133 (
947 # wrap the env here so that the 'insinto' call 1134 # wrap the env here so that the 'insinto' call
948 # doesn't corrupt the env of the caller 1135 # doesn't corrupt the env of the caller
949 insinto /usr/share/xsessions 1136 insinto /usr/share/xsessions
950 doins "${desktop}" 1137 doins "${desktop}"
951 ) 1138 )
952} 1139}
953 1140
1141# @FUNCTION: domenu
1142# @USAGE: <menus>
1143# @DESCRIPTION:
1144# Install the list of .desktop menu files into the appropriate directory
1145# (/usr/share/applications).
954domenu() { 1146domenu() {
955 ( 1147 (
956 # wrap the env here so that the 'insinto' call 1148 # wrap the env here so that the 'insinto' call
957 # doesn't corrupt the env of the caller 1149 # doesn't corrupt the env of the caller
958 local i j ret=0 1150 local i j ret=0
964 elif [[ -d ${i} ]] ; then 1156 elif [[ -d ${i} ]] ; then
965 for j in "${i}"/*.desktop ; do 1157 for j in "${i}"/*.desktop ; do
966 doins "${j}" 1158 doins "${j}"
967 ((ret+=$?)) 1159 ((ret+=$?))
968 done 1160 done
1161 else
1162 ((++ret))
969 fi 1163 fi
970 done 1164 done
971 exit ${ret} 1165 exit ${ret}
972 ) 1166 )
973} 1167}
1168
1169# @FUNCTION: newmenu
1170# @USAGE: <menu> <newname>
1171# @DESCRIPTION:
1172# Like all other new* functions, install the specified menu as newname.
974newmenu() { 1173newmenu() {
975 ( 1174 (
976 # wrap the env here so that the 'insinto' call 1175 # wrap the env here so that the 'insinto' call
977 # doesn't corrupt the env of the caller 1176 # doesn't corrupt the env of the caller
978 insinto /usr/share/applications 1177 insinto /usr/share/applications
979 newins "$@" 1178 newins "$@"
980 ) 1179 )
981} 1180}
982 1181
1182# @FUNCTION: doicon
1183# @USAGE: <list of icons>
1184# @DESCRIPTION:
1185# Install the list of icons into the icon directory (/usr/share/pixmaps).
1186# This is useful in conjunction with creating desktop/menu files.
983doicon() { 1187doicon() {
984 ( 1188 (
985 # wrap the env here so that the 'insinto' call 1189 # wrap the env here so that the 'insinto' call
986 # doesn't corrupt the env of the caller 1190 # doesn't corrupt the env of the caller
987 local i j ret 1191 local i j ret
993 elif [[ -d ${i} ]] ; then 1197 elif [[ -d ${i} ]] ; then
994 for j in "${i}"/*.png ; do 1198 for j in "${i}"/*.png ; do
995 doins "${j}" 1199 doins "${j}"
996 ((ret+=$?)) 1200 ((ret+=$?))
997 done 1201 done
1202 else
1203 ((++ret))
998 fi 1204 fi
999 done 1205 done
1000 exit ${ret} 1206 exit ${ret}
1001 ) 1207 )
1002} 1208}
1209
1210# @FUNCTION: newicon
1211# @USAGE: <icon> <newname>
1212# @DESCRIPTION:
1213# Like all other new* functions, install the specified icon as newname.
1003newicon() { 1214newicon() {
1004 ( 1215 (
1005 # wrap the env here so that the 'insinto' call 1216 # wrap the env here so that the 'insinto' call
1006 # doesn't corrupt the env of the caller 1217 # doesn't corrupt the env of the caller
1007 insinto /usr/share/pixmaps 1218 insinto /usr/share/pixmaps
1008 newins "$@" 1219 newins "$@"
1009 ) 1220 )
1010} 1221}
1011
1012##############################################################
1013# END: Handle .desktop files and menu entries #
1014##############################################################
1015
1016 1222
1017# for internal use only (unpack_pdv and unpack_makeself) 1223# for internal use only (unpack_pdv and unpack_makeself)
1018find_unpackable_file() { 1224find_unpackable_file() {
1019 local src=$1 1225 local src=$1
1020 if [[ -z ${src} ]] ; then 1226 if [[ -z ${src} ]] ; then
1030 fi 1236 fi
1031 [[ ! -e ${src} ]] && return 1 1237 [[ ! -e ${src} ]] && return 1
1032 echo "${src}" 1238 echo "${src}"
1033} 1239}
1034 1240
1241# @FUNCTION: unpack_pdv
1242# @USAGE: <file to unpack> <size of off_t>
1243# @DESCRIPTION:
1035# Unpack those pesky pdv generated files ... 1244# Unpack those pesky pdv generated files ...
1036# They're self-unpacking programs with the binary package stuffed in 1245# They're self-unpacking programs with the binary package stuffed in
1037# the middle of the archive. Valve seems to use it a lot ... too bad 1246# the middle of the archive. Valve seems to use it a lot ... too bad
1038# it seems to like to segfault a lot :(. So lets take it apart ourselves. 1247# it seems to like to segfault a lot :(. So lets take it apart ourselves.
1039# 1248#
1040# Usage: unpack_pdv [file to unpack] [size of off_t]
1041# - you have to specify the off_t size ... i have no idea how to extract that 1249# You have to specify the off_t size ... I have no idea how to extract that
1042# information out of the binary executable myself. basically you pass in 1250# information out of the binary executable myself. Basically you pass in
1043# the size of the off_t type (in bytes) on the machine that built the pdv 1251# the size of the off_t type (in bytes) on the machine that built the pdv
1252# archive.
1253#
1044# archive. one way to determine this is by running the following commands: 1254# One way to determine this is by running the following commands:
1255#
1256# @CODE
1045# strings <pdv archive> | grep lseek 1257# strings <pdv archive> | grep lseek
1046# strace -elseek <pdv archive> 1258# strace -elseek <pdv archive>
1259# @CODE
1260#
1047# basically look for the first lseek command (we do the strings/grep because 1261# Basically look for the first lseek command (we do the strings/grep because
1048# sometimes the function call is _llseek or something) and steal the 2nd 1262# sometimes the function call is _llseek or something) and steal the 2nd
1049# parameter. here is an example: 1263# parameter. Here is an example:
1264#
1265# @CODE
1050# root@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek 1266# vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek
1051# lseek 1267# lseek
1052# root@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin 1268# vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin
1053# lseek(3, -4, SEEK_END) = 2981250 1269# lseek(3, -4, SEEK_END) = 2981250
1270# @CODE
1271#
1054# thus we would pass in the value of '4' as the second parameter. 1272# Thus we would pass in the value of '4' as the second parameter.
1055unpack_pdv() { 1273unpack_pdv() {
1056 local src=$(find_unpackable_file "$1") 1274 local src=$(find_unpackable_file "$1")
1057 local sizeoff_t=$2 1275 local sizeoff_t=$2
1058 1276
1059 [[ -z ${src} ]] && die "Could not locate source for '$1'" 1277 [[ -z ${src} ]] && die "Could not locate source for '$1'"
1121 true 1339 true
1122 #[ -s "${datafile}" ] || die "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')" 1340 #[ -s "${datafile}" ] || die "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')"
1123 #assert "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')" 1341 #assert "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')"
1124} 1342}
1125 1343
1344# @FUNCTION: unpack_makeself
1345# @USAGE: [file to unpack] [offset] [tail|dd]
1346# @DESCRIPTION:
1126# Unpack those pesky makeself generated files ... 1347# Unpack those pesky makeself generated files ...
1127# They're shell scripts with the binary package tagged onto 1348# They're shell scripts with the binary package tagged onto
1128# the end of the archive. Loki utilized the format as does 1349# the end of the archive. Loki utilized the format as does
1129# many other game companies. 1350# many other game companies.
1130# 1351#
1131# Usage: unpack_makeself [file to unpack] [offset] [tail|dd] 1352# If the file is not specified, then ${A} is used. If the
1132# - If the file is not specified then unpack will utilize ${A}.
1133# - If the offset is not specified then we will attempt to extract 1353# offset is not specified then we will attempt to extract
1134# the proper offset from the script itself. 1354# the proper offset from the script itself.
1135unpack_makeself() { 1355unpack_makeself() {
1136 local src_input=${1:-${A}} 1356 local src_input=${1:-${A}}
1137 local src=$(find_unpackable_file "${src_input}") 1357 local src=$(find_unpackable_file "${src_input}")
1138 local skip=$2 1358 local skip=$2
1139 local exe=$3 1359 local exe=$3
1141 [[ -z ${src} ]] && die "Could not locate source for '${src_input}'" 1361 [[ -z ${src} ]] && die "Could not locate source for '${src_input}'"
1142 1362
1143 local shrtsrc=$(basename "${src}") 1363 local shrtsrc=$(basename "${src}")
1144 echo ">>> Unpacking ${shrtsrc} to ${PWD}" 1364 echo ">>> Unpacking ${shrtsrc} to ${PWD}"
1145 if [[ -z ${skip} ]] ; then 1365 if [[ -z ${skip} ]] ; then
1146 local ver=$(grep -a '#.*Makeself' "${src}" | awk '{print $NF}') 1366 local ver=$(grep -m1 -a '#.*Makeself' "${src}" | awk '{print $NF}')
1147 local skip=0 1367 local skip=0
1148 exe=tail 1368 exe=tail
1149 case ${ver} in 1369 case ${ver} in
1150 1.5.*|1.6.0-nv) # tested 1.5.{3,4,5} ... guessing 1.5.x series is same 1370 1.5.*|1.6.0-nv) # tested 1.5.{3,4,5} ... guessing 1.5.x series is same
1151 skip=$(grep -a ^skip= "${src}" | cut -d= -f2) 1371 skip=$(grep -a ^skip= "${src}" | cut -d= -f2)
1153 2.0|2.0.1) 1373 2.0|2.0.1)
1154 skip=$(grep -a ^$'\t'tail "${src}" | awk '{print $2}' | cut -b2-) 1374 skip=$(grep -a ^$'\t'tail "${src}" | awk '{print $2}' | cut -b2-)
1155 ;; 1375 ;;
1156 2.1.1) 1376 2.1.1)
1157 skip=$(grep -a ^offset= "${src}" | awk '{print $2}' | cut -b2-) 1377 skip=$(grep -a ^offset= "${src}" | awk '{print $2}' | cut -b2-)
1158 let skip="skip + 1" 1378 (( skip++ ))
1159 ;; 1379 ;;
1160 2.1.2) 1380 2.1.2)
1161 skip=$(grep -a ^offset= "${src}" | awk '{print $3}' | head -n 1) 1381 skip=$(grep -a ^offset= "${src}" | awk '{print $3}' | head -n 1)
1162 let skip="skip + 1" 1382 (( skip++ ))
1163 ;; 1383 ;;
1164 2.1.3) 1384 2.1.3)
1165 skip=`grep -a ^offset= "${src}" | awk '{print $3}'` 1385 skip=`grep -a ^offset= "${src}" | awk '{print $3}'`
1166 let skip="skip + 1" 1386 (( skip++ ))
1167 ;; 1387 ;;
1168 2.1.4|2.1.5) 1388 2.1.4|2.1.5)
1169 skip=$(grep -a offset=.*head.*wc "${src}" | awk '{print $3}' | head -n 1) 1389 skip=$(grep -a offset=.*head.*wc "${src}" | awk '{print $3}' | head -n 1)
1170 skip=$(head -n ${skip} "${src}" | wc -c) 1390 skip=$(head -n ${skip} "${src}" | wc -c)
1171 exe="dd" 1391 exe="dd"
1180 esac 1400 esac
1181 debug-print "Detected Makeself version ${ver} ... using ${skip} as offset" 1401 debug-print "Detected Makeself version ${ver} ... using ${skip} as offset"
1182 fi 1402 fi
1183 case ${exe} in 1403 case ${exe} in
1184 tail) exe="tail -n +${skip} '${src}'";; 1404 tail) exe="tail -n +${skip} '${src}'";;
1185 dd) exe="dd ibs=${skip} skip=1 obs=1024 conv=sync if='${src}'";; 1405 dd) exe="dd ibs=${skip} skip=1 if='${src}'";;
1186 *) die "makeself cant handle exe '${exe}'" 1406 *) die "makeself cant handle exe '${exe}'"
1187 esac 1407 esac
1188 1408
1189 # lets grab the first few bytes of the file to figure out what kind of archive it is 1409 # lets grab the first few bytes of the file to figure out what kind of archive it is
1190 local tmpfile=$(emktemp) 1410 local filetype tmpfile=$(emktemp)
1191 eval ${exe} 2>/dev/null | head -c 512 > "${tmpfile}" 1411 eval ${exe} 2>/dev/null | head -c 512 > "${tmpfile}"
1192 local filetype=$(file -b "${tmpfile}") 1412 filetype=$(file -b "${tmpfile}") || die
1193 case ${filetype} in 1413 case ${filetype} in
1194 *tar\ archive*) 1414 *tar\ archive*)
1195 eval ${exe} | tar --no-same-owner -xf - 1415 eval ${exe} | tar --no-same-owner -xf -
1196 ;; 1416 ;;
1197 bzip2*) 1417 bzip2*)
1209 ;; 1429 ;;
1210 esac 1430 esac
1211 assert "failure unpacking (${filetype}) makeself ${shrtsrc} ('${ver}' +${skip})" 1431 assert "failure unpacking (${filetype}) makeself ${shrtsrc} ('${ver}' +${skip})"
1212} 1432}
1213 1433
1434# @FUNCTION: check_license
1435# @USAGE: [license]
1436# @DESCRIPTION:
1214# Display a license for user to accept. 1437# Display a license for user to accept. If no license is
1215#
1216# Usage: check_license [license]
1217# - If the file is not specified then ${LICENSE} is used. 1438# specified, then ${LICENSE} is used.
1218check_license() { 1439check_license() {
1219 local lic=$1 1440 local lic=$1
1220 if [ -z "${lic}" ] ; then 1441 if [ -z "${lic}" ] ; then
1221 lic="${PORTDIR}/licenses/${LICENSE}" 1442 lic="${PORTDIR}/licenses/${LICENSE}"
1222 else 1443 else
1226 lic="${PWD}/${lic}" 1447 lic="${PWD}/${lic}"
1227 elif [ -e "${lic}" ] ; then 1448 elif [ -e "${lic}" ] ; then
1228 lic="${lic}" 1449 lic="${lic}"
1229 fi 1450 fi
1230 fi 1451 fi
1231 [ ! -f "${lic}" ] && die "Could not find requested license ${lic}"
1232 local l="`basename ${lic}`" 1452 local l="`basename ${lic}`"
1233 1453
1234 # here is where we check for the licenses the user already 1454 # here is where we check for the licenses the user already
1235 # accepted ... if we don't find a match, we make the user accept 1455 # accepted ... if we don't find a match, we make the user accept
1236 local shopts=$-
1237 local alic 1456 local alic
1238 set -o noglob #so that bash doesn't expand "*" 1457 eshopts_push -o noglob # so that bash doesn't expand "*"
1239 for alic in ${ACCEPT_LICENSE} ; do 1458 for alic in ${ACCEPT_LICENSE} ; do
1240 if [[ ${alic} == ${l} ]]; then 1459 if [[ ${alic} == ${l} ]]; then
1241 set +o noglob; set -${shopts} #reset old shell opts 1460 eshopts_pop
1242 return 0 1461 return 0
1243 fi 1462 fi
1244 done 1463 done
1245 set +o noglob; set -$shopts #reset old shell opts 1464 eshopts_pop
1465 [ ! -f "${lic}" ] && die "Could not find requested license ${lic}"
1246 1466
1247 local licmsg=$(emktemp) 1467 local licmsg=$(emktemp)
1248 cat <<-EOF > ${licmsg} 1468 cat <<-EOF > ${licmsg}
1249 ********************************************************** 1469 **********************************************************
1250 The following license outlines the terms of use of this 1470 The following license outlines the terms of use of this
1251 package. You MUST accept this license for installation to 1471 package. You MUST accept this license for installation to
1252 continue. When you are done viewing, hit 'q'. If you 1472 continue. When you are done viewing, hit 'q'. If you
1253 CTRL+C out of this, the install will not run! 1473 CTRL+C out of this, the install will not run!
1254 ********************************************************** 1474 **********************************************************
1255 1475
1256 EOF 1476 EOF
1257 cat ${lic} >> ${licmsg} 1477 cat ${lic} >> ${licmsg}
1258 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}" 1478 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}"
1259 einfon "Do you accept the terms of this license (${l})? [yes/no] " 1479 einfon "Do you accept the terms of this license (${l})? [yes/no] "
1260 read alic 1480 read alic
1268 die "Failed to accept license" 1488 die "Failed to accept license"
1269 ;; 1489 ;;
1270 esac 1490 esac
1271} 1491}
1272 1492
1493# @FUNCTION: cdrom_get_cds
1494# @USAGE: <file on cd1> [file on cd2] [file on cd3] [...]
1495# @DESCRIPTION:
1273# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates 1496# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates
1274# the whole 'non-interactive' policy, but damnit I want CD support ! 1497# the whole 'non-interactive' policy, but damnit I want CD support !
1275# 1498#
1276# with these cdrom functions we handle all the user interaction and 1499# With these cdrom functions we handle all the user interaction and
1277# standardize everything. all you have to do is call cdrom_get_cds() 1500# standardize everything. All you have to do is call cdrom_get_cds()
1278# and when the function returns, you can assume that the cd has been 1501# and when the function returns, you can assume that the cd has been
1279# found at CDROM_ROOT. 1502# found at CDROM_ROOT.
1280# 1503#
1504# The function will attempt to locate a cd based upon a file that is on
1505# the cd. The more files you give this function, the more cds
1506# the cdrom functions will handle.
1507#
1281# normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2', 1508# Normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2',
1282# etc... if you want to give the cds better names, then just export 1509# etc... If you want to give the cds better names, then just export
1283# the appropriate CDROM_NAME variable before calling cdrom_get_cds(). 1510# the appropriate CDROM_NAME variable before calling cdrom_get_cds().
1284# - CDROM_NAME="fooie cd" - for when you only want 1 cd 1511# Use CDROM_NAME for one cd, or CDROM_NAME_# for multiple cds. You can
1285# - CDROM_NAME_1="install cd" - for when you want more than 1 cd 1512# also use the CDROM_NAME_SET bash array.
1286# CDROM_NAME_2="data cd"
1287# - CDROM_NAME_SET=( "install cd" "data cd" ) - short hand for CDROM_NAME_#
1288# 1513#
1289# for those multi cd ebuilds, see the cdrom_load_next_cd() below. 1514# For those multi cd ebuilds, see the cdrom_load_next_cd() function.
1290#
1291# Usage: cdrom_get_cds <file on cd1> [file on cd2] [file on cd3] [...]
1292# - this will attempt to locate a cd based upon a file that is on
1293# the cd ... the more files you give this function, the more cds
1294# the cdrom functions will handle
1295cdrom_get_cds() { 1515cdrom_get_cds() {
1296 # first we figure out how many cds we're dealing with by 1516 # first we figure out how many cds we're dealing with by
1297 # the # of files they gave us 1517 # the # of files they gave us
1298 local cdcnt=0 1518 local cdcnt=0
1299 local f= 1519 local f=
1323 export CDROM_ROOT=${CD_ROOT_1:-${CD_ROOT}} 1543 export CDROM_ROOT=${CD_ROOT_1:-${CD_ROOT}}
1324 einfo "Found CD #${CDROM_CURRENT_CD} root at ${CDROM_ROOT}" 1544 einfo "Found CD #${CDROM_CURRENT_CD} root at ${CDROM_ROOT}"
1325 export CDROM_SET=-1 1545 export CDROM_SET=-1
1326 for f in ${CDROM_CHECK_1//:/ } ; do 1546 for f in ${CDROM_CHECK_1//:/ } ; do
1327 ((++CDROM_SET)) 1547 ((++CDROM_SET))
1328 [[ -e ${CD_ROOT}/${f} ]] && break 1548 [[ -e ${CDROM_ROOT}/${f} ]] && break
1329 done 1549 done
1330 export CDROM_MATCH=${f} 1550 export CDROM_MATCH=${f}
1331 return 1551 return
1332 fi 1552 fi
1333 1553
1385 export CDROM_SET="" 1605 export CDROM_SET=""
1386 export CDROM_CURRENT_CD=0 1606 export CDROM_CURRENT_CD=0
1387 cdrom_load_next_cd 1607 cdrom_load_next_cd
1388} 1608}
1389 1609
1390# this is only used when you need access to more than one cd. 1610# @FUNCTION: cdrom_load_next_cd
1391# when you have finished using the first cd, just call this function. 1611# @DESCRIPTION:
1392# when it returns, CDROM_ROOT will be pointing to the second cd. 1612# Some packages are so big they come on multiple CDs. When you're done reading
1393# remember, you can only go forward in the cd chain, you can't go back. 1613# files off a CD and want access to the next one, just call this function.
1614# Again, all the messy details of user interaction are taken care of for you.
1615# Once this returns, just read the variable CDROM_ROOT for the location of the
1616# mounted CD. Note that you can only go forward in the CD list, so make sure
1617# you only call this function when you're done using the current CD.
1394cdrom_load_next_cd() { 1618cdrom_load_next_cd() {
1395 local var 1619 local var
1396 ((++CDROM_CURRENT_CD)) 1620 ((++CDROM_CURRENT_CD))
1397 1621
1398 unset CDROM_ROOT 1622 unset CDROM_ROOT
1415# displayed and we'll hang out here until: 1639# displayed and we'll hang out here until:
1416# (1) the file is found on a mounted cdrom 1640# (1) the file is found on a mounted cdrom
1417# (2) the user hits CTRL+C 1641# (2) the user hits CTRL+C
1418_cdrom_locate_file_on_cd() { 1642_cdrom_locate_file_on_cd() {
1419 local mline="" 1643 local mline=""
1420 local showedmsg=0 1644 local showedmsg=0 showjolietmsg=0
1421 1645
1422 while [[ -z ${CDROM_ROOT} ]] ; do 1646 while [[ -z ${CDROM_ROOT} ]] ; do
1423 local i=0 1647 local i=0
1424 local -a cdset=(${*//:/ }) 1648 local -a cdset=(${*//:/ })
1425 if [[ -n ${CDROM_SET} ]] ; then 1649 if [[ -n ${CDROM_SET} ]] ; then
1430 local dir=$(dirname ${cdset[${i}]}) 1654 local dir=$(dirname ${cdset[${i}]})
1431 local file=$(basename ${cdset[${i}]}) 1655 local file=$(basename ${cdset[${i}]})
1432 1656
1433 local point= node= fs= foo= 1657 local point= node= fs= foo=
1434 while read point node fs foo ; do 1658 while read point node fs foo ; do
1435 [[ " cd9660 iso9660 " != *" ${fs} "* ]] && \ 1659 [[ " cd9660 iso9660 udf " != *" ${fs} "* ]] && \
1436 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \ 1660 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \
1437 && continue 1661 && continue
1438 point=${point//\040/ } 1662 point=${point//\040/ }
1663 [[ ! -d ${point}/${dir} ]] && continue
1439 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue 1664 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue
1440 export CDROM_ROOT=${point} 1665 export CDROM_ROOT=${point}
1441 export CDROM_SET=${i} 1666 export CDROM_SET=${i}
1442 export CDROM_MATCH=${cdset[${i}]} 1667 export CDROM_MATCH=${cdset[${i}]}
1443 return 1668 return
1465 showedmsg=1 1690 showedmsg=1
1466 fi 1691 fi
1467 einfo "Press return to scan for the cd again" 1692 einfo "Press return to scan for the cd again"
1468 einfo "or hit CTRL+C to abort the emerge." 1693 einfo "or hit CTRL+C to abort the emerge."
1469 echo 1694 echo
1695 if [[ ${showjolietmsg} -eq 0 ]] ; then
1696 showjolietmsg=1
1697 else
1470 einfo "If you are having trouble with the detection" 1698 ewarn "If you are having trouble with the detection"
1471 einfo "of your CD, it is possible that you do not have" 1699 ewarn "of your CD, it is possible that you do not have"
1472 einfo "Joliet support enabled in your kernel. Please" 1700 ewarn "Joliet support enabled in your kernel. Please"
1473 einfo "check that CONFIG_JOLIET is enabled in your kernel." 1701 ewarn "check that CONFIG_JOLIET is enabled in your kernel."
1702 ebeep 5
1703 fi
1474 read || die "something is screwed with your system" 1704 read || die "something is screwed with your system"
1475 done 1705 done
1476} 1706}
1477 1707
1708# @FUNCTION: strip-linguas
1709# @USAGE: [<allow LINGUAS>|<-i|-u> <directories of .po files>]
1710# @DESCRIPTION:
1478# Make sure that LINGUAS only contains languages that 1711# Make sure that LINGUAS only contains languages that
1479# a package can support 1712# a package can support. The first form allows you to
1480# 1713# specify a list of LINGUAS. The -i builds a list of po
1481# usage: strip-linguas <allow LINGUAS> 1714# files found in all the directories and uses the
1482# strip-linguas -i <directories of .po files> 1715# intersection of the lists. The -u builds a list of po
1483# strip-linguas -u <directories of .po files> 1716# files found in all the directories and uses the union
1484# 1717# of the lists.
1485# The first form allows you to specify a list of LINGUAS.
1486# The -i builds a list of po files found in all the
1487# directories and uses the intersection of the lists.
1488# The -u builds a list of po files found in all the
1489# directories and uses the union of the lists.
1490strip-linguas() { 1718strip-linguas() {
1491 local ls newls nols 1719 local ls newls nols
1492 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then 1720 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then
1493 local op=$1; shift 1721 local op=$1; shift
1494 ls=$(find "$1" -name '*.po' -exec basename {} .po \;); shift 1722 ls=$(find "$1" -name '*.po' -exec basename {} .po ';'); shift
1495 local d f 1723 local d f
1496 for d in "$@" ; do 1724 for d in "$@" ; do
1497 if [[ ${op} == "-u" ]] ; then 1725 if [[ ${op} == "-u" ]] ; then
1498 newls=${ls} 1726 newls=${ls}
1499 else 1727 else
1500 newls="" 1728 newls=""
1501 fi 1729 fi
1502 for f in $(find "$d" -name '*.po' -exec basename {} .po \;) ; do 1730 for f in $(find "$d" -name '*.po' -exec basename {} .po ';') ; do
1503 if [[ ${op} == "-i" ]] ; then 1731 if [[ ${op} == "-i" ]] ; then
1504 hasq ${f} ${ls} && newls="${newls} ${f}" 1732 has ${f} ${ls} && newls="${newls} ${f}"
1505 else 1733 else
1506 hasq ${f} ${ls} || newls="${newls} ${f}" 1734 has ${f} ${ls} || newls="${newls} ${f}"
1507 fi 1735 fi
1508 done 1736 done
1509 ls=${newls} 1737 ls=${newls}
1510 done 1738 done
1511 else 1739 else
1513 fi 1741 fi
1514 1742
1515 nols="" 1743 nols=""
1516 newls="" 1744 newls=""
1517 for f in ${LINGUAS} ; do 1745 for f in ${LINGUAS} ; do
1518 if hasq ${f} ${ls} ; then 1746 if has ${f} ${ls} ; then
1519 newls="${newls} ${f}" 1747 newls="${newls} ${f}"
1520 else 1748 else
1521 nols="${nols} ${f}" 1749 nols="${nols} ${f}"
1522 fi 1750 fi
1523 done 1751 done
1524 [[ -n ${nols} ]] \ 1752 [[ -n ${nols} ]] \
1525 && ewarn "Sorry, but ${PN} does not support the LINGUAs:" ${nols} 1753 && ewarn "Sorry, but ${PN} does not support the LINGUAS:" ${nols}
1526 export LINGUAS=${newls:1} 1754 export LINGUAS=${newls:1}
1527} 1755}
1528 1756
1529# moved from kernel.eclass since they are generally useful outside of 1757# @FUNCTION: preserve_old_lib
1530# kernel.eclass -iggy (20041002) 1758# @USAGE: <libs to preserve> [more libs]
1531 1759# @DESCRIPTION:
1532# the following functions are useful in kernel module ebuilds, etc.
1533# for an example see ivtv or drbd ebuilds
1534
1535# set's ARCH to match what the kernel expects
1536set_arch_to_kernel() {
1537 i=10
1538 while ((i--)) ; do
1539 ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
1540 done
1541 export EUTILS_ECLASS_PORTAGE_ARCH="${ARCH}"
1542 case ${ARCH} in
1543 x86) export ARCH="i386";;
1544 amd64) export ARCH="x86_64";;
1545 hppa) export ARCH="parisc";;
1546 mips) export ARCH="mips";;
1547 sparc) export ARCH="$(tc-arch-kernel)";; # Yeah this is ugly, but it's even WORSE if you don't do this. linux-info.eclass's set_arch_to_kernel is fixed, but won't get used over this one!
1548 *) export ARCH="${ARCH}";;
1549 esac
1550}
1551
1552# set's ARCH back to what portage expects
1553set_arch_to_portage() {
1554 i=10
1555 while ((i--)) ; do
1556 ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
1557 done
1558 export ARCH="${EUTILS_ECLASS_PORTAGE_ARCH}"
1559}
1560
1561# Jeremy Huddleston <eradicator@gentoo.org>:
1562# preserve_old_lib /path/to/libblah.so.0
1563# preserve_old_lib_notify /path/to/libblah.so.0
1564#
1565# These functions are useful when a lib in your package changes --library. Such 1760# These functions are useful when a lib in your package changes ABI SONAME.
1566# an example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0 1761# An example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0
1567# would break packages that link against it. Most people get around this 1762# would break packages that link against it. Most people get around this
1568# by using the portage SLOT mechanism, but that is not always a relevant 1763# by using the portage SLOT mechanism, but that is not always a relevant
1569# solution, so instead you can add the following to your ebuilds: 1764# solution, so instead you can call this from pkg_preinst. See also the
1570# 1765# preserve_old_lib_notify function.
1571# pkg_preinst() {
1572# ...
1573# preserve_old_lib /usr/$(get_libdir)/libogg.so.0
1574# ...
1575# }
1576#
1577# pkg_postinst() {
1578# ...
1579# preserve_old_lib_notify /usr/$(get_libdir)/libogg.so.0
1580# ...
1581# }
1582
1583preserve_old_lib() { 1766preserve_old_lib() {
1584 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then 1767 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then
1585 eerror "preserve_old_lib() must be called from pkg_preinst() only" 1768 eerror "preserve_old_lib() must be called from pkg_preinst() only"
1586# die "Invalid preserve_old_lib() usage" 1769 die "Invalid preserve_old_lib() usage"
1587 fi 1770 fi
1588 [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]" 1771 [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]"
1772
1773 # let portage worry about it
1774 has preserve-libs ${FEATURES} && return 0
1589 1775
1590 local lib dir 1776 local lib dir
1591 for lib in "$@" ; do 1777 for lib in "$@" ; do
1592 [[ -e ${ROOT}/${lib} ]] || continue 1778 [[ -e ${ROOT}/${lib} ]] || continue
1593 dir=${lib%/*} 1779 dir=${lib%/*}
1595 cp "${ROOT}"/${lib} "${D}"/${lib} || die "cp ${lib} failed" 1781 cp "${ROOT}"/${lib} "${D}"/${lib} || die "cp ${lib} failed"
1596 touch "${D}"/${lib} 1782 touch "${D}"/${lib}
1597 done 1783 done
1598} 1784}
1599 1785
1786# @FUNCTION: preserve_old_lib_notify
1787# @USAGE: <libs to notify> [more libs]
1788# @DESCRIPTION:
1789# Spit helpful messages about the libraries preserved by preserve_old_lib.
1600preserve_old_lib_notify() { 1790preserve_old_lib_notify() {
1601 if [[ ${EBUILD_PHASE} != "postinst" ]] ; then 1791 if [[ ${EBUILD_PHASE} != "postinst" ]] ; then
1602 eerror "preserve_old_lib_notify() must be called from pkg_postinst() only" 1792 eerror "preserve_old_lib_notify() must be called from pkg_postinst() only"
1603# die "Invalid preserve_old_lib_notify() usage" 1793 die "Invalid preserve_old_lib_notify() usage"
1604 fi 1794 fi
1795
1796 # let portage worry about it
1797 has preserve-libs ${FEATURES} && return 0
1605 1798
1606 local lib notice=0 1799 local lib notice=0
1607 for lib in "$@" ; do 1800 for lib in "$@" ; do
1608 [[ -e ${ROOT}/${lib} ]] || continue 1801 [[ -e ${ROOT}/${lib} ]] || continue
1609 if [[ ${notice} -eq 0 ]] ; then 1802 if [[ ${notice} -eq 0 ]] ; then
1613 ewarn "the libraries are not being removed. You need to run revdep-rebuild" 1806 ewarn "the libraries are not being removed. You need to run revdep-rebuild"
1614 ewarn "in order to remove these old dependencies. If you do not have this" 1807 ewarn "in order to remove these old dependencies. If you do not have this"
1615 ewarn "helper program, simply emerge the 'gentoolkit' package." 1808 ewarn "helper program, simply emerge the 'gentoolkit' package."
1616 ewarn 1809 ewarn
1617 fi 1810 fi
1811 # temp hack for #348634 #357225
1812 [[ ${PN} == "mpfr" ]] && lib=${lib##*/}
1618 ewarn " # revdep-rebuild --library ${lib##*/}" 1813 ewarn " # revdep-rebuild --library '${lib}'"
1619 done 1814 done
1815 if [[ ${notice} -eq 1 ]] ; then
1816 ewarn
1817 ewarn "Once you've finished running revdep-rebuild, it should be safe to"
1818 ewarn "delete the old libraries. Here is a copy & paste for the lazy:"
1819 for lib in "$@" ; do
1820 ewarn " # rm '${lib}'"
1821 done
1822 fi
1620} 1823}
1621 1824
1622# Hack for people to figure out if a package was built with 1825# @FUNCTION: built_with_use
1623# certain USE flags
1624#
1625# Usage: built_with_use [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags> 1826# @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags>
1626# ex: built_with_use xchat gtk2 1827# @DESCRIPTION:
1627# 1828#
1628# Flags: -a all USE flags should be utilized 1829# Deprecated: Use EAPI 2 use deps in DEPEND|RDEPEND and with has_version calls.
1629# -o at least one USE flag should be utilized 1830#
1630# --missing peform the specified action if the flag is not in IUSE (true/false/die) 1831# A temporary hack until portage properly supports DEPENDing on USE
1631# --hidden USE flag we're checking is hidden expanded so it isnt in IUSE 1832# flags being enabled in packages. This will check to see if the specified
1632# Note: the default flag is '-a' 1833# DEPEND atom was built with the specified list of USE flags. The
1834# --missing option controls the behavior if called on a package that does
1835# not actually support the defined USE flags (aka listed in IUSE).
1836# The default is to abort (call die). The -a and -o flags control
1837# the requirements of the USE flags. They correspond to "and" and "or"
1838# logic. So the -a flag means all listed USE flags must be enabled
1839# while the -o flag means at least one of the listed IUSE flags must be
1840# enabled. The --hidden option is really for internal use only as it
1841# means the USE flag we're checking is hidden expanded, so it won't be found
1842# in IUSE like normal USE flags.
1843#
1844# Remember that this function isn't terribly intelligent so order of optional
1845# flags matter.
1633built_with_use() { 1846built_with_use() {
1634 local hidden="no" 1847 local hidden="no"
1635 if [[ $1 == "--hidden" ]] ; then 1848 if [[ $1 == "--hidden" ]] ; then
1636 hidden="yes" 1849 hidden="yes"
1637 shift 1850 shift
1666 die) die "Unable to determine what USE flags $PKG was built with";; 1879 die) die "Unable to determine what USE flags $PKG was built with";;
1667 esac 1880 esac
1668 fi 1881 fi
1669 1882
1670 if [[ ${hidden} == "no" ]] ; then 1883 if [[ ${hidden} == "no" ]] ; then
1671 local IUSE_BUILT=$(<${IUSEFILE}) 1884 local IUSE_BUILT=( $(<"${IUSEFILE}") )
1672 # Don't check USE_EXPAND #147237 1885 # Don't check USE_EXPAND #147237
1673 local expand 1886 local expand
1674 for expand in $(echo ${USE_EXPAND} | tr '[:upper:]' '[:lower:]') ; do 1887 for expand in $(echo ${USE_EXPAND} | tr '[:upper:]' '[:lower:]') ; do
1675 if [[ $1 == ${expand}_* ]] ; then 1888 if [[ $1 == ${expand}_* ]] ; then
1676 expand="" 1889 expand=""
1677 break 1890 break
1678 fi 1891 fi
1679 done 1892 done
1680 if [[ -n ${expand} ]] ; then 1893 if [[ -n ${expand} ]] ; then
1681 if ! has $1 ${IUSE_BUILT} ; then 1894 if ! has $1 ${IUSE_BUILT[@]#[-+]} ; then
1682 case ${missing_action} in 1895 case ${missing_action} in
1683 true) return 0;; 1896 true) return 0;;
1684 false) return 1;; 1897 false) return 1;;
1685 die) die "$PKG does not actually support the $1 USE flag!";; 1898 die) die "$PKG does not actually support the $1 USE flag!";;
1686 esac 1899 esac
1698 shift 1911 shift
1699 done 1912 done
1700 [[ ${opt} = "-a" ]] 1913 [[ ${opt} = "-a" ]]
1701} 1914}
1702 1915
1916# @FUNCTION: epunt_cxx
1917# @USAGE: [dir to scan]
1918# @DESCRIPTION:
1703# Many configure scripts wrongly bail when a C++ compiler 1919# Many configure scripts wrongly bail when a C++ compiler could not be
1704# could not be detected. #73450 1920# detected. If dir is not specified, then it defaults to ${S}.
1921#
1922# http://bugs.gentoo.org/73450
1705epunt_cxx() { 1923epunt_cxx() {
1706 local dir=$1 1924 local dir=$1
1707 [[ -z ${dir} ]] && dir=${S} 1925 [[ -z ${dir} ]] && dir=${S}
1708 ebegin "Removing useless C++ checks" 1926 ebegin "Removing useless C++ checks"
1709 local f 1927 local f
1710 for f in $(find ${dir} -name configure) ; do 1928 find "${dir}" -name configure | while read f ; do
1711 patch -p0 "${f}" "${PORTDIR}/eclass/ELT-patches/nocxx/nocxx.patch" > /dev/null 1929 patch --no-backup-if-mismatch -p0 "${f}" "${PORTDIR}/eclass/ELT-patches/nocxx/nocxx.patch" > /dev/null
1712 done 1930 done
1713 eend 0 1931 eend 0
1714} 1932}
1715 1933
1716# make a wrapper script ... 1934# @FUNCTION: make_wrapper
1717# NOTE: this was originally games_make_wrapper, but I noticed other places where 1935# @USAGE: <wrapper> <target> [chdir] [libpaths] [installpath]
1718# this could be used, so I have moved it here and made it not games-specific 1936# @DESCRIPTION:
1719# -- wolf31o2 1937# Create a shell wrapper script named wrapper in installpath
1720# $1 == wrapper name 1938# (defaults to the bindir) to execute target (default of wrapper) by
1721# $2 == binary to run 1939# first optionally setting LD_LIBRARY_PATH to the colon-delimited
1722# $3 == directory to chdir before running binary 1940# libpaths followed by optionally changing directory to chdir.
1723# $4 == extra LD_LIBRARY_PATH's (make it : delimited)
1724# $5 == path for wrapper
1725make_wrapper() { 1941make_wrapper() {
1726 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5 1942 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5
1727 local tmpwrapper=$(emktemp) 1943 local tmpwrapper=$(emktemp)
1728 # We don't want to quote ${bin} so that people can pass complex 1944 # We don't want to quote ${bin} so that people can pass complex
1729 # things as $bin ... "./someprog --args" 1945 # things as $bin ... "./someprog --args"
1739fi 1955fi
1740exec ${bin} "\$@" 1956exec ${bin} "\$@"
1741EOF 1957EOF
1742 chmod go+rx "${tmpwrapper}" 1958 chmod go+rx "${tmpwrapper}"
1743 if [[ -n ${path} ]] ; then 1959 if [[ -n ${path} ]] ; then
1960 (
1744 exeinto "${path}" 1961 exeinto "${path}"
1745 newexe "${tmpwrapper}" "${wrapper}" 1962 newexe "${tmpwrapper}" "${wrapper}"
1963 ) || die
1746 else 1964 else
1747 newbin "${tmpwrapper}" "${wrapper}" 1965 newbin "${tmpwrapper}" "${wrapper}" || die
1748 fi 1966 fi
1749} 1967}
1968
1969# @FUNCTION: path_exists
1970# @USAGE: [-a|-o] <paths>
1971# @DESCRIPTION:
1972# Check if the specified paths exist. Works for all types of paths
1973# (files/dirs/etc...). The -a and -o flags control the requirements
1974# of the paths. They correspond to "and" and "or" logic. So the -a
1975# flag means all the paths must exist while the -o flag means at least
1976# one of the paths must exist. The default behavior is "and". If no
1977# paths are specified, then the return value is "false".
1978path_exists() {
1979 local opt=$1
1980 [[ ${opt} == -[ao] ]] && shift || opt="-a"
1981
1982 # no paths -> return false
1983 # same behavior as: [[ -e "" ]]
1984 [[ $# -eq 0 ]] && return 1
1985
1986 local p r=0
1987 for p in "$@" ; do
1988 [[ -e ${p} ]]
1989 : $(( r += $? ))
1990 done
1991
1992 case ${opt} in
1993 -a) return $(( r != 0 )) ;;
1994 -o) return $(( r == $# )) ;;
1995 esac
1996}

Legend:
Removed from v.1.275  
changed lines
  Added in v.1.360

  ViewVC Help
Powered by ViewVC 1.1.20