Funtoo Profiles

Other languages:

English • ‎Türkçe • ‎español • ‎português do Brasil • ‎slovenčina • ‎русский • ‎中文（中国大陆）‎ • ‎日本語

This page covers the Funtoo Linux profile system -- how it works, what profiles are available, and how to use epro to set and change profile settings.

Profile Types

Historically, users have had to add a large number of settings to /etc/make.conf to customize their Gentoo or Funtoo Linux system, which made setup of the operating system more difficult than it should be. In Gentoo Linux, it is possible to only define one system profile. Think of a system profile as the default settings that Portage uses for building everything on your system. Funtoo Linux uses multiple sub-profiles per system. The following profile types are available in Funtoo Linux:

Sub-Profile	Description
`arch`	This defines CPU-specific settings. Only one arch profile is enabled at install time, and cannot be changed.
`subarch`	This further refines the CPU-specific settings. One subarch profile is typically enabled at install time.
`build`	This defines the type of stability, such as `current` or `stable`, and its associated settings. One build profile is enabled, at install time, and is generally not changed.
`flavor`	This defines the intended use of Funtoo, such as `minimal`, `core`, `workstation` or `desktop`. One flavor is enabled, and can be changed by the user.
`mix-ins`	These can be enabled by the user, based on the features the user wants, such as `gnome`, `kde`, `media`, `mate`, `X`, and `hardened`.

Note

Flavors can (and often do) inherit settings from other flavors and mix-ins. Mix-ins can also inherit settings from other mix-ins. For example, X is inherited by gnome. The epro tool will show both as being enabled so there are no surprises.

Using epro

epro show will display the current profile settings on your system:

root #  epro show

=== Enabled Profiles: ===

        arch:  x86-64bit
       build:  current
     subarch:  intel64-haswell
      flavor:  desktop
     mix-ins:  gnome


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

To view all available sub-profile settings, use epro list:

root #  epro list

Enabled profiles will be highlighted in cyan. Directly enabled profiles will be in bold and have an asterisk * appended. Sub-profiles enabled via inheritance will be highlighted.

Usage Examples

Add the mix-ins `gnome` and `kde`	root # epro mix-ins +gnome +kde
Remove a mix-in, for example `gnome`	root # epro mix-ins -gnome
Change the profile arch to x86-64bit	root # epro arch x86-64bit
Change the subarch to `generic_64`	root # epro subarch generic_64
Change the system flavor	root # epro flavor desktop
Get JSON output of profile settings	root # epro show-json
Get current sub-profile setting in text form	root # epro get [profiletype]

Flavors

A system can have only one flavor profile enabled at a time. The following flavors are available:

Flavor	Description
`minimal`	This flavor defines the most minimal possible flavor. It currently only contains defaults for all Funtoo Linux flavors.
`core`	The core flavor is the minimal flavor plus reasonable USE options, and is used for stage3 builds.
`server`	The server flavor is intended for servers but at this time just tracks core.
`workstation`	The workstation flavor is a minimal desktop system. It includes the core flavor plus these mix-ins: `X`, `audio`, `dvd`, `media` and `console-extras`.
`desktop`	The desktop flavor is a full-featured desktop system, minus desktop environment (add KDE, GNOME or XFCE as a mix-in.) It includes the `workstation` flavor plus `printing` support.

Mix-ins

A system can have any number of mix-ins enabled at a time. The following mix-ins are available:

Mix-in	Description
`audio`	Enables core audio-related settings, currently related to ALSA.
`console-extras`	Enables things that are nice to have for console-only systems. Currently enabling gpm in USE.
`dvd`	USE settings related to optical drives -- CDR/DVD-ROM/RW use.
`gnome`	USE and package.use settings required to merge GNOME. Designed to be used with `desktop` or `workstation` flavor.
`hardened`	Enables hardened support.
`kde`	USE and package.use settings required to merge KDE. Designed to be used with `desktop` or `workstation` flavor.
`media`	USE settings related to audio/video media encoding. Can be for desktops or servers.
`print`	Enables printing capability.
`vmware-guest`	Settings related to using Funtoo Linux as a VMWare virtual machine guest.
`X`	Settings related to the X Window System and hardware support.
`xfce`	USE settings required for merging XFCE.

Media Device Mix-ins

Media device mix-ins have been created to support media devices, including external and portable devices, and associated low-level hardware support and hardware-focused codecs. Media devices have been categorized into audio and video categories, and consumer and professional categories. "Consumer" devices are those devices that regular desktop users might typically use, while "professional" devices are those that professionals, hobbyists or enthusiasts would typically use. Here are the new mix-ins for media devices:

Media Device Mix-in	Description
`mediadevice-base`	Common, universally-supported media devices, like IEEE-1394 (Firewire), CDDA, CDIO. Other mediadevice mix-ins have this as a parent.
`mediadevice-audio-consumer`	Consumer audio devices, such as personal portable media players (iOS, iPod, etc.)
`mediadevice-audio-pro`	Pro audio support, such as JACK.
`mediadevice-video-consumer`	Consumer video support, such as DVD, Blu Ray, V4L
`mediadevice-video-pro`	Pro video support, such as dv, dc1394.

Media Format Mix-ins

Media format mix-ins have been created to support media formats for reading, writing, encoding and decoding images, audio and video. They have been organized into a "common" collection, for popular formats, and an "extra" collection, which is intended to include "everything else". Let's look at the new mix-ins:

Media Format Mix-in	Description
`mediaformat-video-common`	Common (ie. popular) video formats.
`mediaformat-video-extra`	More esoteric video formats.
`mediaformat-audio-common`	Common (ie. popular) audio formats.
`mediaformat-audio-extra`	More esoteric audio formats.
`mediaformat-gfx-common`	Common (ie. popular) graphics formats.
`mediaformat-gfx-extra`	More esoteric graphics formats.

How to Use Media Mix-Ins

Our existing media mix-in still exists, and is still pulled in by the desktop and workstation flavors automatically. It now includes the following parent mix-ins:

mediadevice-audio-consumer
mediadevice-video-consumer
mediaformat-audio-common
mediaformat-gfx-common
mediaformat-video-common

In addition, there is a new media-pro mix-in which needs to be enabled manually, which pulls in the following mix-ins:

mediadevice-audio-pro
mediadevice-video-pro

So typically, you would enable the desktop or workstation flavor, and if you need professional hardware support, you'd also enable the media-pro mix-in. If you needed any additional media formats support, you could enable one or more of the mediaformat-*-extra mix-ins to add the formats you needed. Of course, it's possible to enable only the specific mix-ins you need, and also complement these mix-ins with specific USE variable settings you might require.

How Profile Settings are Stored

Funtoo Linux stores its profile settings in the /etc/portage/make.profile/parent file. Typically, users don't need to modify this file, instead using ego and epro to make changes, but it can be handy to take a look at what the contents of the file look like. A simple server might have profile settings as follows:

/etc/portage/make.profile/parent

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

Profile settings for a desktop might look like this: