View source for Direct Client-to-Client

{{Short description|Protocol for file transfer and direct chat on Internet Relay Chat}}
{{Multiple issues|{{overly detailed|date=August 2012}}
{{more citations needed|date=August 2012}}}}

'''Direct Client-to-Client''' ('''DCC''') (originally '''Direct Client Connection'''<ref>{{Cite web |title=Open Source and Free Software |url=https://www.troy.rollo.name/opensource.html |url-status=dead |archive-url=https://web.archive.org/web/20181116085439/https://www.troy.rollo.name/opensource.html |archive-date=2018-11-16 |access-date=2018-11-15 |website=troy.rollo.name}}</ref><ref>{{Cite web |title=DCC negotiation and connection |url=http://www.kvirc.net/doc/doc_dcc_connection.html |website=kvric.net}}</ref><ref>{{Cite web|url=https://www.irchelp.org/protocol/ctcpspec.html|title=IRCHelp.org — The Client-To-Client Protocol (CTCP)|website=www.irchelp.org}}</ref>) is an [[Internet Relay Chat|IRC]]-related sub-protocol enabling [[Peer-to-peer|peers]] to interconnect using an IRC server for [[Handshake (computing)|handshaking]] in order to exchange files or perform non-relayed chats. Once established, a typical DCC session runs independently from the IRC server. Originally designed to be used with [[ircII]] it is now supported by many [[client (computing)|IRC clients]]. Some peer-to-peer clients on napster-protocol servers also have DCC send/get capability, including TekNap, SunshineUN and Lopster. A variation of the DCC protocol called SDCC (Secure Direct Client-to-Client), also known as DCC SCHAT supports [[encrypted]] connections. An [[Request for Comments|RFC specification]] on the use of DCC does not exist.

DCC connections can be initiated in two different ways:
* The most common way is to use [[Client-To-Client Protocol|CTCP]] to initiate a DCC session. The CTCP is sent from one user, over the IRC network, to another user.
* Another way to initiate a DCC session is for the client to connect directly to the DCC server. Using this method, no traffic will go across the IRC network (the parties involved do not need to be connected to an IRC network in order to initiate the DCC connection).

==History==
[[ircII]] was the first IRC client to implement the CTCP and DCC protocols.<ref>{{cite book
| last        = Piccard
| first       = Paul
|author2=Brian Baskin|author3=George Spillman|author4=Marcus Sachs
| title       = Securing IM and P2P Applications for the Enterprise
| edition     = 1st
| date        = May 1, 2005
| publisher   = Syngress
| isbn        = 1-59749-017-2
| page        = 386
| chapter     = IRC Networks and Security
| quote       = The authors of the ircII software package originally pioneered file transfers over IRC.
}}</ref> The CTCP protocol was implemented by Michael Sandrof in 1990 for ircII version 2.1.<ref>See the 'NOTES' and 'source/ctcp.c' files included with [http://download.ircii.org/historical/unsorted/clients/unix/ircii/ircii-2.1.4e.tar.gz ircii-2.1.4e.tar.gz]{{dead link|date=December 2016 |bot=InternetArchiveBot |fix-attempted=yes }}</ref> The DCC protocol was implemented by Troy Rollo in 1991 for version 2.1.2,<ref>See the 'UPDATES' and 'source/dcc.c' files included with [http://download.ircii.org/historical/unsorted/clients/unix/ircii/ircii-2.1.4e.tar.gz ircii-2.1.4e.tar.gz]{{dead link|date=December 2016 |bot=InternetArchiveBot |fix-attempted=yes }}</ref> but was never intended to be portable to other IRC clients.<ref>{{cite newsgroup
| title       = /dcc
| author      = Troy Rollo
| date        = January 20, 1993
| newsgroup   = alt.irc
|message-id= 1993Jan20.222051.1484@usage.csd.unsw.OZ.AU
| url         = https://groups.google.com/group/alt.irc/msg/fc5de46e023d5ffe
| access-date  = November 10, 2010
}}</ref><ref>{{cite web
| url         = http://www.irchelp.org/irchelp/rfc/dccspec.html
| title       = A description of the DCC protocol
| access-date  = November 10, 2010
| last        = Rollo
| first       = Troy
| publisher   = irchelp.org
| quote       = The first comment I should make is that the DCC protocol was never designed to be portable to clients other than IRCII. As such I take no responsibility for it being difficult to implement for other clients.
}}</ref>

==Common DCC applications==

===DCC CHAT===
The CHAT service enables users to chat with each other over a DCC connection.<ref>{{Cite web |title=mIRC Help |url=https://www.mirc.com/help/html/index.html?dcc.html |access-date=2023-07-24 |website=www.mirc.com}}</ref> The traffic will go directly between the users, and not over the IRC network. When compared to sending messages normally, this reduces IRC network load, allows sending of larger amounts of text at once, due to the lack of flood control, and makes the communication more secure by not exposing the message to the IRC servers (however, the message is still in [[plaintext]]).

DCC CHAT is normally initiated using a [[Client-To-Client Protocol|CTCP]] handshake. The user wishing to establish the connection sends the following CTCP to the target, <code>DCC CHAT {{var|protocol}} {{var|ip}} {{var|port}}</code>, where {{var|ip}} and {{var|port}} are the IP address and port number of the sender, and are expressed as integers. {{var|protocol}} is {{mono|chat}} for standard DCC CHAT. The receiving party can then connect to the given port and IP address.

Once a connection is established, the protocol used for DCC CHAT is very simple: users exchange [[CRLF]]-terminated messages. Messages that begin with an [[ASCII]] 001 (control-A, represented below by {{mono|[^A]}}) and the word {{mono|ACTION}}, and are terminated by another ASCII {{mono|001}}, are interpreted as emotes: <code>[^A]ACTION waves goodbye[^A]</code>.

====DCC Whiteboard====
This is an extension to DCC CHAT, allowing simple drawing commands to be sent as well as lines of text. DCC Whiteboard is initiated with a handshake similar to DCC CHAT, with the protocol {{mono|chat}} replaced by {{mono|wboard}}:
<code>DCC CHAT wboard {{var|ip}} {{var|port}}</code>.

Once the connection is established, the two clients exchange [[CRLF]]-terminated messages. Messages that begin (and optionally end) with ASCII {{mono|001}} are interpreted as special commands; the command {{mono|ACTION}} represents an emote, while others cause lines to be drawn on the user's whiteboard surface, or allow the two clients to negotiate a set of features.

===DCC SEND {{anchor|DCC RESUME|DCC TSEND|DCC SEND T}} ===
The SEND service allows users to send files to one another. The original specification for the handshake did not allow the receiver to know the total file size nor to resume a transfer. This has made clients introduce their own extensions to the handshake, many of which have become widely supported.

The original handshake consisted of the sender sending the following CTCP to the receiver: <code>DCC SEND {{var|filename}} {{var|ip}} {{var|port}}</code>.

As with DCC CHAT, {{var|ip}} and {{var|port}} are the IP address and port where the sending machine will be listening for an incoming connection. Some clients enclose filenames with spaces in double quotes. It is common practice to add the file size as a last argument: <code>DCC SEND {{var|filename}} {{var|ip}} {{var|port}} {{var|filesize}}</code>.

At this point, the original specification had the receiver either connect to the given address and port and wait for data, or ignore the request, but for clients supporting the DCC RESUME extension, a third alternative is to ask the sender to skip part of the file by sending the CTCP reply: <code>DCC RESUME {{var|filename}} {{var|port}} {{var|position}}</code>.

If the sending client supports DCC RESUME, it will reply with, <code>DCC ACCEPT {{var|filename}} {{var|port}} {{var|position}}</code>, and the receiver can connect to the given address and port and listen for data to append to an already existing file.

Data is sent to the client in blocks, each of which the client must acknowledge by sending the total number of bytes received in the form of a [[32-bit]] [[network byte order]] integer. This slows down connections and is redundant because of [[Transmission Control Protocol|TCP]]. The send-ahead extension relieves this problem somewhat by not waiting for the acknowledgements, but since the receiver still has to send them for every block it receives, in case the sender expects them, it is not solved completely.

Another extension, TDCC, or turbo DCC, removes the acknowledgements, but requires a slightly modified handshake and is not widely supported. Older versions of TDCC replaced the word SEND in the handshake with TSEND; later versions use the word SEND but append a {{mono|T}} after the handshake, making this version of TSEND compatible with other clients (as long as they can parse the modified handshake).

====DCC SEND exploit====
The "DCC send exploit" can refer to two bugs: a variant [[buffer overflow]] error in [[mIRC]] triggered by filenames longer than 14 characters,<ref>{{cite web|url=http://www.securityfocus.com/bid/8880|title=SecurityFocus exploit information}}</ref> and an [[input validation error]] in some routers manufactured by [[Netgear]], [[D-Link]] and [[Linksys]], triggered by the use of port {{Mono|0}}.<ref>{{Cite web|url=https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2006-1068|title=CVE - CVE-2006-1068|website=cve.mitre.org}}</ref><ref>{{Cite web|url=https://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-2006-1067|title=CVE - CVE-2006-1067|website=cve.mitre.org}}</ref> The router exploit, in particular, may be triggered when the phrase '{{Mono|DCC SEND}}' followed by at least 6 characters without spaces or newlines appears anywhere in a [[Transmission Control Protocol|TCP]] stream on port 6667, not just when an actual DCC SEND request has been made. In the 2000s it was possible to combine multiple exploits into a single string, {{Mono|DCC SEND startkeylogger 0 0 0}}, which if posted in a public channel could cause multiple users to disconnect (either by crashing IRC clients, crashing routers, or triggering overly strict default settings in antivirus software).{{cn|date=January 2024}}

===DCC XMIT===
The XMIT service is a modified version of DCC SEND that allows for resuming files and cuts down on wasteful traffic from the ACK longs. XMIT is not widely supported.

The XMIT handshake differs somewhat from the SEND handshake. The sender sends a [[Client-to-client protocol|CTCP]] offering a file to the receiver: <code>DCC XMIT {{var|protocol}} {{var|ip}} {{var|port}}[ {{var|name}}[ {{var|size}}[ {{var|MIME-type}}]]]</code>

Square brackets here enclose optional parts. {{var|protocol}} is the [[protocol (computing)|protocol]] to use for the transfer; only {{mono|clear}} is defined presently. Unlike standard DCC SEND, {{var|ip}} can be in the additional forms of standard dotted notation for IPv4, or either hexadecimal or mixed notation for IPv6. To leave an early parameter empty, but still supply a later one, the earlier one can be specified as {{mono|-}}. If the receiver does not implement the protocol used, it will send back a CTCP reply of the format: <code>ERRMSG DCC CHAT {{var|protocol}} unavailable</code>.

CHAT is used here to maintain compatibility with the error messages sent by the extended DCC CHAT. If the receiver declines the transfer, it sends the following CTCP reply: <code>ERRMSG DCC CHAT {{var|protocol}} declined</code>.

Other errors are reported in the same fashion. If the receiver is willing and capable of receiving the file, it will connect to the given address and port. What happens then depends on the protocol used.

In the case of the {{mono|clear}} protocol, the XMIT server will, upon receiving a connection, send a 32-bit <code>[[time t]]</code> in [[network byte order]], representing the file's modification time. Presumably based on the modification time of the local file, the client will then send another network byte order <code>[[Endianness#Networking|long]]</code>, an offset which the server should seek to when sending the file. This should be set to zero if the whole file is wanted, or the size of the local file if the client wishes to resume a previous download.

While faster than SEND, XMIT carries one of the same limitations in that it is impossible to tell how big the file is, unless its size is specified in the [[Client-to-client protocol|CTCP]] negotiation or known beforehand. Furthermore, it is not possible to resume a file past the two gigabyte mark due to the 32-bit offset.

===Passive DCC===
In a normal DCC connection the initiator acts as the [[Server (computing)|server]], and the target is the [[client (computing)|client]]. Because of widespread [[Firewall (networking)|firewalling]] and reduction of end-to-end transparency because of [[Network Address Translation|NAT]], the initiator might not be able to act as a server. Various ways of asking the target to act as the server have been devised:

====DCC Server====
This extension to normal DCC SEND and CHAT was introduced by the IRC client [[mIRC]]. DCC Server has moderate support, but is not standard on all clients (see [[Comparison of Internet Relay Chat clients]]).

It allows the initiation of a DCC connection by IP address, without the need of an IRC server. This is accomplished by the receiving client acting as a server (hence the name) listening (usually on port 59) for a handshake from the sender.

For a CHAT, the initiator sends <code>1000 {{var|initiator nick}}</code>. The target then replies with, <code>1000 {{var|target nick}}</code>, and the rest proceeds according to standard DCC CHAT protocol.

For a SEND, the initiator sends <code>1200 {{var|initiator nick}} {{var|filesize}} {{var|filename}}</code>. The target replies with, <code>1210 {{var|target nick}} {{var|resume position}}</code>, where {{var|resume position}} is the offset in the file from which to start. From here the transfer proceeds as a normal DCC SEND.

DCC Server also supports mIRC-style file servers and DCC GET.

====RDCC====
DCC Server provides no way specifying the port to use, so this has to be negotiated manually, which is not always possible, as one of the sides may not be a human. RDCC is a handshake mechanism for DCC Server, which in addition to the port also provides the IP address of the server, which the client might not be able to find otherwise because of host masking. It is not widely supported.

The initiator requests the port the target is listening on by sending the CTCP query, <code>RDCC {{var|function}} {{var|comment}}</code>, where {{var|function}} is {{mono|c}} for chat, {{mono|s}} for send, or {{mono|f}} for file server.

The target may then CTCP reply with, <code>RDCC 0 {{var|ip}} {{var|port}}</code>, where {{var|ip}} and {{var|port}} have the same meanings as for normal DCC SEND and CHAT. After this the initiator connects to the {{var|ip}} and {{var|port}}, and a DCC Server handshake follows.

====DCC REVERSE====
Unlike DCC Server, where the handshake is handled over a direct IP connection, DCC REVERSE has a normal CTCP handshake, similar to the one used by DCC SEND. This is not widely implemented. The sender offers a file to the receiver by sending the CTCP message: <code>DCC REVERSE {{var|filename}} {{var|filesize}} {{var|key}}</code>. {{var|key}} is a 1–50 characters-long string of [[ASCII]] characters in the range 33–126, and acts as an identifier for the transfer.

If the receiver accepts, it sends the CTCP reply, <code>DCC REVERSE {{var|key}} {{var|start}} {{var|ip}} {{var|port}}</code>

Here, {{var|start}} is the position in the file from which to start sending, {{var|ip}} is the IP address of the receiver in standard [[Dot-decimal notation|dotted notation]] for [[IPv4]], or [[hexadecimal]] notation for [[IPv6]]. The sender then connects to the ip address and port indicated by the receiver, and a normal DCC SEND follows. Both the sender and receiver can cancel the handshake by sending the CTCP reply, <code>DCC REJECT REVERSE {{var|key}}</code>.

====DCC RSEND====
This is the KVIrc client's alternative to DCC REVERSE. The sender offers a file by sending the CTCP: <code>DCC RSEND {{var|filename}} {{var|filesize}}</code>. The receiver can then accept by CTCP replying with, <code>DCC RECV {{var|filename}} {{var|ip}} {{var|port}} {{var|start}}</code>, and the sender connects to the receiver and sends as during a normal DCC SEND.

====Reverse / Firewall DCC====
This passive DCC mechanism is supported by at least [[mIRC]], [[Visual IRC]], [[HexChat]], KVIrc, [[DMDirc]], [[Klient]], [[Konversation]], and [[PhibianIRC]]. The sender offers a file by sending the CTCP message, <code>DCC SEND {{var|filename}} {{var|ip}} 0 {{var|filesize}} {{var|token}}</code>. {{var|ip}} is the [[IP address]] of the sender in network byte order, expressed as a single integer (as in standard DCC). The number 0 is sent instead of a valid port, signaling that this is a Reverse DCC request. {{var|token}} is a unique integer; if TSEND is being used (by a client that supports it), the letter {{mono|T}} is appended to the token, letting the receiver know it doesn't need to send acknowledgements.

The receiver can accept the file by opening a listening socket and responding with the CTCP message, <code>DCC SEND {{var|filename}} {{var|ip}} {{var|port}} {{var|filesize}} {{var|token}}</code>. This is identical to the original Reverse DCC message, except the {{var|ip}} and {{var|port}} identify the socket where the receiver is listening. {{var|token}} is the same as in the original request, letting the sender know which request is being accepted. (Because this message follows the same format as a regular DCC send request, some servers which filter DCC requests may require the sender to add the receiver to their "DCC allow" list.)

The sender then connects to the receiver's socket, sends the content of the file, and waits for the receiver to close the socket when the file is finished.

When the RESUME extension to the SEND protocol is used, the sequence of commands becomes (with {{mono|>>}} indicating an outgoing message on the initiating side, and {{mono|<<}} response by its peer):

<code>>> DCC SEND {{var|filename}} {{var|ip}} 0 {{var|filesize}} {{var|token}}<br />
<< DCC RESUME {{var|filename}} 0 {{var|position}} {{var|token}}<br />
>> DCC ACCEPT {{var|filename}} 0 {{var|position}} {{var|token}}<br />
<< DCC SEND {{var|filename}} {{var|peer-ip}} {{var|port}} {{var|filesize}} {{var|token}}</code>

After which the protocol proceeds as normal (i.e. the sender connects to the receiver's socket).

===File servers (FSERVs)===
A DCC ''fserve'', or file server, lets a user browse, read and download files located on a DCC server.

Typically, this is implemented with a DCC CHAT session (which presents the user with a command prompt) or special [[Client-to-client protocol|CTCP]] commands to request a file. The files are sent over DCC SEND or DCC XMIT. There are many implementations of DCC file servers, among them is the FSERV command in the popular [[mIRC]] client.

==See also==
* [[Client-to-client protocol|CTCP]] (Client-to-client protocol)
* [[XDCC]] (eXtended DCC)

==References==
{{reflist}}

==External links==
* [http://www.irchelp.org/irchelp/rfc/dccspec.html A description of the DCC protocol] ''(note: Most IRC-clients and networks have implemented extensions to the DCC protocol. The DCC commonly used today has evolved quite a bit from what this document describes.)''
* [http://www.kvirc.de/docu/doc_dcc_connection.html DCC negotiation and connection] {{Webarchive|url=https://web.archive.org/web/20051215235335/http://www.kvirc.de/docu/doc_dcc_connection.html |date=2005-12-15 }}
* [http://www.visualirc.net/tech-tdcc.php A description of the Turbo DCC protocol]
* [http://www.visualirc.net/tech-wboard.php A description of the DCC Whiteboard protocol]

{{IRC topics}}

{{DEFAULTSORT:Direct Client-To-Client}}
[[Category:IRC]]
[[Category:Internet terminology]]
[[Category:Network protocols]]
[[Category:Protocols related to IRC]]