go/src/net
Martin Sucha 35170365c8 net: document methods of Buffers
There is code in the wild that copies the Buffers slice,
but not the contents.
Let's document explicitly that it is not safe to do so.

Updates #45163

Change-Id: Id45e27b93037d4e9f2bfde2558e7869983b60bcf
Reviewed-on: https://go-review.googlesource.com/c/go/+/387434
Reviewed-by: Ian Lance Taylor <iant@golang.org>
Run-TryBot: Ian Lance Taylor <iant@golang.org>
TryBot-Result: Gopher Robot <gobot@golang.org>
Reviewed-by: Damien Neil <dneil@google.com>
2022-02-22 23:35:31 +00:00
..
http net/http: deflake request-not-written path 2022-02-14 17:30:31 +00:00
internal/socktest all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
mail all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
netip net/netip: correct ipv6 address in ParsePrefix comment 2022-02-03 03:21:15 +00:00
rpc all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
smtp net/smtp: match actual behavior for Auth.Start 2022-02-08 23:39:48 +00:00
testdata net: reject leading zeros in IP address parsers 2021-06-08 20:23:22 +00:00
textproto all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
url all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
addrselect.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
addrselect_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_aix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_android.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_bsd.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_linux.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_netbsd.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_openbsd.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_resnew.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_resold.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_socknew.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_sockold.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_solaris.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
cgo_windows.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
conf.go net/netip: add new IP address package 2021-11-02 01:28:01 +00:00
conf_netcgo.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
conf_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
conn_test.go net: lengthen arbitrary SetDeadline timeout by a few orders of magnitude 2021-12-17 02:00:14 +00:00
dial.go
dial_test.go net: synchronize instead of sleeping in TestDialParallelSpuriousConnection 2022-01-06 15:00:16 +00:00
dial_unix_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
dnsclient.go net: accept "." as a valid domain name 2021-11-05 22:23:52 +00:00
dnsclient_test.go
dnsclient_unix.go net: increase maximum accepted DNS packet to 1232 bytes 2022-02-15 22:30:13 +00:00
dnsclient_unix_test.go net: increase maximum accepted DNS packet to 1232 bytes 2022-02-15 22:30:13 +00:00
dnsconfig_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
dnsconfig_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
dnsname_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
error_plan9.go
error_plan9_test.go net: refactor TestWriteToTimeout 2021-12-13 16:44:13 +00:00
error_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
error_posix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
error_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
error_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
error_unix_test.go net: refactor TestWriteToTimeout 2021-12-13 16:44:13 +00:00
error_windows.go
error_windows_test.go net: refactor TestWriteToTimeout 2021-12-13 16:44:13 +00:00
example_test.go net: add examples for remaining IP functions 2021-10-13 16:36:59 +00:00
external_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
fcntl_libc_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
fcntl_syscall_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
fd_plan9.go
fd_posix.go net: pass around pointers to SockaddrInetN 2021-11-04 21:52:36 +00:00
fd_unix.go net: optimize ctxDone usage 2021-11-18 19:16:38 +00:00
fd_windows.go
file.go
file_plan9.go
file_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
file_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
file_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
file_windows.go
hook.go
hook_plan9.go
hook_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
hook_windows.go
hosts.go net: avoid memory copy calling absDomainName 2021-08-16 21:38:38 +00:00
hosts_test.go net: avoid memory copy calling absDomainName 2021-08-16 21:38:38 +00:00
interface.go
interface_aix.go internal/syscall/unix: change Ioctl arg type to unsafe.Pointer on AIX 2021-08-16 16:58:24 +00:00
interface_bsd.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
interface_bsd_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
interface_bsdvar.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
interface_darwin.go
interface_freebsd.go net: don't use syscall.NET_RT_IFLISTL on FreeBSD 2021-10-02 16:05:55 +00:00
interface_linux.go
interface_linux_test.go
interface_plan9.go
interface_solaris.go
interface_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
interface_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
interface_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
interface_windows.go
ip.go net: do not panic on nil IPNet.String() 2022-01-05 01:53:39 +00:00
ip_test.go net: do not panic on nil IPNet.String() 2022-01-05 01:53:39 +00:00
iprawsock.go
iprawsock_plan9.go
iprawsock_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
iprawsock_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
ipsock.go
ipsock_plan9.go
ipsock_plan9_test.go
ipsock_posix.go net: optimize WriteMsgUDPAddrPort 2021-11-02 03:55:19 +00:00
ipsock_test.go
listen_test.go all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
lookup.go all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
lookup_fake.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
lookup_plan9.go net: avoid memory copy calling absDomainName 2021-08-16 21:38:38 +00:00
lookup_test.go net: fix a race in TestLookupContextCancel 2022-02-09 20:12:16 +00:00
lookup_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
lookup_windows.go net: avoid memory copy calling absDomainName 2021-08-16 21:38:38 +00:00
lookup_windows_test.go all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
mac.go
mac_test.go
main_cloexec_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
main_conf_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
main_noconf_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
main_plan9_test.go
main_posix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
main_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
main_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
main_windows_test.go
mockserver_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
net.go net: document methods of Buffers 2022-02-22 23:35:31 +00:00
net_fake.go net: pass around pointers to SockaddrInetN 2021-11-04 21:52:36 +00:00
net_test.go net: in TestNotTemporaryRead, do not assume that a dialed connection has been accepted 2022-02-14 21:55:10 +00:00
net_windows_test.go
netgo_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
nss.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
nss_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
packetconn_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
parse.go net/netip: add new IP address package 2021-11-02 01:28:01 +00:00
parse_test.go net/netip: add new IP address package 2021-11-02 01:28:01 +00:00
pipe.go
pipe_test.go
platform_test.go all: gofmt -w -r 'interface{} -> any' src 2021-12-13 18:45:54 +00:00
port.go
port_test.go
port_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
protoconn_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
rawconn.go
rawconn_stub_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
rawconn_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
rawconn_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
rawconn_windows_test.go
sendfile_linux.go
sendfile_stub.go net: do not use sendfile on iOS 2021-12-01 15:58:46 +00:00
sendfile_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
sendfile_unix_alt.go net: do not use sendfile on iOS 2021-12-01 15:58:46 +00:00
sendfile_windows.go
server_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
sock_bsd.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sock_cloexec.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sock_linux.go
sock_linux_test.go
sock_plan9.go
sock_posix.go Revert "net: in (*netFD).dial, use the passed in local address if getsockname fails" 2021-12-08 15:31:54 +00:00
sock_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sock_windows.go
sockaddr_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockopt_aix.go
sockopt_bsd.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockopt_linux.go
sockopt_plan9.go
sockopt_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockopt_solaris.go
sockopt_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockopt_windows.go
sockoptip_bsdvar.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockoptip_linux.go
sockoptip_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockoptip_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
sockoptip_windows.go
splice_linux.go
splice_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
splice_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
sys_cloexec.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
tcpsock.go net: add conversion from AddrPort to TCPAddr to complement existing inverse 2021-11-11 11:00:33 +00:00
tcpsock_plan9.go
tcpsock_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
tcpsock_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
tcpsock_unix_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
tcpsockopt_darwin.go
tcpsockopt_dragonfly.go
tcpsockopt_openbsd.go
tcpsockopt_plan9.go
tcpsockopt_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
tcpsockopt_solaris.go
tcpsockopt_stub.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
tcpsockopt_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
tcpsockopt_windows.go
timeout_test.go net: increase timing slop in TimeoutFluctuation tests on NetBSD and OpenBSD 2021-12-15 22:33:52 +00:00
udpsock.go net: do more faithful conversion from AddrPort to UDPAddr 2021-11-10 22:16:25 +00:00
udpsock_plan9.go net: add ReadFromUDPAddrPort 2021-11-02 18:35:35 +00:00
udpsock_plan9_test.go
udpsock_posix.go net: pass around pointers to SockaddrInetN 2021-11-04 21:52:36 +00:00
udpsock_test.go net: remove an arbitrary timeout in TestUDPReadSizeError 2022-02-03 05:57:46 +00:00
unixsock.go
unixsock_linux_test.go
unixsock_plan9.go
unixsock_posix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
unixsock_readmsg_cloexec.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
unixsock_readmsg_cmsg_cloexec.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
unixsock_readmsg_other.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
unixsock_readmsg_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
unixsock_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
unixsock_windows_test.go net: create unix sockets in unique directories 2021-12-13 16:42:31 +00:00
write_unix_test.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00
writev_test.go net: pass a testing.TB to newLocal* helpers 2021-12-13 16:42:23 +00:00
writev_unix.go all: go fix -fix=buildtag std cmd (except for bootstrap deps, vendor) 2021-10-28 18:17:57 +00:00