| 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.290 2007/10/01 13:16:44 vapier Exp $ |
| 4 | |
4 | |
| 5 | # @ECLASS: eutils.eclass |
5 | # @ECLASS: eutils.eclass |
| 6 | # @MAINTAINER: |
6 | # @MAINTAINER: |
| 7 | # base-system@gentoo.org |
7 | # base-system@gentoo.org |
| 8 | # @BLURB: many extra (but common) functions that are used in ebuilds |
8 | # @BLURB: many extra (but common) functions that are used in ebuilds |
| 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 | |
| 18 | inherit multilib portability |
18 | inherit multilib portability |
| 19 | |
19 | |
| … | |
… | |
| 972 | elif [[ -d ${i} ]] ; then |
972 | elif [[ -d ${i} ]] ; then |
| 973 | for j in "${i}"/*.desktop ; do |
973 | for j in "${i}"/*.desktop ; do |
| 974 | doins "${j}" |
974 | doins "${j}" |
| 975 | ((ret+=$?)) |
975 | ((ret+=$?)) |
| 976 | done |
976 | done |
|
|
977 | else |
|
|
978 | ((++ret)) |
| 977 | fi |
979 | fi |
| 978 | done |
980 | done |
| 979 | exit ${ret} |
981 | exit ${ret} |
| 980 | ) |
982 | ) |
| 981 | } |
983 | } |
| … | |
… | |
| 1011 | elif [[ -d ${i} ]] ; then |
1013 | elif [[ -d ${i} ]] ; then |
| 1012 | for j in "${i}"/*.png ; do |
1014 | for j in "${i}"/*.png ; do |
| 1013 | doins "${j}" |
1015 | doins "${j}" |
| 1014 | ((ret+=$?)) |
1016 | ((ret+=$?)) |
| 1015 | done |
1017 | done |
|
|
1018 | else |
|
|
1019 | ((++ret)) |
| 1016 | fi |
1020 | fi |
| 1017 | done |
1021 | done |
| 1018 | exit ${ret} |
1022 | exit ${ret} |
| 1019 | ) |
1023 | ) |
| 1020 | } |
1024 | } |
| … | |
… | |
| 1055 | # @DESCRIPTION: |
1059 | # @DESCRIPTION: |
| 1056 | # Unpack those pesky pdv generated files ... |
1060 | # Unpack those pesky pdv generated files ... |
| 1057 | # They're self-unpacking programs with the binary package stuffed in |
1061 | # 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 |
1062 | # 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. |
1063 | # it seems to like to segfault a lot :(. So lets take it apart ourselves. |
| 1060 | # |
1064 | # |
| 1061 | # You have to specify the off_t size ... I have no idea how to extract that |
1065 | # 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 |
1066 | # 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 |
1067 | # the size of the off_t type (in bytes) on the machine that built the pdv |
| 1064 | # archive. |
1068 | # archive. |
| 1065 | # |
1069 | # |
| 1066 | # One way to determine this is by running the following commands: |
1070 | # One way to determine this is by running the following commands: |
|
|
1071 | # |
|
|
1072 | # @CODE |
| 1067 | # strings <pdv archive> | grep lseek |
1073 | # strings <pdv archive> | grep lseek |
| 1068 | # strace -elseek <pdv archive> |
1074 | # strace -elseek <pdv archive> |
|
|
1075 | # @CODE |
|
|
1076 | # |
| 1069 | # Basically look for the first lseek command (we do the strings/grep because |
1077 | # 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 |
1078 | # sometimes the function call is _llseek or something) and steal the 2nd |
| 1071 | # parameter. Here is an example: |
1079 | # parameter. Here is an example: |
|
|
1080 | # |
|
|
1081 | # @CODE |
| 1072 | # vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek |
1082 | # vapier@vapier 0 pdv_unpack # strings hldsupdatetool.bin | grep lseek |
| 1073 | # lseek |
1083 | # lseek |
| 1074 | # vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin |
1084 | # vapier@vapier 0 pdv_unpack # strace -elseek ./hldsupdatetool.bin |
| 1075 | # lseek(3, -4, SEEK_END) = 2981250 |
1085 | # lseek(3, -4, SEEK_END) = 2981250 |
|
|
1086 | # @CODE |
|
|
1087 | # |
| 1076 | # Thus we would pass in the value of '4' as the second parameter. |
1088 | # Thus we would pass in the value of '4' as the second parameter. |
| 1077 | unpack_pdv() { |
1089 | unpack_pdv() { |
| 1078 | local src=$(find_unpackable_file "$1") |
1090 | local src=$(find_unpackable_file "$1") |
| 1079 | local sizeoff_t=$2 |
1091 | local sizeoff_t=$2 |
| 1080 | |
1092 | |
| … | |
… | |
| 1150 | # @DESCRIPTION: |
1162 | # @DESCRIPTION: |
| 1151 | # Unpack those pesky makeself generated files ... |
1163 | # Unpack those pesky makeself generated files ... |
| 1152 | # They're shell scripts with the binary package tagged onto |
1164 | # They're shell scripts with the binary package tagged onto |
| 1153 | # the end of the archive. Loki utilized the format as does |
1165 | # the end of the archive. Loki utilized the format as does |
| 1154 | # many other game companies. |
1166 | # many other game companies. |
| 1155 | # |
1167 | # |
| 1156 | # If the file is not specified, then ${A} is used. If the |
1168 | # If the file is not specified, then ${A} is used. If the |
| 1157 | # offset is not specified then we will attempt to extract |
1169 | # offset is not specified then we will attempt to extract |
| 1158 | # the proper offset from the script itself. |
1170 | # the proper offset from the script itself. |
| 1159 | unpack_makeself() { |
1171 | unpack_makeself() { |
| 1160 | local src_input=${1:-${A}} |
1172 | local src_input=${1:-${A}} |
| … | |
… | |
| 1275 | The following license outlines the terms of use of this |
1287 | The following license outlines the terms of use of this |
| 1276 | package. You MUST accept this license for installation to |
1288 | package. You MUST accept this license for installation to |
| 1277 | continue. When you are done viewing, hit 'q'. If you |
1289 | continue. When you are done viewing, hit 'q'. If you |
| 1278 | CTRL+C out of this, the install will not run! |
1290 | CTRL+C out of this, the install will not run! |
| 1279 | ********************************************************** |
1291 | ********************************************************** |
| 1280 | |
1292 | |
| 1281 | EOF |
1293 | EOF |
| 1282 | cat ${lic} >> ${licmsg} |
1294 | cat ${lic} >> ${licmsg} |
| 1283 | ${PAGER:-less} ${licmsg} || die "Could not execute pager (${PAGER}) to accept ${lic}" |
1295 | ${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] " |
1296 | einfon "Do you accept the terms of this license (${l})? [yes/no] " |
| 1285 | read alic |
1297 | read alic |
| … | |
… | |
| 1298 | # @FUNCTION: cdrom_get_cds |
1310 | # @FUNCTION: cdrom_get_cds |
| 1299 | # @USAGE: <file on cd1> [file on cd2] [file on cd3] [...] |
1311 | # @USAGE: <file on cd1> [file on cd2] [file on cd3] [...] |
| 1300 | # @DESCRIPTION: |
1312 | # @DESCRIPTION: |
| 1301 | # Aquire cd(s) for those lovely cd-based emerges. Yes, this violates |
1313 | # Aquire cd(s) for those lovely cd-based emerges. Yes, this violates |
| 1302 | # the whole 'non-interactive' policy, but damnit I want CD support ! |
1314 | # the whole 'non-interactive' policy, but damnit I want CD support ! |
| 1303 | # |
1315 | # |
| 1304 | # With these cdrom functions we handle all the user interaction and |
1316 | # With these cdrom functions we handle all the user interaction and |
| 1305 | # standardize everything. All you have to do is call cdrom_get_cds() |
1317 | # 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 |
1318 | # and when the function returns, you can assume that the cd has been |
| 1307 | # found at CDROM_ROOT. |
1319 | # found at CDROM_ROOT. |
| 1308 | # |
1320 | # |
| 1309 | # The function will attempt to locate a cd based upon a file that is on |
1321 | # 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 |
1322 | # the cd. The more files you give this function, the more cds |
| 1311 | # the cdrom functions will handle. |
1323 | # the cdrom functions will handle. |
| 1312 | # |
1324 | # |
| 1313 | # Normally the cdrom functions will refer to the cds as 'cd #1', 'cd #2', |
1325 | # 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 |
1326 | # etc... If you want to give the cds better names, then just export |
| 1315 | # the appropriate CDROM_NAME variable before calling cdrom_get_cds(). |
1327 | # 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 |
1328 | # Use CDROM_NAME for one cd, or CDROM_NAME_# for multiple cds. You can |
| 1317 | # also use the CDROM_NAME_SET bash array. |
1329 | # also use the CDROM_NAME_SET bash array. |
| 1318 | # |
1330 | # |
| 1319 | # For those multi cd ebuilds, see the cdrom_load_next_cd() function. |
1331 | # For those multi cd ebuilds, see the cdrom_load_next_cd() function. |
| 1320 | cdrom_get_cds() { |
1332 | cdrom_get_cds() { |
| 1321 | # first we figure out how many cds we're dealing with by |
1333 | # first we figure out how many cds we're dealing with by |
| 1322 | # the # of files they gave us |
1334 | # the # of files they gave us |
| 1323 | local cdcnt=0 |
1335 | local cdcnt=0 |
| … | |
… | |
| 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. |
|
|
| 1519 | strip-linguas() { |
1529 | strip-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. |
|
|
| 1561 | set_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. |
|
|
| 1580 | set_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 |
| … | |
… | |
| 1650 | # logic. So the -a flag means all listed USE flags must be enabled |
1630 | # 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 |
1631 | # 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 |
1632 | # 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 |
1633 | # means the USE flag we're checking is hidden expanded, so it won't be found |
| 1654 | # in IUSE like normal USE flags. |
1634 | # in IUSE like normal USE flags. |
| 1655 | # |
1635 | # |
| 1656 | # Remember that this function isn't terribly intelligent so order of optional |
1636 | # Remember that this function isn't terribly intelligent so order of optional |
| 1657 | # flags matter. |
1637 | # flags matter. |
| 1658 | built_with_use() { |
1638 | built_with_use() { |
| 1659 | local hidden="no" |
1639 | local hidden="no" |
| 1660 | if [[ $1 == "--hidden" ]] ; then |
1640 | if [[ $1 == "--hidden" ]] ; then |
| … | |
… | |
| 1723 | shift |
1703 | shift |
| 1724 | done |
1704 | done |
| 1725 | [[ ${opt} = "-a" ]] |
1705 | [[ ${opt} = "-a" ]] |
| 1726 | } |
1706 | } |
| 1727 | |
1707 | |
| 1728 | # @DESCRIPTION: epunt_cxx |
1708 | # @FUNCTION: epunt_cxx |
| 1729 | # @USAGE: [dir to scan] |
1709 | # @USAGE: [dir to scan] |
| 1730 | # @DESCRIPTION: |
1710 | # @DESCRIPTION: |
| 1731 | # Many configure scripts wrongly bail when a C++ compiler could not be |
1711 | # Many configure scripts wrongly bail when a C++ compiler could not be |
| 1732 | # detected. If dir is not specified, then it defaults to ${S}. |
1712 | # detected. If dir is not specified, then it defaults to ${S}. |
| 1733 | # |
1713 | # |