net: document unimplemented methods and functions

Fixes #16802.

Change-Id: I41be7bb4e21e3beaa2136ee69771b0f455b2a7c6
Reviewed-on: https://go-review.googlesource.com/27417
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>

diff --git a/src/net/file.go b/src/net/file.go
index 1aad477400c2d0494709e87eceb23b68fe2d78ca..07099851cbfbd04c524722b693e16406c577f3dc 100644 (file)
--- a/src/net/file.go
+++ b/src/net/file.go
@@ -6,6 +6,9 @@ package net
 
 import "os"
 
+// BUG(mikio): On NaCl and Windows, the FileConn, FileListener and
+// FilePacketConn functions are not implemented.
+
 type fileAddr string
 
 func (fileAddr) Network() string  { return "file+net" }

diff --git a/src/net/interface.go b/src/net/interface.go
index 4947b52fafee8995e1cdfaf5c90eacbc421f7fab..295ab2dc9231556e543b5e936500632c9270cfeb 100644 (file)
--- a/src/net/interface.go
+++ b/src/net/interface.go
@@ -10,6 +10,12 @@ import (
        "time"
 )
 
+// BUG(mikio): On NaCl, Plan9 and Solaris, methods and functions
+// related to Interface are not implemented.
+
+// BUG(mikio): On DragonFly BSD, NetBSD and OpenBSD, the
+// MulticastAddrs method of Interface is not implemented.
+
 var (
        errInvalidInterface         = errors.New("invalid network interface")
        errInvalidInterfaceIndex    = errors.New("invalid network interface index")

diff --git a/src/net/iprawsock.go b/src/net/iprawsock.go
index 173b3cb4114296ef5e1d4e6606456e6631c5ffdc..95761b3a9ce264b2390ecd8359604320e2291bbf 100644 (file)
--- a/src/net/iprawsock.go
+++ b/src/net/iprawsock.go
@@ -9,6 +9,12 @@ import (
        "syscall"
 )
 
+// BUG(mikio): On NaCl, Plan 9 and Windows, the ReadMsgIP and
+// WriteMsgIP methods of IPConn are not implemented.
+
+// BUG(mikio): On Windows, the File method of IPConn is not
+// implemented.
+
 // IPAddr represents the address of an IP end point.
 type IPAddr struct {
        IP   IP

diff --git a/src/net/tcpsock.go b/src/net/tcpsock.go
index ce6e009451f46494c7d777e4802340a3b8301ecc..e02e6c9c7d325a1e70f4e84acf224ef530122f6d 100644 (file)
--- a/src/net/tcpsock.go
+++ b/src/net/tcpsock.go
@@ -12,6 +12,9 @@ import (
        "time"
 )
 
+// BUG(mikio): On Windows, the File method of TCPListener is not
+// implemented.
+
 // TCPAddr represents the address of a TCP end point.
 type TCPAddr struct {
        IP   IP

diff --git a/src/net/udpsock.go b/src/net/udpsock.go
index 980f67c81f9fa67a61a3ef755aa8b587043ae835..a859f4d4c0e1a8202877d8df8d4367c26aecfd74 100644 (file)
--- a/src/net/udpsock.go
+++ b/src/net/udpsock.go
@@ -9,6 +9,15 @@ import (
        "syscall"
 )
 
+// BUG(mikio): On NaCl, Plan 9 and Windows, the ReadMsgUDP and
+// WriteMsgUDP methods of UDPConn are not implemented.
+
+// BUG(mikio): On Windows, the File method of UDPConn is not
+// implemented.
+
+// BUG(mikio): On NaCl and Plan 9, the ListenMulticastUDP function is
+// not implemented.
+
 // UDPAddr represents the address of a UDP end point.
 type UDPAddr struct {
        IP   IP