Difference between revisions of "Emerge"

(Update package database)
(package.accept_keywords)
 
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
== Getting started with emerge ==
 
== Getting started with emerge ==
Emerge is the front-end for funtoo's portage package manager. With emerge its easy to install, update or remove packages.
+
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 ===
 
=== Update package database ===
Sync local package database. This will update your local Portage tree with the latest Funtoo ebuilds.
+
'''Sync local package database. This will update your local Portage tree with the latest Funtoo ebuilds.'''
<console># emerge --sync</console>
+
<console>
 +
###i## emerge --sync
 +
</console>
  
 
=== Search packages ===
 
=== Search packages ===
Search packages by name.
+
'''Search packages by name.'''
<console># emerge -s firefox
+
<console>
# emerge --search firefox</console>
+
###i## emerge -s firefox
 +
###i## emerge --search firefox
 +
</console>
  
Search packages by description.
+
'''Search packages by description.'''
<console># emerge -S web browser
+
<console>
# emerge --searchdesc web browser</console>
+
###i## emerge -S web browser
 +
###i## emerge --searchdesc web browser
 +
</console>
  
 
=== Install packages ===
 
=== Install packages ===
Install package.
+
'''Install package.'''
<console># emerge firefox</console>
+
<console>
 +
###i## emerge firefox
 +
</console>
  
Install multiple packages.
+
'''Install multiple packages.'''
<console># emerge firefox thunderbird</console>
+
<console>
 +
###i## emerge firefox thunderbird
 +
</console>
  
Install package. Ask for confirmation before performing any changes. Show verbose output.
+
'''Install package. Ask for confirmation before performing any changes. Show verbose output.'''
<console># emerge -av firefox</console>
+
<console>
 +
###i## emerge -av firefox
 +
###i## emerge --ask firefox
 +
</console>
  
 
=== Remove packages ===
 
=== Remove packages ===
Remove package.
+
'''Remove package.'''
<console># emerge -C firefox
+
<console>
# emerge --unmerge firefox</console>
+
###i## emerge -C firefox
 +
###i## emerge --unmerge firefox
 +
</console>
  
Remove package. Ask for confirmation before performing any changes.
+
'''Remove package. Ask for confirmation before performing any changes.'''
<console># emerge -aC firefox</console>
+
<console>
 +
###i## emerge -aC firefox
 +
</console>
  
Remove orphaned packages. Ask for confirmation before performing any changes.
+
'''Remove orphaned packages. Ask for confirmation before performing any changes.'''
<console># emerge -a --depclean</console>
+
<console>
 +
###i## emerge -a --depclean
 +
</console>
  
 
=== Update packages ===
 
=== Update packages ===
Update all packages.
+
'''Update all packages.'''
<console># emerge -uDN @world</console>
+
<console>
 +
###i## emerge -uDN @world
 +
</console>
  
Update all packages. Ask for confirmation before performing any changes. Show verbose output.
+
'''Update all packages. Ask for confirmation before performing any changes. Show verbose output.'''
<console># emerge -uavDN @world</console>
+
<console>
 +
###i## emerge -uavDN @world
 +
</console>
  
 
== Emerge options ==
 
== Emerge options ==
Line 88: Line 111:
  
 
== Configuration ==
 
== Configuration ==
Emerge can be configured with /etc/portage/make.conf
+
=== make.conf ===
<pre>CFLAGS="-march=native -O2 -pipe"
+
Emerge can be configured by editing <code>/etc/portage/make.conf</code>:
 +
<syntaxhighlight lang="bash">
 +
CFLAGS="-march=native -O2 -pipe"
 
CXXFLAGS="-march=native -O2 -pipe"
 
CXXFLAGS="-march=native -O2 -pipe"
  
Line 102: Line 127:
 
     svg x264 xvid gstreamer webm vpx icu bash-completion vim-pager \
 
     svg x264 xvid gstreamer webm vpx icu bash-completion vim-pager \
 
     -gnome -xscreensaver -cups -fortran -deprecated -iptables -ipv6 -geoloc \
 
     -gnome -xscreensaver -cups -fortran -deprecated -iptables -ipv6 -geoloc \
     -mta -sendmail -kmod -tiff -live -quicktime -real -gpm -themes"</pre>
+
     -mta -sendmail -kmod -tiff -live -quicktime -real -gpm -themes"
 +
</syntaxhighlight>
  
Per-package use flags can be configured with /etc/portage/package.use
+
=== Package.use ===
<pre>x11-wm/dwm savedconfig
+
Per-package use flags can be configured in <code>/etc/portage/package.use</code>:
media-sound/ncmpcpp visualizer clock taglib</pre>
+
  
If you want to install package that has not been tested on your architecture you need to edit /etc/portage/package.accept_keywords
+
<pre>
<pre>=app-misc/screenfetch-9999 **</pre>
+
x11-wm/dwm savedconfig
 +
x11-drivers/ati-drivers qt4
 +
media-sound/ncmpcpp visualizer clock taglib
 +
</pre>
  
== Further info ==
+
=== package.accept_keywords ===
For further info see emerge man page.
+
If you want to install a package that has not been tested on your architecture you need to edit <code>/etc/portage/package.accept_keywords</code>:
<console>$ man emerge</console>
+
<pre>
 +
=app-misc/screenfetch-9999 **
 +
</pre>
  
[[Category:Portage]]
+
== Other Resources ==
 +
For more info see the emerge man page.
 +
<console>
 +
$##i## man emerge
 +
</console>
  
 +
[[Category:Portage]]
 
[[Category:HOWTO]]
 
[[Category:HOWTO]]
 
[[Category:Tutorial]]
 
[[Category:Tutorial]]
 +
[[Category:System]]
 +
[[Category:First Steps]]

Latest revision as of 23:30, 26 June 2014

Getting started with emerge

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

Sync local package database. This will update your local Portage tree with the latest Funtoo ebuilds.

# emerge --sync

Search packages

Search packages by name.

# emerge -s firefox
# emerge --search firefox

Search packages by description.

# emerge -S web browser
# emerge --searchdesc web browser

Install packages

Install package.

# emerge firefox

Install multiple packages.

# emerge firefox thunderbird

Install package. Ask for confirmation before performing any changes. Show verbose output.

# emerge -av firefox
# emerge --ask firefox

Remove packages

Remove package.

# emerge -C firefox
# emerge --unmerge firefox

Remove package. Ask for confirmation before performing any changes.

# emerge -aC firefox

Remove orphaned packages. Ask for confirmation before performing any changes.

# emerge -a --depclean

Update packages

Update all packages.

# emerge -uDN @world

Update all packages. Ask for confirmation before performing any changes. Show verbose output.

# emerge -uavDN @world

Emerge options

--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

make.conf

Emerge can be configured by editing /etc/portage/make.conf:

CFLAGS="-march=native -O2 -pipe"
CXXFLAGS="-march=native -O2 -pipe"
 
MAKEOPTS="-j2"
EMERGE_DEFAULT_OPTS="--jobs 2 --load-average 2"
INPUT_DEVICES="evdev synaptics"
VIDEO_CARDS="intel i965"
LINGUAS="en en_US en_GB"
ACCEPT_LICENSE="*"
 
USE="mmx mmxext sse sse2 sse3 ssse3 threads alsa X gtk xcb dri opengl vaapi udev \
     svg x264 xvid gstreamer webm vpx icu bash-completion vim-pager \
     -gnome -xscreensaver -cups -fortran -deprecated -iptables -ipv6 -geoloc \
     -mta -sendmail -kmod -tiff -live -quicktime -real -gpm -themes"

Package.use

Per-package use flags can be configured in /etc/portage/package.use:

x11-wm/dwm savedconfig
x11-drivers/ati-drivers qt4
media-sound/ncmpcpp visualizer clock taglib

package.accept_keywords

If you want to install a package that has not been tested on your architecture you need to edit /etc/portage/package.accept_keywords:

=app-misc/screenfetch-9999 **

Other Resources

For more info see the emerge man page.

$ man emerge