Logging
CtrlProxy has various means for logging conversions to file.
Logging in a custom format
Module that writes logs to one or more files using a
defined format.
This module may be used to write out log files that can be parsed by scripts or bots or logs in the same format as your favorite
IRC client.
Substitutes
The configuration values define the syntax that is used to
write out log file lines. In these configuration values,
values beginning with a '%' can be substituted.
The following characters are allowed after a percent
sign for all types of lines:
h
Current time of day, hours field.
M
Current time of day, number of minutes.
s
Current time of day, number of seconds.
n
Nick originating the line (saying the message, doing the kick, quitting, joining, etc).
u
Hostmask of the user originating the line.
N
Name of the current IRC network.
S
Name of the server (as set by the transport).
%
Percent sign
0,1,2,3,4,5,6,7,8,9
Substituted with the respective argument
in the IRC line.
@
Replaced by channel name if the message
is directed to a channel, the nick name to which
the message is being sent, or the name of the sender
of the message when the receiver is the user
running ctrlproxy.
This substitute will be the name of the first channel
on which the user is active if the line type
is NICK or QUIT.
Each type of line also has some variables of it's own that it substitutes.
join
%c
Name of the channel the user joins.
part
%c
Name of the channel the user is leaving.
%m
Comment
kick
%t
Nick of the user that is being kicked.
%c
Channel the user is being kicked from.
%r
Reason the user is being kicked.
quit
%m
Comment.
topic/notopic
%c
Name of the channel of which the
topic is being changed.
%t
The new topic. Only set
for 'topic', not for 'notopic'.
mode
%c
Name of user or channel of which the mode
is being changed.
%p
Change in the mode, e.g. +oie
%t
Target of which the mode is being changed.
To retrieve any additional arguments for a MODE command,
use %1, %2, etc.
notice/privmsg/action
%t
Name of channel or nickname of user to which
the notice/privmsg/ or action is being sent.
%m
Message that is being sent.
nick
%r
New nickname the user is changing his/her name to.