TIP 162: IPv6 Sockets for Tcl

Author:         Rafael Martínez Torres <[email protected]>
Author:         Donal K. Fellows <[email protected]>
Author:         Reinhard Max <[email protected]>
State:          Final
Type:           Project
Vote:           Done
Created:        23-Oct-2003
Tcl-Version:    8.6
Tcl-Branch:     rmax-ipv6-branch


This TIP is about allowing Tcl to use IPv6 sockets in virtually the same way that you would use the current (IPv4) sockets.


IPv6 is the next generation of the IP protocol that underlies Internet sockets. IPv6 advantages include a wider address space (128 bits instead current 32 bits), improved mobility, mandatory security at IP layer (IPsec...), etc. Tcl should allow the programmers try both protocols at their networking programs without too much effort (dependant on underlying operating system support, of course), just accepting the literal address (, 2001:DB8::baad:f00d) or the DNS names (www.example.com).

Proposed Change

The interpreter should understand:

socket http
socket 2001:DB8::baad:f00d echo
socket -server accept 9999
socket ipv6.example.com 8080

Where a hostname resolves to multiple addresses in multiple families, the addresses are tried one by one as returned by the the resolver library until a connection can be established. The order depends on the resolver library and its configuration; it is deliberately not touched by Tcl, so that local preferences are automatically respected by Tcl programs.

For sockets that actually use IPv6 the output of fconfigure needs to be changed to reflect the fact:

Client sockets:

% fconfigure sock5 -peername
2001:DB8::baad:f00d ipv6.example.com 7
% fconfigure sock5 -sockname
2001:DB8::dead:beef 2001:DB8::dead:beef 49198

Server sockets:

% socket -server accept 0
% fconfigure sock3 -sockname 49198 :: :: 49198

The -sockname and -peername options are the affected ones; for client sockets they can indicate addresses in the IPv6 or IPv4 namespaces, and for server sockets the -sockname option will list all the addresses bound (2 in the above example), three elements each. To maximize backward compatibility, the IPv4 address (if bound) will always be listed first. (Client sockets will always only list a single address as they will always be connected by a definite protocol.)

Reference Implementation

A development branch has been opened up; see http://wiki.tcl.tk/25947 for details.

An older patch is available for UNIX platforms http://www.ngn.euro6ix.org/IPv6/tcl .


This document has been placed in the public domain.