Jump to: navigation, search


435 bytes added, 9 months ago
Marked this version for translation
Emerge is the front-end for funtoo's Portage package manager. With emerge it is easy to install, update or remove packages.
== Update Package Database ==<!--T:2-->
'''Sync meta-repo. This will update your local Portage tree with the latest Funtoo ebuilds.'''
See {{package|app-admin/ego}} ([[Package:Ego|Wiki Page]]) for more information on ego. Also see the man pages: {{c|ego}}, {{c|ego-profile}}, {{c|ego-sync}} and [[Funtoo Profiles]] wiki page.
== Search packages ==<!--T:3-->
'''Search packages by name.'''
'''Search packages by description.'''
== Install packages ==<!--T:5-->
'''Install package.'''
'''Install multiple packages.'''
'''Install package. Ask for confirmation before performing any changes. Show verbose output.'''
== Remove packages ==<!--T:8-->
'''Remove package.'''
'''Remove package. Ask for confirmation before performing any changes.'''
'''Remove orphaned packages. Ask for confirmation before performing any changes.'''
== Update packages ==<!--T:11-->
'''Update all packages.'''
'''Update all packages. Ask for confirmation before performing any changes. Show verbose output.'''
'''When upgrading to a new version of perl, it is necessary to also run {{c|perl-cleaner}} afterwards:'''
{{Note|This requirement of running {{c|perl-cleaner}} will eventually go away, once all perl-related ebuilds are updated to EAPI 5. EAPI 5 is a version of the Ebuild specification that supports smart updating of perl-related bits.}}
== Emerge options ==<!--T:15-->
; --sync
: Updates the portage tree that is located in /usr/portage by default.
; --search -s
: Searches for matches of the supplied string in the portage tree.
; --searchdesc -S
: Matches the search string against the description field as well as the package name.
; --ask -a
: Ask for confirmation before performing any changes.
; --pretend -p
: Instead of actually performing the merge, simply display what *would* have been installed if --pretend weren't used.
; --unmerge -C
: Removes all matching packages.
; --update -u
: Updates packages to the best version available, which may not always be the highest version number due to masking for testing and development.
; --deep [DEPTH] -D
: force emerge to consider the entire dependency tree of packages, instead of checking only the immediate dependencies of the packages.
; --newuse -N
: Tells emerge to include installed packages where USE flags have changed since compilation.
; --depclean -c
: Remove orphaned packages. Cleans the system by removing packages that are not associated with explicitly merged packages.
; --autounmask-write
: Automatically write package.use settings as necessary to satisfy dependencies.
; --resume -r
: Resumes the most recent merge list that has been aborted due to an error.
; --jobs[=JOBS] -j [JOBS]
: Specifies the number of packages to build simultaneously.
; --load-average [LOAD]
: Specifies that no new builds should be started if there are other builds running and the load average is at least LOAD (a floating-point number).
== Configuration ==<!--T:30-->
=== make.conf ===
Emerge can be configured by editing {{c|/etc/make.conf}} to customize settings that are set in profiles. However, it's recommended to try to use [[Funtoo Profiles]] as much as possible to avoid having to clutter up {{c|/etc/make.conf}}. Also note that {{c|/etc/portage/make.conf}} is the same as {{c|/etc/make.conf}} -- they are symlinked.
{{file|name=/etc/portage/make.conf||desc=See [[Make.conf]]|body=
# override subarch profile
CXXFLAGS="-march=native -O2 -pipe"
EMERGE_DEFAULT_OPTS="--jobs 2 --load-average 2"
# Generally, your subarch profile and flavor/mix-ins will set these for you:
USE="mmx mmxext sse sse2 sse3 ssse3 threads alsa X gtk xcb dri opengl vaapi udev \
=== Package.use ===<!--T:34-->
Per-package use flags can be configured in
x11-wm/dwm savedconfig
=== package.accept_keywords ===<!--T:36-->
If you want to install a package that has not been tested on your architecture you need to edit
== Other Resources ==<!--T:37-->
For more info see the emerge man page.
Bureaucrats, Administrators, wiki-admins, wiki-staff

Navigation menu