code review 684041: net: implement raw sockets

src/pkg/net/tcpsock.go

 // 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.
 
 // TCP sockets
 
 package net
 
 import (
         "os"
@@ skipping 63 matching lines @@
 func newTCPConn(fd *netFD) *TCPConn {
         c := &TCPConn{fd}
         setsockoptInt(fd.sysfd, syscall.IPPROTO_TCP, syscall.TCP_NODELAY, 1)
         return c
 }
 
 func (c *TCPConn) ok() bool { return c != nil && c.fd != nil }
 
 // Implementation of the Conn interface - see Conn for documentation.
 
-// Read reads data from the TCP connection.
-//
-// Read can be made to time out and return err == os.EAGAIN
-// after a fixed time limit; see SetTimeout and SetReadTimeout.
+// Read implements the net.Conn Read method.
 func (c *TCPConn) Read(b []byte) (n int, err os.Error) {
         if !c.ok() {
                 return 0, os.EINVAL
         }
         return c.fd.Read(b)
 }
 
-// Write writes data to the TCP connection.
-//
-// Write can be made to time out and return err == os.EAGAIN
-// after a fixed time limit; see SetTimeout and SetReadTimeout.
+// Write implements the net.Conn Write method.
 func (c *TCPConn) Write(b []byte) (n int, err os.Error) {
         if !c.ok() {
                 return 0, os.EINVAL
         }
         return c.fd.Write(b)
 }
 
 // Close closes the TCP connection.
 func (c *TCPConn) Close() os.Error {
         if !c.ok() {
@@ skipping 13 matching lines @@
 }
 
 // RemoteAddr returns the remote network address, a *TCPAddr.
 func (c *TCPConn) RemoteAddr() Addr {
         if !c.ok() {
                 return nil
         }
         return c.fd.raddr
 }
 
-// SetTimeout sets the read and write deadlines associated
-// with the connection.
+// SetTimeout implements the net.Conn SetTimeout method.
 func (c *TCPConn) SetTimeout(nsec int64) os.Error {
         if !c.ok() {
                 return os.EINVAL
         }
         return setTimeout(c.fd, nsec)
 }
 
-// SetReadTimeout sets the time (in nanoseconds) that
-// Read will wait for data before returning os.EAGAIN.
-// Setting nsec == 0 (the default) disables the deadline.
+// SetReadTimeout implements the net.Conn SetReadTimeout method.
 func (c *TCPConn) SetReadTimeout(nsec int64) os.Error {
         if !c.ok() {
                 return os.EINVAL
         }
         return setReadTimeout(c.fd, nsec)
 }
 
-// SetWriteTimeout sets the time (in nanoseconds) that
-// Write will wait to send its data before returning os.EAGAIN.
-// Setting nsec == 0 (the default) disables the deadline.
-// Even if write times out, it may return n > 0, indicating that
-// some of the data was successfully written.
+// SetWriteTimeout implements the net.Conn SetWriteTimeout method.
 func (c *TCPConn) SetWriteTimeout(nsec int64) os.Error {
         if !c.ok() {
                 return os.EINVAL
         }
         return setWriteTimeout(c.fd, nsec)
 }
 
 // SetReadBuffer sets the size of the operating system's
 // receive buffer associated with the connection.
 func (c *TCPConn) SetReadBuffer(bytes int) os.Error {
@@ skipping 105 matching lines @@
 // Already Accepted connections are not closed.
 func (l *TCPListener) Close() os.Error {
         if l == nil || l.fd == nil {
                 return os.EINVAL
         }
         return l.fd.Close()
 }
 
 // Addr returns the listener's network address, a *TCPAddr.
 func (l *TCPListener) Addr() Addr { return l.fd.laddr }