注意:

The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.

Difference between revisions of "Funtoo Linux First Steps"

From Funtoo
Jump to navigation Jump to search
 
(26 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
<translate><!--T:1-->
{{Subpages|Helpful Applications for Daily Usage,Installing a Graphical Environment,Creating a User Account}}
If you are brand new to Gentoo Linux or Funtoo Linux, this page will help you to get familiar with your new system, and how it works.
If you are brand new to Gentoo Linux or Funtoo Linux, this page will help you to get familiar with your new system, and how it works.


== Intro to Emerge: Installing an Editor ==
== Intro to Emerge: Installing an Editor == <!--T:2-->


By default, Funtoo Linux has the <tt>nano</tt> and <tt>vi</tt> editors installed. <tt>nano</tt> is the default editor.
<!--T:3-->
By default, Funtoo Linux has the {{c|nano}} and {{c|vi}} editors installed. {{c|nano}} is the default editor.


If you are new to Funtoo Linux, you have probably heard about <tt>[[emerge]]</tt>, the Funtoo and Gentoo Linux command for installing packages from the Portage tree. Funtoo Linux has a git-based Portage tree, which is located at <tt>/usr/portage</tt> by default. It contains scripts called ''ebuilds'' that describe how to build and install packages from source. <tt>emerge</tt> is used to run these scripts and install packages, as follows:
<!--T:4-->
If you are new to Funtoo Linux, you have probably heard about {{c|[[emerge]]}}, the Funtoo and Gentoo Linux command for installing packages from the Portage tree. Funtoo Linux has a git-based Portage tree, which is located at {{f|/var/git/meta-repo}} by default. It contains scripts called ''ebuilds'' that describe how to build and install packages from source. {{c|emerge}} is used to run these scripts and install packages, as follows:</translate>


<console>
<console>
Line 11: Line 17:
</console>
</console>


<translate><!--T:5-->
An important note about any commands you specify on an {{c|emerge}} command-line -- Portage will automatically add them to your "selected" set, which means that Portage now understands that you want to keep this package updated as part of your system.
An important note about any commands you specify on an {{c|emerge}} command-line -- Portage will automatically add them to your "selected" set, which means that Portage now understands that you want to keep this package updated as part of your system.


Using the {{c|--pretend}} ({{c|-p}}) option, you can see what {{c|emerge}} ''would'' do, without actually doing it:
<!--T:6-->
Using the {{c|--pretend}} ({{c|-p}}) option, you can see what {{c|emerge}} ''would'' do, without actually doing it:</translate>
<console>
<console>
# ##i##emerge -p vim
# ##i##emerge -p vim
</console>
</console>


Another equally handy option is the {{c|-a}}, or {{c|--ask}} option, which will display the packages to be merged, and then ask for confirmation from you as to whether you would like to proceed and merge the packages, or not:
<translate><!--T:7--> Another equally handy option is the {{c|-a}}, or {{c|--ask}} option, which will display the packages to be merged, and then ask for confirmation from you as to whether you would like to proceed and merge the packages, or not:</translate>


{{console|body=
{{console|body=
# ##i##emerge -a emacs
# ##i##emerge -a emacs


##g##These are the packages that would be merged, in order:
\##g##These are the packages that would be merged, in order:


Calculating dependencies... done!
Calculating dependencies... done!
Line 29: Line 37:
[##g##ebuild  N    ##!g##] ##g##net-libs/liblockfile-1.09  
[##g##ebuild  N    ##!g##] ##g##net-libs/liblockfile-1.09  
[##g##ebuild  N    ##!g##] ##g##app-emacs/emacs-common-gentoo-1.3-r1##!g##  USE="##bl##-X -emacs22icons##!bl##"  
[##g##ebuild  N    ##!g##] ##g##app-emacs/emacs-common-gentoo-1.3-r1##!g##  USE="##bl##-X -emacs22icons##!bl##"  
[##g##ebuild  N    ##!g##] ##g####b##app-editors/emacs-23.4-r1##!g####!b##  USE="##r##alsa gif gpm jpeg png tiff xpm ##!r###bl##-X -Xaw3d ##!bl##(##bl##-aqua##!bl##)##bl## -athena -dbus -gconf -gtk -gzip-el -hesiod -kerberos -livecd -m17n-lib -motif -sound -source -svg -toolkit-scroll-bars -xft##!bl##"  
[##g##ebuild  N    ##!g##] ##g####b##app-editors/emacs-23.4-r1##!g####!b##  USE="##r##alsa gif gpm jpeg png tiff xpm ##!r####bl##-X -Xaw3d ##!bl##(##bl##-aqua##!bl##)##bl## -athena -dbus -gconf -gtk -gzip-el -hesiod -kerberos -livecd -m17n-lib -motif -sound -source -svg -toolkit-scroll-bars -xft##!bl##"  
[##g##ebuild  N    ##!g##] ##g##virtual/emacs-23  
[##g##ebuild  N    ##!g##] ##g##virtual/emacs-23  


##b##Would you like to merge these packages? [##g##Yes##!g##/##r##No##!r##]##!b##  ##i##y
\##b##Would you like to merge these packages? [##g##Yes##!g##/##r##No##!r##]##!b##  ##i##y
}}
}}


Line 39: Line 47:
In the above {{c|emerge}} output, you can see some text beginning with {{c|1=USE=}} on the {{c|app-editors/emacs}} line. This means that this package has a number of optional build-time features which can be controlled using Portage USE variables.  
In the above {{c|emerge}} output, you can see some text beginning with {{c|1=USE=}} on the {{c|app-editors/emacs}} line. This means that this package has a number of optional build-time features which can be controlled using Portage USE variables.  


It is possible to enable USE variables globally in {{f|/etc/make.conf}}, on a per-package basis in {{f|/etc/portage/package.use}}, or as logical sets by using [[Funtoo Profiles]]. It's recommended that you first take a look at [[Funtoo Profiles]] and see if there may be sets of USE variables that you want to enable as a group. You can set your system ''flavor'' to more accurately reflect the intended use of your Funtoo system, and by doing so, many more USE variables will be set (or unset) to reasonable defaults for your intended use.
It is possible to enable USE variables globally in {{f|/etc/portage/make.conf}}, on a per-package basis in {{f|/etc/portage/package.use}}, or as logical sets by using [[Funtoo Profiles]]. It's recommended that you first take a look at [[Funtoo Profiles]] and see if there may be sets of USE variables that you want to enable as a group. You can set your system ''flavor'' to more accurately reflect the intended use of your Funtoo system, and by doing so, many more USE variables will be set (or unset) to reasonable defaults for your intended use.


These USE variables can be set globally by adding a line such as this to {{f|/etc/make.conf}}:
These USE variables can be set globally by adding a line such as this to {{f|/etc/portage/make.conf}}:


{{file|lang=bash|name=/etc/make.conf|body=
{{file|lang=bash|name=/etc/portage/make.conf|body=
USE="gif jpeg png tiff xpm"
USE="gif jpeg png tiff xpm"
}}
}}
Line 59: Line 67:
==== Default editor ====
==== Default editor ====


Funtoo Linux also has a special meta-command called <tt>eselect</tt>, which can be used to set many default system settings. One of the things it is used for is to set the default editor used by things like <tt>crontab -e</tt>, etc that will automatically start an editor when run. Here is how to use <tt>eselect</tt> to change the default system editor:
Funtoo Linux also has a special meta-command called {{c|eselect}}, which can be used to set many default system settings. One of the things it is used for is to set the default editor used by things like {{c|crontab -e}}, etc that will automatically start an editor when run. Here is how to use {{c|eselect}} to change the default system editor:


<console>
{{console|body=
# ##i##eselect editor list
# ##i##eselect editor list
Available targets for the EDITOR variable:
Available targets for the EDITOR variable:
Line 72: Line 80:
Setting EDITOR to /usr/bin/vi ...
Setting EDITOR to /usr/bin/vi ...
Run ". /etc/profile" to update the variable in your shell.
Run ". /etc/profile" to update the variable in your shell.
</console>
}}


After logging in again, or typing <tt>source /etc/profile</tt> in the current shell, the new system editor will be active.
After logging in again, or typing {{c|source /etc/profile}} in the current shell, the new system editor will be active.


Note that if you want to use vim instead of a vi through busybox you also need to run:
Note that if you want to use vim instead of a vi through busybox you also need to run:


<console>
{{console|body=
# ##i##eselect vi set vim
# ##i##eselect vi set vim
</console>
}}
 
=== Profiles ===
 
You may have heard that Funtoo Linux and Gentoo Linux are metadistributions, which means that rather than being a one-size-fits-all kind of Linux, they allow you to customize your system to your liking. We have already taken a look at <tt>USE</tt> variables, and there are also various other settings that can affect the features that are installed when you emerge a package.
 
In Funtoo Linux, we have a system of ''profiles'' which can be used to enable various useful settings at once. In fact, a number of profiles are already enabled on your system. For example, on my desktop system, typing
<console>
###i## epro show
</console>
produces the following output:
 
<console>
=== Enabled Profiles: ===
 
        arch: x86-64bit
      build: current
    subarch: generic_64
      flavor: desktop
    mix-ins: gnome
    mix-ins: hardened
 
 
=== All inherited flavors from desktop flavor: ===
 
                    workstation (from desktop flavor)
                            core (from workstation flavor)
                        minimal (from core flavor)
 
=== All inherited mix-ins from desktop flavor: ===
 
                              X (from workstation flavor)
                          audio (from workstation flavor)
                            dvd (from workstation flavor)
                          media (from workstation flavor)
      mediadevice-audio-consumer (from media mix-in)
                mediadevice-base (from mediadevice-audio-consumer mix-in)
      mediadevice-video-consumer (from media mix-in)
                mediadevice-base (from mediadevice-video-consumer mix-in)
        mediaformat-audio-common (from media mix-in)
          mediaformat-gfx-common (from media mix-in)
        mediaformat-video-common (from media mix-in)
                  console-extras (from workstation flavor)
                          print (from desktop flavor)
</console>
 
In case you're curious, these various profile settings live within <tt>/usr/portage/profiles/funtoo/1.0/linux-gnu</tt>. You can find the profile settings for (inherited) mix-in <tt>X</tt> by looking in <tt>/usr/portage/profiles/funtoo/1.0/linux-gnu/mix-ins/X</tt>, for example.
 
Under the list of <tt>Enabled profiles</tt>, you'll see that I have an <tt>x86-64bit</tt> arch profile. In Funtoo Linux, ''all'' systems have a single arch profile defined, and this is where settings specific to your system architecture are defined. Besides the architecture, there is also a sub-architecture profile, which allows you to enable builds options which make the system even more optimised towards the specific set of CPU instructions you might have at your disposal. Like in case of architecture, only a single sub-architecture can be defined at any time for a single system. In addition, I have a build profile of ''current''. All Funtoo Linux systems have a single build profile defined, and this tells Portage what masks to apply to the Portage tree -- in other words, what selection of packages you will have available to emerge. If you are using funtoo-stable, your build profile will be ''stable'' and you will have a more limited set of packages that you can merge by default -- the stable set.
 
You will also see that I have a ''flavor'' profile. Unlike the ''arch'', ''subarch'', and ''build'' profiles, which should not be changed, you can choose another flavor if you want. In fact, we encourage you to do so. The ''flavor'' is used to define the general type of system you are creating. You can only have one flavor profile enabled, and since this command was run on a desktop-type system, I have enabled the ''desktop'' flavor. This enables a variety of settings, primarily USE flags, suitable for desktop systems.
 
You'll also see that I have a couple of ''mix-ins'' (explicitly) enabled. In Funtoo Linux, you can have zero or more mix-ins enabled -- I have ''gnome'' enabled, which sets various settings that are optimal for the use of the [[GNOME First Steps|GNOME]] desktop environment, and then I am also using the ''hardened'' mix-in, since I have set up a so-called "hardened" system with various protections against malicious attacks.
 
{{Tip|1=Take advantage of Funtoo Linux's [[:News:New Media Mix-ins| enhanced Media mix-ins]] to help you easily get the level of media support you want for your system.}}  
 
Followed by the general information about enabled profiles and mix-ins come two lists - one showing any number of flavors that are inherited by the flavor you picked within profile settings, and one showing a listing of all the different mix-ins that got pulled-in by the flavor you have selected. As you can see, the desktop flavor itself inherits (and  builds upon) flavors ''workstation'', ''core'', and ''minimal''. On the other hand, all of these different flavors pull in a number of mix-ins. Each mix-in shows which flavor has pulled it in. For example, the ''X'' mix-in comes with the ''workstation'' flavor, while the ''print'' mix-in comes from the ''desktop'' flavor. Some mix-ins are pulled-in by other mix-ins, as you can see for the mix-in ''mediaformat-audio-common'' - which is pulled-in by the media mix-in (which, in turn, is pulled in by the ''workstation'' flavor).
 
For now, it is not necessary to get too deep into profiles, but if you are creating a desktop system, I suggest you set the ''desktop'' flavor. To do this, type the following command as the root user:
 
<console>
# ##i##epro flavor desktop
</console>
 
You will now have the ''desktop'' flavor set for your system. Type <tt>epro show</tt> to see your new settings.


=== Updating your system ===
=== Updating your system ===


Sometimes, you may want to update the packages on your system. Often, this is done after you run <tt>emerge --sync</tt>, which will grab Portage tree updates from the main Funtoo Linux Portage tree:
Sometimes, you may want to update the packages on your system. Often, this is done after you run {{c|ego sync}}, which will grab Portage tree updates from the main Funtoo Linux Portage tree:


<console>
{{console|body=
# ##i##emerge --sync
# ##i##ego sync
 
\##g##Syncing meta-repo
>>> Starting git pull...
(cd /var/git/meta-repo && git remote set-branches --add origin master)
remote: Counting objects: 1791, done.      
(cd /var/git/meta-repo && git fetch origin refs/heads/master:refs/remotes/origin/master)
remote: Compressing objects: 100% (206/206), done.      
remote: Counting objects: 95, done.
remote: Total 980 (delta 811), reused 931 (delta 764)      
remote: Compressing objects: 100% (64/64), done.
Receiving objects: 100% (980/980), 185.04 KiB, done.
remote: Total 95 (delta 31), reused 95 (delta 31), pack-reused 0
Resolving deltas: 100% (811/811), completed with 754 local objects.
Unpacking objects: 100% (95/95), done.
From git://github.com/funtoo/experimental-mini-2011
}}
  7a17140..b836bc8  funtoo.org -> origin/funtoo.org
Updating 7a17140..b836bc8
Fast-forward
>>> Git pull in /usr/portage successful
 
* IMPORTANT: 1 news items need reading for repository 'gentoo'.
* Use eselect news to read news items.
 
#
</console>


You may also want to update your system after you have changed USE flag settings. To take advantage of the USE flags you have just enabled, it's necessary to recompile everything that includes them.  
You may also want to update your system after you have changed USE flag settings. To take advantage of the USE flags you have just enabled, it's necessary to recompile everything that includes them.  


Below, you'll find a recommended <tt>emerge</tt> command for updating your entire system. The <tt>-a</tt> option will cause <tt>emerge</tt> to prompt you for confirmation before starting the merge:
Below, you'll find a recommended {{c|emerge}} command for updating your entire system. The <tt>-a</tt> option will cause <tt>emerge</tt> to prompt you for confirmation before starting the merge:


<console>
{{console|body=
# ##i##emerge -auDN world
# ##i##emerge -auDN @world
</console>
}}


<tt>-u</tt> tells <tt>emerge</tt> to update any already-installed but out-of-date packages that we specify on the command-line. The <tt>-D</tt> option tells <tt>emerge</tt> to perform a ''deep'' dependency tree graph, so it will include sub-dependencies of packages that we have specified on the command line as well. This allows <tt>emerge</tt> to perform as thorough an update of your system as possible.  
{{c|-u}} tells {{c|emerge}} to update any already-installed but out-of-date packages that we specify on the command-line. The {{c|-D}} option tells {{c|emerge}} to perform a ''deep'' dependency tree graph, so it will include sub-dependencies of packages that we have specified on the command line as well. This allows {{c|emerge}} to perform as thorough an update of your system as possible.  


The <tt>-N</tt> (<tt>--newuse</tt>) option tells Portage to check for any new USE flags that have been enabled or disabled, and rebuild packages so that all USE flags are set as currently defined in <tt>/etc/make.conf</tt> and <tt>/etc/portage/package.use</tt>.  
The {{c|-N}} ({{c|--newuse}}) option tells Portage to check for any new USE flags that have been enabled or disabled, and rebuild packages so that all USE flags are set as currently defined in [[Funtoo Profiles]], {{f|/etc/portage/make.conf}} and {{f|/etc/portage/package.use}}.  


<tt>world</tt> is a "meta-package" or "package set" which includes every package that you have manually installed plus all packages in the system set. It's important to note that whenever you ask <tt>emerge</tt> to install anything, such as <tt>metalog</tt> or <tt>vim</tt>, those packages will be automatically added to the world package set. In this way, <tt>emerge</tt> learns what packages you care about and want to keep updated. If you want to see what's in your world package set, take a look at <tt>/var/lib/portage/world</tt>:
<tt>world</tt> is a "meta-package" or "package set" which includes every package that you have manually installed plus all packages in the system set. If you want to see a list of all these packages, look at {{f|/var/lib/portage/world}}:


<console>
{{console|body=
# ##i##cat /var/lib/portage/world
# ##i##cat /var/lib/portage/world
app-editors/vim
app-editors/vim
Line 199: Line 133:
sys-fs/reiserfsprogs
sys-fs/reiserfsprogs
sys-kernel/vanilla-sources
sys-kernel/vanilla-sources
</console>
}}
 
Also note that some packages may have been added to the world set by Metro when your stage3 tarball was built.
 
==== Updating a few packages ====
==== Updating a few packages ====


Line 210: Line 141:
# ##i##emerge -auDN vim emacs
# ##i##emerge -auDN vim emacs
</console>
</console>
== Useful applications for daily usage ==
Here are some other packages you may want to consider installing via <tt>emerge</tt>:
;<tt>app-misc/screen</tt>: Allows you to have persistent login sessions.
;<tt>app-misc/tmux</tt>: Similar to <tt>screen</tt> -- some people prefer it.
;<tt>app-admin/sudo</tt>: Grant root privileges to selected users and command combinations.
;<tt>sys-process/htop</tt>: Colorful and informative text-based process list.
;<tt>sys-process/glances</tt>: Similar to htop, includes disc I/O and network I/O in display.
;<tt>app-portage/eix</tt>: Quick portage package search
;<tt>app-portage/gentoolkit</tt>: Portage utils
;<tt>app-misc/mc</tt>: GNU Midnight Commander is a text based file manager --- some will recall <tt>MS-DOS XtreeGold</tt>
;<tt>app-text/wgetpaste</tt>: Command-line interface to various pastebins; very useful in providing info along with bugs reports
;<tt>net-irc/irssi</tt>: A modular textUI IRC client with IPv6 support; a powerful tool to get help from Funtoo Community on IRC channel. Nice companion to <tt>app-text/wgetpaste</tt>
<console>
# ##i##emerge --jobs app-misc/screen sudo htop eix gentoolkit app-misc/mc wgetpaste net-irc/irssi
</console>
=== Creating a user account ===
It's a good idea to create a normal user account that you can use for general Linux tasks. Before rebooting, create a user account for everyday use. Adjust the groups in the example below to match your needs. Some of them may not exist yet on your system. Replace "<tt><user_name></tt>" with the name you're going to use for your everyday user. The "<tt>-m</tt>" option instructs <tt>useradd</tt> to create a home directory for your user. See <tt>man useradd</tt> for more info.
<console>
# ##i##useradd -m -g users -G audio,video,cdrom,wheel <user_name>
</console>
Don't forget to set a password for your new user:
<console>
# ##i##passwd <user_name>
</console>
== Installing a graphical environment ==
If you intend on using your Funtoo Linux installation for more than system administration, chances are you're going to want to have a GUI (graphical user interface). In the past, setting one up involved wading through text files and man pages. Thanks to modern tools like udev this is no longer the case.
Unlike most operating systems, Funtoo does not ship with a GUI pre-installed. If you've used Windows or Mac OS, you'd also know that their interfaces cannot be replaced easily. With Linux, the opposite is true -- you are free to choose from a huge selection of GUIs. From window managers such as Blackbox, IceWM, and xmonad, to fully-featured desktop environments like GNOME and KDE, the possibilities are vast in number.
The first step in setting up a graphical environment is to set up the [[X Window System]]. Then, you will be able to install the graphical environment of your choice. [[GNOME First Steps|GNOME]] is a popular option for new users. [[KDE Plasma Desktop|KDE Plasma]] and [http://www.funtoo.org/Package:Xfce4-meta XFCE] are popular alternatives.


[[Category:HOWTO]]
[[Category:HOWTO]]
[[Category:Install]]
[[Category:Install]]
[[Category:Featured]]
[[Category:Featured]]

Latest revision as of 21:51, August 19, 2019

Other languages:
English • ‎Türkçe • ‎español • ‎português do Brasil • ‎中文(中国大陆)‎

If you are brand new to Gentoo Linux or Funtoo Linux, this page will help you to get familiar with your new system, and how it works.

Intro to Emerge: Installing an Editor

By default, Funtoo Linux has the nano and vi editors installed. nano is the default editor.

If you are new to Funtoo Linux, you have probably heard about emerge, the Funtoo and Gentoo Linux command for installing packages from the Portage tree. Funtoo Linux has a git-based Portage tree, which is located at /var/git/meta-repo by default. It contains scripts called ebuilds that describe how to build and install packages from source. emerge is used to run these scripts and install packages, as follows:

root # emerge vim

An important note about any commands you specify on an emerge command-line -- Portage will automatically add them to your "selected" set, which means that Portage now understands that you want to keep this package updated as part of your system.

Using the --pretend (-p) option, you can see what emerge would do, without actually doing it:

root # emerge -p vim

Another equally handy option is the -a, or --ask option, which will display the packages to be merged, and then ask for confirmation from you as to whether you would like to proceed and merge the packages, or not:

root # emerge -a emacs

These are the packages that would be merged, in order:

Calculating dependencies... done!
[ebuild  N     ] app-admin/eselect-emacs-1.13 
[ebuild  N     ] net-libs/liblockfile-1.09 
[ebuild  N     ] app-emacs/emacs-common-gentoo-1.3-r1  USE="-X -emacs22icons" 
[ebuild  N     ] app-editors/emacs-23.4-r1  USE="alsa gif gpm jpeg png tiff xpm -X -Xaw3d (-aqua) -athena -dbus -gconf -gtk -gzip-el -hesiod -kerberos -livecd -m17n-lib -motif -sound -source -svg -toolkit-scroll-bars -xft" 
[ebuild  N     ] virtual/emacs-23 

Would you like to merge these packages? [Yes/No]  y

USE Variables

In the above emerge output, you can see some text beginning with USE= on the app-editors/emacs line. This means that this package has a number of optional build-time features which can be controlled using Portage USE variables.

It is possible to enable USE variables globally in /etc/portage/make.conf, on a per-package basis in /etc/portage/package.use, or as logical sets by using Funtoo Profiles. It's recommended that you first take a look at Funtoo Profiles and see if there may be sets of USE variables that you want to enable as a group. You can set your system flavor to more accurately reflect the intended use of your Funtoo system, and by doing so, many more USE variables will be set (or unset) to reasonable defaults for your intended use.

These USE variables can be set globally by adding a line such as this to /etc/portage/make.conf:

   /etc/portage/make.conf (bash source code)
USE="gif jpeg png tiff xpm"

Or, alternatively, you can enable just these USE variables for emacs by adding the following line to /etc/portage/package.use:

   /etc/portage/package.use (bash source code)
app-editors/emacs gif jpeg png tiff xpm

However, it's generally best to find a Funtoo Profile flavor or mix-in that serves your purpose. For example, setting your system to be a desktop by running epro flavor desktop or adding the appropriate mix-in via epro mix-in +mediaformat-gfx-common gives you more opportunity to dial in sets of related USE variables with a single command.

See the emerge page for more information on various emerge command-line options and best practices.

Default editor

Funtoo Linux also has a special meta-command called eselect, which can be used to set many default system settings. One of the things it is used for is to set the default editor used by things like crontab -e, etc that will automatically start an editor when run. Here is how to use eselect to change the default system editor:

root # eselect editor list
Available targets for the EDITOR variable:
  [1]   /bin/nano
  [2]   /bin/ed
  [3]   /usr/bin/ex
  [4]   /usr/bin/vi
  [ ]   (free form)
root # eselect editor set 4
Setting EDITOR to /usr/bin/vi ...
Run ". /etc/profile" to update the variable in your shell.

After logging in again, or typing source /etc/profile in the current shell, the new system editor will be active.

Note that if you want to use vim instead of a vi through busybox you also need to run:

root # eselect vi set vim

Updating your system

Sometimes, you may want to update the packages on your system. Often, this is done after you run ego sync, which will grab Portage tree updates from the main Funtoo Linux Portage tree:

root # ego sync
Syncing meta-repo
(cd /var/git/meta-repo && git remote set-branches --add origin master)
(cd /var/git/meta-repo && git fetch origin refs/heads/master:refs/remotes/origin/master)
remote: Counting objects: 95, done.
remote: Compressing objects: 100% (64/64), done.
remote: Total 95 (delta 31), reused 95 (delta 31), pack-reused 0
Unpacking objects: 100% (95/95), done.

You may also want to update your system after you have changed USE flag settings. To take advantage of the USE flags you have just enabled, it's necessary to recompile everything that includes them.

Below, you'll find a recommended emerge command for updating your entire system. The -a option will cause emerge to prompt you for confirmation before starting the merge:

root # emerge -auDN @world

-u tells emerge to update any already-installed but out-of-date packages that we specify on the command-line. The -D option tells emerge to perform a deep dependency tree graph, so it will include sub-dependencies of packages that we have specified on the command line as well. This allows emerge to perform as thorough an update of your system as possible.

The -N (--newuse) option tells Portage to check for any new USE flags that have been enabled or disabled, and rebuild packages so that all USE flags are set as currently defined in Funtoo Profiles, /etc/portage/make.conf and /etc/portage/package.use.

world is a "meta-package" or "package set" which includes every package that you have manually installed plus all packages in the system set. If you want to see a list of all these packages, look at /var/lib/portage/world:

root # cat /var/lib/portage/world
app-editors/vim
app-portage/eix
app-portage/gentoolkit
dev-vcs/git
net-misc/bridge-utils
net-misc/dhcpcd
net-misc/keychain
sys-apps/gptfdisk
sys-apps/pciutils
sys-devel/bc
sys-fs/reiserfsprogs
sys-kernel/vanilla-sources

Updating a few packages

If we simply wanted to rebuild a few packages to reflect updated USE flag settings, we could specify it instead of world. Be sure to include the -N option:

root # emerge -auDN vim emacs