User Tools

Site Tools


on_dcc_lost

Differences

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

Link to this comparison view

on_dcc_lost [2007/05/20 01:19] (current)
Line 1: Line 1:
 +#$EPIC: on_dcc_lost.txt,​v 1.4 2007/05/20 01:19:15 jnelson Exp $
 +======Synopsis:​======
 +[[on]] [<​modes>​]dcc_lost [<​serial#>​] [-|^]<​match>​ { <​action>​ }
 +
 +======Description:​======
 +This hook is triggered whenever a [[DCC]] [[dcc CHAT|CHAT]] or 
 +[[DCC SEND|SEND]] connection ends whether or not the connection was 
 +successful or not.
 +
 +As a special case, this hook is triggered whenever the user specifies a
 +port with the -p flag to [[dcc chat]] or [[dcc send]] and that port cannot
 +be used because it is already in use.  See the second set of parameters.
 +You can hook this event and either do a
 + @dccctl(SET $4 WANT_PORT <new port>)
 +or create an entirely new [[dcc]],
 + defer dcc $1 $0 $urldecode($2) -p <new port>
 +or you can do nothing, and the dcc will be automatically abandoned.
 +
 +======Parameters:​======
 +|$0    |nickname of the [[dcc]] connection |
 +|$1-   ​|disconnection message (varies) |
 +
 +======Parameters for Port In Use:======
 +| $0 | The person the [[dcc chat]] or [[dcc send]] is being offered to |
 +| $1 | The type (ie, SEND or CHAT) |
 +| $2 | The url-encoded filename (if any) |
 +| $3 | The refnum of the dcc, suitable for [[dccctl]]. |
 +| $4 | The port that was in use. |
 +| $5- | The literal string "PORT IN USE" |
 +
 +
 +======Default Action:​======
 +If you don't suppress this event, the client will display a message to your
 +screen.
 +
 +======Examples:​======
 +To indicate that dcc connection was terminated:
 +   on ^dcc_lost * (nick, reason) {
 +      if (*reason) {
 +         @ reason = [: ] ## reason;
 +      };
 +      xecho -b DCC connection with $nick lost$reason;​
 +   };
 +
 +======History:​======
  
on_dcc_lost.txt ยท Last modified: 2007/05/20 01:19 (external edit)