PkDesktop: PackageKit Reference Manual

PkDesktop

PkDesktop — Find desktop metadata about a package

Functions

PkDesktop *	pk_desktop_new ()
gboolean	pk_desktop_open_database ()
GPtrArray *	pk_desktop_get_files_for_package ()
GPtrArray *	pk_desktop_get_shown_for_package ()
gchar *	pk_desktop_get_package_for_file ()

Types and Values

#define	PK_DESKTOP_DEFAULT_DATABASE
#define	PK_DESKTOP_DEFAULT_APPLICATION_DIR

Description

Desktop metadata such as icon name and localised summary may be stored in a local sqlite cache, and this module allows applications to query this.

Functions

pk_desktop_new ()

PkDesktop *
pk_desktop_new (void);

NOTE: This method is unused and will be removed next time the library soname changes!

Since: 0.5.3

pk_desktop_open_database ()

gboolean
pk_desktop_open_database (PkDesktop *desktop,
                          GError **error);

This method is unused and will be removed next time the library soname changes!

Parameters

desktop	a valid PkDesktop instance
error	a GError to put the error code and message in, or `NULL`

Returns

TRUE if opened correctly

Since: 0.5.3

pk_desktop_get_files_for_package ()

GPtrArray *
pk_desktop_get_files_for_package (PkDesktop *desktop,
                                  const gchar *package,
                                  GError **error);

Return all desktop files owned by a package, regardless if they are shown in the main menu or not.

Parameters

desktop	a valid PkDesktop instance
package	the package name, e.g. "gnome-power-manager"
error	a GError to put the error code and message in, or `NULL`

Returns

string array of results, free with g_ptr_array_unref()

NOTE: This method is unused and will be removed next time the library soname changes!.

[transfer container][element-type utf8]

Since: 0.5.3

pk_desktop_get_shown_for_package ()

GPtrArray *
pk_desktop_get_shown_for_package (PkDesktop *desktop,
                                  const gchar *package,
                                  GError **error);

Return all desktop files owned by a package that would be shown in a menu, i.e are an application

Parameters

desktop	a valid PkDesktop instance
package	the package name, e.g. "gnome-power-manager"
error	a GError to put the error code and message in, or `NULL`

Returns

string array of results, free with g_ptr_array_unref()

NOTE: This method is unused and will be removed next time the library soname changes!.

[transfer container][element-type utf8]

Since: 0.5.3

pk_desktop_get_package_for_file ()

gchar *
pk_desktop_get_package_for_file (PkDesktop *desktop,
                                 const gchar *filename,
                                 GError **error);

Returns the package name that owns the desktop file. Fast.

Parameters

desktop	a valid PkDesktop instance
filename	a fully qualified filename
error	a GError to put the error code and message in, or `NULL`

Returns

package name, or NULL

NOTE: This method is unused and will be removed next time the library soname changes!

Since: 0.5.3

Types and Values

PK_DESKTOP_DEFAULT_DATABASE

#define PK_DESKTOP_DEFAULT_DATABASE		LOCALSTATEDIR "/lib/PackageKit/desktop-files.db"

The default location for the database

PK_DESKTOP_DEFAULT_APPLICATION_DIR

#define PK_DESKTOP_DEFAULT_APPLICATION_DIR "/usr/share/applications"

The default location for the desktop files