features

Documentation

Overview

Package features allows probing for BPF features available to the calling process.

Index

• func HaveMapType(mt ebpf.MapType) error
• func HaveProgType(pt ebpf.ProgramType) error

Functions

func HaveMapType

func HaveMapType(mt ebpf.MapType) error

HaveMapType probes the running kernel for the availability of the specified map type. Return values have the following semantics:

err == nil: The feature is available.
errors.Is(err, ebpf.ErrNotSupported): The feature is not available.
err != nil: Any errors encountered during probe execution, wrapped.

Note that the latter case may include false negatives, and that map creation may succeed despite an error being returned. Some map types cannot reliably be probed and will also return error. Only `nil` and `ebpf.ErrNotSupported` are conclusive.

Probe results are cached and persist throughout any process capability changes.

func HaveProgType

func HaveProgType(pt ebpf.ProgramType) error

HaveProgType probes the running kernel for the availability of the specified program type. Return values have the following semantics:

err == nil: The feature is available.
errors.Is(err, ebpf.ErrNotSupported): The feature is not available.
err != nil: Any errors encountered during probe execution, wrapped.

Note that the latter case may include false negatives, and that program creation may succeed despite an error being returned. Some program types cannot reliably be probed and will also return error. Only `nil` and `ebpf.ErrNotSupported` are conclusive.

Probe results are cached and persist throughout any process capability changes.