Struct Mmap

pub struct Mmap<'a> {
    pub pid: u32,
    pub tid: u32,
    pub addr: u64,
    pub len: u64,
    pub pgoff: u64,
    pub filename: Cow<'a, [u8]>,
}

MMAP events record memory mappings.

This struct corresponds to PERF_RECORD_MMAP. See the manpage for more documentation here.

Fields

pid: u32

The process ID.

tid: u32

The thread ID.

addr: u64

The address that the mapping was placed at in the process’ address space.

len: u64

The length, in bytes, of the allocated memory.

pgoff: u64

The page offset of the memory mapping.

filename: Cow<'a, [u8]>

The path to the file that is being mapped, if there is one.

Notes

• Not all memory mappings have a path on the file system. In cases where there is no such path then this will be a label(ish) string from the kernel (e.g. [stack], [heap], [vdso], etc.)
• Just because the mapping has a path doesn’t necessarily mean that the file at that path was the file that was mapped. The file may have been deleted in the meantime or the process may be under a chroot.

If you need to be able to tell whether the file at the path is the same one as was mapped you will need to use Mmap2 instead.

Implementations

impl<'a> Mmap<'a>

pub fn filename_os(&self) -> &OsStr

The path to the file that is being mapped, as an OsStr.

Notes

• Not all memory mappings have a path on the file system. In cases where there is no such path then this will be a label(ish) string from the kernel (e.g. [stack], [heap], [vdso], etc.)
• Just because the mapping has a path doesn’t necessarily mean that the file at that path was the file that was mapped. The file may have been deleted in the meantime or the process may be under a chroot.

If you need to be able to tell whether the file at the path is the same one as was mapped you will need to use Mmap2 instead.

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

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

Trait Implementations

impl<'a> Clone for Mmap<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Mmap<'_>

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

Formats the value using the given formatter.

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 Mmap<'a>

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

Converts to this type from the input type.

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