nightmorph 10/03/03 00:36:42 Modified: hb-working-portage.xml Log: Wrote some stuff on ACCEPT_LICENSE, prompted by bug 292445
Revision Changes Path 1.74 xml/htdocs/doc/en/handbook/hb-working-portage.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.73&r2=1.74 Index: hb-working-portage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v retrieving revision 1.73 retrieving revision 1.74 diff -u -r1.73 -r1.74 --- hb-working-portage.xml 13 Feb 2010 20:54:07 -0000 1.73 +++ hb-working-portage.xml 3 Mar 2010 00:36:42 -0000 1.74 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.74 2010/03/03 00:36:42 nightmorph Exp $ --> <sections> @@ -13,8 +13,8 @@ maintain the software on his system. </abstract> -<version>1.66</version> -<date>2010-02-13</date> +<version>1.67</version> +<date>2010-03-02</date> <section> <title>Welcome to Portage</title> @@ -370,6 +370,96 @@ </body> </subsection> </section> +<section id="license"> +<title>Licenses</title> +<subsection> +<body> + +<p> +Beginning with Portage version 2.1.7, you can accept or reject software +installation based on its license. All packages in the tree contain a +<c>LICENSE</c> entry in their ebuilds. Running <c>emerge --search +packagename</c> will tell you the package's license. +</p> + +<p> +By default, Portage permits all licenses, except End User License Agreements +(EULAs) that require reading and signing an acceptance agreement. +</p> + +<p> +The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which +can be set in <path>/etc/make.conf</path>: +</p> + +<pre caption="Default ACCEPT_LICENSE in /etc/make.conf"> +ACCEPT_LICENSE="* -...@eula" +</pre> + +<p> +With this configuration, packages that require interaction during installation +to approve their EULA <e>will not</e> be installed. Packages without an EULA +<e>will</e> be installed. +</p> + +<p> +You can set <c>ACCEPT_LICENSE</c> globally in <path>/etc/make.conf</path>, or +you can specify it on a per-package basis in +<path>/etc/portage/package.license</path>. +</p> + +<p> +For example, if you want to allow the <c>truecrypt-2.7</c> license for +<c>app-crypt/truecrypt</c>, add the following to +<path>/etc/portage/package.license</path>: +</p> + +<pre caption="Specifying a truecrypt license in package.license"> +app-crypt/truecrypt truecrypt-2.7 +</pre> + +<p> +This permits installation of truecrypt versions that have the +<c>truecrypt-2.7</c> license, but not versions with the <c>truecrypt-2.8</c> +license. +</p> + +<impo> +Licenses are stored in <path>/usr/portage/licenses</path>, and license groups +are kept in <path>/usr/portage/license_groups</path>. The first entry of each +line in CAPITAL letters is the name of the license group, and every entry after +that is an individual license. +</impo> + +<p> +License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b> +sign. Here's an example of a system that globally permits the GPL-compatible +license group, as well as a few other groups and individual licenses: +</p> + +<pre caption="ACCEPT_LICENSE in /etc/make.conf"> +ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera" +</pre> + +<p> +If you want only free software and documentation on your system, you might use +the following setup: +</p> + +<pre caption="Use only free licenses"> +ACCEPT_LICENSE="-* @FREE" +</pre> + +<p> +In this case, "free" is mostly defined by the <uri +link="http://www.gnu.org/philosophy/free-sw.html";>FSF</uri> and <uri +link="http://www.opensource.org/docs/osd";>OSI</uri>. Any package whose license +does not meet these requirements will not be installed on your system. +</p> + +</body> +</subsection> +</section> <section> <title>When Portage is Complaining...</title> <subsection> @@ -491,6 +581,7 @@ - dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>) - games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>) - sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>) +- net-im/skype-2.1.0.81 (masked by: skype-eula <i>license</i>(s)) </pre> <p> @@ -525,6 +616,13 @@ profile. The application might break your system if you installed it or is just not compatible with the profile you use. </li> + <li> + <b>license</b> means that the package's license is not compatible with your + <c>ACCEPT_LICENSE</c> setting. You must explicitly permit its license or + license group by setting it in <path>/etc/make.conf</path> or in + <path>/etc/portage/package.license</path>. Refer to <uri + link="#license">Licenses</uri> to learn how licenses work. + </li> </ul> </body>
