AMule Project FAQ - User contributions [en]

Current events

2005-01-23T14:37:11Z

80.224.220.31:

Please visit [http://www.amule.org/amule/board.php?boardid=8&sid= '''aMule news'''] to know about the latest [[aMule]] events.

About current events in this [http://wikipedia.sf.net wiki], please check our [[TODO]] page.

HowTo compile on Mac

2005-01-21T23:18:37Z

80.224.220.31:

The following steps will lead you to install [[aMule]] in your [http://www.apple.com/macosx MacOS X] box.

You can get also the most recent binnary of [[aMule]] for [http://www.apple.com/macosx MacOS X] dowloading this: http://download.berlios.de/amule/aMule.zip

This HowTo is written to compile and install [[aMule]] 2.0.0-rc8. It will not work for older versions. Please note that you should always download the latest [[aMule]] version available.

'''NOTE:''' This document explains how to download files using [http://curl.haxx.se curl]. However, [http://curl.haxx.se curl] might not be installed on your system: either install it (you can use [http://fink.sourceforge.net Fink] to install it) or download the files with whatever application you want (maybe your web browser), but place them in the directory that's being used on each part of the guide, otherwise the commands that are shown here will not work.

== Setting up the required environment ==

These steps are one-time-only steps necessary for the steps in the following sections to work properly.

# [http://developer.apple.com/tools/xcode Xcode]
## Install [http://developer.apple.com/tools/xcode Xcode Tools] from http://developer.apple.com/tools/download
## "Getting ADC ID"->"Log In"->"Download Software"->"Developer Tools"->"Download Xcode Tools last release">"Install"
# [http://fink.sourceforge.net Fink]
## Install (or verify installation if already installed) [http://fink.sourceforge.net Fink] from http://fink.sourceforge.net/download
# [http://www.gnu.org/software/gettext gettext]
## Using [http://fink.sourceforge.net Fink], install [http://www.gnu.org/software/gettext gettext]. Read [http://fink.sourceforge.net/download Fink's installation guide] to learn how to install applications through [http://fink.sourceforge.net Fink] (the [http://www.gnu.org/software/gettext gettext] package is ''gettext'').
# Working directories
## Make ''amule'' dir in your home directory: ''mkdir ~/amule''
## Make ''wxmac'' dir in your home directory: ''mkdir ~/wxmac''

== Obtaining [[wxMac]] sources ==

'''ATTENTION:''' [[wxMac]] 2.5.3 has a couple of bugs which cause [[aMule]] 2.0.0-rc8 to crash. One bug causes [[aMule]] to crash just after starting up, the other causes it to crash at a random later time :-(. The only work-around is to pull the [[wxWidgets]] sources from [[wx-cvs|CVS]]!

You have two options, downloading a [[wx-cvs|CVS]] snapshot or performing a checkout through the [[wxWidgets]] [[wx-cvs|CVS]] server. The snapshot may be faster to download; the [[wx-cvs|CVS]] server will give you the most up-to-date sources and the most flexibility if you need sources from a previous day (for example, to avoid bugs that may crop up in the ever-changing source). On the other hand, the sources from the snapshot, once extracted, take nearly 6 times as much disk space as those checked out from the [[wx-cvs|CVS]] server because they include files not necessary for compiling on [http://macosx.apple.com MacOS X].

'''NOTE:''' As of 2005-01-18, the [[wxMac]] developers have approved the patch for the last of these crashing bugs. Therefore, it is no longer necessary for you to apply any patches yourself. A checkout from the [[wx-cvs|CVS]] server will include the fix. The [[wx-cvs|CVS]] snapshot won't include the fix until 2005-01-19, so until then use the [[wx-cvs|CVS]] server checkout method.

=== '''Option 1:''' Obtaining [[wxMac]] sources from [[wx-cvs|CVS]] snapshot ===

These instructions were adapted from http://wxwidgets.org/cvs.htm

# Enter the ''wxmac'' directory: ''cd ~/wxmac''
# Get the [[wxMac]] [[wx-cvs|CVS]] snapshot (found at http://wxwindows.sourceforge.net/snapshots as ''wx-cvs.tar.bz2'') and place it in your ''~/wxmac'' directory: ''curl -O http://biolpc22.york.ac.uk/pub/CVS_HEAD/wx-cvs.tar.bz2''
# Extract it: ''tar -xjf wx-cvs.tar.bz2''
# '''Optional:''' You may delete the archive after extracting its contents: ''rm wx-cvs.tar.bz2''

=== '''Option 2:''' Obtaining [[wxMac]] sources from [[wx-cvs|CVS]] server ===

These instructions were adapted from http://wxwidgets.org/cvs.htm

# Enter the ''wxmac'' directory: ''cd ~/wxmac''
# Login (anonymously) to the wxWidgets CVS server (when prompted, enter ''anoncvs'' as the password): ''cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets login''
# Checkout the [[wxMac]] sources from CVS: ''cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets checkout wxMac''

== '''Optional:''' Patching the [[wxMac]] sources ==

'''NOTE:''' As explained above, it is no longer necessary to patch the [[wxMac]] sources to avoid crashing bugs. This section remains for those adventurous souls willing to apply the as-yet-unapproved patches for some memory leaks.

The [[wxMac]] sources still contain some bugs which cause [[aMule]] to leak memory. Patches to fix [[wxMac]] have been submitted to the [[wxWidgets]] team. These patches have not yet been approved by the wxWidgets developers and so should be considered experimental and approached with caution.

# Enter the ''wxmac'' directory: ''cd ~/wxmac''
# Patch some memory leaks in [[wxMac]].
## Download the patch files: ''curl "http://sourceforge.net/tracker/download.php?group_id=9863&atid=309863&file_id=112952&aid=1088052" -o ctable.patch "http://sourceforge.net/tracker/download.php?group_id=9863&atid=309863&file_id=112949&aid=1088038" -o bitmap.patch''
## Apply the patches: ''cat ctable.patch bitmap.patch | patch -p0 -d wxWidgets''

== Installing [[wxMac]] from sources ==

# Enter the directory containing the [[wxMac]] sources: ''cd ~/wxmac/wxWidgets''
# Directory ''build'' should already be there. If not, create it with: ''mkdir build''
# Now enter ''build'' directory: ''cd build''
# Prepare the compilation: ''../configure''
# And compile: ''make''
# Now install [[wxMac]] compilation: ''sudo make install''
# Get back to your home directory, you're done: ''cd ~''
# '''Optional:''' If everything went ok, you can safely remove the [[wxMac]] sources (not recommended, since you might want to compile it again someday): ''rm -r ~/wxmac''

== Compiling and installing [[aMule]] ==

# Enter the ''amule'' directory: ''cd ~/amule''
# Get [[aMule]]'s latest source code (aMule 2.0.0-rc8 sourcecode: [http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2 http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2]) and place it in your ''~/amule'' directory: ''curl -O http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2''
# Extract it: ''tar -xjf aMule-2.0.0rc8.tar.bz2''
# Enter [[aMule]]'s sources directory: ''cd aMule-2.0.0rc8''
# Prepare the compilation (thanks to '''one_2_one''' and '''Babboia''' for his test&fix): ''./configure --disable-systray --disable-gtk --with-wx-config=/usr/local/bin/wx-config''
# And compile it: ''make''
# '''Optional:''' You can reduce the size of [[aMule]] from 44MB to 3MB by doing the following (anyway, this will make the [[aMule]] binary lose debug info, so you'll be unable to report problems to the [[aMule devs|aMule Team]] to make [[aMule]] a better program; so, it is not recommended): ''strip src/amule''
# Copy the ''amule'' binary to the app-Container directory: ''cp src/amule amule.app/Contents/MacOS/'' ('''NOTE:''' If the ''MacOS'' directory is missing in ''amule.app'', create it by typing ''mkdir amule.app/Contents/MacOS'' before executing the previous command. Thanks to '''dan''' for the tip)
# And copy ''amule.app'' directory to your Applications folder: ''cp -R amule.app /Applications''
# Get back to your home directory, you're done: ''cd ~''
# If everything went OK, you can safely remove the downloaded packages:
## Remove [[aMule]]'s sources package: ''rm ~/amule/aMule-2.0.0rc8.tar.bz2''
## Optionally remove the extracted [[aMule]] sources (not recommended, since you might want to compile it again someday): ''rm -r ~/amule''

== Problems and solutions ==

*If [http://fink.sourceforge.net Fink] reports something like: ''After unpacking 11.2GB will be freed'', don't be afraid. [http://fink.sourceforge.net Fink] has evolved into a different way of managing packet's size and some old ("old": at least some months old) packages' sizes aren't handled correctly on the output. If this is your case, devide the number by 1024. So, what the above example really means is: ''After unpacking 11.2MB will be freed''.

*If you get an error like this: ''You cannot open the application "amule" because it may be damaged or incomplete'', right click on ''amule'', then click on ''Show Packages Contents'', go to "Contents">"MacOS"> and double click on ''amule''. Next time you start from ''amule.app'' it will run fine. If you still get the same error, move ''amule.app'' to the desktop and run it from there.

== Older releases ==

In older releases ([[aMule]] 2.0.0-rc7 and earlier), the app container wasn't included with the sources. If you are compiling any of this older releases and do not whish to upgrade (remember it is '''strongly''' recommended to upgrade to the latest release), you can:

*Download the latest [[aMule]] sources and get the app container from there (recommended option).
*Download [http://download.berlios.de/amule/aMule-App-Container.tar.bz2 aMule's app-Container]: ''curl -O http://download.berlios.de/amule/aMule-App-Container.tar.bz2''

You must extract the app container in your ''amule'' directory: possible ''~/amule''
To extract it: ''tar -xjf aMule-App-Container.tar.bz2''

'''NOTE:''' If the app-Container failed to extract try running this command instead of the app-Container extraction step: ''mkdir -p amule.app/Contents/MacOS''

Once the installation is finished, you can safely remove the app-Container package: ''rm aMule-App-Container.tar.bz2''

Reviews

2005-01-20T15:26:58Z

80.224.220.31:

__NOTOC__

{| align="center" |
|+ valign="top" |
== Releases ==

| valign="top" width=200 |
=== [http://www.kernel.org Linux] ===
{| border=1 width=200 |
|
[http://www.aMule.org aMule.org (Official)]

[http://developer.berlios.de/projects/amule BerliOS (Official)]

[http://sourceforge.net/projects/amule SourceForge]

[http://freshmeat.net/projects/amule FreshMeat]

[http://klik.atekon.de/details.php?section=x11/&package=amule Klik]

[http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=amule Debian bugs]

[http://www.gentoo-portage.com/net-p2p/amule/bugs Gentoo bugs]

[http://archlinux.org/packages.php?id=5640 ArchLinux]

[http://www.rocklinux.net/packages/amule.html RockLinux]

[http://bugzilla.conectiva.com/show_bug.cgi?id=11273 Conectiva Linux]

[http://gobo.calica.com/descriptions/amule GoboLinux]
|}

| valign="top" |
=== [http://www.bsd.org BSD] ===
{| border=1 width=200 |
|
[http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/amule FreeBSD (BSD)]

[http://www.freshports.org/net/amule FreshPorts (BSD)]
|}

=== [http://macosx.apple.com MacOS X] ===
{| border=1 width=200 |
|
[http://www.macupdate.com/info.php/id/16818 MacUpdate]

[http://www.versiontracker.com/dyn/moreinfo/macosx/23853&vid=152872 VersionTracker]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}
|}

{| align="center"
| valign="top" width=200 align="center" |
== Descriptions ==
{| border=1 width=200 |
|
[[AMule|aMule Wiki]]

[http://www.slyck.com/prog.php?id=142 Slyck]

[http://en.wikipedia.org/wiki/AMule WikiPedia]

[http://wiki.linuxquestions.org/wiki/AMule LinuxQuestions]

[http://www.encyclopedia-online.info/AMule Encyclopedia Online]

[http://www.yotor.com/wiki/en/am/AMule.htm Yotor]

[http://www.searchspaniel.com/index.php/AMule SearchSpaniel]
|}
|}

{| align="center"
|
| valign="top" align="center" |
== Reviews ==
|

|-

| valign="top" width=200 |
=== English ===
{| border=1 width=200 |
|
[http://softpedia.com/get/UNIX/Networking/Client-Applications/aMule.shtml SoftPedia]

[http://www.gnomefiles.org/app.php?soft_id=472 GNOME Files]

[http://www.comfm.com/download/?log=122 comfm]

[http://heidelberg.freshrpms.net/rpm/amule FreshRPMs]

[http://addict3d.org/index.php?page=downloadfile&ID=3140 Addict3D]

[http://www.software-facilities.com/net-software/amule.php Software Facilities]

[http://ukrainer.ru/article76.html ukrainer.ru]

[http://www.linuxsoft.cz/en/sw_detail.php?id_item=2029 LinuxSoft]

[http://www.linuxpackages.net/pkg_details.php?id=3589 LinuxPackages]

[http://www.rocklinux.net/packages/amule.html RockLinux]

[http://www.ratiatum.com/logitheque.php?id_cat=5&id_log=340 Ratiatum]

[http://linuxfr.org/~motodashi/10160.html LinuxFr]

[http://www2.openmedia.info:8080/p26.html OpenMedia]

[http://yarrow.freshrpms.net/rpm.html?id=1268 FreshRPMs]

[http://www.angelfire.com/nv/claytonpage/docs/amule_install.txt AngelFire]

[http://www.stargeek.com/item/202436.html StarGeek]

[http://mp3.box.sk/codebox.links.php?id=4659&pid=mp3soft&subject=MP3+software+%3A%3A+mp3+search+software&key=mp3searchs MP3 box.sk]
|}

| valign="top" width=200 |
=== Spanish ===
{| border=1 width=200 |
|
[http://alts.homelinux.net/libreapp.php?id=289 Alternativas Libres]

[http://descargas.terra.es/informacion_extendida.phtml?n_id=32021&plat=4 Descargas Terra]

[http://www.softonic.com/ie/32021/aMule Softonic]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}

=== French ===
{| border=1 width=200 |
|
[http://www.infos-du-net.com/news/2029-amule.html Infos-du-Net]

[http://routes-linux.scooba.org/amule.php Routes Linux]

[http://www.linuxfrench.net/article.php3?id_article=1332 LinuxFrench]

[http://starstones.free.fr/src/amule Linux on Mandrake]

[http://www.linuxpourlesnuls.org/modules.php?name=Sections&op=viewarticle&artid=34 Linux pour les nuls]
|}

=== German ===
{| border=1 width=200 heigh="100%" |
|
[http://www.tuxfutter.de/wiki/AMule TuxFutter]

[http://www.pctipp.ch/downloads/dl/29318.asp PCtipp]

[http://www.userchannel.de/wissen/docs/aMule%20unter%20Linux%20installieren UserChannel]
|}

| valign="top" |
=== Italian ===
{| border=1 width=200 |
|
[http://www.pc-facile.com/aMule_s318 PC Facile]
|}

=== Portuguese ===
{| border=1 width=200 heigh="100%" |
|
[http://pl.wikipedia.org/wiki/AMule Portuguese]

[http://www.linuxrapido.org/modules.php?name=Sections&op=viewarticle&artid=84&page=1 LinuxRapido]
|}

=== Catalan ===
{| border=1 width=200 |
|
[http://www.comesfa.org/node/199 ComEsFa P2P]

[http://www.comesfa.org/node/268 ComEsFa aMule]
|}

=== Croatian ===
{| border=1 width=200 |
|
[http://www.linuxsoft.cz/sw_detail.php?id_item=2029 LinuxSoft]

[http://www.sosej.cz/program.php?pid=763 Sosej]
|}

=== Polish ===
{| border=1 width=200 |
|
[http://www.idg.pl/ftp/linux_202/aMule.1.0.8.html IDG.pl]

[http://p2p.info.pl/index.php?module=subjects&func=viewpage&pageid=6 Polskie Centrum P2P]
|}
|}

Reviews

2005-01-20T15:26:00Z

80.224.220.31:

__NOTOC__

{| align="center" |
|+ valign="top" |
== Releases ==

| valign="top" width=200 |
=== [http://www.kernel.org Linux] ===
{| border=1 width=200 |
|
[http://www.aMule.org aMule.org (Official)]

[http://developer.berlios.de/projects/amule BerliOS (Official)]

[http://sourceforge.net/projects/amule SourceForge]

[http://freshmeat.net/projects/amule FreshMeat]

[http://klik.atekon.de/details.php?section=x11/&package=amule Klik]

[http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=amule Debian bugs]

[http://www.gentoo-portage.com/net-p2p/amule/bugs Gentoo bugs]

[http://archlinux.org/packages.php?id=5640 ArchLinux]

[http://www.rocklinux.net/packages/amule.html RockLinux]

[http://bugzilla.conectiva.com/show_bug.cgi?id=11273 Conectiva Linux]

[http://gobo.calica.com/descriptions/amule GoboLinux]
|}

| valign="top" |
=== [http://www.bsd.org BSD] ===
{| border=1 width=200 |
|
[http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/amule FreeBSD (BSD)]

[http://www.freshports.org/net/amule FreshPorts (BSD)]
|}

=== [http://macosx.apple.com MacOS X] ===
{| border=1 width=200 |
|
[http://www.macupdate.com/info.php/id/16818 MacUpdate]

[http://www.versiontracker.com/dyn/moreinfo/macosx/23853&vid=152872 VersionTracker]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}
|}

{| align="center"
| valign="top" width=200 align="center" |
== Descriptions ==
{| border=1 width=200 |
|
[[AMule|aMule Wiki]]

[http://www.slyck.com/prog.php?id=142 Slyck]

[http://en.wikipedia.org/wiki/AMule WikiPedia]

[http://wiki.linuxquestions.org/wiki/AMule LinuxQuestions]

[http://www.encyclopedia-online.info/AMule Encyclopedia Online]

[http://www.yotor.com/wiki/en/am/AMule.htm Yotor]

[http://www.searchspaniel.com/index.php/AMule SearchSpaniel]
|}
|}

{| align="center"
|
| valign="top" align="center" |
== Reviews ==
|

|-

| valign="top" width=200 |
=== English ===
{| border=1 width=200 |
|
[http://softpedia.com/get/UNIX/Networking/Client-Applications/aMule.shtml SoftPedia]

[http://www.gnomefiles.org/app.php?soft_id=472 GNOME Files]

[http://www.comfm.com/download/?log=122 comfm]

[http://heidelberg.freshrpms.net/rpm/amule FreshRPMs]

[http://addict3d.org/index.php?page=downloadfile&ID=3140 Addict3D]

[http://www.software-facilities.com/net-software/amule.php Software Facilities]

[http://ukrainer.ru/article76.html ukrainer.ru]

[http://www.linuxsoft.cz/en/sw_detail.php?id_item=2029 LinuxSoft]

[http://www.linuxpackages.net/pkg_details.php?id=3589 LinuxPackages]

[http://www.rocklinux.net/packages/amule.html RockLinux]

[http://www.ratiatum.com/logitheque.php?id_cat=5&id_log=340 Ratiatum]

[http://linuxfr.org/~motodashi/10160.html LinuxFr]

[http://www2.openmedia.info:8080/p26.html OpenMedia]

[http://yarrow.freshrpms.net/rpm.html?id=1268 FreshRPMs]

[http://www.angelfire.com/nv/claytonpage/docs/amule_install.txt AngelFire]

[http://mp3.box.sk/codebox.links.php?id=4659&pid=mp3soft&subject=MP3+software+%3A%3A+mp3+search+software&key=mp3searchs MP3 box.sk]
|}

| valign="top" width=200 |
=== Spanish ===
{| border=1 width=200 |
|
[http://alts.homelinux.net/libreapp.php?id=289 Alternativas Libres]

[http://descargas.terra.es/informacion_extendida.phtml?n_id=32021&plat=4 Descargas Terra]

[http://www.softonic.com/ie/32021/aMule Softonic]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}

=== French ===
{| border=1 width=200 |
|
[http://www.infos-du-net.com/news/2029-amule.html Infos-du-Net]

[http://routes-linux.scooba.org/amule.php Routes Linux]

[http://www.linuxfrench.net/article.php3?id_article=1332 LinuxFrench]

[http://starstones.free.fr/src/amule Linux on Mandrake]

[http://www.linuxpourlesnuls.org/modules.php?name=Sections&op=viewarticle&artid=34 Linux pour les nuls]
|}

=== German ===
{| border=1 width=200 heigh="100%" |
|
[http://www.tuxfutter.de/wiki/AMule TuxFutter]

[http://www.pctipp.ch/downloads/dl/29318.asp PCtipp]

[http://www.userchannel.de/wissen/docs/aMule%20unter%20Linux%20installieren UserChannel]
|}

| valign="top" |
=== Italian ===
{| border=1 width=200 |
|
[http://www.pc-facile.com/aMule_s318 PC Facile]
|}

=== Portuguese ===
{| border=1 width=200 heigh="100%" |
|
[http://pl.wikipedia.org/wiki/AMule Portuguese]

[http://www.linuxrapido.org/modules.php?name=Sections&op=viewarticle&artid=84&page=1 LinuxRapido]
|}

=== Catalan ===
{| border=1 width=200 |
|
[http://www.comesfa.org/node/199 ComEsFa P2P]

[http://www.comesfa.org/node/268 ComEsFa aMule]
|}

=== Croatian ===
{| border=1 width=200 |
|
[http://www.linuxsoft.cz/sw_detail.php?id_item=2029 LinuxSoft]

[http://www.sosej.cz/program.php?pid=763 Sosej]
|}

=== Polish ===
{| border=1 width=200 |
|
[http://www.idg.pl/ftp/linux_202/aMule.1.0.8.html IDG.pl]

[http://p2p.info.pl/index.php?module=subjects&func=viewpage&pageid=6 Polskie Centrum P2P]
|}
|}

Reviews

2005-01-20T12:47:26Z

80.224.220.31:

__NOTOC__

{| align="center" |
|+ valign="top" |
== Releases ==

| valign="top" width=200 |
=== [http://www.kernel.org Linux] ===
{| border=1 width=200 |
|
[http://www.aMule.org aMule.org (Official)]

[http://developer.berlios.de/projects/amule BerliOS (Official)]

[http://sourceforge.net/projects/amule SourceForge]

[http://freshmeat.net/projects/amule FreshMeat]

[http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=amule Debian bugs]

[http://www.gentoo-portage.com/net-p2p/amule/bugs Gentoo bugs]

[http://archlinux.org/packages.php?id=5640 ArchLinux]
|}

| valign="top" |
=== [http://www.bsd.org BSD] ===
{| border=1 width=200 |
|
[http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/amule FreeBSD (BSD)]

[http://www.freshports.org/net/amule FreshPorts (BSD)]
|}

=== [http://macosx.apple.com MacOS X] ===
{| border=1 width=200 |
|
[http://www.macupdate.com/info.php/id/16818 MacUpdate]

[http://www.versiontracker.com/dyn/moreinfo/macosx/23853&vid=152872 VersionTracker]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}
|}

{| align="center"
| valign="top" width=200 align="center" |
== Descriptions ==
{| border=1 width=200 |
|
[[AMule|aMule Wiki]]

[http://en.wikipedia.org/wiki/AMule WikiPedia]

[http://wiki.linuxquestions.org/wiki/AMule LinuxQuestions]

[http://www.encyclopedia-online.info/AMule Encyclopedia Online]

[http://www.yotor.com/wiki/en/am/AMule.htm Yotor]

[http://www.searchspaniel.com/index.php/AMule SearchSpaniel]
|}
|}

{| align="center"
|
| valign="top" align="center" |
== Reviews ==
|

|-

| valign="top" width=200 |
=== English ===
{| border=1 width=200 |
|
[http://softpedia.com/get/UNIX/Networking/Client-Applications/aMule.shtml SoftPedia]

[http://www.gnomefiles.org/app.php?soft_id=472 GNOME Files]

[http://www.comfm.com/download/?log=122 comfm]

[http://heidelberg.freshrpms.net/rpm/amule FreshRPMs]

[http://addict3d.org/index.php?page=downloadfile&ID=3140 Addict3D]

[http://www.software-facilities.com/net-software/amule.php Software Facilities]

[http://ukrainer.ru/article76.html ukrainer.ru]

[http://www.linuxsoft.cz/en/sw_detail.php?id_item=2029 LinuxSoft]

[http://www.linuxpackages.net/pkg_details.php?id=3589 LinuxPackages]

[http://www.rocklinux.net/packages/amule.html RockLinux]

[http://www.ratiatum.com/logitheque.php?id_cat=5&id_log=340 Ratiatum]

[http://linuxfr.org/~motodashi/10160.html LinuxFr]

[http://www2.openmedia.info:8080/p26.html OpenMedia]

[http://yarrow.freshrpms.net/rpm.html?id=1268 FreshRPMs]

[http://mp3.box.sk/codebox.links.php?id=4659&pid=mp3soft&subject=MP3+software+%3A%3A+mp3+search+software&key=mp3searchs MP3 box.sk]
|}

| valign="top" width=200 |
=== Spanish ===
{| border=1 width=200 |
|
[http://alts.homelinux.net/libreapp.php?id=289 Alternativas Libres]

[http://descargas.terra.es/informacion_extendida.phtml?n_id=32021&plat=4 Descargas Terra]

[http://www.softonic.com/ie/32021/aMule Softonic]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}

=== French ===
{| border=1 width=200 |
|
[http://www.infos-du-net.com/news/2029-amule.html Infos-du-Net]

[http://routes-linux.scooba.org/amule.php Routes Linux]

[http://www.linuxfrench.net/article.php3?id_article=1332 LinuxFrench]

[http://starstones.free.fr/src/amule Linux on Mandrake]
|}

=== German ===
{| border=1 width=200 heigh="100%" |
|
[http://www.tuxfutter.de/wiki/AMule TuxFutter]

[http://www.pctipp.ch/downloads/dl/29318.asp PCtipp]

[http://www.userchannel.de/wissen/docs/aMule%20unter%20Linux%20installieren UserChannel]
|}

| valign="top" |
=== Italian ===
{| border=1 width=200 |
|
[http://www.pc-facile.com/aMule_s318 PC Facile]
|}

=== Croatian ===
{| border=1 width=200 |
|
[http://www.linuxsoft.cz/sw_detail.php?id_item=2029 LinuxSoft]
|}

=== Polish ===
{| border=1 width=200 |
|
[http://www.idg.pl/ftp/linux_202/aMule.1.0.8.html IDG.pl]

[http://p2p.info.pl/index.php?module=subjects&func=viewpage&pageid=6 Polskie Centrum P2P]
|}

=== Catalan ===
{| border=1 width=200 |
|
[http://www.comesfa.org/node/199 ComEsFa P2P]

[http://www.comesfa.org/node/268 ComEsFa aMule]
|}

=== Portuguese ===
{| border=1 width=200 heigh="100%" |
|
[http://pl.wikipedia.org/wiki/AMule Portuguese]
|}
|}

User:Tiku

2005-01-20T12:04:02Z

80.224.220.31:

Original creator and main developer of [[lMule]].

Sadly, MIA since long ago.

User:Ken

2005-01-20T12:00:39Z

80.224.220.31:

'''[[aMule]] [[AMule_devs#Testers|tester]] & [[AMule_devs|dev]] ;)'''

[[aMule]] concerns:
*[http://macosx.apple.com MacOS X] [[aMule]]r

Reviews

2005-01-17T20:54:12Z

80.224.220.31:

__NOTOC__

{|
| valign="top" |
== [http://www.kernel.org Linux] ==

[http://www.aMule.org aMule.org (Official)]

[http://developer.berlios.de/projects/amule BerliOS (Official)]

[http://sourceforge.net/projects/amule SourceForge]

[http://freshmeat.net/projects/amule FreshMeat]

[http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=amule Debian bugs]

[http://www.gentoo-portage.com/net-p2p/amule/bugs Gentoo bugs]

[http://archlinux.org/packages.php?id=5640 ArchLinux]
| valign="top" |
== [http://www.bsd.org BSD] ==

[http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/amule FreeBSD (BSD)]

[http://www.freshports.org/net/amule FreshPorts (BSD)]

== [http://macosx.apple.com MacOS X] ==

[http://www.macupdate.com/info.php/id/16818 MacUpdate]

[http://www.versiontracker.com/dyn/moreinfo/macosx/23853&vid=152872 VersionTracker]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|}

{|
| valign="top" |
== Descriptions ==

[[AMule|aMule Wiki]]

[http://en.wikipedia.org/wiki/AMule WikiPedia]

[http://wiki.linuxquestions.org/wiki/AMule LinuxQuestions]

[http://www.encyclopedia-online.info/AMule Encyclopedia Online]

[http://www.yotor.com/wiki/en/am/AMule.htm Yotor]

[http://www.searchspaniel.com/index.php/AMule SearchSpaniel]
|}

{|
| valign="top" |
== French ==

[http://www.infos-du-net.com/news/2029-amule.html Infos-du-Net]

[http://routes-linux.scooba.org/amule.php Routes Linux]

[http://www.linuxfrench.net/article.php3?id_article=1332 LinuxFrench]
| valign="top" |
== Croatian ==

[http://www.linuxsoft.cz/sw_detail.php?id_item=2029 LinuxSoft]
|-
| valign="top" |
== Polish ==

[http://www.idg.pl/ftp/linux_202/aMule.1.0.8.html IDG.pl]

[http://p2p.info.pl/index.php?module=subjects&func=viewpage&pageid=6 Polskie Centrum P2P]
| valign="top" |
== Spanish ==

[http://alts.homelinux.net/libreapp.php?id=289 Alternativas Libres]

[http://descargas.terra.es/informacion_extendida.phtml?n_id=32021&plat=4 Descargas Terra]

[http://www.softonic.com/ie/32021/aMule Softonic]

[http://pcactual.softonic.com/ie/38286/aMule PcActual Softonic]
|-
| valign="top" |
== Catalan ==

[http://www.comesfa.org/node/199 ComEsFa P2P]

[http://www.comesfa.org/node/268 ComEsFa aMule]
| valign="top" |
== Italian ==

[http://www.pc-facile.com/aMule_s318 PC Facile]
|-
| valign="top" |
[http://pl.wikipedia.org/wiki/AMule Portuguese]
|-
| valign="top" |
== English ==

[http://softpedia.com/get/UNIX/Networking/Client-Applications/aMule.shtml SoftPedia]

[http://www.gnomefiles.org/app.php?soft_id=472 GNOME Files]

[http://www.comfm.com/download/?log=122 comfm]

[http://heidelberg.freshrpms.net/rpm/amule FreshRPMs]

[http://addict3d.org/index.php?page=downloadfile&ID=3140 Addict3D]

[http://www.software-facilities.com/net-software/amule.php Software Facilities]

[http://ukrainer.ru/article76.html ukrainer.ru]

[http://www.linuxsoft.cz/en/sw_detail.php?id_item=2029 LinuxSoft]

[http://www.linuxpackages.net/pkg_details.php?id=3589 LinuxPackages]

[http://www.rocklinux.net/packages/amule.html RockLinux]

[http://www.ratiatum.com/logitheque.php?id_cat=5&id_log=340 Ratiatum]

[http://linuxfr.org/~motodashi/10160.html LinuxFr]

[http://www2.openmedia.info:8080/p26.html OpenMedia]

[http://yarrow.freshrpms.net/rpm.html?id=1268 FreshRPMs]

[http://mp3.box.sk/codebox.links.php?id=4659&pid=mp3soft&subject=MP3+software+%3A%3A+mp3+search+software&key=mp3searchs MP3 box.sk]
| valign="top" |
== German ==

[http://www.tuxfutter.de/wiki/AMule TuxFutter]

[http://www.pctipp.ch/downloads/dl/29318.asp PCtipp]

[http://www.userchannel.de/wissen/docs/aMule%20unter%20Linux%20installieren UserChannel]

[http://starstones.free.fr/src/amule Linux on Mandrake]
|}

AMule Project FAQ:How does one edit a page

2005-01-17T19:20:27Z

80.224.220.31:

#REDIRECT [[AMule_Project_FAQ:Help]].

Reviews

2005-01-16T22:19:30Z

80.224.220.31:

{|
| Release pages

http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=amule

http://fink.sourceforge.net/pdb/package.php/amule

http://sourceforge.net/projects/amule

http://freshmeat.net/projects/amule

http://developer.berlios.de/projects/amule

http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/amule

http://www.freshports.org/net/amule

|-
| Descriptions

http://en.wikipedia.org/wiki/AMule

http://www.encyclopedia-online.info/AMule

|-
| Mac reviews

http://www.macupdate.com/info.php/id/16818

http://fink.sourceforge.net/pdb/package.php/amule

http://www.versiontracker.com/dyn/moreinfo/macosx/23853&vid=152872

http://pcactual.softonic.com/ie/38286/aMule

|-
| German

http://www.pctipp.ch/downloads/dl/29318.asp

|-
| French

http://www.infos-du-net.com/news/2029-amule.html

http://routes-linux.scooba.org/amule.php

http://www.linuxfrench.net/article.php3?id_article=1332

|-
| Croatian

http://www.linuxsoft.cz/sw_detail.php?id_item=2029

|-
| Polish

http://www.idg.pl/ftp/linux_202/aMule.1.0.8.html

http://p2p.info.pl/index.php?module=subjects&func=viewpage&pageid=6

|-
| Spanish

http://alts.homelinux.net/libreapp.php?id=289

http://descargas.terra.es/informacion_extendida.phtml?n_id=32021&plat=4

http://www.softonic.com/ie/32021/aMule

http://pcactual.softonic.com/ie/38286/aMule

|-
| Catalan

http://www.comesfa.org/node/199

http://www.comesfa.org/node/268

|-
| Italian

http://www.pc-facile.com/aMule_s318

|-
| English

http://softpedia.com/get/UNIX/Networking/Client-Applications/aMule.shtml

http://www.gnomefiles.org/app.php?soft_id=472

http://www.comfm.com/download/?log=122

http://heidelberg.freshrpms.net/rpm/amule/

http://addict3d.org/index.php?page=downloadfile&ID=3140

http://www.software-facilities.com/net-software/amule.php

http://ukrainer.ru/article76.html

http://www.linuxsoft.cz/en/sw_detail.php?id_item=2029

http://www.linuxpackages.net/pkg_details.php?id=3589

http://www.rocklinux.net/packages/amule.html

http://www.ratiatum.com/logitheque.php?id_cat=5&id_log=340

http://linuxfr.org/~motodashi/10160.html

http://www2.openmedia.info:8080/p26.html

http://www.comesfa.org/node/268

http://www.encyclopedia-online.info/AMule

http://mercurio.homeip.net/blog/76

http://yarrow.freshrpms.net/rpm.html?id=1268

http://mp3.box.sk/codebox.links.php?id=4659&pid=mp3soft&subject=MP3+software+%3A%3A+mp3+search+software&key=mp3searchs

Reviews

2005-01-16T22:18:58Z

80.224.220.31:

{|
| Release pages

http://bugs.debian.org/cgi-bin/pkgreport.cgi?pkg=amule

http://fink.sourceforge.net/pdb/package.php/amule

http://sourceforge.net/projects/amule

http://freshmeat.net/projects/amule

http://developer.berlios.de/projects/amule

http://www.freebsd.org/cgi/cvsweb.cgi/ports/net/amule

http://www.freshports.org/net/amule

|-
| Descriptions

http://http://en.wikipedia.org/wiki/AMule

http://www.encyclopedia-online.info/AMule

|-
| Mac reviews

http://www.macupdate.com/info.php/id/16818

http://fink.sourceforge.net/pdb/package.php/amule

http://www.versiontracker.com/dyn/moreinfo/macosx/23853&vid=152872

http://pcactual.softonic.com/ie/38286/aMule

|-
| German

http://www.pctipp.ch/downloads/dl/29318.asp

|-
| French

http://www.infos-du-net.com/news/2029-amule.html

http://routes-linux.scooba.org/amule.php

http://www.linuxfrench.net/article.php3?id_article=1332

|-
| Croatian

http://www.linuxsoft.cz/sw_detail.php?id_item=2029

|-
| Polish

http://www.idg.pl/ftp/linux_202/aMule.1.0.8.html

http://p2p.info.pl/index.php?module=subjects&func=viewpage&pageid=6

|-
| Spanish

http://alts.homelinux.net/libreapp.php?id=289

http://descargas.terra.es/informacion_extendida.phtml?n_id=32021&plat=4

http://www.softonic.com/ie/32021/aMule

http://pcactual.softonic.com/ie/38286/aMule

|-
| Catalan

http://www.comesfa.org/node/199

http://www.comesfa.org/node/268

|-
| Italian

http://www.pc-facile.com/aMule_s318

|-
| English

http://softpedia.com/get/UNIX/Networking/Client-Applications/aMule.shtml

http://www.gnomefiles.org/app.php?soft_id=472

http://www.comfm.com/download/?log=122

http://heidelberg.freshrpms.net/rpm/amule/

http://addict3d.org/index.php?page=downloadfile&ID=3140

http://www.software-facilities.com/net-software/amule.php

http://ukrainer.ru/article76.html

http://www.linuxsoft.cz/en/sw_detail.php?id_item=2029

http://www.linuxpackages.net/pkg_details.php?id=3589

http://www.rocklinux.net/packages/amule.html

http://www.ratiatum.com/logitheque.php?id_cat=5&id_log=340

http://linuxfr.org/~motodashi/10160.html

http://www2.openmedia.info:8080/p26.html

http://www.comesfa.org/node/268

http://www.encyclopedia-online.info/AMule

http://mercurio.homeip.net/blog/76

http://yarrow.freshrpms.net/rpm.html?id=1268

http://mp3.box.sk/codebox.links.php?id=4659&pid=mp3soft&subject=MP3+software+%3A%3A+mp3+search+software&key=mp3searchs

HowTo Compile In Debian/Ubuntu

2005-01-16T21:42:19Z

80.224.220.31:

<center><h2>HowTo compile aMule in [[Debian]]</h2> 
<h2>by [[User:Jacobo221|Jacobo221]]</h2> 

<h3>Very special thanks to darknox, Arathornz, guest234, parasito, maya and klando for their tests!</h3></center> 
 
== <h4>Notes before starting</h4> ==
Important: Have in mind that this HowTo was done having in mind aMule 2.0.0 or greater in [[Debian]] 3.0 (Woody/Sarge/Sid). 
 
This HowTo is based on using the apt-get package installer tool, which means you'll have to be able to get super-user (root) access. Also, apt-get requires a perfect packet dependencies installed system. If you usually use apt-get for installing any application, skip this and go to the next section. If you rarely use apt-get but, instead, use dpkg, you can 
 
A) (Recommended) Solve all the dependencies problems on your system. This can be done by taking a look at the <code>"dpkg -C"</code> output and installing/removing/updating the packages it mentions depending on what's required. This option is the recommended since it will not only ensure your aMule compilation will be most surely correct, but it will also make your system the most stable it can possibly be and from now on you'll be able to use apt-get to not only make easier installations, but also to easily upgrade your system. 
 
B) Force apt-get to ignore the dependencies problems using the -f or --fix-broken switches (just one of them, since they're exactly the same, so that'd be, for example, <code>"apt-get install -f ..."</code>). This option may cause a corrupt installation of some packages which may cause the apps not to work. Also have in mind that using this switch in a system with dependencies problems may cause the system to completely brake if the package being installed is a base package (although this is not the case). 
 
C) Follow this instructions but, instead of using <code>"apt-get install foo"</code>, use <code>"dpkg -i foo"</code> where foo is the package to install. Remember the packages must be already on the system when installing packages with dpkg. Remember also to download any "Depends" package since it most-surely will be necessary for successfully compiling [[aMule]]. Avoid using whichever of the following dpkg switches: --force-all --force-depends-version --force-depends --force-conflicts 
 
If you usually install applications from source, read deltaHF's [[Compilation_Installation|"aMule compilation / installation HowTo"]] since your system might not be complying the Debian aMule package dependencies although <code>"dpkg -C"</code> shows no errors. 
 
 
== <h4>The easiest: Preparing the system</h4> ==
Once you decided to use apt-get, you must make sure you'll be downloading the latest versions of the packages (aMule team has discovered bugs in some deb packages that would make aMule impossible to compile on Debian without compiling some other libraries too. This bugs have been mostly fixed in those affected debian packages, so it is very important to be sure to have the packages up to date). This is done by 
 
<code>apt-get update && apt-get dist-upgrade</code> 
 
Note 1: You must be root user to do this. Log in as root or <code>"su"</code> or use <code>"sudo"</code> (<code>"sudo"</code> must be specified on both apt-get commands, that is <code>"sudo apt-get update && sudo apt-get dist-upgrade"</code>). <code>"sudo"</code> is not a base command, so it may not be installed on your system, although it most probably will. Be aware that following this HowTo entirely as root may bring some problems later such as being unable to delete certain files as a normal user, so please only use tooy priviledges when necessary. 
Note 2: Woody users (that is, people stuck in the stable Debian 3.0 branch) will be unable to install the wxGTK, wxbase and Crypto++ libraries since they were not available in the current minimum compatible versions (2.4.2 and 2.5.1 respectively) when Woody was released. 
The best for Woody users is to switch to the Sarge or Sid branch. That can be done with the following command (again, you must be root) <code>"sed s/stable/testing/g /etc/apt/sources.list > /etc/apt/sources.list"</code> or <code>"sed s/woody/sarge/g /etc/apt/sources.list > /etc/apt/sources.list"</code> to switch to the Sarge/testing branch, or with <code>"sed s/unstable/testing/g /etc/apt/sources.list > /etc/apt/sources.list"</code> or <code>"sed s/woody/sid/g /etc/apt/sources.list > /etc/apt/sources.list"</code> to switch to the Sid/unstable branch. 
But Woody users might not be interested in switching to Sarge. Such users will have to download Woody-backported debian packages by adding the following line to /etc/apt/sources.list (remember to <code>"apt-get update"</code> after adding this line): 
<code>deb http://debian.thermoman.de/ woody wxwindows2.4 libcrypto++</code> 
What's more, [http://www.thermoman.de thermoman] stopped working on the [[aMule]] backports for [http://www.debian.org Woody] on the [[aMule]] 2.0.0-rc5 release, so newer [[aMule]] releases backports are unavailable. Sorry. 
Note 3: Sarge users won't have any dependecy problems any longer, sicne both crypto++ and wxWidgets are both in Sarge since some time ago. So, there's no longer any need to update ''sources.list'' on Debian Sarge distributions. 
Note 4: Sid users (that is, people holding the cutting-edge unstable Debian 3.0 branch) could suffer problems from packages not completely implemented or with broken dependencies (both are normal issues in the unstable branch). It is very important to keep this in mind since a compiler (g++) will be installed so it could also be broken and, with it, most applications compiled with it (once upgraded, of course). If a package was broken, to downgrade you can use the --force-downgrade switch with dpkg. 
 
If for whatever reason you think this is too much of a complication, you can just wait a few days until the aMule binary version comes out for your architecture (that is, a .deb file). 
 
 

== <h4>The fastest: Installing the necessary packages</h4> ==
Remember you need to be root to install applications using apt-get, since apt-get installs system-wide applications. So, log in as root, use "su" or add "sudo" before every command shown here. 
 
The following are the packages which must be installed: 
 
1) Install the latest stable g++ compiler and the C++ Standard Library 
 
<code>apt-get install g++</code> 
 
the required libraries for compiling [[aMule]] (wxbase is not really a requiered packet to compile aMule but, unless you know what you're doing, be sure you install it. I won't show in this this guide how to force aMule's compilation without wxbase): 
 
<code>apt-get install libwxbase2.4-dev libcurl2-dev libgtk1.2-dev libwxgtk2.4-dev</code> 
Alternatively you can use <code>apt-get build-dep amule</code> to get all the required depencies for compilation. Anyway, this last method is not sure to work, since it will depend on the latest version on the Debian repository and later versions or CVS versions might have different dependencies.
 
and the required utilities for compiling [[aMule]], at the moment only gettext (necessary for internationalization support): 
 
<code>apt-get install gettext</code> 
 
Note 5: This can all be done in a single command line, which might be more handy for users using <code>"sudo"</code> to gain root priviledges: <code>apt-get install g++ libwxbase2.4-dev libcurl2-dev libgtk1.2-dev gettext</code> 
Note 6: From aMule 2.0.0-rc1 to aMule 2.0.0-rc5 (inclusive) the package ''libcrypto++-dev'' is was necessary for compiling aMule, so if you are compiling any of such versions, apt-get libcrypto++-dev too. 
Also, you might be interested in installing libgd2-noxpm-dev if you plan to compile CAS. It is not a required library for compiling CAS, this library is only used by CAS for creating images (since v2.0.0-rc3) on the current aMule status (by running <code>cas -o</code>). If you plan to use this feature of CAS, you need to install LibGD2. Anyway, CAS will compile perfectly well even if LibGD2 isn't installed, since it detects, on compilation time, if this library is installed. 
Note 7: Woody users will most probably be unable to get libgd2-xpm-dev since that package isn't available for Woody. At the moment, there is no backport available but, since this library is only used by CAS, it won't give any problems on compilation time. Just be aware that <code>cas -o</code> won't work. 
 
2) Download the latest released [[aMule]] source code from [http://www.amule.org/files/files.php?cat=6 here] (or look [[AMule_CVS|here]] for an up-to-date link). 
 
Note 8: From now on, I will suppose we are installing aMule 2.0.0-rc3 
 
3) Fix Crypto++ Library 5.1 if using it 
From [[aMule]] 2.0.0-rc1 to a aMule 1.0.0-rc5 (inclusive) this library is required because [[aMule]] is now supporting SecureIdent (remember, since aMule 2.0.0-rc6, libcrypto++ is optional and not needed by default), but the [[Libcrypto|Crypto++]] [[Debian]] package has had lots of compiling bugs and still has one (although the rest have been fixed after aMule team's reports). Remember you should have update and dist-upgraded apt-get before installing any [[Debian]] package in this HowTo, otherwise, you could be installing (or already have installed) a buggy Crypto++ package and this fix will not suit your needs. To fix the latest [[Libcrypto|crypto++]] [[Debian]] package only a symbolic link is needed: 
 
<code>ln -s /usr/include/crypto++/cryptopp_config.h /usr/include/crypto++/config.h</code> 
 
If you still can't compile crypto++, try compiling it after running the following command: 
 
<code>ln -s /usr/include/crypto++ /usr/include/cryptopp''</code> 
 
Note 9: Since this link needs write permissions in /usr/lib, super-user (root) priviledges are needed. Again, this can be done easily with <code>"su"</code> or <code>"sudo"</code>. 
 
 

== <h4>The hardest: Compiling [[aMule]]</h4> ==
4) Extract the sources. The following will create a folder on your user's home directory where it will extract the sources with the -C switch into it (the following command understands that [[aMule]]'s sources are on the current directory): 
 
<code>mkdir ~/aMule-compilation/ && tar xzfv aMule-2.0.0rc3.tar.gz -C ~/aMule-compilation/ && cd ~/aMule-compilation/</code> 
 
Note 10: Remember I'm supposing you are extracting [[aMule]] 2.0.0-rc3. Change the file name if it doesn't correspond to the actual packed source code filename. 
 
5) Compile [[aMule]]! The following command will actually switch to the directory containing [[aMule]] 2.0.0rc3 and compile it: 
 
<code>cd ~/aMule-compilation/aMule-2.0.0rc3/ && ./configure && make</code> 
 
Note 11: You should check <code>"./configure --help | more"</code> to see if there is any configure switch which might be of your interest, such as --disable-debug --enable-optimise or --bindir= 
Note 12: if you get an error message, while compiling, similar to: "In file included from /usr/include/wx/***:***, [...] /usr/include/wx/******:***: internal compiler error: Segmentation fault", then you most probably have problems with wxWidgets. Try with <code>"apt-get install --reinstall wxwin2.4-headers libwxbase2.4 libwxgtk2.4-dev"</code>, which will reinstall wxWidgets and will most probably fix the compilation error.
 
 
== <h4>Meeting satisfaction: Installing aMule!</h4> ==
8) What's left? Install aMule (remember you must be root, so log in as root or use <code>"su"</code> or <code>"sudo"</code>): 
 
<code>make install</code> 
 
Now you can remove the sources so you free up space in your hard disk by running: 
 
<code>rm -rf ~/aMule-compilation/</code> 
 
 
== <h4>The end: Final checks</h4> ==
If you have sometime installed aMule from the Debian packages (no matter if the package came from http://gunnm.org/~soda ), you will have aMule binaries installed in /usr/bin. But <code>"make install"</code> installs binnaries in /usr/local/bin (unless --prefix= is set in configure). This leads us to the point that when typing "amule" anyone of the two installed aMule versions might be invoked (which one is executed will depend on the $PATH environment variable. You can check it by typing <code>"type amule"</code>). The walk around is very easy: remove the aMule installed through [[Debian]] package. You can do this with the command "apt-get remove amule" (do not use <code>"apt-get remove --purge"</code> or you might loose your [[aMule]] settings) or with <code>"dpkg --remove amule"</code> (again, never ever use <code>"dpkg --purge"</code> or you might loose your [[aMule]] settings). apt-get will remove aMule-utils if you have them installed (only available as a separate package in Sid, in Sarge and Woody aMule utils are included in the base aMule package) while dpkg will leave aMule-utils installed on the system (which, in general, is a bad idea). 
Also, if you installed xmule sometime or you are planing to install it, have in mind that the [[ed2k command]] exists both in [[aMule]] and [[xMule]]. You might want to run `type ed2k` to see which [[ed2k command]] will be executed and rename the other so you make sure it's never executed by mistake. 
 
 
== <h4>You're done...</h4> ==
That's it! Your own compiled [[aMule]] is installed on your system and ready to go. 
To run [[aMule]], just type <code>"amule"</code>. You can check if everything worked by typing <code>"amule -v"</code> and check if the displayed version corresponds with the one you were compiling/installing. 
If this HowTo didn't help, you have a rare problem on your system ;-) Take a look at http://www.amule.org ([http://www.amule.org/amule aMule Forums] at http://www.amule.org/amule/ ) or visit us in #amule on irc.freenode.net and (don't doubt) we'll try to do our best to help you.

HowTo compile on Mac

2005-01-15T14:02:12Z

80.224.220.31:

The following steps will lead you to install [[aMule]] in your [http://www.apple.com/macosx MacOS X] box.

You can get also the most recent binnary of [[aMule]] for [http://www.apple.com/macosx MacOS X] dowloading this: http://download.berlios.de/amule/aMule.zip

This HowTo is written to compile and install [[aMule]] 2.0.0-rc8. It will not work for older versions. Please note that you should always download the latest [[aMule]] version available.

'''NOTE:''' This document explains how to download files using [http://curl.haxx.se curl]. However, [http://curl.haxx.se curl] might not be installed on your system: either install it (you can use [http://fink.sourceforge.net Fink] to install it) or download the files with whatever application you want (maybe your web browser), but place them in the directory that's being used on each part of the guide, otherwise the commands that are shown here will not work.

== Setting up the required environment ==

These steps are one-time-only steps necessary for the steps in the following sections to work properly.

# Xcode
## Install [http://developer.apple.com/tools/xcode Xcode Tools] from http://developer.apple.com/tools/download
## "Getting ADC ID"->"Log In"->"Download Software"->"Developer Tools"->"Download Xcode Tools last release">"Install"
# Fink
## Install (or verify installation if already installed) [http://fink.sourceforge.net Fink] from http://fink.sourceforge.net/download
# gettext
## Using [http://fink.sourceforge.net Fink], install [http://www.gnu.org/software/gettext gettext]. Read [http://fink.sourceforge.net/download Fink's installation guide] to learn how to install applications through [http://fink.sourceforge.net Fink] (the [http://www.gnu.org/software/gettext gettext] package is ''gettext'').
# Working directories
## Make ''amule'' dir in your home directory: ''mkdir ~/amule''
## Make ''wxmac'' dir in your home directory: ''mkdir ~/wxmac''

== Obtaining [[wxMac]] sources ==

'''ATTENTION:''' [[wxMac]] 2.5.3 has a couple of bugs which cause [[aMule]] 2.0.0-rc8 to crash. One bug causes [[aMule]] to crash just after starting up, the other causes it to crash at a random later time :-(. The only work-around is to pull the wxWidgets sources from CVS and patch them!

You have two options, downloading a CVS snapshot or performing a checkout through the wxWidgets CVS server. The snapshot may be faster to download; the CVS server will give you the most up-to-date sources and the most flexibility if you need sources from a previous day (for example, to avoid bugs that may crop up in the ever-changing source). On the other hand, the sources from the snapshot, once extracted, take nearly 6 times as much disk space as those checked out from the CVS server because they include files not necessary for compiling on Mac OS X.

=== '''Option 1:''' Obtaining [[wxMac]] sources from CVS snapshot ===

These instructions were adapted from http://wxwidgets.org/cvs.htm

# Enter the ''wxmac'' directory: ''cd ~/wxmac''
# Get the [[wxMac]] CVS snapshot (found at [http://wxwindows.sourceforge.net/snapshots/ http://wxwindows.sourceforge.net/snapshots/] as ''wx-cvs.tar.bz2'') and place it in your ''~/wxmac'' directory: ''curl -O http://biolpc22.york.ac.uk/pub/CVS_HEAD/wx-cvs.tar.bz2''
# Extract it: ''tar -xjf wx-cvs.tar.bz2''
# '''Optional:''' You may delete the archive after extracting its contents: ''rm wx-cvs.tar.bz2''

=== '''Option 2:''' Obtaining [[wxMac]] sources from CVS server ===

These instructions were adapted from http://wxwidgets.org/cvs.htm

# Enter the ''wxmac'' directory: ''cd ~/wxmac''
# Login (anonymously) to the wxWidgets CVS server (when prompted, enter ''anoncvs'' as the password): ''cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets login''
# Checkout the [[wxMac]] sources from CVS: ''cvs -d :pserver:anoncvs@cvs.wxwidgets.org:/pack/cvsroots/wxwidgets checkout wxMac''

== Patching the [[wxMac]] sources ==

The [[wxMac]] sources still contain some bugs which affect aMule. One causes aMule to crash at random times. Others cause aMule to leak memory. Patches to fix [[wxMac]] have been submitted to the wxWidgets team. These patches have not yet been approved by the wxWidgets developers and so should be considered experimental and approached with caution. However, since the crashing bug seriously hampers the use of aMule, and several Mac aMule users have successfully tested the patch, you are strongly encouraged to apply it. You should exercise judgment in applying the other patches.

# Enter the ''wxmac'' directory: ''cd ~/wxmac''
# Patch the crashing bug in [[wxMac]]
## Download the patch file: ''curl "http://sourceforge.net/tracker/download.php?group_id=9863&atid=309863&file_id=114017&aid=1093852" -o doublefree.patch''
## Apply the patch to the sources: ''patch -d wxWidgets -p0 <doublefree.patch''
# '''Optional:''' Patch some memory leaks in [[wxMac]].
## Download the patch files: ''curl "http://sourceforge.net/tracker/download.php?group_id=9863&atid=309863&file_id=112952&aid=1088052" -o ctable.patch "http://sourceforge.net/tracker/download.php?group_id=9863&atid=309863&file_id=112949&aid=1088038" -o bitmap.patch''
## Apply the patches: ''cat ctable.patch bitmap.patch | patch -p0 -d wxWidgets''

== Installing [[wxMac]] from sources ==

# Enter the directory containing the [[wxMac]] sources: ''cd ~/wxmac/wxWidgets''
# Directory ''build'' should already be there. If not, create it with: ''mkdir build''
# Now enter ''build'' directory: ''cd build''
# Prepare the compilation: ''../configure''
# And compile: ''make''
# Now install [[wxMac]] compilation: ''sudo make install''
# Get back to your home directory, you're done: ''cd ~''
# '''Optional:''' If everything went ok, you can safely remove the [[wxMac]] sources (not recommended, since you might want to compile it again someday): ''rm -r ~/wxmac

== Compiling and installing [[aMule]] ==

# Enter the ''amule'' directory: ''cd ~/amule''
# Get [[aMule]]'s latest source code (aMule 2.0.0-rc8 sourcecode: [http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2 http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2]) and place it in your ''~/amule'' directory: ''curl -O http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2''
# Extract it: ''tar -xjf aMule-2.0.0rc8.tar.bz2''
# Enter [[aMule]]'s sources directory: ''cd aMule-2.0.0rc8''
# Prepare the compilation (thanks to '''one_2_one''' and '''Babboia''' for his test&fix): ''./configure --disable-systray --disable-gtk --with-wx-config=/usr/local/bin/wx-config''
# And compile it: ''make''
# '''Optional:''' You can reduce the size of [[aMule]] from 44MB to 3MB by doing the following (anyway, this will make the [[aMule]] binary lose debug info, so you'll be unable to report problems to the [[aMule devs|aMule Team]] to make [[aMule]] a better program; so, it is not recommended): ''strip src/amule''
# Copy the ''amule'' binary to the app-Container directory: ''cp src/amule amule.app/Contents/MacOS/'' ('''NOTE:''' If the ''MacOS'' directory is missing in ''amule.app'', create it by typing ''mkdir amule.app/Contents/MacOS'' before executing the previous command. Thanks to '''dan''' for the tip)
# And copy ''amule.app'' directory to your Applications folder: ''cp -R amule.app /Applications''
# Get back to your home directory, you're done: ''cd ~''
# If everything went OK, you can safely remove the downloaded packages:
## Remove [[aMule]]'s sources package: ''rm ~/amule/aMule-2.0.0rc8.tar.bz2''
## Optionally remove the extracted [[aMule]] sources (not recommended, since you might want to compile it again someday): ''rm -r ~/amule''

== Problems and solutions ==

*If [http://fink.sourceforge.net Fink] reports something like: ''After unpacking 11.2GB will be freed'', don't be afraid. [http://fink.sourceforge.net Fink] has evolved into a different way of managing packet's size and some old ("old": at least some months old) packages' sizes aren't handled correctly on the output. If this is your case, devide the number by 1024. So, what the above example really means is: ''After unpacking 11.2MB will be freed''.

*If you get an error like this: ''You cannot open the application "amule" because it may be damaged or incomplete'', right click on ''amule'', then click on ''Show Packages Contents'', go to "Contents">"MacOS"> and double click on ''amule''. Next time you start from ''amule.app'' it will run fine. If you still get the same error, move ''amule.app'' to the desktop and run it from there.

== Older releases ==

In older releases ([[aMule]] 2.0.0-rc7 and earlier), the app container wasn't included with the sources. If you are compiling any of this older releases and do not whish to upgrade (remember it is '''strongly''' recommended to upgrade to the latest release), you can:

*Download the latest [[aMule]] sources and get the app container from there (recommended option).
*Download [http://download.berlios.de/amule/aMule-App-Container.tar.bz2 aMule's app-Container]: ''curl -O http://download.berlios.de/amule/aMule-App-Container.tar.bz2''

You must extract the app container in your ''amule'' directory: possible ''~/amule''
To extract it: ''tar -xjf aMule-App-Container.tar.bz2''

'''NOTE:''' If the app-Container failed to extract try running this command instead of the app-Container extraction step: ''mkdir -p amule.app/Contents/MacOS''

Once the installation is finished, you can safely remove the app-Container package: ''rm aMule-App-Container.tar.bz2''

IPFilter

2005-01-15T13:58:42Z

80.224.220.31:

== Description ==

The [[IP]] Filter blocks traffic from/to IPs and ranges of [[IP]]s with our [[client]]. This means that those [[IP]]s which get blocked will not be able neither to upload to us nor to download from us.

This filter is read from [[ipfilter.dat_file|''~/.aMule/ipfilter.dat'']] which is a file which's contents describes the valid and blocked [[IP]] ranges.

== [[ipfilter.dat file]] ==

The information and details about the [[ipfilter.dat file]] can be found [[ipfilter.dat file|here]].

== Using the [[IP]] Filter in [[aMule]] ==

The ''Access level'' of the [[IP]] filter is selected in [[aMule]] through "Preferences" -> "Security" -> "IP Filtering" -> "Filtering level" (in [[aMule]] versions up to 2.0.0-rc8 it is under "Server", instead of "Security").

'''NOTE:''' [[aMule]]'s ''ipfilter.dat'' file is 100% compatible with [[eMule]]'s ([[eMule]]'s [http://www.methlabs.org/methlabs.htm PeerGuardian] format, which is the most popular. The ''antip2p.txt'' format isn't yet supported).

== [[IP]] Filter sources ==

http://www.emulext.net/seguridad/Mc4TuTi/ipfilter.dat

http://www.morph-mod.de/morph/ipfilter/ipfilter.dat

http://emulepawcio.sourceforge.net/nieuwe_site/Ipfilter_fakes/ipfilter.dat

== Hard coded [[IP]] filter in [[aMule]] ==

[[aMule]] has a range of [[IP]]s which it filters by default following the [http://www.rfc-editor.org/rfc/rfc3330.txt RFC 3330] document. This ranges are:

<pre>
Address Block Present Use Reference
----------------------------------------------------------------------
"0.0.0.0/8", // "This" Network [RFC1700, page 4]
"10.0.0.0/8", // Private-Use Networks [RFC1918]
"14.0.0.0/8", // Public-Data Networks [RFC1700, page 181]
"24.0.0.0/8", // Cable Television Networks --
"39.0.0.0/8", // Reserved but subject
// to allocation [RFC1797]
"127.0.0.0/8", // Loopback [RFC1700, page 5]
"128.0.0.0/16", // Reserved but subject
// to allocation --
"169.254.0.0/16", // Link Local --
"172.16.0.0/12", // Private-Use Networks [RFC1918]
"191.255.0.0/16", // Reserved but subject
// to allocation --
"192.0.0.0/24", // Reserved but subject
// to allocation --
"192.0.2.0/24", // Test-Net
"192.88.99.0/24", // 6to4 Relay Anycast [RFC3068]
"192.168.0.0/16", // Private-Use Networks [RFC1918]
"198.18.0.0/15", // Network Interconnect
// Device Benchmark Testing [RFC2544]
"223.255.255.0/24",// Reserved but subject
// to allocation --
"224.0.0.0/4", // Multicast [RFC3171]
"240.0.0.0/4" // Reserved for Future Use [RFC1700, page 4]
</pre>

However, you can un-filter this range of [http://www.faqs.org/rfcs/rfc791.html IP]s by unchecking "Preferences"->"Security"->"IP-filtering"->"Always filter bad IPs" (on [[aMule]] versions up to 2.0.0-rc8, this option can be found in "Preferences"->"Server"->"Always filter bad IPs").

AMule is slow

2005-01-13T14:11:50Z

80.224.220.31: until someone checks this is true, I don't agree having any hypothesis from HopeSeekr settled as a valid statement. It turns out that HS is not even a bit truthful source

<center>'''English''' | [[AMule_is_slow-it|Italiano]]</center>

== [[aMule]] is slow ==

So [[aMule]] is slow? This can be due to:

*[[#Your fault|Your fault]]
*[[#The network's fault|The network's fault]]

== Your fault ==

This is a list of issues which can be the reason for slow download speeds:

*A low value in "Preferences"->"Download limit".
*A low value in "Preferences"->"Upload limit". Upload limits under 4 kbps limit your download speed to 3 times your upload speed. Upload limits under 10 kbps limit your download speed to 4 times your upload speed. Upload limits above or equal to 10 kbps give you unlimited download speed, limited only by the "Download limit" preference value (read [[FAQ_eD2k-Kademlia#Are_there_any_limitations_on_the_ED2K_network?|this link]] to know more about it).
*Having [[FAQ_eD2k-Kademlia#What_is_LowID_and_HighID?|Low ID]].
*Some [http://en.wikipedia.org/wiki/ISP ISP]s block or limit connections to the standard [[FAQ_eD2k-Kademlia#What_is_ED2K?|eD2k]] [[FAQ_eD2k-Kademlia#Which_ports_do_I_have_to_configure_in_a_firewall_or_router_to_run_aMule?|ports]]. Try changing the port in "Preferences"->"Connections" to some other values.

== The network's fault ==

We're sorry to tell you that sometimes, the low speeds aren't due to a bad [[aMule]] code or a bad configuration, but due to other facts. This is a list:

*The [[FAQ_eD2k-Kademlia#What_is_ED2K?|eD2k]] is a slow network. In some other [[P2P]] networks you can easily download faster. The [[FAQ_eD2k-Kademlia#What_is_ED2K?|eD2k]] network is one of the fastest [[P2P]] networks existing, but its main goal is availability. While on other popular networks you'll be able to download very fast, you'll quickly find out that in the [[FAQ_eD2k-Kademlia#What_is_ED2K?|eD2k]] network there are millions of files you'll be unable to find in any other network.
*[[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|Credits]]. If you are running [[aMule]] for the first time or if you deleted some files in the ''~/.aMule'' directory, you'll have no [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|credits]]. [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|Credits]] grant fast downloads. If you don't know what they are, read [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|this]].
*The file's availability. Rare files, old files, extremly new files... this kind of files have very few [[FAQ_eD2k-Kademlia#What_is_a_source?|source]]s, so it takes quite some time for [[aMule]] to connect to some other [[client]] sharing it.

== Unverified hypothesis ==

According to research done by HopeSeekr of xMule, the ED2K network *still* follows the 80-20 rule that hinders all other Peer-to-Peer networks, in a novel way. With virtually all other p2p nets, 80% of the users leech off 20% of the uploaders. With ED2K the main manifestation of the 80-20 rule (which shows up in *many* other natural processes) is that roughly 80% of the "high-bandwidth" (30kb/sec and above) and "small waits" (less than 5 minutes in a queue) are provided by roughly 20% of the clients on the entire network. These are, in order of precendence (determined by HopeSeekr's httpd log mod for xMule):
* eMule release mods (like ZZUL)
* mlDonkey + EDonkey clients
* Files running xMule's modified upload code (xMule 1.6.0+ and aMule)
* eMule 0.30 and below
* eMule 0.42 and above with few popular files

The devil's bargain is that eMule's credit-system, huge queues, source exchange, and lack of initial credit accreditation for clients with zero initial parts (e.g. first downloaders) forces the initial downloader to wait any where from 2 hours to 8 hours in a eMule-centric upload-source cluster. Typical eMule queues are measured in the thousands, the average upload segment is 9.28MB, making the average wait in any one particular queue approximately 6 hours. Shorter queues, critics complain, would simply cause the 80-20 rule to shift from bandwidth to file availability (something *I* thought BitTorrent radically disproves, but o well).

Additionally, due to the abnormally large partfile size (BitTorrent's partfile sizes are dynamic and are generally no more than 150 KB) and eMule's lack of sophistication in selectively uploading them (it uses a pseudo-random process) causes the problem, unique to the ED2K network, of "missing parts"...a syndrome in which many thousands of people may have any particular large file, but one or more 9.28 MB parts are missing, due to the fact that the releaser did not effectively spread them to enough downloaders.

All these problems have been fixed by a host of eMule mods, xMule, mlDonkey, and others, however due to the lack of a protocol consortium such as the [http://rfc-gnutella.sourceforge.net/ Gnutella Group], largely prevents these ideas from entering the mainstream ed2k network. A huge road block to this is that despite the existence of many independent ed2k clients, eMule maintains an extensive monopoly in the realm of clients (90 - 95% of all clients), which if nothing else causes the major ed2k server software (also a monopoly) to only consider contacting eMule (and its chosen allies) about critical server protocol changes.

Such an event happened in October 03, when lugdunum 0.44 introduced compulsive zlib support for all clients, after only informing eMule to its existence or how to implement it. In the aftermath of this decision, xMule stayed uncompliant for ~4 months, and the vast majority of its userbase moved to aMule, as HopeSeekr had been incapacitated for several weeks since and could not make the changes.

Debian fonts

2005-01-12T17:56:37Z

80.224.220.31:

If you get small fonts in [[Debian]] build, just run:

''apt-get install xfonts-75dpi-transcoded xfonts-100dpi-transcoded''

and then restart your [http://www.x.org X server].

AMule Project FAQ:FAQ

2005-01-12T17:55:40Z

80.224.220.31:

== Where is the main page of this [http://wikipedia.sf.net wiki]? ==

You can access the [[main Page|aMule wiki's main page here]].

== Can I contribute to this [http://wikipedia.sf.net wiki]? ==

Yes! Of course! That's the [http://wikipedia.sf.net wiki] philosophy. Anyone can edit (almost) anything!

== How can I contribute to this [http://wikipedia.sf.net wiki]? ==

If you are intending to contribute, please read carefully [[AMule_Project_FAQ:Policy|aMule's wiki's policy]].

If you are unexperienced with editting [http://wikipedia.sf.net wiki]s, read [[AMule_Project_FAQ:Help|this guide]].

== Is there anything left to be done here? ==

Sure! There's never enough. Please check our [[TODO|TODO page]]. Edit it to add or remove things as long as it follows our [[AMule_Project_FAQ:Policy|policy]].

AMule Project FAQ:How does one edit a page

2005-01-12T17:53:31Z

80.224.220.31:

This page has been moved [[AMule_Project_FAQ:Help|here]].

Talk:Geaiez

2005-01-08T23:25:07Z

80.224.220.31:

How about adding an option in security to amule to ban these clients, that aggressivly request shared file list ( I think eMulePlus can do this)

'''Not possible since not all of this users are [[bad guy]]s :-('''

Debian fonts

2005-01-08T23:21:27Z

80.224.220.31:

If you get small fonts in debian build, just run:

''apt-get install xfonts-75dpi-transcoded xfonts-100dpi-transcoded''

and then restart your [http://www.x.org X server].

HowTo compile on Mac

2005-01-06T17:06:31Z

80.224.220.31:

The following steps will lead you to install [[aMule]] in your [http://www.apple.com/macosx MacOS X] box.

You can get also the most recent binnary of [[aMule]] for [http://www.apple.com/macosx MacOS X] dowloading this: http://download.berlios.de/amule/aMule.zip

This HowTo is written to compile and install [[aMule]] 2.0.0-rc8. It will not work for older versions. Please note that you should always download the latest [[aMule]] version available.

'''ATTENTION:''' [[wxMac]] 2.5.3 has a bug which causes [[aMule]] 2.0.0-rc8 to crash just after starting up :-(. The only work-around to compile [[wxMac]] without this bug and to have [[aMule]] 2.0.0-rc8 running is to pull the wxWidgets sources from CVS! See http://wxwidgets.org/cvs.htm to see how to do that. Then cd to the newly created directory wxWidgets and continue with step 6 in the chapter "Installing [[wxMac]] form sources" below.

'''NOTE:''' This document explains how to download files using [http://curl.haxx.se curl]. However, [http://curl.haxx.se curl] might not be installed on your system: either install it (you can use [http://fink.sourceforge.net Fink] to instal it) or download the files with whatever application you want (maybe your web browser), but place then in the directory that's being used on each part of the guide, otherwise the commands that are shown here will not work.

== Compiling and installing [[aMule]] ==

# Install [http://developer.apple.com/tools/xcode Xcode Tools] from http://developer.apple.com/tools/download
# "Getting ADC ID"->"Log In"->"Download Software"->"Developer Tools"->"Download Xcode Tools last release">"Install"
# Install (or verify installation if already installed) [http://fink.sourceforge.net Fink], since [http://www.gnu.org/software/gettext gettext] and [[wxMac]] are installed along with [http://fink.sourceforge.net Fink], from http://fink.sourceforge.net/download
# Install [http://www.gnu.org/software/gettext gettext] and [[wxMac]] ([[wxMac]] is only available through [http://fink.sourceforge.net Fink] [http://fink.sourceforge.net/faq/usage-fink.php?phpLang=en#unstable unstable] on [http://www.apple.com/macosx MacOS] 10.3. If you are using [http://fink.sourceforge.net Fink] stable or [http://www.apple.com/macosx MacOS] 10.2 or earlier, either [http://fink.sourceforge.net/faq/usage-fink.php?phpLang=en#unstable upgrade Fink to unstable] and/or [http://www.apple.com/macosx MacOS] to 10.3, or check the [[#Installing wxMac from sources|Installing wxMac from sources section]] of this document and then go on with this section) through [http://fink.sourceforge.net Fink]. Read [http://fink.sourceforge.net/download Fink's installation guide] to learn how to install applications through [http://fink.sourceforge.net Fink] (the [http://www.gnu.org/software/gettext gettext] package is ''gettext'' and the [[wxMac]] package is ''wxmac'' and ''wxmac-shlibs''),
# Read the documentation at http://fink.sourceforge.net/download to learn how to install [[wxMac]].
# Make ''amule'' dir in your home directory: ''mkdir ~/amule''
# Enter the ''amule'' directory you just created: ''cd ~/amule''
# Get [[aMule]]'s latest source code (aMule 2.0.0-rc8 sourcecode: [http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2 http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2]) and place it in your ''~/amule'' directory: ''curl -O http://download.berlios.de/amule/aMule-2.0.0rc8.tar.bz2''
# Extract it: ''tar -xjf aMule-2.0.0rc8.tar.bz2''
# Enter [[aMule]]'s sources directory: ''cd aMule-2.0.0rc8''
# Prepare the compilation (thanks to '''one_2_one''' and '''Babboia''' for his test&fix): ''./configure --disable-systray --disable-gtk --with-wx-config=/sw/bin/wx-config''
# And compile it: ''make''
# '''Optional:''' You can reduce the size of [[aMule]] from 44MB to 3MB by doing the following (anyway, this will make the [[aMule]] binary lose debug info, so you'll be unable to report problems to the [[aMule devs|aMule Team]] to make [[aMule]] a better program, which it is not recommended): ''strip src/amule''
# Copy the ''amule'' binary to the app-Container directory: ''cp src/amule amule.app/Contents/MacOS/'' ('''NOTE:''' If the ''MacOS'' directory is missing in ''amule.app'', create it by typing ''mkdir amule.app/Contents/MacOS'' before executing the previous command. Thanks to '''dan''' for the tip)
# And copy ''amule.app'' directory to your Applications folder: ''cp -R amule.app /Applications''
# If everything went OK, you can safely remove the downloaded packages:
## Remove [[aMule]]'s sources package: ''rm ~/amule/aMule-2.0.0rc8.tar.bz2''
## Optionally remove the extracted [[aMule]] sources (not recommended, since you might want to compile it again someday): ''rm -r ~/amule/aMule-2.0.0rc8''
## Optionally, if you if you decided to remove the extracted [[aMule]] sources, remove the ''~/amule'' directory (which should be empty by now): ''rmdir ~/amule''

== Installing [[wxMac]] from sources ==

Only follow this part of the guide if [[wxMac]] is not available through your [http://fink.sourceforge.net Fink] installation or if you really know what you're doing. In any other case, just jump to the next section.

# Create a directory where all the work will be done: ''mkdir ~/wxmac''
# Enter that directory: ''cd ~/wxmac''
# Download [[wxMac]] sources: ''curl -O ftp://biolpc22.york.ac.uk/pub/2.5.3/wxMac-2.5.3.tar.gz''
# Extract the file: ''tar -xzf wxMac-2.5.3.tar.gz''
# Enter the extracted sources' directory: ''cd wxMac-2.5.3''
# Directory ''build'' should already be there. If not, create it with: ''mkdir build''
# Now enter ''build'' directory: ''cd build''
# Prepare the compilation: ''../configure''
# And compile: ''make''
# Now install [[wxMac]] compilation: ''sudo make install''
# Get back to your home directory, you're done: ''cd ~''
# If everything went ok, you can safely remove:
## [[wxMac]]'s sources package: ''rm wxMac-2.5.3.tar.gz''
## Optionally remove the extracted [[wxMac]] sources (not recommended, since you might want to compile it again someday): ''rm -r ~/wxmac

'''NOTE:''' Since you're installing [[wxMac]] from sources instead of through [http://fink.sourceforge.net Fink], use ''./configure --disable-systray --disable-gtk --with-wx-config=/usr/local/bin/wx-config'' as your configure command at [[aMule]]'s compilation instead of ''./configure --disable-systray --disable-gtk --with-wx-config=/sw/bin/wx-config''

== Problems and solutions ==

*If [http://fink.sourceforge.net Fink] reports something like: ''After unpacking 11.2GB will be freed'', don't be afraid. [http://fink.sourceforge.net Fink] has evolved into a different way of managing packet's size and some old ("old": at least some months old) packages' sizes aren't handled correctly on the output. If this is your case, devide the number by 1024. So, what the above example really means is: ''After unpacking 11.2MB will be freed''.

*If you get an error like this: ''You cannot open the application "amule" because it may be damaged or incomplete'', right click on ''amule'', then click on ''Show Packages Contents'', go to "Contents">"MacOS"> and double click on ''amule''. Next time you start from ''amule.app'' it will run fine. If you still get the same error, move ''amule.app'' to the desktop and run it from there.

== Older releases ==

In older releases ([[aMule]] 2.0.0-rc7 and earlier), the app container wasn't included with the sources. If you are compiling any of this older releases and do not whish to upgrade (remember it is '''strongly''' recommended to upgrade to the latest release), you can:

*Download the latest [[aMule]] sources and get the app container from there (recommended option).
*Download [http://download.berlios.de/amule/aMule-App-Container.tar.bz2 aMule's app-Container]: ''curl -O http://download.berlios.de/amule/aMule-App-Container.tar.bz2''

You must extract the app container in your ''amule'' directory: possible ''~/amule''
To extract it: ''tar -xjf aMule-App-Container.tar.bz2''

'''NOTE:''' If the app-Container failed to extract try running this command instead of the app-Container extraction step: ''mkdir -p amule.app/Contents/MacOS''

Once the installation is finished, you can safely remove the app-Container package: ''rm aMule-App-Container.tar.bz2''

FAQ amulecmd

2005-01-06T17:01:25Z

80.224.220.31:

I cannot connect to [[aMuled]]. It seems [[aMuled]] does not create the listening port for connecting to it :-\

'''Please post your question at http://forum.amule.org'''

'''Wiki is the place for documentation, not for direct-assistance ;-)'''

'''You have probably not enabled [[External Connections]] in ''~/.eMule'''''

Webserver

2005-01-05T20:03:39Z

80.224.220.31:

=== Previous notes ===

If you installed [[aMule]] via [http://www.debian.org deb] or [http://www.rpm.org RPM] package, the [[aMuleWeb|webserver]] source is not included.
Since some few files are needed from the sources to set-up [[aMuleWeb|amuleweb]], please visit http://www.amule.org and download the tar.gz package for your [[aMule]] version.

== Set a [[aMuleWeb|Webserver]] with [[aMule]] ==

[[Webserver-1.2.x|Webserver with aMule 1.2.8 or earlier]]

=== Webserver with [[aMule]] 2.0.0-rc1 or later ===

*[http://www.gnu.org/software/tar/tar.html Untar] the sources and copy '''''src/aMule.tmpl''''' and '''''src/webserver/''''' into your '''''~/.aMule/''''' directory. The following (run from the sources directory), should do so:
:''cp -r src/aMule.tmpl src/webserver/ ~/.aMule/''

*Go to "Preferences"->"Remote Controls" (in [[aMule]]) and...
**Enable "Accept External Connections".
**Enable "Use TCP ports instead of unix local sockets".

::'''NOTE:''' On some early [[aMule]] 2.0.0-rcX versions the above two options weren't available (or didn't work). If you are using such [[aMule]] version and you don't wish to upgrade, then do the following:

::Shutdown [[aMule]] if it is still running.
::Edit your ''~/.eMule'' file, locate the ''[ExternalConnect]'' section and change:
:::''AcceptExternalConnections=1'' <-- To enable [[aMule]] listening for [[External Connections]].
:::''ECUseTCPPort=1'' <-- To use the [http://www.faqs.org/faqs/internet/tcp-ip/resource-list TCP] port. Very important since [http://www.unix.org Unix] sockets are disabled.

*Restart [[aMule]]

*Go to your "Preferences"->"Remote Controls" (in [[aMule]]) and setup your passwords here for [[External Connections]] and [[aMuleWeb|webserver]] login.
::'''NOTE:''' When you change your [[aMuleWeb|webserver]] and [[External Connections]] ports here, make sure to restart [[aMule]].
::'''NOTE:''' that ''"Enable [[aMuleWeb|Webserver]]"'' has no effect and will be renamed in 2.0.0rc8. [[aMuleWeb|Webserver]] is always enabled as long as you have [[External Connections]] enabled.
::'''NOTE:''' For users running [[aMuled|aMule Daemon]] you have to edit the ''.eMule'' file like shown above. For a way to setup a password check the [[Webserver-1.2.x|1.2.8 aMule HowTo]]. You can still do it in the same way.

*Now you're done! You are ready to run [[aMuleWeb|amuleweb]] and connect to it.

'''[[User:Stefanero|Stefanero]]'''

== Connecting to [[aMuleWeb|amuleweb]] ==

To run [[aMuleWeb]] run '''''amuleweb''''' on a terminal. For more information about running [[aMuleWeb]] check the [[aMuleWeb|aMuleWeb document]].

Once [[aMuleWeb]] is running, open a web browser and connect to:

''http://host:port''

where ''host'' stands for your host's name (try with ''localhost'') and port stands for the [[aMuleWeb]] port ('''NOT''' the [[External Connections]] port).

For example: ''http://localhost:4711''

== Standard ports ==

The ports can be set to anything, but this are the most used (the standard ones):

*[[External Connections]]: 4712
*[[aMuleWeb|amuleweb]]: 4711

Make sure you do not confuse with what each of them is.

== Where to report problems and questions? ==

For Problems or Questions just report on http://forum.amule.org forum or join [[IRC]] channel [irc://irc.freenode.net/amule #amule] at [irc://irc.freenode.net irc.freenode.net]

User:Bootstrap

2005-01-02T14:57:42Z

80.224.220.31:

'''[[aMule]] lover'''

Main [[aMule]] concerns:
*Hosts the [[aMule CVS]]
*Provides [[IRC]] channel bot
*Wrote the [[HowTo_Compile_In_RedHat-Fedora|RedHat/Fedora compilation HowTo]]

HowTo Compile In RedHat-Fedora

2005-01-02T14:55:28Z

80.224.220.31:

<h1>aMule in RedHat/Fedora</h1> ''(rev 0.1 by [[User:bootstrap|bootstrap]])''

== What's this all about? ==

This mini-howto explains how to get a working [[aMule]] installation on [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] based installations. 
It covers installing by [http://www.rpm.org RPM] as well as building from source. 
Focus is to keep things easy so that probably everybody will be able to follow this instructions without learning to rebuild a complete system from scratch ;)

== Show me the way... ==

This Section is divided into 2 parts. Part (a)  will cover the easy way using [http://www.rpm.org RPM]s (which is quite easy, so I really don't like to write it down, but there have been questions, and I won't leave them unanswered...), while part (b)  covers the more complex way: using the sources to build your own [[aMule]].

=== Easy ===

I said it's easy and it really is. The one and only rule to get an [http://www.rpm.org RPM] based [[aMule]] installation up and running is:

: Get the right [http://www.rpm.org RPM]s. That means:

: 1. Get [[wxWidgets|wxGTK]] and [[wxWidgets|wxBase]] from http://www.wxwidgets.org (you don't need the -devel packages to get [[aMule]] running) and install  them. Whatever someone else may say or you might think, don't use any other [[WxWidgets|wx]] [http://www.rpm.org RPM].

: 2. Install some additional [http://www.rpm.org RPM]s. On a common [http://www.redhat.com RedHat]-ish system you will have most of them, but I've read some questions regarding libcrypto (not [[libcrypto]]++, that's next...), so it's better to say that you will need to have openssl installed. If you're installing aMule <= 2.0rc6 you will also need to install [[libcrypto]]++ (we're talking about [[libcrypto]]++ from [http://www.eskimo.com/~weidai/cryptlib.html http://www.eskimo.com/~weidai/cryptlib.html]). You can find [http://www.rpm.org RPM]s for [http://www.redhat.com RedHat]/[http://fedora.redhat.org Fedora] on http://www.hirnriss.net or links on the [http://www.amule.org/amule/download.php aMule download page]. That should probably be all you [http://www.rpm.org RPM]s you will need to install by hand (actually [http://www.openssl.org openssl] will be installed on most systems, but as I mentioned before, there have been questions about that, so here you are...). If you're still getting a dependency problem and can't figure it out on your own, contact us through [[IRC]] (come to irc.freenode.net and visit #amule). Somebody will surely help you. Some [http://www.rpm.org RPM]s you should probably check are [http://curl.haxx.se libcurl], [http://www.openssl.org OpenSSL] and [http://www.gnu.org/software/make/manual/make.html automake] >= 1.7.

: 3. Get [[aMule]] from http://www.amule.org/dl/index.php?category=22 and install  it.

That's it. If nothing went wrong you can drop your root privileges  and start [[aMule]]. That's as easy as typing ''amule &'' in your favourite shell. Have fun!

=== Not that easy ===

==== First notes ====

So you're one of that guys that don't like [http://www.rpm.org RPM]s? Well - you asked for it...

Preparation:

You will need to get some [[wxWidgets|wx]] stuff. If you'd like to build [[wxBase]] and [[wxWidgets|wxGTK]] yourself, you will have to look into another howto. Building [[wxWidgets|wx]] can be complex and takes some time, so I really recommend to use the http://www.wxwidgets.org [http://www.rpm.org RPM]s.

As you want to build [[aMule]] yourself, you will need some more [http://www.rpm.org RPM]s than other people. Install [[wxWidgets|wxGTK]], [[wxBase]], [[wxWidgets|wxGTK]]-devel and [[wxBase]]-devel.

If you're building [[aMule]] <= 2.0rc6 you will also need [[libcrypto]]pp and [[libcrypto]]pp-devel ([http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] downloads at [http://www.hirnriss.net http://www.hirnriss.net]) to get [[aMule]] compiled. Skip this if you're building [[aMule]] => 2.0rc7.

Get the sources you want (probably a cvs tarball from http://amule.hirnriss.net ?) from http://www.amule.org and un[http://www.gnu.org/software/tar/tar.html tar] it (if you don't know about tarballs, use [http://www.rpm.org RPM]s. Please!) into a directory you'd like to work in.

Drop your root privileges  and proceed to the fun part...

==== Configuring your [[aMule]] build ====

The following is an example, but it will work on [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] systems and it's been used for quite some time when building the "official" [[aMule]] [http://www.rpm.org RPM]s. Anyway, your system or your opinion may be different, so feel free to change the options if you feel like changing them.

''Note: If you're building [[aMule]] => 2.0rc7 you will have an embedded [http://www.openssl.org/docs/crypto/crypto.html crypto] lib that makes [[libcrypto]]++ installation obsolete. It's enabled by default, so you don't need to change your configure options.''

Go to the directory you created, change into the [[aMule]] sources and type: ''./configure --prefix=/usr --enable-optimize --enable-amulecmd --enable-amulecmdgui --enable-webserver --enable-webservergui --enable-utf8-systray --with-wx-config=/usr/bin/wxgtk-2.4-config --with-wxbase-config=/usr/bin/wxbase-2.4-config''

Now you should see a bunch of output, while your system tries to configure [[aMule]] for building. If you're '''NOT''' building a [http://www.gnu.org/software/cvs CVS] Version and you encounter problems, join the [[IRC|aMule IRC channel] at #amule on irc.freenode.net and prepare to paste some info. If your building a [http://www.gnu.org/software/cvs CVS] version you should probably wait a day and try again - it may just be some of those days where [http://www.gnu.org/software/cvs CVS] sources are not really working out for unexperienced users ;). If you're suspecting an interesting bug or just want to build that tarball whatever it takes, you're welcome to [[IRC]] in #amule as well, but bring some time because solving problems may not be as easy as installing [http://www.rpm.org RPM]s.

Once configure is done (should not take that long... 30 - 60 seconds on a modern system, a little more on older systems) type ''make'', sit down and relax. Depending on your systems speed this can take some time. Prepare for at least 5 minutes of strange output. If make stops check the last few lines of output for something that looks like an error message. If you can find something that looks like an error message, again, join [[IRC]], come to #amule and prepare for pasting or do a ''make clean'', try to change some of your configure options and restart ''make''. If it's still not working, ask someone at [[IRC]] in #amule on irc.freenode.net for help.

If your build completed without error you're nearly done.

Get root privileges and type ''make install'' to install your newly built [[aMule]]. Now drop your root privileges  and try to start [[aMule]] with ''amule &''. If your build was ok and you had a good day on [http://www.gnu.org/software/cvs CVS] versions you may have a great piece of software running by now. If your [[aMule]] instantly dies and produces a bunch of output containing words like "backtrace" - don't worry, Join [[IRC]] at #amule on irc.freenode.net and somebody might help you.

After building you can remove the directory you just built [[aMule]] in, as well as you can remove the installed -devel [http://www.rpm.org RPM]s. I suggest you leave the [http://www.rpm.org RPM]s in place in case you want to rebuild or build a new version some other day.

If nothing works and your home built [[aMule]] won't run, don't worry, try one of our [http://www.rpm.org RPM]s ;)

== Suggestions ==

This section is quite small (at the time of this writing) and contains some tips regarding [[aMule]] usage.

: * Drop your root privileges. Don't work/play/watch movies/drive a car/{you're favourite way to waste some time here} as root. Working as root can be dangerous. One mistake can lead to some interesting hours, restoring your system's health. If you know what you're doing: fine, but it's probably still better if you don't work as root.

: * Keep an eye on the [http://forum.amule.org aMule forum] and the [[Main_Page|aMule Project FAQ]] and probably use the search function: most questions have been answered before.

: * Don't drink and drive.

... to be continued ...

== Additional fun ==

This section covers additional ways to have fun with or around [[aMule]].

[http://www.uk.research.att.com/vnc VNC] Server. Did you ever think about using [[aMule]] on your server? If you don't like webservers and want to have more access to your system but a limited web GUI, this info is for you.

Using [[aMule]] in [http://www.uk.research.att.com/vnc VNC] is quite easy in [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora], because you don't need more than a simple [http://www.rpm.com RPM] install  of vnc-server and a minor modification to a startup script.

Just install vnc-server ([http://www.rpm.org RPM] comes with your installation CDs) and drop your root privileges.
This howto assumes that your default user is named ''bob''.
As 'bob' do: ''vncserver -depth 16 :1''. If you never used [http://www.uk.research.att.com/vnc VNC] as 'bob' before, the [http://www.uk.research.att.com/vnc VNC] server should ask you for a password. This password is used to connect to your [http://www.uk.research.att.com/vnc VNC] session. It is ''not'' the password your user 'bob' has and it should not be set to the same password. Furthermore your [http://www.uk.research.att.com/vnc VNC] password can be only 8 letters/digits long, so you really should not set your users pw here.
The next step would be to test if your server is running as expected. Use you desktop or any other remote system to connect to your [http://www.uk.research.att.com/vnc VNC] session. To make sure you get the right port, use the following syntax: ''pizza:1'' or ''192.168.100.1'' assuming your server is named pizza and your [http://www.dns.net/dnsrd DNS] is running, or your server is running on the [http://www.faqs.org/rfcs/rfc791.html IP] 192.168.100.1 - if not, change the values to your needs.
Once your connection is up, you should be watching a very simple and nearly ugly desktop by now (i'm pretty sure the [http://www.plig.org/xwinman/vtwm.html twm] folks will kill me if they read this... sorry guys). This is because the default setting is to start only a little set of applications and a small window manager inside [http://www.uk.research.att.com/vnc VNC]. Go back to your shell and stop [http://www.uk.research.att.com/vnc VNC] using ''vncserver -kill :1'' as 'bob'. Now your [http://www.uk.research.att.com/vnc VNC] server should immediatly go offline. As next step edit ''/home/bob/.vnc/xstartup'' - uncomment the two lines below ''"Uncomment the following two lines for a normal desktop"'' and comment the rest. If you now start your [http://www.uk.research.att.com/vnc VNC] server again, you will have a fully functional [http://www.redhat.com RedHat]/[http://fedora.redhat.com Fedora] desktop. Now open a shell or use your window manager to start [[aMule]] and enjoy. One last hint: [http://www.uk.research.att.com/vnc VNC] uses encryption and timeouts to protect your password, but it's not perfectly secure. To get an even more secure system, I'd recommend using a screensaver on your newly created desktop. If you're using [http://www.kde.org KDE] you should have a nice button on your taskbar already. That should protect your system, even if your [http://www.uk.research.att.com/vnc VNC] password has been compromised.

== How to use [http://www.rpm.org RPM] ==

There are several how to's on [http://www.rpm.org RPM] available so I won't try to write a new one. Here are some short hints to help you out in case you're completely new to your system and just want to follow the [[aMule]] installation from part 2.

Install: ''rpm -i rpmname'' (use the complete filename of your [http://www.rpm.org RPM], like: ''openssl-0.9.7a-35.i386.rpm'')

Remove: ''rpm -e rpmname'' (don't use the complete filename here, just the package name. Like ''openssl'', but not ''openssl-0.9.7a-35'')

Update: ''rpm -U rpmname'' (use the complete filename of your rpm, like: ''openssl-0.9.7a-35.i386.rpm'')

If you need any further info on [http://www.rpm.org RPM], please consult the rpm howto or use ''[http://www.rpm.org/max-rpm/rpm.8.html man rpm]''.

FAQ wxcas

2005-01-01T10:49:31Z

80.224.220.31:

Hi guys...

I run aMule 2.0.0rc8 and try open tool Wxcas and recive this error mesage:

can't open file '/home/angel/.aMule/amulesig.dat' (error 2: No such file or directory)

Solution?

I run Fedora Core 3

'''Go to aMule -> Preferences -> Online Signature -> Enable OnlineSignature'''

AMule devs

2004-12-29T22:30:44Z

80.224.220.31:

== The [[aMule]] Project ==
The aMule project is led by a bunch in people who toil away in front of their computers, so that you can enjoy a stable and featureful P2P client.
This page is about us.

== The Team ==
These are the people who work on aMule:

=== Developers ===

* [[User:deltaHF|deltaHF]]: Webmaster, Admin and from-time-to-time-coder ;)
* [[User:Jacobo221|Jacobo221]]: Our man-for-all
* [[User:Kry|Kry]]: Main developer and Admin
* [[User:lfroen|lfroen]]: Core/GUI dedicated guy.
* [[User:Phoenix|Phoenix]]: Code janitor junior.
* [[User:thepolish|thepolish]]: [[aMule]] [[FAQ_utils|tools]] coder.
* [[User:Unleashed|Unleashed]]: Sometimes around ;)
* [[User:Xaignar|Xaignar]]: Code janitor extraordinaire!
* [[User:GonoszTopi|GonoszTopi]]: [[External Connections]] developer.
* [[User:falso|falso]]: [[CAS]] coder.
* [[User:Hetfield|Hetfield]]: Admin, pretty-no-free-time coder.

=== Testers ===
* [[User:Citroklar|Citroklar]]: Tester, slave-work-coder (sometimes)
* ender`: Tester
* nachbarnebenan: Tester, and life-complicator by using large&strange nicks ;-P
* nich: Tester
* [[User:Stefanero|Stefanero]]: Supporter, Tester, and [[aMuleWeb]] Guru

=== Special Gold Guest Members ===
* [[User:Bigbob|Bigbob]]: Also known as ''[[User:Bigbob|Creteil]]''; [[aMule]] project creator.
* [[User:Madcat|Madcat]]: The one and only kitty dev.
* [[User:Tiku|Tiku]]: And God said: Let there be [[lMule]]!

=== Others ===
* [[User:Bootstrap|bootstrap]]: [[IRC]] bot (''bootbox'') and [[aMule CVS]] hoster
* [[User:uberpenguin|uberpenguin]]: uberpenguin is extremely difficult to classify... Let us call him the 'official bystander to *mule'.
* niet: [http://www.dns.net/dnsrd DNS] stuff, [[XAS]], tester.

=== Former Team-members ===
These are people who have worked on [[aMule]] in the past.
Please note that this list doesn't include the people from before [[aMule]] forked off from [[xMule]], nor does it include people from the [[LMule]] days. If you wish to learn more about those, please visit the websites of those projects.

==== Developers ====
* shakraw: [[aMuleWeb]] mantainer.

==== Testers ====

== Helping ==
We can always use another helping hand, and if you are interested, then I'd encourage you to contact us and see if you can help us. Currently, what we need the most is developers and testers, though also translators and others.

=== Becoming a Developer ===
To become a [[aMule]] Developer (tm), you'll need at the very least a working knowledge of C++, since that is the language in which [[aMule]] is written. You'll also need to learn about the GUI toolkit used by [[aMule]]: [[wxWidgets]].

However, we do not require that you are an expert, only that you are willing to help and willing to learn.

If you are interested, then simply drop by on [[IRC]] and let us know. Currently we use a private [http://www.gnu.org/software/cvs CVS] server, but after you've submitted a patch or two you can easily get r/w access to it.

Besides [[IRC]], you can post patches on [http://www.amule-project.net/amule/board.php?boardid=47 aMule's Development forum]. After a few good patches, you might become a developer.

We can use your skills if you are using one of the platforms where we aim at being usable on: Unix, [http://www.sun.com/solaris Solaris], [http://www.apple.com Macs] and [http://www.microsoft.com/windows Windows].
And if your operating system of choice isn't on that list, then maybe you can help add it.

=== Becoming a Tester ===
We need people who are willing to create complete bug-reports, as the standard is pretty low regarding user reports. This is rather simple, but takes patience. Please contact us on [[IRC]] for more information and read [[Backtraces|this guide on creating useful backtraces]].

=== Becoming a Translator ===
[[aMule]] already includes translations for a number of languages, however, we'll always welcome more, and even if your language of choice has been done already, then perhaps you can help improve it. Please see the [http://forum.amule.org/board.php?boardid=40 Translations forum] for more information on current translations, or contact us on [[IRC]]. Also, take a deep look into the [[Translations|aMule translation howto]].

Of course, you can also work on [[Translating_Wiki|translating this wiki]]'s articles. There's still a lot of work to do!

Backtraces

2004-12-28T21:29:33Z

80.224.220.31:

== Introduction ==

Well, not hard to guess, this is about backtraces.

Usually, it should not be necessary for the normal user to do this. However, we might have a bad day and release a somewhat buggy version or you are running [http://www.gnu.org/software/cvs CVS] which can also be unstable sometimes.
This is where the backtraces come in: if [[aMule]] crashes, and you get an "OOPS - aMule crashed" and so on, we'd like to know. The backtrace [[aMule]] provides is not always very usefull as it contains little information, but, as usual, there's a better way: A *real* backtrace.

== The GNU Debugger ==

First of all, you need the [http://www.gnu.org/software/gdb/gdb.html GNU Debugger] installed. It's called ''gdb'' and you could check for that by typing ''which gdb'' in a console window. You should see something like this:

''<pre>
$ which gdb
/usr/bin/gdb
</pre>''

If you don't have [http://www.gnu.org/software/gdb/gdb.html GDB] installed, you will get a message like this: 

''<pre>
$ which gdb
which: no gdb in (/bin:/usr/bin:[etc])
</pre>''

If that is the case, the [http://www.gnu.org/software/gdb/gdb.html GNU Debugger] is most likely not installed on your system and you should install it before you proceed.

If your OS is [http://www.gentoo.org Gentoo Linux] you have just to type that:
''<pre>
# emerge -av gdb
</pre>''

== Compiling [[aMule]] ==

Then, compile [[aMule]] with debugging information:

''<pre>
$ ./configure --enable-debug --disable-optimise --prefix=/where/to/install/aMule
$ make
$ make install
</pre>''

If you do not want to overwrite you old copy of [[aMule]], simply do this instead:

''<pre>
$ ./configure --enable-debug --disable-optimise
$ make
</pre>''

[[aMule]] can then be run by going into the dir ''src'' and typing ''./amule''

If you are unable or unwilling to recompile, or are running a RPM version, proceed anyway, but be aware that backtraces from debugging enabled builds are much more useful to us.

== Create a backtrace ==

Now create in your home directory the file ''.gdbinit'' and put these lines into it (or you can type them in at the ''(gdb)'' prompt later):
''<pre>
ha SIGPIPE nostop noprint pass
ha SIG32 nostop noprint pass
</pre>''

For those who want to know the meaning of the previous lines:
the first one avoid [http://www.gnu.org/software/gdb/gdb.html GDB] stopping at broken pipes;
the second one avoid [http://www.gnu.org/software/gdb/gdb.html GDB] stopping at new thread.

To create a backtrace, open a console and do the following:

''<pre>
$ gdb /where/to/install/aMule/bin/amule
(gdb) run
</pre>''

Now use [[aMule]] normally until it crashes. If it crashes do the following:

''<pre>
(gdb) bt
(gdb) bt full
</pre>''

Post the output of the last two commands in the [http://www.amule.org/amule/board.php?boardid=33 backtraces forum] with some additional comment about the circumstances the segfault happened and what [[aMule]] version you used (or checkout time for [http://www.gnu.org/software/cvs CVS]).

== The core file ==

If your [[aMule]] executable has been compiled with debug information (''--enable-debug'' configure flag), but you were not running it from within [http://www.gnu.org/software/gdb/gdb.html GDB], there is still a way to generate a backtrace, if your system was configured to generate '''core files'''.

Core files are the full memory image of a process that crashed. Your session must be properly configured, so that the system generates core files. Add the following command to ''~/.bashrc'':

''ulimit -c unlimited''

Now, when a program crashes, suppose it generate the file ''core.1234'' (this name can be different, but usually will start with 'core') you can enter [http://www.gnu.org/software/gdb/gdb.html GDB] like that:

''$ gdb /path/to/amule /path/to/core/file/core.1234''

and then proceed as in the last session and issue 'bt' and 'bt full'.

So, that's it, have fun with [[aMule]]

Greetings, [[User:Citroklar|Citroklar]] & [[User:Phoenix|Phoenix]]

(Most of the above shamelessly stolen from pure_ascii's post in backtraces forum, thanks, pure!)

Please read [[Using_gdb_and_valgrind|this]] to learn more about [http://www.gnu.org/software/gdb/gdb.html GDB] and [http://valgrind.kde.org Valgrind].