// Copyright 2009 The Go Authors. All rights reserved. // Use of this source code is governed by a BSD-style // license that can be found in the LICENSE file. // IP sockets package net import ( "os"; "syscall"; ) // Should we try to use the IPv4 socket interface if we're // only dealing with IPv4 sockets? As long as the host system // understands IPv6, it's okay to pass IPv4 addresses to the IPv6 // interface. That simplifies our code and is most general. // Unfortunately, we need to run on kernels built without IPv6 support too. // So probe the kernel to figure it out. func kernelSupportsIPv6() bool { fd, e := syscall.Socket(syscall.AF_INET6, syscall.SOCK_STREAM, syscall.IPPROTO_TCP); if fd >= 0 { syscall.Close(fd) } return e == 0 } var preferIPv4 = !kernelSupportsIPv6() // TODO(rsc): if syscall.OS == "linux", we're supposd to read // /proc/sys/net/core/somaxconn, // to take advantage of kernels that have raised the limit. func listenBacklog() int { return syscall.SOMAXCONN } // ListenerTCP is a TCP network listener. // Clients should typically use variables of type Listener // instead of assuming TCP. type ListenerTCP struct { fd *netFD; } // ListenTCP announces on the TCP address laddr and returns a TCP listener. // Net must be "tcp", "tcp4", or "tcp6". // If laddr has a port of 0, it means to listen on some available port. // The caller can use l.Addr() to retrieve the chosen address. func ListenTCP(net, laddr string) (l *ListenerTCP, err os.Error) { fd, e := internetSocket(net, laddr, "", syscall.SOCK_STREAM, "listen"); if e != nil { return nil, e } e1 := syscall.Listen(fd.fd, listenBacklog()); if e1 != 0 { syscall.Close(fd.fd); return nil, &OpError{"listen", "tcp", laddr, os.Errno(e1)}; } l = new(ListenerTCP); l.fd = fd; return l, nil } // AcceptTCP accepts the next incoming call and returns the new connection // and the remote address. func (l *ListenerTCP) AcceptTCP() (c *ConnTCP, raddr string, err os.Error) { if l == nil || l.fd == nil || l.fd.fd < 0 { return nil, "", os.EINVAL } fd, e := l.fd.accept(); if e != nil { return nil, "", e } return newConnTCP(fd, fd.raddr), fd.raddr, nil } // Accept implements the Accept method in the Listener interface; // it waits for the next call and returns a generic Conn. func (l *ListenerTCP) Accept() (c Conn, raddr string, err os.Error) { c1, r1, e1 := l.AcceptTCP(); if e1 != nil { return nil, "", e1 } return c1, r1, nil } // Close stops listening on the TCP address. // Already Accepted connections are not closed. func (l *ListenerTCP) Close() os.Error { if l == nil || l.fd == nil { return os.EINVAL } return l.fd.Close() } // Addr returns the listener's network address. func (l *ListenerTCP) Addr() string { return l.fd.addr(); } // Internet sockets (TCP, UDP) func internetSocket(net, laddr, raddr string, proto int, mode string) (fd *netFD, err os.Error) { // Parse addresses (unless they are empty). var lip, rip IP; var lport, rport int; if laddr != "" { if lip, lport, err = hostPortToIP(net, laddr, mode); err != nil { goto Error; } } if raddr != "" { if rip, rport, err = hostPortToIP(net, raddr, mode); err != nil { goto Error; } } // Figure out IP version. // If network has a suffix like "tcp4", obey it. vers := 0; switch net[len(net)-1] { case '4': vers = 4; case '6': vers = 6; default: // Otherwise, guess. // If the addresses are IPv4 and we prefer IPv4, use 4; else 6. if preferIPv4 && (lip == nil || lip.To4() != nil) && (rip == nil || rip.To4() != nil) { vers = 4 } else { vers = 6 } } var family int; if vers == 4 { family = syscall.AF_INET } else { family = syscall.AF_INET6 } var la, ra syscall.Sockaddr; if lip != nil { if la, err = ipToSockaddr(family, lip, lport); err != nil { goto Error; } } if rip != nil { if ra, err = ipToSockaddr(family, rip, rport); err != nil { goto Error; } } fd, err = socket(net, laddr, raddr, family, proto, 0, la, ra); if err != nil { goto Error; } return fd, nil; Error: addr := raddr; if mode == "listen" { addr = laddr; } return nil, &OpError{mode, net, addr, err}; } // TCP connections. // ConnTCP is an implementation of the Conn interface // for TCP network connections. type ConnTCP struct { connBase } func (c *ConnTCP) SetNoDelay(nodelay bool) os.Error { if c == nil { return os.EINVAL } return setsockoptInt(c.sysFD(), syscall.IPPROTO_TCP, syscall.TCP_NODELAY, boolint(nodelay)) } func newConnTCP(fd *netFD, raddr string) *ConnTCP { c := new(ConnTCP); c.fd = fd; c.raddr = raddr; c.SetNoDelay(true); return c } // DialTCP is like Dial but can only connect to TCP networks // and returns a ConnTCP structure. func DialTCP(net, laddr, raddr string) (c *ConnTCP, err os.Error) { if raddr == "" { return nil, &OpError{"dial", "tcp", "", errMissingAddress} } fd, e := internetSocket(net, laddr, raddr, syscall.SOCK_STREAM, "dial"); if e != nil { return nil, e } return newConnTCP(fd, raddr), nil } // UDP connections. // TODO(rsc): UDP headers mode // ConnUDP is an implementation of the Conn interface // for UDP network connections. type ConnUDP struct { connBase } func newConnUDP(fd *netFD, raddr string) *ConnUDP { c := new(ConnUDP); c.fd = fd; c.raddr = raddr; return c } // DialUDP is like Dial but can only connect to UDP networks // and returns a ConnUDP structure. func DialUDP(net, laddr, raddr string) (c *ConnUDP, err os.Error) { if raddr == "" { return nil, &OpError{"dial", "udp", "", errMissingAddress} } fd, e := internetSocket(net, laddr, raddr, syscall.SOCK_DGRAM, "dial"); if e != nil { return nil, e } return newConnUDP(fd, raddr), nil } func ipToSockaddr(family int, ip IP, port int) (syscall.Sockaddr, os.Error) { switch family { case syscall.AF_INET: if ip = ip.To4(); ip == nil { return nil, os.EINVAL } s := new(syscall.SockaddrInet4); for i := 0; i < IPv4len; i++ { s.Addr[i] = ip[i]; } s.Port = port; return s, nil; case syscall.AF_INET6: // IPv4 callers use 0.0.0.0 to mean "announce on any available address". // In IPv6 mode, Linux treats that as meaning "announce on 0.0.0.0", // which it refuses to do. Rewrite to the IPv6 all zeros. if p4 := ip.To4(); p4 != nil && p4[0] == 0 && p4[1] == 0 && p4[2] == 0 && p4[3] == 0 { ip = IPzero; } if ip = ip.To16(); ip == nil { return nil, os.EINVAL } s := new(syscall.SockaddrInet6); for i := 0; i < IPv6len; i++ { s.Addr[i] = ip[i]; } s.Port = port; return s, nil; } return nil, os.EINVAL; } // Split "host:port" into "host" and "port". // Host cannot contain colons unless it is bracketed. func splitHostPort(hostport string) (host, port string, err os.Error) { // The port starts after the last colon. i := last(hostport, ':'); if i < 0 { err = &AddrError{"missing port in address", hostport}; return; } host, port = hostport[0:i], hostport[i+1:len(hostport)]; // Can put brackets around host ... if len(host) > 0 && host[0] == '[' && host[len(host)-1] == ']' { host = host[1:len(host)-1] } else { // ... but if there are no brackets, no colons. if byteIndex(host, ':') >= 0 { err = &AddrError{"too many colons in address", hostport}; return; } } return; } // Join "host" and "port" into "host:port". // If host contains colons, will join into "[host]:port". func joinHostPort(host, port string) string { // If host has colons, have to bracket it. if byteIndex(host, ':') >= 0 { return "[" + host + "]:" + port } return host + ":" + port } // Convert "host:port" into IP address and port. // For now, host and port must be numeric literals. // Eventually, we'll have name resolution. func hostPortToIP(net, hostport, mode string) (ip IP, iport int, err os.Error) { host, port, err := splitHostPort(hostport); if err != nil { goto Error; } var addr IP; if host == "" { if mode != "listen" { err = &AddrError{"no host in address", hostport}; goto Error; } if preferIPv4 { addr = IPv4zero; } else { addr = IPzero; // wildcard - listen to all } } // Try as an IP address. if addr == nil { addr = ParseIP(host); } if addr == nil { // Not an IP address. Try as a DNS name. _, addrs, err1 := LookupHost(host); if err1 != nil { err = err1; goto Error; } addr = ParseIP(addrs[0]); if addr == nil { // should not happen err = &AddrError{"LookupHost returned invalid address", addrs[0]}; goto Error; } } p, i, ok := dtoi(port, 0); if !ok || i != len(port) { p, err = LookupPort(net, port); if err != nil { goto Error; } } if p < 0 || p > 0xFFFF { err = &AddrError{"invalid port", port}; goto Error; } return addr, p, nil; Error: return nil, 0, err; }