Enum DsoKey

pub enum DsoKey {
    Kernel,
    GuestKernel,
    Vdso32,
    VdsoX32,
    Vdso64,
    Vsyscall,
    KernelModule {
        name: String,
    },
    User {
        file_name: String,
        full_path: Vec<u8>,
    },
}

A canonicalized key which can be used to cross-reference an Mmap record with an entry in the perf file’s build ID list.

This is needed because the entries sometimes don’t have matching path strings.

Examples:

• Mmap path “[kernel.kallsyms]_text” + build ID map entry path “[kernel.kallsyms]”
• Mmap path “[kernel.kallsyms]_text” + build ID map entry path “/full/path/to/vmlinux”

Variants

Kernel

GuestKernel

Vdso32

VdsoX32

Vdso64

Vsyscall

KernelModule

Fields

name: String

The name of the kernel module, without file extension, e.g. “snd-seq-device”.

We don’t store the full path in the key because the name is enough to uniquely identify the kernel module.

User

Fields

file_name: String

The file name of the user-space DSO.

full_path: Vec<u8>

The full path of the user-space DSO. This must be part of the key because there could be multiple DSOs with the same file name at different paths.

Implementations

impl DsoKey

pub fn detect(path: &[u8], cpu_mode: CpuMode) -> Option<Self>

Make a DsoKey from a path and a CpuMode (which usually comes from a misc field).

Returns None for things which cannot be detected as a DSO, such as //anon mappings.

pub fn name(&self) -> &str

The name string for this DSO. This is a short string that you’d want to see in a profiler UI, for example.

Trait Implementations

impl Clone for DsoKey

fn clone(&self) -> DsoKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DsoKey

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

Formats the value using the given formatter.

impl Hash for DsoKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for DsoKey

fn eq(&self, other: &DsoKey) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for DsoKey

impl StructuralPartialEq for DsoKey