/[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.73 Revision 1.74
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/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.74 2010/03/03 00:36:42 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12This chapter explains the "simple" steps a user definitely needs to know to 12This chapter explains the "simple" steps a user definitely needs to know to
13maintain the software on his system. 13maintain the software on his system.
14</abstract> 14</abstract>
15 15
16<version>1.66</version> 16<version>1.67</version>
17<date>2010-02-13</date> 17<date>2010-03-02</date>
18 18
19<section> 19<section>
20<title>Welcome to Portage</title> 20<title>Welcome to Portage</title>
21<body> 21<body>
22 22
368</pre> 368</pre>
369 369
370</body> 370</body>
371</subsection> 371</subsection>
372</section> 372</section>
373<section id="license">
374<title>Licenses</title>
375<subsection>
376<body>
377
378<p>
379Beginning with Portage version 2.1.7, you can accept or reject software
380installation based on its license. All packages in the tree contain a
381<c>LICENSE</c> entry in their ebuilds. Running <c>emerge --search
382packagename</c> will tell you the package's license.
383</p>
384
385<p>
386By default, Portage permits all licenses, except End User License Agreements
387(EULAs) that require reading and signing an acceptance agreement.
388</p>
389
390<p>
391The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which
392can be set in <path>/etc/make.conf</path>:
393</p>
394
395<pre caption="Default ACCEPT_LICENSE in /etc/make.conf">
396ACCEPT_LICENSE="* -@EULA"
397</pre>
398
399<p>
400With this configuration, packages that require interaction during installation
401to approve their EULA <e>will not</e> be installed. Packages without an EULA
402<e>will</e> be installed.
403</p>
404
405<p>
406You can set <c>ACCEPT_LICENSE</c> globally in <path>/etc/make.conf</path>, or
407you can specify it on a per-package basis in
408<path>/etc/portage/package.license</path>.
409</p>
410
411<p>
412For example, if you want to allow the <c>truecrypt-2.7</c> license for
413<c>app-crypt/truecrypt</c>, add the following to
414<path>/etc/portage/package.license</path>:
415</p>
416
417<pre caption="Specifying a truecrypt license in package.license">
418app-crypt/truecrypt truecrypt-2.7
419</pre>
420
421<p>
422This permits installation of truecrypt versions that have the
423<c>truecrypt-2.7</c> license, but not versions with the <c>truecrypt-2.8</c>
424license.
425</p>
426
427<impo>
428Licenses are stored in <path>/usr/portage/licenses</path>, and license groups
429are kept in <path>/usr/portage/license_groups</path>. The first entry of each
430line in CAPITAL letters is the name of the license group, and every entry after
431that is an individual license.
432</impo>
433
434<p>
435License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b>
436sign. Here's an example of a system that globally permits the GPL-compatible
437license group, as well as a few other groups and individual licenses:
438</p>
439
440<pre caption="ACCEPT_LICENSE in /etc/make.conf">
441ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera"
442</pre>
443
444<p>
445If you want only free software and documentation on your system, you might use
446the following setup:
447</p>
448
449<pre caption="Use only free licenses">
450ACCEPT_LICENSE="-* @FREE"
451</pre>
452
453<p>
454In this case, "free" is mostly defined by the <uri
455link="http://www.gnu.org/philosophy/free-sw.html">FSF</uri> and <uri
456link="http://www.opensource.org/docs/osd">OSI</uri>. Any package whose license
457does not meet these requirements will not be installed on your system.
458</p>
459
460</body>
461</subsection>
462</section>
373<section> 463<section>
374<title>When Portage is Complaining...</title> 464<title>When Portage is Complaining...</title>
375<subsection> 465<subsection>
376<title>About SLOTs, Virtuals, Branches, Architectures and Profiles</title> 466<title>About SLOTs, Virtuals, Branches, Architectures and Profiles</title>
377<body> 467<body>
489- lm-sensors/lm-sensors-2.8.7 (masked by: <i>-sparc keyword</i>) 579- lm-sensors/lm-sensors-2.8.7 (masked by: <i>-sparc keyword</i>)
490- sys-libs/glibc-2.3.4.20040808 (masked by: <i>-* keyword</i>) 580- sys-libs/glibc-2.3.4.20040808 (masked by: <i>-* keyword</i>)
491- dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>) 581- dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>)
492- games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>) 582- games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>)
493- sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>) 583- sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>)
584- net-im/skype-2.1.0.81 (masked by: skype-eula <i>license</i>(s))
494</pre> 585</pre>
495 586
496<p> 587<p>
497When you want to install a package that isn't available for your system, you 588When you want to install a package that isn't available for your system, you
498will receive this masking error. You should try installing a different 589will receive this masking error. You should try installing a different
523 <li> 614 <li>
524 <b>profile</b> means that the package has been found not suitable for your 615 <b>profile</b> means that the package has been found not suitable for your
525 profile. The application might break your system if you installed it or is 616 profile. The application might break your system if you installed it or is
526 just not compatible with the profile you use. 617 just not compatible with the profile you use.
527 </li> 618 </li>
619 <li>
620 <b>license</b> means that the package's license is not compatible with your
621 <c>ACCEPT_LICENSE</c> setting. You must explicitly permit its license or
622 license group by setting it in <path>/etc/make.conf</path> or in
623 <path>/etc/portage/package.license</path>. Refer to <uri
624 link="#license">Licenses</uri> to learn how licenses work.
625 </li>
528</ul> 626</ul>
529 627
530</body> 628</body>
531</subsection> 629</subsection>
532<subsection id="missingdependencies"> 630<subsection id="missingdependencies">

Legend:
Removed from v.1.73  
changed lines
  Added in v.1.74

  ViewVC Help
Powered by ViewVC 1.1.20