Check my article Using portage (previously known as «Support and Update Gentoo») to find how to configure portage and safely update Gentoo.
Notes about Gentoo updates
26 Jan 2011
After upgrading x11-base/xorg-server from 1.7.7-r1 to 1.9.2 keyboard and mouse stop working. That happens because new x11-base/xorg-server doesn't support USE-flag "-hal" anymore, and try to use HAL and "evdev" driver instead of kbd/mouse drivers defined in xorg.conf.
The fix is either switch to start using HAL, evdev, … and stop using
xorg.conf, or add this line into /etc/X11/xorg.conf at Section
Option "AutoAddDevices" "False"
07 Jul 2010
Upgrade of media-libs/libpng was troublesome.
First issue is subtle situation with /usr/lib/libpng12.so.0.
While upgrading from 1.2.43-r2 to 1.4.3 you will receive notification/email
with actions needed after this upgrade, and these actions include
# rm '/usr/lib/libpng12.so.0'
But if you've installed
app-emulation/vmware-workstation, then while upgrading
libpng in addition to 1.4.3 you'll have installed (slotted) 1.2.44 too,
which also own /usr/lib/libpng12.so.0, and removing it will
broke VMware Workstation.
Second issue is even more subtle: 1.2.43-r2 contain file
/usr/lib/pkgconfig/libpng12.pc, but neither 1.2.44 nor 1.4.3
provide that file, so it will be removed while upgrade.
Removing this file broke some
dev-util/pkgconfig dependencies - at least for
x11-libs/cairo and all packages dependent on it, like
x11-libs/gtk+. This result in broken detection of
installed GTK+ version while compiling any other packages - their
./configure scripts try to run pkgconfig but got this error instead of
GTK+ version number:
# pkg-config --modversion gtk+-2.0
Package libpng12 was not found in the pkg-config search path.
Perhaps you should add the directory containing `libpng12.pc'
to the PKG_CONFIG_PATH environment variable
Package 'libpng12', required by 'cairo', not found
To solve this you've to rebuild x11-libs/cairo right
after upgrading media-libs/libpng! Just to be safe, you
can rebuild few more related packages (like pango and gtk+) too.
So, complete solution for this issue is:
# emerge -1uDNa media-libs/libpng
# emerge -1 cairo
# emerge -1 pango
# emerge -1 gtk+
# revdep-rebuild --library libpng12.so.0
# qlist -I -v libpng-1.2 | grep -q libpng || rm /usr/lib/libpng12.so.0
If you've emerged any packages after upgrading
media-libs/libpng, but before re-emerging
x11-libs/cairo, for example, if your
media-libs/libpng was upgraded while usual
# emerge -uDNa world
then some of packages emerged after media-libs/libpng
probably was build with broken dependencies, and you should re-emerge
these packages after fixing this issue as shown above.
05 Mar 2009
After upgrading sys-kernel/hardened-sources to
2.6.27-r8 (was: 2.6.26-r9) all perl scripts which
will crash on start with segmentation fault error.
To work around either relax PaX for all perl script (if you need Math::Pari):
# work around 'text file busy' error:
cp /usr/bin/perl5.8.8 /usr/bin/perl5.8.8.tmp
paxctl -m /usr/bin/perl5.8.8.tmp
mv /usr/bin/perl5.8.8.tmp /usr/bin/perl5.8.8
or just delete it (if it usage optional):
It looks like this kernel also kill www-servers/apache if it use dev-lang/php with Ioncube or ZendOptimizer.
Also it kill media-sound/amarok.
I recommend avoid using that kernel and will rollback to previous version.
Update: workaround was found.
22 Apr 2008
I've just updated sys-fs/udev to 119 (was: 115-r1)
and have few issues with it.
Command udevstart was removed from
sys-fs/udev-117, so if you use my /etc/runit/1
script you need to update it using
or just replace in /etc/runit/1
udevtrigger --attr-match=dev # only create device nodes
Few other things changed too, for example /dev/misc/psaux now just /dev/psaux (don't forget to update your /etc/X11/xorg.conf!).
08 Jul 2007
Looks like new portage (220.127.116.11) has different/broken handling of $LINGUAS. I had LINGUAS="en ru" in /etc/env.d/99local, and this portage version fail to parse "ru". Moving LINGUAS from /etc/env.d/99local to /etc/make.conf solved this issue.
15 Jun 2007
Mplayer fail to compile. Looks like this issue related to hardened, and can be fixed in two ways: either add custom-cflags to mplayer's USE flags or use patches from Gentoo bugzilla.
11 Jun 2007
After overall system recompile because of upgrading glibc I got this:
$ perl -e 'use Scalar::Util qw( weaken )'
Weak references are not implemented in the version of perl at -e line 1
BEGIN failed--compilation aborted at -e line 1.
Manual reinstallation of Scalar::Util fixed this error.
27 Mar 2007
After updating sys-apps/coreutils to 6.7-r1 (was: 6.4) I noticed cat was moved from /usr/bin to /bin! Maybe some other programs moved too... :-(
Second issue: x11-libs/xosd-2.2.10-r1 is buggy, I've masked it and downgrade to 2.2.8-r1.
25 Feb 2007
After updating sys-apps/portage to 2.1.2-r9 (was: 2.1.1-r2) emerge start complaining about 'wrong atom' in some ebuilds. To fix this you can edit these bad ebuilds, DEPEND= line, and replace things like packagename with unambiguous atom cate-gory/packagename.
15 Feb 2007
Few months ago, after mplayer upgrade OSD stop working: pressing o result in crash. (Looks like this issue described in bugzilla.) For me, recompilation of mplayer with USE-flag iconv solved this issue.
Also I recommend to add this line:
into ~/.mplayer/config if you dislike large OSD font.
09 Feb 2007
Upgrade to netqmail from qmail package.
./run files for services should be rewritten this way:
home ~ # cat /service/qmail-send/run
home ~ # cat /service/qmail-smtpd/run
Also if you doesn't moved your tcpserver configuration
from /etc/tcp.* files to /etc/tcprules.d/tcp.qmail-*
files, then do it now, because /var/qmail/supervise/qmail-smtpd/run
script will use /etc/tcprules.d/tcp.qmail-smtp.cdb instead of
/etc/tcp.smtp.cdb. Just move your configuration from
/etc/tcp.smtp to /etc/tcprules.d/tcp.qmail-smtp and run:
make -C /etc/tcprules.d/
20 Oct 2006
Upgrade to xorg-x11-7.1 and ati-drivers-8.27.10-r1 (X 7.1 require newer ATI and NVIDIA drivers) was seamless. Only issue I notice is some (WW) warnings about fglrx driver in /var/log/Xorg.0.log: looks like some options in Device section of /etc/X11/xorg.conf should be modified.
Also hardened-sources-2.6.17-r1 was marked stable, but I suggest don't upgrade it until runit-1.7 will be added into portage because there was some bugfixes related to 2.6.17.
02 Oct 2006
Flash video streaming
(like used on video.google.com)
doesn't work in opera.
Very strange bug happens only if path to
libflashplayer.so contains string 'netscape' (this library
installed in /opt/netscape/plugins/libflashplayer.so). To fix:
ln -s /opt/netscape/plugins/libflashplayer.so \
then go to Tools->Preferences->Advanced->Content->Plug-in
options and fix path for "Shockwave Flash" to use only
29 Sep 2006
Few days ago sys-kernel/linux-headers-2.6.17-r1
was marked stable on x86, so
emerge -uDNa world
try to update it. But current stable
hardened-sources is 2.6.16, so I recommend to delay updating
will be marked stable too:
echo '>=sys-kernel/linux-headers-2.6.17' \
11 Jul 2006
Upgrade to Modular X 7.0 was ease enough... but it took 3.5 hours. :-/ Problems:
- imagemagick does not compile, so I was forced to install ~x86;
- imagemagick should be compiled twice (revdep-rebuild will remind about this), or one of it's libraries and perl-module will be linked with previous imagemagick version (see bug 121142);
- some of programs I use doesn't included into Modular X by default, so I need to install them manually: xfontsel, xprop, xwininfo, xv, xset, xmessage (some of them - only ~x86).
09 Jul 2006
X Window in russian keyboard layout doesn't allow to input
# numbersign using Shift+3
because it try to input № numerosign
which not exists.
To fix put this line into your ~/.xmodmaprc:
keysym 3 = 3 numbersign
and start xmodmap with X - add this line into your ~/.xinitrc:
21 Jun 2006
After upgrading glibc-2.3.6-r3 to glibc-2.3.6-r4 russian support lost again. :( Now to setup locale which glibc should support we should use /etc/locale.gen instead of /etc/locales.build. Format of this file also was slightly changed - check comments inside it for details.
07 May 2006
After last Gentoo upgrade both unzip and xmms will hang after startup (they both installed from portage overlay RusXMMS). Update to last RusXMMS (2006_04_09) and removing ~/.rcc/ solved issue.
BTW, this RusXMMS version require USE flag rcc to work.
15 Apr 2006
After upgrading mysql-4.1.14 to mysql-4.1.14-r1 russian support is lost because of MySQL charset issue!