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, | ||
+ | ======Synopsis: | ||
+ | [[on]] [< | ||
+ | |||
+ | ======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- | ||
+ | |||
+ | ======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