Enum Record

#[non_exhaustive]
pub enum Record<'a> {
    Mmap(Mmap<'a>),
    Lost(Lost),
    Comm(Comm<'a>),
    Exit(Exit),
    Throttle(Throttle),
    Unthrottle(Throttle),
    Fork(Fork),
    Read(Read),
    Sample(Box<Sample<'a>>),
    Mmap2(Mmap2<'a>),
    Aux(Aux),
    ITraceStart(ITraceStart),
    LostSamples(LostSamples),
    Switch,
    SwitchCpuWide(SwitchCpuWide),
    Namespaces(Namespaces<'a>),
    KSymbol(KSymbol<'a>),
    BpfEvent(BpfEvent),
    CGroup(CGroup<'a>),
    TextPoke(TextPoke<'a>),
    AuxOutputHwId(AuxOutputHwId),
    Unknown {
        ty: u32,
        data: Cow<'a, [u8]>,
    },
}

A record emitted by the linux kernel.

This enum contains every supported record type emitted by the kernel. Depending on how the perf event counter was configured only a few of these will be emitted by any one counter.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Mmap(Mmap<'a>)

Lost(Lost)

Comm(Comm<'a>)

Exit(Exit)

Throttle(Throttle)

Unthrottle(Throttle)

Fork(Fork)

Read(Read)

Sample(Box<Sample<'a>>)

Mmap2(Mmap2<'a>)

Aux(Aux)

ITraceStart(ITraceStart)

LostSamples(LostSamples)

Switch

SwitchCpuWide(SwitchCpuWide)

Namespaces(Namespaces<'a>)

KSymbol(KSymbol<'a>)

BpfEvent(BpfEvent)

CGroup(CGroup<'a>)

TextPoke(TextPoke<'a>)

AuxOutputHwId(AuxOutputHwId)

Unknown

A record type that is unknown to this crate.

Note that just because a record is parsed as unknown in one release of this crate does not mean it will continue to be parsed in future releases. Adding a new variant to this enum is not considered to be a breaking change.

If you find yourself using the unknown variant to parse valid records emitted by the kernel please file an issue or create a PR to add support for them.

Fields

ty: u32

data: Cow<'a, [u8]>

Implementations

impl<'p> Record<'p>

pub fn parse_with_header<B, E>( p: &mut Parser<B, E>, header: perf_event_header, ) -> ParseResult<Self>

where E: Endian, B: ParseBuf<'p>,

Parse a Record using a perf_event_header that has already been parsed.

Trait Implementations

impl<'a> Clone for Record<'a>

fn clone(&self) -> Record<'a>

Returns a duplicate of the value.

const fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for Record<'a>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'a> From<Aux> for Record<'a>

fn from(value: Aux) -> Self

Converts to this type from the input type.

impl<'a> From<AuxOutputHwId> for Record<'a>

fn from(value: AuxOutputHwId) -> Self

Converts to this type from the input type.

impl<'a> From<BpfEvent> for Record<'a>

fn from(value: BpfEvent) -> Self

Converts to this type from the input type.

impl<'a> From<CGroup<'a>> for Record<'a>

fn from(value: CGroup<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Comm<'a>> for Record<'a>

fn from(value: Comm<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<ITraceStart> for Record<'a>

fn from(value: ITraceStart) -> Self

Converts to this type from the input type.

impl<'a> From<KSymbol<'a>> for Record<'a>

fn from(value: KSymbol<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Lost> for Record<'a>

fn from(value: Lost) -> Self

Converts to this type from the input type.

impl<'a> From<LostSamples> for Record<'a>

fn from(value: LostSamples) -> Self

Converts to this type from the input type.

impl<'a> From<Mmap<'a>> for Record<'a>

fn from(value: Mmap<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Mmap2<'a>> for Record<'a>

fn from(value: Mmap2<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Namespaces<'a>> for Record<'a>

fn from(value: Namespaces<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<Read> for Record<'a>

fn from(value: Read) -> Self

Converts to this type from the input type.

impl<'a> From<Sample<'a>> for Record<'a>

fn from(value: Sample<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<SwitchCpuWide> for Record<'a>

fn from(value: SwitchCpuWide) -> Self

Converts to this type from the input type.

impl<'a> From<TextPoke<'a>> for Record<'a>

fn from(value: TextPoke<'a>) -> Self

Converts to this type from the input type.

impl<'p> Parse<'p> for Record<'p>

fn parse<B, E>(p: &mut Parser<B, E>) -> ParseResult<Self>

where E: Endian, B: ParseBuf<'p>,

Parse Self using the provided Parser instance.