yule writes the
current status to a HTML file. The default name of this file
samhain.html, and by
default it is placed in
The file contains a header with the current status of the server (starting time, current time, open connections, total connections since start), and a table that lists the status of all registered clients.
There are a number of pre-defined events that may occur for a client:
The client has not connected since server startup.
The client has started. This message may be missing if the client was already running at server startup.
The client has exited.
The client has sent a message.
The client has fetched a file from the server.
Startup without prior exit. May indicate a preceding abnormal termination.
The client has encountered a fatal error condition.
An unsuccessful attempt to set up a session key or transfer a message.
The client has discovered a policy violation.
No message (e.g. timestamp) has been received from the client for a defined amount of time (default 1 day, option SetClientTimeLimit).
For each client, the latest event of each given type is listed. Events are sorted by time. Events that have not occurred (yet) are not listed.
It is possible to specify templates for (i) the file
header, (ii) a single table entry, and (iii) the file end.
Templates must be named
and must be located in the data directory (i.e.
Section 6 ). The distribution package
includes two sample files
The following replacements will be made in the head template:
|%L||Time of last connection.|
|%A||Total connections since startup.|
|%M||Maximum simultaneous connections.|
The following replacements will be made in the entry template:
|%T||Time of event.|
A literal '%' in the HTML output must be represented by a '% ' ('%' followed by space) in the template.