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

Diff of /eclass/eutils.eclass

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

Revision 1.284 Revision 1.293
1# Copyright 1999-2007 Gentoo Foundation 1# Copyright 1999-2007 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.284 2007/06/21 04:44:45 vapier Exp $ 3# $Header: /var/cvsroot/gentoo-x86/eclass/eutils.eclass,v 1.293 2007/11/20 22:32:01 wolf31o2 Exp $
4 4
5# @ECLASS: eutils.eclass 5# @ECLASS: eutils.eclass
6# @MAINTAINER: 6# @MAINTAINER:
7# base-system@gentoo.org 7# base-system@gentoo.org
8# @BLURB: many extra (but common) functions that are used in ebuilds 8# @BLURB: many extra (but common) functions that are used in ebuilds
9# @DESCRIPTION: 9# @DESCRIPTION:
10# The eutils eclass contains a suite of functions that complement 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 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 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. 13# home rather than having multiple ebuilds implementing the same thing.
14# 14#
15# Due to the nature of this eclass, some functions may have maintainers 15# Due to the nature of this eclass, some functions may have maintainers
16# different from the overall eclass! 16# different from the overall eclass!
17 17
18inherit multilib portability 18inherit multilib portability
19 19
739make_desktop_entry() { 739make_desktop_entry() {
740 [[ -z $1 ]] && eerror "make_desktop_entry: You must specify the executable" && return 1 740 [[ -z $1 ]] && eerror "make_desktop_entry: You must specify the executable" && return 1
741 741
742 local exec=${1} 742 local exec=${1}
743 local name=${2:-${PN}} 743 local name=${2:-${PN}}
744 local icon=${3:-${PN}.png} 744 local icon=${3:-${PN}}
745 local type=${4} 745 local type=${4}
746 local path=${5} 746 local path=${5}
747 747
748 if [[ -z ${type} ]] ; then 748 if [[ -z ${type} ]] ; then
749 local catmaj=${CATEGORY%%-*} 749 local catmaj=${CATEGORY%%-*}
873 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop" 873 local desktop="${T}/$(echo ${exec} | sed 's:[[:space:]/:]:_:g')-${desktop_name}.desktop"
874 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop 874 #local desktop=${T}/${exec%% *:-${desktop_name}}.desktop
875 875
876 cat <<-EOF > "${desktop}" 876 cat <<-EOF > "${desktop}"
877 [Desktop Entry] 877 [Desktop Entry]
878 Encoding=UTF-8
879 Version=1.0 878 Version=1.0
880 Name=${name} 879 Name=${name}
881 Type=Application 880 Type=Application
882 Comment=${DESCRIPTION} 881 Comment=${DESCRIPTION}
883 Exec=${exec} 882 Exec=${exec}
884 TryExec=${exec%% *} 883 TryExec=${exec%% *}
885 Path=${path}
886 Icon=${icon} 884 Icon=${icon}
887 Categories=${type}; 885 Categories=${type};
888 EOF 886 EOF
887
888 [[ ${path} ]] && echo "Path=${path}" >> "${desktop}"
889 889
890 ( 890 (
891 # wrap the env here so that the 'insinto' call 891 # wrap the env here so that the 'insinto' call
892 # doesn't corrupt the env of the caller 892 # doesn't corrupt the env of the caller
893 insinto /usr/share/applications 893 insinto /usr/share/applications
936 local command=$2 936 local command=$2
937 local desktop=${T}/${wm}.desktop 937 local desktop=${T}/${wm}.desktop
938 938
939 cat <<-EOF > "${desktop}" 939 cat <<-EOF > "${desktop}"
940 [Desktop Entry] 940 [Desktop Entry]
941 Encoding=UTF-8
942 Name=${title} 941 Name=${title}
943 Comment=This session logs you into ${title} 942 Comment=This session logs you into ${title}
944 Exec=${command} 943 Exec=${command}
945 TryExec=${command} 944 TryExec=${command}
946 Type=Application 945 Type=Application
972 elif [[ -d ${i} ]] ; then 971 elif [[ -d ${i} ]] ; then
973 for j in "${i}"/*.desktop ; do 972 for j in "${i}"/*.desktop ; do
974 doins "${j}" 973 doins "${j}"
975 ((ret+=$?)) 974 ((ret+=$?))
976 done 975 done
976 else
977 ((++ret))
977 fi 978 fi
978 done 979 done
979 exit ${ret} 980 exit ${ret}
980 ) 981 )
981} 982}
1011 elif [[ -d ${i} ]] ; then 1012 elif [[ -d ${i} ]] ; then
1012 for j in "${i}"/*.png ; do 1013 for j in "${i}"/*.png ; do
1013 doins "${j}" 1014 doins "${j}"
1014 ((ret+=$?)) 1015 ((ret+=$?))
1015 done 1016 done
1017 else
1018 ((++ret))
1016 fi 1019 fi
1017 done 1020 done
1018 exit ${ret} 1021 exit ${ret}
1019 ) 1022 )
1020} 1023}
1055# @DESCRIPTION: 1058# @DESCRIPTION:
1056# Unpack those pesky pdv generated files ... 1059# Unpack those pesky pdv generated files ...
1057# They're self-unpacking programs with the binary package stuffed in 1060# They're self-unpacking programs with the binary package stuffed in
1058# the middle of the archive. Valve seems to use it a lot ... too bad 1061# the middle of the archive. Valve seems to use it a lot ... too bad
1059# it seems to like to segfault a lot :(. So lets take it apart ourselves. 1062# it seems to like to segfault a lot :(. So lets take it apart ourselves.
1060# 1063#
1061# You have to specify the off_t size ... I have no idea how to extract that 1064# You have to specify the off_t size ... I have no idea how to extract that
1062# information out of the binary executable myself. Basically you pass in 1065# information out of the binary executable myself. Basically you pass in
1063# the size of the off_t type (in bytes) on the machine that built the pdv 1066# the size of the off_t type (in bytes) on the machine that built the pdv
1064# archive. 1067# archive.
1065# 1068#
1066# One way to determine this is by running the following commands: 1069# One way to determine this is by running the following commands:
1070#
1071# @CODE
1067# strings <pdv archive> | grep lseek 1072# strings <pdv archive> | grep lseek
1068# strace -elseek <pdv archive> 1073# strace -elseek <pdv archive>
1074# @CODE
1075#
1069# Basically look for the first lseek command (we do the strings/grep because 1076# Basically look for the first lseek command (we do the strings/grep because
1070# sometimes the function call is _llseek or something) and steal the 2nd 1077# sometimes the function call is _llseek or something) and steal the 2nd
1071# parameter. Here is an example: 1078# parameter. Here is an example:
1079#
1080# @CODE
1072# vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek 1081# vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek
1073# lseek 1082# lseek
1074# vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin 1083# vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin
1075# lseek(3, -4, SEEK_END) = 2981250 1084# lseek(3, -4, SEEK_END) = 2981250
1085# @CODE
1086#
1076# Thus we would pass in the value of '4' as the second parameter. 1087# Thus we would pass in the value of '4' as the second parameter.
1077unpack_pdv() { 1088unpack_pdv() {
1078 local src=$(find_unpackable_file "$1") 1089 local src=$(find_unpackable_file "$1")
1079 local sizeoff_t=$2 1090 local sizeoff_t=$2
1080 1091
1150# @DESCRIPTION: 1161# @DESCRIPTION:
1151# Unpack those pesky makeself generated files ... 1162# Unpack those pesky makeself generated files ...
1152# They're shell scripts with the binary package tagged onto 1163# They're shell scripts with the binary package tagged onto
1153# the end of the archive. Loki utilized the format as does 1164# the end of the archive. Loki utilized the format as does
1154# many other game companies. 1165# many other game companies.
1155# 1166#
1156# If the file is not specified, then ${A} is used. If the 1167# If the file is not specified, then ${A} is used. If the
1157# offset is not specified then we will attempt to extract 1168# offset is not specified then we will attempt to extract
1158# the proper offset from the script itself. 1169# the proper offset from the script itself.
1159unpack_makeself() { 1170unpack_makeself() {
1160 local src_input=${1:-${A}} 1171 local src_input=${1:-${A}}
1275 The following license outlines the terms of use of this 1286 The following license outlines the terms of use of this
1276 package. You MUST accept this license for installation to 1287 package. You MUST accept this license for installation to
1277 continue. When you are done viewing, hit 'q'. If you 1288 continue. When you are done viewing, hit 'q'. If you
1278 CTRL+C out of this, the install will not run! 1289 CTRL+C out of this, the install will not run!
1279 ********************************************************** 1290 **********************************************************
1280 1291
1281 EOF 1292 EOF
1282 cat ${lic} >> ${licmsg} 1293 cat ${lic} >> ${licmsg}
1283 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}" 1294 ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}"
1284 einfon "Do you accept the terms of this license (${l})? [yes/no] " 1295 einfon "Do you accept the terms of this license (${l})? [yes/no] "
1285 read alic 1296 read alic
1298# @FUNCTION: cdrom_get_cds 1309# @FUNCTION: cdrom_get_cds
1299# @USAGE: <file on cd1> [file on cd2] [file on cd3] [...] 1310# @USAGE: <file on cd1> [file on cd2] [file on cd3] [...]
1300# @DESCRIPTION: 1311# @DESCRIPTION:
1301# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates 1312# Aquire cd(s) for those lovely cd-based emerges. Yes, this violates
1302# the whole 'non-interactive' policy, but damnit I want CD support ! 1313# the whole 'non-interactive' policy, but damnit I want CD support !
1303# 1314#
1304# With these cdrom functions we handle all the user interaction and 1315# With these cdrom functions we handle all the user interaction and
1305# standardize everything. All you have to do is call cdrom_get_cds() 1316# standardize everything. All you have to do is call cdrom_get_cds()
1306# and when the function returns, you can assume that the cd has been 1317# and when the function returns, you can assume that the cd has been
1307# found at CDROM_ROOT. 1318# found at CDROM_ROOT.
1308# 1319#
1309# The function will attempt to locate a cd based upon a file that is on 1320# The function will attempt to locate a cd based upon a file that is on
1310# the cd. The more files you give this function, the more cds 1321# the cd. The more files you give this function, the more cds
1311# the cdrom functions will handle. 1322# the cdrom functions will handle.
1312# 1323#
1313# Normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2', 1324# Normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2',
1314# etc... If you want to give the cds better names, then just export 1325# etc... If you want to give the cds better names, then just export
1315# the appropriate CDROM_NAME variable before calling cdrom_get_cds(). 1326# the appropriate CDROM_NAME variable before calling cdrom_get_cds().
1316# Use CDROM_NAME for one cd, or CDROM_NAME_# for multiple cds. You can 1327# Use CDROM_NAME for one cd, or CDROM_NAME_# for multiple cds. You can
1317# also use the CDROM_NAME_SET bash array. 1328# also use the CDROM_NAME_SET bash array.
1318# 1329#
1319# For those multi cd ebuilds, see the cdrom_load_next_cd() function. 1330# For those multi cd ebuilds, see the cdrom_load_next_cd() function.
1320cdrom_get_cds() { 1331cdrom_get_cds() {
1321 # first we figure out how many cds we're dealing with by 1332 # first we figure out how many cds we're dealing with by
1322 # the # of files they gave us 1333 # the # of files they gave us
1323 local cdcnt=0 1334 local cdcnt=0
1463 while read point node fs foo ; do 1474 while read point node fs foo ; do
1464 [[ " cd9660 iso9660 udf " != *" ${fs} "* ]] && \ 1475 [[ " cd9660 iso9660 udf " != *" ${fs} "* ]] && \
1465 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \ 1476 ! [[ ${fs} == "subfs" && ",${opts}," == *",fs=cdfss,"* ]] \
1466 && continue 1477 && continue
1467 point=${point//\040/ } 1478 point=${point//\040/ }
1479 [[ ! -d ${point}/${dir} ]] && continue
1468 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue 1480 [[ -z $(find "${point}/${dir}" -maxdepth 1 -iname "${file}") ]] && continue
1469 export CDROM_ROOT=${point} 1481 export CDROM_ROOT=${point}
1470 export CDROM_SET=${i} 1482 export CDROM_SET=${i}
1471 export CDROM_MATCH=${cdset[${i}]} 1483 export CDROM_MATCH=${cdset[${i}]}
1472 return 1484 return
1502 einfo "check that CONFIG_JOLIET is enabled in your kernel." 1514 einfo "check that CONFIG_JOLIET is enabled in your kernel."
1503 read || die "something is screwed with your system" 1515 read || die "something is screwed with your system"
1504 done 1516 done
1505} 1517}
1506 1518
1519# @FUNCTION: strip-linguas
1520# @USAGE: [<allow LINGUAS>|<-i|-u> <directories of .po files>]
1521# @DESCRIPTION:
1507# Make sure that LINGUAS only contains languages that 1522# Make sure that LINGUAS only contains languages that
1508# a package can support 1523# a package can support. The first form allows you to
1509# 1524# specify a list of LINGUAS. The -i builds a list of po
1510# usage: strip-linguas <allow LINGUAS> 1525# files found in all the directories and uses the
1511# strip-linguas -i <directories of .po files> 1526# intersection of the lists. The -u builds a list of po
1512# strip-linguas -u <directories of .po files> 1527# files found in all the directories and uses the union
1513# 1528# 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() { 1529strip-linguas() {
1520 local ls newls nols 1530 local ls newls nols
1521 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then 1531 if [[ $1 == "-i" ]] || [[ $1 == "-u" ]] ; then
1522 local op=$1; shift 1532 local op=$1; shift
1523 ls=$(find "$1" -name '*.po' -exec basename {} .po \;); shift 1533 ls=$(find "$1" -name '*.po' -exec basename {} .po \;); shift
1553 [[ -n ${nols} ]] \ 1563 [[ -n ${nols} ]] \
1554 && ewarn "Sorry, but ${PN} does not support the LINGUAs:" ${nols} 1564 && ewarn "Sorry, but ${PN} does not support the LINGUAs:" ${nols}
1555 export LINGUAS=${newls:1} 1565 export LINGUAS=${newls:1}
1556} 1566}
1557 1567
1558# @FUNCTION: set_arch_to_kernel
1559# @DESCRIPTION:
1560# Set the env ARCH to match what the kernel expects.
1561set_arch_to_kernel() {
1562 i=10
1563 while ((i--)) ; do
1564 ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
1565 done
1566 export EUTILS_ECLASS_PORTAGE_ARCH="${ARCH}"
1567 case ${ARCH} in
1568 x86) export ARCH="i386";;
1569 amd64) export ARCH="x86_64";;
1570 hppa) export ARCH="parisc";;
1571 mips) export ARCH="mips";;
1572 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!
1573 *) export ARCH="${ARCH}";;
1574 esac
1575}
1576
1577# @FUNCTION: set_arch_to_portage
1578# @DESCRIPTION:
1579# Set the env ARCH to match what portage expects.
1580set_arch_to_portage() {
1581 i=10
1582 while ((i--)) ; do
1583 ewarn "PLEASE UPDATE TO YOUR PACKAGE TO USE linux-info.eclass"
1584 done
1585 export ARCH="${EUTILS_ECLASS_PORTAGE_ARCH}"
1586}
1587
1588# @FUNCTION: preserve_old_lib 1568# @FUNCTION: preserve_old_lib
1589# @USAGE: <libs to preserve> [more libs] 1569# @USAGE: <libs to preserve> [more libs]
1590# @DESCRIPTION: 1570# @DESCRIPTION:
1591# These functions are useful when a lib in your package changes ABI SONAME. 1571# These functions are useful when a lib in your package changes ABI SONAME.
1592# An example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0 1572# An example might be from libogg.so.0 to libogg.so.1. Removing libogg.so.0
1633 ewarn "helper program, simply emerge the 'gentoolkit' package." 1613 ewarn "helper program, simply emerge the 'gentoolkit' package."
1634 ewarn 1614 ewarn
1635 fi 1615 fi
1636 ewarn " # revdep-rebuild --library ${lib##*/}" 1616 ewarn " # revdep-rebuild --library ${lib##*/}"
1637 done 1617 done
1618 if [[ ${notice} -eq 1 ]] ; then
1619 ewarn
1620 ewarn "Once you've finished running revdep-rebuild, it should be safe to"
1621 ewarn "delete the old libraries."
1622 fi
1638} 1623}
1639 1624
1640# @FUNCTION: built_with_use 1625# @FUNCTION: built_with_use
1641# @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags> 1626# @USAGE: [--hidden] [--missing <action>] [-a|-o] <DEPEND ATOM> <List of USE flags>
1642# @DESCRIPTION: 1627# @DESCRIPTION:
1650# logic. So the -a flag means all listed USE flags must be enabled 1635# logic. So the -a flag means all listed USE flags must be enabled
1651# while the -o flag means at least one of the listed fIUSE flags must be 1636# while the -o flag means at least one of the listed fIUSE flags must be
1652# enabled. The --hidden option is really for internal use only as it 1637# enabled. The --hidden option is really for internal use only as it
1653# means the USE flag we're checking is hidden expanded, so it won't be found 1638# means the USE flag we're checking is hidden expanded, so it won't be found
1654# in IUSE like normal USE flags. 1639# in IUSE like normal USE flags.
1655# 1640#
1656# Remember that this function isn't terribly intelligent so order of optional 1641# Remember that this function isn't terribly intelligent so order of optional
1657# flags matter. 1642# flags matter.
1658built_with_use() { 1643built_with_use() {
1659 local hidden="no" 1644 local hidden="no"
1660 if [[ $1 == "--hidden" ]] ; then 1645 if [[ $1 == "--hidden" ]] ; then
1723 shift 1708 shift
1724 done 1709 done
1725 [[ ${opt} = "-a" ]] 1710 [[ ${opt} = "-a" ]]
1726} 1711}
1727 1712
1728# @DESCRIPTION: epunt_cxx 1713# @FUNCTION: epunt_cxx
1729# @USAGE: [dir to scan] 1714# @USAGE: [dir to scan]
1730# @DESCRIPTION: 1715# @DESCRIPTION:
1731# Many configure scripts wrongly bail when a C++ compiler could not be 1716# Many configure scripts wrongly bail when a C++ compiler could not be
1732# detected. If dir is not specified, then it defaults to ${S}. 1717# detected. If dir is not specified, then it defaults to ${S}.
1733# 1718#

Legend:
Removed from v.1.284  
changed lines
  Added in v.1.293

  ViewVC Help
Powered by ViewVC 1.1.20