Struct libudev::Device
[−]
[src]
pub struct Device<'a> { /* fields omitted */ }
A structure that provides access to sysfs/kernel devices.
Methods
impl<'a> Device<'a>
[src]
fn is_initialized(&self) -> bool
Checks whether the device has already been handled by udev.
When a new device is connected to the system, udev initializes the device by setting
permissions, renaming network devices, and possibly other initialization routines. This
method returns true
if udev has performed all of its work to initialize this device.
This method only applies to devices with device nodes or network interfaces. All other
devices return true
by default.
fn devnum(&self) -> Option<dev_t>
Gets the device's major/minor number.
fn syspath(&self) -> &Path
Returns the syspath of the device.
The path is an absolute path and includes the sys mount point. For example, the syspath for
tty0
could be /sys/devices/virtual/tty/tty0
, which includes the sys mount point,
/sys
.
fn devpath(&self) -> &OsStr
Returns the kernel devpath value of the device.
The path does not contain the sys mount point, but does start with a /
. For example, the
devpath for tty0
could be /devices/virtual/tty/tty0
.
fn devnode(&self) -> Option<&Path>
Returns the path to the device node belonging to the device.
The path is an absolute path and starts with the device directory. For example, the device
node for tty0
could be /dev/tty0
.
fn parent(&self) -> Option<Device>
Returns the parent of the device.
fn subsystem(&self) -> &OsStr
Returns the subsystem name of the device.
The subsystem name is a string that indicates which kernel subsystem the device belongs to.
Examples of subsystem names are tty
, vtconsole
, block
, scsi
, and net
.
fn sysname(&self) -> &OsStr
Returns the kernel device name for the device.
The sysname is a string that differentiates the device from others in the same subsystem.
For example, tty0
is the sysname for a TTY device that differentiates it from others,
such as tty1
.
fn sysnum(&self) -> Option<usize>
Returns the instance number of the device.
The instance number is used to differentiate many devices of the same type. For example,
/dev/tty0
and /dev/tty1
are both TTY devices but have instance numbers of 0 and 1,
respectively.
Some devices don't have instance numbers, such as /dev/console
, in which case the method
returns None
.
fn devtype(&self) -> Option<&OsStr>
Returns the devtype name of the device.
fn driver(&self) -> Option<&OsStr>
Returns the name of the kernel driver attached to the device.
fn property_value<T: AsRef<OsStr>>(&self, property: T) -> Option<&OsStr>
Retreives the value of a device property.
fn attribute_value<T: AsRef<OsStr>>(&self, attribute: T) -> Option<&OsStr>
Retreives the value of a device attribute.
fn set_attribute_value<T: AsRef<OsStr>, U: AsRef<OsStr>>(
&mut self,
attribute: T,
value: U
) -> Result<()>
&mut self,
attribute: T,
value: U
) -> Result<()>
Sets the value of a device attribute.
fn properties(&self) -> Properties
Returns an iterator over the device's properties.
Example
This example prints out all of a device's properties:
for property in device.properties() { println!("{:?} = {:?}", property.name(), property.value()); }
fn attributes(&self) -> Attributes
Returns an iterator over the device's attributes.
Example
This example prints out all of a device's attributes:
for attribute in device.attributes() { println!("{:?} = {:?}", attribute.name(), attribute.value()); }