|
+ |
+ |
+GUdev Reference Manual | + |
+
|---|---|---|---|---|
| +Top + | + Description + | + Object Hierarchy + | + Properties + | + Signals + | ||||
GUdevClient; +struct GUdevClientClass; +enum GUdevDeviceType; +typedef GUdevDeviceNumber; +GUdevClient * g_udev_client_new (+const gchar * const *subsystems); +GList * g_udev_client_query_by_subsystem (GUdevClient *client, +const gchar *subsystem); +GUdevDevice * g_udev_client_query_by_device_number + (GUdevClient *client, +GUdevDeviceType type, +GUdevDeviceNumber number); +GUdevDevice * g_udev_client_query_by_device_file (GUdevClient *client, +const gchar *device_file); +GUdevDevice * g_udev_client_query_by_sysfs_path (GUdevClient *client, +const gchar *sysfs_path); +GUdevDevice * g_udev_client_query_by_subsystem_and_name + (GUdevClient *client, +const gchar *subsystem, +const gchar *name); +
+GUdevClient is used to query information about devices on a Linux +system from the Linux kernel and the udev device +manager. +
+
+Device information is retrieved from the kernel (through the
+sysfs filesystem) and the udev daemon (through a
+tmpfs filesystem) and presented through
+GUdevDevice objects. This means that no blocking IO ever happens
+(in both cases, we are essentially just reading data from kernel
+memory) and as such there are no asynchronous versions of the
+provided methods.
+
+To get GUdevDevice objects, use
+g_udev_client_query_by_subsystem(),
+g_udev_client_query_by_device_number(),
+g_udev_client_query_by_device_file(),
+g_udev_client_query_by_sysfs_path(),
+g_udev_client_query_by_subsystem_and_name()
+or the GUdevEnumerator type.
+
+To listen to uevents, connect to the "uevent" signal. +
+typedef struct _GUdevClient GUdevClient;+
+The GUdevClient struct is opaque and should not be accessed directly. +
+struct GUdevClientClass {
+ GObjectClass parent_class;
+
+ /* signals */
+ void (*uevent) (GUdevClient *client,
+ const gchar *action,
+ GUdevDevice *device);
+};
+
++Class structure for GUdevClient. +
+| + | Parent class. | +
| + | Signal class handler for the "uevent" signal. | +
typedef enum {
+ G_UDEV_DEVICE_TYPE_NONE = 0,
+ G_UDEV_DEVICE_TYPE_BLOCK = 'b',
+ G_UDEV_DEVICE_TYPE_CHAR = 'c',
+} GUdevDeviceType;
+
++Enumeration used to specify a the type of a device. +
+ +typedef guint64 GUdevDeviceNumber; /* __UQUAD_TYPE */ ++
+Corresponds to the standard dev_t type as defined by POSIX (Until +bug 584517 is resolved this work-around is needed). +
+GUdevClient * g_udev_client_new (const gchar * const *subsystems);
++Constructs a GUdevClient object that can be used to query +information about devices. Connect to the "uevent" +signal to listen for uevents. Note that signals are emitted in the +thread-default main loop +of the thread that you call this constructor from. +
+
|
+A NULL terminated string array of subsystems to listen for uevents on, NULL to not listen on uevents at all, or an empty array to listen to uevents on all subsystems. See the documentation for the "subsystems" property for details on this parameter. [array zero-terminated=1][element-type utf8][transfer none][allow-none]
+ |
+
Returns : |
+A new GUdevClient object. Free with g_object_unref(). |
+
GList * g_udev_client_query_by_subsystem (+GUdevClient *client, +const gchar *subsystem);
+Gets all devices belonging to subsystem.
+
|
+A GUdevClient. | +
|
+The subsystem to get devices for or NULL to get all devices. [allow-none]
+ |
+
Returns : |
+A list of GUdevDevice objects. The caller should free the result by using g_object_unref() on each element in the list and then g_list_free() on the list. [element-type GUdevDevice][transfer full]
+ |
+
GUdevDevice * g_udev_client_query_by_device_number + (+GUdevClient *client, +GUdevDeviceType type, +GUdevDeviceNumber number);
+Looks up a device for a type and device number. +
+
|
+A GUdevClient. | +
|
+A value from the GUdevDeviceType enumeration. | +
|
+A device number. | +
Returns : |
+A GUdevDevice object or NULL if the device was not found. Free with g_object_unref(). [transfer full]
+ |
+
GUdevDevice * g_udev_client_query_by_device_file (+GUdevClient *client, +const gchar *device_file);
+Looks up a device for a device file. +
+
|
+A GUdevClient. | +
|
+A device file. | +
Returns : |
+A GUdevDevice object or NULL if the device was not found. Free with g_object_unref(). [transfer full]
+ |
+
GUdevDevice * g_udev_client_query_by_sysfs_path (+GUdevClient *client, +const gchar *sysfs_path);
+Looks up a device for a sysfs path. +
+
|
+A GUdevClient. | +
|
+A sysfs path. | +
Returns : |
+A GUdevDevice object or NULL if the device was not found. Free with g_object_unref(). [transfer full]
+ |
+
GUdevDevice * g_udev_client_query_by_subsystem_and_name + (+GUdevClient *client, +const gchar *subsystem, +const gchar *name);
+Looks up a device for a subsystem and name. +
+
|
+A GUdevClient. | +
|
+A subsystem name. | +
|
+The name of the device. | +
Returns : |
+A GUdevDevice object or NULL if the device was not found. Free with g_object_unref(). [transfer full]
+ |
+
"subsystems" property "subsystems" GStrv : Read / Write / Construct Only
++The subsystems to listen for uevents on. +
++To listen for only a specific DEVTYPE for a given SUBSYSTEM, use +"subsystem/devtype". For example, to only listen for uevents +where SUBSYSTEM is usb and DEVTYPE is usb_interface, use +"usb/usb_interface". +
+
+If this property is NULL, then no events will be reported. If
+it's the empty array, events from all subsystems will be
+reported.
+
"uevent" signalvoid user_function (GUdevClient *client,
+ gchar *action,
+ GUdevDevice *device,
+ gpointer user_data) : Run Last
+
+Emitted when client receives an uevent.
+
+This signal is emitted in the
+thread-default main loop
+of the thread that client was created in.
+
|
+The GUdevClient receiving the event. | +
|
+The action for the uevent e.g. "add", "remove", "change", "move", etc. | +
|
+Details about the GUdevDevice the event is for. | +
|
+user data set when the signal handler was connected. | +
|
+ |
+ |
+GUdev Reference Manual | + |
+
|---|---|---|---|---|
| +Top + | + Description + | + Object Hierarchy + | ||||
GUdevDevice; +struct GUdevDeviceClass; +const gchar * g_udev_device_get_subsystem (+GUdevDevice *device); +const gchar * g_udev_device_get_devtype (GUdevDevice *device); +const gchar * g_udev_device_get_name (GUdevDevice *device); +const gchar * g_udev_device_get_number (GUdevDevice *device); +const gchar * g_udev_device_get_sysfs_path (GUdevDevice *device); +const gchar * g_udev_device_get_driver (GUdevDevice *device); +const gchar * g_udev_device_get_action (GUdevDevice *device); +guint64 g_udev_device_get_seqnum (GUdevDevice *device); +GUdevDeviceType g_udev_device_get_device_type (GUdevDevice *device); +GUdevDeviceNumber g_udev_device_get_device_number (GUdevDevice *device); +const gchar * g_udev_device_get_device_file (GUdevDevice *device); +const gchar * const * g_udev_device_get_device_file_symlinks + (GUdevDevice *device); +GUdevDevice * g_udev_device_get_parent (GUdevDevice *device); +GUdevDevice * g_udev_device_get_parent_with_subsystem + (GUdevDevice *device, +const gchar *subsystem, +const gchar *devtype); +const gchar * const * g_udev_device_get_tags (GUdevDevice *device); +gboolean g_udev_device_get_is_initialized (GUdevDevice *device); +guint64 g_udev_device_get_usec_since_initialized + (GUdevDevice *device); +const gchar * const * g_udev_device_get_property_keys (GUdevDevice *device); +gboolean g_udev_device_has_property (GUdevDevice *device, +const gchar *key); +const gchar * g_udev_device_get_property (GUdevDevice *device, +const gchar *key); +gint g_udev_device_get_property_as_int (GUdevDevice *device, +const gchar *key); +guint64 g_udev_device_get_property_as_uint64 + (GUdevDevice *device, +const gchar *key); +gdouble g_udev_device_get_property_as_double + (GUdevDevice *device, +const gchar *key); +gboolean g_udev_device_get_property_as_boolean + (GUdevDevice *device, +const gchar *key); +const gchar * const * g_udev_device_get_property_as_strv + (GUdevDevice *device, +const gchar *key); +const gchar * g_udev_device_get_sysfs_attr (GUdevDevice *device, +const gchar *name); +gint g_udev_device_get_sysfs_attr_as_int (GUdevDevice *device, +const gchar *name); +guint64 g_udev_device_get_sysfs_attr_as_uint64 + (GUdevDevice *device, +const gchar *name); +gdouble g_udev_device_get_sysfs_attr_as_double + (GUdevDevice *device, +const gchar *name); +gboolean g_udev_device_get_sysfs_attr_as_boolean + (GUdevDevice *device, +const gchar *name); +const gchar * const * g_udev_device_get_sysfs_attr_as_strv + (GUdevDevice *device, +const gchar *name); +
+The GUdevDevice class is used to get information about a specific +device. Note that you cannot instantiate a GUdevDevice object +yourself. Instead you must use GUdevClient to obtain GUdevDevice +objects. +
+
+To get basic information about a device, use
+g_udev_device_get_subsystem(), g_udev_device_get_devtype(),
+g_udev_device_get_name(), g_udev_device_get_number(),
+g_udev_device_get_sysfs_path(), g_udev_device_get_driver(),
+g_udev_device_get_action(), g_udev_device_get_seqnum(),
+g_udev_device_get_device_type(), g_udev_device_get_device_number(),
+g_udev_device_get_device_file(),
+g_udev_device_get_device_file_symlinks().
+
+To navigate the device tree, use g_udev_device_get_parent() and
+g_udev_device_get_parent_with_subsystem().
+
+To access udev properties for the device, use
+g_udev_device_get_property_keys(),
+g_udev_device_has_property(),
+g_udev_device_get_property(),
+g_udev_device_get_property_as_int(),
+g_udev_device_get_property_as_uint64(),
+g_udev_device_get_property_as_double(),
+g_udev_device_get_property_as_boolean() and
+g_udev_device_get_property_as_strv().
+
+To access sysfs attributes for the device, use
+g_udev_device_get_sysfs_attr(),
+g_udev_device_get_sysfs_attr_as_int(),
+g_udev_device_get_sysfs_attr_as_uint64(),
+g_udev_device_get_sysfs_attr_as_double(),
+g_udev_device_get_sysfs_attr_as_boolean() and
+g_udev_device_get_sysfs_attr_as_strv().
+
+Note that all getters on GUdevDevice are non-reffing – returned +values are owned by the object, should not be freed and are only +valid as long as the object is alive. +
++By design, GUdevDevice will not react to changes for a device – it +only contains a snapshot of information when the GUdevDevice +object was created. To work with changes, you typically connect to +the "uevent" signal on a GUdevClient and get a new +GUdevDevice whenever an event happens. +
+typedef struct _GUdevDevice GUdevDevice;+
+The GUdevDevice struct is opaque and should not be accessed directly. +
+struct GUdevDeviceClass {
+ GObjectClass parent_class;
+};
+
++Class structure for GUdevDevice. +
+ +const gchar * g_udev_device_get_subsystem (GUdevDevice *device);
+
+Gets the subsystem for device.
+
|
+A GUdevDevice. | +
Returns : |
+The subsystem for device. |
+
const gchar * g_udev_device_get_devtype (GUdevDevice *device);
+
+Gets the device type for device.
+
|
+A GUdevDevice. | +
Returns : |
+The devtype for device. |
+
const gchar * g_udev_device_get_name (GUdevDevice *device);
+
+Gets the name of device, e.g. "sda3".
+
|
+A GUdevDevice. | +
Returns : |
+The name of device. |
+
const gchar * g_udev_device_get_number (GUdevDevice *device);
+
+Gets the number of device, e.g. "3" if g_udev_device_get_name() returns "sda3".
+
|
+A GUdevDevice. | +
Returns : |
+The number of device. |
+
const gchar * g_udev_device_get_sysfs_path (GUdevDevice *device);
+
+Gets the sysfs path for device.
+
|
+A GUdevDevice. | +
Returns : |
+The sysfs path for device. |
+
const gchar * g_udev_device_get_driver (GUdevDevice *device);
+
+Gets the name of the driver used for device.
+
|
+A GUdevDevice. | +
Returns : |
+The name of the driver for device or NULL if unknown. |
+
const gchar * g_udev_device_get_action (GUdevDevice *device);
+
+Gets the most recent action (e.g. "add", "remove", "change", etc.) for device.
+
|
+A GUdevDevice. | +
Returns : |
+An action string. | +
guint64 g_udev_device_get_seqnum (GUdevDevice *device);
+
+Gets the most recent sequence number for device.
+
|
+A GUdevDevice. | +
Returns : |
+A sequence number. | +
GUdevDeviceType g_udev_device_get_device_type (GUdevDevice *device);
+
+Gets the type of the device file, if any, for device.
+
|
+A GUdevDevice. | +
Returns : |
+The device number for device or G_UDEV_DEVICE_TYPE_NONE if the device does not have a device file. |
+
GUdevDeviceNumber g_udev_device_get_device_number (GUdevDevice *device);
+
+Gets the device number, if any, for device.
+
|
+A GUdevDevice. | +
Returns : |
+The device number for device or 0 if unknown. |
+
const gchar * g_udev_device_get_device_file (GUdevDevice *device);
+
+Gets the device file for device.
+
|
+A GUdevDevice. | +
Returns : |
+The device file for device or NULL if no device file
+exists. |
+
const gchar * const * g_udev_device_get_device_file_symlinks
+ (GUdevDevice *device);
+
+Gets a list of symlinks (in /dev) that points to
+the device file for device.
+
|
+A GUdevDevice. | +
Returns : |
+A NULL terminated string array of symlinks. This array is owned by device and should not be freed by the caller. [transfer none][array zero-terminated=1][element-type utf8]
+ |
+
GUdevDevice * g_udev_device_get_parent (GUdevDevice *device);
+
+Gets the immediate parent of device, if any.
+
|
+A GUdevDevice. | +
Returns : |
+A GUdevDevice or NULL if device has no parent. Free with g_object_unref(). [transfer full]
+ |
+
GUdevDevice * g_udev_device_get_parent_with_subsystem + (+GUdevDevice *device, +const gchar *subsystem, +const gchar *devtype);
+Walks up the chain of parents of device and returns the first
+device encountered where subsystem and devtype matches, if any.
+
|
+A GUdevDevice. | +
|
+The subsystem of the parent to get. | +
|
+The devtype of the parent to get or NULL. [allow-none]
+ |
+
Returns : |
+A GUdevDevice or NULL if device has no parent with subsystem and devtype. Free with g_object_unref(). [transfer full]
+ |
+
const gchar * const * g_udev_device_get_tags (GUdevDevice *device);
+
+Gets all tags for device.
+
|
+A GUdevDevice. | +
Returns : |
+A NULL terminated string array of tags. This array is owned by device and should not be freed by the caller. [transfer none][array zero-terminated=1][element-type utf8]
+ |
+
Since 165
+gboolean g_udev_device_get_is_initialized (GUdevDevice *device);
+
+Gets whether device has been initalized.
+
|
+A GUdevDevice. | +
Returns : |
+Whether device has been initialized. |
+
Since 165
+guint64 g_udev_device_get_usec_since_initialized
+ (GUdevDevice *device);
+
+Gets number of micro-seconds since device was initialized.
+
+This only works for devices with properties in the udev +database. All other devices return 0. +
+
|
+A GUdevDevice. | +
Returns : |
+Number of micro-seconds since device was initialized or 0 if unknown. |
+
Since 165
+const gchar * const * g_udev_device_get_property_keys (GUdevDevice *device);
+
+Gets all keys for properties on device.
+
|
+A GUdevDevice. | +
Returns : |
+A NULL terminated string array of property keys. This array is owned by device and should not be freed by the caller. [transfer none][array zero-terminated=1][element-type utf8]
+ |
+
gboolean g_udev_device_has_property (+GUdevDevice *device, +const gchar *key);
+Check if a the property with the given key exists. +
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+
+TRUE only if the value for key exist. |
+
const gchar * g_udev_device_get_property (+GUdevDevice *device, +const gchar *key);
+Look up the value for key on device.
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+The value for key or NULL if key doesn't exist on device. Do not free this string, it is owned by device. |
+
gint g_udev_device_get_property_as_int (+GUdevDevice *device, +const gchar *key);
+Look up the value for key on device and convert it to an integer
+using strtol().
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+The value for key or 0 if key doesn't exist or
+isn't an integer. |
+
guint64 g_udev_device_get_property_as_uint64 + (+GUdevDevice *device, +const gchar *key);
+Look up the value for key on device and convert it to an unsigned
+64-bit integer using g_ascii_strtoull().
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+The value for key or 0 if key doesn't exist or isn't a
+guint64. |
+
gdouble g_udev_device_get_property_as_double + (+GUdevDevice *device, +const gchar *key);
+Look up the value for key on device and convert it to a double
+precision floating point number using strtod().
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+The value for key or 0.0 if key doesn't exist or isn't a
+gdouble. |
+
gboolean g_udev_device_get_property_as_boolean + (+GUdevDevice *device, +const gchar *key);
+Look up the value for key on device and convert it to an
+boolean. This is done by doing a case-insensitive string comparison
+on the string value against "1" and "true".
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+The value for key or FALSE if key doesn't exist or
+isn't a gboolean. |
+
const gchar * const * g_udev_device_get_property_as_strv + (+GUdevDevice *device, +const gchar *key);
+Look up the value for key on device and return the result of
+splitting it into non-empty tokens split at white space (only space
+(' '), form-feed ('\f'), newline ('\n'), carriage return ('\r'),
+horizontal tab ('\t'), and vertical tab ('\v') are considered; the
+locale is not taken into account).
+
|
+A GUdevDevice. | +
|
+Name of property. | +
Returns : |
+The value of key on device split into tokens or NULL if key doesn't exist. This array is owned by device and should not be freed by the caller. [transfer none][array zero-terminated=1][element-type utf8]
+ |
+
const gchar * g_udev_device_get_sysfs_attr (+GUdevDevice *device, +const gchar *name);
+Look up the sysfs attribute with name on device.
+
|
+A GUdevDevice. | +
|
+Name of the sysfs attribute. | +
Returns : |
+The value of the sysfs attribute or NULL if there is no
+such attribute. Do not free this string, it is owned by device. |
+
gint g_udev_device_get_sysfs_attr_as_int (+GUdevDevice *device, +const gchar *name);
+Look up the sysfs attribute with name on device and convert it to an integer
+using strtol().
+
|
+A GUdevDevice. | +
|
+Name of the sysfs attribute. | +
Returns : |
+The value of the sysfs attribute or 0 if there is no such +attribute. | +
guint64 g_udev_device_get_sysfs_attr_as_uint64 + (+GUdevDevice *device, +const gchar *name);
+Look up the sysfs attribute with name on device and convert it to an unsigned
+64-bit integer using g_ascii_strtoull().
+
|
+A GUdevDevice. | +
|
+Name of the sysfs attribute. | +
Returns : |
+The value of the sysfs attribute or 0 if there is no such +attribute. | +
gdouble g_udev_device_get_sysfs_attr_as_double + (+GUdevDevice *device, +const gchar *name);
+Look up the sysfs attribute with name on device and convert it to a double
+precision floating point number using strtod().
+
|
+A GUdevDevice. | +
|
+Name of the sysfs attribute. | +
Returns : |
+The value of the sysfs attribute or 0.0 if there is no such +attribute. | +
gboolean g_udev_device_get_sysfs_attr_as_boolean + (+GUdevDevice *device, +const gchar *name);
+Look up the sysfs attribute with name on device and convert it to an
+boolean. This is done by doing a case-insensitive string comparison
+on the string value against "1" and "true".
+
|
+A GUdevDevice. | +
|
+Name of the sysfs attribute. | +
Returns : |
+The value of the sysfs attribute or FALSE if there is no such
+attribute. |
+
const gchar * const * g_udev_device_get_sysfs_attr_as_strv + (+GUdevDevice *device, +const gchar *name);
+Look up the sysfs attribute with name on device and return the result of
+splitting it into non-empty tokens split at white space (only space (' '),
+form-feed ('\f'), newline ('\n'), carriage return ('\r'), horizontal
+tab ('\t'), and vertical tab ('\v') are considered; the locale is
+not taken into account).
+
|
+A GUdevDevice. | +
|
+Name of the sysfs attribute. | +
Returns : |
+The value of the sysfs attribute split into tokens or NULL if there is no such attribute. This array is owned by device and should not be freed by the caller. [transfer none][array zero-terminated=1][element-type utf8]
+ |
+
|
+ |
+ |
+GUdev Reference Manual | + |
+
|---|---|---|---|---|
| +Top + | + Description + | + Object Hierarchy + | + Properties + | ||||
GUdevEnumerator; +struct GUdevEnumeratorClass; +GUdevEnumerator * g_udev_enumerator_new (+GUdevClient *client); +GUdevEnumerator * g_udev_enumerator_add_match_subsystem + (GUdevEnumerator *enumerator, +const gchar *subsystem); +GUdevEnumerator * g_udev_enumerator_add_nomatch_subsystem + (GUdevEnumerator *enumerator, +const gchar *subsystem); +GUdevEnumerator * g_udev_enumerator_add_match_sysfs_attr + (GUdevEnumerator *enumerator, +const gchar *name, +const gchar *value); +GUdevEnumerator * g_udev_enumerator_add_nomatch_sysfs_attr + (GUdevEnumerator *enumerator, +const gchar *name, +const gchar *value); +GUdevEnumerator * g_udev_enumerator_add_match_property + (GUdevEnumerator *enumerator, +const gchar *name, +const gchar *value); +GUdevEnumerator * g_udev_enumerator_add_match_name (GUdevEnumerator *enumerator, +const gchar *name); +GUdevEnumerator * g_udev_enumerator_add_match_tag (GUdevEnumerator *enumerator, +const gchar *tag); +GUdevEnumerator * g_udev_enumerator_add_match_is_initialized + (GUdevEnumerator *enumerator); +GUdevEnumerator * g_udev_enumerator_add_sysfs_path (GUdevEnumerator *enumerator, +const gchar *sysfs_path); +GList * g_udev_enumerator_execute (GUdevEnumerator *enumerator); +
typedef struct _GUdevEnumerator GUdevEnumerator;+
+The GUdevEnumerator struct is opaque and should not be accessed directly. +
+Since 165
+struct GUdevEnumeratorClass {
+ GObjectClass parent_class;
+};
+
++Class structure for GUdevEnumerator. +
+ +Since 165
+GUdevEnumerator * g_udev_enumerator_new (GUdevClient *client);
+
+Constructs a GUdevEnumerator object that can be used to enumerate
+and sort devices. Use the add_match_*() and add_nomatch_*() methods
+and execute the query to get a list of devices with
+g_udev_enumerator_execute().
+
|
+A GUdevClient to enumerate devices from. | +
Returns : |
+A new GUdevEnumerator object. Free with g_object_unref(). |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_match_subsystem + (+GUdevEnumerator *enumerator, +const gchar *subsystem);
+All returned devices will match the given subsystem.
+
|
+A GUdevEnumerator. | +
|
+Wildcard for subsystem name e.g. 'scsi' or 'a*'. | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_nomatch_subsystem + (+GUdevEnumerator *enumerator, +const gchar *subsystem);
+All returned devices will not match the given subsystem.
+
|
+A GUdevEnumerator. | +
|
+Wildcard for subsystem name e.g. 'scsi' or 'a*'. | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_match_sysfs_attr + (+GUdevEnumerator *enumerator, +const gchar *name, +const gchar *value);
+All returned devices will have a sysfs attribute matching the given name and value.
+
|
+A GUdevEnumerator. | +
|
+Wildcard filter for sysfs attribute key. | +
|
+Wildcard filter for sysfs attribute value. | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_nomatch_sysfs_attr + (+GUdevEnumerator *enumerator, +const gchar *name, +const gchar *value);
+All returned devices will not have a sysfs attribute matching the given name and value.
+
|
+A GUdevEnumerator. | +
|
+Wildcard filter for sysfs attribute key. | +
|
+Wildcard filter for sysfs attribute value. | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_match_property + (+GUdevEnumerator *enumerator, +const gchar *name, +const gchar *value);
+All returned devices will have a property matching the given name and value.
+
|
+A GUdevEnumerator. | +
|
+Wildcard filter for property name. | +
|
+Wildcard filter for property value. | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_match_name (+GUdevEnumerator *enumerator, +const gchar *name);
+All returned devices will match the given name.
+
|
+A GUdevEnumerator. | +
|
+Wildcard filter for kernel name e.g. "sda*". | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_match_tag (+GUdevEnumerator *enumerator, +const gchar *tag);
+All returned devices will match the given tag.
+
|
+A GUdevEnumerator. | +
|
+A udev tag e.g. "udev-acl". | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_match_is_initialized
+ (GUdevEnumerator *enumerator);
++All returned devices will be initialized. +
+
|
+A GUdevEnumerator. | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GUdevEnumerator * g_udev_enumerator_add_sysfs_path (+GUdevEnumerator *enumerator, +const gchar *sysfs_path);
+Add a device to the list of devices, to retrieve it back sorted in dependency order. +
+
|
+A GUdevEnumerator. | +
|
+A sysfs path, e.g. "/sys/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda" | +
Returns : |
+The passed in enumerator. [transfer none]
+ |
+
Since 165
+GList * g_udev_enumerator_execute (GUdevEnumerator *enumerator);
+
+Executes the query in enumerator.
+
|
+A GUdevEnumerator. | +
Returns : |
+A list of GUdevDevice objects. The caller should free the result by using g_object_unref() on each element in the list and then g_list_free() on the list. [element-type GUdevDevice][transfer full]
+ |
+
Since 165
+"client" property"client" GUdevClient* : Read / Write / Construct Only+
+The GUdevClient to enumerate devices from. +
+Since 165
+ |
++ | |
+GUdev Reference Manual | ++ |
|---|---|---|---|---|
| +A + | + E + | + T + | ||||
Parameter points to an array of items.
NULL is ok, both for passing and for returning.
Generics and defining elements of containers and arrays.
Free data after the code is done.
Don't free data after the code is done.
|
++ | |
+GUdev Reference Manual | + |
+
|---|
|
++ | |
+GUdev Reference Manual | + |
+
|---|---|---|---|---|
| +C + | + D + | + E + | + G + | ||||
|
++ | |
+GUdev Reference Manual | + |
+
|---|
+ GObject + GUdevDevice + GUdevClient + GUdevEnumerator + GEnum + GUdevDeviceType ++
GUdev Reference Manual |
|---|
+ For version 199 + — the latest version of this + documentation can be found at + + http://www.freedesktop.org/software/systemd/gudev/ + . +
Copyright © 2009-2012 David Zeuthen <davidz@redhat.com>, Bastien Nocera <hadess@hadess.net>
|
++ | |
+GUdev Reference Manual | + |
+
|---|---|---|---|---|
| +D + | + E + | + G + | ||||
|
++ | |
+GUdev Reference Manual | + |
+
|---|