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

Diff of /eclass/eutils.eclass

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

Revision 1.279 Revision 1.356
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.279 2007/04/25 09:14:35 carlo Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/eutils.eclass,v 1.356 2011/04/18 15:09:16 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 else
256 # sanity check ... if it isn't a dir or file, wtf man ?
257 [[ $# -ne 0 ]] && EPATCH_SOURCE=$1
258 echo
259 eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:"
260 eerror
261 eerror " ${EPATCH_SOURCE}"
262 eerror " ( ${EPATCH_SOURCE##*/} )"
263 echo
264 die "Cannot find \$EPATCH_SOURCE!"
265 fi
266
267 local PIPE_CMD
268 case ${EPATCH_SUFFIX##*\.} in
269 xz) PIPE_CMD="xz -dc" ;;
270 lzma) PIPE_CMD="lzma -dc" ;;
271 bz2) PIPE_CMD="bzip2 -dc" ;;
272 gz|Z|z) PIPE_CMD="gzip -dc" ;;
273 ZIP|zip) PIPE_CMD="unzip -p" ;;
274 *) ;;
275 esac
276
277 [[ ${SINGLE_PATCH} == "no" ]] && einfo "${EPATCH_MULTI_MSG}"
278
279 local x
280 for x in "$@" ; do
281 # If the patch dir given contains subdirs, or our EPATCH_SUFFIX
282 # didn't match anything, ignore continue on
283 [[ ! -f ${x} ]] && continue
284
285 local patchname=${x##*/}
286
287 # Apply single patches, or forced sets of patches, or
288 # patches with ARCH dependant names.
289 # ???_arch_foo.patch
290 # Else, skip this input altogether
291 local a=${patchname#*_} # strip the ???_
292 a=${a%%_*} # strip the _foo.patch
293 if ! [[ ${SINGLE_PATCH} == "yes" || \
294 ${EPATCH_FORCE} == "yes" || \
295 ${a} == all || \
296 ${a} == ${ARCH} ]]
179 then 297 then
180 local EPATCH_SOURCE="$1/*" 298 continue
299 fi
300
301 # Let people filter things dynamically
302 if [[ -n ${EPATCH_EXCLUDE} ]] ; then
303 # let people use globs in the exclude
304 eshopts_push -o noglob
305
306 local ex
307 for ex in ${EPATCH_EXCLUDE} ; do
308 if [[ ${patchname} == ${ex} ]] ; then
309 eshopts_pop
310 continue 2
311 fi
312 done
313
314 eshopts_pop
315 fi
316
317 if [[ ${SINGLE_PATCH} == "yes" ]] ; then
318 if [[ -n ${EPATCH_SINGLE_MSG} ]] ; then
319 einfo "${EPATCH_SINGLE_MSG}"
320 else
321 einfo "Applying ${patchname} ..."
322 fi
181 else 323 else
182 local EPATCH_SOURCE="$1/*.${EPATCH_SUFFIX}" 324 einfo " ${patchname} ..."
183 fi 325 fi
184 else 326
185 if [ ! -d ${EPATCH_SOURCE} ] || [ -n "$1" ] 327 # most of the time, there will only be one run per unique name,
186 then 328 # but if there are more, make sure we get unique log filenames
187 if [ -n "$1" -a "${EPATCH_SOURCE}" = "${WORKDIR}/patch" ] 329 local STDERR_TARGET="${T}/${patchname}.out"
188 then 330 if [[ -e ${STDERR_TARGET} ]] ; then
189 EPATCH_SOURCE="$1" 331 STDERR_TARGET="${T}/${patchname}-$$.out"
332 fi
333
334 printf "***** %s *****\n\n" "${patchname}" > "${STDERR_TARGET}"
335
336 # Decompress the patch if need be
337 local count=0
338 local PATCH_TARGET
339 if [[ -n ${PIPE_CMD} ]] ; then
340 PATCH_TARGET="${T}/$$.patch"
341 echo "PIPE_COMMAND: ${PIPE_CMD} ${x} > ${PATCH_TARGET}" >> "${STDERR_TARGET}"
342
343 if ! (${PIPE_CMD} "${x}" > "${PATCH_TARGET}") >> "${STDERR_TARGET}" 2>&1 ; then
344 echo
345 eerror "Could not extract patch!"
346 #die "Could not extract patch!"
347 count=5
348 break
190 fi 349 fi
350 else
351 PATCH_TARGET=${x}
352 fi
191 353
354 # Check for absolute paths in patches. If sandbox is disabled,
355 # people could (accidently) patch files in the root filesystem.
356 # Or trigger other unpleasantries #237667. So disallow -p0 on
357 # such patches.
358 local abs_paths=$(egrep -n '^[-+]{3} /' "${PATCH_TARGET}" | awk '$2 != "/dev/null" { print }')
359 if [[ -n ${abs_paths} ]] ; then
360 count=1
361 printf "NOTE: skipping -p0 due to absolute paths in patch:\n%s\n" "${abs_paths}" >> "${STDERR_TARGET}"
362 fi
363 # Similar reason, but with relative paths.
364 local rel_paths=$(egrep -n '^[-+]{3} [^ ]*[.][.]/' "${PATCH_TARGET}")
365 if [[ -n ${rel_paths} ]] ; then
366 eqawarn "QA Notice: Your patch uses relative paths '../'."
367 eqawarn " In the future this will cause a failure."
368 eqawarn "${rel_paths}"
369 fi
370
371 # Dynamically detect the correct -p# ... i'm lazy, so shoot me :/
372 while [[ ${count} -lt 5 ]] ; do
373 # Generate some useful debug info ...
374 (
375 _epatch_draw_line "***** ${patchname} *****"
192 echo 376 echo
193 eerror "Cannot find \$EPATCH_SOURCE! Value for \$EPATCH_SOURCE is:" 377 echo "PATCH COMMAND: patch -p${count} ${EPATCH_OPTS} < '${PATCH_TARGET}'"
378 echo
379 _epatch_draw_line "***** ${patchname} *****"
380 ) >> "${STDERR_TARGET}"
381
382 if (patch -p${count} ${EPATCH_OPTS} --dry-run -f < "${PATCH_TARGET}") >> "${STDERR_TARGET}" 2>&1 ; then
383 (
384 _epatch_draw_line "***** ${patchname} *****"
385 echo
386 echo "ACTUALLY APPLYING ${patchname} ..."
387 echo
388 _epatch_draw_line "***** ${patchname} *****"
389 patch -p${count} ${EPATCH_OPTS} < "${PATCH_TARGET}" 2>&1
390 ) >> "${STDERR_TARGET}"
391
392 if [ $? -ne 0 ] ; then
393 echo
394 eerror "A dry-run of patch command succeeded, but actually"
395 eerror "applying the patch failed!"
396 #die "Real world sux compared to the dreamworld!"
397 count=5
398 fi
399 break
400 fi
401
402 : $(( count++ ))
403 done
404
405 # if we had to decompress the patch, delete the temp one
406 if [[ -n ${PIPE_CMD} ]] ; then
407 rm -f "${PATCH_TARGET}"
408 fi
409
410 if [[ ${count} -ge 5 ]] ; then
411 echo
412 eerror "Failed Patch: ${patchname} !"
413 eerror " ( ${PATCH_TARGET} )"
194 eerror 414 eerror
195 eerror " ${EPATCH_SOURCE}" 415 eerror "Include in your bugreport the contents of:"
196 eerror " ( ${EPATCH_SOURCE##*/} )" 416 eerror
417 eerror " ${STDERR_TARGET}"
197 echo 418 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}!" 419 die "Failed Patch: ${patchname}!"
342 fi 420 fi
343 421
344 rm -f ${STDERR_TARGET%/*}/${patchname}-${STDERR_TARGET##*/} 422 # if everything worked, delete the patch log
345 423 rm -f "${STDERR_TARGET}"
346 eend 0 424 eend 0
347 fi
348 done 425 done
349 if [ "${SINGLE_PATCH}" = "no" ] 426
350 then 427 [[ ${SINGLE_PATCH} == "no" ]] && einfo "Done with patching"
351 einfo "Done with patching" 428 : # everything worked
429}
430epatch_user() {
431 [[ $# -ne 0 ]] && die "epatch_user takes no options"
432
433 # don't clobber any EPATCH vars that the parent might want
434 local EPATCH_SOURCE check base=${PORTAGE_CONFIGROOT%/}/etc/portage/patches
435 for check in {${CATEGORY}/${PF},${CATEGORY}/${P},${CATEGORY}/${PN}}; do
436 EPATCH_SOURCE=${base}/${CTARGET}/${check}
437 [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${CHOST}/${check}
438 [[ -r ${EPATCH_SOURCE} ]] || EPATCH_SOURCE=${base}/${check}
439 if [[ -d ${EPATCH_SOURCE} ]] ; then
440 EPATCH_SOURCE=${EPATCH_SOURCE} \
441 EPATCH_SUFFIX="patch" \
442 EPATCH_FORCE="yes" \
443 EPATCH_MULTI_MSG="Applying user patches from ${EPATCH_SOURCE} ..." \
444 epatch
445 return 0
352 fi 446 fi
447 done
448 return 1
353} 449}
354 450
451# @FUNCTION: emktemp
452# @USAGE: [temp dir]
453# @DESCRIPTION:
355# Cheap replacement for when debianutils (and thus mktemp) 454# Cheap replacement for when debianutils (and thus mktemp)
356# does not exist on the users system 455# 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() { 456emktemp() {
361 local exe="touch" 457 local exe="touch"
362 [[ $1 == -d ]] && exe="mkdir" && shift 458 [[ $1 == -d ]] && exe="mkdir" && shift
363 local topdir=$1 459 local topdir=$1
364 460
366 [[ -z ${T} ]] \ 462 [[ -z ${T} ]] \
367 && topdir="/tmp" \ 463 && topdir="/tmp" \
368 || topdir=${T} 464 || topdir=${T}
369 fi 465 fi
370 466
371 if [[ -z $(type -p mktemp) ]] ; then 467 if ! type -P mktemp > /dev/null ; then
468 # system lacks `mktemp` so we have to fake it
372 local tmp=/ 469 local tmp=/
373 while [[ -e ${tmp} ]] ; do 470 while [[ -e ${tmp} ]] ; do
374 tmp=${topdir}/tmp.${RANDOM}.${RANDOM}.${RANDOM} 471 tmp=${topdir}/tmp.${RANDOM}.${RANDOM}.${RANDOM}
375 done 472 done
376 ${exe} "${tmp}" || ${exe} -p "${tmp}" 473 ${exe} "${tmp}" || ${exe} -p "${tmp}"
377 echo "${tmp}" 474 echo "${tmp}"
378 else 475 else
476 # the args here will give slightly wierd names on BSD,
477 # but should produce a usable file on all userlands
379 if [[ ${exe} == "touch" ]] ; then 478 if [[ ${exe} == "touch" ]] ; then
380 [[ ${USERLAND} == "GNU" ]] \
381 && mktemp -p "${topdir}" \
382 || TMPDIR="${topdir}" mktemp -t tmp 479 TMPDIR="${topdir}" mktemp -t tmp.XXXXXXXXXX
383 else 480 else
384 [[ ${USERLAND} == "GNU" ]] \
385 && mktemp -d "${topdir}" \
386 || TMPDIR="${topdir}" mktemp -dt tmp 481 TMPDIR="${topdir}" mktemp -dt tmp.XXXXXXXXXX
387 fi
388 fi 482 fi
483 fi
389} 484}
390 485
486# @FUNCTION: egetent
487# @USAGE: <database> <key>
488# @MAINTAINER:
489# base-system@gentoo.org (Linux)
490# Joe Jezak <josejx@gmail.com> (OS X)
491# usata@gentoo.org (OS X)
492# Aaron Walker <ka0ttic@gentoo.org> (FreeBSD)
493# @DESCRIPTION:
391# Small wrapper for getent (Linux), nidump (Mac OS X), 494# Small wrapper for getent (Linux),
495# nidump (< Mac OS X 10.5), dscl (Mac OS X 10.5),
392# and pw (FreeBSD) used in enewuser()/enewgroup() 496# 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() { 497egetent() {
398 case ${CHOST} in 498 case ${CHOST} in
399 *-darwin*) 499 *-darwin[678])
400 case "$2" in 500 case "$2" in
401 *[!0-9]*) # Non numeric 501 *[!0-9]*) # Non numeric
402 nidump $1 . | awk -F":" "{ if (\$1 ~ /^$2$/) {print \$0;exit;} }" 502 nidump $1 . | awk -F":" "{ if (\$1 ~ /^$2$/) {print \$0;exit;} }"
403 ;; 503 ;;
404 *) # Numeric 504 *) # Numeric
405 nidump $1 . | awk -F":" "{ if (\$3 == $2) {print \$0;exit;} }" 505 nidump $1 . | awk -F":" "{ if (\$3 == $2) {print \$0;exit;} }"
506 ;;
507 esac
508 ;;
509 *-darwin*)
510 local mytype=$1
511 [[ "passwd" == $mytype ]] && mytype="Users"
512 [[ "group" == $mytype ]] && mytype="Groups"
513 case "$2" in
514 *[!0-9]*) # Non numeric
515 dscl . -read /$mytype/$2 2>/dev/null |grep RecordName
516 ;;
517 *) # Numeric
518 local mykey="UniqueID"
519 [[ $mytype == "Groups" ]] && mykey="PrimaryGroupID"
520 dscl . -search /$mytype $mykey $2 2>/dev/null
406 ;; 521 ;;
407 esac 522 esac
408 ;; 523 ;;
409 *-freebsd*|*-dragonfly*) 524 *-freebsd*|*-dragonfly*)
410 local opts action="user" 525 local opts action="user"
425 getent "$1" "$2" 540 getent "$1" "$2"
426 ;; 541 ;;
427 esac 542 esac
428} 543}
429 544
430# Simplify/standardize adding users to the system 545# @FUNCTION: enewuser
431# vapier@gentoo.org 546# @USAGE: <user> [uid] [shell] [homedir] [groups] [params]
432# 547# @DESCRIPTION:
433# enewuser(username, uid, shell, homedir, groups, extra options) 548# Same as enewgroup, you are not required to understand how to properly add
434# 549# a user to the system. The only required parameter is the username.
435# Default values if you do not specify any: 550# Default uid is (pass -1 for this) next available, default shell is
436# username: REQUIRED ! 551# /bin/false, default homedir is /dev/null, there are no default groups,
437# uid: next available (see useradd(8)) 552# 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() { 553enewuser() {
444 case ${EBUILD_PHASE} in 554 case ${EBUILD_PHASE} in
445 unpack|compile|test|install) 555 unpack|compile|test|install)
446 eerror "'enewuser()' called from '${EBUILD_PHASE}()' which is not a pkg_* function." 556 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." 557 eerror "Package fails at QA and at life. Please file a bug."
615 fi 725 fi
616 ;; 726 ;;
617 727
618 *) 728 *)
619 if [[ -z $@ ]] ; then 729 if [[ -z $@ ]] ; then
620 useradd ${opts} ${euser} \ 730 useradd -r ${opts} \
621 -c "added by portage for ${PN}" \ 731 -c "added by portage for ${PN}" \
732 ${euser} \
622 || die "enewuser failed" 733 || die "enewuser failed"
623 else 734 else
624 einfo " - Extra: $@" 735 einfo " - Extra: $@"
625 useradd ${opts} ${euser} "$@" \ 736 useradd -r ${opts} "$@" \
737 ${euser} \
626 || die "enewuser failed" 738 || die "enewuser failed"
627 fi 739 fi
628 ;; 740 ;;
629 esac 741 esac
630 742
636 fi 748 fi
637 749
638 export SANDBOX_ON=${oldsandbox} 750 export SANDBOX_ON=${oldsandbox}
639} 751}
640 752
641# Simplify/standardize adding groups to the system 753# @FUNCTION: enewgroup
642# vapier@gentoo.org 754# @USAGE: <group> [gid]
643# 755# @DESCRIPTION:
644# enewgroup(group, gid) 756# This function does not require you to understand how to properly add a
645# 757# group to the system. Just give it a group name to add and enewgroup will
646# Default values if you do not specify any: 758# do the rest. You may specify the gid for the group or allow the group to
647# groupname: REQUIRED ! 759# allocate the next available one.
648# gid: next available (see groupadd(8))
649# extra: none
650enewgroup() { 760enewgroup() {
651 case ${EBUILD_PHASE} in 761 case ${EBUILD_PHASE} in
652 unpack|compile|test|install) 762 unpack|compile|test|install)
653 eerror "'enewgroup()' called from '${EBUILD_PHASE}()' which is not a pkg_* function." 763 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." 764 eerror "Package fails at QA and at life. Please file a bug."
744 esac 854 esac
745 groupadd -g ${egid} ${egroup} || die "enewgroup failed" 855 groupadd -g ${egid} ${egroup} || die "enewgroup failed"
746 ;; 856 ;;
747 857
748 *) 858 *)
859 # We specify -r so that we get a GID in the system range from login.defs
749 groupadd ${opts} ${egroup} || die "enewgroup failed" 860 groupadd -r ${opts} ${egroup} || die "enewgroup failed"
750 ;; 861 ;;
751 esac 862 esac
752 export SANDBOX_ON="${oldsandbox}" 863 export SANDBOX_ON="${oldsandbox}"
753} 864}
754 865
755# Simple script to replace 'dos2unix' binaries 866# @FUNCTION: edos2unix
756# vapier@gentoo.org 867# @USAGE: <file> [more files ...]
757# 868# @DESCRIPTION:
758# edos2unix(file, <more files> ...) 869# A handy replacement for dos2unix, recode, fixdos, etc... This allows you
870# to remove all of these text utilities from DEPEND variables because this
871# is a script based solution. Just give it a list of files to convert and
872# they will all be changed from the DOS CRLF format to the UNIX LF format.
759edos2unix() { 873edos2unix() {
760 echo "$@" | xargs sed -i 's/\r$//' 874 echo "$@" | xargs sed -i 's/\r$//'
761} 875}
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 876
770# Make a desktop file ! 877# Make a desktop file !
771# Great for making those icons in kde/gnome startmenu ! 878# Great for making those icons in kde/gnome startmenu !
772# Amaze your friends ! Get the women ! Join today ! 879# Amaze your friends ! Get the women ! Join today !
773# 880#
774# make_desktop_entry(<command>, [name], [icon], [type], [path]) 881# make_desktop_entry(<command>, [name], [icon], [type], [fields])
775# 882#
776# binary: what command does the app run with ? 883# binary: what command does the app run with ?
777# name: the name that will show up in the menu 884# name: the name that will show up in the menu
778# icon: give your little like a pretty little icon ... 885# icon: give your little like a pretty little icon ...
779# this can be relative (to /usr/share/pixmaps) or 886# this can be relative (to /usr/share/pixmaps) or
780# a full path to an icon 887# a full path to an icon
781# type: what kind of application is this ? for categories: 888# type: what kind of application is this ? for categories:
782# http://www.freedesktop.org/Standards/desktop-entry-spec 889# http://standards.freedesktop.org/menu-spec/latest/apa.html
783# path: if your app needs to startup in a specific dir 890# fields: extra fields to append to the desktop file; a printf string
784make_desktop_entry() { 891make_desktop_entry() {
785 [[ -z $1 ]] && eerror "make_desktop_entry: You must specify the executable" && return 1 892 [[ -z $1 ]] && die "make_desktop_entry: You must specify the executable"
786 893
787 local exec=${1} 894 local exec=${1}
788 local name=${2:-${PN}} 895 local name=${2:-${PN}}
789 local icon=${3:-${PN}.png} 896 local icon=${3:-${PN}}
790 local type=${4} 897 local type=${4}
791 local path=${5} 898 local fields=${5}
792 899
793 if [[ -z ${type} ]] ; then 900 if [[ -z ${type} ]] ; then
794 local catmaj=${CATEGORY%%-*} 901 local catmaj=${CATEGORY%%-*}
795 local catmin=${CATEGORY##*-} 902 local catmin=${CATEGORY##*-}
796 case ${catmaj} in 903 case ${catmaj} in
797 app) 904 app)
798 case ${catmin} in 905 case ${catmin} in
906 accessibility) type=Accessibility;;
799 admin) type=System;; 907 admin) type=System;;
908 antivirus) type=System;;
909 arch) type=Archiving;;
910 backup) type=Archiving;;
800 cdr) type=DiscBurning;; 911 cdr) type=DiscBurning;;
801 dicts) type=Dictionary;; 912 dicts) type=Dictionary;;
913 doc) type=Documentation;;
802 editors) type=TextEditor;; 914 editors) type=TextEditor;;
803 emacs) type=TextEditor;; 915 emacs) type=TextEditor;;
804 emulation) type=Emulator;; 916 emulation) type=Emulator;;
805 laptop) type=HardwareSettings;; 917 laptop) type=HardwareSettings;;
806 office) type=Office;; 918 office) type=Office;;
919 pda) type=PDA;;
807 vim) type=TextEditor;; 920 vim) type=TextEditor;;
808 xemacs) type=TextEditor;; 921 xemacs) type=TextEditor;;
809 *) type=;;
810 esac 922 esac
811 ;; 923 ;;
812 924
813 dev) 925 dev)
814 type="Development" 926 type="Development"
815 ;; 927 ;;
816 928
817 games) 929 games)
818 case ${catmin} in 930 case ${catmin} in
819 action|fps) type=ActionGame;; 931 action|fps) type=ActionGame;;
820 arcade) type=ArcadeGame;; 932 arcade) type=ArcadeGame;;
821 board) type=BoardGame;; 933 board) type=BoardGame;;
822 kids) type=KidsGame;;
823 emulation) type=Emulator;; 934 emulation) type=Emulator;;
935 kids) type=KidsGame;;
824 puzzle) type=LogicGame;; 936 puzzle) type=LogicGame;;
825 rpg) type=RolePlaying;;
826 roguelike) type=RolePlaying;; 937 roguelike) type=RolePlaying;;
938 rpg) type=RolePlaying;;
827 simulation) type=Simulation;; 939 simulation) type=Simulation;;
828 sports) type=SportsGame;; 940 sports) type=SportsGame;;
829 strategy) type=StrategyGame;; 941 strategy) type=StrategyGame;;
830 *) type=;;
831 esac 942 esac
832 type="Game;${type}" 943 type="Game;${type}"
833 ;; 944 ;;
834 945
946 gnome)
947 type="Gnome;GTK"
948 ;;
949
950 kde)
951 type="KDE;Qt"
952 ;;
953
835 mail) 954 mail)
836 type="Network;Email" 955 type="Network;Email"
837 ;; 956 ;;
838 957
839 media) 958 media)
840 case ${catmin} in 959 case ${catmin} in
960 gfx)
841 gfx) type=Graphics;; 961 type=Graphics
962 ;;
963 *)
964 case ${catmin} in
842 radio) type=Tuner;; 965 radio) type=Tuner;;
843 sound) type=Audio;; 966 sound) type=Audio;;
844 tv) type=TV;; 967 tv) type=TV;;
845 video) type=Video;; 968 video) type=Video;;
846 *) type=;; 969 esac
970 type="AudioVideo;${type}"
971 ;;
847 esac 972 esac
848 type="AudioVideo;${type}"
849 ;; 973 ;;
850 974
851 net) 975 net)
852 case ${catmin} in 976 case ${catmin} in
853 dialup) type=Dialup;; 977 dialup) type=Dialup;;
854 ftp) type=FileTransfer;; 978 ftp) type=FileTransfer;;
855 im) type=InstantMessaging;; 979 im) type=InstantMessaging;;
856 irc) type=IRCClient;; 980 irc) type=IRCClient;;
857 mail) type=Email;; 981 mail) type=Email;;
858 news) type=News;; 982 news) type=News;;
859 nntp) type=News;; 983 nntp) type=News;;
860 p2p) type=FileTransfer;; 984 p2p) type=FileTransfer;;
861 *) type=;; 985 voip) type=Telephony;;
862 esac 986 esac
863 type="Network;${type}" 987 type="Network;${type}"
864 ;; 988 ;;
865 989
866 sci) 990 sci)
867 case ${catmin} in 991 case ${catmin} in
868 astro*) type=Astronomy;; 992 astro*) type=Astronomy;;
869 bio*) type=Biology;; 993 bio*) type=Biology;;
870 calc*) type=Calculator;; 994 calc*) type=Calculator;;
871 chem*) type=Chemistry;; 995 chem*) type=Chemistry;;
996 elec*) type=Electronics;;
872 geo*) type=Geology;; 997 geo*) type=Geology;;
873 math*) type=Math;; 998 math*) type=Math;;
874 *) type=;; 999 physics) type=Physics;;
1000 visual*) type=DataVisualization;;
875 esac 1001 esac
876 type="Science;${type}" 1002 type="Education;Science;${type}"
1003 ;;
1004
1005 sys)
1006 type="System"
877 ;; 1007 ;;
878 1008
879 www) 1009 www)
880 case ${catmin} in 1010 case ${catmin} in
881 client) type=WebBrowser;; 1011 client) type=WebBrowser;;
882 *) type=;;
883 esac 1012 esac
884 type="Network" 1013 type="Network;${type}"
885 ;; 1014 ;;
886 1015
887 *) 1016 *)
888 type= 1017 type=
889 ;; 1018 ;;
895 local desktop_name="${PN}-${SLOT}" 1024 local desktop_name="${PN}-${SLOT}"
896 fi 1025 fi
897 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop" 1026 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop"
898 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop 1027 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop
899 1028
1029 # Don't append another ";" when a valid category value is provided.
1030 type=${type%;}${type:+;}
1031
1032 eshopts_push -s extglob
1033 if [[ -n ${icon} && ${icon} != /* ]] && [[ ${icon} == *.xpm || ${icon} == *.png || ${icon} == *.svg ]]; then
1034 ewarn "As described in the Icon Theme Specification, icon file extensions are not"
1035 ewarn "allowed in .desktop files if the value is not an absolute path."
1036 icon=${icon%.@(xpm|png|svg)}
1037 fi
1038 eshopts_pop
1039
900 cat <<-EOF > "${desktop}" 1040 cat <<-EOF > "${desktop}"
901 [Desktop Entry] 1041 [Desktop Entry]
902 Encoding=UTF-8
903 Version=0.9.2
904 Name=${name} 1042 Name=${name}
905 Type=Application 1043 Type=Application
906 Comment=${DESCRIPTION} 1044 Comment=${DESCRIPTION}
907 Exec=${exec} 1045 Exec=${exec}
908 TryExec=${exec%% *} 1046 TryExec=${exec%% *}
909 Path=${path}
910 Icon=${icon} 1047 Icon=${icon}
911 Categories=Application;${type}; 1048 Categories=${type}
912 EOF 1049 EOF
1050
1051 if [[ ${fields:-=} != *=* ]] ; then
1052 # 5th arg used to be value to Path=
1053 ewarn "make_desktop_entry: update your 5th arg to read Path=${fields}"
1054 fields="Path=${fields}"
1055 fi
1056 [[ -n ${fields} ]] && printf '%b\n' "${fields}" >> "${desktop}"
913 1057
914 ( 1058 (
915 # wrap the env here so that the 'insinto' call 1059 # wrap the env here so that the 'insinto' call
916 # doesn't corrupt the env of the caller 1060 # doesn't corrupt the env of the caller
917 insinto /usr/share/applications 1061 insinto /usr/share/applications
918 doins "${desktop}" 1062 doins "${desktop}"
919 ) 1063 ) || die "installing desktop file failed"
920} 1064}
921 1065
922 1066# @FUNCTION: validate_desktop_entries
1067# @USAGE: [directories]
1068# @MAINTAINER:
1069# Carsten Lohrke <carlo@gentoo.org>
1070# @DESCRIPTION:
923# Validate desktop entries using desktop-file-utils 1071# Validate desktop entries using desktop-file-utils
924# Carsten Lohrke <carlo@gentoo.org>
925#
926# Usage: validate_desktop_entries [directory ...]
927
928validate_desktop_entries() { 1072validate_desktop_entries() {
929 if [[ -x /usr/bin/desktop-file-validate ]] ; then 1073 if [[ -x /usr/bin/desktop-file-validate ]] ; then
930 einfo "Checking desktop entry validity" 1074 einfo "Checking desktop entry validity"
931 local directories="" 1075 local directories=""
932 for d in /usr/share/applications $@ ; do 1076 for d in /usr/share/applications $@ ; do
945 else 1089 else
946 einfo "Passing desktop entry validity check. Install dev-util/desktop-file-utils, if you want to help to improve Gentoo." 1090 einfo "Passing desktop entry validity check. Install dev-util/desktop-file-utils, if you want to help to improve Gentoo."
947 fi 1091 fi
948} 1092}
949 1093
950 1094# @FUNCTION: make_session_desktop
951# Make a GDM/KDM Session file 1095# @USAGE: <title> <command> [command args...]
1096# @DESCRIPTION:
1097# Make a GDM/KDM Session file. The title is the file to execute to start the
1098# Window Manager. The command is the name of the Window Manager.
952# 1099#
953# make_session_desktop(<title>, <command>) 1100# You can set the name of the file via the ${wm} variable.
954# title: File to execute to start the Window Manager
955# command: Name of the Window Manager
956
957make_session_desktop() { 1101make_session_desktop() {
958 [[ -z $1 ]] && eerror "make_session_desktop: You must specify the title" && return 1 1102 [[ -z $1 ]] && eerror "$0: You must specify the title" && return 1
959 [[ -z $2 ]] && eerror "make_session_desktop: You must specify the command" && return 1 1103 [[ -z $2 ]] && eerror "$0: You must specify the command" && return 1
960 1104
961 local title=$1 1105 local title=$1
962 local command=$2 1106 local command=$2
963 local desktop=${T}/${wm}.desktop 1107 local desktop=${T}/${wm:-${PN}}.desktop
1108 shift 2
964 1109
965 cat <<-EOF > "${desktop}" 1110 cat <<-EOF > "${desktop}"
966 [Desktop Entry] 1111 [Desktop Entry]
967 Encoding=UTF-8
968 Name=${title} 1112 Name=${title}
969 Comment=This session logs you into ${title} 1113 Comment=This session logs you into ${title}
970 Exec=${command} 1114 Exec=${command} $*
971 TryExec=${command} 1115 TryExec=${command}
972 Type=Application 1116 Type=XSession
973 EOF 1117 EOF
974 1118
975 ( 1119 (
976 # wrap the env here so that the 'insinto' call 1120 # wrap the env here so that the 'insinto' call
977 # doesn't corrupt the env of the caller 1121 # doesn't corrupt the env of the caller
978 insinto /usr/share/xsessions 1122 insinto /usr/share/xsessions
979 doins "${desktop}" 1123 doins "${desktop}"
980 ) 1124 )
981} 1125}
982 1126
1127# @FUNCTION: domenu
1128# @USAGE: <menus>
1129# @DESCRIPTION:
1130# Install the list of .desktop menu files into the appropriate directory
1131# (/usr/share/applications).
983domenu() { 1132domenu() {
984 ( 1133 (
985 # wrap the env here so that the 'insinto' call 1134 # wrap the env here so that the 'insinto' call
986 # doesn't corrupt the env of the caller 1135 # doesn't corrupt the env of the caller
987 local i j ret=0 1136 local i j ret=0
993 elif [[ -d ${i} ]] ; then 1142 elif [[ -d ${i} ]] ; then
994 for j in "${i}"/*.desktop ; do 1143 for j in "${i}"/*.desktop ; do
995 doins "${j}" 1144 doins "${j}"
996 ((ret+=$?)) 1145 ((ret+=$?))
997 done 1146 done
1147 else
1148 ((++ret))
998 fi 1149 fi
999 done 1150 done
1000 exit ${ret} 1151 exit ${ret}
1001 ) 1152 )
1002} 1153}
1154
1155# @FUNCTION: newmenu
1156# @USAGE: <menu> <newname>
1157# @DESCRIPTION:
1158# Like all other new* functions, install the specified menu as newname.
1003newmenu() { 1159newmenu() {
1004 ( 1160 (
1005 # wrap the env here so that the 'insinto' call 1161 # wrap the env here so that the 'insinto' call
1006 # doesn't corrupt the env of the caller 1162 # doesn't corrupt the env of the caller
1007 insinto /usr/share/applications 1163 insinto /usr/share/applications
1008 newins "$@" 1164 newins "$@"
1009 ) 1165 )
1010} 1166}
1011 1167
1168# @FUNCTION: doicon
1169# @USAGE: <list of icons>
1170# @DESCRIPTION:
1171# Install the list of icons into the icon directory (/usr/share/pixmaps).
1172# This is useful in conjunction with creating desktop/menu files.
1012doicon() { 1173doicon() {
1013 ( 1174 (
1014 # wrap the env here so that the 'insinto' call 1175 # wrap the env here so that the 'insinto' call
1015 # doesn't corrupt the env of the caller 1176 # doesn't corrupt the env of the caller
1016 local i j ret 1177 local i j ret
1022 elif [[ -d ${i} ]] ; then 1183 elif [[ -d ${i} ]] ; then
1023 for j in "${i}"/*.png ; do 1184 for j in "${i}"/*.png ; do
1024 doins "${j}" 1185 doins "${j}"
1025 ((ret+=$?)) 1186 ((ret+=$?))
1026 done 1187 done
1188 else
1189 ((++ret))
1027 fi 1190 fi
1028 done 1191 done
1029 exit ${ret} 1192 exit ${ret}
1030 ) 1193 )
1031} 1194}
1195
1196# @FUNCTION: newicon
1197# @USAGE: <icon> <newname>
1198# @DESCRIPTION:
1199# Like all other new* functions, install the specified icon as newname.
1032newicon() { 1200newicon() {
1033 ( 1201 (
1034 # wrap the env here so that the 'insinto' call 1202 # wrap the env here so that the 'insinto' call
1035 # doesn't corrupt the env of the caller 1203 # doesn't corrupt the env of the caller
1036 insinto /usr/share/pixmaps 1204 insinto /usr/share/pixmaps
1037 newins "$@" 1205 newins "$@"
1038 ) 1206 )
1039} 1207}
1040
1041##############################################################
1042# END: Handle .desktop files and menu entries #
1043##############################################################
1044
1045 1208
1046# for internal use only (unpack_pdv and unpack_makeself) 1209# for internal use only (unpack_pdv and unpack_makeself)
1047find_unpackable_file() { 1210find_unpackable_file() {
1048 local src=$1 1211 local src=$1
1049 if [[ -z ${src} ]] ; then 1212 if [[ -z ${src} ]] ; then
1059 fi 1222 fi
1060 [[ ! -e ${src} ]] && return 1 1223 [[ ! -e ${src} ]] && return 1
1061 echo "${src}" 1224 echo "${src}"
1062} 1225}
1063 1226
1227# @FUNCTION: unpack_pdv
1228# @USAGE: <file to unpack> <size of off_t>
1229# @DESCRIPTION:
1064# Unpack those pesky pdv generated files ... 1230# Unpack those pesky pdv generated files ...
1065# They're self-unpacking programs with the binary package stuffed in 1231# They're self-unpacking programs with the binary package stuffed in
1066# the middle of the archive. Valve seems to use it a lot ... too bad 1232# the middle of the archive. Valve seems to use it a lot ... too bad
1067# it seems to like to segfault a lot :(. So lets take it apart ourselves. 1233# it seems to like to segfault a lot :(. So lets take it apart ourselves.
1068# 1234#
1069# Usage: unpack_pdv [file to unpack] [size of off_t]
1070# - you have to specify the off_t size ... i have no idea how to extract that 1235# You have to specify the off_t size ... I have no idea how to extract that
1071# information out of the binary executable myself. basically you pass in 1236# information out of the binary executable myself. Basically you pass in
1072# the size of the off_t type (in bytes) on the machine that built the pdv 1237# the size of the off_t type (in bytes) on the machine that built the pdv
1238# archive.
1239#
1073# archive. one way to determine this is by running the following commands: 1240# One way to determine this is by running the following commands:
1241#
1242# @CODE
1074# strings <pdv archive> | grep lseek 1243# strings <pdv archive> | grep lseek
1075# strace -elseek <pdv archive> 1244# strace -elseek <pdv archive>
1245# @CODE
1246#
1076# basically look for the first lseek command (we do the strings/grep because 1247# Basically look for the first lseek command (we do the strings/grep because
1077# sometimes the function call is _llseek or something) and steal the 2nd 1248# sometimes the function call is _llseek or something) and steal the 2nd
1078# parameter. here is an example: 1249# parameter. Here is an example:
1250#
1251# @CODE
1079# root@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek 1252# vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek
1080# lseek 1253# lseek
1081# root@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin 1254# vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin
1082# lseek(3, -4, SEEK_END) = 2981250 1255# lseek(3, -4, SEEK_END) = 2981250
1256# @CODE
1257#
1083# thus we would pass in the value of '4' as the second parameter. 1258# Thus we would pass in the value of '4' as the second parameter.
1084unpack_pdv() { 1259unpack_pdv() {
1085 local src=$(find_unpackable_file "$1") 1260 local src=$(find_unpackable_file "$1")
1086 local sizeoff_t=$2 1261 local sizeoff_t=$2
1087 1262
1088 [[ -z ${src} ]] && die "Could not locate source for '$1'" 1263 [[ -z ${src} ]] && die "Could not locate source for '$1'"
1150 true 1325 true
1151 #[ -s "${datafile}" ] || die "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')" 1326 #[ -s "${datafile}" ] || die "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')"
1152 #assert "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')" 1327 #assert "failure unpacking pdv ('${metaskip}' '${tailskip}' '${datafile}')"
1153} 1328}
1154 1329
1330# @FUNCTION: unpack_makeself
1331# @USAGE: [file to unpack] [offset] [tail|dd]
1332# @DESCRIPTION:
1155# Unpack those pesky makeself generated files ... 1333# Unpack those pesky makeself generated files ...
1156# They're shell scripts with the binary package tagged onto 1334# They're shell scripts with the binary package tagged onto
1157# the end of the archive. Loki utilized the format as does 1335# the end of the archive. Loki utilized the format as does
1158# many other game companies. 1336# many other game companies.
1159# 1337#
1160# Usage: unpack_makeself [file to unpack] [offset] [tail|dd] 1338# If the file is not specified, then ${A} is used. If the
1161# - If the file is not specified then unpack will utilize ${A}.
1162# - If the offset is not specified then we will attempt to extract 1339# offset is not specified then we will attempt to extract
1163# the proper offset from the script itself. 1340# the proper offset from the script itself.
1164unpack_makeself() { 1341unpack_makeself() {
1165 local src_input=${1:-${A}} 1342 local src_input=${1:-${A}}
1166 local src=$(find_unpackable_file "${src_input}") 1343 local src=$(find_unpackable_file "${src_input}")
1167 local skip=$2 1344 local skip=$2
1168 local exe=$3 1345 local exe=$3
1170 [[ -z ${src} ]] && die "Could not locate source for '${src_input}'" 1347 [[ -z ${src} ]] && die "Could not locate source for '${src_input}'"
1171 1348
1172 local shrtsrc=$(basename "${src}") 1349 local shrtsrc=$(basename "${src}")
1173 echo ">>> Unpacking ${shrtsrc} to ${PWD}" 1350 echo ">>> Unpacking ${shrtsrc} to ${PWD}"
1174 if [[ -z ${skip} ]] ; then 1351 if [[ -z ${skip} ]] ; then
1175 local ver=$(grep -a '#.*Makeself' "${src}" | awk '{print $NF}') 1352 local ver=$(grep -m1 -a '#.*Makeself' "${src}" | awk '{print $NF}')
1176 local skip=0 1353 local skip=0
1177 exe=tail 1354 exe=tail
1178 case ${ver} in 1355 case ${ver} in
1179 1.5.*|1.6.0-nv) # tested 1.5.{3,4,5} ... guessing 1.5.x series is same 1356 1.5.*|1.6.0-nv) # tested 1.5.{3,4,5} ... guessing 1.5.x series is same
1180 skip=$(grep -a ^skip= "${src}" | cut -d= -f2) 1357 skip=$(grep -a ^skip= "${src}" | cut -d= -f2)
1182 2.0|2.0.1) 1359 2.0|2.0.1)
1183 skip=$(grep -a ^$'\t'tail "${src}" | awk '{print $2}' | cut -b2-) 1360 skip=$(grep -a ^$'\t'tail "${src}" | awk '{print $2}' | cut -b2-)
1184 ;; 1361 ;;
1185 2.1.1) 1362 2.1.1)
1186 skip=$(grep -a ^offset= "${src}" | awk '{print $2}' | cut -b2-) 1363 skip=$(grep -a ^offset= "${src}" | awk '{print $2}' | cut -b2-)
1187 let skip="skip + 1" 1364 (( skip++ ))
1188 ;; 1365 ;;
1189 2.1.2) 1366 2.1.2)
1190 skip=$(grep -a ^offset= "${src}" | awk '{print $3}' | head -n 1) 1367 skip=$(grep -a ^offset= "${src}" | awk '{print $3}' | head -n 1)
1191 let skip="skip + 1" 1368 (( skip++ ))
1192 ;; 1369 ;;
1193 2.1.3) 1370 2.1.3)
1194 skip=`grep -a ^offset= "${src}" | awk '{print $3}'` 1371 skip=`grep -a ^offset= "${src}" | awk '{print $3}'`
1195 let skip="skip + 1" 1372 (( skip++ ))
1196 ;; 1373 ;;
1197 2.1.4|2.1.5) 1374 2.1.4|2.1.5)
1198 skip=$(grep -a offset=.*head.*wc "${src}" | awk '{print $3}' | head -n 1) 1375 skip=$(grep -a offset=.*head.*wc "${src}" | awk '{print $3}' | head -n 1)
1199 skip=$(head -n ${skip} "${src}" | wc -c) 1376 skip=$(head -n ${skip} "${src}" | wc -c)
1200 exe="dd" 1377 exe="dd"
1209 esac 1386 esac
1210 debug-print "Detected Makeself version ${ver} ... using ${skip} as offset" 1387 debug-print "Detected Makeself version ${ver} ... using ${skip} as offset"
1211 fi 1388 fi
1212 case ${exe} in 1389 case ${exe} in
1213 tail) exe="tail -n +${skip} '${src}'";; 1390 tail) exe="tail -n +${skip} '${src}'";;
1214 dd) exe="dd ibs=${skip} skip=1 obs=1024 conv=sync if='${src}'";; 1391 dd) exe="dd ibs=${skip} skip=1 if='${src}'";;
1215 *) die "makeself cant handle exe '${exe}'" 1392 *) die "makeself cant handle exe '${exe}'"
1216 esac 1393 esac
1217 1394
1218 # lets grab the first few bytes of the file to figure out what kind of archive it is 1395 # lets grab the first few bytes of the file to figure out what kind of archive it is
1219 local tmpfile=$(emktemp) 1396 local filetype tmpfile=$(emktemp)
1220 eval ${exe} 2>/dev/null | head -c 512 > "${tmpfile}" 1397 eval ${exe} 2>/dev/null | head -c 512 > "${tmpfile}"
1221 local filetype=$(file -b "${tmpfile}") 1398 filetype=$(file -b "${tmpfile}") || die
1222 case ${filetype} in 1399 case ${filetype} in
1223 *tar\ archive*) 1400 *tar\ archive*)
1224 eval ${exe} | tar --no-same-owner -xf - 1401 eval ${exe} | tar --no-same-owner -xf -
1225 ;; 1402 ;;
1226 bzip2*) 1403 bzip2*)
1238 ;; 1415 ;;
1239 esac 1416 esac
1240 assert "failure unpacking (${filetype}) makeself ${shrtsrc} ('${ver}' +${skip})" 1417 assert "failure unpacking (${filetype}) makeself ${shrtsrc} ('${ver}' +${skip})"
1241} 1418}
1242 1419
1420# @FUNCTION: check_license
1421# @USAGE: [license]
1422# @DESCRIPTION:
1243# Display a license for user to accept. 1423# Display a license for user to accept. If no license is
1244#
1245# Usage: check_license [license]
1246# - If the file is not specified then ${LICENSE} is used. 1424# specified, then ${LICENSE} is used.
1247check_license() { 1425check_license() {
1248 local lic=$1 1426 local lic=$1
1249 if [ -z "${lic}" ] ; then 1427 if [ -z "${lic}" ] ; then
1250 lic="${PORTDIR}/licenses/${LICENSE}" 1428 lic="${PORTDIR}/licenses/${LICENSE}"
1251 else 1429 else
1255 lic="${PWD}/${lic}" 1433 lic="${PWD}/${lic}"
1256 elif [ -e "${lic}" ] ; then 1434 elif [ -e "${lic}" ] ; then
1257 lic="${lic}" 1435 lic="${lic}"
1258 fi 1436 fi
1259 fi 1437 fi
1260 [ ! -f "${lic}" ] && die "Could not find requested license ${lic}"
1261 local l="`basename ${lic}`" 1438 local l="`basename ${lic}`"
1262 1439
1263 # here is where we check for the licenses the user already 1440 # here is where we check for the licenses the user already
1264 # accepted ... if we don't find a match, we make the user accept 1441 # accepted ... if we don't find a match, we make the user accept
1265 local shopts=$-
1266 local alic 1442 local alic
1267 set -o noglob #so that bash doesn't expand "*" 1443 eshopts_push -o noglob # so that bash doesn't expand "*"
1268 for alic in ${ACCEPT_LICENSE} ; do 1444 for alic in ${ACCEPT_LICENSE} ; do
1269 if [[ ${alic} == ${l} ]]; then 1445 if [[ ${alic} == ${l} ]]; then
1270 set +o noglob; set -${shopts} #reset old shell opts 1446 eshopts_pop
1271 return 0 1447 return 0
1272 fi 1448 fi
1273 done 1449 done
1274 set +o noglob; set -$shopts #reset old shell opts 1450 eshopts_pop
1451 [ ! -f "${lic}" ] && die "Could not find requested license ${lic}"
1275 1452
1276 local licmsg=$(emktemp) 1453 local licmsg=$(emktemp)
1277 cat <<-EOF > ${licmsg} 1454 cat <<-EOF > ${licmsg}
1278 ********************************************************** 1455 **********************************************************
1279 The following license outlines the terms of use of this 1456 The following license outlines the terms of use of this
1280 package. You MUST accept this license for installation to 1457 package. You MUST accept this license for installation to
1281 continue. When you are done viewing, hit 'q'. If you 1458 continue. When you are done viewing, hit 'q'. If you
1282 CTRL+C out of this, the install will not run! 1459 CTRL+C out of this, the install will not run!
1283 ********************************************************** 1460 **********************************************************
1284 1461
1285 EOF 1462 EOF
1286 cat ${lic} >> ${licmsg} 1463 cat ${lic} >> ${licmsg}
1287 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}" 1464 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}"
1288 einfon "Do you accept the terms of this license (${l})? [yes/no] " 1465 einfon "Do you accept the terms of this license (${l})? [yes/no] "
1289 read alic 1466 read alic
1297 die "Failed to accept license" 1474 die "Failed to accept license"
1298 ;; 1475 ;;
1299 esac 1476 esac
1300} 1477}
1301 1478
1479# @FUNCTION: cdrom_get_cds
1480# @USAGE: <file on cd1> [file on cd2] [file on cd3] [...]
1481# @DESCRIPTION:
1302# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates 1482# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates
1303# the whole 'non-interactive' policy, but damnit I want CD support ! 1483# the whole 'non-interactive' policy, but damnit I want CD support !
1304# 1484#
1305# with these cdrom functions we handle all the user interaction and 1485# With these cdrom functions we handle all the user interaction and
1306# standardize everything. all you have to do is call cdrom_get_cds() 1486# standardize everything. All you have to do is call cdrom_get_cds()
1307# and when the function returns, you can assume that the cd has been 1487# and when the function returns, you can assume that the cd has been
1308# found at CDROM_ROOT. 1488# found at CDROM_ROOT.
1309# 1489#
1490# The function will attempt to locate a cd based upon a file that is on
1491# the cd. The more files you give this function, the more cds
1492# the cdrom functions will handle.
1493#
1310# normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2', 1494# Normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2',
1311# etc... if you want to give the cds better names, then just export 1495# etc... If you want to give the cds better names, then just export
1312# the appropriate CDROM_NAME variable before calling cdrom_get_cds(). 1496# the appropriate CDROM_NAME variable before calling cdrom_get_cds().
1313# - CDROM_NAME="fooie cd" - for when you only want 1 cd 1497# Use CDROM_NAME for one cd, or CDROM_NAME_# for multiple cds. You can
1314# - CDROM_NAME_1="install cd" - for when you want more than 1 cd 1498# also use the CDROM_NAME_SET bash array.
1315# CDROM_NAME_2="data cd"
1316# - CDROM_NAME_SET=( "install cd" "data cd" ) - short hand for CDROM_NAME_#
1317# 1499#
1318# for those multi cd ebuilds, see the cdrom_load_next_cd() below. 1500# For those multi cd ebuilds, see the cdrom_load_next_cd() function.
1319#
1320# Usage: cdrom_get_cds <file on cd1> [file on cd2] [file on cd3] [...]
1321# - this will attempt to locate a cd based upon a file that is on
1322# the cd ... the more files you give this function, the more cds
1323# the cdrom functions will handle
1324cdrom_get_cds() { 1501cdrom_get_cds() {
1325 # first we figure out how many cds we're dealing with by 1502 # first we figure out how many cds we're dealing with by
1326 # the # of files they gave us 1503 # the # of files they gave us
1327 local cdcnt=0 1504 local cdcnt=0
1328 local f= 1505 local f=
1352 export CDROM_ROOT=${CD_ROOT_1:-${CD_ROOT}} 1529 export CDROM_ROOT=${CD_ROOT_1:-${CD_ROOT}}
1353 einfo "Found CD #${CDROM_CURRENT_CD} root at ${CDROM_ROOT}" 1530 einfo "Found CD #${CDROM_CURRENT_CD} root at ${CDROM_ROOT}"
1354 export CDROM_SET=-1 1531 export CDROM_SET=-1
1355 for f in ${CDROM_CHECK_1//:/ } ; do 1532 for f in ${CDROM_CHECK_1//:/ } ; do
1356 ((++CDROM_SET)) 1533 ((++CDROM_SET))
1357 [[ -e ${CD_ROOT}/${f} ]] && break 1534 [[ -e ${CDROM_ROOT}/${f} ]] && break
1358 done 1535 done
1359 export CDROM_MATCH=${f} 1536 export CDROM_MATCH=${f}
1360 return 1537 return
1361 fi 1538 fi
1362 1539
1414 export CDROM_SET="" 1591 export CDROM_SET=""
1415 export CDROM_CURRENT_CD=0 1592 export CDROM_CURRENT_CD=0
1416 cdrom_load_next_cd 1593 cdrom_load_next_cd
1417} 1594}
1418 1595
1419# this is only used when you need access to more than one cd. 1596# @FUNCTION: cdrom_load_next_cd
1420# when you have finished using the first cd, just call this function. 1597# @DESCRIPTION:
1421# when it returns, CDROM_ROOT will be pointing to the second cd. 1598# Some packages are so big they come on multiple CDs. When you're done reading
1422# remember, you can only go forward in the cd chain, you can't go back. 1599# files off a CD and want access to the next one, just call this function.
1600# Again, all the messy details of user interaction are taken care of for you.
1601# Once this returns, just read the variable CDROM_ROOT for the location of the
1602# mounted CD. Note that you can only go forward in the CD list, so make sure
1603# you only call this function when you're done using the current CD.
1423cdrom_load_next_cd() { 1604cdrom_load_next_cd() {
1424 local var 1605 local var
1425 ((++CDROM_CURRENT_CD)) 1606 ((++CDROM_CURRENT_CD))
1426 1607
1427 unset CDROM_ROOT 1608 unset CDROM_ROOT
1444# displayed and we'll hang out here until: 1625# displayed and we'll hang out here until:
1445# (1) the file is found on a mounted cdrom 1626# (1) the file is found on a mounted cdrom
1446# (2) the user hits CTRL+C 1627# (2) the user hits CTRL+C
1447_cdrom_locate_file_on_cd() { 1628_cdrom_locate_file_on_cd() {
1448 local mline="" 1629 local mline=""
1449 local showedmsg=0 1630 local showedmsg=0 showjolietmsg=0
1450 1631
1451 while [[ -z ${CDROM_ROOT} ]] ; do 1632 while [[ -z ${CDROM_ROOT} ]] ; do
1452 local i=0 1633 local i=0
1453 local -a cdset=(${*//:/ }) 1634 local -a cdset=(${*//:/ })
1454 if [[ -n ${CDROM_SET} ]] ; then 1635 if [[ -n ${CDROM_SET} ]] ; then
1459 local dir=$(dirname ${cdset[${i}]}) 1640 local dir=$(dirname ${cdset[${i}]})
1460 local file=$(basename ${cdset[${i}]}) 1641 local file=$(basename ${cdset[${i}]})
1461 1642
1462 local point= node= fs= foo= 1643 local point= node= fs= foo=
1463 while read point node fs foo ; do 1644 while read point node fs foo ; do
1464 [[ " cd9660 iso9660 " != *" ${fs} "* ]] && \ 1645 [[ " cd9660 iso9660 udf " != *" ${fs} "* ]] && \
1465 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \ 1646 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \
1466 && continue 1647 && continue
1467 point=${point//\040/ } 1648 point=${point//\040/ }
1649 [[ ! -d ${point}/${dir} ]] && continue
1468 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue 1650 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue
1469 export CDROM_ROOT=${point} 1651 export CDROM_ROOT=${point}
1470 export CDROM_SET=${i} 1652 export CDROM_SET=${i}
1471 export CDROM_MATCH=${cdset[${i}]} 1653 export CDROM_MATCH=${cdset[${i}]}
1472 return 1654 return
1494 showedmsg=1 1676 showedmsg=1
1495 fi 1677 fi
1496 einfo "Press return to scan for the cd again" 1678 einfo "Press return to scan for the cd again"
1497 einfo "or hit CTRL+C to abort the emerge." 1679 einfo "or hit CTRL+C to abort the emerge."
1498 echo 1680 echo
1681 if [[ ${showjolietmsg} -eq 0 ]] ; then
1682 showjolietmsg=1
1683 else
1499 einfo "If you are having trouble with the detection" 1684 ewarn "If you are having trouble with the detection"
1500 einfo "of your CD, it is possible that you do not have" 1685 ewarn "of your CD, it is possible that you do not have"
1501 einfo "Joliet support enabled in your kernel. Please" 1686 ewarn "Joliet support enabled in your kernel. Please"
1502 einfo "check that CONFIG_JOLIET is enabled in your kernel." 1687 ewarn "check that CONFIG_JOLIET is enabled in your kernel."
1688 ebeep 5
1689 fi
1503 read || die "something is screwed with your system" 1690 read || die "something is screwed with your system"
1504 done 1691 done
1505} 1692}
1506 1693
1694# @FUNCTION: strip-linguas
1695# @USAGE: [<allow LINGUAS>|<-i|-u> <directories of .po files>]
1696# @DESCRIPTION:
1507# Make sure that LINGUAS only contains languages that 1697# Make sure that LINGUAS only contains languages that
1508# a package can support 1698# a package can support. The first form allows you to
1509# 1699# specify a list of LINGUAS. The -i builds a list of po
1510# usage: strip-linguas <allow LINGUAS> 1700# files found in all the directories and uses the
1511# strip-linguas -i <directories of .po files> 1701# intersection of the lists. The -u builds a list of po
1512# strip-linguas -u <directories of .po files> 1702# files found in all the directories and uses the union
1513# 1703# of the lists.
1514# The first form allows you to specify a list of LINGUAS.
1515# The -i builds a list of po files found in all the
1516# directories and uses the intersection of the lists.
1517# The -u builds a list of po files found in all the
1518# directories and uses the union of the lists.
1519strip-linguas() { 1704strip-linguas() {
1520 local ls newls nols 1705 local ls newls nols
1521 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then 1706 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then
1522 local op=$1; shift 1707 local op=$1; shift
1523 ls=$(find "$1" -name '*.po' -exec basename {} .po \;); shift 1708 ls=$(find "$1" -name '*.po' -exec basename {} .po ';'); shift
1524 local d f 1709 local d f
1525 for d in "$@" ; do 1710 for d in "$@" ; do
1526 if [[ ${op} == "-u" ]] ; then 1711 if [[ ${op} == "-u" ]] ; then
1527 newls=${ls} 1712 newls=${ls}
1528 else 1713 else
1529 newls="" 1714 newls=""
1530 fi 1715 fi
1531 for f in $(find "$d" -name '*.po' -exec basename {} .po \;) ; do 1716 for f in $(find "$d" -name '*.po' -exec basename {} .po ';') ; do
1532 if [[ ${op} == "-i" ]] ; then 1717 if [[ ${op} == "-i" ]] ; then
1533 hasq ${f} ${ls} && newls="${newls} ${f}" 1718 hasq ${f} ${ls} && newls="${newls} ${f}"
1534 else 1719 else
1535 hasq ${f} ${ls} || newls="${newls} ${f}" 1720 hasq ${f} ${ls} || newls="${newls} ${f}"
1536 fi 1721 fi
1549 else 1734 else
1550 nols="${nols} ${f}" 1735 nols="${nols} ${f}"
1551 fi 1736 fi
1552 done 1737 done
1553 [[ -n ${nols} ]] \ 1738 [[ -n ${nols} ]] \
1554 && ewarn "Sorry, but ${PN} does not support the LINGUAs:" ${nols} 1739 && ewarn "Sorry, but ${PN} does not support the LINGUAS:" ${nols}
1555 export LINGUAS=${newls:1} 1740 export LINGUAS=${newls:1}
1556} 1741}
1557 1742
1558# moved from kernel.eclass since they are generally useful outside of 1743# @FUNCTION: preserve_old_lib
1559# kernel.eclass -iggy (20041002) 1744# @USAGE: <libs to preserve> [more libs]
1560 1745# @DESCRIPTION:
1561# the following functions are useful in kernel module ebuilds, etc.
1562# for an example see ivtv or drbd ebuilds
1563
1564# set's ARCH to match what the kernel expects
1565set_arch_to_kernel() {
1566 i=10
1567 while ((i--)) ; do
1568 ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
1569 done
1570 export EUTILS_ECLASS_PORTAGE_ARCH="${ARCH}"
1571 case ${ARCH} in
1572 x86) export ARCH="i386";;
1573 amd64) export ARCH="x86_64";;
1574 hppa) export ARCH="parisc";;
1575 mips) export ARCH="mips";;
1576 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!
1577 *) export ARCH="${ARCH}";;
1578 esac
1579}
1580
1581# set's ARCH back to what portage expects
1582set_arch_to_portage() {
1583 i=10
1584 while ((i--)) ; do
1585 ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
1586 done
1587 export ARCH="${EUTILS_ECLASS_PORTAGE_ARCH}"
1588}
1589
1590# Jeremy Huddleston <eradicator@gentoo.org>:
1591# preserve_old_lib /path/to/libblah.so.0
1592# preserve_old_lib_notify /path/to/libblah.so.0
1593#
1594# These functions are useful when a lib in your package changes --library. Such 1746# These functions are useful when a lib in your package changes ABI SONAME.
1595# an example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0 1747# An example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0
1596# would break packages that link against it. Most people get around this 1748# would break packages that link against it. Most people get around this
1597# by using the portage SLOT mechanism, but that is not always a relevant 1749# by using the portage SLOT mechanism, but that is not always a relevant
1598# solution, so instead you can add the following to your ebuilds: 1750# solution, so instead you can call this from pkg_preinst. See also the
1599# 1751# preserve_old_lib_notify function.
1600# pkg_preinst() {
1601# ...
1602# preserve_old_lib /usr/$(get_libdir)/libogg.so.0
1603# ...
1604# }
1605#
1606# pkg_postinst() {
1607# ...
1608# preserve_old_lib_notify /usr/$(get_libdir)/libogg.so.0
1609# ...
1610# }
1611
1612preserve_old_lib() { 1752preserve_old_lib() {
1613 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then 1753 if [[ ${EBUILD_PHASE} != "preinst" ]] ; then
1614 eerror "preserve_old_lib() must be called from pkg_preinst() only" 1754 eerror "preserve_old_lib() must be called from pkg_preinst() only"
1615 die "Invalid preserve_old_lib() usage" 1755 die "Invalid preserve_old_lib() usage"
1616 fi 1756 fi
1617 [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]" 1757 [[ -z $1 ]] && die "Usage: preserve_old_lib <library to preserve> [more libraries to preserve]"
1758
1759 # let portage worry about it
1760 has preserve-libs ${FEATURES} && return 0
1618 1761
1619 local lib dir 1762 local lib dir
1620 for lib in "$@" ; do 1763 for lib in "$@" ; do
1621 [[ -e ${ROOT}/${lib} ]] || continue 1764 [[ -e ${ROOT}/${lib} ]] || continue
1622 dir=${lib%/*} 1765 dir=${lib%/*}
1624 cp "${ROOT}"/${lib} "${D}"/${lib} || die "cp ${lib} failed" 1767 cp "${ROOT}"/${lib} "${D}"/${lib} || die "cp ${lib} failed"
1625 touch "${D}"/${lib} 1768 touch "${D}"/${lib}
1626 done 1769 done
1627} 1770}
1628 1771
1772# @FUNCTION: preserve_old_lib_notify
1773# @USAGE: <libs to notify> [more libs]
1774# @DESCRIPTION:
1775# Spit helpful messages about the libraries preserved by preserve_old_lib.
1629preserve_old_lib_notify() { 1776preserve_old_lib_notify() {
1630 if [[ ${EBUILD_PHASE} != "postinst" ]] ; then 1777 if [[ ${EBUILD_PHASE} != "postinst" ]] ; then
1631 eerror "preserve_old_lib_notify() must be called from pkg_postinst() only" 1778 eerror "preserve_old_lib_notify() must be called from pkg_postinst() only"
1632 die "Invalid preserve_old_lib_notify() usage" 1779 die "Invalid preserve_old_lib_notify() usage"
1633 fi 1780 fi
1781
1782 # let portage worry about it
1783 has preserve-libs ${FEATURES} && return 0
1634 1784
1635 local lib notice=0 1785 local lib notice=0
1636 for lib in "$@" ; do 1786 for lib in "$@" ; do
1637 [[ -e ${ROOT}/${lib} ]] || continue 1787 [[ -e ${ROOT}/${lib} ]] || continue
1638 if [[ ${notice} -eq 0 ]] ; then 1788 if [[ ${notice} -eq 0 ]] ; then
1642 ewarn "the libraries are not being removed. You need to run revdep-rebuild" 1792 ewarn "the libraries are not being removed. You need to run revdep-rebuild"
1643 ewarn "in order to remove these old dependencies. If you do not have this" 1793 ewarn "in order to remove these old dependencies. If you do not have this"
1644 ewarn "helper program, simply emerge the 'gentoolkit' package." 1794 ewarn "helper program, simply emerge the 'gentoolkit' package."
1645 ewarn 1795 ewarn
1646 fi 1796 fi
1797 # temp hack for #348634 #357225
1798 [[ ${PN} == "mpfr" ]] && lib=${lib##*/}
1647 ewarn " # revdep-rebuild --library ${lib##*/}" 1799 ewarn " # revdep-rebuild --library '${lib}'"
1648 done 1800 done
1801 if [[ ${notice} -eq 1 ]] ; then
1802 ewarn
1803 ewarn "Once you've finished running revdep-rebuild, it should be safe to"
1804 ewarn "delete the old libraries. Here is a copy & paste for the lazy:"
1805 for lib in "$@" ; do
1806 ewarn " # rm '${lib}'"
1807 done
1808 fi
1649} 1809}
1650 1810
1651# Hack for people to figure out if a package was built with 1811# @FUNCTION: built_with_use
1652# certain USE flags
1653#
1654# Usage: built_with_use [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags> 1812# @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags>
1655# ex: built_with_use xchat gtk2 1813# @DESCRIPTION:
1656# 1814#
1657# Flags: -a all USE flags should be utilized 1815# Deprecated: Use EAPI 2 use deps in DEPEND|RDEPEND and with has_version calls.
1658# -o at least one USE flag should be utilized 1816#
1659# --missing peform the specified action if the flag is not in IUSE (true/false/die) 1817# A temporary hack until portage properly supports DEPENDing on USE
1660# --hidden USE flag we're checking is hidden expanded so it isnt in IUSE 1818# flags being enabled in packages. This will check to see if the specified
1661# Note: the default flag is '-a' 1819# DEPEND atom was built with the specified list of USE flags. The
1820# --missing option controls the behavior if called on a package that does
1821# not actually support the defined USE flags (aka listed in IUSE).
1822# The default is to abort (call die). The -a and -o flags control
1823# the requirements of the USE flags. They correspond to "and" and "or"
1824# logic. So the -a flag means all listed USE flags must be enabled
1825# while the -o flag means at least one of the listed IUSE flags must be
1826# enabled. The --hidden option is really for internal use only as it
1827# means the USE flag we're checking is hidden expanded, so it won't be found
1828# in IUSE like normal USE flags.
1829#
1830# Remember that this function isn't terribly intelligent so order of optional
1831# flags matter.
1662built_with_use() { 1832built_with_use() {
1663 local hidden="no" 1833 local hidden="no"
1664 if [[ $1 == "--hidden" ]] ; then 1834 if [[ $1 == "--hidden" ]] ; then
1665 hidden="yes" 1835 hidden="yes"
1666 shift 1836 shift
1695 die) die "Unable to determine what USE flags $PKG was built with";; 1865 die) die "Unable to determine what USE flags $PKG was built with";;
1696 esac 1866 esac
1697 fi 1867 fi
1698 1868
1699 if [[ ${hidden} == "no" ]] ; then 1869 if [[ ${hidden} == "no" ]] ; then
1700 local IUSE_BUILT=$(<${IUSEFILE}) 1870 local IUSE_BUILT=( $(<"${IUSEFILE}") )
1701 # Don't check USE_EXPAND #147237 1871 # Don't check USE_EXPAND #147237
1702 local expand 1872 local expand
1703 for expand in $(echo ${USE_EXPAND} | tr '[:upper:]' '[:lower:]') ; do 1873 for expand in $(echo ${USE_EXPAND} | tr '[:upper:]' '[:lower:]') ; do
1704 if [[ $1 == ${expand}_* ]] ; then 1874 if [[ $1 == ${expand}_* ]] ; then
1705 expand="" 1875 expand=""
1706 break 1876 break
1707 fi 1877 fi
1708 done 1878 done
1709 if [[ -n ${expand} ]] ; then 1879 if [[ -n ${expand} ]] ; then
1710 if ! has $1 ${IUSE_BUILT} ; then 1880 if ! has $1 ${IUSE_BUILT[@]#[-+]} ; then
1711 case ${missing_action} in 1881 case ${missing_action} in
1712 true) return 0;; 1882 true) return 0;;
1713 false) return 1;; 1883 false) return 1;;
1714 die) die "$PKG does not actually support the $1 USE flag!";; 1884 die) die "$PKG does not actually support the $1 USE flag!";;
1715 esac 1885 esac
1727 shift 1897 shift
1728 done 1898 done
1729 [[ ${opt} = "-a" ]] 1899 [[ ${opt} = "-a" ]]
1730} 1900}
1731 1901
1902# @FUNCTION: epunt_cxx
1903# @USAGE: [dir to scan]
1904# @DESCRIPTION:
1732# Many configure scripts wrongly bail when a C++ compiler 1905# Many configure scripts wrongly bail when a C++ compiler could not be
1733# could not be detected. #73450 1906# detected. If dir is not specified, then it defaults to ${S}.
1907#
1908# http://bugs.gentoo.org/73450
1734epunt_cxx() { 1909epunt_cxx() {
1735 local dir=$1 1910 local dir=$1
1736 [[ -z ${dir} ]] && dir=${S} 1911 [[ -z ${dir} ]] && dir=${S}
1737 ebegin "Removing useless C++ checks" 1912 ebegin "Removing useless C++ checks"
1738 local f 1913 local f
1739 for f in $(find ${dir} -name configure) ; do 1914 find "${dir}" -name configure | while read f ; do
1740 patch -p0 "${f}" "${PORTDIR}/eclass/ELT-patches/nocxx/nocxx.patch" > /dev/null 1915 patch --no-backup-if-mismatch -p0 "${f}" "${PORTDIR}/eclass/ELT-patches/nocxx/nocxx.patch" > /dev/null
1741 done 1916 done
1742 eend 0 1917 eend 0
1743} 1918}
1744 1919
1745# make a wrapper script ... 1920# @FUNCTION: make_wrapper
1746# NOTE: this was originally games_make_wrapper, but I noticed other places where 1921# @USAGE: <wrapper> <target> [chdir] [libpaths] [installpath]
1747# this could be used, so I have moved it here and made it not games-specific 1922# @DESCRIPTION:
1748# -- wolf31o2 1923# Create a shell wrapper script named wrapper in installpath
1749# $1 == wrapper name 1924# (defaults to the bindir) to execute target (default of wrapper) by
1750# $2 == binary to run 1925# first optionally setting LD_LIBRARY_PATH to the colon-delimited
1751# $3 == directory to chdir before running binary 1926# libpaths followed by optionally changing directory to chdir.
1752# $4 == extra LD_LIBRARY_PATH's (make it : delimited)
1753# $5 == path for wrapper
1754make_wrapper() { 1927make_wrapper() {
1755 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5 1928 local wrapper=$1 bin=$2 chdir=$3 libdir=$4 path=$5
1756 local tmpwrapper=$(emktemp) 1929 local tmpwrapper=$(emktemp)
1757 # We don't want to quote ${bin} so that people can pass complex 1930 # We don't want to quote ${bin} so that people can pass complex
1758 # things as $bin ... "./someprog --args" 1931 # things as $bin ... "./someprog --args"
1768fi 1941fi
1769exec ${bin} "\$@" 1942exec ${bin} "\$@"
1770EOF 1943EOF
1771 chmod go+rx "${tmpwrapper}" 1944 chmod go+rx "${tmpwrapper}"
1772 if [[ -n ${path} ]] ; then 1945 if [[ -n ${path} ]] ; then
1946 (
1773 exeinto "${path}" 1947 exeinto "${path}"
1774 newexe "${tmpwrapper}" "${wrapper}" 1948 newexe "${tmpwrapper}" "${wrapper}"
1949 ) || die
1775 else 1950 else
1776 newbin "${tmpwrapper}" "${wrapper}" 1951 newbin "${tmpwrapper}" "${wrapper}" || die
1777 fi 1952 fi
1778} 1953}
1954
1955# @FUNCTION: path_exists
1956# @USAGE: [-a|-o] <paths>
1957# @DESCRIPTION:
1958# Check if the specified paths exist. Works for all types of paths
1959# (files/dirs/etc...). The -a and -o flags control the requirements
1960# of the paths. They correspond to "and" and "or" logic. So the -a
1961# flag means all the paths must exist while the -o flag means at least
1962# one of the paths must exist. The default behavior is "and". If no
1963# paths are specified, then the return value is "false".
1964path_exists() {
1965 local opt=$1
1966 [[ ${opt} == -[ao] ]] && shift || opt="-a"
1967
1968 # no paths -> return false
1969 # same behavior as: [[ -e "" ]]
1970 [[ $# -eq 0 ]] && return 1
1971
1972 local p r=0
1973 for p in "$@" ; do
1974 [[ -e ${p} ]]
1975 : $(( r += $? ))
1976 done
1977
1978 case ${opt} in
1979 -a) return $(( r != 0 )) ;;
1980 -o) return $(( r == $# )) ;;
1981 esac
1982}

Legend:
Removed from v.1.279  
changed lines
  Added in v.1.356

  ViewVC Help
Powered by ViewVC 1.1.20