on_dcc_lost
Differences
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:====== | ||
on_dcc_lost.txt ยท Last modified: 2007/05/20 01:19 (external edit)