Difference between revisions of "Preferences.dat file"

From AMule Project FAQ
Jump to: navigation, search
m (Description: Pointing to amule.conf)
 
(10 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 +
<center>
 +
'''English''' |
 +
[[Preferences.dat_file-tw|正體中文]]
 +
</center>
 +
 +
== File ==
 +
 +
'''Name:''' ''preferences.dat''
 +
 +
'''Location:''' ''~/.aMule/''
 +
 
== Description ==
 
== 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.
 
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 ==
 
== Data ==
Line 11: Line 24:
 
The file format is as follows:
 
The file format is as follows:
  
'''VersionUserhashLengthFlagsShowcmdMaxpositionxMaxpositionyMinpositionxMinpositionyNormalpositionleftNormalpositiontopNormalpositionrightNormalpositionbottom'''
+
'''Version Userhash'''
  
As you can see, all the fields are stored without any separator character. This is done like this all the fields have a specific size:
+
Size of each field is as follows:
 
*''Version'': 1 byte
 
*''Version'': 1 byte
*''Userhash'': 2 bytes
+
*''Userhash'': 16 bytes, stored as a big-endian 128-bit value.
*''Length'': 4 bytes
+
*''Flags'': 4 bytes
+
*''Showcmd'': 4 bytes
+
*''Maxpositionx'': 4 bytes
+
*''Maxpositiony'': 4 bytes
+
*''Minpositionx'': 4 bytes
+
*''Minpositiony'': 4 bytes
+
*''Normalpositionleft'': 4 bytes
+
*''Normalpositiontop'': 4 bytes
+
*''Normalpositionright'': 4 bytes
+
*''Normalpositionbottom'': 4 bytes
+
 
+
Once this data is put together, it is stored in little-endian.
+
  
 
== Example ==
 
== Example ==
  
The following is a hex dump of an hypothetic ''preferences-dat'' file:
+
The following is a hex dump of an hypothetic ''preferences.dat'' file:
  
''a3143e6f12dd445b12a0c3c6f7ca5b2d00000000000000000000000000000000000000000000000000000000''
+
''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:
 
In the above example, the following data can be seen:
  
 
*Configuration file version: ''20'' (In hex: ''0x14'')
 
*Configuration file version: ''20'' (In hex: ''0x14'')
*Userhash: ''A36F3EDD125B44A012C6C3CAF72D5B''
+
*Userhash: ''2C1662179C0ECE024555A85A566C6F49''
*Window position and size: ---
+
 
+
== Extra ==
+
  
[[aMule]] ignores the main window position, main window size, showcmd, flags and length fields in this file. That's the reason why this fields aren't specified in this article.
+
[[Category:Program Files]]

Latest revision as of 14:02, 17 June 2012

English | 正體中文

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