Difference between revisions of "AMule files"
From AMule Project FAQ
GonoszTopi (Talk | contribs) (Add link to canceled.met_file) |
|||
(46 intermediate revisions by 13 users not shown) | |||
Line 1: | Line 1: | ||
− | <center>'''English''' | [[AMule_files-nl|Nederlands]]</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 | + | 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 == |
− | + | ||
+ | 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/amule.conf''' | + | *'''[[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/amule.conf.bak:''' Backup of [[amule.conf file]]. |
− | *'''~/.aMule/aMule. | + | *'''[[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/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. | + | **'''~/.aMule/clients.met.bak:''' Backup of [[clients.met file]]. |
− | *'''[[cryptkey.dat_file|~/.aMule/cryptkey.dat]]:''' It contains the unique 384 bit private [http://www. | + | *'''[[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. |
+ | *'''[[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. | *'''[[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). |
− | *'''[[lastversion_file|~/.aMule/lastversion]]:''' This is only for [[ | + | *'''[[last_version_check_file|~/.aMule/last_version_check]]:''' Temporary file containing the version of the latest official [[aMule]] release available. |
− | *'''~/.aMule/logfile:''' This file contains the log of the | + | *'''[[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. |
− | *'''~/.aMule/ | + | *'''[[load_index.dat file|~/.aMule/load_index.dat]]:''' Contains keyIDs of other [[Kademlia]] clients and the date when they where last seen. |
− | *'''[[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 [[ | + | *'''[[logfile_file|~/.aMule/logfile]]:''' This file contains the log of the current [[aMule]] execution. |
− | *'''[[preferences.dat_file|~/.aMule/preferences.dat]]:''' Contains the public key of your client, also known as user hash. | + | **'''~/.aMule/logfile.bak:''' This file contains the log of the [[aMule]] execution before the current. |
− | *'''[[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). | + | *'''[[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. |
− | *'''~/.aMule/ | + | *'''[[nodes.dat file|~/.aMule/nodes.dat]]:''' Contains a list of Kademlia contacts and details on how to contact each of them. |
− | *'''~/.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]]. | + | *'''[[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. | *'''[[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. | *'''[[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]] | |
− | + | ||
− | *'''*.part:''' This file contains the downloaded parts (not chunks, since not completed chunks are also stored here) of the download. As [[ | + | === 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/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/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/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:''' 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]] |
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"):
- ~/.aMule/addresses.dat: Contains a list of serverlist URLs to check (if enabled in Preferences) for new servers on startup.
- ~/.aMule/amule.conf: aMule's personal configuration file (where most preferences are stored).
- ~/.aMule/amule.conf.bak: Backup of amule.conf file.
- ~/.aMule/amulesig.dat: This is aMule's OnLineSignature file, which is the same as eMule's signature (see 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 HTML stats page. This 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.
- ~/.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.
- ~/.aMule/canceled.met: Contains the hashes of the files that were cancelled by the user.
- ~/.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/cryptkey.dat: It contains the unique 384 bit private RSA key of your client.
- ~/.aMule/emfriends.met: Contains your friends list configuration.
- ~/.aMule/ED2KLinks: This file acts as an external interface to add downloads to aMule.
- ~/.aMule/GeoIP.dat: Used to identify the country of an IP address.
- ~/.aMule/ipfilter.dat: This file contains the IP ranges and access levels restrictions which will be passed to IPFilter.
- ~/.aMule/ipfilter.download: This is where ipfilter.dat files are temporary downloaded, before being renamed to ipfilter.dat (if the download succeeds).
- ~/.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/key_index.dat: This file stores information your client provides to the Kademlia network.
- ~/.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).
- ~/.aMule/last_version_check: Temporary file containing the version of the latest official aMule release available.
- ~/.aMule/lastversion: This is only for aMule to know if you changed your version or if it's the first time you run it.
- ~/.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 current aMule execution.
- ~/.aMule/logfile.bak: This file contains the log of the aMule execution before the current.
- ~/.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.
- ~/.aMule/nodes.dat: Contains a list of Kademlia contacts and details on how to contact each of them.
- ~/.aMule/onlinesig.dat: This is an eMule compatible OnLineSignature file. It's used by other applications to know basic information on aMule's stat. See also amulesig.dat above.
- ~/.aMule/preferences.dat: Contains the public key of your client on the ed2k network, also known as user hash.
- ~/.aMule/preferencesKad.dat: Contains the IP and client ID of your client on the Kademlia network, that is, your identification keys.
- ~/.aMule/remote.conf: Configuration file for External Connections.
- ~/.aMule/server.met: This is a list of all known servers and your preferences about them (priority, name, IP, port and such).
- ~/.aMule/server.met.bak: Backup of server.met file.
- ~/.aMule/server.met.download: This is where server.met files 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.
- ~/.aMule/server_auto.met: Here is where server.met files are downloaded before merging them with aMule's server.met file.
- ~/.aMule/shareddir.dat: Stores the paths to all shared directories.
- ~/.aMule/src_index.dat: This file stores information your client provides to the Kademlia network.
- ~/.aMule/staticservers.dat: Stores a list of static servers.
- ~/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 links.
- /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/tmp.html: Default location where CAS will look for a template HTML page to generate the stats HTML page.
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.