ircII help - on/dcc_raw

Usage: ON [#|+|-|^|&|@]DCC_RAW [-|^]<paramters> [action]

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

Up index Top level index