- [Improvement]: updated dependencies, test with Go 1.20.
- [Bug Fix]: test only changes to avoid failures on big endian machines.
This is the first release of package netlink that only supports Go 1.18+. Users on older versions of Go must use v1.6.2.
- [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 netlink that supports Go 1.17 and below.
- [Bug Fix] commit:
undo update to
golang.org/x/sys
which would force the minimum Go version of this package to Go 1.17 due to use ofunsafe.Slice
. We encourage users to use the latest stable version of Go where possible, but continue to maintain some compatibility with older versions of Go as long as it is reasonable to do so.
- [Deprecation] commit:
the
netlink.Socket
interface has been marked as deprecated. The abstraction is awkward to use properly and disables much of the functionality of the Conn type when the basic interface is implemented. Do not use.
This is the first release of package netlink that only supports Go 1.13+. Users on older versions of Go must use v1.5.0.
- [New API] commit:
the
netlink.Config.Strict
field can be used to apply a more strict default set of options to anetlink.Conn
. This is recommended for applications running on modern Linux kernels, but cannot be enabled by default because the options may require a more recent kernel than the minimum kernel version that Go supports. See the documentation for details. - [Improvement]: broke some integration tests into a separate Go module so the
default
go.mod
for packagenetlink
has fewer dependencies.
This is the last release of package netlink that supports Go 1.12.
- [New API] commit:
the
netlink.Config.PID
field can be used to specify an explicit port ID when binding the netlink socket. This is intended for advanced use cases and most callers should leave this field set to 0. - [Improvement]: more low-level functionality ported to
github.com/mdlayher/socket
, reducing package complexity.
- [Documentation] commit:
the
netlink.Config.DisableNSLockThread
now properly uses Go's deprecated identifier convention. This option has been a noop for a long time and should not be used. - [Improvement] #189: the
package now uses Go 1.17's
//go:build
identifiers. Thanks @tklauser. - [Bug Fix]
commit:
the
netlink.AttributeEncoder
'sBytes
,String
, andDo
methods now properly reject byte slices and strings which are too large to fit in the value of a netlink attribute. Thanks @ubiquitousbyte for the report.
- [Improvement]: significant runtime network poller integration cleanup through
the use of
github.com/mdlayher/socket
.
- [New API] #185: the
netlink.AttributeDecoder
andnetlink.AttributeEncoder
types now have methods for dealing with signed integers:Int8
,Int16
,Int32
, andInt64
. These are necessary for working with rtnetlink's XDP APIs. Thanks @fbegyn.
- [Improvement]
commit:
github.com/google/go-cmp
is no longer a (non-test) dependency of this module.
- [Improvement]: many internal cleanups and simplifications. The library is now slimmer and features less internal indirection. There are no user-facing changes in this release.
- [New API] #176:
netlink.OpError
now hasMessage
andOffset
fields which are populated when the kernel returns netlink extended acknowledgement data along with an error code. The caller can turn on this option by usingnetlink.Conn.SetOption(netlink.ExtendedAcknowledge, true)
. - [New API]
commit:
the
netlink.GetStrictCheck
option can be used to tell the kernel to be more strict when parsing requests. This enables more safety checks and can allow the kernel to perform more advanced request filtering in subsystems such as route netlink.
- [Bug Fix]
commit:
netlink.SetBPF
will no longer panic if an empty BPF filter is set. - [Improvement] commit: the library now uses https://github.com/josharian/native to provide the system's native endianness at compile time, rather than re-computing it many times at runtime.
This is the first release of package netlink that only supports Go 1.12+. Users on older versions of Go must use v1.1.1.
- [Improvement] #173: support for Go 1.11 and below has been dropped. All users are highly recommended to use a stable and supported release of Go for their applications.
- [Performance] #171:
netlink.Conn
no longer requires a locked OS thread for the vast majority of operations, which should result in a significant speedup for highly concurrent callers. Thanks @ti-mo. - [Bug Fix] #169: calls to
netlink.Conn.Close
are now able to unblock concurrent calls tonetlink.Conn.Receive
and other blocking operations.
This is the last release of package netlink that supports Go 1.11.
- [Improvement] #165:
netlink.Conn
SetReadBuffer
andSetWriteBuffer
methods now attempt theSO_*BUFFORCE
socket options to possibly ignore system limits given elevated caller permissions. Thanks @MarkusBauer. - [Note]
commit:
netlink.Conn.Close
has had a long-standing bug #162 related to internal concurrency handling where a call toClose
is not sufficient to unblock pending reads. To effectively fix this issue, it is necessary to drop support for Go 1.11 and below. This will be fixed in a future release, but a workaround is noted in the method documentation as of now.
- [New API] #157: the
netlink.AttributeDecoder.TypeFlags
method enables retrieval of the type bits stored in a netlink attribute's type field, because the existingType
method masks away these bits. Thanks @ti-mo! - [Performance] #157:
netlink.AttributeDecoder
now decodes netlink attributes on demand, enabling callers who only need a limited number of attributes to exit early from decoding loops. Thanks @ti-mo! - [Improvement] #161:
netlink.Conn
system calls are now ready for Go 1.14+'s changes to goroutine preemption. See the PR for details.
- Initial stable commit.