Struct backtrace::symbolize::gimli::parse_running_mmaps::MapsEntry

pub(super) struct MapsEntry {
    address: (usize, usize),
    perms: [char; 4],
    offset: usize,
    dev: (usize, usize),
    inode: usize,
    pathname: OsString,
}

Fields

address: (usize, usize)

start (inclusive) and limit (exclusive) of address range.

perms: [char; 4]

The perms field are the permissions for the entry

r = read w = write x = execute s = shared p = private (copy on write)

offset: usize

Offset into the file (or “whatever”).

dev: (usize, usize)

device (major, minor)

inode: usize

inode on the device. 0 indicates that no inode is associated with the memory region (e.g. uninitalized data aka BSS).

pathname: OsString

Usually the file backing the mapping.

Note: The man page for proc includes a note about “coordination” by using readelf to see the Offset field in ELF program headers. pnkfelix is not yet sure if that is intended to be a comment on pathname, or what form/purpose such coordination is meant to have.

There are also some pseudo-paths: “[stack]”: The initial process’s (aka main thread’s) stack. “[stack:]”: a specific thread’s stack. (This was only present for a limited range of Linux verisons; it was determined to be too expensive to provide.) “[vdso]”: Virtual dynamically linked shared object “[heap]”: The process’s heap

The pathname can be blank, which means it is an anonymous mapping obtained via mmap.

Newlines in pathname are replaced with an octal escape sequence.

The pathname may have “(deleted)” appended onto it if the file-backed path has been deleted.

Note that modifications like the latter two indicated above imply that in general the pathname may be ambiguous. (I.e. you cannot tell if the denoted filename actually ended with the text “(deleted)”, or if that was added by the maps rendering.

Implementations

impl MapsEntry

pub(super) fn pathname(&self) -> &OsString

pub(super) fn ip_matches(&self, ip: usize) -> bool

Trait Implementations

impl Debug for MapsEntry

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

Formats the value using the given formatter.

impl FromStr for MapsEntry

type Err = &'static str

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

Parses a string s to return a value of this type.

impl PartialEq for MapsEntry

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

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

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 MapsEntry

impl StructuralPartialEq for MapsEntry