/[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.10 Revision 1.13
1<!-- The content of this document is licensed under the CC-BY-SA license --> 1<!-- The content of this document is licensed under the CC-BY-SA license -->
2<!-- See http://creativecommons.org/licenses/by-sa/1.0 --> 2<!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
3 3
4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.10 2003/11/30 12:49:20 swift Exp $ --> 4<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.13 2003/12/04 22:26:19 swift Exp $ -->
5 5
6<sections> 6<sections>
7<section> 7<section>
8<title>Obtaining Package Information</title> 8<title>Obtaining Package Information</title>
9<subsection> 9<subsection>
12 12
13<p> 13<p>
14The main Portage tool that most users will use is <c>emerge</c>. We have already 14The main Portage tool that most users will use is <c>emerge</c>. We have already
15used it during the Gentoo installation and in the previous chapter, but we just 15used it during the Gentoo installation and in the previous chapter, but we just
16briefly explained how to use it. This chapter will elaborate on <c>emerge</c> 16briefly explained how to use it. This chapter will elaborate on <c>emerge</c>
17and learn you how to use <c>emerge</c> to fix all your software-related needs. 17and teach you how to use <c>emerge</c> to fix all your software-related needs.
18</p> 18</p>
19 19
20<p> 20<p>
21<c>emerge</c> is the command used to install, remove, query and maintain 21<c>emerge</c> is the command used to install, remove, query and maintain
22software packages. It is a front-end for <c>ebuild</c>; people interested in 22software packages. It is a front-end for <c>ebuild</c>; people interested in
103gnofin/ khacc/ mrproject/ phprojekt/ texmacs/ 103gnofin/ khacc/ mrproject/ phprojekt/ texmacs/
104</pre> 104</pre>
105 105
106<p> 106<p>
107Inside a category you will find the packages belonging to that category, with a 107Inside a category you will find the packages belonging to that category, with a
108seperate directory for each package. Let us take a look at the <c>openoffice</c> 108separate directory for each package. Let us take a look at the <c>openoffice</c>
109package: 109package:
110</p> 110</p>
111 111
112<pre caption="Viewing a package"> 112<pre caption="Viewing a package">
113# <i>cd openoffice; ls --classify</i> 113# <i>cd openoffice; ls --classify</i>
517 517
518 518
519</body> 519</body>
520</subsection> 520</subsection>
521<subsection> 521<subsection>
522<title>Working with Dependencies</title>
523<body>
524
525<p>
526Portage has an extensive support for dependency handling. Although you usually
527don't need to even think about this (as dependencies are automatically handled
528by Portage) some users might want to know how you can work with <c>emerge</c>
529and dependencies.
530</p>
531
532<p>
533For instance, if you want Portage to pretend that none of the dependencies of a
534package are installed, you can use <c>--emptytree</c> (<c>-e</c> in short). This
535is useful with <c>--pretend</c> to display a complete tree of dependencies for
536any particular package. Without <c>--pretend</c>, <c>emerge</c> will (re)compile
537all listed packages. However, <c>glibc</c> will <e>not</e> be listed as
538dependency for safety reasons.
539</p>
540
541<pre caption="Show all dependencies of gnumeric">
542# <i>emerge --emptytree --pretend gnumeric</i>
543</pre>
544
545<p>
546Another argument is <c>--nodeps</c>, which will ask Portage to try install the
547given package without taking care of the dependencies. It is trivial that this
548can lead to failures.
549</p>
550
551<pre caption="Installing gnumeric without taking care of the dependencies">
552# <i>emerge --nodeps gnumeric</i>
553</pre>
554
555<p>
556To opposite of <c>--nodeps</c> is <c>--onlydeps</c>, which will have Portage
557install all dependencies of a given package, but not the package itself:
558</p>
559
560<pre caption="Installing the dependencies of gnumeric">
561# <i>emerge --onlydeps gnumeric</i>
562</pre>
563
564</body>
565</subsection>
566<subsection>
522<title>Updating your System</title> 567<title>Updating your System</title>
523<body> 568<body>
524 569
525<p> 570<p>
526Portage knows two special tags to denote a set of software packages: 571Portage knows two special tags to denote a set of software packages:
649Portage doesn't verify if a package is a dependency for another 694Portage doesn't verify if a package is a dependency for another
650installed package. It also doesn't warn you if the package is part of 695installed package. It also doesn't warn you if the package is part of
651<e>system</e>, i.e. a core application necessary for the correct functioning of 696<e>system</e>, i.e. a core application necessary for the correct functioning of
652your system! 697your system!
653</warn> 698</warn>
699
700<p>
701Once the unmerge begins you will see a long list of filenames belonging to the
702package. Some of these filenames will have a flag displayed to the
703left of the filename. The flags <c>!mtime</c>, <c>!empty</c>, and <c>cfgpro</c>
704specify reasons why certain files are not being removed while the package is.
705Files listed without any of these three flags are removed from the
706filesystem successfully. The three flags specify the following reasons:
707</p>
708
709<ul>
710 <li>
711 <c>!mtime</c> : The listed file has been changed since it was installed,
712 probably by you or some tool
713 </li>
714 <li>
715 <c>!empty</c> : The listed directory is not empty
716 </li>
717 <li>
718 <c>cfgpro</c> : Another already installed package claims to own this file
719 </li>
720</ul>
654 721
655</body> 722</body>
656</subsection> 723</subsection>
657</section> 724</section>
658<section> 725<section>

Legend:
Removed from v.1.10  
changed lines
  Added in v.1.13

  ViewVC Help
Powered by ViewVC 1.1.20