Difference between revisions of "AMule files"

From AMule Project FAQ
Jump to: navigation, search
(Add link to canceled.met_file)
 
(29 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<center>'''English''' | [[AMule_files-nl|Nederlands]] | [[AMule_files-de|Deutsch]] | [[AMule_files-hu|Magyar]]</center>
+
<center>
 +
'''English''' |  
 +
[[AMule_files-de|Deutsch]] |  
 +
[[AMule_files-hu|Magyar]] |  
 +
[[AMule_files-nl|Nederlands]]
 +
</center>
  
Most [[aMule]]'s config files and data are the same as or is compatible with [[eMule|eMule]]'s.
+
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.
 
Have in mind that you might not have all of them on your hard disk, since they are generated when needed.
  
Here is a list and the usage of each of them:
+
== Program Files ==
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0).
+
 
 +
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.
 
*'''[[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.conf_file|~/.aMule/amule.conf]]:''' [[aMule]]'s personal configuration file (where most preferences are stored).
*'''[[amulesig.dat_file|~/.aMule/amulesig.dat]]:''' This is [[aMule_Project_FAQ:About|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.conf.bak:''' Backup of [[amule.conf file]].
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[amuleweb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
+
*'''[[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.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_Project_FAQ:About|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_Project_FAQ:About|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.
 +
*'''~/.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.
 
*'''[[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.
 +
*'''[[canceled.met_file|~/.aMule/canceled.met]]:''' Contains the hashes of the files that were cancelled by the user.
 
*'''[[clients.met_file|~/.aMule/clients.met]]:''' Contains the public hashes of other known clients along with the credits it owes each of them.
 
*'''[[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]].
+
**'''~/.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]].
+
*'''[[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.
 
*'''[[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]].
 
*'''[[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]] ranges and access levels restrictions which will be passed to [[IPFilter]].
+
*'''[[GeoIP.dat_file|~/.aMule/GeoIP.dat]]:'''  Used to identify the country of an IP address.
*'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
+
*'''[[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_static.dat:''' This file contains the [[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]] 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.
+
**'''~/.aMule/ipfilter.download:''' This is where [[ipfilter.dat file]]s are temporary downloaded, before being renamed to ''ipfilter.dat'' (if the download succeeds).
*'''[[key_index.dat file|~/.aMule/key_index.dat]]:'''  
+
*'''[[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.
 
*'''[[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 stores 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.
 
*'''[[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_Project_FAQ:About|aMule]] to know if you changed your version or if it's the first time you run it.
+
*'''[[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]] clientsand the date when they where last seen.
+
*'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen.
*'''~/.aMule/logfile:''' This file contains the log of the last [[aMule_Project_FAQ:About|aMule]] execution.
+
*'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution.
*'''~/.aMule/muleconn:''' This file is a socket for [[aMule_Project_FAQ:About|aMule]] communications.
+
**'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current.
*'''[[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_Project_FAQ:About|aMule]]'s stat. See also [[amulesig.dat_file|''amulesig.dat'']] above.
+
*'''[[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.
*'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client on the [[FAQ_ed2k|ed2k]] network, also known as user hash.
+
*'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them.
*'''[[preferencesKad.dat_file|~/.aMule/preferencesKad.dat]]:''' Contains the [[IP]] and client ID of your client on the [[Kademlia]] network, that is, your identification keys.
+
*'''[[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]].
 
*'''[[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]], port and such).
+
*'''[[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.bak:''' Backup of [[server.met file]].
*'''~/.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.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_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.
 
*'''[[shareddir.dat_file|~/.aMule/shareddir.dat]]:''' Stores the paths to all shared directories.
*'''[[src_index.dat file|~/.aMule/src_index.dat]]:'''  
+
*'''[[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.
 
*'''[[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.
 
*'''~/aMule-online-sign.{png|jpg|bmp}:''' Default location where [[wxCAS]] stores the stat image.
Line 45: Line 56:
 
*'''/usr/share/fonts/corefonts/times.ttf:''' Default location where [[CAS]] will look for a font to generate the stats image.
 
*'''/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.
 
*'''/usr/share/pixmaps/stat.png:''' Default location where [[CAS]] will look for a template image to generate the stats image.
*'''/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.
+
*'''[[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]]
Also, on the Temp directory (which is ''~/.aMule/Temp'' by default but can be set to any other on Preferences), [[aMule_Project_FAQ:About|aMule]] will create, for each download in queue, the following files:
+
  
*'''*.part:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[aMule_Project_FAQ:About|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.
+
=== Deprecated ===
*'''*.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'' 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''.
+
*'''~/.aMule/aMule.tmpl:''' This was the template file which [[AMuleWeb|aMule WebServer]] used in version prior to [[aMule]] 2.0.0.
*'''*.part.met.backup:''' This are temporal ''*.part.met'' while the data is being stored. As soon as [[aMule]] finishes writting the file, it is renamed to ''*.part.met''.
+
*'''~/.eMule:''' [[aMule]]'s old personal configuration file (version prior to [[aMule]] 2.0.0). It was renamed to ''~/.aMule/amule.conf''.
*'''*.part.met.seeds:''' This file only exists if you have enabled to store the [[IP]]s of sources of rare files in the preferences, so that [[aMule_Project_FAQ:About|aMule]] can try to connect to these sources again after a restart.
+
*'''~/.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:
 
The directories in ''~/.aMule/'' have the following use:
  
*'''~/.aMule/Incoming/:''' By default, the directory where [[aMule_Project_FAQ:About|aMule]] stores the completed downloads (except on [http://macosx.apple.com MacOS X]).
+
*'''~/.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_Project_FAQ:About|aMule]] stores the non-completed downloads (temporary files).
+
*'''~/.aMule/Temp/:''' By default, the directory where [[aMule]] stores the non-completed downloads (temporary files).
*'''~/.aMule/webserver/:''' This directory contains the skins for [[aMuleWeb]].
+
*'''~/.aMule/webserver/:''' This directory contains the skins for [[AMuleWeb|aMuleWeb]].
*'''~/aMule Downloads:''' By default, the directory where [[aMule_Project_FAQ:About|aMule]] stores the completed downloads on [http://www.microsoft.com/windows Windows].
+
*'''~/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_Project_FAQ:About|aMule]] stores the completed downloads on [http://macosx.apple.com MacOS X] (since [[aMule]] 2.0.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]]

Latest revision as of 17:02, 25 March 2015

English | Deutsch | Magyar | Nederlands

Most of aMule's config files and data are the same as or are compatible with 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"):

See also: Category:Program Files

Deprecated

  • ~/.aMule/aMule.tmpl: This was the template file which 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: 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: 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 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 while the data is being stored. As soon as aMule finishes writting the file, it is renamed to *.part.met.
  • *.part.met.seeds: This file only exists if you have enabled to store the IPs 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 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.
  • ~/aMule Downloads: The directory where aMule stored the completed downloads on 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 Windows (since aMule 2.0.0).
  • <app_dir>/Incoming: In MacOS X and Windows, if aMule cannot determine the user's Documents folder, it will store the downloaded files here.