path: root/docs/signals.txt

List of signals irssi emits - see design.txt for more information about
signals.

core
----

* Requires to work properly:

 "gui exit"
 "gui dialog", char *type, char *text
 "send command", char *command, SERVER_REC, WI_ITEM_REC

* Provides signals:

chat-protocols.c:
 "chat protocol created", CHAT_PROTOCOL_REC
 "chat protocol updated", CHAT_PROTOCOL_REC
 "chat protocol destroyed", CHAT_PROTOCOL_REC

channels.c:
 "channel created", CHANNEL_REC, int automatic
 "channel destroyed", CHANNEL_REC

chatnets.c:
 "chatnet created", CHATNET_REC
 "chatnet destroyed", CHATNET_REC

commands.c:
 "commandlist new", COMMAND_REC
 "commandlist remove", COMMAND_REC
 "error command", int err, char *cmd

 "send command", char *args, SERVER_REC, WI_ITEM_REC
 "send text", char *line, SERVER_REC, WI_ITEM_REC
 "command "<cmd>, char *args, SERVER_REC, WI_ITEM_REC
 "default command", char *args, SERVER_REC, WI_ITEM_REC

ignore.c:
 "ignore created", IGNORE_REC
 "ignore destroyed", IGNORE_REC
 "ignore changed", IGNORE_REC

log.c:
 "log new", LOG_REC
 "log remove", LOG_REC
 "log create failed", LOG_REC
 "log locked", LOG_REC
 "log started", LOG_REC
 "log stopped", LOG_REC
 "log rotated", LOG_REC
 "log written", LOG_REC, char *line

modules.c:
 "module loaded", MODULE_REC, MODULE_FILE_REC
 "module unloaded", MODULE_REC, MODULE_FILE_REC
 "module error", int error, char *text, char *rootmodule, char *submodule

nicklist.c:
 "nicklist new", CHANNEL_REC, NICK_REC
 "nicklist remove", CHANNEL_REC, NICK_REC
 "nicklist changed", CHANNEL_REC, NICK_REC, char *old_nick
 "nicklist host changed", CHANNEL_REC, NICK_REC
 "nicklist gone changed", CHANNEL_REC, NICK_REC
 "nicklist serverop changed", CHANNEL_REC, NICK_REC

pidwait.c:
 "pidwait", int pid, int status

queries.c:
 "query created", QUERY_REC, int automatic
 "query destroyed", QUERY_REC
 "query nick changed", QUERY_REC, char *orignick
 "window item name changed", WI_ITEM_REC
 "query address changed", QUERY_REC
 "query server changed", QUERY_REC, SERVER_REC

rawlog.c:
 "rawlog", RAWLOG_REC, char *data

server.c:
 "server looking", SERVER_REC
 "server connected", SERVER_REC
 "server connecting", SERVER_REC, ulong *ip
 "server connect failed", SERVER_REC
 "server disconnected", SERVER_REC
 "server quit", SERVER_REC, char *msg
 "server sendmsg", SERVER_REC, char *target, char *msg, int target_type

settings.c:
 "setup changed"
 "setup reread", char *fname
 "setup saved", char *fname, int autosaved


IRC core
--------

* Provides signals:

bans.c:
 "ban type changed", char *bantype

channels, nicklist:
 "channel joined", CHANNEL_REC
 "channel wholist", CHANNEL_REC
 "channel sync", CHANNEL_REC

 "channel topic changed", CHANNEL_REC

ctcp.c:

 "ctcp msg", SERVER_REC, char *args, char *nick, char *addr, char *target
 "ctcp msg "<cmd>, SERVER_REC, char *args, char *nick, char *addr, char *target
 "default ctcp msg", SERVER_REC, char *args, char *nick, char *addr, char *target
 "ctcp reply", SERVER_REC, char *args, char *nick, char *addr, char *target
 "ctcp reply "<cmd>, SERVER_REC, char *args, char *nick, char *addr, char *target
 "default ctcp reply", SERVER_REC, char *args, char *nick, char *addr, char *target
 "ctcp action", SERVER_REC, char *args, char *nick, char *addr, char *target

irc-log.c:
 "awaylog show", LOG_REC, int away_msgs, int filepos

irc-nicklist.c:
 "server nick changed", SERVER_REC

irc-servers.c:
 "event connected", SERVER_REC

irc.c:

 "server event", SERVER_REC, char *data, char *sender_nick, char *sender_address
 "event "<cmd>, SERVER_REC, char *args, char *sender_nick, char *sender_address
 "default event", SERVER_REC, char *data, char *sender_nick, char *sender_address
 "whois default event", SERVER_REC, char *args, char *sender_nick, char *sender_address

 "server incoming", SERVER_REC, char *data

(for perl parser..)
 "redir "<cmd>, SERVER_REC, char *args, char *sender_nick, char *sender_address

lag.c:
 "server lag", SERVER_REC
 "server lag disconnect", SERVER_REC

massjoin.c:
 "massjoin", CHANNEL_REC, GSList of NICK_RECs

mode-lists.c:
 "ban new", CHANNEL_REC, BAN_REC
 "ban remove", CHANNEL_REC, BAN_REC, char *setby

modes.c:
 "channel mode changed", CHANNEL_REC, char *setby
 "nick mode changed", CHANNEL_REC, NICK_REC, char *setby, char *mode, char *type
 "user mode changed", SERVER_REC, char *old
 "away mode changed", SERVER_REC

netsplit.c:
 "netsplit server new", SERVER_REC, NETSPLIT_SERVER_REC
 "netsplit server remove", SERVER_REC, NETSPLIT_SERVER_REC
 "netsplit new", NETSPLIT_REC
 "netsplit remove", NETSPLIT_REC

IRC modules
-----------

* Provides signals:

dcc*.c:

 "dcc ctcp "<cmd>, char *args, DCC_REC
 "default dcc ctcp", char *args, DCC_REC
 "dcc unknown ctcp", char *args, char *sender, char *sendaddr

 "dcc reply "<cmd>, char *args, DCC_REC
 "default dcc reply", char *args, DCC_REC
 "dcc unknown reply", char *args, char *sender, char *sendaddr

 "dcc chat message", DCC_REC, char *msg

 "dcc created", DCC_REC
 "dcc destroyed", DCC_REC
 "dcc connected", DCC_REC
 "dcc rejecting", DCC_REC
 "dcc closed", DCC_REC
 "dcc request", DCC_REC, char *sendaddr
 "dcc request send", DCC_REC
 "dcc chat message", DCC_REC, char *msg
 "dcc transfer update", DCC_REC
 "dcc get receive", DCC_REC
 "dcc error connect", DCC_REC
 "dcc error file create", DCC_REC, char *filename
 "dcc error file open", char *nick, char *filename, int errno
 "dcc error get not found", char *nick
 "dcc error send exists", char *nick, char *filename
 "dcc error unknown type", char *type
 "dcc error close not found", char *type, char *nick, char *filename

autoignore.c:

 "autoignore new", SERVER_REC, AUTOIGNORE_REC
 "autoignore remove", SERVER_REC, AUTOIGNORE_REC

flood.c:

 "flood", SERVER_REC, char *nick, char *host, int level, char *target

notifylist.c:

 "notifylist new", NOTIFYLIST_REC
 "notifylist remove", NOTIFYLIST_REC
 "notifylist joined", SERVER_REC, char *nick, char *user, char *host, char *realname, char *awaymsg
 "notifylist away changed", SERVER_REC, char *nick, char *user, char *host, char *realname, char *awaymsg
 "notifylist left", SERVER_REC, char *nick, char *user, char *host, char *realname, char *awaymsg

proxy/listen.c:

 "proxy client connected", CLIENT_REC
 "proxy client disconnected", CLIENT_REC

FE common
---------

* Requires to work properly:

 "gui print text", WINDOW_REC, int fg, int bg, int flags, char *text, TEXT_DEST_REC

(Can be used to determine when all "gui print text"s are sent (not required))
 "gui print text finished", WINDOW_REC

* Provides signals:

completion.c:
 "complete word", GList * of char*, WINDOW_REC, char *word, char *linestart, int *want_space

fe-common-core.c:
 "irssi init read settings"

fe-exec.c:
 "exec new", PROCESS_REC
 "exec remove", PROCESS_REC, int status
 "exec input", PROCESS_REC, char *text

fe-messages.c:
 "message public", SERVER_REC, char *msg, char *nick, char *address, char *target
 "message private", SERVER_REC, char *msg, char *nick, char *address
 "message own_public", SERVER_REC, char *msg, char *target
 "message own_private", SERVER_REC, char *msg, char *target, char *orig_target
 "message join", SERVER_REC, char *channel, char *nick, char *address
 "message part", SERVER_REC, char *channel, char *nick, char *address, char *reason
 "message quit", SERVER_REC, char *nick, char *address, char *reason
 "message kick", SERVER_REC, char *channel, char *nick, char *kicker, char *address, char *reason
 "message nick", SERVER_REC, char *newnick, char *oldnick, char *address
 "message own_nick", SERVER_REC, char *newnick, char *oldnick, char *address
 "message invite", SERVER_REC, char *channel, char *nick, char *address
 "message topic", SERVER_REC, char *channel, char *topic, char *nick, char *address

keyboard.c:
 "keyinfo created", KEYINFO_REC
 "keyinfo destroyed", KEYINFO_REC

printtext.c:
 "print text", TEXT_DEST_REC *dest, char *text, char *stripped

themes.c:
 "theme created", THEME_REC
 "theme destroyed", THEME_REC

window-activity.c:
 "window hilight", WINDOW_REC
 "window activity", WINDOW_REC, int old_level
 "window item hilight", WI_ITEM_REC
 "window item activity", WI_ITEM_REC, int old_level

window-items.c:
 "window item new", WINDOW_REC, WI_ITEM_REC
 "window item remove", WINDOW_REC, WI_ITEM_REC
 "window item changed", WINDOW_REC, WI_ITEM_REC
 "window item server changed", WINDOW_REC, WI_ITEM_REC

windows.c:
 "window created", WINDOW_REC
 "window destroyed", WINDOW_REC
 "window changed", WINDOW_REC, WINDOW_REC old
 "window changed automatic", WINDOW_REC
 "window server changed", WINDOW_REC, SERVER_REC
 "window refnum changed", WINDOW_REC, int old
 "window name changed", WINDOW_REC
 "window history changed", WINDOW_REC, char *oldname
 "window level changed", WINDOW_REC

FE IRC
------

fe-irc-messages.c:
 "message irc op_public", SERVER_REC, char *msg, char *nick, char *address, char *target
 "message irc own_wall", SERVER_REC, char *msg, char *target
 "message irc own_action", SERVER_REC, char *msg, char *target
 "message irc action", SERVER_REC, char *msg, char *nick, char *address, char *target
 "message irc own_notice", SERVER_REC, char *msg, char *target
 "message irc notice", SERVER_REC, char *msg, char *nick, char *address, char *target
 "message irc own_ctcp", SERVER_REC, char *cmd, char *data, char *target
 "message irc ctcp", SERVER_REC, char *cmd, char *data, char *nick, char *address, char *target

fe-modes.c:
 "message irc mode", SERVER_REC, char *channel, char *nick, char *addr, char *mode

dcc/fe-dcc-chat-messages.c:
 "message dcc own", DCC_REC *dcc, char *msg
 "message dcc own_action", DCC_REC *dcc, char *msg
 "message dcc own_ctcp", DCC_REC *dcc, char *cmd, char *data
 "message dcc", DCC_REC *dcc, char *msg
 "message dcc action", DCC_REC *dcc, char *msg
 "message dcc ctcp", DCC_REC *dcc, char *cmd, char *data

Text FE
-------

gui-readline.c:
 "gui key pressed", int key

gui-printtext.c:
 "beep"

Perl
----

"script error", PERL_SCRIPT_REC, char *errormsg