CHANGELOG

v0.5.0

This is the first release of package socket that only supports Go 1.21+. Users on older versions of Go must use v0.4.1.

[Improvement]: drop support for older versions of Go.
[New API]: add socket.Conn wrappers for various Getsockopt and Setsockopt system calls.

[Bug Fix] commit: ensure socket.Conn can be used with non-socket file descriptors by handling ENOTSOCK in the constructor.

This is the first release of package socket that only supports Go 1.18+. Users on older versions of Go must use v0.3.0.

[Improvement]: drop support for older versions of Go so we can begin using modern versions of x/sys and other dependencies.

This is the last release of package socket that supports Go 1.17 and below.

[New API/API change] PR: numerous socket.Conn methods now support context cancelation. Future releases will continue adding support as needed.
- New ReadContext and WriteContext methods.
- Connect, Recvfrom, Recvmsg, Sendmsg, and Sendto methods now accept a context.
- Sendto parameter order was also fixed to match the underlying syscall.

[New API] commit: socket.Conn has new Pidfd* methods for wrapping the pidfd_*(2) family of system calls.

[New API] commit: socket.Conn has new IoctlKCM* methods for wrapping ioctl(2) for AF_KCM operations.

[New API] commit: socket.Conn has a new SetsockoptPacketMreq method for wrapping setsockopt(2) for AF_PACKET socket options.

[New API] commit: socket.FileConn can be used to create a socket.Conn from an existing os.File, which may be provided by systemd socket activation or another external mechanism.
[API change] commit: socket.Conn.Connect now returns the unix.Sockaddr value provided by getpeername(2), since we have to invoke that system call anyway to verify that a connection to a remote peer was successfully established.
[Bug Fix] commit: check the correct error from unix.GetsockoptInt in the socket.Conn.Connect method. Thanks @vcabbage!

[Bug Fix]: socket.Conn.Connect now properly checks the SO_ERROR socket option value after calling connect(2) to verify whether or not a connection could successfully be established. This means that Connect should now report an error for an AF_INET TCP connection refused or AF_VSOCK connection reset by peer.
[New API]: add socket.Conn.Getpeername for use in Connect, but also for use by external callers.

[New API]: socket.Conn now has CloseRead, CloseWrite, and Shutdown methods.
[Improvement]: internal rework to more robustly handle various errors.

Initial unstable release. Most functionality has been developed and ported from package netlink.