From 5416e6e916b56160b9b3b4f4d25118cd739dc0dc Mon Sep 17 00:00:00 2001 From: Rick Arnold Date: Wed, 5 Dec 2012 23:31:35 -0500 Subject: [PATCH] net: document that File reverts connection to blocking mode. Fixes #2458. R=mikioh.mikioh, rsc CC=golang-dev https://golang.org/cl/6869054 --- src/pkg/net/net.go | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/src/pkg/net/net.go b/src/pkg/net/net.go index f60c1e4cb2..a3d1759820 100644 --- a/src/pkg/net/net.go +++ b/src/pkg/net/net.go @@ -197,9 +197,13 @@ func (c *conn) SetWriteBuffer(bytes int) error { return setWriteBuffer(c.fd, bytes) } -// File returns a copy of the underlying os.File, set to blocking mode. +// File sets the underlying os.File to blocking mode and returns a copy. // It is the caller's responsibility to close f when finished. // Closing c does not affect f, and closing f does not affect c. +// +// The returned os.File's file descriptor is different from the connection's. +// Attempting to change properties of the original using this duplicate +// may or may not have the desired effect. func (c *conn) File() (f *os.File, err error) { return c.fd.dup() } // An Error represents a network error. -- 2.48.1