Struct Enumerator

pub struct Enumerator { /* private fields */ }

An enumeration context.

An Enumerator scans /sys for devices matching its filters. Filters are added to an Enumerator by calling its match_* and nomatch_* methods. After the filters are setup, the scan_devices() method finds devices in /sys that match the filters.

Implementations

impl Enumerator

pub fn new(context: &Context) -> Result<Self>

Creates a new Enumerator.

pub fn match_is_initialized(&mut self) -> Result<()>

Adds a filter that matches only initialized devices.

pub fn match_subsystem<T: AsRef<OsStr>>(&mut self, subsystem: T) -> Result<()>

Adds a filter that matches only devices that belong to the given kernel subsystem.

pub fn match_attribute<T: AsRef<OsStr>, U: AsRef<OsStr>>( &mut self, attribute: T, value: U, ) -> Result<()>

Adds a filter that matches only devices with the given attribute value.

pub fn match_sysname<T: AsRef<OsStr>>(&mut self, sysname: T) -> Result<()>

Adds a filter that matches only devices with the given kernel device name.

pub fn match_property<T: AsRef<OsStr>, U: AsRef<OsStr>>( &mut self, property: T, value: U, ) -> Result<()>

Adds a filter that matches only devices with the given property value.

pub fn match_tag<T: AsRef<OsStr>>(&mut self, tag: T) -> Result<()>

Adds a filter that matches only devices with the given tag.

pub fn match_parent(&mut self, parent: &Device) -> Result<()>

Includes the parent device and all devices in the subtree of the parent device.

pub fn nomatch_subsystem<T: AsRef<OsStr>>(&mut self, subsystem: T) -> Result<()>

Adds a filter that matches only devices that don’t belong to the given kernel subsystem.

pub fn nomatch_attribute<T: AsRef<OsStr>, U: AsRef<OsStr>>( &mut self, attribute: T, value: U, ) -> Result<()>

Adds a filter that matches only devices that don’t have the the given attribute value.

pub fn add_syspath(&mut self, syspath: &Path) -> Result<()>

Includes the device with the given syspath.

pub fn scan_devices(&mut self) -> Result<Devices<'_>>

Scans /sys for devices matching the attached filters.

The devices will be sorted in dependency order.

Trait Implementations

impl Drop for Enumerator

fn drop(&mut self)

Executes the destructor for this type.