Struct libudev::Enumerator

pub struct Enumerator<'a> { /* fields omitted */ }

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.

Methods

impl<'a> Enumerator<'a>

pub fn new(context: &'a 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<'a> Drop for Enumerator<'a>

fn drop(&mut self)

Executes the destructor for this type.