Package com.sun.jna.platform.linux

Class Udev.UdevDevice

  • All Implemented Interfaces:
    NativeMapped
    Enclosing interface:
    Udev
    public static class Udev.UdevDevice
extends PointerType
    To introspect a local device on a system, a udev device object can be created via Udev.UdevContext.deviceNewFromSyspath(String) and friends. The device object allows one to query current state, read and write attributes and lookup properties of the device in question.

    • Constructor Detail

      • UdevDevice

        public UdevDevice()

    • Method Detail

      • ref

        public Udev.UdevDevice ref()
        Acquire a further reference to this object.
        Returns:
        this object, unmodified.

      • unref

        public void unref()
        Drop a reference to this object. Once the reference count hits 0, the context object is destroyed and freed.

      • getParent

        public Udev.UdevDevice getParent()
        Gets the parent of this device
        Returns:
        the parent device. No additional reference to this device is acquired, but the child device owns a reference to the parent device. On failure, NULL is returned.

      • getParentWithSubsystemDevtype

        public Udev.UdevDevice getParentWithSubsystemDevtype​(String subsystem,
                                                     String devtype)
        Gets the parent of this device matching a subsystem and devtype
        Parameters:
        subsystem - The subsystem to match
        devtype - The device type to match
        Returns:
        the parent device. No additional reference to this device is acquired, but the child device owns a reference to the parent device. On failure, NULL is returned.

      • getSyspath

        public String getSyspath()
        Gets the syspath of this device
        Returns:
        a string that describes the syspath. On failure, may return NULL.

      • getSysname

        public String getSysname()
        Gets the sysname of this device
        Returns:
        a string that describes the sysname. On failure, may return NULL.

      • getDevnode

        public String getDevnode()
        Gets the devnode of this device
        Returns:
        a string that describes the devnode. On failure, may return NULL.

      • getDevtype

        public String getDevtype()
        Gets the devtype of this device
        Returns:
        a string that describes the devtype. On failure, may return NULL.

      • getSubsystem

        public String getSubsystem()
        Gets the subsystem of this device
        Returns:
        a string that describes the subsystem. On failure, may return NULL.

      • getSysattrValue

        public String getSysattrValue​(String sysattr)
        Retrieves a device attribute from this device
        Parameters:
        sysattr - The attribute to retrieve.
        Returns:
        a string of the requested value. On error, NULL is returned. Attributes that may contain NUL bytes should not be retrieved with udev_device_get_sysattr_value(); instead, read them directly from the files within the device's syspath.

      • getPropertyValue

        public String getPropertyValue​(String key)
        Retrieves a device property from this device
        Parameters:
        key - The property to retrieve.
        Returns:
        a string of the requested value. On error, NULL is returned.