Struct perf_event_data::Comm

pub struct Comm<'a> {
    pub pid: u32,
    pub tid: u32,
    pub comm: Cow<'a, [u8]>,
}

COMM records indicate changes in process names.

There are multiple ways that this could happen: execve(2), prctl(PR_SET_NAME), as well as writing to /proc/self/comm.

Since Linux 3.10 the kernel will set the COMM_EXEC bit in the misc flags if the record is due to an execve(2) syscall. You can set comm_exec when building to detect whether this is supported.

This struct corresponds to PERF_RECORD_COMM. See the manpage for more documentation.

Fields

pid: u32

The process ID.

tid: u32

The thread ID.

comm: Cow<'a, [u8]>

The new name of the process.

If on unix systems you can use comm_os to get this as an OsStr.

Implementations

impl<'a> Comm<'a>

pub fn comm_os(&self) -> &OsStr

The new name of the process, as an OsStr.

pub fn into_owned(self) -> Comm<'static>

Convert all the borrowed data in this Comm into owned data.

Trait Implementations

impl<'a> Clone for Comm<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Comm<'_>

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

Formats the value using the given formatter.

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

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

Converts to this type from the input type.

impl<'p> Parse<'p> for Comm<'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.