This shows you the differences between two versions of the page.
on_dcc_lost [2007/05/20 01:19] |
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:====== | ||