| 1 | <?xml version='1.0' encoding='UTF-8'?> |
1 | <?xml version='1.0' encoding='UTF-8'?> |
| 2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
2 | <!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
| 3 | |
3 | |
| 4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
4 | <!-- The content of this document is licensed under the CC-BY-SA license --> |
| 5 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
5 | <!-- See http://creativecommons.org/licenses/by-sa/1.0 --> |
| 6 | |
6 | |
| 7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.26 2004/07/16 09:37:11 neysx Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.27 2004/07/18 10:41:51 neysx Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | <section> |
10 | <section> |
| 11 | <title>Obtaining Package Information</title> |
11 | <title>Obtaining Package Information</title> |
| 12 | <subsection> |
12 | <subsection> |
| 13 | <title>The Lord of All Tools: emerge</title> |
13 | <title>The Lord of All Tools: emerge</title> |
| 14 | <body> |
14 | <body> |
| 15 | |
15 | |
| 16 | <p> |
16 | <p> |
| 17 | The main Portage tool that most users will use is <c>emerge</c>. We have already |
17 | The main Portage tool that most users will use is <c>emerge</c>. We have already |
| 18 | used it during the Gentoo installation and in the previous chapter, but we just |
18 | used it during the Gentoo installation and in the previous chapter, but we just |
| 19 | briefly explained how to use it. This chapter will elaborate on <c>emerge</c> |
19 | briefly explained how to use it. This chapter will elaborate on <c>emerge</c> |
| 20 | and teach you how to use <c>emerge</c> to fix all your software-related needs. |
20 | and teach you how to use <c>emerge</c> to fix all your software-related needs. |
| 21 | </p> |
21 | </p> |
| 22 | |
22 | |
| … | |
… | |
| 805 | <pre caption="Message about masked packages"> |
805 | <pre caption="Message about masked packages"> |
| 806 | Calculating dependencies |
806 | Calculating dependencies |
| 807 | !!! <comment>all ebuilds that could satisfy </comment><your package><comment> have been masked.</comment> |
807 | !!! <comment>all ebuilds that could satisfy </comment><your package><comment> have been masked.</comment> |
| 808 | </pre> |
808 | </pre> |
| 809 | |
809 | |
| 810 | <p> |
810 | <p> |
| 811 | A package can be masked due to two reasons: |
811 | A package can be masked due to two reasons: |
| 812 | </p> |
812 | </p> |
| 813 | |
813 | |
| 814 | <ol> |
814 | <ol> |
| 815 | <li>The package is in <e>~ARCH</e> while you use <e>ARCH</e></li> |
815 | <li>The package is in <e>~ARCH</e> while you use <e>ARCH</e></li> |
| 816 | <li>The package is hard-masked explicitly</li> |
816 | <li>The package is hard-masked explicitly</li> |
| 817 | </ol> |
817 | </ol> |
| 818 | |
818 | |
| 819 | <p> |
819 | <p> |
| 820 | If the package is masked because of the first reason, and you <e>really</e> want |
820 | If the package is masked because of the first reason, and you <e>really</e> |
| 821 | to install it (knowing that there <e>is</e> a reason why it isn't available in |
821 | want to install it (knowing that there <e>is</e> a reason why it isn't |
| 822 | <e>ARCH</e>), you can temporarily accept <e>~ARCH</e> packages: |
822 | available in <e>ARCH</e>), you can accept the <e>~ARCH</e> version of any |
|
|
823 | package by adding it to your <path>/etc/portage/package.keywords</path> file: |
| 823 | </p> |
824 | </p> |
| 824 | |
825 | |
| 825 | <pre caption="Temporarily accepting ~ARCH packages"> |
826 | <pre caption="Accepting the ~ARCH version of a package"> |
| 826 | # <i>ACCEPT_KEYWORDS="~x86" emerge gnumeric</i> |
827 | # <i>echo "app-office/gnumeric ~x86" >> /etc/portage/package.keywords</i> |
|
|
828 | # <i>emerge gnumeric</i> |
| 827 | </pre> |
829 | </pre> |
| 828 | |
830 | |
| 829 | <p> |
831 | <p> |
| 830 | A package is hardmasked if it is listed in |
832 | A package is hardmasked if it is listed in |
| 831 | <path>/usr/portage/profiles/package.mask</path>. If you read this file, you |
833 | <path>/usr/portage/profiles/package.mask</path>. If you read this file, you |
| 832 | will also read the reason why the package is hardmasked (it is usually added as |
834 | will also read the reason why the package is hardmasked (it is usually added as |
| 833 | a comment). If you want to install the package nevertheless (despite all the |
835 | a comment). If you want to install the package nevertheless (despite all the |
| 834 | possible warnings we could ever throw at your head about "breaking your system", |
836 | possible warnings we could ever throw at your head about "breaking your system", |
| 835 | "breaks other packages", or "badly needs testing"), create the |
837 | "breaks other packages", or "badly needs testing"), create the |
| 836 | <path>/etc/portage/package.unmask</path> file and list the package in it (use |
838 | <path>/etc/portage/package.unmask</path> file and list the package in it (use |
| 837 | the same format as is used in <path>/usr/portage/profiles/package.mask</path>). |
839 | the same format as is used in <path>/usr/portage/profiles/package.mask</path>). |
| 838 | </p> |
840 | </p> |
| 839 | |
841 | |
| 840 | <p> |
842 | <p> |
| 841 | Do <e>not</e> alter the <path>/usr/portage/profiles/package.mask</path> file as |
843 | Do <e>not</e> alter the <path>/usr/portage/profiles/package.mask</path> file as |