Struct Database 

pub struct Database<'db> { /* private fields */ }

Available on macOS only.

Safe, read-only view of a kpep_db opened by the framework.

Each database describes every PMC event that a specific Apple Silicon CPU supports. The 'db lifetime is tied to the framework-allocated database; all string and event pointers inside the database remain valid for this lifetime.

Implementations

impl<'db> Database<'db>

pub const unsafe fn as_raw(&self) -> NonNull<kpep_db>

Returns a non-null pointer to the underlying kpep_db.

This is useful if you need to call kperfdata.framework functions directly through the VTable.

Safety

The returned pointer borrows the database. The caller must not mutate it, free it, or use it after the Database’s lifetime has expired.

pub const fn name(&self) -> &'db str

Database name, e.g. "a14", "as4".

pub const fn cpu_id(&self) -> &'db str

Plist CPU identifier, e.g. "cpu_7_8_10b282dc".

pub const fn cpu(&self) -> Option<Cpu>

The Cpu corresponding to this database.

pub const fn marketing_name(&self) -> &'db str

Marketing name, e.g. "Apple A14/M1".

pub const fn events(&self) -> &'db [DatabaseEvent<'db>]

All events in the database.

pub const fn fixed_events(&self) -> &'db [&'db DatabaseEvent<'db>]

Events assigned to fixed counter registers.

Each element is a reference into the events array.

pub const fn architecture(&self) -> Architecture

The CPU architecture this database targets.