Disclaimer :
This document is a work in progress and should not be considered official yet.
|
The Collected Wisdom of mzbot
1.
Hot #gentoo /topic Items
Can't speak in #gentoo
/join #gentoo-ops and ask for voice. Feel free to ping an op there, we may not notice your join.
Gentoo Channel List
Some of the more popular #gentoo- channels are listed here
Linux Kernel 2.6 Local Root Exploit
Affected kernels - 2.6.17 to 2.6.24
Stable - gentoo-sources-2.6.23-r8 and later are patched
Unstable - gentoo-sources-2.6.24-r2 and later are patched
Please upgrade your kernel
Users stuck on an earlier kernel use this kernel module
make it wherever you like and insmod /path/to/kernel/module now and at every reboot.
nvidia-drivers or ati-drivers blockage
/msg mzbot faq xorg
libexpat issues
expat-2.0.1 is not ABI compatible with earlier versions. Run the following in bash to fix:
Code Listing 1.1: Emerge everything that depends on libexpat |
emerge -n1 '>=portage-2.1.2.12' portage-utils && emerge -qep world | grep --color=never -oFf <(scanelf -plRBF '%F %n' | awk '/libexpat.so.0/{print $1}' | xargs qfile -qC | sort -u; echo -e "libtool\ncurl") | xargs emerge -1
|
If a specific package fails, (gtk+/pango are common).
If, while trying to fix the expat mess, a package won't build then run the following
(substituting "gtk+" with the name of whichever package that failed):
Code Listing 1.2: if the above fails |
emerge -n portage-utils && grep -vxFf <(emerge -qep system) <(emerge -qep gtk+) | sed -rne '/^\[ebuild/{s/(^| )\[[^]]*\]( |$)//gp}' | xargs qatom | awk '{print $1"/"$2}' | xargs emerge -1".
|
Afterwards, run
Code Listing 1.3: |
emerge --resume
|
to continue.
expat-2.0.1 an alternative approach
expat-2.0.1 has been marked stable, but it is not ABI compatible with earlier versions. To fix, we recommend running
Code Listing 1.4: An alternative approach |
"emerge portage-utils gentoolkit && emerge -1 $(qlist -qICe expat gettext python XML-Parser dbus apr apr-util fontconfig libXft) && revdep-rebuild --library libexpat.so.0".
|
If gtk+ then fails, run
Code Listing 1.5: For particular problem cases |
"emerge -C gtk+ pango cairo && emerge -1 gtk+ && emerge --resume".
|
A package wants gcc-3.x
Some packages, usually pre-compiled binary packages such as mozilla-firefox-bin, are written in C++ and are only compatible with the C++
runtime library provided by gcc-3.x. If this is the case then you can avoid having to install gcc-3.x entirely by installing libstdc++-v3 beforehand
Code Listing 1.6: Emerge the library only |
emerge -1 sys-libs/libstdc++-v3
|
which provides the library without the whole gcc ... continue with your emerge that failed
mktemp blocks coreutils
As of coreutils 6.10 mktemp is included directly in the coreutils package. Just unmerge mktemp to resolve this blocker.
xorg 7.3 problems with nvidia-drivers
xorg-x11-7.3 is not yet supported by the official ati-drivers packages and, hence, are blocked.
If you are affected and wish to continue using the official drivers, then you should mask the newer version of xorg until ATI rectify the situation
Code Listing 1.7: Masking Xorg |
echo -e "=x11-base/xorg-server-1.4*\n ~x11-base/xorg-x11-7.3" && /etc/portage/package.mask.
|
KDE 4
KDE 4.0.1 is in the portage tree, hard-masked. You can get help in #genkdesvn and #gentoo-kde after reading http://xrl.us/bekfz.
Please do not ask about kde 4 in #gentoo.
apr-util vs berkdb?
Recently installed sys-libs/db-4.5* and having problems building apr/apr-util?
To fix,
Code Listing 1.8: Remove apr-util (if installed) |
emerge -C apr-util apr
|
then
Code Listing 1.9: |
emerge -1 libtool apr-util
|
2.
Help Us to Help You
#gentoo /topic
The main topic of #gentoo is support for Gentoo Linux. If your question isn't Gentoo-related, or if it's Gentoo-related, but not support-related, ops
may ask you to move the conversation to #gentoo-chat or another more appropriate channel. Note: ops are not always identified
To inform us about a problem, you need to give us the /fault/, not the error.
Error lines that begin with "!!!" or "make" are of no use to us. Fault lines, like "foobar.o: no such file or directory" or "undefined variable cabli" are.
If it is over a few lines, please use a pastebin such as http://rafb.net/paste/ (details: gentoo-detailed/error)
Don't Be Shy
Just ask, don't ask to ask, don't ask who's familiar. Don't ask if anyone knows about it.
Just ask the question, it's the easiest way to get people to answer :)
Ask Smart Questions
While this document has a bit of an "arrogant" or "elitist" tone to it, it also has a great number of good tips regarding asking good questions.
Which are more likely to get you answers. Try to look past the attitude as you read
Use a pastebin site
To inform us about a problem, you need to give us the /fault/, not the error.
Error lines that begin with "!!!" or "make" are of no use to us. Fault lines, like "foobar.o: no such file or directory" or
"undefined variable cabli" are.
If it is over a few lines, please use a pastebin such as http://rafb.net/paste/
A pastebin is a web site where you can paste many text lines or sometimes files. Try to avoid pastebin.com as it is very slow.
Consider using http://rafb.net/paste instead. If you don't have a browser you can install a pastebin helper with
Code Listing 2.1: Installing a Pastebin Helper |
emerge nopaste
|
Code Listing 2.2: Alternatively |
emerge wgetpaste
|
to send text to http://rafb.net/paste from the command line. Note that wgetpaste is preferred
Gentoo Install Guides
The Gentoo Installation procedure is well documented at Networkless Install and for the
manual install
Since the installation procedure is thorough, we can't say how to do it without continuously referring to the Gentoo Handbook,
so please read the Gentoo Handbook and ask questions if things aren't clear.
Beware Wikis
http://www.gentoo-wiki.comuri> can be a great resource, but it is not endorsed or supported by us, as wikis can be edited by anyone - even the uninformed
and malicious. We may ask you to go read the official documentation
3.
I'm Installing Gentoo for the first time and ...
Odds 'n Ends
Your router is vulnerable to an exploit. To you it probably looks like your Internet connection just drops, but it's actually triggered by a crafted string.
Please read this page (thoughtfully provided by Ubuntu) for more information: http://xrl.us/2hn8
http://www.gentoo.org/doc/en/handbook/index.xml
GNU screen is a "terminal multiplexer". You can run multiple console-based applications within a single screen "session".
Support for detaching means that you can use it to keep programs running after you close your terminal, or even after you log out,
and later resume right where you were by re-attaching to your screen session. Also, sessions can be shared between multiple users.
Tutorial: http://tinyurl.com/4q7jo
The file /etc/portage/package.keywords contains a list of packages of which Portage should accept the non-tested versions (~arch).
Ideally to use a couple of non-tested packages on your system.
Run "man portage" for more information. See also {~arch}
~arch is a KEYWORD setting (f.i. ~x86, ~ppc, ...) for a certain package denoting that that package has been found stable
by the developer but needs testing before it reaches the "stable" Gentoo Portage tree.
Usually, this means around 30 days without any bugs. Have patience, and it will reach your system eventually.
See also {package.keywords}
Don't use the SMBFS client in the Linux kernel. Use CIFS! It supports shares hosted by Windows 2000 (or greater) and Samba.
It is actively maintained upstream, more reliable, more performant and supports features such as unicode, hardlinks, dfs,
distributed caching and native TCP names (rather than RFC1001/NetBIOS names), not to mention Unix extensions.
For more info: http://linux-cifs.samba.org/
http://www.gentoo.org/doc/en/kde-split-ebuilds.xml
http://www.gentoo.org/doc/en/dri-howto.xml
Grub Errors
(Installation Related Resources/Other Installation Related Documentation/Gentoo Grub Error Collection)
Gentoo releases only affect the installation media (new hardware support for the CD and such).
If you already have a working Gentoo installation, update your system profile, for example:
" ln -snf /usr/portage/profiles/default-linux/x86/2006.1/desktop /etc/make.profile ",
and system:
Code Listing 3.1: Updating Gentoo |
emerge --sync && emerge -uDNp world
|
(check your USE flags!) and you're using the latest and greatest.
4.
About Package Managers
Portage
Portage is Gentoos' software management system, built to provide as much flexibility as possible.
It uses ebuilds as package format and supports both source code packages (most used) and binary packages (such as GRP).
See parts 2 and 3 of the Gentoo Handbook
Paludis
Paludis is an alternate package manager. It is not an official gentoo project, so for help you should go to #paludis or its
home page
Pkgcore
pkgcore is an alternative package manager. It is not an official Gentoo project.
You can get help at here or on freenode at #pkgcore
Using Package Managers to Install and Update
Here is an explanation of the --upgrade and -deep flags (the usage of the word "build" here means either install or upgrade):
emerge <pkg> == build <pkg>, building only deps that are _needed_ to do so |
emerge -u <pkg> == build <pkg>, also opportunistically building any deps directly defined by <pkg> |
emerge -uD <pkg> == build <pkg>, recursing _all_ deps derived from <pkg> and opportunistically building them
The system target
As far as emerge is concerned, the "system" target defines a collection of packages which are considered as mandatory in any
Gentoo Linux installation and, as such, are also present within the contents of a stage tarball. Note that the "world" target always
implies "system". To see a list of these packages, run "emerge -ep system"
5.
Profiles
Chose a desktop or server profile
You'll want to use the 2007.0/desktop subprofile, not 2007.0 itself, as the later is extremely minimalist USE flag wise.
No jpeg support is a common symptom. Use 'eselect' to change profiles.
You should do an emerge -DuN world at some point after this. ('mzbot: faq eselect profile' for more.)
eselect profile list will list available profiles. Choose your desired profile by number from that list, and then run
'eselect profile set N' from that list to change your current profile.
You may want to read http://www.gentoo.org/doc/en/gentoo-upgrading.xml too.
6.
Risky Things to do with your Gentoo
Changing CHOST
Changing your CHOST is possible, but discouraged. It is very easy to destroy your installation if you do not follow instructions very well.
Please see http://www.gentoo.org/doc/en/change-chost.xml if you will be doing this.
If you have a Pentium III or better, do *not* choose the x86 tarball. You want the 686 tarball.
The x86 one does not use i686-pc-linux-gnu as CHOST, which means you usually end up changing CHOST, which is a hassle.
Upgrading gcc http://www.gentoo.org/doc/en/gcc-upgrading.xml
7.
Admin and Disipline
Channel Disipline
Channel disipline is enforced by the various channel operators. Operators are not always identifed but will usually warn
in channel when unacceptable behavioue is spotted. Of course, any user can do this. Continued unacceptable behavior will
lead to a /kick or a /ban.
Should you feel any or all of these steps were unjustified, please take the discusion to #gentoo-ops, which is where discussion
of the management of #gentoo is on topic.
In the event the situation cannot be resolved, you can contact one of the Gentoo channel group contacts.
Group Contacts
8.
Old Topics ... Useful if you don't update very often
XMMS has Gone
xmms has been removed from portage, due to long standing bugs, and also the project has seen no new releases
for a long time.
Some alternatives include audacious and amarok. If you find ebuilds with hard dependancies on xmms,
please file bugs against them. If you want to complain, complain to gentoo's userrel,
not to xmms devs. also look here
Monolithic Xorg is Gone
mask virtual/x11 has been masked. What this means is that you should move to modular xorg. Modular xorg has been in gentoo for a long time now,
so the time has come for users to move to it. Please follow the modular xorg howto, found here: http://xrl.us/kjcy
Gentoo Forums Upgrade Complete
Forums downtime: The forums will be readonly starting later in the day on 2007-09-07, and will be down completely later in the weekend.
Info: http://gentooexperimental.org/~patrick/forums.html
Status: http://gentoo.org/proj/en/forums/forum-downtime200709.xml If you have questions not answered by these two pages, join #gentoo-forums
9.
Distros Derived From Gentoo
Sabayon for example
Sabayon is a distribution based on Gentoo Linux. However, we did not make it, and so we unfortunately can't support it.
Please utilize the support channels which exist for Sabayon, such as #sabayon. We're sorry if their channel is quiet, we can't change that :)
We are only using Sabayon as an example, there are other distros derived from Gentoo and the same applies. They are not Gentoo, we don't
know how they differ from Gentoo, so we cannot support them
10.
More Coming Soon ...
The contents of this document, unless otherwise expressly stated, are licensed under the CC-BY-SA-2.5 license. The Gentoo Name and Logo Usage Guidelines apply.
|