Struct IsrCache

pub struct IsrCache<C = JsonCodec>where
    C: Codec,
{ /* private fields */ }

Expand description

A cache for OS kernel profiles.

Manages the download and extraction of necessary debug symbols. Uses a Codec to encode and decode profiles. The default codec is JsonCodec.

Implementations§

impl<C> IsrCache<C>
where C: Codec,

pub fn new(directory: impl Into<PathBuf>) -> Result<Self, Error>

Creates a new IsrCache instance, initializing it with the provided directory. If the directory doesn’t exist, it attempts to create it.

pub fn entry_from_codeview(&self, codeview: CodeView) -> Result<Entry<C>, Error>

Creates or retrieves a cached profile from a CodeView debug information structure.

If a profile for the given CodeView information already exists in the cache, its path is returned. Otherwise, the necessary PDB file is downloaded, the profile is generated and stored in the cache, and its path is returned.

pub fn entry_from_pe(&self, path: impl AsRef<Path>) -> Result<Entry<C>, Error>

Creates or retrieves a cached profile from a PE file.

Extracts the CodeView debug information from the PE file and delegates to entry_from_codeview.

pub fn entry_from_linux_banner( &self, linux_banner: &str, ) -> Result<Entry<C>, Error>

Creates or retrieves a cached profile based on a Linux kernel banner.

Parses the banner to determine the kernel version and downloads the necessary debug symbols and system map if not present in the cache. Generates and stores the profile, returning its path.

Auto Trait Implementations§

impl<C> Freeze for IsrCache<C>

impl<C> RefUnwindSafe for IsrCache<C>
where C: RefUnwindSafe,

impl<C> Send for IsrCache<C>
where C: Send,

impl<C> Sync for IsrCache<C>
where C: Sync,

impl<C> Unpin for IsrCache<C>
where C: Unpin,

impl<C> UnwindSafe for IsrCache<C>
where C: UnwindSafe,

Blanket Implementations§

impl<T> Any for T
where T: 'static + ?Sized,

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more

impl<T> Borrow<T> for T
where T: ?Sized,

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more

impl<T> BorrowMut<T> for T
where T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more

impl<T> From<T> for T

fn from(t: T) -> T

Returns the argument unchanged.

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more

impl<T, U> Into<U> for T
where U: From<T>,

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow only if self and other return Action::Follow. Read more

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns Action::Follow if either self or other returns Action::Follow. Read more

impl<T, U> TryFrom<U> for T
where U: Into<T>,

type Error = Infallible

The type returned in the event of a conversion error.

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more

impl<T> ErasedDestructor for T
where T: 'static,