Onlinesig.dat file

From AMule Project FAQ
Revision as of 18:52, 11 January 2011 by Reorder (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

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 (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 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 UNIX newlines (in hex, 0xA), never DOS newlines (even if you are using a DOS or 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 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 UNIX newline character 0xA)
0.0|0.0|0