![]() |
![]() |
![]() |
PackageKit Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties |
#define PK_CLIENT_ERROR #define PK_CLIENT_TYPE_ERROR struct PkClient; struct PkClientClass; enum PkClientError;void pk_client_accept_eula_async (PkClient *client
,const
,gchar *eula_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_adopt_async (PkClient *client
,const
,gchar *transaction_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_download_packages_async (PkClient *client
,,
gchar **package_idsconst
,gchar *directory,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_dataGQuark pk_client_error_quark (void
); PkResults * pk_client_generic_finish (PkClient *client
,,
GAsyncResult *res);
GError **errorgboolean pk_client_get_background (PkClient *client
);guint pk_client_get_cache_age (PkClient *client
);void pk_client_get_categories_async (PkClient *client
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_depends_async (PkClient *client
,PkBitfield filters
,,
gchar **package_ids,
gboolean recursive,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_details_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_distro_upgrades_async (PkClient *client
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_files_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datagboolean pk_client_get_idle (PkClient *client
);gboolean pk_client_get_interactive (PkClient *client
); constgchar * pk_client_get_locale (PkClient *client
);void pk_client_get_old_transactions_async (PkClient *client
,,
guint number,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_packages_async (PkClient *client
,PkBitfield filters
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_progress_async (PkClient *client
,const
,gchar *transaction_id,
GCancellable *cancellable,
GAsyncReadyCallback callback_ready); PkProgress * pk_client_get_progress_finish (
gpointer user_dataPkClient *client
,,
GAsyncResult *res);
GError **errorvoid pk_client_get_repo_list_async (PkClient *client
,PkBitfield filters
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_requires_async (PkClient *client
,PkBitfield filters
,,
gchar **package_ids,
gboolean recursive,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_update_detail_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_get_updates_async (PkClient *client
,PkBitfield filters
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_install_files_async (PkClient *client
,,
gboolean only_trusted,
gchar **files,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_install_packages_async (PkClient *client
,,
gboolean only_trusted,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_install_signature_async (PkClient *client
,PkSigTypeEnum type
,const
,gchar *key_idconst
,gchar *package_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready); PkClient * pk_client_new (
gpointer user_datavoid
);void pk_client_refresh_cache_async (PkClient *client
,,
gboolean force,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_remove_packages_async (PkClient *client
,,
gchar **package_ids,
gboolean allow_deps,
gboolean autoremove,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_repo_enable_async (PkClient *client
,const
,gchar *repo_id,
gboolean enabled,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_repo_set_data_async (PkClient *client
,const
,gchar *repo_idconst
,gchar *parameterconst
,gchar *value,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_resolve_async (PkClient *client
,PkBitfield filters
,,
gchar **packages,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_rollback_async (PkClient *client
,const
,gchar *transaction_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_search_details_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_search_files_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_search_groups_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_search_names_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_set_background (PkClient *client
,);
gboolean backgroundvoid pk_client_set_cache_age (PkClient *client
,);
guint cache_agevoid pk_client_set_interactive (PkClient *client
,);
gboolean interactivevoid pk_client_set_locale (PkClient *client
,const
);gchar *localevoid pk_client_simulate_install_files_async (PkClient *client
,,
gchar **files,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_simulate_install_packages_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_simulate_remove_packages_async (PkClient *client
,,
gchar **package_ids,
gboolean autoremove,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_simulate_update_packages_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_test ();
gpointer user_datavoid pk_client_update_packages_async (PkClient *client
,,
gboolean only_trusted,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_update_system_async (PkClient *client
,,
gboolean only_trusted,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_upgrade_system_async (PkClient *client
,const
,gchar *distro_idPkUpgradeKindEnum upgrade_kind
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_datavoid pk_client_what_provides_async (PkClient *client
,PkBitfield filters
,PkProvidesEnum provides
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
"background"gboolean : Read / Write "cache-age"guint : Read / Write "idle"gboolean : Read "interactive"gboolean : Read / Write "locale"gchar * : Read / Write
A GObject to use for accessing PackageKit asynchronously. If you're using PkClient to install, remove, or update packages, be prepared that the eula, gpg and trusted callbacks need to be rescheduled manually, as in http://www.packagekit.org/gtk-doc/introduction-ideas-transactions.html
struct PkClientClass { GObjectClass parent_class; /* signals */ void (* changed) (PkClient *client); /* padding for future expansion */ void (*_pk_reserved1) (void); void (*_pk_reserved2) (void); void (*_pk_reserved3) (void); void (*_pk_reserved4) (void); void (*_pk_reserved5) (void); };
typedef enum { PK_CLIENT_ERROR_FAILED, PK_CLIENT_ERROR_FAILED_AUTH, PK_CLIENT_ERROR_NO_TID, PK_CLIENT_ERROR_ALREADY_TID, PK_CLIENT_ERROR_ROLE_UNKNOWN, PK_CLIENT_ERROR_CANNOT_START_DAEMON, PK_CLIENT_ERROR_INVALID_INPUT, PK_CLIENT_ERROR_INVALID_FILE, PK_CLIENT_ERROR_NOT_SUPPORTED, PK_CLIENT_ERROR_DECLINED_SIMULATION, /* we define this so we can punt the PkErrorEnums here */ PK_CLIENT_ERROR_LAST } PkClientError;
Errors that can be thrown
the transaction failed for an unknown reason | |
the transaction id was not pre-allocated (internal error) | |
the transaction id has already been used (internal error) | |
the role was not set (internal error) | |
the package_id is invalid | |
the file is invalid | |
the action is not supported | |
the simulation was declined by the user | |
void pk_client_accept_eula_async (PkClient *client
,const
,gchar *eula_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
We may want to agree to a EULA dialog if one is presented.
|
a valid PkClient instance |
|
the eula_id we are agreeing to |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_adopt_async (PkClient *client
,const
,gchar *transaction_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Adopt a transaction which allows the caller to monitor the state or cancel it.
|
a valid PkClient instance |
|
a transaction ID such as "/21_ebcbdaae_data" |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_download_packages_async (PkClient *client
,,
gchar **package_idsconst
,gchar *directory,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Downloads package files to a specified location.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
the location where packages are to be downloaded |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
GQuark pk_client_error_quark (void
);
Returns : |
Our personal error quark. |
Since 0.5.2
PkResults * pk_client_generic_finish (PkClient *client
,,
GAsyncResult *res);
GError **error
Gets the result from the asynchronous function.
|
a valid PkClient instance |
|
the |
|
A NULL |
Returns : |
the PkResults, or NULL g_object_unref() |
Since 0.5.2
gboolean pk_client_get_background (PkClient *client
);
Gets the background value.
|
a valid PkClient instance |
Returns : |
The background status. |
Since 0.6.10
guint pk_client_get_cache_age (PkClient *client
);
Gets the maximum cache age value.
|
a valid PkClient instance |
Returns : |
The cache age in seconds |
Since 0.6.10
void pk_client_get_categories_async (PkClient *client
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get a list of all categories supported.
|
a valid PkClient instance |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_depends_async (PkClient *client
,PkBitfield filters
,,
gchar **package_ids,
gboolean recursive,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get the packages that depend this one, i.e. child->parent.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
If we should search recursively for depends |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_details_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get details of a package, so more information can be obtained for GUI or command line tools.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_distro_upgrades_async (PkClient *client
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
This method should return a list of distribution upgrades that are available. It should not return updates, only major upgrades.
|
a valid PkClient instance |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_files_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get the file list (i.e. a list of files installed) for the specified package.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
gboolean pk_client_get_idle (PkClient *client
);
Gets if the transaction client idle value.
|
a valid PkClient instance |
Returns : |
if this client is idle. |
Since 0.6.10
gboolean pk_client_get_interactive (PkClient *client
);
Gets the client interactive value.
|
a valid PkClient instance |
Returns : |
if the transaction is due to run interactivly. |
Since 0.6.10
constgchar * pk_client_get_locale (PkClient *client
);
Gets the locale used for this transaction.
|
a valid PkClient instance |
Returns : |
The locale. |
Since 0.6.10
void pk_client_get_old_transactions_async (PkClient *client
,,
guint number,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get the old transaction list, mainly used for the rollback viewer.
|
a valid PkClient instance |
|
the number of past transactions to return, or 0 for all |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_packages_async (PkClient *client
,PkBitfield filters
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get the list of packages from the backend
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_progress_async (PkClient *client
,const
,gchar *transaction_id,
GCancellable *cancellable,
GAsyncReadyCallback callback_ready);
gpointer user_data
Find the current state of a transaction.
|
a valid PkClient instance |
|
a transaction ID such as "/21_ebcbdaae_data" |
|
a NULL |
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
PkProgress * pk_client_get_progress_finish (PkClient *client
,,
GAsyncResult *res);
GError **error
Gets the result from the asynchronous function.
|
a valid PkClient instance |
|
the |
|
A NULL |
Returns : |
the PkProgress, or NULL g_object_unref() |
Since 0.5.2
void pk_client_get_repo_list_async (PkClient *client
,PkBitfield filters
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get the list of repositories installed on the system.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_DEVEL PK_FILTER_ENUM_NONE |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_requires_async (PkClient *client
,PkBitfield filters
,,
gchar **package_ids,
gboolean recursive,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get the packages that require this one, i.e. parent->child.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
If we should search recursively for requires |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_update_detail_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get details about the specific update, for instance any CVE urls and severity information.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_get_updates_async (PkClient *client
,PkBitfield filters
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Get a list of all the packages that can be updated for all repositories.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_DEVEL PK_FILTER_ENUM_NONE |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_install_files_async (PkClient *client
,,
gboolean only_trusted,
gchar **files,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Install a file locally, and get the deps from the repositories. This is useful for double clicking on a .rpm or .deb file.
|
a valid PkClient instance |
|
only trusted packages should be installed |
|
a file such as "/home/hughsie/Desktop/hal-devel-0.10.0.rpm". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_install_packages_async (PkClient *client
,,
gboolean only_trusted,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Install a package of the newest and most correct version.
|
a valid PkClient instance |
|
only trusted packages should be installed |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_install_signature_async (PkClient *client
,PkSigTypeEnum type
,const
,gchar *key_idconst
,gchar *package_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Install a software source signature of the newest and most correct version.
|
a valid PkClient instance |
|
the signature type, e.g. PK_SIGTYPE_ENUM_GPG |
|
a key ID such as "0df23df" |
|
a signature_id structure such as "hal;0.0.1;i386;fedora" |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
PkClient * pk_client_new (void
);
PkClient is a nice GObject wrapper for PackageKit and makes writing frontends easy.
Returns : |
A new PkClient instance |
Since 0.5.2
void pk_client_refresh_cache_async (PkClient *client
,,
gboolean force,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Refresh the cache, i.e. download new metadata from a remote URL so that package lists are up to date. This action may take a few minutes and should be done when the session and system are idle.
|
a valid PkClient instance |
|
if we should aggressively drop caches |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_remove_packages_async (PkClient *client
,,
gchar **package_ids,
gboolean allow_deps,
gboolean autoremove,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Remove a package (optionally with dependancies) from the system.
If allow_deps
FALSE
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
if other dependant packages are allowed to be removed from the computer |
|
if other packages installed at the same time should be tried to remove |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_repo_enable_async (PkClient *client
,const
,gchar *repo_id,
gboolean enabled,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Enable or disable the repository.
|
a valid PkClient instance |
|
a repo_id structure such as "livna-devel" |
|
if we should enable the repository |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_repo_set_data_async (PkClient *client
,const
,gchar *repo_idconst
,gchar *parameterconst
,gchar *value,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
We may want to set a repository parameter. NOTE: this is free text, and is left to the backend to define a format.
|
a valid PkClient instance |
|
a repo_id structure such as "livna-devel" |
|
the parameter to change |
|
what we should change it to |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_resolve_async (PkClient *client
,PkBitfield filters
,,
gchar **packages,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Resolve a package name into a package_id
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
an array of package names to resolve, e.g. "gnome-system-tools". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_rollback_async (PkClient *client
,const
,gchar *transaction_id,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
We may want to agree to a EULA dialog if one is presented.
|
a valid PkClient instance |
|
the transaction_id we want to return to |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_search_details_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Search all detailed summary information to try and find a keyword.
Think of this as pk_client_search_names()
, but trying much harder and
taking longer.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
free text to search for, for instance, "power". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.5
void pk_client_search_files_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Search for packages that provide a specific file.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
file to search for, for instance, "/sbin/service". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.5
void pk_client_search_groups_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Return all packages in a specific group.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
a group enum to search for, for instance, "system-tools". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.5
void pk_client_search_names_async (PkClient *client
,PkBitfield filters
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Search all the locally installed files and remote repositories for a package that matches a specific name.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
free text to search for, for instance, "power". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.5
void pk_client_set_background (PkClient *client
,);
gboolean background
Sets the background value for the client. A background transaction is usually scheduled at a lower priority and is usually given less network and disk performance.
|
a valid PkClient instance |
|
if the transaction is a background transaction |
Since 0.6.10
void pk_client_set_cache_age (PkClient *client
,);
guint cache_age
Sets the maximum cache age value for the client.
|
a valid PkClient instance |
|
the cache age to set |
Since 0.6.10
void pk_client_set_interactive (PkClient *client
,);
gboolean interactive
Sets the interactive value for the client. Interactive transactions are usally allowed to ask the user questions.
|
a valid PkClient instance |
|
the value to set |
Since 0.6.10
void pk_client_set_locale (PkClient *client
,const
);gchar *locale
Sets the locale to be used for the client. This may affect returned results.
|
a valid PkClient instance |
|
the locale to set, e.g. "en_GB.UTF-8" |
Since 0.6.10
void pk_client_simulate_install_files_async (PkClient *client
,,
gchar **files,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Simulate an installation of files.
|
a valid PkClient instance |
|
a file such as "/home/hughsie/Desktop/hal-devel-0.10.0.rpm". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_simulate_install_packages_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Simulate an installation of packages.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_simulate_remove_packages_async (PkClient *client
,,
gchar **package_ids,
gboolean autoremove,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Simulate a removal of packages.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
if other packages installed at the same time should be tried to remove |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_simulate_update_packages_async (PkClient *client
,,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Simulate an update of packages.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_update_packages_async (PkClient *client
,,
gboolean only_trusted,
gchar **package_ids,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Update specific packages to the newest available versions.
|
a valid PkClient instance |
|
only trusted packages should be installed |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_update_system_async (PkClient *client
,,
gboolean only_trusted,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
Update all the packages on the system with the highest versions found in all repositories. NOTE: you can't choose what repositories to update from, but you can do:
pk_client_repo_disable()
|
a valid PkClient instance |
|
only trusted packages should be installed |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_client_upgrade_system_async (PkClient *client
,const
,gchar *distro_idPkUpgradeKindEnum upgrade_kind
,,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
This transaction will update the distro to the next version, which may involve just downloading the installer and setting up the boot device, or may involve doing an on-line upgrade.
The backend will decide what is best to do.
|
a valid PkClient instance |
|
a distro ID such as "fedora-14" |
|
a PkUpgradeKindEnum such as PK_UPGRADE_KIND_ENUM_COMPLETE |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.6.11
void pk_client_what_provides_async (PkClient *client
,PkBitfield filters
,PkProvidesEnum provides
,,
gchar **values,
GCancellable *cancellablePkProgressCallback progress_callback
,,
gpointer progress_user_data,
GAsyncReadyCallback callback_ready);
gpointer user_data
This should return packages that provide the supplied attributes. This method is useful for finding out what package(s) provide a modalias or GStreamer codec string.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI PK_FILTER_ENUM_FREE PK_FILTER_ENUM_NONE |
|
a PkProvidesEnum value such as PK_PROVIDES_ENUM_CODEC |
|
a search term such as "sound/mp3". [array zero-terminated=1] |
|
a NULL |
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2