This is activated whenever you receive a raw message from a tcp connection established with $CONNECT(). The parameters for the action are as follows: $0 file descriptor for the connection. $1 host name in connection $2 code as listed below $3- data or port number depending on code.
Incoming messages can be intercepted with ON DCC_RAW, which has the following formats:
fd host D data fd host C fd host N port fd host E port
The D message indicates incoming data. The C message indicates that the socket has been closed. The N message indicates that a socket listening on the specified port has accepted a connection. fd in this case is the file descriptor for the new connection. The E message is generated when a CONNECT() results in a successful connection.
Conventions to be used for the socket access:
Scripts using sockets should never use the serial number 0 in their hooks. As their first act before using the DCC_RAW hooks, they should set:
ON ^DCC_RAW * #
To ensure that all raw DCC sockets produce no output.
A new set of hooks should be created for each active socket at a chosen serial number. One must always exist to detect the close message, and as its last act must remove all the hooks for that file descriptor.
See Also: dcc/raw alias/functions