Revision as of 11:03, 30 August 2011

What It Is

The main idea behind The Funtoo 1.0 Profile is to do away with the current necessity of jumping-through-hoops in order to configure your system. It aims for a Unified Configuration by collating these files and directories:

/etc/make.conf
/etc/make.profile (symlink)
/etc/portage/

Into a single "system profile":

/etc/portage/

How It Works

Please check Funtoo 1.0 Profile: Internals.

What It Looks Like

A finished /etc/portage directory contains the following files and directories:

bin/                    [...]
eapi                    Define the EAPI version to maintain Gentoo Linux compatibility.
make.defaults           What was previously known as the /etc/make.conf file.
overlays                Define overlays.
package.env/            Define environment files (one package per atom).
package.keywords/       Define accepted architecture/Funtoo branch keywords for individual packages.
package.license/        Define accepted licenses for individual packages.
package.mask/           Define masks for individual packages.
package.properties/     [...]
package.unmask/         Define unmasks for individual packages.
package.use/            Define use flags for individual packages.
parent                  Define the profile sub-sets you wish to use.
portdir                 Define the path to your portage directory.
postsync.d/             [...]
profile/                [...]
savedconfig/            Storage for configuration files that need to be included while building a special package.

Note that the new structure of is similar to the old one except for a few changes and that the file/directory duality of package.* remains.

How To Use It

Prepare the System

This is only applicable if you are using the "portage.git" or "portage-mini-2010.git" portage trees.

Switch to the Latest Portage Tree

1. First, emerge --sync and emerge -u portage to ensure you have the latest (unmasked) version of Portage running.

2. Then, back up your old Portage tree:

cd /usr
mv portage portage.old

3. Next, edit /etc/make.conf and remove any hard-coded SYNC= variable from the file. The latest Portage has the correct default. You probably have a SYNC= line even if you didn't add it yourself. You need to ensure it's removed.

4. Now, grab the new 2011 tree by running "emerge --sync".

5. "cat /usr/portage/.git/config" and ensure that the "url" line ends in "portage-mini-2011.git" - this confirms you now have the latest 2011 tree.

6. Make sure your new tree is working fine, emerge a few things, etc.

7. Once you have confirmed that your new Portage tree is working, you can now "rm -rf /usr/portage.old" to save some disk space.

Switch to the Funtoo 1.0 Profile

Upgrade to the Development Version of Portage

The new profile uses the development version of portage which is currently masked.

If you use /etc/portage/package.{keywords,mask,unmask,use} as folders you can unmask it like so:

echo ">=sys-portage/portage-9999" > /etc/portage/package.unmask/portage
echo ">=sys-portage/portage-9999 **" > /etc/portage/package.keywords/portage

If you use /etc/portage/package.{keywords,mask,unmask,use} as files you can unmask it like so:

echo ">=sys-apps/portage-9999" >> /etc/portage/package.unmask
echo ">=sys-apps/portage-9999 **" >> /etc/portage/package.keywords

Now you can update portage:

emerge -va =portage-9999

Move the make.conf file

mv /etc/make.conf /etc/portage/make.defaults

Define the PORTDIR, DISTDIR and PKGDIR locations

As per a prior discussion The Funtoo Core Team has decided to change the default PORTDIR, DISTDIR and PKGDIR locations from:

/usr/portage
/usr/portage/distfiles
/usr/portage/packages

to:

/var/cache/portage
/var/src/distfiles
/var/cache/portage/packages

You may prefer the old or a custom directory structure or simply not wish to currently be bothered with moving things around. If so, you need to explicting define the DISTDIR and PKGDIR locations in the /etc/portage/make.defaults file like so:

DISTDIR="/usr/portage/distfiles"
PKGDIR="/usr/portage/packages"

The PORTDIR location must also be defined It has moved to a new file and can be set like so:

echo "/usr/portage" > /etc/portage/portdir

Define your overlays

If you use layman you can just copy its make.conf and edit out the unnecessary lines accordingly.

cp -a /var/lib/layman/make.conf > /etc/portage/overlays

Once done, you can append any additional overlays as needed:

echo "/usr/local/portage" >> /etc/portage/overlays

Define the profile sub-sets you will use

A feature of the Funtoo 1.0 profile is the /etc/portage/parent file which describes what profiles your specific system derives settings from. It is made up of 4 components:

1. A "arch" profile which defines settings for a particular architecture.

2. A "build" profile which describes the intent of ACCEPT_KEYWORDS variable in the /etc/portage/make.defaults file.

3. A "flavor" profile (what was previously known as profiles) which desrcibes the kind of system you want.

4. One more "mix-ins" profiles which describe optional add-ons.

A minimalistic setup might look like this:

:funtoo/1.0/linux-gnu/arch/x86-64bit
:funtoo/1.0/linux-gnu/build/current
:funtoo/1.0/linux-gnu/flavor/core

A more rounded setup might look like this:

:funtoo/1.0/linux-gnu/arch/x86-64bit
:funtoo/1.0/linux-gnu/build/current
:funtoo/1.0/linux-gnu/flavor/desktop
:funtoo/1.0/linux-gnu/mix-ins/dvd
:funtoo/1.0/linux-gnu/mix-ins/media

Define the EAPI version

echo "4" > /etc/portage/eapi

Finish Up

emerge -vauDN world

Inspect the output of the prior command carefully. It is entirely possible that the use flags of several packages have changed. Many were removed in an effort to stay minimalistic.

For instance, gcc will no longer have the fortran use enabled flag by default and libreoffice/openoffice will no longer have the cups use flag enabled by default.

Adjust your system-wide and application-specific use flags as necessary then re-run the prior command and update when stratified.

Dealing with the Leftovers

Remove Obsoleted Variables From /etc/portage/make.defaults

SYNC                        Superseded by internal funtoo portage tracking.
PORTDIR_OVERLAY             Superseded by the /etc/portage/portdir file.
SOURCE                      Superseded by the /etc/portage/overlays file.

Remove Obsoleted Files From /etc/

/etc/make.conf              Superseded by the /etc/portage/make.defaults file.
/etc/make.conf.example      If anything a /etc/portage/make.defaults.examples needs to be created.
/etc/make.globals           [TODO: Find out if this is needed]
/etc/make.profile           Superseded by the /etc/portage/parent file.

Gotchas

eselect profile

The eselect profile <action> <options> command no longer works and furthermore is no longer relevant.

layman

The /etc/portage/make.defaults file does not support sourcing external files. You must list your overlays in the /etc/portage/overlays file as illustrated above.

eix

The current version of eix does not support the new profile. Until this issue is resolved you can use the following work-around which involves bringing the /etc/make.conf file back from the dead:

echo "source /var/lib/layman/make.conf" > /etc/make.conf