Live ebuilds

Live ebuilds are ebuilds with a version number of 9999. These ebuilds fetch updates directly from the upstream project's source code repository and will build the associated package from the latest commit.

Warning
Live ebuilds are extremely unstable, and therefore are always keyword masked.

Live ebuilds are different to regular ebuilds

Most Gentoo systems are built entirely from versioned ebuilds, which build one specific version of a package. This is one meaning of the word stable: unchanging and predictable results (USE flags notwithstanding) from a single ebuild.

Conversely, a live ebuild has a fake version number of 9999. Instead of building from a specific version, it always fetches the very latest source (sometimes called tip of tree) from the package's repository. This version could change from one minute to the next, depending on activity within the project.

This is what the above warning means by "extremely unstable": not necessarily buggy or broken, but unpredictable. Because it is impossible to know the state of the build ahead of time, a live ebuild can't be tested in the same sense a versioned ebuild is.

For example, the upstream project may make a change which requires a different version of one of its dependencies, or a new dependency altogether. If the maintainer of the Gentoo ebuild has not yet had a chance to reflect this change in the ebuild, there will likely be problems either building or running the package.

As noted below, packages installed from live ebuilds are not routinely updated with emerge --update.

For these reasons, use of live ebuilds should only be done with careful consideration of the ramifications, or if advised to by someone who has made that consideration.

Unmasking live ebuilds

A single package

Live builds will require manual unmasking in order to be installed by the package manager. For example, to unmask the live version of app-emulation/wine-staging , the following

FILE /etc/portage/package.accept_keywordsUnmasking a single live ebuilds

# Note: Accepting all keywords removes all levels of quality assurance from the system
# and is likely to result in build failures, unstable software, or other problems.
# Here be dragons! Proceed keeping these risks in mind...
app-emulation/wine-staging**

System wide

While possible to set system wide, there is very little to gain from doing so, as even the bug reports produced have so many unknown quirks that it makes them unreliable.

Consider this as a banned practice in Gentoo.

Updating live packages

All presently installed live packages can be updated by re-installing via the @live-rebuild set. This is a crude and effective approach, since Portage will re-pull and then recompile each of the packages in the set, which take a considerable amount of time.

root #emerge --ask @live-rebuild

Important
The package manager will not automatically update packages with a version number of 9999, since they are already considered to be at their maximum version. Running emerge --update @live-rebuild will perform no action, which is why the set is simply re-installed in the example above.

Smart live rebuild

The app-portage/smart-live-rebuild package provides a framework which will intelligently pull updates from each upstream source code repository for each live package installed on the system. It will only update packages which have a newer set of changes available upstream, therefore avoiding the crude approach of having to recompile all packages within the @live-rebuild set.