Site Tools


on_send_to_server

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

on_send_to_server [2006/08/29 16:08] (current)
Line 1: Line 1:
 +======Synopsis:​======
 +[[on]] [<​modes>​]send_to_server [<​serial#>​] [-|^]<​match>​ { <​action>​ }
 +
 +======Description:​======
 +This hook, when set, is triggered whenever the client sends data to the
 +server that matches the hook.  It is useful for catching raw messages
 +destined for the server and redefining them.  One such use is with DCC,
 +as it offers no convenient way to send a raw request. ​ By using the
 +silent mode, the default action (sending data to the server) is
 +suppressed, allowing any arbitrary command to be replaced.
 +
 +When this hook is defined, it causes the client to monitor all traffic
 +to the server, making it somewhat resource intensive. ​ It is recommended
 +that it be used sparingly. ​ Caution should be used, as it is easy to
 +put the client into an infinite loop with this hook.
 +
 +======Parameters:​======
 +|$0 |reference number of the target server|
 +|$1 |Unix file descriptor of the server connection|
 +|$2- |text to be sent to the server|
 +
 +======Examples:​======
 +To change how a DCC handshake is made (on the sending side):
 +   on ^send_to_server "% % % PRIVMSG % :​$chr(1)DCC*"​ {
 +      quote PRIVMSG $4 :​$chr(1)SECRET_DCC $6-
 +   }
 +
  
on_send_to_server.txt ยท Last modified: 2006/08/29 16:08 (external edit)