Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.13.1 (2024-11-01)

Chore

Add comments in *_wrong_map tests
Rename bpf -> ebpf
Fix unused_qualifications lints This was failing the docs build.

Documentation

fix typo
Use Ebpf instead of Bpf

New Features

Implement TCX This commit adds the initial support for TCX bpf links. This is a new, multi-program, attachment type allows for the caller to specify where they would like to be attached relative to other programs at the attachment point using the LinkOrder type.
Provide a deprecated BpfError alias
Rename Bpf to Ebpf And BpfLoader to EbpfLoader. This also adds type aliases to preserve the use of the old names, making updating to a new Aya release less of a burden. These aliases are marked as deprecated since we'll likely remove them in a later release.

Bug Fixes

Fill bss maps with zeros The loader should fill bss maps with zeros according to the size of the ELF section. Failure to do so yields weird verifier messages as follows:
```
cannot access ptr member ops with moff 0 in struct bpf_map with off 0 size 4
```

Reference to this in the cilium/ebpf code is here [1]. I could not find a reference in libbpf.

Fix PerfEventArray resize logic There was a logic bug in the previously merged patch where we set the correctly calculated max_entries size with the original.

To fix this and prevent regressions a unit test was added. This highlighted that the original map definition needs to be mutated in order for the max_entries change to be properly applied.

As such, this resize logic moved out of aya::sys into aya::maps

Set PerfEventArray max_entries to nCPUs Both libbpf and cilium/ebpf have will set the max_entries of a BPF_MAP_TYPE_PERF_EVENT_ARRAY to the number of online CPUs if it was omitted at map definition time. This adds that same logic to Aya.
fix panic when creating map on custom ubuntu kernel
fix rustdocs-args ordering in taplo to -D warnings This fixes the current rustdoc build error by correcting the ordering of rustdoc-args to -D warnings. Additionally, this also removes the recorder_arrays field (defaults to false) so that the order is not modified, which is what caused the error in the first place.

Other

use FdLink in SockOps programs
remove unwrap and NonZero* in info Addresses the feedback from #1007:
- remove panic from unwrap and expect
- Option => Option with 0 mapping to None
- revamp MapInfo be more friendly with older kernels Adds detection for whether a field is available in MapInfo:
  - For map_type(), we treturn new enum MapType instead of the integer representation.
  - For fields that can't be zero, we return Option<NonZero*> type.
  - For name_as_str(), it now uses the feature probe bpf_name() to detect if field is available. Although the feature probe checks for program name, it can also be used for map name since they were both introduced in the same commit.
- revamp ProgramInfo be more friendly with older kernels Purpose of this commit is to add detections for whether a field is available in ProgramInfo.
  - For program_type(), we return the new enum ProgramType instead of the integer representation.
  - For fields that we know cannot be zero, we return Option<NonZero*> type.
  - For name_as_str(), it now also uses the feature probe bpf_name() to detect if field is available or not.
  - Two additional feature probes are added for the fields:
    - prog_info_map_ids() probe -> map_ids() field
    - prog_info_gpl_compatible() probe -> gpl_compatible() field
With the prog_info_map_ids() probe, the previous implementation that I had for bpf_prog_get_info_by_fd() is shortened to use the probe instead of having to make 2 potential syscalls.

The test_loaded_at() test is also moved into info tests since it is better related to the info tests.
- add conversion u32 to enum type for prog, link, & attach type Add conversion from u32 to program type, link type, and attach type. Additionally, remove duplicate match statement for u32 conversion to BPF_MAP_TYPE_BLOOM_FILTER & BPF_MAP_TYPE_CGRP_STORAGE.
New error InvalidTypeBinding<T> is created to represent when a parsed/received value binding to a type is invalid. This is used in the new conversions added here, and also replaces InvalidMapTypeError in TryFrom for bpf_map_type.
- improve integration tests for info API Improves the existing integraiton tests for loaded_programs() and loaded_maps() in consideration for older kernels:
  - Opt for SocketFilter program in tests since XDP requires v4.8 and fragments requires v5.18.
  - For assertion tests, first perform the assertion, if the assertion fails, then it checks the host kernel version to see if it is above the minimum version requirement. If not, then continue with test, otherwise fail. For assertions that are skipped, they're logged in stderr which can be observed with -- --nocapture.
This also fixes the bpf_prog_get_info_by_fd() call for kernels below v4.15. If calling syscall on kernels below v4.15, it can produce an E2BIG error because check_uarg_tail_zero() expects the entire struct to all-zero bytes (which is caused from the map info).

Instead, we first attempt the syscall with the map info filled, if it returns E2BIG, then perform syscall again with empty closure.

Also adds doc for which version a kernel feature was introduced for better awareness.

The tests have been verified kernel versions:
```
 - 4.13.0
 - 4.15.0
 - 6.1.0
```
- adjust bpf programs for big endian In aya/src/sys/bpf.rs, there are several simple bpf programs written as byte arrays. These need to be adjusted to account for big endian.
- expose run_time_ns and run_cnt fields in ProgramInfo Added functions to expose run_time_ns & run_cnt statistics from ProgramInfo/bpf_prog_info.
- add BPF_ENABLE_STATS syscall function Add bpf syscall function for BPF_ENABLE_STATS to enable stats tracking for benchmarking purposes.
Additionally, move #[cfg(test)] annotation around the Drop trait instead. Having separate functions causes some complications when needing ownership/moving of the inner value OwnedFd when Drop is manually implemented.
- :programs::uprobe: fix bad variable name The variable fn_name was very much not the fn_name, but rather the object file path.
- adjust symbol lookup tests for object crate alignment requirements The object::File::parse API requires parameter to be aligned with 8 bytes. Adjusted the Vec in the tests with miri to meet this requirement.
- add symbol lookup in associated debug files This change enhances the logic for symbol lookup in uprobe or uretprobe. If the symbol is not found in the original binary, the search continues in the debug file associated through the debuglink section. Before searching the symbol table, it compares the build IDs of the two files. The symbol lookup will only be terminated if both build IDs exist and do not match. This modification does not affect the existing symbol lookup logic.
- Generate new bindings
- include license in crate workspace This PR includes the licenses files in the crate workspace subdirectory. Without this, they won't be showing on crates.io and would be giving out errors on tooling such as rust2rpm.
- appease new nightly clippy lints
```
 error: unnecessary qualification
    --> aya/src/maps/ring_buf.rs:434:22
     |
 434 |                 ptr: ptr::NonNull::new(ptr).ok_or(
     |                      ^^^^^^^^^^^^^^^^^
     |
 note: the lint level is defined here
    --> aya/src/lib.rs:72:5
     |
 72  |     unused_qualifications,
     |     ^^^^^^^^^^^^^^^^^^^^^
 help: remove the unnecessary path segments
     |
 434 -                 ptr: ptr::NonNull::new(ptr).ok_or(
 434 +                 ptr: NonNull::new(ptr).ok_or(
     |
   
 error: unnecessary qualification
    --> aya/src/maps/mod.rs:225:21
     |
 225 |     let mut limit = std::mem::MaybeUninit::<rlimit>::uninit();
     |                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     |
 help: remove the unnecessary path segments
     |
 225 -     let mut limit = std::mem::MaybeUninit::<rlimit>::uninit();
 225 +     let mut limit = mem::MaybeUninit::<rlimit>::uninit();
     |
   
 error: unnecessary qualification
    --> aya/src/programs/mod.rs:614:9
     |
 614 |         crate::obj::Program {
     |         ^^^^^^^^^^^^^^^^^^^
     |
 help: remove the unnecessary path segments
     |
 614 -         crate::obj::Program {
 614 +         obj::Program {
     |
   
 error: unnecessary qualification
    --> aya/src/util.rs:373:14
     |
 373 |     unsafe { std::slice::from_raw_parts(bpf_name.as_ptr() as
     *const _, length) }
     |              ^^^^^^^^^^^^^^^^^^^^^^^^^^
     |
 help: remove the unnecessary path segments
     |
 373 -     unsafe { std::slice::from_raw_parts(bpf_name.as_ptr() as
     *const _, length) }
 373 +     unsafe { slice::from_raw_parts(bpf_name.as_ptr() as *const _,
     length) }
     |
   
 error: unnecessary qualification
     --> aya/src/maps/mod.rs:1130:47
      |
 1130 |                     .copy_from_slice(unsafe {
      std::mem::transmute(TEST_NAME) });
      |                                               ^^^^^^^^^^^^^^^^^^^
      |
 note: the lint level is defined here
     --> aya/src/lib.rs:72:5
      |
 72   |     unused_qualifications,
      |     ^^^^^^^^^^^^^^^^^^^^^
 help: remove the unnecessary path segments
      |
 1130 -                     .copy_from_slice(unsafe {
      std::mem::transmute(TEST_NAME) });
 1130 +                     .copy_from_slice(unsafe {
      mem::transmute(TEST_NAME) });
      |
```
Performance
- cache nr_cpus in a thread_local
Test
- adjust test byte arrays for big endian Adding support for s390x (big endian architecture) and found that some of the unit tests have structures and files implemented as byte arrays. They are all coded as little endian and need a bug endian version to work properly.
New Features (BREAKING)
- Rename BpfRelocationError -> EbpfRelocationError
- Rename BpfSectionKind to EbpfSectionKind
Commit Statistics
- 69 commits contributed to the release over the course of 241 calendar days.
- 247 days passed between releases.
- 32 commits were understood as conventional.
- 0 issues like '(#ID)' were seen in commit messages
Commit Details

view details
* **Uncategorized** - Release aya-obj v0.2.1 ([`c6a34ca`](https://github.com/aya-rs/aya/commit/c6a34cade1)) - Merge pull request #1073 from dave-tucker/reloc-bug ([`b2ac9fe`](https://github.com/aya-rs/aya/commit/b2ac9fe85d)) - Fill bss maps with zeros ([`ca0c32d`](https://github.com/aya-rs/aya/commit/ca0c32d107)) - Release aya-obj v0.2.0, aya v0.13.0, safety bump aya v0.13.0 ([`c169b72`](https://github.com/aya-rs/aya/commit/c169b727e6)) - Implement TCX ([`5478cac`](https://github.com/aya-rs/aya/commit/5478cac008)) - Cache `nr_cpus` in a thread_local ([`d05110f`](https://github.com/aya-rs/aya/commit/d05110fd86)) - Clarify `Arc` usage ([`afd777b`](https://github.com/aya-rs/aya/commit/afd777b705)) - Replace `Arc` with `&'static` ([`e992c28`](https://github.com/aya-rs/aya/commit/e992c280cb)) - Avoid intermediate allocations in parse_cpu_ranges ([`0e86757`](https://github.com/aya-rs/aya/commit/0e867572ff)) - Reduce duplication in `{nr,possible}_cpus` ([`f3b2744`](https://github.com/aya-rs/aya/commit/f3b2744072)) - Replace `lazy_static` with `std::sync::LazyLock` ([`2b299d4`](https://github.com/aya-rs/aya/commit/2b299d4fba)) - Appease clippy ([`0f16363`](https://github.com/aya-rs/aya/commit/0f163633e3)) - Merge pull request #1023 from l2dy/fdlink/sockops ([`2cd3576`](https://github.com/aya-rs/aya/commit/2cd35769dc)) - Use FdLink in SockOps programs ([`c44f8b0`](https://github.com/aya-rs/aya/commit/c44f8b0f5b)) - Remove unwrap and NonZero* in info ([`02d1db5`](https://github.com/aya-rs/aya/commit/02d1db5fc0)) - Merge pull request #985 from reyzell/main ([`40f3032`](https://github.com/aya-rs/aya/commit/40f303205f)) - Add the option to support multiple and overrideable programs per cgroup ([`f790685`](https://github.com/aya-rs/aya/commit/f790685d75)) - Merge pull request #1007 from tyrone-wu/aya/info-api ([`15eb935`](https://github.com/aya-rs/aya/commit/15eb935bce)) - Revamp MapInfo be more friendly with older kernels ([`fbb0930`](https://github.com/aya-rs/aya/commit/fbb09304a2)) - Revamp ProgramInfo be more friendly with older kernels ([`88f5ac3`](https://github.com/aya-rs/aya/commit/88f5ac3114)) - Add conversion u32 to enum type for prog, link, & attach type ([`1634fa7`](https://github.com/aya-rs/aya/commit/1634fa7188)) - Improve integration tests for info API ([`cb8e478`](https://github.com/aya-rs/aya/commit/cb8e478800)) - Merge pull request #959 from tyrone-wu/aya/program_info_stats ([`ab000ad`](https://github.com/aya-rs/aya/commit/ab000ad7c3)) - Merge pull request #974 from Billy99/billy99-arch-ppc64-s390x ([`ab5e688`](https://github.com/aya-rs/aya/commit/ab5e688fd4)) - Adjust bpf programs for big endian ([`cd1db86`](https://github.com/aya-rs/aya/commit/cd1db86fd4)) - Adjust test byte arrays for big endian ([`eef7346`](https://github.com/aya-rs/aya/commit/eef7346fb2)) - Simplify doctest ([`4362020`](https://github.com/aya-rs/aya/commit/4362020691)) - Appease nightly clippy ([`bce3c4f`](https://github.com/aya-rs/aya/commit/bce3c4fb1d)) - Expose run_time_ns and run_cnt fields in ProgramInfo ([`a25f501`](https://github.com/aya-rs/aya/commit/a25f501ece)) - Add BPF_ENABLE_STATS syscall function ([`fa6af6a`](https://github.com/aya-rs/aya/commit/fa6af6a204)) - Fix PerfEventArray resize logic ([`3d57d35`](https://github.com/aya-rs/aya/commit/3d57d358e4)) - Add comments in `*_wrong_map` tests ([`e575712`](https://github.com/aya-rs/aya/commit/e575712c59)) - Set PerfEventArray max_entries to nCPUs ([`25d986a`](https://github.com/aya-rs/aya/commit/25d986a26d)) - Use MockableFd everywhere ([`e12fcf4`](https://github.com/aya-rs/aya/commit/e12fcf46cb)) - Merge pull request #991 from l2dy/typo-1 ([`2cd9858`](https://github.com/aya-rs/aya/commit/2cd9858ea9)) - Fix typo ([`f1773d5`](https://github.com/aya-rs/aya/commit/f1773d5af4)) - Merge pull request #983 from ajwerner/fix-variable-name ([`d5414bf`](https://github.com/aya-rs/aya/commit/d5414bf10c)) - :programs::uprobe: fix bad variable name ([`d413e2f`](https://github.com/aya-rs/aya/commit/d413e2f285)) - Fix panic when creating map on custom ubuntu kernel ([`38d8e32`](https://github.com/aya-rs/aya/commit/38d8e32baa)) - Appease clippy ([`78acd74`](https://github.com/aya-rs/aya/commit/78acd74bad)) - Don't deny unused_qualifications ([`781914f`](https://github.com/aya-rs/aya/commit/781914f058)) - Fix rustdocs-args ordering in taplo to -D warnings ([`5e13283`](https://github.com/aya-rs/aya/commit/5e13283f59)) - Remove deny(pointer_structural_match) ([`4e843a3`](https://github.com/aya-rs/aya/commit/4e843a3523)) - Merge pull request #938 from swananan/enhance_urpobe_symbol_lookup ([`bde4b5f`](https://github.com/aya-rs/aya/commit/bde4b5f86b)) - Fix clippy ([`c7898c5`](https://github.com/aya-rs/aya/commit/c7898c596f)) - Adjust symbol lookup tests for object crate alignment requirements ([`462514e`](https://github.com/aya-rs/aya/commit/462514ed4c)) - Add symbol lookup in associated debug files ([`e6e1bfe`](https://github.com/aya-rs/aya/commit/e6e1bfeb58)) - Merge pull request #928 from seanyoung/io-error ([`d0e9b95`](https://github.com/aya-rs/aya/commit/d0e9b95aa5)) - S/MiriSafeFd/MockableFd/ ([`a11b61e`](https://github.com/aya-rs/aya/commit/a11b61ebfd)) - Remove miri ignores ([`cb6d3bd`](https://github.com/aya-rs/aya/commit/cb6d3bd75d)) - Document miri skip reasons ([`35962a4`](https://github.com/aya-rs/aya/commit/35962a4794)) - Avoid crashing under Miri ([`7a7d168`](https://github.com/aya-rs/aya/commit/7a7d16885a)) - Deduplicate test helpers ([`7e1666f`](https://github.com/aya-rs/aya/commit/7e1666fb83)) - Reduce duplication ([`58e154e`](https://github.com/aya-rs/aya/commit/58e154e1bc)) - Expose io_error in SyscallError ([`a6c45f6`](https://github.com/aya-rs/aya/commit/a6c45f61c7)) - Appease clippy ([`09442c2`](https://github.com/aya-rs/aya/commit/09442c2cbe)) - Generate new bindings ([`b06ff40`](https://github.com/aya-rs/aya/commit/b06ff40278)) - Appease clippy ([`0a32dac`](https://github.com/aya-rs/aya/commit/0a32dacd2f)) - Merge pull request #528 from dave-tucker/rename-all-the-things ([`63d8d4d`](https://github.com/aya-rs/aya/commit/63d8d4d34b)) - Include license in crate workspace ([`a4e68eb`](https://github.com/aya-rs/aya/commit/a4e68ebdbf)) - Use `Ebpf` instead of `Bpf` ([`57a69fe`](https://github.com/aya-rs/aya/commit/57a69fe9d2)) - Provide a deprecated `BpfError` alias ([`110a76c`](https://github.com/aya-rs/aya/commit/110a76cb9a)) - Rename Bpf to Ebpf ([`8c79b71`](https://github.com/aya-rs/aya/commit/8c79b71bd5)) - Rename BpfRelocationError -> EbpfRelocationError ([`fd48c55`](https://github.com/aya-rs/aya/commit/fd48c55466)) - Rename BpfSectionKind to EbpfSectionKind ([`cf3e2ca`](https://github.com/aya-rs/aya/commit/cf3e2ca677)) - Rename bpf -> ebpf ([`70ac91d`](https://github.com/aya-rs/aya/commit/70ac91dc1e)) - Fix unused_qualifications lints ([`481b73b`](https://github.com/aya-rs/aya/commit/481b73b6d8)) - Add `CgroupDevice::query` ([`542306d`](https://github.com/aya-rs/aya/commit/542306d295)) - Appease new nightly clippy lints ([`e38eac6`](https://github.com/aya-rs/aya/commit/e38eac6352))

0.13.0 (2024-10-09)

Chore
- Add comments in *_wrong_map tests
- Rename bpf -> ebpf
- Fix unused_qualifications lints This was failing the docs build.
Documentation
- fix typo
- Use Ebpf instead of Bpf
New Features
- Implement TCX This commit adds the initial support for TCX bpf links. This is a new, multi-program, attachment type allows for the caller to specify where they would like to be attached relative to other programs at the attachment point using the LinkOrder type.
- Provide a deprecated BpfError alias
- Rename Bpf to Ebpf And BpfLoader to EbpfLoader. This also adds type aliases to preserve the use of the old names, making updating to a new Aya release less of a burden. These aliases are marked as deprecated since we'll likely remove them in a later release.
Bug Fixes
- Fix PerfEventArray resize logic There was a logic bug in the previously merged patch where we set the correctly calculated max_entries size with the original.
To fix this and prevent regressions a unit test was added. This highlighted that the original map definition needs to be mutated in order for the max_entries change to be properly applied.

As such, this resize logic moved out of aya::sys into aya::maps
- Set PerfEventArray max_entries to nCPUs Both libbpf and cilium/ebpf have will set the max_entries of a BPF_MAP_TYPE_PERF_EVENT_ARRAY to the number of online CPUs if it was omitted at map definition time. This adds that same logic to Aya.
- fix panic when creating map on custom ubuntu kernel
- fix rustdocs-args ordering in taplo to -D warnings This fixes the current rustdoc build error by correcting the ordering of rustdoc-args to -D warnings. Additionally, this also removes the recorder_arrays field (defaults to false) so that the order is not modified, which is what caused the error in the first place.
Other
- use FdLink in SockOps programs
- remove unwrap and NonZero* in info Addresses the feedback from #1007:
  - remove panic from unwrap and expect
  - Option => Option with 0 mapping to None
  - revamp MapInfo be more friendly with older kernels Adds detection for whether a field is available in MapInfo:
    - For map_type(), we treturn new enum MapType instead of the integer representation.
    - For fields that can't be zero, we return Option<NonZero*> type.
    - For name_as_str(), it now uses the feature probe bpf_name() to detect if field is available. Although the feature probe checks for program name, it can also be used for map name since they were both introduced in the same commit.
  - revamp ProgramInfo be more friendly with older kernels Purpose of this commit is to add detections for whether a field is available in ProgramInfo.
    - For program_type(), we return the new enum ProgramType instead of the integer representation.
    - For fields that we know cannot be zero, we return Option<NonZero*> type.
    - For name_as_str(), it now also uses the feature probe bpf_name() to detect if field is available or not.
    - Two additional feature probes are added for the fields:
      - prog_info_map_ids() probe -> map_ids() field
      - prog_info_gpl_compatible() probe -> gpl_compatible() field
  With the prog_info_map_ids() probe, the previous implementation that I had for bpf_prog_get_info_by_fd() is shortened to use the probe instead of having to make 2 potential syscalls.
  
  The test_loaded_at() test is also moved into info tests since it is better related to the info tests.
  - add conversion u32 to enum type for prog, link, & attach type Add conversion from u32 to program type, link type, and attach type. Additionally, remove duplicate match statement for u32 conversion to BPF_MAP_TYPE_BLOOM_FILTER & BPF_MAP_TYPE_CGRP_STORAGE.
  New error InvalidTypeBinding<T> is created to represent when a parsed/received value binding to a type is invalid. This is used in the new conversions added here, and also replaces InvalidMapTypeError in TryFrom for bpf_map_type.
  - improve integration tests for info API Improves the existing integraiton tests for loaded_programs() and loaded_maps() in consideration for older kernels:
    - Opt for SocketFilter program in tests since XDP requires v4.8 and fragments requires v5.18.
    - For assertion tests, first perform the assertion, if the assertion fails, then it checks the host kernel version to see if it is above the minimum version requirement. If not, then continue with test, otherwise fail. For assertions that are skipped, they're logged in stderr which can be observed with -- --nocapture.
  This also fixes the bpf_prog_get_info_by_fd() call for kernels below v4.15. If calling syscall on kernels below v4.15, it can produce an E2BIG error because check_uarg_tail_zero() expects the entire struct to all-zero bytes (which is caused from the map info).
  
  Instead, we first attempt the syscall with the map info filled, if it returns E2BIG, then perform syscall again with empty closure.
  
  Also adds doc for which version a kernel feature was introduced for better awareness.
  
  The tests have been verified kernel versions:
```
 - 4.13.0
 - 4.15.0
 - 6.1.0
```
  - adjust bpf programs for big endian In aya/src/sys/bpf.rs, there are several simple bpf programs written as byte arrays. These need to be adjusted to account for big endian.
  - expose run_time_ns and run_cnt fields in ProgramInfo Added functions to expose run_time_ns & run_cnt statistics from ProgramInfo/bpf_prog_info.
  - add BPF_ENABLE_STATS syscall function Add bpf syscall function for BPF_ENABLE_STATS to enable stats tracking for benchmarking purposes.
  Additionally, move #[cfg(test)] annotation around the Drop trait instead. Having separate functions causes some complications when needing ownership/moving of the inner value OwnedFd when Drop is manually implemented.
  - :programs::uprobe: fix bad variable name The variable fn_name was very much not the fn_name, but rather the object file path.
  - adjust symbol lookup tests for object crate alignment requirements The object::File::parse API requires parameter to be aligned with 8 bytes. Adjusted the Vec in the tests with miri to meet this requirement.
  - add symbol lookup in associated debug files This change enhances the logic for symbol lookup in uprobe or uretprobe. If the symbol is not found in the original binary, the search continues in the debug file associated through the debuglink section. Before searching the symbol table, it compares the build IDs of the two files. The symbol lookup will only be terminated if both build IDs exist and do not match. This modification does not affect the existing symbol lookup logic.
  - Generate new bindings
  - include license in crate workspace This PR includes the licenses files in the crate workspace subdirectory. Without this, they won't be showing on crates.io and would be giving out errors on tooling such as rust2rpm.
  - appease new nightly clippy lints
```
 error: unnecessary qualification
    --> aya/src/maps/ring_buf.rs:434:22
     |
 434 |                 ptr: ptr::NonNull::new(ptr).ok_or(
     |                      ^^^^^^^^^^^^^^^^^
     |
 note: the lint level is defined here
    --> aya/src/lib.rs:72:5
     |
 72  |     unused_qualifications,
     |     ^^^^^^^^^^^^^^^^^^^^^
 help: remove the unnecessary path segments
     |
 434 -                 ptr: ptr::NonNull::new(ptr).ok_or(
 434 +                 ptr: NonNull::new(ptr).ok_or(
     |
   
 error: unnecessary qualification
    --> aya/src/maps/mod.rs:225:21
     |
 225 |     let mut limit = std::mem::MaybeUninit::<rlimit>::uninit();
     |                     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     |
 help: remove the unnecessary path segments
     |
 225 -     let mut limit = std::mem::MaybeUninit::<rlimit>::uninit();
 225 +     let mut limit = mem::MaybeUninit::<rlimit>::uninit();
     |
   
 error: unnecessary qualification
    --> aya/src/programs/mod.rs:614:9
     |
 614 |         crate::obj::Program {
     |         ^^^^^^^^^^^^^^^^^^^
     |
 help: remove the unnecessary path segments
     |
 614 -         crate::obj::Program {
 614 +         obj::Program {
     |
   
 error: unnecessary qualification
    --> aya/src/util.rs:373:14
     |
 373 |     unsafe { std::slice::from_raw_parts(bpf_name.as_ptr() as
     *const _, length) }
     |              ^^^^^^^^^^^^^^^^^^^^^^^^^^
     |
 help: remove the unnecessary path segments
     |
 373 -     unsafe { std::slice::from_raw_parts(bpf_name.as_ptr() as
     *const _, length) }
 373 +     unsafe { slice::from_raw_parts(bpf_name.as_ptr() as *const _,
     length) }
     |
   
 error: unnecessary qualification
     --> aya/src/maps/mod.rs:1130:47
      |
 1130 |                     .copy_from_slice(unsafe {
      std::mem::transmute(TEST_NAME) });
      |                                               ^^^^^^^^^^^^^^^^^^^
      |
 note: the lint level is defined here
     --> aya/src/lib.rs:72:5
      |
 72   |     unused_qualifications,
      |     ^^^^^^^^^^^^^^^^^^^^^
 help: remove the unnecessary path segments
      |
 1130 -                     .copy_from_slice(unsafe {
      std::mem::transmute(TEST_NAME) });
 1130 +                     .copy_from_slice(unsafe {
      mem::transmute(TEST_NAME) });
      |
```
  Performance
  - cache nr_cpus in a thread_local
  Test
  - adjust test byte arrays for big endian Adding support for s390x (big endian architecture) and found that some of the unit tests have structures and files implemented as byte arrays. They are all coded as little endian and need a bug endian version to work properly.
  New Features (BREAKING)
  - Rename BpfRelocationError -> EbpfRelocationError
  - Rename BpfSectionKind to EbpfSectionKind
  0.12.0 (2024-02-28)
  
  Chore
  - Use the cargo workspace package table This allows for inheritance of common fields from the workspace root. The following fields have been made common:
    - authors
    - license
    - repository
    - homepage
    - edition
  - Appease clippy unused imports
  - tracefs review fixes
  Chore
  - Don't use path deps in workspace This moves the path dependencies back into the per-crate Cargo.toml. It is required such that the release tooling can correctly calculate which version constraints require changing when we perform a release.
  Documentation
  - Document breaking changes This provides a BREAKING-CHANGES.md that we can populate per-crate. Doing so will allow us to pull this content into our changelog and websites to make things easier for users.
  - Add labels for optional features Following the lead of crates like tokio and nix, we now annotate APIs that require optional features. This helps in cases where a user wants to have an AsyncPerfEventArray which is documented on crates.io, but it's not obvious that you have to enable the async feature.
  - Add crabby logo
  - Document more breaking changes
  - Add CHANGELOG
  New Features
  - get_tracefs function
  Bug Fixes
  - invalid transmute when calling fd Corrent an invalid transmutation for sock_map. fd is already a ref of MapFd, so transmuting &fd to &SockMapFd is equivalent to transmuting &&SockMapFd into &SockMapFd which is buggy.
  - Relax unnecessarily strict atomic ordering on probe event_alias
  - remove useless any all in cfg.
  Other
  - reformat to please rustfmt
  - export some missing modules Previously we were only re-exporting the program types from these, so links and other pub types were not exported.
  - perf_event: add inherit argument to attach()
  - add StackTraceMap::remove()
  - appease new nightly clippy lints
```
 error: this call to `as_ref.map(...)` does nothing
    --> aya/src/bpf.rs:536:30
     |
 536 |                 let btf_fd = btf_fd.as_ref().map(Arc::clone);
     |                              ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ help: try: `btf_fd.clone()`
     |
     = help: for further information visit https://rust-lang.github.io/rust-clippy/master/index.html#useless_asref
 note: the lint level is defined here
    --> aya/src/lib.rs:41:5
     |
 41  |     clippy::all,
     |     ^^^^^^^^^^^
     = note: `#[deny(clippy::useless_asref)]` implied by `#[deny(clippy::all)]`
   
 error: could not compile `aya` (lib) due to 1 previous error
 warning: build failed, waiting for other jobs to finish...
 error: initializer for `thread_local` value can be made `const`
   --> aya/src/sys/fake.rs:14:61
    |
 14 |     pub(crate) static TEST_MMAP_RET: RefCell<*mut c_void> = RefCell::new(ptr::null_mut());
    |                                                             ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ help: replace with: `const { RefCell::new(ptr::null_mut()) }`
    |
    = help: for further information visit https://rust-lang.github.io/rust-clippy/master/index.html#thread_local_initializer_can_be_made_const
    = note: `#[deny(clippy::thread_local_initializer_can_be_made_const)]` implied by `#[deny(clippy::all)]`
```
  - appease nightly lint
```
error: lint `unused_tuple_struct_fields` has been renamed to `dead_code`
 --> aya/src/lib.rs:74:5
  |
74 |     unused_tuple_struct_fields,
  |     ^^^^^^^^^^^^^^^^^^^^^^^^^^ help: use the new name: `dead_code`
  |
  = note: `-D renamed-and-removed-lints` implied by `-D warnings`
  = help: to override `-D warnings` add `#[allow(renamed_and_removed_lints)]`
```
  See https://github.com/rust-lang/rust/commit/9fcf9c141068984ffcbb4cb00c.
  - add SchedClassifier::attach_to_link Similar to Xdp::attach_to_link, can be used to replace/upgrade the program attached to a link.
  - add SchedClassifierLink::attach_type() getter The link already exposes priority() and handle(). Expose attach_type() too.
  - Fix ringbuf docs doctests are not running in CI and therefore the didn't catch the ringbuf docs failures. This commit fixes the issues in the examples.
  - pin for (async)perf_event_array Implement pinning for perf_event_array and async_perf_event_array. Additionally make the core MapData.pin method operate on a reference rather than a mutable reference.
  - make RingBuf: Send + Sync There was no reason for them not to be -- the APIs all require mutable references and hold onto mutable references, so there cannot be internal concurrency. The !Send + !Sync came from the MMap, but not for any good reason.
  - extracting program and map names with the same function
  - add MapInfo struct following the same pattern as ProgramInfo This makes the APIs for loading maps and programs more similar.
  - support loading a map by fd This adds support to loading maps by fd similarly to the way programs can be loaded by fd.
  - make KernelVersion::code public
  - Add markdownlint This adds a linter to catch common markdown formatting errors. The linter used is markdownlint-cli2 which is available on all platforms and has an associated Github Action to automate these checks in CI.
  Configuration is checked in at .markdownlint-cli2.yaml.
  
  You may run the check locally using markdownlint-cli2. Or you may install the extension for VSCode: DavidAnson.vscode-markdownlint
  - update async-io requirement from 1.3 to 2.0 Updates the requirements on async-io to permit the latest version.
  updated-dependencies:
  - dependency-name: async-io dependency-type: direct:production ...
  - fix unused async-io dependency linter error Not using the dep: syntax created a Cargo feature flag for async-io, though this feature alone does nothing without the async_std or async_tokio features.
  - Implement RingBuf This implements the userspace binding for RingBuf.
  Instead of streaming the samples as heap buffers, the process_ring function takes a callback to which we pass the event's byte region, roughly following [libbpf]'s API design. This avoids a copy and allows marking the consumer pointer in a timely manner.
  - move mmap from perf_buffer.rs to sys/mod.rs mmap() is needed for the ring buffer implementation, so move it to a common module
  - impl Fromobj::InvalidMapTypeError for MapTypeError
  - sort variants Missed in 5e637071c1 due to merge skew with 7b71c7e1cd.
  - import types from std::ffi rather than libc
  - sort variants
  - remove redundant keys default-features = false is already in the root Cargo.toml.
  - add pin() api
    - Adds new maps_mut() API to the BpfManager to allow us to iterate though and pin all of maps at the same time.
    - Adds new pin(Path)/unpin(Path) api to Maps so they can be generically pinned AFTER load.
    - Adds macro for pinning explicit map types in aya. Convert all explicit map types "inner" field to be pub crate in order to facilitate this.
  - fix libbpf_pin_by_name Aligns with libbpf for the special LIBBPF_PIN_BY_NAME map flag. Specifically if the flag is provided without a pin path default to "/sys/fs/bpf".
  - Deprecate syscall_prefix Using the prefix only for the host architecture is often not enough, kernels usually provide symbols for more architectures, which are used by multilib applications. Handling them might or might not be necessary depending on the use case. Due to that complexity, we decided to let the callers to handle prefixes the way they prefer.
  - group_imports = "StdExternalCrate" High time we stop debating this; let the robots do the work.
  - Fix program loading on kernels with a patch > 255
  - fix load time and add test Time since boot is defined as the UNIX_EPOCH plus the duration since boot. which is realtime - boottime NOT boottime - realtime.
  Add a integration test to ensure this doesn't happen again.
  - make maps work on kernels not supporting ProgIds On startup, the kernel is probed for support of chained program ids for CpuMap, DevMap and DevMapHash, and will patch maps at load time to have the proper size. Then, at runtime, the support is checked and will error out if a program id is passed when the kernel does not support it.
  - use ProgramFd instead of impl AsRawFd Not having a generic here allows to pass None without specifying the actual type you don't care about.
  - add documentation for XDP maps
  - fix docstring missing trailing period
  - add support for chained xdp programs in {cpu,dev}map set/insert functions can now take an optional bpf program fd to run once the packet has been redirected from the main probe
  - add support for map-bound XDP programs Such programs are to be bound to cpumap or devmap instead of the usual network interfaces.
  - Update XDP maps implementations Map impls changed since this was first written.
  - Implement XDP Map Types This commit adds implementations for:
    - xskmap
    - devmap
    - devmap_hash
    - cpumap
  Which can all be used to redirect XDP packets to various different locations
  - Make MapData::pin pub This is to solve a use-case where a user (in this case bpfd) may want to:
    - MapData::from_pin to open a pinned map from bpffs
    - MapData::pin to pin that object into another bpffs
  Both operations should be easily accomplished without needing to cast a MapData into a concrete Map type - e.g aya::maps::HashMap.
  - Remove MapData::pinned BPF objects can be pinned multiple times, to multiple different places. Tracking whether or not a map is pinned in a bool is therefore not sufficient. We could track this in a HashSet, but there is really no reason to track it at all.
  - fix typos, avoid fallible conversions
  - MapData::{obj, fd} are private
  - MapFd and SockMapFd are owned
  - add program_info() api to program Add a new api to the outer level Program structure which allows users to get the program's kernel info before casting it to an explicit program variant.
  - support TryFrom for LRU hash maps The macro to implement TryFrom for MapData didn't have the ability to specify that more than one variant of MapData can be valid for a single map implementation. Support for new syntax was added to the macro so that the implementation can succeed for both valid variants in the HashMap and PerCpuHashMap impl.
  - rework TryFrom macros The old macros were repetitive and inflexible. This unifies the various macros used to generate TryFrom implementations for map implementations from the relevant map enum variants.

CHANGELOG.md 234 KB Verlauf Originalformat

Changelog

0.13.1 (2024-11-01)

Chore

Documentation

New Features

Bug Fixes

Other

Performance

Test

New Features (BREAKING)

Commit Statistics

Commit Details

0.13.0 (2024-10-09)

Chore

Documentation

New Features

Bug Fixes

Other

Performance

Test

New Features (BREAKING)

0.12.0 (2024-02-28)

Chore

Chore

Documentation

New Features

Bug Fixes

Other

Test

Commit Statistics

Commit Details

v0.11.0 (2022-06-06)

Other

Commit Statistics

Commit Details

v0.10.7 (2022-03-19)

Chore

Bug Fixes

Other

Commit Statistics

Commit Details

v0.10.6 (2021-11-13)

Other

Commit Statistics

Commit Details

v0.10.5 (2021-10-15)

Other

Commit Statistics

Commit Details

v0.10.4 (2021-09-21)

Other

Commit Statistics

Commit Details

v0.10.3 (2021-07-31)

Bug Fixes

Other

Commit Statistics

Commit Details

v0.10.2 (2021-06-17)

Other

Commit Statistics

Commit Details

v0.10.1 (2021-06-16)

Commit Statistics

Commit Details

v0.10.0 (2021-06-15)

Other

Commit Statistics

Commit Details

CHANGELOG.md 234 KB

Verlauf Originalformat