User Tools

Site Tools


dcc_close

# $EPIC: dcc_close.txt,v 1.4 2006/08/29 18:22:56 sthalik Exp $

Synopsis:

dcc close [<type>|-all|*] [<nick>|-all|*] [“<filename>”]

Description:

DCC CLOSE cancels a DCC session:

  • For DCC SEND, it rescinds the offer to send a file
  • For DCC GET, it rejects our interest in receiving the file
  • For DCC CHAT, it closes the dedicated chat connection
  • For $connect(), it closes the raw client socket connection
  • For $listen(), it closes the listening socket (but not any connections)
  • For a file transfer in progress, it terminates the transfer early.
The <type> argument is one of:
CHAT for private one-to-one conversations
SEND for outbound file transfers
GET for inbound file transfers
RAW for $connect()s or $listen()s
-ALL for all DCCs of all of the above types
* same as -ALL

The <nick> argument is the name of the peer, as shown in the DCC LIST output. It may be -ALL or * to match all DCCs of the given <type>.

<filename> may be in double quotes, if it contains spaces. <filename> is only necessary for DCC SEND or DCC GET connections.

If you do not provide <filename> and there are multiple connections of a given <type> to <nick> open, the first such connection is closed.

There is no wildcard support for <type>, <nick>, or <filename>.

When you DCC CLOSE a pending connection (either an offer you have made to someone else, or an offer someone has made to you, but which has not been accepted), it is considered a DCC REJECT and a CTCP reply to the other peer will be send to notify them the connection will not be completed.

If someone is sending you a file, you want to DCC CLOSE GET <nick> and if you are sending someone a file, you want to DCC CLOSE SEND <nick>.

If you exit the client, all of your open DCC connections are closed.

On some older versions of EPIC, doing DCC CLOSE from within an ON related to a DCC event could cause a crash. Be careful about closing a DCC that is currently being processed.

Examples:

To close an existing DCC CHAT connection with bob:

    /dcc close chat bob

To reject an incoming DCC SEND connection from bob:

    /dcc close get bob

To close all DCC CHAT connections:

    /dcc close chat *

or

    /dcc close chat -all

To close all DCC connections with or offered by bob:

    /dcc close * bob

or

    /dcc close -all bob

History:

The DCC CLOSE command first appeared in ircII-2.1.2

dcc_close.txt · Last modified: 2006/08/29 20:18 (external edit)