| 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/2.0 --> |
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.51 2005/05/17 14:39:26 neysx Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.80 2012/07/24 12:12:52 swift Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
|
|
11 | <abstract> |
|
|
12 | This chapter explains the "simple" steps a user definitely needs to know to |
|
|
13 | maintain the software on his system. |
|
|
14 | </abstract> |
|
|
15 | |
| 11 | <version>1.46</version> |
16 | <version>6</version> |
| 12 | <date>2005-05-17</date> |
17 | <date>2012-07-24</date> |
| 13 | |
18 | |
| 14 | <section> |
19 | <section> |
| 15 | <title>Welcome to Portage</title> |
20 | <title>Welcome to Portage</title> |
| 16 | <body> |
21 | <body> |
| 17 | |
22 | |
| … | |
… | |
| 85 | </p> |
90 | </p> |
| 86 | |
91 | |
| 87 | <pre caption="Running emerge-webrsync"> |
92 | <pre caption="Running emerge-webrsync"> |
| 88 | # <i>emerge-webrsync</i> |
93 | # <i>emerge-webrsync</i> |
| 89 | </pre> |
94 | </pre> |
|
|
95 | |
|
|
96 | <p> |
|
|
97 | An additional advantage of using <c>emerge-webrsync</c> is that it allows the |
|
|
98 | administrator to only pull in portage tree snapshots that are signed by the |
|
|
99 | Gentoo release engineering GPG key. More information on this can be found |
|
|
100 | in the <uri link="?part=2&chap=3">Portage Features</uri> section on |
|
|
101 | <uri link="?part=2&chap=3#webrsync-gpg">Fetching Validated Portage Tree |
|
|
102 | Snapshots</uri>. |
|
|
103 | </p> |
| 90 | |
104 | |
| 91 | </body> |
105 | </body> |
| 92 | </subsection> |
106 | </subsection> |
| 93 | </section> |
107 | </section> |
| 94 | <section> |
108 | <section> |
| … | |
… | |
| 178 | </pre> |
192 | </pre> |
| 179 | |
193 | |
| 180 | </body> |
194 | </body> |
| 181 | </subsection> |
195 | </subsection> |
| 182 | <subsection> |
196 | <subsection> |
|
|
197 | <title>Finding Installed Package Documentation</title> |
|
|
198 | <body> |
|
|
199 | |
|
|
200 | <p> |
|
|
201 | Many packages come with their own documentation. Sometimes, the <c>doc</c> USE |
|
|
202 | flag determines whether the package documentation should be installed or not. |
|
|
203 | You can check the existence of a <c>doc</c> USE flag with the <c>emerge -vp |
|
|
204 | <package name></c> command. |
|
|
205 | </p> |
|
|
206 | |
|
|
207 | <pre caption="Checking the existence of a doc USE flag"> |
|
|
208 | <comment>(alsa-lib is just an example, of course.)</comment> |
|
|
209 | # <i>emerge -vp alsa-lib</i> |
|
|
210 | [ebuild N ] media-libs/alsa-lib-1.0.14_rc1 -debug +doc 698 kB |
|
|
211 | </pre> |
|
|
212 | |
|
|
213 | <p> |
|
|
214 | The best way of enabling the <c>doc</c> USE flag is doing it on a per-package |
|
|
215 | basis via <path>/etc/portage/package.use</path>, so that you get documentation |
|
|
216 | only for packages that you are interested in. Enabling this flag globally is |
|
|
217 | known to cause problems with circular dependencies. For more information, please |
|
|
218 | read the <uri link="?part=2&chap=2">USE Flags</uri> chapter. |
|
|
219 | </p> |
|
|
220 | |
|
|
221 | <p> |
|
|
222 | Once the package installed, its documentation is generally found in a |
|
|
223 | subdirectory named after the package under the <path>/usr/share/doc</path> |
|
|
224 | directory. You can also list all installed files with the <c>equery</c> tool |
|
|
225 | which is part of the <c>app-portage/gentoolkit</c> <uri |
|
|
226 | link="/doc/en/gentoolkit.xml">package</uri>. |
|
|
227 | </p> |
|
|
228 | |
|
|
229 | <pre caption="Locating package documentation"> |
|
|
230 | # <i>ls -l /usr/share/doc/alsa-lib-1.0.14_rc1</i> |
|
|
231 | total 28 |
|
|
232 | -rw-r--r-- 1 root root 669 May 17 21:54 ChangeLog.gz |
|
|
233 | -rw-r--r-- 1 root root 9373 May 17 21:54 COPYING.gz |
|
|
234 | drwxr-xr-x 2 root root 8560 May 17 21:54 html |
|
|
235 | -rw-r--r-- 1 root root 196 May 17 21:54 TODO.gz |
|
|
236 | |
|
|
237 | <comment>(Alternatively, use equery to locate interesting files:)</comment> |
|
|
238 | # <i>equery files alsa-lib | less</i> |
|
|
239 | media-libs/alsa-lib-1.0.14_rc1 |
|
|
240 | * Contents of media-libs/alsa-lib-1.0.14_rc1: |
|
|
241 | /usr |
|
|
242 | /usr/bin |
|
|
243 | /usr/bin/alsalisp |
|
|
244 | <comment>(Output truncated)</comment> |
|
|
245 | </pre> |
|
|
246 | |
|
|
247 | </body> |
|
|
248 | </subsection> |
|
|
249 | <subsection> |
| 183 | <title>Removing Software</title> |
250 | <title>Removing Software</title> |
| 184 | <body> |
251 | <body> |
| 185 | |
252 | |
| 186 | <p> |
253 | <p> |
| 187 | When you want to remove a software package from your system, use <c>emerge |
254 | When you want to remove a software package from your system, use <c>emerge |
| … | |
… | |
| 220 | <p> |
287 | <p> |
| 221 | To keep your system in perfect shape (and not to mention install the latest |
288 | To keep your system in perfect shape (and not to mention install the latest |
| 222 | security updates) you need to update your system regularly. Since Portage only |
289 | security updates) you need to update your system regularly. Since Portage only |
| 223 | checks the ebuilds in your Portage tree you first have to update your Portage |
290 | checks the ebuilds in your Portage tree you first have to update your Portage |
| 224 | tree. When your Portage tree is updated, you can update your system with |
291 | tree. When your Portage tree is updated, you can update your system with |
| 225 | <c>emerge --update world</c>: |
292 | <c>emerge --update world</c>. In the next example, we'll also use the |
|
|
293 | <c>--ask</c> switch which will tell Portage to display the list of packages it |
|
|
294 | wants to upgrade and ask you if you want to continue: |
| 226 | </p> |
295 | </p> |
| 227 | |
296 | |
| 228 | <pre caption="Updating your system"> |
297 | <pre caption="Updating your system"> |
| 229 | # <i>emerge --update world</i> |
298 | # <i>emerge --update --ask world</i> |
| 230 | </pre> |
299 | </pre> |
| 231 | |
300 | |
| 232 | <p> |
301 | <p> |
| 233 | Portage will then search for newer version of the applications you have |
302 | Portage will then search for newer version of the applications you have |
| 234 | installed. However, it will only verify the versions for the applications you |
303 | installed. However, it will only verify the versions for the applications you |
| 235 | have explicitly installed - not the dependencies. If you want to update every |
304 | have <e>explicitly</e> installed (the applications listed in |
| 236 | single package on your system, add the <c>--deep</c> argument: |
305 | <path>/var/lib/portage/world</path>) - it does not thoroughly check their |
|
|
306 | dependencies. If you want to update the dependencies of those packages as well, |
|
|
307 | add the <c>--deep</c> argument: |
|
|
308 | </p> |
|
|
309 | |
|
|
310 | <pre caption="Updating your system with dependencies"> |
|
|
311 | # <i>emerge --update --deep world</i> |
|
|
312 | </pre> |
|
|
313 | |
|
|
314 | <p> |
|
|
315 | Still, this doesn't mean <e>all packages</e>: some packages on your system are |
|
|
316 | needed during the compile and build process of packages, but once that package |
|
|
317 | is installed, these dependencies are no longer required. Portage calls those |
|
|
318 | <e>build dependencies</e>. To include those in an update cycle, add |
|
|
319 | <c>--with-bdeps=y</c>: |
| 237 | </p> |
320 | </p> |
| 238 | |
321 | |
| 239 | <pre caption="Updating your entire system"> |
322 | <pre caption="Updating your entire system"> |
| 240 | # <i>emerge --update --deep world</i> |
323 | # <i>emerge --update --deep --with-bdeps=y world</i> |
|
|
324 | </pre> |
|
|
325 | |
|
|
326 | <p> |
|
|
327 | Since security updates also happen in packages you have not explicitly installed |
|
|
328 | on your system (but that are pulled in as dependencies of other programs), it |
|
|
329 | is recommended to run this command once in a while. |
| 241 | </pre> |
330 | </p> |
| 242 | |
331 | |
| 243 | <p> |
332 | <p> |
| 244 | If you have altered any of your <uri link="?part=2&chap=2">USE flags</uri> |
333 | If you have altered any of your <uri link="?part=2&chap=2">USE flags</uri> |
| 245 | lately you might want to add <c>--newuse</c> as well. Portage will then verify |
334 | lately you might want to add <c>--newuse</c> as well. Portage will then verify |
| 246 | if the change requires the installation of new packages or recompilation of |
335 | if the change requires the installation of new packages or recompilation of |
| 247 | existing ones: |
336 | existing ones: |
| 248 | </p> |
337 | </p> |
| 249 | |
338 | |
| 250 | <pre caption="Performing a full update"> |
339 | <pre caption="Performing a full update"> |
| 251 | # <i>emerge --update --deep --newuse world</i> |
340 | # <i>emerge --update --deep --with-bdeps=y --newuse world</i> |
| 252 | </pre> |
341 | </pre> |
| 253 | |
342 | |
| 254 | </body> |
343 | </body> |
| 255 | </subsection> |
344 | </subsection> |
| 256 | <subsection> |
345 | <subsection> |
| 257 | <title>Metapackages</title> |
346 | <title>Metapackages</title> |
| 258 | <body> |
347 | <body> |
| 259 | |
348 | |
| 260 | <p> |
349 | <p> |
| 261 | Some packages in the Portage tree don't have any real content but are used to |
350 | Some packages in the Portage tree don't have any real content but are used to |
| 262 | install a collection of packages. For instance, the <c>kde</c> package will |
351 | install a collection of packages. For instance, the <c>kde-meta</c> package will |
| 263 | install a complete KDE environment on your system by pulling in various |
352 | install a complete KDE environment on your system by pulling in various |
| 264 | KDE-related packages as dependencies. |
353 | KDE-related packages as dependencies. |
| 265 | </p> |
354 | </p> |
| 266 | |
355 | |
| 267 | <p> |
356 | <p> |
| … | |
… | |
| 300 | </pre> |
389 | </pre> |
| 301 | |
390 | |
| 302 | </body> |
391 | </body> |
| 303 | </subsection> |
392 | </subsection> |
| 304 | </section> |
393 | </section> |
|
|
394 | <section id="license"> |
|
|
395 | <title>Licenses</title> |
|
|
396 | <subsection> |
|
|
397 | <body> |
|
|
398 | |
|
|
399 | <p> |
|
|
400 | Beginning with Portage version 2.1.7, you can accept or reject software |
|
|
401 | installation based on its license. All packages in the tree contain a |
|
|
402 | <c>LICENSE</c> entry in their ebuilds. Running <c>emerge --search |
|
|
403 | packagename</c> will tell you the package's license. |
|
|
404 | </p> |
|
|
405 | |
|
|
406 | <p> |
|
|
407 | By default, Portage permits all licenses, except End User License Agreements |
|
|
408 | (EULAs) that require reading and signing an acceptance agreement. |
|
|
409 | </p> |
|
|
410 | |
|
|
411 | <p> |
|
|
412 | The variable that controls permitted licenses is <c>ACCEPT_LICENSE</c>, which |
|
|
413 | can be set in <path>/etc/portage/make.conf</path>: |
|
|
414 | </p> |
|
|
415 | |
|
|
416 | <pre caption="Default ACCEPT_LICENSE in /etc/portage/make.conf"> |
|
|
417 | ACCEPT_LICENSE="* -@EULA" |
|
|
418 | </pre> |
|
|
419 | |
|
|
420 | <p> |
|
|
421 | With this configuration, packages that require interaction during installation |
|
|
422 | to approve their EULA <e>will not</e> be installed. Packages without an EULA |
|
|
423 | <e>will</e> be installed. |
|
|
424 | </p> |
|
|
425 | |
|
|
426 | <p> |
|
|
427 | You can set <c>ACCEPT_LICENSE</c> globally in <path>/etc/portage/make.conf</path> |
|
|
428 | , or you can specify it on a per-package basis in |
|
|
429 | <path>/etc/portage/package.license</path>. |
|
|
430 | </p> |
|
|
431 | |
|
|
432 | <p> |
|
|
433 | For example, if you want to allow the <c>truecrypt-2.7</c> license for |
|
|
434 | <c>app-crypt/truecrypt</c>, add the following to |
|
|
435 | <path>/etc/portage/package.license</path>: |
|
|
436 | </p> |
|
|
437 | |
|
|
438 | <pre caption="Specifying a truecrypt license in package.license"> |
|
|
439 | app-crypt/truecrypt truecrypt-2.7 |
|
|
440 | </pre> |
|
|
441 | |
|
|
442 | <p> |
|
|
443 | This permits installation of truecrypt versions that have the |
|
|
444 | <c>truecrypt-2.7</c> license, but not versions with the <c>truecrypt-2.8</c> |
|
|
445 | license. |
|
|
446 | </p> |
|
|
447 | |
|
|
448 | <impo> |
|
|
449 | Licenses are stored in <path>/usr/portage/licenses</path>, and license groups |
|
|
450 | are kept in <path>/usr/portage/profiles/license_groups</path>. The first entry |
|
|
451 | of each line in CAPITAL letters is the name of the license group, and every |
|
|
452 | entry after that is an individual license. |
|
|
453 | </impo> |
|
|
454 | |
|
|
455 | <p> |
|
|
456 | License groups defined in <c>ACCEPT_LICENSE</c> are prefixed with an <b>@</b> |
|
|
457 | sign. Here's an example of a system that globally permits the GPL-compatible |
|
|
458 | license group, as well as a few other groups and individual licenses: |
|
|
459 | </p> |
|
|
460 | |
|
|
461 | <pre caption="ACCEPT_LICENSE in /etc/portage/make.conf"> |
|
|
462 | ACCEPT_LICENSE="@GPL-COMPATIBLE @OSI-APPROVED @EULA atheros-hal BitstreamVera" |
|
|
463 | </pre> |
|
|
464 | |
|
|
465 | <p> |
|
|
466 | If you want only free software and documentation on your system, you might use |
|
|
467 | the following setup: |
|
|
468 | </p> |
|
|
469 | |
|
|
470 | <pre caption="Use only free licenses"> |
|
|
471 | ACCEPT_LICENSE="-* @FREE" |
|
|
472 | </pre> |
|
|
473 | |
|
|
474 | <p> |
|
|
475 | In this case, "free" is mostly defined by the <uri |
|
|
476 | link="http://www.gnu.org/philosophy/free-sw.html">FSF</uri> and <uri |
|
|
477 | link="http://www.opensource.org/docs/osd">OSI</uri>. Any package whose license |
|
|
478 | does not meet these requirements will not be installed on your system. |
|
|
479 | </p> |
|
|
480 | |
|
|
481 | </body> |
|
|
482 | </subsection> |
|
|
483 | </section> |
| 305 | <section> |
484 | <section> |
| 306 | <title>When Portage is Complaining...</title> |
485 | <title>When Portage is Complaining...</title> |
| 307 | <subsection> |
486 | <subsection> |
| 308 | <title>About SLOTs, Virtuals, Branches, Architectures and Profiles</title> |
487 | <title>About SLOTs, Virtuals, Branches, Architectures and Profiles</title> |
| 309 | <body> |
488 | <body> |
| … | |
… | |
| 327 | There are also packages that provide the same functionality but are implemented |
506 | There are also packages that provide the same functionality but are implemented |
| 328 | differently. For instance, <c>metalogd</c>, <c>sysklogd</c> and <c>syslog-ng</c> |
507 | differently. For instance, <c>metalogd</c>, <c>sysklogd</c> and <c>syslog-ng</c> |
| 329 | are all system loggers. Applications that rely on the availability of "a system |
508 | are all system loggers. Applications that rely on the availability of "a system |
| 330 | logger" cannot depend on, for instance, <c>metalogd</c>, as the other system |
509 | logger" cannot depend on, for instance, <c>metalogd</c>, as the other system |
| 331 | loggers are as good a choice as any. Portage allows for <e>virtuals</e>: each |
510 | loggers are as good a choice as any. Portage allows for <e>virtuals</e>: each |
| 332 | system logger provides <c>virtual/syslog</c> so that applications can depend on |
511 | system logger is listed as a provider of the logging service in the |
| 333 | <c>virtual/syslog</c>. |
512 | <c>logger</c> virtual package of the <c>virtual</c> category, so that |
|
|
513 | applications can depend on the <c>virtual/logger</c> package. |
| 334 | </p> |
514 | </p> |
| 335 | |
515 | |
| 336 | <p> |
516 | <p> |
| 337 | Software in the Portage tree can reside in different branches. By default your |
517 | Software in the Portage tree can reside in different branches. By default your |
| 338 | system only accepts packages that Gentoo deems stable. Most new software titles, |
518 | system only accepts packages that Gentoo deems stable. Most new software titles, |
| … | |
… | |
| 360 | <subsection id="blocked"> |
540 | <subsection id="blocked"> |
| 361 | <title>Blocked Packages</title> |
541 | <title>Blocked Packages</title> |
| 362 | <body> |
542 | <body> |
| 363 | |
543 | |
| 364 | <pre caption="Portage warning about blocked packages (with --pretend)"> |
544 | <pre caption="Portage warning about blocked packages (with --pretend)"> |
| 365 | [blocks B ] gnome-base/bonobo-activation (from pkg gnome-base/libbonobo-2.4.0) |
545 | [blocks B ] mail-mta/ssmtp (is blocking mail-mta/postfix-2.2.2-r1) |
| 366 | </pre> |
546 | </pre> |
| 367 | |
547 | |
| 368 | <pre caption="Portage warning about blocked packages (without --pretend)"> |
548 | <pre caption="Portage warning about blocked packages (without --pretend)"> |
| 369 | !!! Error: the gnome-base/bonobo-activation package conflicts with another package. |
549 | !!! Error: the mail-mta/postfix package conflicts with another package. |
| 370 | !!! both can't be installed on the same system together. |
550 | !!! both can't be installed on the same system together. |
| 371 | !!! Please use 'emerge --pretend' to determine blockers. |
551 | !!! Please use 'emerge --pretend' to determine blockers. |
| 372 | </pre> |
552 | </pre> |
| 373 | |
553 | |
| 374 | <p> |
554 | <p> |
| … | |
… | |
| 378 | these dependencies explicitly marks a package or virtual as being <e>not</e> |
558 | these dependencies explicitly marks a package or virtual as being <e>not</e> |
| 379 | compatible, it triggers a blockage. |
559 | compatible, it triggers a blockage. |
| 380 | </p> |
560 | </p> |
| 381 | |
561 | |
| 382 | <p> |
562 | <p> |
|
|
563 | While recent versions of Portage are smart enough to work around minor blockages |
|
|
564 | without user intervention, occasionally you will need to fix it yourself, as |
|
|
565 | explained below. |
|
|
566 | </p> |
|
|
567 | |
|
|
568 | <p> |
| 383 | To fix a blockage, you can choose to not install the package or unmerge the |
569 | To fix a blockage, you can choose to not install the package or unmerge the |
| 384 | conflicting package first. In the given example, you can opt not to install |
570 | conflicting package first. In the given example, you can opt not to install |
| 385 | <c>libbonobo</c> or to remove <c>bonobo-activation</c> first. |
571 | <c>postfix</c> or to remove <c>ssmtp</c> first. |
|
|
572 | </p> |
|
|
573 | |
|
|
574 | <p> |
|
|
575 | You may also see blocking packages with specific atoms, such as |
|
|
576 | <b><</b>media-video/mplayer-1.0_rc1-r2. In this case, updating to a more |
|
|
577 | recent version of the blocking package would remove the block. |
|
|
578 | </p> |
|
|
579 | |
|
|
580 | <p> |
|
|
581 | It is also possible that two packages that are yet to be installed are blocking |
|
|
582 | each other. In this rare case, you should find out why you need to install both. |
|
|
583 | In most cases you can do with one of the packages alone. If not, please file a |
|
|
584 | bug on <uri link="http://bugs.gentoo.org">Gentoo's bugtracking system</uri>. |
| 386 | </p> |
585 | </p> |
| 387 | |
586 | |
| 388 | </body> |
587 | </body> |
| 389 | </subsection> |
588 | </subsection> |
| 390 | <subsection id="masked"> |
589 | <subsection id="masked"> |
| … | |
… | |
| 400 | |
599 | |
| 401 | - gnome-base/gnome-2.8.0_pre1 (masked by: <i>~x86 keyword</i>) |
600 | - gnome-base/gnome-2.8.0_pre1 (masked by: <i>~x86 keyword</i>) |
| 402 | - lm-sensors/lm-sensors-2.8.7 (masked by: <i>-sparc keyword</i>) |
601 | - lm-sensors/lm-sensors-2.8.7 (masked by: <i>-sparc keyword</i>) |
| 403 | - sys-libs/glibc-2.3.4.20040808 (masked by: <i>-* keyword</i>) |
602 | - sys-libs/glibc-2.3.4.20040808 (masked by: <i>-* keyword</i>) |
| 404 | - dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>) |
603 | - dev-util/cvsd-1.0.2 (masked by: <i>missing keyword</i>) |
| 405 | - media-video/ati-gatos-4.3.0 (masked by: <i>package.mask</i>) |
604 | - games-fps/unreal-tournament-451 (masked by: <i>package.mask</i>) |
| 406 | - sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>) |
605 | - sys-libs/glibc-2.3.2-r11 (masked by: <i>profile</i>) |
|
|
606 | - net-im/skype-2.1.0.81 (masked by: skype-eula <i>license</i>(s)) |
| 407 | </pre> |
607 | </pre> |
| 408 | |
608 | |
| 409 | <p> |
609 | <p> |
| 410 | When you want to install a package that isn't available for your system, you |
610 | When you want to install a package that isn't available for your system, you |
| 411 | will receive this masking error. You should try installing a different |
611 | will receive this masking error. You should try installing a different |
| … | |
… | |
| 436 | <li> |
636 | <li> |
| 437 | <b>profile</b> means that the package has been found not suitable for your |
637 | <b>profile</b> means that the package has been found not suitable for your |
| 438 | profile. The application might break your system if you installed it or is |
638 | profile. The application might break your system if you installed it or is |
| 439 | just not compatible with the profile you use. |
639 | just not compatible with the profile you use. |
| 440 | </li> |
640 | </li> |
|
|
641 | <li> |
|
|
642 | <b>license</b> means that the package's license is not compatible with your |
|
|
643 | <c>ACCEPT_LICENSE</c> setting. You must explicitly permit its license or |
|
|
644 | license group by setting it in <path>/etc/portage/make.conf</path> or in |
|
|
645 | <path>/etc/portage/package.license</path>. Refer to <uri |
|
|
646 | link="#license">Licenses</uri> to learn how licenses work. |
|
|
647 | </li> |
| 441 | </ul> |
648 | </ul> |
|
|
649 | |
|
|
650 | </body> |
|
|
651 | </subsection> |
|
|
652 | <subsection id="USEdependency"> |
|
|
653 | <title>Necessary USE Flag Changes</title> |
|
|
654 | <body> |
|
|
655 | |
|
|
656 | <pre caption="Portage warning about USE flag change requirement"> |
|
|
657 | The following USE changes are necessary to proceed: |
|
|
658 | #required by app-text/happypackage-2.0, required by happypackage (argument) |
|
|
659 | >=app-text/feelings-1.0.0 test |
|
|
660 | </pre> |
|
|
661 | |
|
|
662 | <p> |
|
|
663 | The error message might also be displayed as follows, if <c>--autounmask</c> |
|
|
664 | isn't set: |
|
|
665 | </p> |
|
|
666 | |
|
|
667 | <pre caption="Portage error about USE flag change requirement"> |
|
|
668 | emerge: there are no ebuilds built with USE flags to satisfy "app-text/feelings[test]". |
|
|
669 | !!! One of the following packages is required to complete your request: |
|
|
670 | - app-text/feelings-1.0.0 (Change USE: +test) |
|
|
671 | (dependency required by "app-text/happypackage-2.0" [ebuild]) |
|
|
672 | (dependency required by "happypackage" [argument]) |
|
|
673 | </pre> |
|
|
674 | |
|
|
675 | <p> |
|
|
676 | Such warning or error occurs when you want to install a package which not only |
|
|
677 | depends on another package, but also requires that that package is built with a |
|
|
678 | particular USE flag (or set of USE flags). In the given example, the package |
|
|
679 | <c>app-text/feelings</c> needs to be built with <c>USE="test"</c>, but this USE |
|
|
680 | flag is not set on the system. |
|
|
681 | </p> |
|
|
682 | |
|
|
683 | <p> |
|
|
684 | To resolve this, either add the requested USE flag to your global USE flags in |
|
|
685 | <path>/etc/portage/make.conf</path>, or set it for the specific package in |
|
|
686 | <path>/etc/portage/package.use</path>. |
|
|
687 | </p> |
| 442 | |
688 | |
| 443 | </body> |
689 | </body> |
| 444 | </subsection> |
690 | </subsection> |
| 445 | <subsection id="missingdependencies"> |
691 | <subsection id="missingdependencies"> |
| 446 | <title>Missing Dependencies</title> |
692 | <title>Missing Dependencies</title> |
| … | |
… | |
| 466 | <subsection id="ambiguousebuild"> |
712 | <subsection id="ambiguousebuild"> |
| 467 | <title>Ambiguous Ebuild Name</title> |
713 | <title>Ambiguous Ebuild Name</title> |
| 468 | <body> |
714 | <body> |
| 469 | |
715 | |
| 470 | <pre caption="Portage warning about ambiguous ebuild names"> |
716 | <pre caption="Portage warning about ambiguous ebuild names"> |
|
|
717 | [ Results for search key : listen ] |
|
|
718 | [ Applications found : 2 ] |
|
|
719 | |
|
|
720 | * dev-tinyos/listen [ Masked ] |
|
|
721 | Latest version available: 1.1.15 |
|
|
722 | Latest version installed: [ Not Installed ] |
|
|
723 | Size of files: 10,032 kB |
|
|
724 | Homepage: http://www.tinyos.net/ |
|
|
725 | Description: Raw listen for TinyOS |
|
|
726 | License: BSD |
|
|
727 | |
|
|
728 | * media-sound/listen [ Masked ] |
|
|
729 | Latest version available: 0.6.3 |
|
|
730 | Latest version installed: [ Not Installed ] |
|
|
731 | Size of files: 859 kB |
|
|
732 | Homepage: http://www.listen-project.org |
|
|
733 | Description: A Music player and management for GNOME |
|
|
734 | License: GPL-2 |
|
|
735 | |
| 471 | !!! The short ebuild name "aterm" is ambiguous. Please specify |
736 | !!! The short ebuild name "listen" is ambiguous. Please specify |
| 472 | !!! one of the following fully-qualified ebuild names instead: |
737 | !!! one of the above fully-qualified ebuild names instead. |
| 473 | |
|
|
| 474 | dev-libs/aterm |
|
|
| 475 | x11-terms/aterm |
|
|
| 476 | </pre> |
738 | </pre> |
| 477 | |
739 | |
| 478 | <p> |
740 | <p> |
| 479 | The application you want to install has a name that corresponds with more than |
741 | The application you want to install has a name that corresponds with more than |
| 480 | one package. You need to supply the category name as well. Portage will inform |
742 | one package. You need to supply the category name as well. Portage will inform |
| … | |
… | |
| 543 | from the system. |
805 | from the system. |
| 544 | </p> |
806 | </p> |
| 545 | |
807 | |
| 546 | </body> |
808 | </body> |
| 547 | </subsection> |
809 | </subsection> |
|
|
810 | <subsection id="digesterror"> |
|
|
811 | <title>Digest Verification Failures</title> |
|
|
812 | <body> |
|
|
813 | |
|
|
814 | <p> |
|
|
815 | Sometimes, when you attempt to emerge a package, it will fail with the message: |
|
|
816 | </p> |
|
|
817 | |
|
|
818 | <pre caption="Digest verification failure"> |
|
|
819 | >>> checking ebuild checksums |
|
|
820 | !!! Digest verification failed: |
|
|
821 | </pre> |
|
|
822 | |
|
|
823 | <p> |
|
|
824 | This is a sign that something is wrong with the Portage tree -- often, it is |
|
|
825 | because a developer may have made a mistake when committing a package to the |
|
|
826 | tree. |
|
|
827 | </p> |
|
|
828 | |
|
|
829 | <p> |
|
|
830 | When the digest verification fails, do <e>not</e> try to re-digest the package |
|
|
831 | yourself. Running <c>ebuild foo manifest</c> will not fix the problem; it will |
|
|
832 | almost certainly make it worse! |
|
|
833 | </p> |
|
|
834 | |
|
|
835 | <p> |
|
|
836 | Instead, wait an hour or two for the tree to settle down. It's likely that the |
|
|
837 | error was noticed right away, but it can take a little time for the fix to |
|
|
838 | trickle down the Portage tree. While you're waiting, check <uri |
|
|
839 | link="http://bugs.gentoo.org">Bugzilla</uri> and see if anyone has reported |
|
|
840 | the problem yet. If not, go ahead and file a bug for the broken package. |
|
|
841 | </p> |
|
|
842 | |
|
|
843 | <p> |
|
|
844 | Once you see that the bug has been fixed, you may want to re-sync to pick up |
|
|
845 | the fixed digest. |
|
|
846 | </p> |
|
|
847 | |
|
|
848 | <impo> |
|
|
849 | This does <e>not</e> mean that you can re-sync your tree multiple times! As |
|
|
850 | stated in the rsync policy (when you run <c>emerge --sync</c>), users who sync |
|
|
851 | too often will be banned! In fact, it's better to just wait until your next |
|
|
852 | scheduled sync, so that you don't overload the rsync servers. |
|
|
853 | </impo> |
|
|
854 | |
|
|
855 | </body> |
|
|
856 | </subsection> |
| 548 | </section> |
857 | </section> |
| 549 | </sections> |
858 | </sections> |