OLD | NEW |
1 .TH "EMERGE" "1" "Nov 2010" "Portage VERSION" "Portage" | 1 .TH "EMERGE" "1" "Nov 2010" "Portage VERSION" "Portage" |
2 .SH "NAME" | 2 .SH "NAME" |
3 emerge \- Command\-line interface to the Portage system | 3 emerge \- Command\-line interface to the Portage system |
4 .SH "SYNOPSIS" | 4 .SH "SYNOPSIS" |
5 .TP | 5 .TP |
6 .BR emerge | 6 .BR emerge |
7 [\fIoptions\fR] [\fIaction\fR] [\fIebuild\fR | \fItbz2file\fR | \fIfile\fR | \fI
@set\fR | \fIatom\fR] ... | 7 [\fIoptions\fR] [\fIaction\fR] [\fIebuild\fR | \fItbz2file\fR | \fIfile\fR | \fI
@set\fR | \fIatom\fR] ... |
8 .TP | 8 .TP |
9 .BR emerge | 9 .BR emerge |
10 \fB\-\-sync\fR | \fB\-\-version\fR | 10 \fB\-\-sync\fR | \fB\-\-version\fR |
(...skipping 446 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
457 the package, even if it is already installed. Note that Portage will | 457 the package, even if it is already installed. Note that Portage will |
458 not remerge dependencies by default. Also note that this option takes | 458 not remerge dependencies by default. Also note that this option takes |
459 precedence over options such as \fB\-\-newuse\fR, preventing a package | 459 precedence over options such as \fB\-\-newuse\fR, preventing a package |
460 from being reinstalled even though the corresponding USE flag settings | 460 from being reinstalled even though the corresponding USE flag settings |
461 may have changed. | 461 may have changed. |
462 .TP | 462 .TP |
463 .BR "\-\-nospinner" | 463 .BR "\-\-nospinner" |
464 Disables the spinner for the session. The spinner is active when the | 464 Disables the spinner for the session. The spinner is active when the |
465 terminal device is determined to be a TTY. This flag disables it regardless. | 465 terminal device is determined to be a TTY. This flag disables it regardless. |
466 .TP | 466 .TP |
| 467 .BR "\-\-nousepkg\-atoms " ATOMS |
| 468 A space separated list of package names or slot atoms. Emerge will ignore |
| 469 matching binary packages. |
| 470 .TP |
467 .BR "\-\-oneshot " (\fB\-1\fR) | 471 .BR "\-\-oneshot " (\fB\-1\fR) |
468 Emerge as normal, but do not add the packages to the world file | 472 Emerge as normal, but do not add the packages to the world file |
469 for later updating. | 473 for later updating. |
470 .TP | 474 .TP |
471 .BR "\-\-onlydeps " (\fB\-o\fR) | 475 .BR "\-\-onlydeps " (\fB\-o\fR) |
472 Only merge (or pretend to merge) the dependencies of the packages | 476 Only merge (or pretend to merge) the dependencies of the packages |
473 specified, not the packages themselves. | 477 specified, not the packages themselves. |
474 .TP | 478 .TP |
475 .BR "\-\-package\-moves [ y | n ]" | 479 .BR "\-\-package\-moves [ y | n ]" |
476 Perform package moves when necessary. This option | 480 Perform package moves when necessary. This option |
(...skipping 50 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
527 have a BUILD_TIME that is larger than the given TIMESTAMP | 531 have a BUILD_TIME that is larger than the given TIMESTAMP |
528 and that is larger than that of the installed package will | 532 and that is larger than that of the installed package will |
529 be considered by the rebuilt\-binaries logic. | 533 be considered by the rebuilt\-binaries logic. |
530 .TP | 534 .TP |
531 .BR "\-\-reinstall changed\-use" | 535 .BR "\-\-reinstall changed\-use" |
532 Tells emerge to include installed packages where USE flags have | 536 Tells emerge to include installed packages where USE flags have |
533 changed since installation. Unlike \fB\-\-newuse\fR, this option does | 537 changed since installation. Unlike \fB\-\-newuse\fR, this option does |
534 not trigger reinstallation when flags that the user has not | 538 not trigger reinstallation when flags that the user has not |
535 enabled are added or removed. | 539 enabled are added or removed. |
536 .TP | 540 .TP |
| 541 .BR "\-\-reinstall\-atoms " ATOMS |
| 542 A space separated list of package names or slot atoms. Emerge will treat |
| 543 matching packages as if they are not installed, and reinstall them if |
| 544 necessary. |
| 545 .TP |
537 .BR \-\-root=DIR | 546 .BR \-\-root=DIR |
538 Set the \fBROOT\fR environment variable. | 547 Set the \fBROOT\fR environment variable. |
539 .TP | 548 .TP |
540 .BR "\-\-root\-deps[=rdeps]" | 549 .BR "\-\-root\-deps[=rdeps]" |
541 If no argument is given then build\-time dependencies of packages for | 550 If no argument is given then build\-time dependencies of packages for |
542 \fBROOT\fR are installed to | 551 \fBROOT\fR are installed to |
543 \fBROOT\fR instead of /. If the \fBrdeps\fR argument is given then discard | 552 \fBROOT\fR instead of /. If the \fBrdeps\fR argument is given then discard |
544 all build\-time dependencies of packages for \fBROOT\fR. This option is | 553 all build\-time dependencies of packages for \fBROOT\fR. This option is |
545 only meaningful when used together with \fBROOT\fR and it should not | 554 only meaningful when used together with \fBROOT\fR and it should not |
546 be enabled under normal circumstances. For currently supported | 555 be enabled under normal circumstances. For currently supported |
(...skipping 37 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
584 Updates packages to the best version available, which may | 593 Updates packages to the best version available, which may |
585 not always be the highest version number due to masking | 594 not always be the highest version number due to masking |
586 for testing and development. Package atoms specified on | 595 for testing and development. Package atoms specified on |
587 the command line are greedy, meaning that unspecific | 596 the command line are greedy, meaning that unspecific |
588 atoms may match multiple versions of slotted packages. | 597 atoms may match multiple versions of slotted packages. |
589 .TP | 598 .TP |
590 .BR "\-\-use\-ebuild\-visibility [ y | n ]" | 599 .BR "\-\-use\-ebuild\-visibility [ y | n ]" |
591 Use unbuilt ebuild metadata for visibility | 600 Use unbuilt ebuild metadata for visibility |
592 checks on built packages. | 601 checks on built packages. |
593 .TP | 602 .TP |
| 603 .BR "\-\-useoldpkg\-atoms " ATOMS |
| 604 A space separated list of package names or slot atoms. Emerge will prefer |
| 605 matching binary packages over newer unbuilt packages. |
| 606 .TP |
594 .BR "\-\-usepkg [ y | n ] (\-k short option)" | 607 .BR "\-\-usepkg [ y | n ] (\-k short option)" |
595 Tells emerge to use binary packages (from $PKGDIR) if they are available, thus | 608 Tells emerge to use binary packages (from $PKGDIR) if they are available, thus |
596 possibly avoiding some time\-consuming compiles. This option is useful for CD | 609 possibly avoiding some time\-consuming compiles. This option is useful for CD |
597 installs; you can export PKGDIR=/mnt/cdrom/packages and then use this option to | 610 installs; you can export PKGDIR=/mnt/cdrom/packages and then use this option to |
598 have emerge "pull" binary packages from the CD in order to satisfy dependencies. | 611 have emerge "pull" binary packages from the CD in order to satisfy dependencies. |
599 .TP | 612 .TP |
600 .BR "\-\-usepkgonly [ y | n ] (\-K short option)" | 613 .BR "\-\-usepkgonly [ y | n ] (\-K short option)" |
601 Tells emerge to only use binary packages (from $PKGDIR). All the binary | 614 Tells emerge to only use binary packages (from $PKGDIR). All the binary |
602 packages must be available at the time of dependency calculation or emerge | 615 packages must be available at the time of dependency calculation or emerge |
603 will simply abort. Portage does not use $PORTDIR when calculating dependency | 616 will simply abort. Portage does not use $PORTDIR when calculating dependency |
(...skipping 301 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
905 .BR ebuild (1), | 918 .BR ebuild (1), |
906 .BR ebuild (5), | 919 .BR ebuild (5), |
907 .BR make.conf (5), | 920 .BR make.conf (5), |
908 .BR color.map (5), | 921 .BR color.map (5), |
909 .BR portage (5) | 922 .BR portage (5) |
910 .LP | 923 .LP |
911 A number of helper applications reside in \fI/usr/lib/portage/bin\fR. | 924 A number of helper applications reside in \fI/usr/lib/portage/bin\fR. |
912 .LP | 925 .LP |
913 The \fBapp\-portage/gentoolkit\fR package contains useful scripts such as | 926 The \fBapp\-portage/gentoolkit\fR package contains useful scripts such as |
914 \fBequery\fR (a package query tool). | 927 \fBequery\fR (a package query tool). |
OLD | NEW |