Site Tools


on_dcc_lost
no way to compare when less than two revisions

Differences

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


on_dcc_lost [2007/05/20 01:19] (current) – created - external edit 127.0.0.1
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 by 127.0.0.1