Sundry helpful trivia

• To be able to su(1), you must be in group wheel: usermod -G wheel user
• To be able to use the SoundCard, you must be in group audio: usermod -G audio user
• There is a thread in the Gentoo about Non-standard Portage Utilities

An emerge clobbered something vital, but I didn't see what!

This happens a lot. If you run emerge -Du world, and don't have a tediously slow machine, chances are pretty good that at some point you'll emerge a package which will "automatically" overwrite some config option. It'll tell you about it, but you probably won't be watching. The shadow package was doing this for a while, and was overwriting the PAM configuration -- screwing anyone who used any non-standard PAM options.

• Don't emerge lots of packages at once. And make sure you read the output. This isn't overly useful advice.
• Set the PORT_LOGDIR variable in /etc/make.conf, and read over the log files generated by each emerge process. Or better yet, grab portlog-info to parse the output and give you the bits you want.
• Grab ehush and use it to emerge instead -- it suppresses the noise and only shows useful information / warning content.

The last two options are ok, however this should be part of portage, not an external script. There is a bug filed against portage for this, but it's been about two years and nothing has actually happened. It's possible this will be included in the 'next version of portage', whenever that comes out.

USE flags for specific packages

You can set specific USE flags for a given package in the package attribute /etc/portage/package.use. Those flags will then be applied to that package as though they were specified on the CommandLine. Eg., to build BitTorrent without X11 support:

echo net-p2p/bittorrent -X >> /etc/portage/package.use

Masked Packages

Packages can be flagged as masked for a number of reasons. Mostly they are masked because they might break something, or they WILL break something. These tend to be masked in /usr/portage/profiles/packages.mask, and you can either forcibly install the package (see later), or unmask the package by commenting out the line. Note that this file is rebuilt everytime you emerge sync. There is rumour of support for a packages.unmask file, but this doesn't seem to work (16 Jun 2003)

The other reason packages can be masked is that they are in the 'unstable' branch of the gentoo tree. This is essentially the same as unstable in debian. Sometimes things will break, othertimes they'll be fine. You're on your own.

The only recommended way to install masked packages is to add to /etc/portage/packages.keywords an entry for the package you want to build. Do NOT, whatever you do, emerge the .ebuild directly, or try to override ACCEPT_KEYWORDS on the CommandLine. Eg., if you want to emerge XFce4 from the unstable tree, do:

echo wm-x11/xfce4 ~x86 >> /etc/portage/package.keywords
echo =wm-x11/xfce4-4.0.0 ~x86 >> /etc/portage/package.keywords # specific version of the package
echo ~wm-x11/xfce4-4.0.0 ~x86 >> /etc/portage/package.keywords # all revisions of a specific version