<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
               "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY version SYSTEM "version.xml">
]>
<refentry id="PkClient">
<refmeta>
<refentrytitle role="top_of_page" id="PkClient.top_of_page">PkClient</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PACKAGEKIT Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>PkClient</refname>
<refpurpose>For creating new transactions</refpurpose>
</refnamediv>

<refsynopsisdiv id="PkClient.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
#define             <link linkend="PK-CLIENT-ERROR--CAPS">PK_CLIENT_ERROR</link>
#define             <link linkend="PK-CLIENT-TYPE-ERROR--CAPS">PK_CLIENT_TYPE_ERROR</link>
enum                <link linkend="PkClientError">PkClientError</link>;
                    <link linkend="PkClientPrivate">PkClientPrivate</link>;
                    <link linkend="PkClient-struct">PkClient</link>;
<link linkend="GQuark">GQuark</link>              <link linkend="pk-client-error-quark">pk_client_error_quark</link>               (void);
<link linkend="PkClient">PkClient</link> *          <link linkend="pk-client-new">pk_client_new</link>                       (void);
<link linkend="void">void</link>                <link linkend="pk-client-test">pk_client_test</link>                      (<link linkend="gpointer">gpointer</link> user_data);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-generic-finish">pk_client_generic_finish</link>            (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-client-resolve-async">pk_client_resolve_async</link>             (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **packages,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-search-names-async">pk_client_search_names_async</link>        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-search-details-async">pk_client_search_details_async</link>      (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-search-groups-async">pk_client_search_groups_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-search-files-async">pk_client_search_files_async</link>        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-details-async">pk_client_get_details_async</link>         (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-update-detail-async">pk_client_get_update_detail_async</link>   (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-download-packages-async">pk_client_download_packages_async</link>   (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         const <link linkend="gchar">gchar</link> *directory,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-updates-async">pk_client_get_updates_async</link>         (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-old-transactions-async">pk_client_get_old_transactions_async</link>
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="guint">guint</link> number,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-update-system-async">pk_client_update_system_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-depends-async">pk_client_get_depends_async</link>         (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="gboolean">gboolean</link> recursive,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-packages-async">pk_client_get_packages_async</link>        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-requires-async">pk_client_get_requires_async</link>        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="gboolean">gboolean</link> recursive,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-what-provides-async">pk_client_what_provides_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="PkProvidesEnum">PkProvidesEnum</link> provides,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-distro-upgrades-async">pk_client_get_distro_upgrades_async</link> (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-files-async">pk_client_get_files_async</link>           (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-categories-async">pk_client_get_categories_async</link>      (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-remove-packages-async">pk_client_remove_packages_async</link>     (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="gboolean">gboolean</link> allow_deps,
                                                         <link linkend="gboolean">gboolean</link> autoremove,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-refresh-cache-async">pk_client_refresh_cache_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> force,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-install-packages-async">pk_client_install_packages_async</link>    (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-install-signature-async">pk_client_install_signature_async</link>   (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkSigTypeEnum">PkSigTypeEnum</link> type,
                                                         const <link linkend="gchar">gchar</link> *key_id,
                                                         const <link linkend="gchar">gchar</link> *package_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-update-packages-async">pk_client_update_packages_async</link>     (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-install-files-async">pk_client_install_files_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="gchar">gchar</link> **files,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-accept-eula-async">pk_client_accept_eula_async</link>         (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *eula_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-rollback-async">pk_client_rollback_async</link>            (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-get-repo-list-async">pk_client_get_repo_list_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-repo-enable-async">pk_client_repo_enable_async</link>         (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *repo_id,
                                                         <link linkend="gboolean">gboolean</link> enabled,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-repo-set-data-async">pk_client_repo_set_data_async</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *repo_id,
                                                         const <link linkend="gchar">gchar</link> *parameter,
                                                         const <link linkend="gchar">gchar</link> *value,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-simulate-install-files-async">pk_client_simulate_install_files_async</link>
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **files,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-simulate-install-packages-async">pk_client_simulate_install_packages_async</link>
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-simulate-remove-packages-async">pk_client_simulate_remove_packages_async</link>
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-simulate-update-packages-async">pk_client_simulate_update_packages_async</link>
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-client-adopt-async">pk_client_adopt_async</link>               (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="PkProgress">PkProgress</link> *        <link linkend="pk-client-get-progress-finish">pk_client_get_progress_finish</link>       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-client-get-progress-async">pk_client_get_progress_async</link>        (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);
</synopsis>
</refsynopsisdiv>

<refsect1 id="PkClient.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<synopsis>
  <link linkend="GObject">GObject</link>
   +----PkClient
         +----<link linkend="PkTask">PkTask</link>
</synopsis>
</refsect1>





<refsect1 id="PkClient.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="PkClient--background">background</link>&quot;               <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="PkClient--idle">idle</link>&quot;                     <link linkend="gboolean">gboolean</link>              : Read
  &quot;<link linkend="PkClient--interactive">interactive</link>&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="PkClient--locale">locale</link>&quot;                   <link linkend="gchar">gchar</link>*                : Read / Write
</synopsis>
</refsect1>



<refsect1 id="PkClient.description" role="desc">
<title role="desc.title">Description</title>
<para>
A GObject to use for accessing PackageKit asynchronously. If you're
using <link linkend="PkClient"><type>PkClient</type></link> 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</para>
<para>
</para>
</refsect1>

<refsect1 id="PkClient.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PK-CLIENT-ERROR--CAPS" role="macro">
<title>PK_CLIENT_ERROR</title>
<indexterm zone="PK-CLIENT-ERROR--CAPS"><primary sortas="PK_CLIENT_ERROR">PK_CLIENT_ERROR</primary></indexterm><programlisting>#define PK_CLIENT_ERROR		(pk_client_error_quark ())
</programlisting>
<para>
</para></refsect2>
<refsect2 id="PK-CLIENT-TYPE-ERROR--CAPS" role="macro">
<title>PK_CLIENT_TYPE_ERROR</title>
<indexterm zone="PK-CLIENT-TYPE-ERROR--CAPS"><primary sortas="PK_CLIENT_TYPE_ERROR">PK_CLIENT_TYPE_ERROR</primary></indexterm><programlisting>#define PK_CLIENT_TYPE_ERROR	(pk_client_error_get_type ())
</programlisting>
<para>
</para></refsect2>
<refsect2 id="PkClientError" role="enum">
<title>enum PkClientError</title>
<indexterm zone="PkClientError"><primary sortas="PkClientError">PkClientError</primary></indexterm><programlisting>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
} PkClientError;
</programlisting>
<para>
Errors that can be thrown</para>
<para>
</para><variablelist role="enum">
<varlistentry id="PK-CLIENT-ERROR-FAILED--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_FAILED</literal></term>
<listitem><simpara> the transaction failed for an unknown reason
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-FAILED-AUTH--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_FAILED_AUTH</literal></term>
<listitem><simpara>
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-NO-TID--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_NO_TID</literal></term>
<listitem><simpara> the transaction id was not pre-allocated (internal error)
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-ALREADY-TID--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_ALREADY_TID</literal></term>
<listitem><simpara> the transaction id has already been used (internal error)
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-ROLE-UNKNOWN--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_ROLE_UNKNOWN</literal></term>
<listitem><simpara> the role was not set (internal error)
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-CANNOT-START-DAEMON--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_CANNOT_START_DAEMON</literal></term>
<listitem><simpara>
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-INVALID-INPUT--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_INVALID_INPUT</literal></term>
<listitem><simpara> the package_id is invalid
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-INVALID-FILE--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_INVALID_FILE</literal></term>
<listitem><simpara> the file is invalid
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CLIENT-ERROR-NOT-SUPPORTED--CAPS" role="constant">
<term><literal>PK_CLIENT_ERROR_NOT_SUPPORTED</literal></term>
<listitem><simpara> the action is not supported
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PkClientPrivate" role="struct">
<title>PkClientPrivate</title>
<indexterm zone="PkClientPrivate"><primary sortas="PkClientPrivate">PkClientPrivate</primary></indexterm><programlisting>typedef struct _PkClientPrivate PkClientPrivate;</programlisting>
<para>
Private <link linkend="PkClient"><type>PkClient</type></link> data</para>
<para>
</para></refsect2>
<refsect2 id="PkClient-struct" role="struct">
<title>PkClient</title>
<indexterm zone="PkClient-struct"><primary sortas="PkClient">PkClient</primary></indexterm><programlisting>typedef struct _PkClient PkClient;</programlisting>
<para>
</para></refsect2>
<refsect2 id="pk-client-error-quark" role="function">
<title>pk_client_error_quark ()</title>
<indexterm zone="pk-client-error-quark"><primary sortas="pk_client_error_quark">pk_client_error_quark</primary></indexterm><programlisting><link linkend="GQuark">GQuark</link>              pk_client_error_quark               (void);</programlisting>
<para>
</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> Our personal error quark.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-new" role="function">
<title>pk_client_new ()</title>
<indexterm zone="pk-client-new"><primary sortas="pk_client_new">pk_client_new</primary></indexterm><programlisting><link linkend="PkClient">PkClient</link> *          pk_client_new                       (void);</programlisting>
<para>
PkClient is a nice GObject wrapper for PackageKit and makes writing
frontends easy.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A new <link linkend="PkClient"><literal>PkClient</literal></link> instance
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-test" role="function">
<title>pk_client_test ()</title>
<indexterm zone="pk-client-test"><primary sortas="pk_client_test">pk_client_test</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_test                      (<link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-generic-finish" role="function">
<title>pk_client_generic_finish ()</title>
<indexterm zone="pk-client-generic-finish"><primary sortas="pk_client_generic_finish">pk_client_generic_finish</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_generic_finish            (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="PkResults"><type>PkResults</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>. Free with <link linkend="g-object-unref"><function>g_object_unref()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-resolve-async" role="function">
<title>pk_client_resolve_async ()</title>
<indexterm zone="pk-client-resolve-async"><primary sortas="pk_client_resolve_async">pk_client_resolve_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_resolve_async             (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **packages,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Resolve a package name into a <link linkend="package-id"><literal>package_id</literal></link>. This can return installed and
available packages and allows you find out if a package is installed locally
or is available in a repository.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>packages</parameter>&#160;:</term>
<listitem><simpara> an array of package names to resolve, e.g. "gnome-system-tools"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-names-async" role="function">
<title>pk_client_search_names_async ()</title>
<indexterm zone="pk-client-search-names-async"><primary sortas="pk_client_search_names_async">pk_client_search_names_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_search_names_async        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Search all the locally installed files and remote repositories for a package
that matches a specific name.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>values</parameter>&#160;:</term>
<listitem><simpara> free text to search for, for instance, "power"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-details-async" role="function">
<title>pk_client_search_details_async ()</title>
<indexterm zone="pk-client-search-details-async"><primary sortas="pk_client_search_details_async">pk_client_search_details_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_search_details_async      (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Search all detailed summary information to try and find a keyword.
Think of this as <link linkend="pk-client-search-names"><function>pk_client_search_names()</function></link>, but trying much harder and
taking longer.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>values</parameter>&#160;:</term>
<listitem><simpara> free text to search for, for instance, "power"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-groups-async" role="function">
<title>pk_client_search_groups_async ()</title>
<indexterm zone="pk-client-search-groups-async"><primary sortas="pk_client_search_groups_async">pk_client_search_groups_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_search_groups_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Return all packages in a specific group.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>values</parameter>&#160;:</term>
<listitem><simpara> a group enum to search for, for instance, "system-tools"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-files-async" role="function">
<title>pk_client_search_files_async ()</title>
<indexterm zone="pk-client-search-files-async"><primary sortas="pk_client_search_files_async">pk_client_search_files_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_search_files_async        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Search for packages that provide a specific file.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>values</parameter>&#160;:</term>
<listitem><simpara> file to search for, for instance, "/sbin/service"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-details-async" role="function">
<title>pk_client_get_details_async ()</title>
<indexterm zone="pk-client-get-details-async"><primary sortas="pk_client_get_details_async">pk_client_get_details_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_details_async         (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get details of a package, so more information can be obtained for GUI
or command line tools.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-update-detail-async" role="function">
<title>pk_client_get_update_detail_async ()</title>
<indexterm zone="pk-client-get-update-detail-async"><primary sortas="pk_client_get_update_detail_async">pk_client_get_update_detail_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_update_detail_async   (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get details about the specific update, for instance any CVE urls and
severity information.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-download-packages-async" role="function">
<title>pk_client_download_packages_async ()</title>
<indexterm zone="pk-client-download-packages-async"><primary sortas="pk_client_download_packages_async">pk_client_download_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_download_packages_async   (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         const <link linkend="gchar">gchar</link> *directory,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Downloads package files to a specified location.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>directory</parameter>&#160;:</term>
<listitem><simpara> the location where packages are to be downloaded
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-updates-async" role="function">
<title>pk_client_get_updates_async ()</title>
<indexterm zone="pk-client-get-updates-async"><primary sortas="pk_client_get_updates_async">pk_client_get_updates_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_updates_async         (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get a list of all the packages that can be updated for all repositories.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-DEVEL--CAPS"><literal>PK_FILTER_ENUM_DEVEL</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-old-transactions-async" role="function">
<title>pk_client_get_old_transactions_async ()</title>
<indexterm zone="pk-client-get-old-transactions-async"><primary sortas="pk_client_get_old_transactions_async">pk_client_get_old_transactions_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_old_transactions_async
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="guint">guint</link> number,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get the old transaction list, mainly used for the rollback viewer.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>number</parameter>&#160;:</term>
<listitem><simpara> the number of past transactions to return, or 0 for all
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-update-system-async" role="function">
<title>pk_client_update_system_async ()</title>
<indexterm zone="pk-client-update-system-async"><primary sortas="pk_client_update_system_async">pk_client_update_system_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_update_system_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
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:
- <link linkend="pk-client-repo-disable"><function>pk_client_repo_disable()</function></link>
- <link linkend="pk-client-update-system"><function>pk_client_update_system()</function></link>
- <link linkend="pk-client-repo-enable"><function>pk_client_repo_enable()</function></link></para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>only_trusted</parameter>&#160;:</term>
<listitem><simpara> only trusted packages should be installed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-depends-async" role="function">
<title>pk_client_get_depends_async ()</title>
<indexterm zone="pk-client-get-depends-async"><primary sortas="pk_client_get_depends_async">pk_client_get_depends_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_depends_async         (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="gboolean">gboolean</link> recursive,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get the packages that depend this one, i.e. child->parent.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursive</parameter>&#160;:</term>
<listitem><simpara> If we should search recursively for depends
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-packages-async" role="function">
<title>pk_client_get_packages_async ()</title>
<indexterm zone="pk-client-get-packages-async"><primary sortas="pk_client_get_packages_async">pk_client_get_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_packages_async        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get the list of packages from the backend</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-requires-async" role="function">
<title>pk_client_get_requires_async ()</title>
<indexterm zone="pk-client-get-requires-async"><primary sortas="pk_client_get_requires_async">pk_client_get_requires_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_requires_async        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="gboolean">gboolean</link> recursive,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get the packages that require this one, i.e. parent->child.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>recursive</parameter>&#160;:</term>
<listitem><simpara> If we should search recursively for requires
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-what-provides-async" role="function">
<title>pk_client_what_provides_async ()</title>
<indexterm zone="pk-client-what-provides-async"><primary sortas="pk_client_what_provides_async">pk_client_what_provides_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_what_provides_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="PkProvidesEnum">PkProvidesEnum</link> provides,
                                                         <link linkend="gchar">gchar</link> **values,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
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.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-GUI--CAPS"><literal>PK_FILTER_ENUM_GUI</literal></link> | <link linkend="PK-FILTER-ENUM-FREE--CAPS"><literal>PK_FILTER_ENUM_FREE</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>provides</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkProvidesEnum"><type>PkProvidesEnum</type></link> value such as PK_PROVIDES_ENUM_CODEC
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>values</parameter>&#160;:</term>
<listitem><simpara> a search term such as "sound/mp3"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-distro-upgrades-async" role="function">
<title>pk_client_get_distro_upgrades_async ()</title>
<indexterm zone="pk-client-get-distro-upgrades-async"><primary sortas="pk_client_get_distro_upgrades_async">pk_client_get_distro_upgrades_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_distro_upgrades_async (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
This method should return a list of distribution upgrades that are available.
It should not return updates, only major upgrades.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-files-async" role="function">
<title>pk_client_get_files_async ()</title>
<indexterm zone="pk-client-get-files-async"><primary sortas="pk_client_get_files_async">pk_client_get_files_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_files_async           (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get the file list (i.e. a list of files installed) for the specified package.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-categories-async" role="function">
<title>pk_client_get_categories_async ()</title>
<indexterm zone="pk-client-get-categories-async"><primary sortas="pk_client_get_categories_async">pk_client_get_categories_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_categories_async      (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get a list of all categories supported.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-remove-packages-async" role="function">
<title>pk_client_remove_packages_async ()</title>
<indexterm zone="pk-client-remove-packages-async"><primary sortas="pk_client_remove_packages_async">pk_client_remove_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_remove_packages_async     (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="gboolean">gboolean</link> allow_deps,
                                                         <link linkend="gboolean">gboolean</link> autoremove,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Remove a package (optionally with dependancies) from the system.
If <link linkend="allow-deps"><literal>allow_deps</literal></link> is set to <link linkend="FALSE--CAPS"><literal>FALSE</literal></link>, and other packages would have to be removed,
then the transaction would fail.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>allow_deps</parameter>&#160;:</term>
<listitem><simpara> if other dependant packages are allowed to be removed from the computer
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>autoremove</parameter>&#160;:</term>
<listitem><simpara> if other packages installed at the same time should be tried to remove
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-refresh-cache-async" role="function">
<title>pk_client_refresh_cache_async ()</title>
<indexterm zone="pk-client-refresh-cache-async"><primary sortas="pk_client_refresh_cache_async">pk_client_refresh_cache_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_refresh_cache_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> force,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
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.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>force</parameter>&#160;:</term>
<listitem><simpara> if we should aggressively drop caches
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-install-packages-async" role="function">
<title>pk_client_install_packages_async ()</title>
<indexterm zone="pk-client-install-packages-async"><primary sortas="pk_client_install_packages_async">pk_client_install_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_install_packages_async    (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Install a package of the newest and most correct version.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>only_trusted</parameter>&#160;:</term>
<listitem><simpara> only trusted packages should be installed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-install-signature-async" role="function">
<title>pk_client_install_signature_async ()</title>
<indexterm zone="pk-client-install-signature-async"><primary sortas="pk_client_install_signature_async">pk_client_install_signature_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_install_signature_async   (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkSigTypeEnum">PkSigTypeEnum</link> type,
                                                         const <link linkend="gchar">gchar</link> *key_id,
                                                         const <link linkend="gchar">gchar</link> *package_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Install a software source signature of the newest and most correct version.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>type</parameter>&#160;:</term>
<listitem><simpara> the signature type, e.g. <link linkend="PK-SIGTYPE-ENUM-GPG--CAPS"><literal>PK_SIGTYPE_ENUM_GPG</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>key_id</parameter>&#160;:</term>
<listitem><simpara> a key ID such as "0df23df"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_id</parameter>&#160;:</term>
<listitem><simpara> a signature_id structure such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-update-packages-async" role="function">
<title>pk_client_update_packages_async ()</title>
<indexterm zone="pk-client-update-packages-async"><primary sortas="pk_client_update_packages_async">pk_client_update_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_update_packages_async     (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Update specific packages to the newest available versions.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>only_trusted</parameter>&#160;:</term>
<listitem><simpara> only trusted packages should be installed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-install-files-async" role="function">
<title>pk_client_install_files_async ()</title>
<indexterm zone="pk-client-install-files-async"><primary sortas="pk_client_install_files_async">pk_client_install_files_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_install_files_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gboolean">gboolean</link> only_trusted,
                                                         <link linkend="gchar">gchar</link> **files,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Install a file locally, and get the deps from the repositories.
This is useful for double clicking on a .rpm or .deb file.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>only_trusted</parameter>&#160;:</term>
<listitem><simpara> only trusted packages should be installed
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>files</parameter>&#160;:</term>
<listitem><simpara> a file such as "/home/hughsie/Desktop/hal-devel-0.10.0.rpm"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-accept-eula-async" role="function">
<title>pk_client_accept_eula_async ()</title>
<indexterm zone="pk-client-accept-eula-async"><primary sortas="pk_client_accept_eula_async">pk_client_accept_eula_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_accept_eula_async         (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *eula_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
We may want to agree to a EULA dialog if one is presented.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>eula_id</parameter>&#160;:</term>
<listitem><simpara> the <literal>eula_id</literal> we are agreeing to
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-rollback-async" role="function">
<title>pk_client_rollback_async ()</title>
<indexterm zone="pk-client-rollback-async"><primary sortas="pk_client_rollback_async">pk_client_rollback_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_rollback_async            (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
We may want to agree to a EULA dialog if one is presented.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>transaction_id</parameter>&#160;:</term>
<listitem><simpara> the <literal>transaction_id</literal> we want to return to
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-repo-list-async" role="function">
<title>pk_client_get_repo_list_async ()</title>
<indexterm zone="pk-client-get-repo-list-async"><primary sortas="pk_client_get_repo_list_async">pk_client_get_repo_list_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_repo_list_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="PkBitfield">PkBitfield</link> filters,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Get the list of repositories installed on the system.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>filters</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="PkBitfield"><literal>PkBitfield</literal></link> such as <link linkend="PK-FILTER-ENUM-DEVEL--CAPS"><literal>PK_FILTER_ENUM_DEVEL</literal></link> or <link linkend="PK-FILTER-ENUM-NONE--CAPS"><literal>PK_FILTER_ENUM_NONE</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-repo-enable-async" role="function">
<title>pk_client_repo_enable_async ()</title>
<indexterm zone="pk-client-repo-enable-async"><primary sortas="pk_client_repo_enable_async">pk_client_repo_enable_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_repo_enable_async         (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *repo_id,
                                                         <link linkend="gboolean">gboolean</link> enabled,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Enable or disable the repository.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>repo_id</parameter>&#160;:</term>
<listitem><simpara> a repo_id structure such as "livna-devel"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>enabled</parameter>&#160;:</term>
<listitem><simpara> if we should enable the repository
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-repo-set-data-async" role="function">
<title>pk_client_repo_set_data_async ()</title>
<indexterm zone="pk-client-repo-set-data-async"><primary sortas="pk_client_repo_set_data_async">pk_client_repo_set_data_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_repo_set_data_async       (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *repo_id,
                                                         const <link linkend="gchar">gchar</link> *parameter,
                                                         const <link linkend="gchar">gchar</link> *value,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
We may want to set a repository parameter.
NOTE: this is free text, and is left to the backend to define a format.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>repo_id</parameter>&#160;:</term>
<listitem><simpara> a repo_id structure such as "livna-devel"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>parameter</parameter>&#160;:</term>
<listitem><simpara> the parameter to change
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>value</parameter>&#160;:</term>
<listitem><simpara> what we should change it to
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-install-files-async" role="function">
<title>pk_client_simulate_install_files_async ()</title>
<indexterm zone="pk-client-simulate-install-files-async"><primary sortas="pk_client_simulate_install_files_async">pk_client_simulate_install_files_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_simulate_install_files_async
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **files,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Simulate an installation of files.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>files</parameter>&#160;:</term>
<listitem><simpara> a file such as "/home/hughsie/Desktop/hal-devel-0.10.0.rpm"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-install-packages-async" role="function">
<title>pk_client_simulate_install_packages_async ()</title>
<indexterm zone="pk-client-simulate-install-packages-async"><primary sortas="pk_client_simulate_install_packages_async">pk_client_simulate_install_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_simulate_install_packages_async
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Simulate an installation of packages.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-remove-packages-async" role="function">
<title>pk_client_simulate_remove_packages_async ()</title>
<indexterm zone="pk-client-simulate-remove-packages-async"><primary sortas="pk_client_simulate_remove_packages_async">pk_client_simulate_remove_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_simulate_remove_packages_async
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Simulate a removal of packages.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-update-packages-async" role="function">
<title>pk_client_simulate_update_packages_async ()</title>
<indexterm zone="pk-client-simulate-update-packages-async"><primary sortas="pk_client_simulate_update_packages_async">pk_client_simulate_update_packages_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_simulate_update_packages_async
                                                        (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="gchar">gchar</link> **package_ids,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Simulate an update of packages.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>package_ids</parameter>&#160;:</term>
<listitem><simpara> a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-adopt-async" role="function">
<title>pk_client_adopt_async ()</title>
<indexterm zone="pk-client-adopt-async"><primary sortas="pk_client_adopt_async">pk_client_adopt_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_adopt_async               (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="PkProgressCallback">PkProgressCallback</link> progress_callback,
                                                         <link linkend="gpointer">gpointer</link> progress_user_data,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Adopt a transaction which allows the caller to monitor the state or cancel it.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>transaction_id</parameter>&#160;:</term>
<listitem><simpara> a transaction ID such as "/21_ebcbdaae_data"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_callback</parameter>&#160;:</term>
<listitem><simpara> the function to run when the progress changes
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>progress_user_data</parameter>&#160;:</term>
<listitem><simpara> data to pass to <parameter>progress_callback</parameter>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-progress-finish" role="function">
<title>pk_client_get_progress_finish ()</title>
<indexterm zone="pk-client-get-progress-finish"><primary sortas="pk_client_get_progress_finish">pk_client_get_progress_finish</primary></indexterm><programlisting><link linkend="PkProgress">PkProgress</link> *        pk_client_get_progress_finish       (<link linkend="PkClient">PkClient</link> *client,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="PkProgress"><type>PkProgress</type></link>, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>. Free with <link linkend="g-object-unref"><function>g_object_unref()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-progress-async" role="function">
<title>pk_client_get_progress_async ()</title>
<indexterm zone="pk-client-get-progress-async"><primary sortas="pk_client_get_progress_async">pk_client_get_progress_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_client_get_progress_async        (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback_ready,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Find the current state of a transaction.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>client</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkClient"><type>PkClient</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>transaction_id</parameter>&#160;:</term>
<listitem><simpara> a transaction ID such as "/21_ebcbdaae_data"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback_ready</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback_ready</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="PkClient.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="PkClient--background" role="property"><title>The <literal>&quot;background&quot;</literal> property</title>
<indexterm zone="PkClient--background"><primary sortas="PkClient:background">PkClient:background</primary></indexterm><programlisting>  &quot;background&quot;               <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="PkClient--idle" role="property"><title>The <literal>&quot;idle&quot;</literal> property</title>
<indexterm zone="PkClient--idle"><primary sortas="PkClient:idle">PkClient:idle</primary></indexterm><programlisting>  &quot;idle&quot;                     <link linkend="gboolean">gboolean</link>              : Read</programlisting>
<para>
</para>
<para>
</para><para>Default value: TRUE</para>
</refsect2>
<refsect2 id="PkClient--interactive" role="property"><title>The <literal>&quot;interactive&quot;</literal> property</title>
<indexterm zone="PkClient--interactive"><primary sortas="PkClient:interactive">PkClient:interactive</primary></indexterm><programlisting>  &quot;interactive&quot;              <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: TRUE</para>
</refsect2>
<refsect2 id="PkClient--locale" role="property"><title>The <literal>&quot;locale&quot;</literal> property</title>
<indexterm zone="PkClient--locale"><primary sortas="PkClient:locale">PkClient:locale</primary></indexterm><programlisting>  &quot;locale&quot;                   <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: NULL</para>
</refsect2>
</refsect1>




</refentry>
