/[gentoo]/xml/htdocs/doc/en/handbook/hb-working-portage.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-working-portage.xml

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

Revision 1.28 Revision 1.29
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.28 2004/07/26 11:41:23 swift Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.29 2004/08/01 13:08:35 swift 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>
17The main Portage tool that most users will use is <c>emerge</c>. We have already 17The main Portage tool that most users will use is <c>emerge</c>. We have already
18used it during the Gentoo installation and in the previous chapter, but we just 18used it during the Gentoo installation and in the previous chapter, but we just
19briefly explained how to use it. This chapter will elaborate on <c>emerge</c> 19briefly explained how to use it. This chapter will elaborate on <c>emerge</c>
20and teach you how to use <c>emerge</c> to fix all your software-related needs. 20and teach you how to use <c>emerge</c> to fix all your software-related needs.
21</p> 21</p>
22 22
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>
820If the package is masked because of the first reason, and you <e>really</e> 820If the package is masked because of the first reason, and you <e>really</e>
821want to install it (knowing that there <e>is</e> a reason why it isn't 821want to install it (knowing that there <e>is</e> a reason why it isn't
822available in <e>ARCH</e>), you can accept the <e>~ARCH</e> version of any 822available in <e>ARCH</e>), you can accept the <e>~ARCH</e> version of any
823package by adding it to your <path>/etc/portage/package.keywords</path> file: 823package by adding it to your <path>/etc/portage/package.keywords</path> file:
824</p> 824</p>
825 825
826<pre caption="Accepting the ~ARCH version of a package"> 826<pre caption="Accepting the ~ARCH version of a package">
827<comment>(Create the /etc/portage directory if it doesn't exist yet)</comment>
828# <i>mkdir /etc/portage</i>
829
827# <i>echo "app-office/gnumeric ~x86" &gt;&gt; /etc/portage/package.keywords</i> 830# <i>echo "app-office/gnumeric ~x86" &gt;&gt; /etc/portage/package.keywords</i>
828# <i>emerge gnumeric</i> 831# <i>emerge gnumeric</i>
829</pre> 832</pre>
830 833
831<p> 834<p>
832A package is hardmasked if it is listed in 835A package is hardmasked if it is listed in
833<path>/usr/portage/profiles/package.mask</path>. If you read this file, you 836<path>/usr/portage/profiles/package.mask</path>. If you read this file, you
834will also read the reason why the package is hardmasked (it is usually added as 837will also read the reason why the package is hardmasked (it is usually added as
835a comment). If you want to install the package nevertheless (despite all the 838a comment). If you want to install the package nevertheless (despite all the
836possible warnings we could ever throw at your head about "breaking your system", 839possible warnings we could ever throw at your head about "breaking your system",
837"breaks other packages", or "badly needs testing"), create the 840"breaks other packages", or "badly needs testing"), create the
838<path>/etc/portage/package.unmask</path> file and list the package in it (use 841<path>/etc/portage/package.unmask</path> file and list the package in it (use
839the same format as is used in <path>/usr/portage/profiles/package.mask</path>). 842the same format as is used in <path>/usr/portage/profiles/package.mask</path>).
840</p> 843</p>
841 844
845<pre caption="Unmasking a hard-masked application">
846<comment>(Create the /etc/portage directory if it doesn't exist yet)</comment>
847# <i>mkdir /etc/portage</i>
848
849# <i>echo "=app-office/gnumeric-1.2.12" &gt;&gt; /etc/portage/package.unmask</i>
850</pre>
851
842<p> 852<p>
843Do <e>not</e> alter the <path>/usr/portage/profiles/package.mask</path> file as 853Do <e>not</e> alter the <path>/usr/portage/profiles/package.mask</path> file as
844all changes are undone the next time you update your Portage tree. If you want 854all changes are undone the next time you update your Portage tree.
855</p>
856
857<p>
858Sometimes you might want to hardmask a (collection of) package(s). This is the
859case when newer versions of an application don't support something you require
860or when these versions break something else in your environment.
861</p>
862
863<p>
845to hardmask a package create <path>/etc/portage/package.mask</path> and list the 864To hard-mask a package, create <path>/etc/portage/package.mask</path> and list the
846package in it (use the same format as mentioned above). 865package in it (use the same format as mentioned above).
847</p> 866</p>
848 867
849<!-- 868<pre caption="Hard-masking a package">
850<p> 869<comment>(Create the /etc/portage directory if it doesn't exist yet)</comment>
851Another trick to circumvent the "masked package" problem is to install the 870# <i>mkdir /etc/portage</i>
852package using the full path. This will ignore both the <c>ACCEPT_KEYWORD</c> 871
853settings and the <path>package.mask</path> listing. 872# <i>echo "&gt;app-office/gnumeric-1.2.10" &gt;&gt; /etc/portage/package.mask</i>
854</p> 873</pre>
855
856<pre caption="Installing a package without checking for stadium / masking">
857# <i>emerge /usr/portage/app-office/gnumeric/gnumeric-1.2.0.ebuild</i>
858</pre>
859-->
860 874
861</body> 875</body>
862</subsection> 876</subsection>
863<subsection> 877<subsection>
864<title>Blocked Packages</title> 878<title>Blocked Packages</title>
865<body> 879<body>
866 880
867<p> 881<p>
868You have a situation when you receive the following error on your screen: 882You have a situation when you receive the following error on your screen:
869</p> 883</p>
870 884
871<pre caption="Blocking package"> 885<pre caption="Blocking package">
872[blocks B ] gnome-base/bonobo-activation (from pkg gnome-base/libbonobo-2.4.0) 886[blocks B ] gnome-base/bonobo-activation (from pkg gnome-base/libbonobo-2.4.0)
873</pre> 887</pre>
874 888

Legend:
Removed from v.1.28  
changed lines
  Added in v.1.29

  ViewVC Help
Powered by ViewVC 1.1.20