chore(deps): update module github.com/cilium/ebpf to v0.20.0 #135
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
v0.16.0->v0.20.0Warning
Some dependencies could not be looked up. Check the warning logs for more information.
Release Notes
cilium/ebpf (github.com/cilium/ebpf)
v0.20.0Compare Source
Performance Improvements
New Features
LoadSplitSpecfunction for easier use of split-BTF filesDetach()method for explicitly detaching linksmap_extrafield in MapSpec (enables bloom filter configuration)ExtraRelocationTargetsccache clang)ErrRestrictedKernelwhen reading zero addresses due tokernel.kptr_restrictErrRestrictedKernelwhen program info is restricted by kernel security settingsErrRestrictedKernelduring ksym resolution unless ksyms are requiredBugfixes
*Memoryinstead of**Memoryto fix resource leakWindows Support Improvements
Breaking Changes
ProgramOptions.KernelModuleTypes removed
The
KernelModuleTypesfield inProgramOptionshas been removed. In 99% of cases this field should not be necessary anymore. Module BTF should be merged into the vmlinux BTF, as tools like btfhub do.For advanced use cases that still require passing additional BTF specs for CO-RE relocations, use the new
ExtraRelocationTargetsfield:Before:
After:
btf.Cache fields unexported
The
KernelTypes,ModuleTypes, andLoadedModulesfields inbtf.Cachehave been unexported. These fields were internal implementation details and should not have been accessed directly. Users should continue usingbtf.NewCache()to create cache instances - no code changes are needed if you weren't directly accessing these fields.What's Changed
LoadSplitSpecfunction by @tdaudi in #1819BPF2GO_CCby @jrife in #1829go toolinstead ofgo runingo:generatestatements by @ti-mo in #1875ErrRestrictedKernelwhen kernel pointers are restricted using sysctls by @dylandreimerink in #1858New Contributors
Full Changelog: cilium/ebpf@v0.19.0...v0.20.0
v0.19.0Compare Source
Major Performance Improvements
This release includes significant performance optimizations across multiple areas:
Program.Stats()method allows querying runtime statistics without fetching full ProgramInfoCO-RE Improvements
Build System and Toolchain Updates
Enhanced Map Support
MapSpec.Tagsfield for readingbtf_decl_tagattributes set on mapsBPF_F_NO_PREALLOChints and warnings for map types that require this flagAssembly and Instruction Handling
Memory and Variable Access
VariableandMemorytypesWindows Support Improvements
Bug Fixes
BatchLookupandBatchLookupDelete(#1741)InvalidOpCodeforStoreImmwithDWordsize (#1767)WalkDirharder to misuse and added Windows support (#1652)structs.HostLayoutin GoFormatter (#1686)Compatibility Notes
What's Changed
New{Map,Program}From{ID,FD}andLoadPinned{Map,Program}by @ti-mo in #1791loadMapsif ELF file has no BTF by @paulcacheux in #1807/sys/kernel/btfby @paulcacheux in #1813New Contributors
Full Changelog: cilium/ebpf@v0.18.0...v0.19.0
v0.18.0Compare Source
Initial Windows Support
This release adds support for eBPF on Windows through the eBPF for Windows runtime. Users must run a recent build of the
mainbranch of eBPF for Windows, version 0.20.0 is not supported.See the documentation and how to contribute to the Windows port.
Supported:
Not supported:
The Windows port is still very new and won't be as performant or stable as the Linux part of the code base. There is also no guarantee of stability at the moment.
Build System Improvements
-verboseflag to bpf2go and gentypes toolsV=environment variableDocumentation
Bugfixes
Breaking Changes
ebpf:
SanitizeNamefunction. Map and program names are now automatically sanitized.What's Changed
binary.Readwithbinary.Decodeinsysenc.Unmarshalby @kolesnikovae in #1713New Contributors
Full Changelog: cilium/ebpf@v0.17.3...v0.18.0
v0.17.3Compare Source
Fixes for a data race in
btf.Spec.Copy(thanks @paulcacheux) and a buffer overflow when running 32-bit user space on a 64-bit kernel (thanks @kolyshkin).What's Changed
unix.Auxvby @tklauser in #1665parseLineInfoRecordsby @paulcacheux in #1657(*mutableTypes).copyby @paulcacheux in #1673Full Changelog: cilium/ebpf@v0.17.2...v0.17.3
v0.17.2Compare Source
Another minor release to ship some bug fixes, notably for attaching bpf programs to symbols in kernel modules, and for reusing data sections across multiple Collections.
All users are encouraged to upgrade!
Features
Bug Fixes
Other Changes
flattenInstructionsby @paulcacheux in #1647Thanks to all who contributed and reported issues!
Full Changelog: cilium/ebpf@v0.17.1...v0.17.2
v0.17.1: Hotfix: don't retry endlessly on verifier errors on kernels <6.4Compare Source
During the prior removal of
ProgramOptions.LogSizein v0.16, the tests weren't updated to exercise the retry logic. With the last-minute addition ofProgramOptions.LogSizeStart, a bug was introduced that would cause program loads to retry indefinitely without ever growing the buffer in case of a verifier error on kernels before 6.4. This is now fixed, and the tests were updated to exercise the retry logic.v0.17.0: Global Variables, Decl Tags, and packagepinCompare Source
Note: the hotfix release 0.17.1 is out. Users are highly encouraged to upgrade.
As we close the door on the year 2024, we're also wrapping up the ebpf-go v0.17 development cycle. This release represents a large body of work and is our largest feature release since BTF.
Users are, as always, highly encouraged to upgrade, and we're looking forward to hearing your feedback on the new Global Variables API. We've been putting this interface trough its paces internally, along with a few eager community members, and we're ready to let the wider community make use of it.
This release also marks the end of our Go 1.21 support; Go 1.22 is required going forward.
Breaking Changes
Before we get to the fun stuff, we need to call out a few breaking changes:
Global variables with a
staticqualifier can no longer be rewritten usingCollectionSpec.RewriteConstants()! See the section on global variables under major features below.program: remove LogSize and VerifierError.Truncated by @lmb in #1526
prog: add ProgramOptions.LogSizeStart to obtain full log after verifier bug by @ti-mo in #1630
The
ProgramOptions.LogSizefield was deprecated and a no-op since 0.16 and has now been removed completely. In its place, a new field was added to obtain full verifier logs when the verifier hits an internal bug. TheProgramOptions.LogSizeStartfield controls the starting size of the log buffer. Use this if you have a good understanding of the log size you're expecting, or if you're trying to pull out the full log when the verifier hits an internal bug. The error string now also contains some hints about what happened and how to handle this situation.map: remove MapSpec.Freeze field by @ti-mo in #1558
elf_reader: don't use BPF_F_RDONLY_PROG flag to trigger map freezing by @ti-mo in #1568
The Freeze field was ambiguous from the start, and has been a source of subtle bugs over the years. Automatic map freezing is now done based solely on map name (.(ro)data prefix). If you were manually setting this flag, consider using a conventional map name instead.
info: expose ksym info and func info by ProgramInfo by @Asphaltt in #1576
info: expose more prog jited info by @Asphaltt in #1598
Some ext_info types in package btf were redefined to enable pulling raw func and line infos out of
Program.Info(). These were all types without methods and all unexported fields, but calling them out regardless in case someone's doingunintendedadvanced things with BTF.kallsyms: change Modules caching strategy, cache address lookups by @ti-mo in #1590
Users attaching bpf programs to kernel symbols should see a marked decrease in allocations made in the library during program creation in the general case. Only used entries are now cached, making kallsyms lookups on subsequent program loads free. In the pathological case (new kernel symbols on every load), scanning is repeated, resulting in more CPU time being used instead of holding on to all kallsyms symbols indefinitely.
ProgramSpec.KernelModule()was unexported until further notice.Also, bpf2go users should now be able to generate Go bindings as unprivileged users once again. Oops!
Major Features
Easy global variables: introducing
ebpf.VariableSpecandebpf.VariableThis has been a frequent ask in the community for years, so we finally bit the bullet and committed to an API to interact with global bpf variables through
CollectionSpec.VariablesandCollectionSpec.Variables. We've published a small guide over on ebpf-go.dev/concepts/global-variables that details how to use them, so we're not going to reiterate here.See the documentation on the use of the
staticqualifier! These are no longer considered global variables, and can't be modified at runtime.bpf2go now also generates objects to be used with
CollectionSpec.Assignand.LoadAndAssign(), and also emits Go type declarations for C types used as bpf C variables. Our test coverage was somewhat lacking for the latter, please drop something on the issue tracker if you're noticing surprising bpf2go output.Note that it's currently not possible to manually create a
VariableSpecand wire it up to aCollectionSpec, so if you were previously relying on e.g. manually assembling aCollectionSpecand usingRewriteConstants()in tests, this will no longer work. This may land as the API crystallizes and we settle on a good mechanism to enable this. Please reach out on the Cilium Slack if you'd like to see this happen.Tags!
As you'll notice, the
btf.Struct,btf.Union,btf.Member,btf.Typedef,btf.Funcandbtf.Varhave gained a new field:Tags! Set one or more tags on these objects from bpf C using__attribute__((btf_decl_tag("mytag")))andyou'll find
Tagsbeing populated in Go.There's also the
btf.Func.ParamTagsfield that holds tags declared on individual function parameters. These are part of theFuncsince they appear only in the function prototype, not in the parameter type itself, since those can appear in many different types. (it does get confusing!)Also, an honorable mention to
btf.TypeTag, which has now been exported. This allows tagging pointers with an arbitrary string value and is mainly used by the Linux verifier to tag kernel pointers, see the__kptrand__kptr_refmacros in Linux'bpf_helpers.h.Pins!
We've added a new root-level package
pin, which currently features theLoad()andWalkDir()functions. Since allLoadPinned*functions in the library now check for the underlying object's type, we've repurposed the machinery to allow loading an opaque pin and returning a Go object of the right type.WalkDirdoes what it says on the tin, it walks bpffs directories and invokes a callback that received the loaded object. Super convenient!Minor Features
We've also added a handful of minor features during this release:
bpf_prog_infofields inProgramInfoby @tyrone-wu in #1512Other Changes
Last but not least, there's bugfixes, CI changes and some internal refactoring that happened to eventually make ebpf-go work with ebpf-for-windows. See individual PRs for more context. Stay tuned!
objNameAllowsDot, return *btf.Var fromVariable{Spec}.Type()by @ti-mo in #1612epoll.Waitby using sentinel errors by @def in #1619New Contributors
Full Changelog: cilium/ebpf@v0.16.0...v0.17.0
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
To execute skipped test pipelines write comment
/ok-to-test.Documentation
Find out how to configure dependency updates in MintMaker documentation or see all available configuration options in Renovate documentation.