mod_logging

Log users entering and leaving the hub. Part of the bundled plug-ins.

mod_logging records a line for every successful login, failed login, logout and nick change, to a log file or to the system log.

Loading

Log to a file:

plugin /var/lib/uhub/mod_logging.so "file=/var/log/uhub/uhub.log"

Or to syslog (Unix only):

plugin /var/lib/uhub/mod_logging.so "syslog=1"

Configuration

OptionDefaultDescription
filePath to the log file. Required unless syslog is used; the file is opened for append.
syslog0When 1, log to the system log (as uhub) instead of a file. Not available on Windows.

Log format

Each line records the event, the user's SID/CID, IP address, nick, credentials (or the reason on errors) and the client's user-agent, for example:

LoginOK     AAAB/CID... 203.0.113.7 "alice" (user) "DC++ 0.868"
Logout      AAAB/CID... 203.0.113.7 "alice" (quit) "DC++ 0.868"
NickChange  AAAC/CID... 198.51.100.4 "bob" -> "bobby"