AMule Project FAQ - User contributions [en]

GeoIP.dat file

2012-06-20T15:04:08Z

Reorder: /* Description */

== File ==
'''Name:''' ''GeoIP.dat''

'''Location:''' ''~/.aMule/''

== Description ==
Binary format file containing a database of the physical location of IP addresses. It is used by the GeoIP extension of php. For more information on that, see the [http://www.php.net/manual/en/book.geoip.php PHP Manual - Geo IP Location].

GeoIP.dat is published by [http://www.maxmind.com/ MaxMind]. To get the latest version of the file, or to download the APIs for using it, go to the [http://www.maxmind.com/app/geolite MaxMind GeoLite Databases] page.

== Format ==
Binary, and possibly proprietary.

== Notes ==
The location from which to download GeoIP.dat would appear to be hard-coded into '''Preferences.cpp''':

<pre>
$ grep -n "GeoIP.dat" Preferences.cpp
1254: s_MiscList.push_back( new Cfg_Str( wxT("/eMule/GeoLiteCountryUpdateUrl"),
s_GeoIPUpdateUrl, wxT("http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz") ) );
</pre>

[[Category:Program Files]]

GeoIP.dat file

2012-06-20T15:03:30Z

Reorder: /* Notes */

== File ==
'''Name:''' ''GeoIP.dat''

'''Location:''' ''~/.aMule/''

== Description ==
Binary format file containing a database of the physical location of IP addresses. It is used by the GeoIP extension of php. For more information on that, see the [http://www.php.net/manual/en/book.geoip.php PHP Manual - Geo IP Location].

GeoIP.dat is published by [[http://www.maxmind.com/|MaxMind]]. To get the latest version of the file, or to download the APIs for using it, go to the [http://www.maxmind.com/app/geolite MaxMind GeoLite Databases] page.

== Format ==
Binary, and possibly proprietary.

== Notes ==
The location from which to download GeoIP.dat would appear to be hard-coded into '''Preferences.cpp''':

<pre>
$ grep -n "GeoIP.dat" Preferences.cpp
1254: s_MiscList.push_back( new Cfg_Str( wxT("/eMule/GeoLiteCountryUpdateUrl"),
s_GeoIPUpdateUrl, wxT("http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz") ) );
</pre>

[[Category:Program Files]]

GeoIP.dat file

2012-06-20T15:02:49Z

Reorder: Created page with '== File == '''Name:''' ''GeoIP.dat'' '''Location:''' ''~/.aMule/'' == Description == Binary format file containing a database of the physical location of IP addresses. It is u…'

== File ==
'''Name:''' ''GeoIP.dat''

'''Location:''' ''~/.aMule/''

== Description ==
Binary format file containing a database of the physical location of IP addresses. It is used by the GeoIP extension of php. For more information on that, see the [http://www.php.net/manual/en/book.geoip.php PHP Manual - Geo IP Location].

GeoIP.dat is published by [[http://www.maxmind.com/|MaxMind]]. To get the latest version of the file, or to download the APIs for using it, go to the [http://www.maxmind.com/app/geolite MaxMind GeoLite Databases] page.

== Format ==
Binary, and possibly proprietary.

== Notes ==
The location from which to download GeoIP.dat would appear to be hard-coded into '''Preferences.cpp''':

<pre>
$ grep -n "GeoIP.dat" Preferences.cpp
1254: s_MiscList.push_back( new Cfg_Str( wxT("/eMule/GeoLiteCountryUpdateUrl"), s_GeoIPUpdateUrl, wxT("http://geolite.maxmind.com/download/geoip/database/GeoLiteCountry/GeoIP.dat.gz") ) );
</pre>

[[Category:Program Files]]

AMule files

2012-06-20T14:29:29Z

Reorder: /* Program Files */ Found some info on GeoIP.dat; also making relevent page

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
**'''~/.aMule/amule.conf.bak:''' Backup of [[amule.conf file]].
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
**'''~/.aMule/clients.met.bak:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[GeoIP.dat_file|~/.aMule/GeoIP.dat]]:''' Used to identify the country of an IP address.
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
**'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
**'''~/.aMule/known2_64.met:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
**'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
**'''~/.aMule/server.met.bak:''' Backup of [[server.met file]].
**'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
**'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

See also: [[:Category:Program Files]]

=== Deprecated ===

*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''~/.aMule/known2.met:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

[[Category:Program Files]]

AMule files

2012-06-20T14:11:26Z

Reorder: /* Program Files */ What ''does'' GeoIP.dat do? More info?

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
**'''~/.aMule/amule.conf.bak:''' Backup of [[amule.conf file]].
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
**'''~/.aMule/clients.met.bak:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''~/.aMule/GeoIP.dat:''' ¿Something to do with identifying the source country of IP addresses?
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
**'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
**'''~/.aMule/known2_64.met:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
**'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
**'''~/.aMule/server.met.bak:''' Backup of [[server.met file]].
**'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
**'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

See also: [[:Category:Program Files]]

=== Deprecated ===

*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''~/.aMule/known2.met:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

[[Category:Program Files]]

AMule files

2012-06-20T11:32:29Z

Reorder: Moved another deprecated file; Made some entries children

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
**'''~/.aMule/amule.conf.bak:''' Backup of [[amule.conf file]].
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
**'''~/.aMule/clients.met.bak:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
**'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
**'''~/.aMule/known2_64.met:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
**'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
**'''~/.aMule/server.met.bak:''' Backup of [[server.met file]].
**'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
**'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

See also: [[:Category:Program Files]]

=== Deprecated ===

*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''~/.aMule/known2.met:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

[[Category:Program Files]]

AMule files

2012-06-20T11:22:18Z

Reorder: /* Program Files */ Move files to "Deprecated" section; add entries for two .bak files

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''~/.aMule/amule.conf.bak:''' Backup of [[amule.conf file]].
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
*'''~/.aMule/clients.met.bak:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
*'''~/.aMule/known2_64.met:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
*'''~/.aMule/server.met.bak:''' Backup of [[server.met file]].
*'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
*'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

See also: [[:Category:Program Files]]

=== Deprecated ===

*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''~/.aMule/known2.met:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

[[Category:Program Files]]

Tmp.html file

2012-06-20T11:06:09Z

Reorder: /* Notes */

== File ==
'''Name:''' ''tmp.html''

'''Location:''' ''/usr/share/pixmaps/''

== Description ==

This is an [http://www.w3.org/MarkUp HTML] template to use with [[CAS]]. CAS will use it to generate an HTML file showing current [[aMule]]'s status.

== Format ==
What CAS will actually do is pretty simple: It will replace some keywords with the status of your currently running aMule instance.

THe following table shows what keywords will be replaced with what status information:

{|+ CAS HTML template keywords
| '''Keyword''' || '''Information'''
|-
| ''#VERSION#'' || CAS version name
|-
| ''#CLIENT#'' || [[Connect]]ion status and uptime
|-
| ''#NICK#'' || aMule's [[username]]
|-
| ''#UPLOADRATE#'' || [[Upload]] rate
|-
| ''#DOWNLOADRATE# || [[Download]] rate
|-
| ''#QUEUE#'' || Amount of [[client]]s on [[queue]]
|-
| ''#NUMSHARE#'' || Amount of [[file]]s being [[share]]d
|-
| ''#SESSIONUP#'' || Amount of [[byte]]s uploaded in current [[session]]
|-
| ''#SESSIONDOWN#'' || Amount of bytes downloaded in current session
|-
| ''#TOTALUP#'' || Amount of [[byte]]s uploaded since aMule was installed
|-
| ''#TOTALDOWN# || Amount of [[byte]]s downloaded since aMule was installed
|-
| ''#SERVER#'' || [[Server]] name
|-
| ''#IP#'' || Server [[IP address|IP]]
|-
| ''#PORT#'' || Server [[port]]
|}

== Notes ==
You might want to take a look at the [http://www.w3.org/MarkUp HTML specifications].

[[Category:Program Files]]

Remote.conf file

2012-06-20T11:04:45Z

Reorder: /* Example */

== File ==
'''Name:''' ''remote.conf''

'''Location:''' ''~/.aMule/''

== Description ==
This is the common configuration [[aMule_files|file]] for all remote tools ([[aMuleCMD]], [[aMuleWeb]], [[aMuleGUI|remote gui]]). The above mentioned name and location is the default name and location for this file, but, unlike all other config files, they can be changed via the ''-f'' (''--config-file'') command-line parameter.

'''Note''': command-line switches and parameters apply only to aMuleCmd and aMuleWeb. aMule remote GUI does not yet implement them.

== Format ==
This is a text file, in the format of the [http://www.microsoft.com/windows Windows] .INI files.

In the file, configuration options are set in key-value pairs. Each line contains exactly one key-value pair, in the form of <''key''>=<''value''> (except for group headers and comments, see below). Keys are organized into groups, and even groups may have sub-groups. Any line starting with a ';' (semicolon) character is considered to be a comment. Comments and empty lines are ignored. Group headers are in the form '['<''group name''>']'.

Keys are referenced as if they were files in a file system where directories are the groups. For example, the key '' 'Password' '' in the group '' 'EC' '' is referenced as '' '/EC/Password' ''. Hopefully the following descriptions and the example will make it clear.

== Keys description ==
=== General notes ===
*For keys that accept an [http://en.wikipedia.org/wiki/MD5 MD5] [[hash]], the value is always case insensitive.
*For keys that enable/disable something (or at least have a boolean type value), '0' means 'false' or 'disabled', '1' means 'true' or 'enabled'.

=== Common keys ===
; '''/Locale''' : Selects language that remote tools should use. Possible values are the language codes for the given language, such as ''de'', ''en_GB''; or the proper english name of the language, e.g. ''french''. Defaults to an empty value, which means '' 'use system default language' ''. Can be overridden by the ''-l'' (''--locale'') command-line parameter.

; '''/EC/Host''' : Hostname or [[IP address|IP]] address of the remote running core ([[aMule]] or [[aMuled]]). Defaults to '' 'localhost' ''. Can be overridden by the ''-h'' (''--host'') command-line parameter.

; '''/EC/Port''' : [[Port]] number where remote core listens to [[External Connections]] (EC). Defaults to '' '4712' ''. Can be overridden by the ''-p'' (''--port'') command-line parameter.

; '''/EC/Password''' : MD5 hash of the password used for EC [[connect]]ion. Can be overridden by the ''-P'' (''--password'') command-line parameter, which accepts a plain-text password!

=== Keys specific to aMuleCmd ===
None.

=== Keys specific to aMuleWeb ===
; '''/Webserver/Port''' : Port number, where aMuleWeb listens for connections from browsers. Defaults to '' '-1' '', which means '' 'query from remote core' ''. If query fails for some reason, '' '4711' '' will be used, but aMuleWeb will most likely be unusable (if such a simple query fails, what to expect from more complex queries?). Can be overridden by the ''-s'' (''--server-port'') command-line parameter.

; '''/Webserver/Template''' : Name of the web template to use. Defaults to '' 'default' ''. The current version of aMuleWeb installs one another template, named '' 'chicane' ''. Can be overridden by the ''-t'' (''--template'') command-line parameter.

; '''/Webserver/UseGzip''' : Enables or disables [http://www.gzip.org/ gzip] compression of [http://www.w3.org/MarkUp/ HTML] pages. Defaults to disabled. Can be overridden by the ''-z'' (''--enable-gzip'') or ''-Z'' (''--disable-gzip'') command-line switches.

; '''/Webserver/AllowGuest''' : Enables or disables guest mode logins to the web interface. Defaults to disabled. Can be overridden by the ''-a'' (''--allow-guest'') or ''-d'' (''--deny--guest'') command-line switches.

; '''/Webserver/AdminPassword''' : MD5 password for admin login. Can be overridden by the ''-A'' (''--admin-pass'') command-line parameter, which accepts a plain-text password!

; '''/Webserver/GuestPassword''' : MD5 password for guest login. Makes sense only when guest login is enabled. Can be overridden by the ''-G'' (''--guest-pass'') command-line parameter, which accepts a plain-text password!

; '''/Webserver/PageRefreshTime''' : Time interval in seconds between page reloads. '' '0' '' means '' 'page refresh disabled' ''. Defaults to '' '120' '', i.e. 2 minutes.

; '''/Webserver/GraphHeight''' : Height (in pixels) of the statistics graphs. Default is '' '149' ''.

; '''/Webserver/GraphWidth''' : Width (in pixels) of the statistics graphs. Default is '' '500' ''.

; '''/Webserver/GraphScale''' : Scaling of the statistics graphs. This means '' 'each pixel in the graph represents '' 'x' '' seconds' ''. Default is 3 seconds/pixel.

=== Keys specific to Remote GUI ===
Remote GUI currently messes up remote.conf, saves a lot of irrelevant keys and does not save some important ones. When this will be fixed, I'll describe its keys too. 

== Example ==
The example below shows a default ''remote.conf'' file, with the exception of the EC password, which is set to dummy (but valid) value.

Locale=
[EC]
Host=localhost
Port=4712
Password=5D41402ABC4B2A76B9719D911017C592
[Webserver]
Port=-1
Template=default
UseGzip=0
AllowGuest=0
AdminPassword=
GuestPassword=
PageRefreshTime=120
GraphHeight=149
GraphWidth=500
GraphScale=3

[[Category:Program Files]]

PreferencesKad.dat file

2012-06-20T11:04:00Z

Reorder: /* Extra */

== File ==
'''Name:''' ''preferencesKad.dat''

'''Location:''' ''~/.aMule/''

== Description ==
This file stores the [[IP address|IP]] and [[Kademlia]] [[ClientID]].

== Format ==
The file format is as follows:

*''IP'': Stores the [client]]'s IP (4 bytes, LSB first)
*''Deprecated field'': This field is no more used, so it's filled with 0s (2 bytes)
*''ClientID'': The client's ClientID (16 bytes)
*''End of tags signal'': Old [[eMule]] clients expected more info to be read on this file. To remain compatible with those clients, this field is set to 0 (1 byte)

Reading and writing the ''ClientID'' is somewhat tricky. It is stored as four 32bit little-endian integers, which themselves represent the 128bit value in big-endian order. See the example below.

== Example ==
The following is a hex dump of an hypothetic ''preferencesKad.dat'' file:

''01 40 52 5B 00 00 B4 F1 52 14 18 17 9A 80 44 57 29 8A B9 3A 2B 6F 00''

In the above example, the following data can be seen:

*IP: ''91.82.64.1'' (In hex: ''0x5B524001'')
*Deprecated field: ''0'' (In hex: ''0x0000'')
*ClientID: ''1452F1B4809A17188A2957446F2B3AB9''
*End of tags signal: ''0'' (In hex: ''0x00'')

== Extra ==
[[aMule]] ignores the ''End of tags signal'' when reading this file, so it is optional to use it. Anyway, [[aMule]] does write it to keep compatibility with old [[eMule]] clients.

[[Category:Program Files]]

MuleLock file

2012-06-20T11:02:59Z

Reorder: /* Notes */

== File ==

'''Name:''' ''muleLock''

'''Location:''' ''~/.aMule/''

== Description ==

This file is generated by [[aMule]] to prevent two aMule instances being run by the same user. See the [[muleLock_file#Notes|Notes section]] for more information.

== Format ==

This file simply contains the PID of the user's running aMule instance.

== Example ==

The following is the contents of a valid ''muleLock'' file:

3865

== Notes ==

This file is created when starting aMule and it writes its PID number in it. When aMule exits, it deletes the file.

When aMule starts, it checks if the ''muleLock'' fiel exists. If it does, it reads it and checks if the number it contains is the PID of a running process. If it is, then it closes itself to prevent two aMule intances running simoultaneously.

Notice that aMule will not check that the process corresponds to a real aMule process. Any processes running with the PID contained in the ''muleLock'' file will prevent aMule from starting.

[[Category:Program Files]]

Logfile file

2012-06-20T11:02:22Z

Reorder: /* Notes */

== File ==

'''Name:''' ''logfile''

'''Location:''' ''~/.aMule/''

== Description ==

This [[file]] contains the [[log]] of the last (or current if still active) [[aMule]] execution.

It contains all errors, warning and messages aMule has reported.

When aMule starts, it creates a new log. The previous log is stored as "logfile.bak".

== Format ==

It's format is very simple:

''<Date> <Time>: <Log-line>''

This are the field's meanings:
*'''Date''': Stands for the date when the log line was reported (in YYYY-MM-DD foramt)
*'''Time''': Stands for the time when the log line was reported (in HH:MM:SS format)
*'''Log-line''': Stands for the log line itself

== Example ==

This is the contents of a possible log file:

2005-12-11 06:57:57: Creditfile loaded, 21523 clients are known
2005-12-11 06:57:58:
2005-12-11 06:57:58: - This is aMule CVS using wxGTK2 v2.6.1 (Unicoded) (Snapshot: rev. 5953) based on eMule.
2005-12-11 06:57:58: Running on Linux 2.6.14.3 i686
2005-12-11 06:57:58: - Visit http://www.amule.org to check if a new version is available.
2005-12-11 06:57:58:
2005-12-11 06:57:58: Loading ipfilter.dat files.
2005-12-11 06:57:58: Loaded 571 IP-ranges from 'ipfilter.dat'. 1 malformed lines were discarded.
2005-12-11 06:57:59: Loaded 0 IP-ranges from 'ipfilter_static.dat'. 0 malformed lines were discarded.
2005-12-11 06:57:59: Loading server.met file: /home/jacobo/.aMule/server.met
2005-12-11 06:57:59: 73 servers in server.met found
2005-12-11 06:58:01: Found 168 part files
2005-12-11 06:58:01: *** TCP socket (ECServer) listening on 0.0.0.0:4712
2005-12-11 06:58:01: Found 87 known shared files
2005-12-11 06:58:06: AICH Thread: Syncronization thread started.
2005-12-11 06:58:06: AICH Thread: Masterhashes of known files have been loaded.
2005-12-11 06:58:06: AICH Thread: No new files found.
2005-12-11 06:58:06: AICH Thread: Terminated.
2005-12-11 06:58:06: Connecting
2005-12-11 06:58:07: Connecting to Rasorpack 2.0 (19.25.44.23 - 19.25.44.23:80)
2005-12-11 06:58:07: Read 0 Kad contacts
2005-12-11 06:58:08: Connecting to Rasorpack 3 (20.1.16.36 - 20.1.16.36:5000)
2005-12-11 06:58:08: Connected to Rasorpack 2.0 (19.25.44.23:4661)
2005-12-11 06:58:08: Connected to Kad (firewalled)
2005-12-11 06:58:09: Connection established on: Rasorpack 2.0
2005-12-11 06:58:09: Connected to Rasorpack 2.0 with HighID
2005-12-11 06:58:09: New clientid is 675249139
2005-12-11 06:58:09: ServerMessage: server version 17.7 (lugdunum)
2005-12-11 06:58:09: ServerMessage: Rasorpack 2 - Dual Opteron Server / www.rasorpack2.com
2005-12-11 06:58:09: ServerMessage: .
2005-12-11 06:58:09: ServerMessage: We cannot be held responsible for any illegal use that could be made of this server
2005-12-11 06:58:09: ServerMessage: .
2005-12-11 06:58:09: ServerMessage: Use an up-to-date client to get better results
2005-12-11 06:58:09: ServerMessage: Information about the last versions of eD2k clients :
2005-12-11 06:58:09: ServerMessage: http://www.rasorpack2.com/fr/faqs/msg/48
2005-12-11 06:58:09: ServerMessage: .
2005-12-11 06:58:09: ServerMessage: Urgente : Mejorad la seguridad de vuestra mula : http://www.rasorpack2.com/fr/faqs/msg/50
2005-12-11 06:58:09: ServerMessage: .
2005-12-11 06:58:09: ServerMessage: Descarga rapidissima y sin limite - Prueben gratis
2005-12-11 06:58:09: ServerMessage: .
2005-12-11 06:59:00: Downloading Make.aMule.mine.rar
2005-12-11 06:59:33: Deleting file: Old.free.film.avi
2005-12-11 07:01:53: Connected to Kad (ok)

== Notes ==

If a log line contains more than just one single line, it will only be given a date and time once, at the beginning of the first line.

[[Category:Program Files]]

Last version check file

2012-06-20T11:01:21Z

Reorder: /* Notes */

== File ==

'''Name:''' ''last_version_check''

'''Location:''' ''~/.aMule/''

== Description ==

This [[file]] is [[download]]ed from http://amule.sourceforge.net/lastversion so that [[aMule]] knows if newer versions have been released and, if so, tell the [[user]].

== Format ==

A single line containing the lastest [[aMule]] release's version number.

These versions are expected to be strings of natural numbers (>= 0) and dots (''.'') only.

== Example ==

2.0.3

== Notes ==

A minimum of two dots (''.'') have to exist in this [[file]]. Otherwise it will be considered [[corrupt]].

[[Category:Program Files]]

AMule files

2012-06-20T11:00:42Z

Reorder: /* Program Files */ Remove links to empty pages

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
*'''~/.aMule/clients.met.BAK:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
*'''~/.aMule/known2.met:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''~/.aMule/known2_64.met:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
*'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
*'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

Other files in ''~/.aMule/'' are most surely backups of some of the above files.

See also: [[:Category:Program Files]]

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

[[Category:Program Files]]

Emfriends.met file

2012-06-20T10:57:17Z

Reorder: /* Notes */

== File ==
'''Name:''' ''emfriends.met''

'''Location:''' ''~/.aMule/''

== Description ==
This file contains a list of [[friend]]s and the necessary data to identify and locate them.

== Format ==
The contents of this file goes as follows:
*First byte is ''0x0E'' to identify the file as a valid ''emfriends.met'' file.
*Next four bytes form a 32 bits unsigned number which tells how many friends the file will list.
*Now for each friend listed:
**Friend's [[hash]] (16 bytes)
**Last known [[IP address|IP]] (32 bits unsigned number)
**Last known [[port]] (16 bits unsigned number)
**Last time the friend was seen (32 bits unsigned number, [[Unix Epoch]] date)
**Last time you chatted with the friend (32 bits unsigned number, [[Unix Epoch]] date)
**Amount of aditional tags about this friend (32 bits unsigned number). aMule only supports [[username]]s as aditional friends tags.
** Now for each tag:
***Type of field (1 byte). In ''emfriends.met'' files, only type ''0x02'' (arrays) are supported.
***Tag type length (16 bits unsigned number). Since only user names are supported, only tag type length ''0x0001'' is supported in this files.
***Tag meaning (8 bits unsigned number). What does the tag stand for. Since ''emfriends.met'' files support one single additional tag, this will always be ''0x01'' (user name).
***Amount of bytes the string needs (16 bytes unsigned number)
*** String (amount of bytes reported by the previous field)

All fields, except the IP and username fields, are stored in [[little endian]]. The IP and username fields are stored in [[big endian]].

If in aMule is compile to support [[Unicode]], it will write the strings twice: First in Unicode, then with no Unicode.

The whole file is then written in packets of 2 bytes in [[little endian]].

== Example ==
Let's see this file:

0E 01 00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 00 50 18 4C 36 EA 00 00 00 00 00 00
00 00 00 02 00 00 00 02 01 00 01 09 00 EF BB BF
64 73 61 64 73 61 02 01 00 01 06 00 64 73 61 64
73 61

What the file shows is:

*''0x0E'' <- File identification.
*''0x02 0x00 0x00 0x00'' <- It is in little endian. So, it is 00000002 = 2. There's one friend listed in this file
**''0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00'' <- No hash has been set.
**''0x50 0x18 0x4C 0x36'' <- IP is ''80.24.76.54''
**''0xEA 0x00'' <- Port ''234''
**''0x00 0x00 0x00 0x00'' <- Last time the friend was seen is unknown
**''0x00 0x00 0x00 0x00'' <- Last time the friend was chatted is unknown
**''0x02 0x00 0x00 0x00'' <- Two tags have to be read
***''0x02'' Tag type
***''0x01 0x00'' <- Tag type length is 1 byte.
***''0x01'' <- Tag is a username
***''0x09 0x00'' <- It is in little endian. So, it is 0009 = 9. The string is 9 bytes long.
***''0xEF 0xBB 0xBF 0x64 0x73 0x61 0x64 0x73 0x61'' <- This is the Unicode string. It stands for ''dsadsa'' as the friend's user name.
***''0x02'' Tag type
***''0x01 0x00'' <- Tag type length is 1 byte.
***''0x01'' <- Tag is a username
***''0x06 0x00'' <- It is in little endian. So, it is 0006 = 6. The string is 9 bytes long.
***''0x64 0x73 0x61 0x64 0x73 0x61'' <- This is the non-Unicode string. It stands for ''dsadsa'' also as the friend's user name.
**''0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00 0x00'' <- No hash has been set.
**''0x55 0x28 0x50 0x36'' <- IP is ''85.40.80.54''
**''0xEA 0x00'' <- Port ''234''
**''0x00 0x00 0x00 0x00'' <- Last time the friend was seen is unknown
**''0x00 0x00 0x00 0x00'' <- Last time the friend was chatted is unknown
**''0x00 0x00 0x00 0x00'' <- No additional tags about this friend.

== Notes ==
*If the last time a friend was seen is set to ''0'' it is because that friend was added manually by the user.
*Since the amount of friends field is a 32 bits unsigned number, the maximum amount of friends that can be stored is 4294967296.
*Since user name length in bytes are stored in 16 bits unsigned numbers, that makes maximum user name length 65536 characters (in the best cases. Some Unicoded usernames will even be less characters since some characters may take more than one byte).

[[Category:Program Files]]

Casrc file

2012-06-20T10:56:29Z

Reorder: /* Notes */ Add Category:Program Files

== File ==

'''Name:''' ''casrc''

'''Location:''' ''~/.aMule/''

== Description ==

This file contains the configuration for the [[CAS]] application which is shipped with [[aMule]].

== Format ==

Each line is considered as a configuration parameter except those '''strictly''' beginning with a ''#'' [[character]].

Parameters are in the form ''<parameter> <value>''

Available parameters are:
*''font'' : Path to the font to use in the generated image
*''font_size'' : Size to use in the image font
*''source image'' : Path to the image to use as source for the generated image (background)
*''template'' : Path to the [http://www.w3.org/MarkUp HTML] [[tmp.html file|template]] to use to generate the HTML page

Any non-comment and non-parameter line will be considered a line placement. Line placements define where text will be placed in the generated image. The first line placement line found will be used to place the first line in the image, and so on with the second line placement found..., third one, fourth one, fith one and sixth one. Only the six first line placements will be read, the rest are ignored. A line placement definition is as follows:

''<identification> <x_position>,<y_position>,<enable>''

Where:
*''identification'' can be any text that will allow you to identify what that line is. CAS will ignore the identification.
*''x_position'' defines the space left, in pixels, from the right most side of the image to the beginning of the text line
*''y_position'' defines the space left, in pixels, from the top most side of the image to the beginning of the text line
*''enable'' defines if that line should be written into the generated image

== Example ==

This is the default configuration

# cas config file
#
# font - full path to a ttf font
# font_size - size the font
# source_image - image where the text will be writen
# *_line - x,y,[1/0] enabled or disabled

font /usr/share/fonts/corefonts/times.ttf
font_size 10.5
source_image /usr/share/pixmaps/stat.png
first_line 23,19,1
second_line 23,36,1
third_line 23,54,1
fourth_line 23,72,1
fifth_line 23,89,1
sixth_line 23,106,1
template /usr/share/pixmaps/tmp.html

*First 5 lines are comments and are ignored.
*Line 6 is not a valid configuration parameter or line placement, so it is ignored too.
*''font'' line defines ''/usr/share/fonts/corefonts/times.ttf'' as the font to use in the lines in the generated image.
*''font_size'' line defines the font size to use in the image to 10.5 pixels in height.
*''source_image'' line defines ''/usr/share/pixmaps/stat.png'' as the source image to use for the generated image (you can think of it as a background image).
*''first_line'' line defines the first text line to start 23 pixels from the right of the image, 19 pixels from the top and to be written (enabled).
*''second_line'', ''third_line'', ''fourth_line'', ''fifth_line'' and ''sixth_line' lines work similar to ''first_line''.
*''template'' line defines the template HTML to use for the generated HTML file.

== Notes ==

*Line placement identificators cannot be any of the parameters: ''font'', ''font_size'', ''source_image'', ''template''.
*Non-recognized lines are ignored.

You might want to see the [[tmp.html file]] article to know how to generate or modify CAS's HTML template.

[[Category:Program Files]]

Known.met file

2012-06-20T10:54:39Z

Reorder: /* Notes */ Add Category:Program Files

== File ==

'''Name:''' ''known.met''

'''Location:'''
* Unix: ''~/.aMule''
* Windows: ''C:\Documents and Settings\username\Application Data\aMule''
* Mac: ''~/Library/Application Support/aMule''

== Description ==

This file stores the hashes and some details (name, size, date, priority, notes) of your shared files. This avoids the need to recalculate their hashes, which can take some time for large (think of Gigabytes) files.

== Format ==

One variable length binary block for each file. The length of a block depends on the number of available tags for the file.

== Example ==

None, because of the file format being binary.

== Notes ==

This file gets updated each time a hashing has taken place. It is also update when aMule is shutting down.

[[Category:Program Files]]

Kademlia

2012-06-17T13:18:27Z

Reorder: Add some references

<center>
'''English''' |
[[Kademlia-de|Deutsch]] |
[[Kademlia-es|Español]]
</center>

[[FAQ_eD2k-Kademlia#What_is_Kademlia?|Kademlia]] is a [[Server|server]]less [[network]] for the *[[Mule]] [[client]]s.

It is based on the Kademlia algorithm by [http://www.scs.cs.nyu.edu/~petar Petar Maymounkov] and [http://www.scs.cs.nyu.edu/~dm David Mazières] ([http://www.nyu.edu New York University], 2002), as described in their paper [http://www.scribd.com/doc/2674753/Kademlia-A-Peertopeer-Information-System-Based-on-the-XOR-Metric|"Kademlia: A Peer-to-peer Information System Based on the XOR Metric"].

The network itself is used as a distributed database of the files and clients on it. The main goal is to provide a reliable, fast, and almost impossible to shutdown way to keep this information. At client to client level, the protocol used for file transfers is shared with the [[ED2k|ed2k]] network at this point, tho this could change in the future.

For information about it you can either read the [[FAQ_eD2k-Kademlia#What_is_Kademlia?|ED2K-Kademlia FAQ]] or see [http://emule-project.net/home/perl/help.cgi?l=1&rm=show_topic&topic_id=232 eMule's support page].

== See Also ==

*<nowiki>http://pdos.csail.mit.edu/~petar/papers/maymounkov-kademlia-lncs.pdf</nowiki>
*<nowiki>http://pdos.csail.mit.edu/~petar/papers/maymounkov-kademlia-talk.ps.gz</nowiki>
*<nowiki>http://www.scs.stanford.edu/~dm/home/papers/maymounkov:kademlia.ps.gz</nowiki>
*http://en.wikipedia.org/wiki/Kademlia

Preferences.dat file

2012-06-17T13:02:59Z

Reorder: /* Description */ Pointing to amule.conf

<center>
'''English''' |
[[Preferences.dat_file-tw|正體中文]]
</center>

== File ==

'''Name:''' ''preferences.dat''

'''Location:''' ''~/.aMule/''

== Description ==

This file used to store [[eMule]]'s configuration in it's earlier versions. Nowadays, it only stores the userhash and the configuration file version.

Most user preferences are now stored in the [[amule.conf file]].

== Data ==

The current configuration file version is 20 (in hex: ''0x14'').

== Format ==

The file format is as follows:

'''Version Userhash'''

Size of each field is as follows:
*''Version'': 1 byte
*''Userhash'': 16 bytes, stored as a big-endian 128-bit value.

== Example ==

The following is a hex dump of an hypothetic ''preferences.dat'' file:

''14 2C 16 62 17 9C 0E CE 02 45 55 A8 5A 56 6C 6F 49''

In the above example, the following data can be seen:

*Configuration file version: ''20'' (In hex: ''0x14'')
*Userhash: ''2C1662179C0ECE024555A85A566C6F49''

[[Category:Program Files]]

AMule files

2012-06-17T12:59:27Z

Reorder: /* Directories */ Adding to Category:Program Files

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
*'''~/.aMule/clients.met.BAK:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
*'''[[known2.met file|~/.aMule/known2.met]]:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''[[known2.met file|~/.aMule/known2_64.met]]:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
*'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
*'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

Other files in ''~/.aMule/'' are most surely backups of some of the above files.

See also: [[:Category:Program Files]]

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

[[Category:Program Files]]

Category:Program Files

2012-06-17T12:58:51Z

Reorder: /* Category:Program Files */

= Category:Program Files =

These are the wiki pages for the files that aMule uses to work.

For a summary of what each does, see: '''[[AMule_files|aMule Files]]'''

Ipfilter static.dat file

2012-06-17T12:54:45Z

Reorder: /* Description */ Noting precedence of ipfilter_static over ipfilter

== File ==
'''Name:''' ''ipfilter_static.dat''

'''Location:''' ''~/.aMule/''

== Description ==
The usefulness of this file (and of [[ipfilter.dat file|ipfilter.dat]]) is described in the [[IPFilter|IP Filter article]].

''Ipfilter_static'' takes precedence over ''ipfilter''. Meaning, in case of a collision between the IP definitions in this file and ''ipfilter'', the definitions in ''ipfilter_static'' will override those in ''ipfilter''.

== Format ==
The format of the ''ipfilter_static.dat'' file is the same as for the ''[[ipfilter.dat file]]''.

== Comments in File ==

# This file is used to store ipfilter-ranges that should
# not be overwritten by aMule. If you wish to keep a custom
# set of ipfilter-ranges that take precedence over ipfilter-
# ranges aquired through the auto-update functionality, then
# place them in this file. aMule will not change this file.

==== Useful addition to comments ====

# Format:
# "IPs range" , "Access level" , "Description"
# Access level values < 127 are blocked
# Access level values > 127 are allowed
#
# Example:
# RangeStart - RangeEnd , NNN , Text
# 000.000.000.000 - 000.255.255.255 , 000 , invalid ip

== See Also ==

*[[IPFilter]]
*[[ipfilter.dat file]]

[[Category:Program Files]]

Ipfilter static.dat file

2012-06-17T12:49:19Z

Reorder: Slowly moving toward completeness.

== File ==
'''Name:''' ''ipfilter_static.dat''

'''Location:''' ''~/.aMule/''

== Description ==
The usefulness of this file (and [[ipfilter.dat file|ipfilter.dat]]) is described in the [[IPFilter|IP Filter article]].

== Format ==
The format of the ''ipfilter_static.dat'' file is the same as for the ''[[ipfilter.dat file]]''.

== Comments in File ==

# This file is used to store ipfilter-ranges that should
# not be overwritten by aMule. If you wish to keep a custom
# set of ipfilter-ranges that take precedence over ipfilter-
# ranges aquired through the auto-update functionality, then
# place them in this file. aMule will not change this file.

==== Useful addition to comments ====

# Format:
# "IPs range" , "Access level" , "Description"
# Access level values < 127 are blocked
# Access level values > 127 are allowed
#
# Example:
# RangeStart - RangeEnd , NNN , Text
# 000.000.000.000 - 000.255.255.255 , 000 , invalid ip

== See Also ==

*[[IPFilter]]
*[[ipfilter.dat file]]

[[Category:Program Files]]

AMule files

2012-06-17T12:36:45Z

Reorder: /* Program Files */ Add link to "ipfilter_static.dat file"

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
*'''~/.aMule/clients.met.BAK:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[ipfilter_static.dat file|~/.aMule/ipfilter_static.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
*'''[[known2.met file|~/.aMule/known2.met]]:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''[[known2.met file|~/.aMule/known2_64.met]]:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
*'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
*'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

Other files in ''~/.aMule/'' are most surely backups of some of the above files.

See also: [[:Category:Program Files]]

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

AMule files

2012-06-17T12:34:01Z

Reorder: /* Program Files */ Trying to get the spam filter to stop blocking updates.

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
*'''~/.aMule/clients.met.BAK:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsa.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''~/.aMule/ipfilter_static.dat:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
*'''[[known2.met file|~/.aMule/known2.met]]:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''[[known2.met file|~/.aMule/known2_64.met]]:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
*'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
*'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

Other files in ''~/.aMule/'' are most surely backups of some of the above files.

See also: [[:Category:Program Files]]

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

Nodes.dat file

2011-01-12T00:05:50Z

Reorder: /* Script for dumping nodes.dat */

<center>
'''English''' | [[Nodes.dat_file-de|Deutsch]]
</center>

== File ==
'''Name:''' ''nodes.dat''

'''Location:''' ''~/.aMule/''

== Description ==
This file stores details about known [[Kademlia]] [[client]]s (also known as Kad [[node]]s).

It is used to [[bootstrap]] the Kad network when aMule starts.

== Format (version 0) ==
This format was used for aMule up to 2.1.3 , and it is no more used

All fields are stored without any separator character. This is done like this because all the fields have a specific size:
*''Number of contacts'': Number of contacts that will be listed (4 bytes)

After specifying the number of contacts that will be listed, the file lists them. Each contact takes 25 bytes, splitted into the following fields:
*''ClientID'': The contact's [[ID|ClientID]] (16 bytes)
*''IP'': The contact's [[IP address|IP]] (4 bytes)
*''UDP Port'': The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
*''TCP Port'': The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
*''Type'': This indicates the [[type]] of the contact, which is how much you can be confident on that contact (a scale from ''0'' to ''4'', being ''0'' the best and ''4'' the worst). (1 byte)

Once this data is put together, it is stored in little-endian.

=== Example of nodes.dat version 0 file ===
The following is a hex dump of a hypothetical ''nodes.dat'' file:

<tt>0200000012257425DBA4EDDBD097150757404486E55E04DE40123612021F64632587A31EC2FC8566C4A9BAB184E6E9B7D44012361202</tt>

In the above example, the following data can be seen:

*Number of contacts: ''2'' (In hex: <tt>02000000</tt>, remember it's [[little endian]])
*Contact #1:
**ClientID: <tt>12257425DBA4EDDBD097150757404486</tt>
**IP: 222.4.94.229 (Hex: <tt>E55E04DE</tt>)
**UDP Port: 1240 (Hex: <tt>4012</tt>)
**TCP Port: 1236 (Hex: <tt>3612</tt>)
**Type: 2 (Hex: <tt>02</tt>)
*Contact #2:
**ClientID: <tt>1F64632587A31EC2FC8566C4A9BAB184</tt>
**IP: 212.183.233.230 (Hex: <tt>E6E9B7D4</tt>)
**UDP Port: 1240 (Hex: <tt>4012</tt>)
**TCP Port: 1236 (Hex: <tt>3612</tt>)
**Type: 2 (Hex: <tt>02</tt>)

== Format (version 2) ==
This format is used in aMule version 2.2.0 and later.

Here again, all fields are stored without any separator character. This is done like this because all the fields have a specific size.

The file begins with 4 bytes storing the null value (hex 0x00000000)
Then follows the fields:

*''Version number'': value 2 stored in little endian (0x02000000 , 4 bytes)
*''Number of contacts'': Number of contacts that will be listed (4 bytes)
After specifying the number of contacts that will be listed, the file lists them.
Each contact takes 34 bytes, splitted into the following fields:
*''ClientID'' (16 bytes): The contact's [[ID|ClientID]]
*''IP'' (4 bytes): The contact's [[IP address|IP]]
*''UDP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact
*''TCP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact
*''Version'' (1 byte): Kademlia protocol version. '0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
*''KadUDPKey'' (8 bytes): In Kad v2, Sender's 32-bit key (node version >5), bound to the receiver (local) IP . It is used in encrypted communication to verify node validity.
*''Verified'': (1 byte) Any value different from 0 states the contact has been verified.

Once this data is put together, it is stored in little-endian.

=== Format v2 Details as a Table ===

{| border="1" cellspacing="5"
|-
! Bytes !! Value
! align="left" | Notes
|-
| colspan="3" | Header information
|-
| 4 || NULL || Hex: <tt>0x00000000</tt>
|-
| 4 || Version || Hex: <tt>0x02000000</tt>
|-
| 4 || Number of contacts || Count of nodes in file
|-
| colspan="4" | Each contact's information
|-
| 16 || ClientID || Contact's [[ID|Client ID]]
|-
| 4 || [[IP address]] || Not enough bytes for IPv6 addresses
|-
| 2 || UDP Port || UDP port to connect to when trying to reach the contact
|-
| 2 || TCP Port || TCP port to connect to when trying to reach the contact
|-
| 1 || Version || Kademlia protocol version: 0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
|-
| 8 || KadUDPKey || Sender's 32-bit key (node version >5), bound to the receiver (local) IP, which is used in encrypted communication to verify node validity (Kad v2)
|-
| 1 || Verified || Any value different from 0 indicates the contact has been verified
|}

* Total bytes for a given contact: <tt>16 + 4 + 2 + 2 + 1 + 8 + 1 = </tt>34 bytes
* All fields are stored as little-endian hexidecimal values.

== Extra ==
Since the ''number of contacts'' field is 4 bytes long, the maximum number of [[node]]s you could store in this file is 4294967296 (~4300M), which should be far enough. Anyway, since this number is so big, [[aMule]], [[eMule]] and all clients have hard limitted the amount of contacts that can be stored ([[aMule]]'s hard limit is ''5000'').

Since ''Type 4'' contacts are those which are marked for deletion, there should never be any ''Type 4'' contact in the ''nodes.dat'' file. If there was, it would just be ignored when reading the file.

== Script for dumping nodes.dat ==
Here's a python script which can be used for dumping contents of the nodes.dat v0 and v2 files:
<pre>
#!/usr/bin/env python
# this code belongs to public domain
# requires nodes.dat filename passed as argument

import struct
import sys

version = 0
count = 0

# check number of command line arguments
if len(sys.argv) != 2:
sys.exit("Please supply a nodes.dat file!")

nodefile = open(sys.argv[1], 'r')

(count,) = struct.unpack("<I", nodefile.read(4))
if (count == 0):
(version,) = struct.unpack("<I", nodefile.read(4))
(count,) = struct.unpack("<I", nodefile.read(4))

if (version >= 0 & version < 3):
print 'Nodes.dat file version = %d' %(version)
print 'Node count = %d' %(count)
print ' '
if (version == 0):
print ' idx type IP address udp tcp'
else :
print ' idx Ver IP address udp tcp kadUDPKey verified'

for i in xrange(count):
if (version == 0):
(clientid, ip1, ip2, ip3, ip4, udpport, tcpport,
type) = struct.unpack("<16s4BHHB", nodefile.read(25))
ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
print '%4d %4d %-15s %5d %5d' % (i, type, ipaddr,
udpport, tcpport)
else :
(clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type, kadUDPkey,
verified) = struct.unpack("<16s4BHHBQB", nodefile.read(34))
ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
if (verified == 0): verf='N'
else : verf='Y'
print '%4d %3d %-15s %5d %5d %16x %s' % (i, type, ipaddr, udpport,
tcpport, kadUDPkey, verf)

else :
print 'Cannot handle nodes.dat version %d !' (version)

nodefile.close()
</pre>

[[Category:Program Files]]

Nodes.dat file

2011-01-12T00:04:50Z

Reorder: /* Script for dumping nodes.dat */ fixed script

Nodes.dat file

2011-01-11T23:36:39Z

Reorder: /* Format (version 2) */

<center>
'''English''' | [[Nodes.dat_file-de|Deutsch]]
</center>

== File ==
'''Name:''' ''nodes.dat''

'''Location:''' ''~/.aMule/''

== Description ==
This file stores details about known [[Kademlia]] [[client]]s (also known as Kad [[node]]s).

It is used to [[bootstrap]] the Kad network when aMule starts.

== Format (version 0) ==
This format was used for aMule up to 2.1.3 , and it is no more used

All fields are stored without any separator character. This is done like this because all the fields have a specific size:
*''Number of contacts'': Number of contacts that will be listed (4 bytes)

After specifying the number of contacts that will be listed, the file lists them. Each contact takes 25 bytes, splitted into the following fields:
*''ClientID'': The contact's [[ID|ClientID]] (16 bytes)
*''IP'': The contact's [[IP address|IP]] (4 bytes)
*''UDP Port'': The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
*''TCP Port'': The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
*''Type'': This indicates the [[type]] of the contact, which is how much you can be confident on that contact (a scale from ''0'' to ''4'', being ''0'' the best and ''4'' the worst). (1 byte)

Once this data is put together, it is stored in little-endian.

=== Example of nodes.dat version 0 file ===
The following is a hex dump of a hypothetical ''nodes.dat'' file:

<tt>0200000012257425DBA4EDDBD097150757404486E55E04DE40123612021F64632587A31EC2FC8566C4A9BAB184E6E9B7D44012361202</tt>

In the above example, the following data can be seen:

*Number of contacts: ''2'' (In hex: <tt>02000000</tt>, remember it's [[little endian]])
*Contact #1:
**ClientID: <tt>12257425DBA4EDDBD097150757404486</tt>
**IP: 222.4.94.229 (Hex: <tt>E55E04DE</tt>)
**UDP Port: 1240 (Hex: <tt>4012</tt>)
**TCP Port: 1236 (Hex: <tt>3612</tt>)
**Type: 2 (Hex: <tt>02</tt>)
*Contact #2:
**ClientID: <tt>1F64632587A31EC2FC8566C4A9BAB184</tt>
**IP: 212.183.233.230 (Hex: <tt>E6E9B7D4</tt>)
**UDP Port: 1240 (Hex: <tt>4012</tt>)
**TCP Port: 1236 (Hex: <tt>3612</tt>)
**Type: 2 (Hex: <tt>02</tt>)

== Format (version 2) ==
This format is used in aMule version 2.2.0 and later.

Here again, all fields are stored without any separator character. This is done like this because all the fields have a specific size.

The file begins with 4 bytes storing the null value (hex 0x00000000)
Then follows the fields:

*''Version number'': value 2 stored in little endian (0x02000000 , 4 bytes)
*''Number of contacts'': Number of contacts that will be listed (4 bytes)
After specifying the number of contacts that will be listed, the file lists them.
Each contact takes 34 bytes, splitted into the following fields:
*''ClientID'' (16 bytes): The contact's [[ID|ClientID]]
*''IP'' (4 bytes): The contact's [[IP address|IP]]
*''UDP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact
*''TCP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact
*''Version'' (1 byte): Kademlia protocol version. '0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
*''KadUDPKey'' (8 bytes): In Kad v2, Sender's 32-bit key (node version >5), bound to the receiver (local) IP . It is used in encrypted communication to verify node validity.
*''Verified'': (1 byte) Any value different from 0 states the contact has been verified.

Once this data is put together, it is stored in little-endian.

=== Format v2 Details as a Table ===

{| border="1" cellspacing="5"
|-
! Bytes !! Value
! align="left" | Notes
|-
| colspan="3" | Header information
|-
| 4 || NULL || Hex: <tt>0x00000000</tt>
|-
| 4 || Version || Hex: <tt>0x02000000</tt>
|-
| 4 || Number of contacts || Count of nodes in file
|-
| colspan="4" | Each contact's information
|-
| 16 || ClientID || Contact's [[ID|Client ID]]
|-
| 4 || [[IP address]] || Not enough bytes for IPv6 addresses
|-
| 2 || UDP Port || UDP port to connect to when trying to reach the contact
|-
| 2 || TCP Port || TCP port to connect to when trying to reach the contact
|-
| 1 || Version || Kademlia protocol version: 0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
|-
| 8 || KadUDPKey || Sender's 32-bit key (node version >5), bound to the receiver (local) IP, which is used in encrypted communication to verify node validity (Kad v2)
|-
| 1 || Verified || Any value different from 0 indicates the contact has been verified
|}

* Total bytes for a given contact: <tt>16 + 4 + 2 + 2 + 1 + 8 + 1 = </tt>34 bytes
* All fields are stored as little-endian hexidecimal values.

== Extra ==
Since the ''number of contacts'' field is 4 bytes long, the maximum number of [[node]]s you could store in this file is 4294967296 (~4300M), which should be far enough. Anyway, since this number is so big, [[aMule]], [[eMule]] and all clients have hard limitted the amount of contacts that can be stored ([[aMule]]'s hard limit is ''5000'').

Since ''Type 4'' contacts are those which are marked for deletion, there should never be any ''Type 4'' contact in the ''nodes.dat'' file. If there was, it would just be ignored when reading the file.

== Script for dumping nodes.dat ==
Here's a python script which can be used for dumping contents of the nodes.dat v0 and v2 files:
<pre>
#!/usr/bin/env python
# this code belongs to public domain

import struct
import sys

version = 0
count = 0

# check number of command line arguments
if len(sys.argv) != 2:
sys.exit("Please supply a nodes.dat file!")

nodefile = open(sys.argv[1], 'r')
(count,) = struct.unpack("<I", nodefile.read(4))
if (count == 0) : (version,) = struct.unpack("<I", nodefile.read(4))
if (version >= 1) : (count,) = struct.unpack("<I", nodefile.read(4))
if (version >= 0 & version < 3) :
print 'Nodes.dat file version = %d' %(version)
print 'Node count = %d' %(count)
print ' '
if (version == 0):
print ' idx type IP address udp tcp'
else :
print ' idx Ver IP address udp tcp kadUDPKey verified'

for i in xrange(count):
if (version == 0):
(clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type) = \
struct.unpack("<16s4BHHB", nodefile.read(25))
ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
print '%4d %4d %-15s %5d %5d' % (i, type, ipaddr, udpport, tcpport)
else :
(clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type, kadUDPkey, verified) = \
struct.unpack("<16s4BHHBQB", nodefile.read(34))
ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
VV = 'Y'
if (verified == 0): VV='N'
print '%4d %3d %-15s %5d %5d %16x %s' % (i, type, ipaddr, udpport, tcpport, kadUDPkey,VV)

else :
print 'Cannot handle nodes.dat version %d !' (version)

nodefile.close()
</pre>

[[Category:Program Files]]

Nodes.dat file

2011-01-11T22:34:34Z

Reorder: /* Example of nodes.dat version 0 file */ Clean up formatting; remove superfluous repetition

<center>
'''English''' | [[Nodes.dat_file-de|Deutsch]]
</center>

== File ==
'''Name:''' ''nodes.dat''

'''Location:''' ''~/.aMule/''

== Description ==
This file stores details about known [[Kademlia]] [[client]]s (also known as Kad [[node]]s).

It is used to [[bootstrap]] the Kad network when aMule starts.

== Format (version 0) ==
This format was used for aMule up to 2.1.3 , and it is no more used

All fields are stored without any separator character. This is done like this because all the fields have a specific size:
*''Number of contacts'': Number of contacts that will be listed (4 bytes)

After specifying the number of contacts that will be listed, the file lists them. Each contact takes 25 bytes, splitted into the following fields:
*''ClientID'': The contact's [[ID|ClientID]] (16 bytes)
*''IP'': The contact's [[IP address|IP]] (4 bytes)
*''UDP Port'': The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
*''TCP Port'': The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact (2 bytes)
*''Type'': This indicates the [[type]] of the contact, which is how much you can be confident on that contact (a scale from ''0'' to ''4'', being ''0'' the best and ''4'' the worst). (1 byte)

Once this data is put together, it is stored in little-endian.

=== Example of nodes.dat version 0 file ===
The following is a hex dump of a hypothetical ''nodes.dat'' file:

<tt>0200000012257425DBA4EDDBD097150757404486E55E04DE40123612021F64632587A31EC2FC8566C4A9BAB184E6E9B7D44012361202</tt>

In the above example, the following data can be seen:

*Number of contacts: ''2'' (In hex: <tt>02000000</tt>, remember it's [[little endian]])
*Contact #1:
**ClientID: <tt>12257425DBA4EDDBD097150757404486</tt>
**IP: 222.4.94.229 (Hex: <tt>E55E04DE</tt>)
**UDP Port: 1240 (Hex: <tt>4012</tt>)
**TCP Port: 1236 (Hex: <tt>3612</tt>)
**Type: 2 (Hex: <tt>02</tt>)
*Contact #2:
**ClientID: <tt>1F64632587A31EC2FC8566C4A9BAB184</tt>
**IP: 212.183.233.230 (Hex: <tt>E6E9B7D4</tt>)
**UDP Port: 1240 (Hex: <tt>4012</tt>)
**TCP Port: 1236 (Hex: <tt>3612</tt>)
**Type: 2 (Hex: <tt>02</tt>)

== Format (version 2) ==
This format is used in aMule version 2.2.0 and later.

Here again, all fields are stored without any separator character. This is done like this because all the fields have a specific size.

The file begins with 4 bytes storing the null value (hex 0x00000000)
Then follows the fields:

*''Version number'': value 2 stored in little endian (0x02000000 , 4 bytes)
*''Number of contacts'': Number of contacts that will be listed (4 bytes)
After specifying the number of contacts that will be listed, the file lists them.
Each contact takes 34 bytes, splitted into the following fields:
*''ClientID'' (16 bytes): The contact's [[ID|ClientID]]
*''IP'' (4 bytes): The contact's [[IP address|IP]]
*''UDP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc768.txt UDP] [[port]] to [[connect]] to when trying to reach the contact
*''TCP Port'' (2 bytes): The [http://www.ietf.org/rfc/rfc793.txt TCP] [[port]] to [[connect]] to when trying to reach the contact
*''Version'' (1 byte): Kademlia protocol version. '0' means a Kad v1 node, any value > 0 means a Kad v2 node and determines what kind of packets can be sent to a node, what features it supports, etc.
*''KadUDPKey'' (8 bytes): In Kad v2, Sender's 32-bit key (node version >5), bound to the receiver (local) IP . It is used in encrypted communication to verify node validity.
*''Verified'': (1 byte) Any value different from 0 states the contact has been verified.

Once this data is put together, it is stored in little-endian.

== Extra ==
Since the ''number of contacts'' field is 4 bytes long, the maximum number of [[node]]s you could store in this file is 4294967296 (~4300M), which should be far enough. Anyway, since this number is so big, [[aMule]], [[eMule]] and all clients have hard limitted the amount of contacts that can be stored ([[aMule]]'s hard limit is ''5000'').

Since ''Type 4'' contacts are those which are marked for deletion, there should never be any ''Type 4'' contact in the ''nodes.dat'' file. If there was, it would just be ignored when reading the file.

== Script for dumping nodes.dat ==
Here's a python script which can be used for dumping contents of the nodes.dat v0 and v2 files:
<pre>
#!/usr/bin/env python
# this code belongs to public domain

import struct
import sys

version = 0
count = 0

# check number of command line arguments
if len(sys.argv) != 2:
sys.exit("Please supply a nodes.dat file!")

nodefile = open(sys.argv[1], 'r')
(count,) = struct.unpack("<I", nodefile.read(4))
if (count == 0) : (version,) = struct.unpack("<I", nodefile.read(4))
if (version >= 1) : (count,) = struct.unpack("<I", nodefile.read(4))
if (version >= 0 & version < 3) :
print 'Nodes.dat file version = %d' %(version)
print 'Node count = %d' %(count)
print ' '
if (version == 0):
print ' idx type IP address udp tcp'
else :
print ' idx Ver IP address udp tcp kadUDPKey verified'

for i in xrange(count):
if (version == 0):
(clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type) = \
struct.unpack("<16s4BHHB", nodefile.read(25))
ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
print '%4d %4d %-15s %5d %5d' % (i, type, ipaddr, udpport, tcpport)
else :
(clientid, ip1, ip2, ip3, ip4, udpport, tcpport, type, kadUDPkey, verified) = \
struct.unpack("<16s4BHHBQB", nodefile.read(34))
ipaddr = '%d.%d.%d.%d' % (ip1, ip2, ip3, ip4)
VV = 'Y'
if (verified == 0): VV='N'
print '%4d %3d %-15s %5d %5d %16x %s' % (i, type, ipaddr, udpport, tcpport, kadUDPkey,VV)

else :
print 'Cannot handle nodes.dat version %d !' (version)

nodefile.close()
</pre>

[[Category:Program Files]]

User:Reorder

2011-01-11T19:44:40Z

Reorder: /* User Links */

== About ==

* Can't code.

* Can't speak anything other than English.

* Enjoys compliments.

* Appreciates (polite) criticism.

* Is trying to be helpful.

== User Links ==

* [http://forum.amule.org/ aMule Forums]

User:Reorder

2011-01-11T19:44:08Z

Reorder:

== About ==

* Can't code.

* Can't speak anything other than English.

* Enjoys compliments.

* Appreciates (polite) criticism.

* Is trying to be helpful.

== User Links ==

* [http://wiki.amule.org/index.php/Forum aMule Forums]

User:Reorder

2011-01-11T19:43:42Z

Reorder:

== About ==

* Can't code.

* Can't speak anything other than English.

* Enjoys compliments.

* Appreciates (polite) criticism.

* Is trying to be helpful.

== User Links ==

* [[http://wiki.amule.org/index.php/Forum|aMule Forums]]

Category:Program Files

2011-01-11T19:34:35Z

Reorder: /* Category:Program Files */ Add link to [AMule_files]

= Category:Program Files =

These are the wiki pages for the files that aMule uses to work.

For a summary of what each does, see: [[AMule_files|aMule Files]]

Wiki reorganization

2011-01-11T18:48:12Z

Reorder: /* List of outdated pages */ "AMule_Project_FAQ:About"

= Wiki reorganization =

== Why? ==

Unfortunately many pages in our wiki are outdated - they contain old information, tutorials don't work anymore in aMule 2.2.1 or recent SVN snapshots and some information are even incorrect now. To improve the quality of our documentation, old pages need to be reworked and outdated information replaced by improved and updated texts. aMule 2.1.3 is outdated, references to it (or even older versions) should be replaced by references to [[aMule SVN]].

== How can I help? ==

The easiest way is to read the wiki and add any outdated pages you find to the list below. Add a short note on what needs an update, please.
If you feel comfortable doing more, have a look at the list of pages below and see which ones you could rework. Once the complaint is resolved, you can add a remark that you updated the page.

= main page organization =

Provide a more user centric approach and put advanced topics in the back. Only these information for the end user should be translated.

Information geared at advanced users and developers don't have to be translated, as our dev language is English anyway.

= Pages in need of an update =

== List of outdated pages ==
* [[Getting_Started]] - Update screenshots, rework outdated passages, add information about fake server
* [[Ed2k_links_handling]] - Remove discontinued browser, update screenshots, check information for correctness
* [[Usage_Preferences]] - update preferences description to current version
* <s>[[aMule CVS]] - [[Special:Whatlinkshere/AMule_CVS|Pages still linking to it]] probably need a touch-up anyway and references should be changed to [[aMule SVN]].</s>
* [[Nodes.dat_file]] - update to current format
* [[Releases]]
* [[AMule_Project_FAQ:About]] -- This page has been deleted as obsolete, yet the footer of the wiki links to it. Presumably, either this page should contain something or redirect somewhere, OR the wiki footer should be changed to link somewhere else

== outdated / incorrect translations ==

= Style change =

== No Version sections ==

If you encounter any Version sections (created by, updated by), please delete them. These information are available to everyone using the history function. This doesn't mean that the work of all contributors is less recognized, but the layout is cleaner this way.

== Language Links ==
The links to the translated articles should be written in the language of the target page, so any site can be visited by any user. A french user can find the french version of the page, even when he enters the wiki on a korean article. The links should be ordered aphabetical depending on their language-appendix.

* No appendix: English
* -cn: Simplified Chinese (简体中文)
* -da: Dansk
* -de: Deutsch
* -es: Español (write Espa&ntilde;ol)
* -fi: Suomi
* -fr: Français (write Fran&ccedil;ais)
* -hu: Magyar
* -it: Italiano
* -ko_KR: 한국말
* -nl: Nederlands
* -pl: Polski
* -pt_BR: Português (write Portugu&ecirc;s)
* -ru: Русский (write &#1056;&#1091;&#1089;&#1089;&#1082;&#1080;&#1081;)
* -tw: Traditional Chinese (正體中文)

To be continued.

The Links to the translation on the main-pages should dissappaer. A user can change to the main-page of his language. The articles should link to just the version in their lang. If it's not aviable in the corresponding lang, it should be linked to the english version, and marked with (en) after the name.

User:Reorder

2011-01-11T18:37:54Z

Reorder:

* Can't code.

* Can't speak anything other than English.

* Enjoys compliments.

* Appreciates (polite) criticism.

* Is trying to be helpful.

User:Reorder

2011-01-11T18:35:29Z

Reorder: Created page with 'Just some damn user.'

Just some damn user.

AMule files

2011-01-11T18:16:12Z

Reorder: Added sections. Added link to :Category:Program Files. Minor edits to text ("on --> in" and the like).

<center>
'''English''' |
[[AMule_files-de|Deutsch]] |
[[AMule_files-hu|Magyar]] |
[[AMule_files-nl|Nederlands]]
</center>

Most of [[aMule]]'s config files and data are the same as or are compatible with [[eMule|eMule]]'s.

Have in mind that you might not have all of them on your hard disk, since they are generated when needed.

== Program Files ==

Here is a list and the usage of each of them (On Mac OS X the "~/.aMule" folder corresponds to "~/Library/Application Support/aMule"):
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''[[addresses.dat_file|~/.aMule/addresses.dat]]:''' Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
*'''[[amule.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule]]'s [[signature|OnLineSignature]] file, which is the same as [[eMule|eMule]]'s [[signature|signature]] (see [[onlinesig.dat_file|''onlinesig.dat'']] below) but with extended information.
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''~/.aMule/aMule-online-sign.png:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch and ''~/.aMule/casrc'' was successfully configured. It is an image containing details on [[aMule]]'s status.*'''~/.aMule/aMule-online-sign.html:''' This file will only exist if [[CAS]] has been asked sometime to generate an [http://www.w3.org/MarkUp HTML] stats page. This [http://www.w3.org/MarkUp HTML] page contains details on [[aMule]]'s status.
*'''[[casrc_file|~/.aMule/casrc]]:''' This file will only exist if [[CAS]] has been run sometime with the ''-o'' switch. It contains the settings for the [[CAS]] image creation.
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
*'''~/.aMule/clients.met.BAK:''' Backup of [[clients.met file]].
*'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www.rsasecurity.com/rsalabs/node.asp?id=2125 RSA] key of your [[client]].
*'''[[emfriends.met file|~/.aMule/emfriends.met]]:''' Contains your friends list configuration.
*'''[[ED2KLinks_file|~/.aMule/ED2KLinks]]:''' This file acts as an external interface to add downloads to [[aMule]].
*'''[[ipfilter.dat file|~/.aMule/ipfilter.dat]]:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]].
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''~/.aMule/ipfilter_static.dat:''' This file contains the [[IP address|IP]] ranges and access levels restrictions which will be passed to [[IPFilter]]. The difference between this file and [[ipfilter.dat file]] is that this one contains static [[IP address|IP]] ranges which will override those in ''ipfilter.dat'' in case of collision, and that this file will never be modified by [[aMule]], while ''ipfilter.dat'' may be auto-updated.
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[known.met file|~/.aMule/known.met]]:''' This file stores the hashes and some details of your shared files like size, path, statics, etc.
*'''[[known2.met file|~/.aMule/known2.met]]:''' This file stored in older aMule versions the verified [[AICH]] hashes of your shared files.
*'''[[known2.met file|~/.aMule/known2_64.met]]:''' This file stores the verified [[AICH]] hashes of your shared files (supporting large files).
*'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available.
*'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[aMule]] to know if you changed your version or if it's the first time you run it.
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule]] communications. It is no longer used since 2.1.0
*'''[[muleLock_file|~/.aMule/muleLock]]:''' This file contains currently running's user's aMule PID. It prevents uers from running two aMules simoultaneously. It replaces the old ''muleconn'' socket file.
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[onlinesig.dat_file|~/.aMule/onlinesig.dat]]:''' This is an [[eMule|eMule]] compatible [[signature|OnLineSignature]] file. It's used by other applications to know basic information on [[aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_eD2k-Kademlia|ed2k]] network, also known as user hash.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP address|IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
*'''[[remote.conf_file|~/.aMule/remote.conf]]:''' Configuration file for [[External Connections]].
*'''[[server.met file|~/.aMule/server.met]]:''' This is a list of all known servers and your preferences about them (priority, name, [[IP address|IP]], port and such).
*'''~/.aMule/server.met.download:''' This is where [[server.met file]]s are temporary downloaded, before being renamed to ''server.met'' (if the download succeeds).
*'''~/.aMule/server.met.new:''' Temporal file while it is being written into disk. As soon as [[aMule]] is finished writting it, it is renamed to [[server.met file|server.met]].
*'''~/.aMule/server_auto.met:''' Here is where [[server.met file]]s are downloaded before merging them with [[aMule]]'s [[server.met file]].
*'''~/.aMule/server_met.old:''' Backup of [[server.met file]].
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:''' This file stores information your client provides to the [[Kademlia]] network.
*'''[[staticservers.dat_file|~/.aMule/staticservers.dat]]:''' Stores a list of [[static server]]s.
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
*'''~/my_ed2k_link.txt:''' Default location where [[aLinkCreator]] stores computed [[ed2k link]]s.
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''[[tmp.html_file|/usr/share/pixmaps/tmp.html]]:''' Default location where [[CAS]] will look for a template [http://www.w3c.com/MarkUp HTML] page to generate the stats [http://www.w3c.com/MarkUp HTML] page.

Other files in ''~/.aMule/'' are most surely backups of some of the above files.

See also: [[:Category:Program Files]]

== Temporary Files ==

In the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other in Preferences), [[aMule]] will create, for each download in queue, the following files:

*'''[[part file|*.part]]:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule]] is able to download from more than one user at the same time, this file has the size of the complete file. The missing parts are filled with zeros.
*'''[[part.met file|*.part.met]]:''' This file contains information on the downloaded parts of the download, the verified chunks, the hash values of the remaining chunks, etc.
*'''*.part.met.bak:''' This are backups of the ''[[part.met file|*.part.met]]'' files. Every now and then aMule creates this backups since without the ''*.part.met'' file, a download has no meaning for aMule. If any ''*.part.met'' file "disappeared, you should rename the ''*.part.met.bak'' to ''*.part.met''.
*'''*.part.met.backup:''' This are temporal ''[[part.met file|*.part.met]]'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
*'''[[part.met.seeds file|*.part.met.seeds]]:''' This file only exists if you have enabled to store the [[IP address|IP]]s of sources of rare files in the preferences, so that [[aMule]] can try to connect to these sources again after a restart.

== Directories ==

The directories in ''~/.aMule/'' have the following use:

*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' The directory where [[aMule]] stored the completed downloads on [http://www.microsoft.com/windows Windows] in old versions (previous to [[aMule]] 2.1.0).
*'''~/Documents/aMule Downloads:''' By default, the directory where [[aMule]] stores the completed downloads on [[MacOS X]] and [http://www.microsoft.com/windows Windows] (since [[aMule]] 2.0.0).
*'''''<app_dir>''/Incoming:''' In [[MacOS X]] and [http://www.microsoft.com/windows Windows], if [[aMule]] cannot determine the user's ''Documents'' folder, it will store the downloaded files here.

Addresses.dat file

2011-01-11T17:54:48Z

Reorder: Category:Program Files

<center>
'''English''' |
[[Addresses.dat_file-de|Deutsch]]
</center>

== File ==

'''Name:''' ''addresses.dat''

'''Location:''' ''~/.aMule/''

== Description ==

This file contains a list of URLs from where [[aMule]] will download [[server.met file]]s to merge with it's current [[server.met file]].

== Format ==

A list of URLs, each of them separated from the others by a new-line character.

In other words, one URL per line.

== Example ==

http://some.whe.re/server.met
http://another.file/my_preferred.met
ftp://localhost/fastservers.met

[[Category:Program Files]]

Clients.met file

2011-01-11T17:54:26Z

Reorder: Category:Program Files

== File ==
'''Name:''' ''clients.met''

'''Location:''' ''~/.aMule/''

== Description ==
This file stores the [[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|credits]] which our [[client]] owes other [[client]]s.

== Format ==
=== Previous notes ===
First of all, have in mind that if there is absolutely anything in this file which doesn't strictly follow it's format rules, the whole file is discarted automatically. So be very carefully when messing around with it.

Also, if the file's version doesn't exactly suit the [[client]]'s supported version (the [[client]] should only support one single version), the whole file will also be discarted.

All numbers in this file are stored in [[little endian]].

=== Into the format ===
The format goes as follows:

*An 8-bits number which specifies the ''cleints.met'' version we're using. [[aMule]] currently supports version ''18'' (''12'' in hexadecimal).
*A 32-bits number specifying the amount of [[client]]s listed in the file.

Each [[client]] requires exactly 119 bytes which are organized in the following way:

*The user's [[FAQ_eD2k-Kademlia#What_is_a_hash?|hash]], which will be exactly 16 bytes long.
*The 4 lower bytes of the 8 bytes number which contains the total amount of bytes uploaded to that [[client]] (in [[little endian]]).
*The 4 lower bytes of the 8 bytes number which contains the total amount of bytes downloaded from that [[client]] (in [[little endian]]).
*The [[Unix Epoch]] (seconds since '00:00:00 1970-01-01 UTC') date (stored in [[little endian]]) when the [[client]] was last identified (requires 4 bytes).
*The 4 higher bytes of the 8 bytes number which contains the total amount of bytes uploaded to that [[client]] (in [[little endian]]).
*The 4 higher bytes of the 8 bytes number which contains the total amount of bytes downloaded from that [[client]] (in [[little endian]]).
*Two bytes which are set to anything, since they are reserved for future use in future specifications of the file.
*A 1-byte number which specifies the size of the [[client]]'s [[Secure User Identification|SecureIdent]] public [[hash]]
*Now the [[Secure User Identification|SecureIdent]] [[hash]] is placed. It must occupy 80 characters, so if it requires less than 80 characters, the rest must be filled with random data.

== Example ==
Here follows a valid ''clients.met'' file and, right after each field, an explanation of it's contents. Please note that the file's contents are shown in hexadecimal values and all bytes have been separated from each other to make more readable:

12 <- Version 0x12
02 00 00 00 <- 2 [[client]]s will be listed. This number is in [[little endian]]
00 00 00 00 00 0F 00 00 00 00 00 00 00 00 6F 00 <- The [[client]]'s [[hash]]
00 00 00 00 <- The 4 lower weight bytes of the total amount of bytes we have uploaded to that [[client]] (in [[little endian]]).
12 F2 01 00 <- The 4 lower weight bytes of the total amount of bytes we have downloaded from that [[client]] (in [[little endian]]).
BF 29 12 42 <- The [[Unix Epoch]] date stored in [[little endian]]. The decimal value of the hexadecimal value 0x421229BF is 1108486591, which is this date: Tue, 15 Feb 2005 17:56:31 +0100
00 00 00 00 <- The 4 higher weight bytes of the total amount of bytes we have uploaded to that [[client]] (in [[little endian]]).
01 00 00 00 <- The 4 higher weight bytes of the total amount of bytes we have downloaded from that [[client]] (in [[little endian]]).
4E 65 <- Just tandom data. This two bytes are reserved.
38 <- This [[client]]'s [[Secure User Identification|SecureIdent]] public [[hash]] is 56 (0x38) bytes long.
F4 69 E7 27 34 D7 6A 2F 74 E7 C2 CE E5 89
43 65 BB 26 73 24 83 DC 3A 2E 84 24 7A E3
89 73 E7 8F 78 C7 86 9D 69 E7 8A 90 8B 89
07 B7 8C 87 E8 79 D4 F8 76 A9 E7 C7 D8 9A <- The [[client]]'s publich [[hash]]
00 00 00 00 00 00 00 00 00 00 00 00 00 00
00 00 00 00 0A 00 00 10 11 64 F4 00 00 00
FA EE E4 00 00 00 <- Just random data to fill the 80-56=34 left bytes for this [[client]].
00 00 00 00 00 0F 00 00 00 00 00 00 00 00 6F 00 <- The other [[client]]'s [[hash]]
... <- Here would follow the other [[client]]'s data...

The total downloaded and total uploaded bytes amount is calculated this way:
*Total Uploaded = Total_Uploaded_High_Bytes x 2^32 + Total_Uploaded_Low_Bytes
*Total Downloaded = Total_Downloaded_High_Bytes x 2^32 + Total_Downloaded_Low_Bytes

In the above example, the total uploaded and downlaoded amount would be (remember, the numbers are stored in [[little endian]], so you have to inverse their order):
*Total Uploaded = 0x00000000 x 2^32 + 0x00000000 = 0 Bytes
*Total Downloaded = 0x00000001 x 2^32 + 0x0001F212 = 4294967296 + 127506 = 4295094802 Bytes = ~4 GigaBytes

== Notes ==
If the backup file (''clients.met.BAK'') is larger than the current ''clients.met'' file, the backup file will not be overriden.

[[FAQ_eD2k-Kademlia#What_is_all_that_credits,_rate_and_score_stuff_about?|Credits]] expire when 12960000 seconds (150 days) have passed without seeing that [[client]].

Almost 4,300 million [[client]]s can be stored in this file (enough, isn't it?)

Each [[client]] is 952 bits (119 bytes) worth ;-)

The maximum size allowed for this file is around 475 GigaBytes (which is way larger the size most filesystems allow for a single file).

== Version ==
Created by "Unknown User" on 09.03.05 at 23:16 
Updated by Vollstrecker on 23.01.08 at 18:48

[[Category:Program Files]]

Cryptkey.dat file

2011-01-11T17:53:56Z

Reorder: Category:Program Files

<center>
'''English''' |
[[Cryptkey.dat_file-tw|正體中文]]
</center>

== File ==

'''Name:''' ''cryptkey.dat''

'''Location:''' ''~/.aMule/''

== Description ==

This file contains your [[client]]'s private 384-bit [http://www.rsasecurity.com/rsalabs/node.asp?id=2125 RSA] key.

== Format ==

Your 384-bit [http://www.rsasecurity.com/rsalabs/node.asp?id=2125 RSA] private key splitted into 5 lines with 72 characters each.

The last line must end with a new-line character.

== Example ==

M22BCQIBADANBgkqhkiG9w0BAQEFAASB9DCB8QIBAAIxALuwVap2WUdpELRZr2VhbqoHE+P5
aiGwS1Euc8d/8kxiUK0hkYMV4YcLdeAWHQpQywIBEQIwIR8eLSPxozComEwP5LbXSy5s6/7W
fmpnV4yti/lG9SsmShKwoK1ySii9YAPnMXUhAhkA2+W8tYcsF5lm+a+Sm8H6Kkh0zW1xr9Lz
AhkA2oDfo3Q0HNRmD7LArieBObwlR+fil5JCAhkAjklb/P0ch72c++oTkfX8OXotdd1nrgD3
AhhzraOSxQyHu72P1xq2jX1wv9eAa7QyH3kCGQC7jgzTqW+wGGP/Bll2YXu8bRYphVTVZgo=

[[Category:Program Files]]

Staticservers.dat file

2011-01-11T17:53:36Z

Reorder: Category:Program Files

== File ==

'''Name:''' ''staticservers.dat''

'''Location:''' ''~/.aMule/''

== Description ==

The [[server]]s listed in this file are considered [[static server]]s.

== Format ==

Each line in this file contains the data about a [[server]].

All [[server]]s listed in this file are automatically considered [[static server]]s.

Any line which's first character is a slash (''/'') or a number-char (''#'') is ignored, so comments c an be placed this way.

The [[server]]s description format is as follows: '''Host''':'''Port''','''Priority''','''Name'''

Each non-comment line must contain exactly 3 fields, where each field is sepparated from the others with a comma ('',''). Any line not containing exactly three fields is ignored.

If the '''Name''' field is empty, it will be filled with the contents of the '''Host:Port''' field.

The '''Priority''' field must be filled with either ''0'' (for normal priority), ''1'' (for high priority) or ''2'' (for low priority). If any other value is read, '''Priority''' will be set to it's defautl value, which is ''normal''.

== Example ==

/ This is my localhost server
127.0.0.1:4662,1,LocalHost
# Next, is my LAN server
192.168.0.300:4661,0,LAN server
# Finally, my...., hm, another server. Let's call it server number #, hehe
# I really dislike this server
20.19.18.17:9666,2,Ugly server number # ;-)

== Notes ==

If a [[server]] listed in this file is already listed in [[server.met file]], the [[server]] data in the [[server.met file]] will be overriden with this file's data.

[[Category:Program Files]]

Part.met.seeds file

2011-01-11T17:53:10Z

Reorder: Category:Program Files

== File ==
'''Name:''' ''*.part.met.seeds''

'''Location:''' ''~/.aMule/Temp/''

== Description ==
This [[file]] contains up to 10 [[source]]s for a file in [[aMule]]'s [[download]] [[queue]]. This are known as [[seed]].

== Format ==
The format of this files is as follows:
*''Number of sources'' <- Amount of sources that will be listed (8 [[Byte|bit]]s unsigned integer)
*For each source it has:
**''Source's ID'' <- The source's [[ID]] (4 [[byte]]s unsigned integer in [[little endian]])
**''Source's port'' <- The source's [[port]] (2 [[byte]]s unsigned integer in little endian)
*Time the file was written (32 bits unsigned number, [[Unix Epoch]] date)

The whole file is then written in packets of 2 bytes in [[little endian]].

== Example ==
This is the contents of a valid seeds file (after [[endian]]ess conversion to [[big endian]]:

05 41 65 1C 50 2A 2D 6E F3 2D 53 36 12 2F F1 CA
51 36 12 BF EA 7E C8 36 12 C1 31 3C D5 D5 30

Which can be read as:

:''05'' <- 5 sources will be listed
:''41 65 1C 50'' <- First sources' ID, which, after performing endiannes conversion, becomes ''50 1C 65 41'' in hex and ''1344038209'' in decimal. This corresponds to IP ''80.28.101.65''
:''2A 2D'' <- First sources port to communicate is port ''15658'' (since in big endian hex it would be ''2D 2A'')
:''6E F3 2D 53'' <- Second source's IP: ''83.45.243.110''
:''36 12'' <- Second source's port: ''4662''
:''2F F1 CA 51'' <- Third source's IP: ''81.202.241.47''
:''36 12'' <- Third source's port: ''4662''
:''BF EA 7E C8'' <- Fourth source's IP: ''200.126.234.191''
:''36 12'' <- Fourth source's port: ''4662''
:''C1 31 3C D5'' <- Fifth source's IP: ''213.60.49.193''
:''D5 30'' <- Fifth source's port: ''12501''

Notice this example does not have the last field ("Time the file was written"). This is beacuse it is an v1 format file. See the [[Part.met.seeds_file#Notes|notes]] below to know more about this.

== Notes ==
*Since from a [[Low ID|LowID]] you cannot tell it's [[IP address|IP]], LowID [[client]]s should never make it into seeds files since it would be impossible to locate them later. So, seeds files only contain [[High ID]] sources.
*aMule limits the amount of sources that can be listed to 10, but the file format could accept up to 255 sources (since the number of sources is told through an 8 bits unsigned integer).
*Read sources are ignored if the file was stored more than two hours ago. The time the file was written field was introduced in file's v2 format. v1 format did not store the time it was stored, so when reading an v1 file it will just read all sources and ignore none.

[[Category:Program Files]]

Amulesig.dat file

2011-01-11T17:52:46Z

Reorder: Category:Program Files

== File ==
'''Name:''' ''amulesig.dat''

'''Location:''' ''~/.aMule/''

== Description ==
This file is generated by [[aMule]] to inform external applications about its status.

[[aMule]]'s [[signature]] file is much more powerful than [[onlinesig.dat_file|eMule]]'s; all the fields are stored in it one per line. Amongst its extended features (compared to [[eMule]]'s [[signature]]) are:
*ED2K connecting status report
*Kademlia status report
*nickname
*session and total downloaded and uploaded bytes
*aMule version
*aMule uptime
*number of shared files

Of course, it includes all of [[eMule]]'s [[signature]] [[onlinesig.dat_file|file]] data too:
*whether it is online or not
*which server it's connected to
*upload and download rate
*clients in queue

== Format ==
Its structure is:
*The first line will contain a ''0'' (zero) if [[aMule]] is disconnected from the ED2K network, a ''2'' if it's connecting (only since [[aMule]] 2.0.0-rc4), or a ''1'' (number 1) if it's online.
*The second, third and forth line contain the name, [[IP address|IP]] and port of the server [[aMule]] is connected to (in this order) or a zero (''0'') if it's offline. Since [[aMule]] 2.0.0-rc4 it will also contain a ''0'' when [[aMule]]'s status is connecting or cleanly closed.
*The fifth line will contain an capital ''H'' or a capital ''L'' depending if [[aMule]] is connected with a high or low ID. If [[aMule]] is disconnected, this field will contain a ''0''. Again, since [[aMule]] 2.0.0-rc4 it will also contain a ''0'' when [[aMule]]'s status is connecting or cleanly closed.
*The sixth line will a contain a ''0'' if aMule is not connected to the Kademlia network, a ''1'' if it is connected to the Kademlia network with a firewalled status or a ''2'' if it is successfully connected to the Kademlia network. This field was introduced with aMule 2.1.0.
*The seventh and eighth lines contain the speed in which [[aMule]] is downloading and uploading respectively. Since [[aMule]] 2.0.0-rc4 both lines contain ''0.0'' when [[aMule]] is cleanly closed. Exactly one decimal is shown (neither mor nor less).
*The ninth and tenth lines contain the number of clients on the upload queue and the number of shared files, is cleanly closed.
*The eleventh line contains the nickname of the user.
*Lines 12 and 13 contain the total amount of bytes downloaded and uploaded respectively.
*Line 14 contains the [[aMule]] version.
*Lines 15 and 16 contain the amount of bytes downloaded and uploaded in the current session respectively. Since [[aMule]] 2.0.0-rc4, both will be ''0'' if [[aMule]] is connecting or was cleanly closed.
*The 17th (and last) line contains the amount of time [[aMule]] has been running. Since [[aMule]] 2.0.0-rc6 this time is expressed in seconds. [[aMule]] version before 2.0.0-rc6 expressed the time in the most suitable integer followed by a space and ''secs'', ''mins'' or ''hours'' depending on the value (or the same time abbreviations in your configured language). Also, since [[aMule]] 2.0.0-rc6, if [[aMule]] is connecting or was cleanly closed this field will contain a ''0'' (in [[aMule]] versions 2.0.0-rc4 and 2.0.0-rc5, when [[aMule]] had been cleanly closed, this line would contain ''00'' followed by the abbreviation ''secs'' (or that same abbreviation in your configured language).

The last line must be followed by a new line character ('\n').

== Example ==
The following is the contents of a valid ''amulesig.dat'' file:

1
eD2k Server
23.48.235.15
4661
H
2
157.2
21.5
521
34
Happy aMule user
23496736693
3296032695
CVS
143534593
23387432
3865

[[Category:Program Files]]

Onlinesig.dat file

2011-01-11T17:52:20Z

Reorder: Category:Program Files

== File ==
'''Name:''' ''onlinesig.dat''

'''Location:''' ''~/.aMule/''

== Description ==
This file is generated by [[eMule]] to inform external applications about it's status. [[aMule]] is able to generate this file too in order to have compatibility with [[eMule]] utilities, but the native [[aMule]] [[signature]] file is [[amulesig.dat_file|amulesig.dat]] (which is much more powerfull than [[eMule]]'s ''onlinesig.dat'').

[[eMule]]'s [[signature]] file reports the following basic status information:
*whether it is online or not
*which server it's connected to
*upload and download rate
*clients in queue

== Format ==
It is composed of two lines separated by a line feed character (with no carriage return character):
*The first one, when [[aMule]] is offline, will contain a ''0'' (zero) and nothing else, but when [[aMule]] is online, it'll contain a ''1'' (number one) followed by ''|'' (the pipe character) then the name of there server it's currently connected to followed by the pipe character (''|''), then the [[IP address|IP]] of the server it's currently connected to followed by the pipe character (''|'') and finally the port it is connected to on that server.
*The second line contains, in this order, the downloading and uploading speeds (exactly one decimal is shown, neither mor nor less) and the number of users on queue, with a pipe character (''|'') between each of this fields.

The second line does '''not''' end in a newline character ('\n').

When [[aMule]] (or [[eMule]]) is cleanly closed, the second line contains the same structure but filled with zeros, while the first line will '''only''' contain a single zero (''0'').

It is very important to notice that the newlines are [http://www.unix.org UNIX] newlines (in hex, ''0xA''), never [http://www.freedos.org DOS] newlines (even if you are using a [http://www.freedos.org DOS] or [http://www.microsofot.com/windows Windows] OS.

== Examples ==
The following is the contents of a valid ''onlinesig.dat'' file when [[aMule]] is online:

''1|eD2k Server|20.34.253.32|4661'' (here goes a [http://www.unix.org UNIX] newline character ''0xA'') 
''20.3|12.9|134''

The following is the contents of a valid ''onlinesig.dat'' file when [[aMule]] is offline (or closed but last status while open was online):

''0'' (here goes a [http://www.unix.org UNIX] newline character ''0xA'') 
''0.0|0.0|0''

[[Category:Program Files]]

Lastversion file

2011-01-11T17:51:59Z

Reorder: Category:Program Files

== File ==

'''Name:''' ''lastversion''

'''Location:''' ''~/.aMule/''

== Description ==

This file contains a list of the latest [[aMule]] versions that have been launched.

== Format ==

'''LastVersionLaunched''' 
'''aMuleVersionLaunchedBeforeTheLastVersionLaunched''' 
'''aMuleVersionLaunchedBeforeTheVersionLaunchedBeforeTheLastVersionLaunched'''

Simple enough, just listing one version after the other in different lines. Some things to have in mind anyway:
*The last version listed must also be followed with a newline character (''/'').
*One version should never appear twice.
*There is no need for the versions to be listed in order. Right the opposite, they are inteded to be listed in the order that they were launched, beggining with the latest launched version (first line) and ending with the oldest launched version recorded (last line).
*Only the last 10 versions launched are stored. When 10 versions are already listed and another version is launched, the last line stored is deleted and the new version is added to the top of the file.

== Example ==

The following is the contents of a valid ''lastversion'' file:

''CVS'' 
''1.2.5'' 
''1.2.6'' 
''2.0.0'' 
''1.1.0'' 
''1.2.0'' 
''1.2.2'' 
''1.0.1'' 
''1.2.1'' 
''1.1.1''

[[Category:Program Files]]

Shareddir.dat file

2011-01-11T17:50:56Z

Reorder: Category:Program Files

<center>
'''English''' |
[[Shareddir.dat_file-tw|正體中文]]
</center>

== File ==

'''Name:''' ''shareddir.dat''

'''Location:''' ''~/.aMule/''

== Description ==

This file contains a list of directories which's contents [[aMule]] should share (it's contents aren't shared recursively).

== Example ==

The following is the contents of a valid ''shareddir.dat'' file:

''/home/guest/'' 
''/temp/'' 
''/mnt/share/'' 
''/mnt/ed2k/'' 
''/var/download/''

[[Category:Program Files]]

Preferences.dat file

2011-01-11T17:50:28Z

Reorder: Category:Program Files

<center>
'''English''' |
[[Preferences.dat_file-tw|正體中文]]
</center>

== File ==

'''Name:''' ''preferences.dat''

'''Location:''' ''~/.aMule/''

== Description ==

This file used to store [[eMule]]'s configuration in it's earlier versions. Nowadays, it only stores the userhash and the configuration file version.

== Data ==

The current configuration file version is 20 (in hex: ''0x14'').

== Format ==

The file format is as follows:

'''Version Userhash'''

Size of each field is as follows:
*''Version'': 1 byte
*''Userhash'': 16 bytes, stored as a big-endian 128-bit value.

== Example ==

The following is a hex dump of an hypothetic ''preferences.dat'' file:

''14 2C 16 62 17 9C 0E CE 02 45 55 A8 5A 56 6C 6F 49''

In the above example, the following data can be seen:

*Configuration file version: ''20'' (In hex: ''0x14'')
*Userhash: ''2C1662179C0ECE024555A85A566C6F49''

[[Category:Program Files]]

Server.met file

2011-01-11T17:50:01Z

Reorder: Category:Program Files

== File ==
'''Name:''' ''server.met''

'''Location:''' ''~/.aMule/''

== Description ==
Binary file containing the list of [[server]]s known to [[aMule]].

Because it's in binary format, it must be changed within [[aMule]], or with other appropriate tools.

The format description below is for development information purposes.

== Format ==
=== File Format ===
This file's fields are written in [[little endian]] order.

'''Note:''' All digit fields are unsigned unless stated.

*Met Header (1 Byte): With value ''Ox0E'' or ''OxE0'', and is used in [[aMule]] to check for valid ''server.met'' files
*Server Count (4 Bytes): Lists the number of [[server]]s that follow
*Block of servers: Each [[server]] is constituted by the following fields:
**[[Server]] [[IP address|IP]] (4 Bytes): Simply that. The [[server]]'s [[IP address|IP]].
**[[Server]] [[Port]] (2 Bytes): Simply that. The [[port]] through which [[aMule]] will connect to the [[server]].
**Tag Count (4 Bytes): Lists the number of [[server]] tags that follows.
**Block of Tags: Each [[server]] can have a list of associated tags with the format bellow.

=== Tags Format ===
==== General tags format ====
There are two tag identifiers: A name (string) and an ID (1 Byte)

Which one is used depends on the tag value type given or on the size of the tag name. If tag name length is ''1'', an ID is used.

*Tag value type (1 Byte)
*Tag name length (2 Bytes)
*Tag name (size given above)
*Tag value length (2 Bytes) (Only when the value is a string)
*Tag value (if the value is a string, it's size is given in the above field. If it is not a string, the size depends on the type of value it is)

==== Tag value types ====
{|
|+ Tag types
| '''Tag type (''Code'')''' || '''Explanation'''
|-
| String (''0x02'') (*) || Defines a string tag.
|-
| Unsigned 32 bits number (''0x03'') || Defines a numeric tag.
|}

'''(*):''' Systems with [http://www.unicode.org Unicode] enabled have the same tag string defined twice, the first in [http://www.unicode.org Unicode], and the second in plain [http://www.asciitable.com ASCII], which will be ignored by [http://www.unicode.org Unicode] enabled [[client]]s, and used by non-[http://www.unicode.org Unicode] ones.

==== Tag IDs ====
{|
|+ Tag IDs
| ''ID ('''code''')'' || ''Tag value type'' || ''Description''
|-
| ServerName (''0x01'') || String || Name of the [[server]]
|-
| Description (''0x0B'') || String || Short description about the server
|-
| Ping (''0x0C'') || Unsigned 32 bits number || Time (in ms) it takes to comunicate with the server
|-
| Fail (''0x0D'') || Unsigned 32 bits number || How many times [[connect]]ing to the server failed
|-
| Preference (''0x0E'') || Unsigned 32 bits number || Priority given to this server among the others (Normal=''0'', High=''1'', Low=''2'')
|-
| DNS (''0x85'') || String || [http://en.wikipedia.org/wiki/DNS DNS] of the server
|-
| Max users (''0x87'') || Unsigned 32 bits number || Maximum number of users the server allows to simoultaneously connect to it
|-
| Soft files (''0x88'') || Unsigned 32 bits number || [[Soft files]] number
|-
| Hard files (''0x89'') || Unsigned 32 bits number || [[Hard files]] number
|-
| Last ping (''0x90'') || Unsigned 32 bits number || Last time the server was [[ping]]ed
|-
| Version (''0x91'') || String / Unsigned 32 bits number || Version and name of the software the server is running to support the [[FAQ_eD2k-Kademlia|ed2k]] [[network]]
|-
| [http://www.ietf.org/rfc/rfc768.txt UDP] flags (''0x92'') || Unsigned 32 bits number || Informs of the actions the server accepts through [http://www.ietf.org/rfc/rfc768.txt UDP] connections. This flags are:
*''0x01'': Get sources
*''0x02'': Get files
*''0x08'': New tags
*''0x10'': Unicode
*''0x20'': Get extended sources info
|-
| Auxiliary [[port]]s list (''0x93'') || String || Some servers have [[How_to_use_auxiliary_server_ports|additional ports]] open for those [[user]]s who cannot connect to the standard one (usually because they have a firewall which tries to stop [[P2P]] connections). This servers tell in this field which additional ports they have open. Each additional port is separated from the others by a coma ('','').
|-
| [[Low ID|LowID]] [[client]]s (''0x94'') || Unsigned 32 bits number || Number of users connected with a LowID
|}

==== Tag Names ====
{| border=0
|+ There are at the moment two tag names recognized by [[aMule]]:
| width="100px" | ''Tag Name'' || ''Tag Value''
|-
| "files" || Unsigned 32 bits number || Shows the number of [[file]]s registered in the [[server]]
|-
|"users" || Unsigned 32 bits number || Shows the number of [[user]]s registered in the [[server]]
|}

== Example ==
The following is an example file:

''E00200000050EFC86CB80B0C000000020100010A004269472042616E4720390201000B0E0077''
''77772E42694742616E472E746F0305007573657273EF1A010003050066696C657331DC8C0003''
''01000C9C00000003010090332B114303010087E0930400030100888813000003010089102700''
''0002010091040031372E3603010092FB0000000301009474580000428722C64E200C00000002''
''0100011E003E3E3E2A2A2A5757572E534558455345584F5345582E434F4D2A2A2A2020''

Here goes the explanation of the file:

*''E0'' <- Validation initial value
*''02000000'' <- ''2'' servers will be listed (remember its [[little endian]])
*Server #1:
**''50EFC86C'' <- [[IP address|IP]]: ''108.200.239.80'' (remember its [[little endian]]) endian]])
**''B80B'' <- [[Port]]: ''3000'' (remember its [[little endian]])
**''0C000000'' <- ''12'' tags (remember its [[little endian]])
**Tag #1
***''02'' <- Tag type ''2'' (String)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''01'' <- Tag name: ''1'' (Server name)
***''0A00'' <- Tag value length: ''10'' (remember its [[little endian]])
***''4269472042616E472039'' <- Tag value: ''BiG BanG 9'' (server name)
**Tag #2
***''02'' <- Tag type ''2'' (String)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''0B'' <- Tag name: ''0B'' (Description)
***''0E00'' <- Tag value length: ''14'' (remember its [[little endian]])
***''7777772E42694742616E472E746F'' <- Tag value: ''www.BiGBanG.to'' (server description)
**Tag #3
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0500'' <- Tag name length: ''5'' (remember its [[little endian]])
***''7573657273'' <- Tag name: ''users'' (this is a string, not a code)
***''EF1A0100'' <- Tag value: ''72431'' (remember its [[little endian]])
**Tag #4
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0500'' <- Tag name length: ''5'' (remember its [[little endian]])
***''66696C6573'' <- Tag name: ''files'' (this is a string, not a code)
***''31DC8C00'' <- Tag value: ''9231409'' (remember its [[little endian]])
**Tag #5
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''0C'' <- Tag name: ''0C'' (Ping)
***''9C000000'' <- Tag value: ''156'' (ping time in ms)
**Tag #6
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''90'' <- Tag name: ''90'' (Last ping)
***''332B1143'' <- Tag value: ''5:10:43 28/08/2005'' (last time the server was pinged)
**Tag #7
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''87'' <- Tag name: ''87'' (Max users)
***''E0930400'' <- Tag value: ''300000'' (max users)
**Tag #8
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''88'' <- Tag name: ''88'' (Soft files)
***''88130000'' <- Tag value: ''5000'' (soft files)
**Tag #9
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''89'' <- Tag name: ''89'' (Hard files)
***''10270000'' <- Tag value: ''10000'' (hard files)
**Tag #10
***''02'' <- Tag type ''2'' (String)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''91'' <- Tag name: ''91'' (Version)
***''0400'' <- Tag value length: ''4'' (remember its [[little endian]])
***''31372E36'' <- Tag value: ''17.6'' (version)
**Tag #11
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''92'' <- Tag name: ''92'' ([http://www.ietf.org/rfc/rfc768.txt UDP] flags)
***''FB000000'' <- Tag value (in binnary, only the least valuable byte): ''11111001'' ([http://www.ietf.org/rfc/rfc768.txt UDP] flags: get sources, new tags, unicode, extended sources)
**Tag #11
***''03'' <- Tag type ''3'' (Unsigned 32 bits number)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''94'' <- Tag name: ''94'' (LowID users)
***''74580000'' <- Tag value: ''22644'' (LowID users)
*Server #2
**''428722C6'' <- [[IP address|IP]]: ''198.34.135.66'' (remember its [[little endian]])
**''4E20'' <- [[Port]]: ''8270'' (remember its [[little endian]])
**''01000000'' <- ''1'' tag (remember its [[little endian]])
**Tag #1
***''02'' <- Tag type ''2'' (String)
***''0100'' <- Tag name length: ''1'' (remember its [[little endian]])
***''01'' <- Tag name: ''1'' (Server name)
***''1E00'' <- Tag value length: ''30'' (remember its [[little endian]])
***''3E3E3E2A2A2A5757572E534558455345584F5345582E434F4D2A2A2A2020'' <- Tag value: ''***WWW.EXAMPLE.COM*** '' (server name)

== More ==
For more information on tags used in [[eMule]] [[AMule_files|files]] and protocol, check the [http://hydranode.com/docs/ed2k/ed2k-tag.php ed2k tag documentation] at the [http://hydranode.com Hydranode project].

[[Category:Program Files]]

Ipfilter.dat file

2011-01-11T17:49:37Z

Reorder: Category:Program Files

== File ==
'''Name:''' ''ipfilter.dat''

'''Location:''' ''~/.aMule/''

== Description ==
The usefullness of this file is described in the [[IPFilter|IP Filter article]].

== Format ==
The format of the ''ipfilter.dat'' file is as follows:

'''[[IP address|IP]]s range , Access level , Description'''

''Access level'' values '''lower than 127''' are ''blocked [[IP address|IP]]s''' and values '''over 127''' are '''allowed [[IP address|IP]]s'''.

''[[IP address|IP]]s range'' values are described by an initial [[IP address|IP]] a dash and the ending [[IP address|IP]] of the range.

== Example ==
''000.000.000.000 - 000.255.255.255 , 000 , "This" Network [RFC1700, page 4]'' 
''169.254.0.0 - 169.254.0.255 , 000 , Link local'' 
''192.168.0.0 , 192.168.255.255 , Optionally block my LAN'' 
''127.0.0.0 , 127.255.255.255 , Optionally block localhost (Loopback)''

[[Category:Program Files]]

ED2KLinks file

2011-01-11T17:49:16Z

Reorder: Category:Program Files

<center>'''English''' | [[ED2KLinks_file-de|Deutsch]]</center>

== File ==

'''Name:''' ''ED2KLinks''

'''Location:''' ''~/.aMule/''

== Description ==

The ''ED2KLinks'' file is an interface to communicate with [[aMule]]. Inspite of the [[External Connections]] interface, this interface is ''mono-directional''. and inspite of the [[Signature|Online Signature]] interface, this one is ''in-going''.

It consists of a regular text file in [[aMule]]'s directory (in *nix systems that is at ''~/.aMule/'') which contains the [[Ed2k_link|eD2k links]] [[aMule]] should download.

As soon as [[aMule]] detects that file's existence, it reads it, starts downloading the links in it, and deletes the file.

It is also rarely used to special commands to a running [[aMule]] instance.

== Format ==

The links are listed one after the other separated with newlines. The file should end with a newline right after the last [[ed2k link]].

If a line contains only ''RAISE_DIALOG'' then [[aMule]], when it reads it, will raise it's window if it was minimized.

== Example ==

The following is the contents of a valid ''ED2KLinks'' file:

''ed2k://|file|Mandrake%20Linux%2010.0-Official-Powerpack-Cd1%20i586.iso|722343936|13048F2EC3B917E33BB9593D956E81AC|/'' 
''ed2k://|file|Knoppix%20v3.6-2004-08-16-En.iso|733499392|E1A848648CF99A2295909799FA45F0A8|/'' 
''ed2k://|file|debian-30r1-i386-binary-2.iso|676495360|557B59750976519476DA071BDF79A014|/''

== More ==

It might be of your interest to read [[FAQ_aMule#Is_there_a_way_to_open_a_text_file_and_load_all_the_ed2k_links_from_the_file?|this part]] in the [[FAQ_aMule|aMule FAQ]].

[[Category:Program Files]]