Gentoo Logo

Gentoo Prefix

Content:

1.  Project Description

To bring out the virtues of Gentoo Linux on different operating systems, the Gentoo Prefix project develops and maintains a way of installing Gentoo systems in a non-standard location, designated by a "prefix".

Usually, Gentoo Linux's package manager (portage) installs in the root of the filesystem hierarchy known as /. On systems other than Gentoo Linux, this usually results in problems, due to conflicts of software packages , unless the OS is adapted like Gentoo/FreeBSD. Instead, Gentoo Prefix installs within an offset, known as a prefix, allowing users to install Gentoo in another location in the filesystem hierarchy, hence avoiding conflicts. Next to this offset, Gentoo Prefix runs unprivileged, meaning no root user or rights are required to use it.

By using an offset (the "prefix" location), it is possible for many "alternative" user groups to benefit from a large part of the packages in the Gentoo Linux Portage tree. Currently users of the following systems successfully run Gentoo Prefix: Mac OS X on PPC and x86, Linux on x86, x86_64 and ia64, Solaris 10 on Sparc, Sparc/64, x86 and x86_64, FreeBSD on x86, AIX on PPC, Interix on x86, Windows on x86 (with the help of Interix), HP-UX on PARISC and ia64.

2.  Getting Started

Bootstrapping

To get a prefixed Portage installed on your system, you need to go through a few steps we call bootstrapping. We currently only have detailed guides on Mac OS X and Solaris systems, but if you have another system, following the Solaris guide might be enough for you. The systems that are known to work with a prefixed Portage are various Linux systems and FreeBSD. Note that, for systems where bash is missing, you need to bootstrap it first with the bootstrap-bash.sh script. It can be found next to bootstrap-prefix.sh as indicated by the guides.

Windows users can get directly up to speed using the Interix installers.

Helper Scripts

To ease the setup of a prefixed Portage installation, the Gentoo Prefix project provides a script called bootstrap-prefix.sh. This script is a sort of kickstart in the bootstrap process, automating downloading the Portage tree, installing Portage and the necessary temporary helper applications. In addition, it tries to setup a profile and prepares those settings that it can deduce automatically.

The location of the correct bootstrap-prefix.sh script as well as how and when to use it is described the bootstrap process guide.

Bootstrap Guides

The following guides give a detailed description on how to install a Gentoo Prefix system.

Windows users can find the documentation and ISO images for the Interix port of Gentoo Prefix on our mirrors.

More documentation as well as pointers for support can be found in our Resources section.

3.  Developers

Developer Nickname Role
Fabian Groffen grobian Lead ( maintainer Prefix Portage )
Jeremy Olexa darkside Developer
Michael Haubenwallner haubi Developer
Benda XU heroxbd Developer
Jonathan Callen jcallen Developer
Markus Duft mduft Developer
Christoph Junghans ottxor Developer ( merge with gx86 )
Ruud Koolen redlizard Developer

All developers can be reached by e-mail using nickname@gentoo.org.

4.  Developer Platforms

Platform Matrix

To keep track of the supported platforms, the following matrix is maintained. It also provides feedback on which developer is maintaining the platform or has direct access to such systems.

grobian haubi mduft darkside jcallen heroxbd ottxor redlizard other support
x86-linux x x o x x x o excellent
amd64-linux o x o x x x x excellent
ia64-linux bad
arm-linux x o good
ppc-aix x o o ok
x86-freebsd bad
x64-freebsd o ok
hppa-hpux x o ok
ia64-hpux x x good
x86-interix o x ok
ppc-macos x ok
x86-macos x o x a good
x64-macos x x a good
m68k-mint a ok
x86-netbsd v bad
ppc-openbsd v bad
x86-openbsd v bad
x64-openbsd v bad
sparc-solaris x x x a excellent
sparc64-solaris x a good
x86-solaris x x x a excellent
x64-solaris x ok
x86-winnt o x ok

Legend:

Symbol Meaning
x actively maintained by developer
o accessible to developer
v outdated
a actively maintained by a user/contributor
e experimental effort by user/contributor

5.  Resources

Resources offered by the prefix project are:

6.  Gentoo Prefix Hall of Fame

Past Developers

Over time, developers come and go again. Some mysteriously disappear, others loose interest and decide to leave. For all past contributors we would like to express our gratitude towards them for helping the Prefix project to become what it is today.

Past Prefix Developers
ferringb initial Portage developer to start the Prefix branch
kito first prototypes of Prefix using a tree, Mac OS X installer, many first time engineering and development tasks
exg Prefix Portage maintainer
genstef import of gtk+, qt4 and X11 applications for Mac OS X
pipping many package additions for Perl, Python, Ruby and Java, lots of Mac OS X targetted fixes and features, pioneer for Darwin9 (Leopard 10.5) support
drizzt mostly reviving Solaris 9 support, by fixing packages in the tree
fauli gave FreeBSD 8 support a boost, some Interix testing


Print

Page updated February 18, 2014

Summary: Gentoo Prefix

Fabian Groffen
Author

Donate to support our development efforts.

Copyright 2001-2014 Gentoo Foundation, Inc. Questions, Comments? Contact us.