1# CHANGELOG
2
3## v0.4.1
4
5- [Bug Fix] [commit](https://github.com/mdlayher/socket/commit/2a14ceef4da279de1f957c5761fffcc6c87bbd3b):
6 ensure `socket.Conn` can be used with non-socket file descriptors by handling
7 `ENOTSOCK` in the constructor.
8
9## v0.4.0
10
11**This is the first release of package socket that only supports Go 1.18+.
12Users on older versions of Go must use v0.3.0.**
13
14- [Improvement]: drop support for older versions of Go so we can begin using
15 modern versions of `x/sys` and other dependencies.
16
17## v0.3.0
18
19**This is the last release of package socket that supports Go 1.17 and below.**
20
21- [New API/API change] [PR](https://github.com/mdlayher/socket/pull/8):
22 numerous `socket.Conn` methods now support context cancelation. Future
23 releases will continue adding support as needed.
24 - New `ReadContext` and `WriteContext` methods.
25 - `Connect`, `Recvfrom`, `Recvmsg`, `Sendmsg`, and `Sendto` methods now accept
26 a context.
27 - `Sendto` parameter order was also fixed to match the underlying syscall.
28
29## v0.2.3
30
31- [New API] [commit](https://github.com/mdlayher/socket/commit/a425d96e0f772c053164f8ce4c9c825380a98086):
32 `socket.Conn` has new `Pidfd*` methods for wrapping the `pidfd_*(2)` family of
33 system calls.
34
35## v0.2.2
36
37- [New API] [commit](https://github.com/mdlayher/socket/commit/a2429f1dfe8ec2586df5a09f50ead865276cd027):
38 `socket.Conn` has new `IoctlKCM*` methods for wrapping `ioctl(2)` for `AF_KCM`
39 operations.
40
41## v0.2.1
42
43- [New API] [commit](https://github.com/mdlayher/socket/commit/b18ddbe9caa0e34552b4409a3aa311cb460d2f99):
44 `socket.Conn` has a new `SetsockoptPacketMreq` method for wrapping
45 `setsockopt(2)` for `AF_PACKET` socket options.
46
47## v0.2.0
48
49- [New API] [commit](https://github.com/mdlayher/socket/commit/6e912a68523c45e5fd899239f4b46c402dd856da):
50 `socket.FileConn` can be used to create a `socket.Conn` from an existing
51 `os.File`, which may be provided by systemd socket activation or another
52 external mechanism.
53- [API change] [commit](https://github.com/mdlayher/socket/commit/66d61f565188c23fe02b24099ddc856d538bf1a7):
54 `socket.Conn.Connect` now returns the `unix.Sockaddr` value provided by
55 `getpeername(2)`, since we have to invoke that system call anyway to verify
56 that a connection to a remote peer was successfully established.
57- [Bug Fix] [commit](https://github.com/mdlayher/socket/commit/b60b2dbe0ac3caff2338446a150083bde8c5c19c):
58 check the correct error from `unix.GetsockoptInt` in the `socket.Conn.Connect`
59 method. Thanks @vcabbage!
60
61## v0.1.2
62
63- [Bug Fix]: `socket.Conn.Connect` now properly checks the `SO_ERROR` socket
64 option value after calling `connect(2)` to verify whether or not a connection
65 could successfully be established. This means that `Connect` should now report
66 an error for an `AF_INET` TCP connection refused or `AF_VSOCK` connection
67 reset by peer.
68- [New API]: add `socket.Conn.Getpeername` for use in `Connect`, but also for
69 use by external callers.
70
71## v0.1.1
72
73- [New API]: `socket.Conn` now has `CloseRead`, `CloseWrite`, and `Shutdown`
74 methods.
75- [Improvement]: internal rework to more robustly handle various errors.
76
77## v0.1.0
78
79- Initial unstable release. Most functionality has been developed and ported
80from package [`netlink`](https://github.com/mdlayher/netlink).
View as plain text