Method

AppStreamSystemInfoget_device_name_for_modalias

Declaration [src] 

gchar*
as_system_info_get_device_name_for_modalias (
  AsSystemInfo* sysinfo,
  const gchar* modalias,
  gboolean allow_fallback,
  GError** error
)

Description [src]

Return a human readable device name for the given modalias. Will return the modalias again if no device name could be found, and returns NULL on error. If allow_fallback is set to FALSE, this function will return NULL and error AS_SYSTEM_INFO_ERROR_NOT_FOUND in case no suitable description could be found.

Parameters

modalias

Type: const gchar*

The modalias value to resolve (may contain wildcards).

The data is owned by the caller of the method.
The value is a NUL terminated UTF-8 string.
allow_fallback

Type: gboolean

Fall back to low-quality data if no better information is available.

error

Type: GError **

The return location for a recoverable error.

The argument can be NULL.
If the return location is not NULL, then you must initialize it to a NULL GError*.
The argument will be left initialized to NULL by the method if there are no errors.
In case of error, the argument will be set to a newly allocated GError; the caller will take ownership of the data, and be responsible for freeing it.

Return value

Type: gchar*

A human-readable device name, or NULL on error.

The caller of the method takes ownership of the returned data, and is responsible for freeing it.
The value is a NUL terminated UTF-8 string.