1 |
nightmorph 10/03/03 00:36:42 |
2 |
|
3 |
Modified: hb-working-portage.xml |
4 |
Log: |
5 |
Wrote some stuff on ACCEPT_LICENSE, prompted by bug 292445 |
6 |
|
7 |
Revision Changes Path |
8 |
1.74 xml/htdocs/doc/en/handbook/hb-working-portage.xml |
9 |
|
10 |
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&view=markup |
11 |
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.74&content-type=text/plain |
12 |
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.73&r2=1.74 |
13 |
|
14 |
Index: hb-working-portage.xml |
15 |
=================================================================== |
16 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v |
17 |
retrieving revision 1.73 |
18 |
retrieving revision 1.74 |
19 |
diff -u -r1.73 -r1.74 |
20 |
--- hb-working-portage.xml 13 Feb 2010 20:54:07 -0000 1.73 |
21 |
+++ hb-working-portage.xml 3 Mar 2010 00:36:42 -0000 1.74 |
22 |
@@ -4,7 +4,7 @@ |
23 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
24 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
25 |
|
26 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.73 2010/02/13 20:54:07 nightmorph Exp $ --> |
27 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.74 2010/03/03 00:36:42 nightmorph Exp $ --> |
28 |
|
29 |
<sections> |
30 |
|
31 |
@@ -13,8 +13,8 @@ |
32 |
maintain the software on his system. |
33 |
</abstract> |
34 |
|
35 |
-<version>1.66</version> |
36 |
-<date>2010-02-13</date> |
37 |
+<version>1.67</version> |
38 |
+<date>2010-03-02</date> |
39 |
|
40 |
<section> |
41 |
<title>Welcome to Portage</title> |
42 |
@@ -370,6 +370,96 @@ |
43 |
</body> |
44 |
</subsection> |
45 |
</section> |
46 |
+<section id="license"> |
47 |
+<title>Licenses</title> |
48 |
+<subsection> |
49 |
+<body> |
50 |
+ |
51 |
+<p> |
52 |
+Beginning with Portage version 2.1.7, you can accept or reject software |
53 |
+installation based on its license. All packages in the tree contain a |
54 |
+<c>LICENSE</c> entry in their ebuilds. Running <c>emerge --search |
55 |
+packagename</c> will tell you the package's license. |
56 |
+</p> |
57 |
+ |
58 |
+<p> |
59 |
+By default, Portage permits all licenses, except End User License Agreements |
60 |
+(EULAs) that require reading and signing an acceptance agreement. |
61 |
+</p> |
62 |
+ |
63 |
+<p> |
64 |
+The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which |
65 |
+can be set in <path>/etc/make.conf</path>: |
66 |
+</p> |
67 |
+ |
68 |
+<pre caption="Default ACCEPT_LICENSE in /etc/make.conf"> |
69 |
+ACCEPT_LICENSE="* -@EULA" |
70 |
+</pre> |
71 |
+ |
72 |
+<p> |
73 |
+With this configuration, packages that require interaction during installation |
74 |
+to approve their EULA <e>will not</e> be installed. Packages without an EULA |
75 |
+<e>will</e> be installed. |
76 |
+</p> |
77 |
+ |
78 |
+<p> |
79 |
+You can set <c>ACCEPT_LICENSE</c> globally in <path>/etc/make.conf</path>, or |
80 |
+you can specify it on a per-package basis in |
81 |
+<path>/etc/portage/package.license</path>. |
82 |
+</p> |
83 |
+ |
84 |
+<p> |
85 |
+For example, if you want to allow the <c>truecrypt-2.7</c> license for |
86 |
+<c>app-crypt/truecrypt</c>, add the following to |
87 |
+<path>/etc/portage/package.license</path>: |
88 |
+</p> |
89 |
+ |
90 |
+<pre caption="Specifying a truecrypt license in package.license"> |
91 |
+app-crypt/truecrypt truecrypt-2.7 |
92 |
+</pre> |
93 |
+ |
94 |
+<p> |
95 |
+This permits installation of truecrypt versions that have the |
96 |
+<c>truecrypt-2.7</c> license, but not versions with the <c>truecrypt-2.8</c> |
97 |
+license. |
98 |
+</p> |
99 |
+ |
100 |
+<impo> |
101 |
+Licenses are stored in <path>/usr/portage/licenses</path>, and license groups |
102 |
+are kept in <path>/usr/portage/license_groups</path>. The first entry of each |
103 |
+line in CAPITAL letters is the name of the license group, and every entry after |
104 |
+that is an individual license. |
105 |
+</impo> |
106 |
+ |
107 |
+<p> |
108 |
+License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b> |
109 |
+sign. Here's an example of a system that globally permits the GPL-compatible |
110 |
+license group, as well as a few other groups and individual licenses: |
111 |
+</p> |
112 |
+ |
113 |
+<pre caption="ACCEPT_LICENSE in /etc/make.conf"> |
114 |
+ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera" |
115 |
+</pre> |
116 |
+ |
117 |
+<p> |
118 |
+If you want only free software and documentation on your system, you might use |
119 |
+the following setup: |
120 |
+</p> |
121 |
+ |
122 |
+<pre caption="Use only free licenses"> |
123 |
+ACCEPT_LICENSE="-* @FREE" |
124 |
+</pre> |
125 |
+ |
126 |
+<p> |
127 |
+In this case, "free" is mostly defined by the <uri |
128 |
+link="http://www.gnu.org/philosophy/free-sw.html">FSF</uri> and <uri |
129 |
+link="http://www.opensource.org/docs/osd">OSI</uri>. Any package whose license |
130 |
+does not meet these requirements will not be installed on your system. |
131 |
+</p> |
132 |
+ |
133 |
+</body> |
134 |
+</subsection> |
135 |
+</section> |
136 |
<section> |
137 |
<title>When Portage is Complaining...</title> |
138 |
<subsection> |
139 |
@@ -491,6 +581,7 @@ |
140 |
- dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>) |
141 |
- games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>) |
142 |
- sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>) |
143 |
+- net-im/skype-2.1.0.81 (masked by: skype-eula <i>license</i>(s)) |
144 |
</pre> |
145 |
|
146 |
<p> |
147 |
@@ -525,6 +616,13 @@ |
148 |
profile. The application might break your system if you installed it or is |
149 |
just not compatible with the profile you use. |
150 |
</li> |
151 |
+ <li> |
152 |
+ <b>license</b> means that the package's license is not compatible with your |
153 |
+ <c>ACCEPT_LICENSE</c> setting. You must explicitly permit its license or |
154 |
+ license group by setting it in <path>/etc/make.conf</path> or in |
155 |
+ <path>/etc/portage/package.license</path>. Refer to <uri |
156 |
+ link="#license">Licenses</uri> to learn how licenses work. |
157 |
+ </li> |
158 |
</ul> |
159 |
|
160 |
</body> |