pub struct CgroupSysctl { /* private fields */ }Expand description
A program used to watch for sysctl changes.
CgroupSysctl programs can be attached to a cgroup and will be called every
time a process inside that cgroup tries to read from or write to a sysctl knob in proc.
§Minimum kernel version
The minimum kernel version required to use this feature is 5.2.
§Examples
use std::fs::File;
use aya::programs::{CgroupAttachMode, CgroupSysctl};
let file = File::open("/sys/fs/cgroup/unified")?;
let program: &mut CgroupSysctl = bpf.program_mut("cgroup_sysctl").unwrap().try_into()?;
program.load()?;
program.attach(file, CgroupAttachMode::Single)?;Implementations§
Source§impl CgroupSysctl
impl CgroupSysctl
Sourcepub fn load(&mut self) -> Result<(), ProgramError>
pub fn load(&mut self) -> Result<(), ProgramError>
Loads the program inside the kernel.
Sourcepub fn attach<T: AsFd>(
&mut self,
cgroup: T,
mode: CgroupAttachMode,
) -> Result<CgroupSysctlLinkId, ProgramError>
pub fn attach<T: AsFd>( &mut self, cgroup: T, mode: CgroupAttachMode, ) -> Result<CgroupSysctlLinkId, ProgramError>
Attaches the program to the given cgroup.
The returned value can be used to detach, see CgroupSysctl::detach.
Sourcepub fn take_link(
&mut self,
link_id: CgroupSysctlLinkId,
) -> Result<CgroupSysctlLink, ProgramError>
pub fn take_link( &mut self, link_id: CgroupSysctlLinkId, ) -> Result<CgroupSysctlLink, ProgramError>
Takes ownership of the link referenced by the provided link_id.
The link will be detached on Drop and the caller is now responsible
for managing its lifetime.
Sourcepub fn detach(
&mut self,
link_id: CgroupSysctlLinkId,
) -> Result<(), ProgramError>
pub fn detach( &mut self, link_id: CgroupSysctlLinkId, ) -> Result<(), ProgramError>
Detaches the program.
See CgroupSysctl::attach.
Source§impl CgroupSysctl
impl CgroupSysctl
Sourcepub fn unload(&mut self) -> Result<(), ProgramError>
pub fn unload(&mut self) -> Result<(), ProgramError>
Unloads the program from the kernel.
Links will be detached before unloading the program. Note
that owned links obtained using take_link() will not be
detached.
Source§impl CgroupSysctl
impl CgroupSysctl
Sourcepub fn fd(&self) -> Result<&ProgramFd, ProgramError>
pub fn fd(&self) -> Result<&ProgramFd, ProgramError>
Returns the file descriptor of this Program.
Source§impl CgroupSysctl
impl CgroupSysctl
Sourcepub fn pin<P: AsRef<Path>>(&mut self, path: P) -> Result<(), PinError>
pub fn pin<P: AsRef<Path>>(&mut self, path: P) -> Result<(), PinError>
Pins the program to a BPF filesystem.
When a BPF object is pinned to a BPF filesystem it will remain loaded after Aya has unloaded the program. To remove the program, the file on the BPF filesystem must be removed. Any directories in the the path provided should have been created by the caller.
Source§impl CgroupSysctl
impl CgroupSysctl
Sourcepub fn from_pin<P: AsRef<Path>>(path: P) -> Result<Self, ProgramError>
pub fn from_pin<P: AsRef<Path>>(path: P) -> Result<Self, ProgramError>
Creates a program from a pinned entry on a bpffs.
Existing links will not be populated. To work with existing links you should use crate::programs::links::PinnedLink.
On drop, any managed links are detached and the program is unloaded. This will not result in the program being unloaded from the kernel if it is still pinned.
Source§impl CgroupSysctl
impl CgroupSysctl
Sourcepub fn info(&self) -> Result<ProgramInfo, ProgramError>
pub fn info(&self) -> Result<ProgramInfo, ProgramError>
Returns metadata information of this program.
Uses kernel v4.13 features.