HowTo Compile In Gentoo

2005-03-12T22:26:44Z

151.44.23.189:

Compiling a recent version of [[aMule]] on [http://www.gentoo.org Gentoo] should be a breeze by just typing
''emerge -av amule''
but due to several facts it isn't quite that easy right now. So here's a little Step-by-Step explanation. Please read the whole document before doing anything as there are several ways you can use and each of them will have a different outcome.

Note: currently Diego "Flameeyes" Pettenò (non-official devel) is trying to make aMule merging simpler.
Please take a look at [http://bugs.gentoo.org/show_bug.cgi?id=71108 Bug #71108] for further information. The new ebuild requires wxGTK 2.5, but there is another ebuild for wxGTK 2.5 (always from Diego) which should allow to safely unmask that version.

== Stable aMule from portage ==

If you just ''emerge amule'' you will most likely get the latest package that is marked as stable in portage. This is amule-1.2.8 which is more than 12 months old, lacks several bugfixes and features which could seriously lower your download or make it impossible to connect to some servers. So that is not really an option.

== Unstable aMule from portage ==

[http://www.gentoo.org Gentoo] classifies amule2.0.0rc ebuilds as unstable because they are ReleaseCandidates. The latest one available is ''amule2.0.0rc7''. There is an (inofficial) ebuild for rc8, but as rc8 depends on ''wxGTK2.5.3'' to build the [[aMuled|aMule daemon]] and ''wxGTK2.5.3'' is hardmasked in portage.

However, if rc7 is "new enough" for you enter the following things as root into a console:

<code>mkdir /etc/portage</code> (this could give an error message if the directory already exists, just ignore that) 
<code>echo 'net-p2p/amule ~x86' >> /etc/portage/package.keywords 
emerge -av amule</code>

However rc7 is getting quite old now, so it is the best thing to use either rc8 or even a recent cvs tarball and compile amule manually.

== Recent aMule manual installation ==

Per default [http://www.gentoo.org Gentoo] uses ''gtk2'' in all recent profiles. When it comes to [[wxGTK]] (which is needed by [[aMule]]) this can be some trouble. The recent stable [[wxGTK]] in portage is ''wxGTK2.4.2'' which should never be linked against ''GTK2''. It causes random crashes, freezes, inpredictable behaviour and may even harm your pet dog!

So there are two possible ways to go: choose ''wxGTK2.4.2'' linked against ''GTK1.2'' (which should be fine for everybody who doesn't want to use [[aMuled]], the [[aMuled|aMule daemon]]) or choose ''wxGTK2.5.3'' linked either against ''GTK1.2'' or ''GTK2'' (for those who want to try [[aMuled]] as [[aMuled]] doesn't work with [[wxGTK]] prior to 2.5.3).

Another thing is unicode support: You can't enable unicode support when using ''GTK1.2'' and enabling unicode with ''GTK2'' causes huge memleaks (100MB and more in 24h). So I will just disable it in these examples.

== wxGTK2.4.2 ==

If you don't want to use [[aMuled]] then ''wxGTK2.4.2'' is just fine for. You only need to tell it that it should link against ''GTK1.2''. To do this grab a console and enter (as root):

<code>mkdir /etc/portage</code> (this may give you an error if the directory already exists, just ignore that) 
<code> echo 'x11-libs/wxGTK -gtk2 -unicode' >> /etc/portage/package-use 
emerge -av wxGTK</code>

This should (re-)emerge ''wxGTK2.4.2'' linked against ''GTK1.2''. Now you can go on to [[HowTo_Compile_In_Gentoo#compiling_amule|compiling aMule]].

== wxGTK2.5.3 ==

If you want to use amuled then you need at least ''wxGTK2.5.3''. This is currently hardmasked in portage due to problems when compiling with [http://www.opengl.org OpenGL] support. But as [[aMule]] is no 3D egoshooter we can safely disable [http://www.opengl.org OpenGL] support and use it anyway. To do so enter the following into a console as root:

<code>mkdir /etc/portage</code> (this may give you an error if the directory already exists, just ignore that) 
<code>echo '=x11-libs/wxGTK-2.5*' >> /etc/portage/package.unmask 
echo 'x11-libs/wxGTK ~x86' >> /etc/portage/package.keywords </code>

If you want to use ''GTK1.2'' (recommended): 
<code>echo 'x11-libs/wxGTK -gtk2 -unicode -opengl' >> /etc/portage/package.use </code>

If you want to use ''GTK2'' (not thoroughly tested yet): 
<code>echo 'x11-libs/wxGTK -unicode -opengl' >> /etc/portage/package.use </code>

<code>emerge -av wxGTK</code>

== Compiling [[aMule]] ==
Grab either ''amule2.0.0rc8'' from http://www.aMule.org or (specially if you want to use [[aMuled]]) a recent [[aMule CVS|CVS tarball]] from http://amule.hirnriss.net. Untar it by entering <code>tar -xvjf aMule-foo.tar.bz2</code> and go into the newly created directory.

Check <code>./configure --help</code> for a summary of all configure options. Pick the ones you want and run (as an example building the monolithic client and [[aMuleCMD]]) 
<code>./configure --enable-amulecmd</code>

Check the configure output for errors and if everything seems fine type <code>make</code>. Once [[aMule]] is done compiling change to a root account and type <code>make install</code> to install [[aMule]]. Now you're done and can start enjoying your [[aMule]] experience.

AMule Project FAQ - User contributions [en]

HowTo Compile In Gentoo