Difference between revisions of "Amulesig.dat file"

From AMule Project FAQ
Jump to: navigation, search
Line 1: Line 1:
 
This file is generated by [[aMule]] to inform external applications about it's status.
 
This file is generated by [[aMule]] to inform external applications about it's status.
  
[[aMule]]'s [[signature]] file is much more powerful than [[onlinesig.dat_file|eMule]]'s and has as much lines as fields. It's structure is:
+
[[aMule]]'s [[signature]] file is much more powerful than [[onlinesig.dat_file|eMule]]'s and has as much lines as fields. Amongst it's extended features (compared to [[eMule]]'s [[signature]]) are:
 +
*connecting 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
 +
 
 +
It's structure is:
 
*The first line will contain a ''0'' (zero) if [[aMule]] is disconnected or has been cleanly closed, a ''2'' if it's connecting (only since [[aMule]] 2.0.0-rc4), or a ''1'' (number 1) if it's online.
 
*The first line will contain a ''0'' (zero) if [[aMule]] is disconnected or has been cleanly closed, 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]] 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 second third and forth line contain the name, [[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.

Revision as of 14:05, 9 December 2004

This file is generated by aMule to inform external applications about it's status.

aMule's signature file is much more powerful than eMule's and has as much lines as fields. Amongst it's extended features (compared to eMule's signature) are:

  • connecting 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 file data too:

  • whether it is online or not
  • which server it's connected to
  • upload and download rate
  • clients in queue

It's structure is:

  • The first line will contain a 0 (zero) if aMule is disconnected or has been cleanly closed, 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 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 and seventh 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.
  • The eighth and nineth lines contain the number of clients on the upload queue and the amount of shared files respectively. Since aMule 2.0.0-rc4 both lines are set to zero (0) too when aMule is cleanly closed.
  • The tenth line contains the nickname of the user.
  • The eleventh and twelve lines contain the total amount of bytes downloaded and uploaded respectively.
  • The thirteenth line contains the aMule version.
  • The fourteenth and fifteenth line contains 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 sixteenth (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').