<?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="PackageKit-pk-client-sync">
<refmeta>
<refentrytitle role="top_of_page" id="PackageKit-pk-client-sync.top_of_page">pk-client-sync</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>PACKAGEKIT Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>pk-client-sync</refname>
<refpurpose></refpurpose>
</refnamediv>

<refsynopsisdiv id="PackageKit-pk-client-sync.synopsis" role="synopsis">
<title role="synopsis.title">Synopsis</title>

<synopsis>
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-resolve">pk_client_resolve</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-search-names">pk_client_search_names</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-search-details">pk_client_search_details</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-search-groups">pk_client_search_groups</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-search-files">pk_client_search_files</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-details">pk_client_get_details</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-update-detail">pk_client_get_update_detail</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-download-packages">pk_client_download_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-updates">pk_client_get_updates</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-old-transactions">pk_client_get_old_transactions</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-update-system">pk_client_update_system</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-depends">pk_client_get_depends</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-packages">pk_client_get_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-requires">pk_client_get_requires</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-what-provides">pk_client_what_provides</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-distro-upgrades">pk_client_get_distro_upgrades</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-files">pk_client_get_files</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-categories">pk_client_get_categories</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-remove-packages">pk_client_remove_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-refresh-cache">pk_client_refresh_cache</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-install-packages">pk_client_install_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-install-signature">pk_client_install_signature</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-update-packages">pk_client_update_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-install-files">pk_client_install_files</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-accept-eula">pk_client_accept_eula</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-rollback">pk_client_rollback</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-get-repo-list">pk_client_get_repo_list</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-repo-enable">pk_client_repo_enable</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-repo-set-data">pk_client_repo_set_data</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-simulate-install-files">pk_client_simulate_install_files</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-simulate-install-packages">pk_client_simulate_install_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-simulate-remove-packages">pk_client_simulate_remove_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-simulate-update-packages">pk_client_simulate_update_packages</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="GError">GError</link> **error);
<link linkend="PkResults">PkResults</link> *         <link linkend="pk-client-adopt">pk_client_adopt</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="GError">GError</link> **error);
<link linkend="PkProgress">PkProgress</link> *        <link linkend="pk-client-get-progress">pk_client_get_progress</link>              (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GError">GError</link> **error);
</synopsis>
</refsynopsisdiv>









<refsect1 id="PackageKit-pk-client-sync.description" role="desc">
<title role="desc.title">Description</title>
<para>
</para>
</refsect1>

<refsect1 id="PackageKit-pk-client-sync.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="pk-client-resolve" role="function">
<title>pk_client_resolve ()</title>
<indexterm zone="pk-client-resolve"><primary sortas="pk_client_resolve">pk_client_resolve</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_resolve                   (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-names" role="function">
<title>pk_client_search_names ()</title>
<indexterm zone="pk-client-search-names"><primary sortas="pk_client_search_names">pk_client_search_names</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_search_names              (<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="GError">GError</link> **error);</programlisting>
<para>
Search all the locally installed files and remote repositories for a package
that matches a specific name.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-details" role="function">
<title>pk_client_search_details ()</title>
<indexterm zone="pk-client-search-details"><primary sortas="pk_client_search_details">pk_client_search_details</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_search_details            (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-groups" role="function">
<title>pk_client_search_groups ()</title>
<indexterm zone="pk-client-search-groups"><primary sortas="pk_client_search_groups">pk_client_search_groups</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_search_groups             (<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="GError">GError</link> **error);</programlisting>
<para>
Return all packages in a specific group.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-search-files" role="function">
<title>pk_client_search_files ()</title>
<indexterm zone="pk-client-search-files"><primary sortas="pk_client_search_files">pk_client_search_files</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_search_files              (<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="GError">GError</link> **error);</programlisting>
<para>
Search for packages that provide a specific file.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-details" role="function">
<title>pk_client_get_details ()</title>
<indexterm zone="pk-client-get-details"><primary sortas="pk_client_get_details">pk_client_get_details</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_details               (<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="GError">GError</link> **error);</programlisting>
<para>
Get details of a package, so more information can be obtained for GUI
or command line tools.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-update-detail" role="function">
<title>pk_client_get_update_detail ()</title>
<indexterm zone="pk-client-get-update-detail"><primary sortas="pk_client_get_update_detail">pk_client_get_update_detail</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_update_detail         (<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="GError">GError</link> **error);</programlisting>
<para>
Get details about the specific update, for instance any CVE urls and
severity information.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-download-packages" role="function">
<title>pk_client_download_packages ()</title>
<indexterm zone="pk-client-download-packages"><primary sortas="pk_client_download_packages">pk_client_download_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_download_packages         (<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="GError">GError</link> **error);</programlisting>
<para>
Downloads package files to a specified location.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-updates" role="function">
<title>pk_client_get_updates ()</title>
<indexterm zone="pk-client-get-updates"><primary sortas="pk_client_get_updates">pk_client_get_updates</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_updates               (<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="GError">GError</link> **error);</programlisting>
<para>
Get a list of all the packages that can be updated for all repositories.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-old-transactions" role="function">
<title>pk_client_get_old_transactions ()</title>
<indexterm zone="pk-client-get-old-transactions"><primary sortas="pk_client_get_old_transactions">pk_client_get_old_transactions</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_old_transactions      (<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="GError">GError</link> **error);</programlisting>
<para>
Get the old transaction list, mainly used for the rollback viewer.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-update-system" role="function">
<title>pk_client_update_system ()</title>
<indexterm zone="pk-client-update-system"><primary sortas="pk_client_update_system">pk_client_update_system</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_update_system             (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-depends" role="function">
<title>pk_client_get_depends ()</title>
<indexterm zone="pk-client-get-depends"><primary sortas="pk_client_get_depends">pk_client_get_depends</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_depends               (<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="GError">GError</link> **error);</programlisting>
<para>
Get the packages that depend this one, i.e. child->parent.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-packages" role="function">
<title>pk_client_get_packages ()</title>
<indexterm zone="pk-client-get-packages"><primary sortas="pk_client_get_packages">pk_client_get_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_packages              (<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="GError">GError</link> **error);</programlisting>
<para>
Get the list of packages from the backend
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-requires" role="function">
<title>pk_client_get_requires ()</title>
<indexterm zone="pk-client-get-requires"><primary sortas="pk_client_get_requires">pk_client_get_requires</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_requires              (<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="GError">GError</link> **error);</programlisting>
<para>
Get the packages that require this one, i.e. parent->child.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-what-provides" role="function">
<title>pk_client_what_provides ()</title>
<indexterm zone="pk-client-what-provides"><primary sortas="pk_client_what_provides">pk_client_what_provides</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_what_provides             (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-distro-upgrades" role="function">
<title>pk_client_get_distro_upgrades ()</title>
<indexterm zone="pk-client-get-distro-upgrades"><primary sortas="pk_client_get_distro_upgrades">pk_client_get_distro_upgrades</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_distro_upgrades       (<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="GError">GError</link> **error);</programlisting>
<para>
This method should return a list of distribution upgrades that are available.
It should not return updates, only major upgrades.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-files" role="function">
<title>pk_client_get_files ()</title>
<indexterm zone="pk-client-get-files"><primary sortas="pk_client_get_files">pk_client_get_files</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_files                 (<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="GError">GError</link> **error);</programlisting>
<para>
Get the file list (i.e. a list of files installed) for the specified package.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-categories" role="function">
<title>pk_client_get_categories ()</title>
<indexterm zone="pk-client-get-categories"><primary sortas="pk_client_get_categories">pk_client_get_categories</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_categories            (<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="GError">GError</link> **error);</programlisting>
<para>
Get a list of all categories supported.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-remove-packages" role="function">
<title>pk_client_remove_packages ()</title>
<indexterm zone="pk-client-remove-packages"><primary sortas="pk_client_remove_packages">pk_client_remove_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_remove_packages           (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-refresh-cache" role="function">
<title>pk_client_refresh_cache ()</title>
<indexterm zone="pk-client-refresh-cache"><primary sortas="pk_client_refresh_cache">pk_client_refresh_cache</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_refresh_cache             (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-install-packages" role="function">
<title>pk_client_install_packages ()</title>
<indexterm zone="pk-client-install-packages"><primary sortas="pk_client_install_packages">pk_client_install_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_install_packages          (<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="GError">GError</link> **error);</programlisting>
<para>
Install a package of the newest and most correct version.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-install-signature" role="function">
<title>pk_client_install_signature ()</title>
<indexterm zone="pk-client-install-signature"><primary sortas="pk_client_install_signature">pk_client_install_signature</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_install_signature         (<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="GError">GError</link> **error);</programlisting>
<para>
Install a software source signature of the newest and most correct version.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-update-packages" role="function">
<title>pk_client_update_packages ()</title>
<indexterm zone="pk-client-update-packages"><primary sortas="pk_client_update_packages">pk_client_update_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_update_packages           (<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="GError">GError</link> **error);</programlisting>
<para>
Update specific packages to the newest available versions.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-install-files" role="function">
<title>pk_client_install_files ()</title>
<indexterm zone="pk-client-install-files"><primary sortas="pk_client_install_files">pk_client_install_files</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_install_files             (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-accept-eula" role="function">
<title>pk_client_accept_eula ()</title>
<indexterm zone="pk-client-accept-eula"><primary sortas="pk_client_accept_eula">pk_client_accept_eula</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_accept_eula               (<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="GError">GError</link> **error);</programlisting>
<para>
We may want to agree to a EULA dialog if one is presented.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-rollback" role="function">
<title>pk_client_rollback ()</title>
<indexterm zone="pk-client-rollback"><primary sortas="pk_client_rollback">pk_client_rollback</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_rollback                  (<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="GError">GError</link> **error);</programlisting>
<para>
We may want to agree to a EULA dialog if one is presented.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-repo-list" role="function">
<title>pk_client_get_repo_list ()</title>
<indexterm zone="pk-client-get-repo-list"><primary sortas="pk_client_get_repo_list">pk_client_get_repo_list</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_get_repo_list             (<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="GError">GError</link> **error);</programlisting>
<para>
Get the list of repositories installed on the system.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-repo-enable" role="function">
<title>pk_client_repo_enable ()</title>
<indexterm zone="pk-client-repo-enable"><primary sortas="pk_client_repo_enable">pk_client_repo_enable</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_repo_enable               (<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="GError">GError</link> **error);</programlisting>
<para>
Enable or disable the repository.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-repo-set-data" role="function">
<title>pk_client_repo_set_data ()</title>
<indexterm zone="pk-client-repo-set-data"><primary sortas="pk_client_repo_set_data">pk_client_repo_set_data</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_repo_set_data             (<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="GError">GError</link> **error);</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>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-install-files" role="function">
<title>pk_client_simulate_install_files ()</title>
<indexterm zone="pk-client-simulate-install-files"><primary sortas="pk_client_simulate_install_files">pk_client_simulate_install_files</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_simulate_install_files    (<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="GError">GError</link> **error);</programlisting>
<para>
Simulate an installation of files.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-install-packages" role="function">
<title>pk_client_simulate_install_packages ()</title>
<indexterm zone="pk-client-simulate-install-packages"><primary sortas="pk_client_simulate_install_packages">pk_client_simulate_install_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_simulate_install_packages (<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="GError">GError</link> **error);</programlisting>
<para>
Simulate an installation of packages.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-remove-packages" role="function">
<title>pk_client_simulate_remove_packages ()</title>
<indexterm zone="pk-client-simulate-remove-packages"><primary sortas="pk_client_simulate_remove_packages">pk_client_simulate_remove_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_simulate_remove_packages  (<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="GError">GError</link> **error);</programlisting>
<para>
Simulate a removal of packages.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-simulate-update-packages" role="function">
<title>pk_client_simulate_update_packages ()</title>
<indexterm zone="pk-client-simulate-update-packages"><primary sortas="pk_client_simulate_update_packages">pk_client_simulate_update_packages</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_simulate_update_packages  (<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="GError">GError</link> **error);</programlisting>
<para>
Simulate an update of packages.
</para>
<para>
Warning: this function is synchronous, and may block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-adopt" role="function">
<title>pk_client_adopt ()</title>
<indexterm zone="pk-client-adopt"><primary sortas="pk_client_adopt">pk_client_adopt</primary></indexterm><programlisting><link linkend="PkResults">PkResults</link> *         pk_client_adopt                     (<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="GError">GError</link> **error);</programlisting>
<para>
Adopt a transaction.
</para>
<para>
Warning: this function is synchronous, and will block. Do not use it in GUI
applications.</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-client-get-progress" role="function">
<title>pk_client_get_progress ()</title>
<indexterm zone="pk-client-get-progress"><primary sortas="pk_client_get_progress">pk_client_get_progress</primary></indexterm><programlisting><link linkend="PkProgress">PkProgress</link> *        pk_client_get_progress              (<link linkend="PkClient">PkClient</link> *client,
                                                         const <link linkend="gchar">gchar</link> *transaction_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Adopt a transaction.
</para>
<para>
Warning: this function is synchronous, and will block. Do not use it in GUI
applications.</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>
</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>error</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GError"><type>GError</type></link> to store any failure, or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a <link linkend="PkResults"><literal>PkResults</literal></link> object, or NULL for error
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>




</refentry>
