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

<refnamediv>
<refname>PkControl</refname>
<refpurpose>For querying data about PackageKit</refpurpose>
</refnamediv>

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

<synopsis>
#define             <link linkend="PK-CONTROL-ERROR--CAPS">PK_CONTROL_ERROR</link>
#define             <link linkend="PK-CONTROL-TYPE-ERROR--CAPS">PK_CONTROL_TYPE_ERROR</link>
                    <link linkend="PkControlPrivate">PkControlPrivate</link>;
enum                <link linkend="PkControlError">PkControlError</link>;
                    <link linkend="PkControl-struct">PkControl</link>;
<link linkend="GQuark">GQuark</link>              <link linkend="pk-control-error-quark">pk_control_error_quark</link>              (void);
<link linkend="PkControl">PkControl</link> *         <link linkend="pk-control-new">pk_control_new</link>                      (void);
<link linkend="void">void</link>                <link linkend="pk-control-test">pk_control_test</link>                     (<link linkend="gpointer">gpointer</link> user_data);
<link linkend="void">void</link>                <link linkend="pk-control-get-tid-async">pk_control_get_tid_async</link>            (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="gchar">gchar</link> *             <link linkend="pk-control-get-tid-finish">pk_control_get_tid_finish</link>           (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-get-daemon-state-async">pk_control_get_daemon_state_async</link>   (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="gchar">gchar</link> *             <link linkend="pk-control-get-daemon-state-finish">pk_control_get_daemon_state_finish</link>  (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-set-proxy-async">pk_control_set_proxy_async</link>          (<link linkend="PkControl">PkControl</link> *control,
                                                         const <link linkend="gchar">gchar</link> *proxy_http,
                                                         const <link linkend="gchar">gchar</link> *proxy_ftp,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-control-set-proxy-finish">pk_control_set_proxy_finish</link>         (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-get-network-state-async">pk_control_get_network_state_async</link>  (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="PkNetworkEnum">PkNetworkEnum</link>       <link linkend="pk-control-get-network-state-finish">pk_control_get_network_state_finish</link> (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-get-time-since-action-async">pk_control_get_time_since_action_async</link>
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="PkRoleEnum">PkRoleEnum</link> role,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="guint">guint</link>               <link linkend="pk-control-get-time-since-action-finish">pk_control_get_time_since_action_finish</link>
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-get-transaction-list-async">pk_control_get_transaction_list_async</link>
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="gchar">gchar</link> **            <link linkend="pk-control-get-transaction-list-finish">pk_control_get_transaction_list_finish</link>
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-can-authorize-async">pk_control_can_authorize_async</link>      (<link linkend="PkControl">PkControl</link> *control,
                                                         const <link linkend="gchar">gchar</link> *action_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="PkAuthorizeEnum">PkAuthorizeEnum</link>     <link linkend="pk-control-can-authorize-finish">pk_control_can_authorize_finish</link>     (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
<link linkend="void">void</link>                <link linkend="pk-control-get-properties-async">pk_control_get_properties_async</link>     (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);
<link linkend="gboolean">gboolean</link>            <link linkend="pk-control-get-properties-finish">pk_control_get_properties_finish</link>    (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);
</synopsis>
</refsynopsisdiv>

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





<refsect1 id="PkControl.properties" role="properties">
<title role="properties.title">Properties</title>
<synopsis>
  &quot;<link linkend="PkControl--backend-author">backend-author</link>&quot;           <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="PkControl--backend-description">backend-description</link>&quot;      <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="PkControl--backend-name">backend-name</link>&quot;             <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="PkControl--connected">connected</link>&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="PkControl--distro-id">distro-id</link>&quot;                <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="PkControl--filters">filters</link>&quot;                  <link linkend="guint64">guint64</link>               : Read / Write
  &quot;<link linkend="PkControl--groups">groups</link>&quot;                   <link linkend="guint64">guint64</link>               : Read / Write
  &quot;<link linkend="PkControl--locked">locked</link>&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write
  &quot;<link linkend="PkControl--mime-types">mime-types</link>&quot;               <link linkend="gchar">gchar</link>*                : Read / Write
  &quot;<link linkend="PkControl--network-state">network-state</link>&quot;            <link linkend="guint">guint</link>                 : Read / Write
  &quot;<link linkend="PkControl--roles">roles</link>&quot;                    <link linkend="guint64">guint64</link>               : Read / Write
  &quot;<link linkend="PkControl--version-major">version-major</link>&quot;            <link linkend="guint">guint</link>                 : Read
  &quot;<link linkend="PkControl--version-micro">version-micro</link>&quot;            <link linkend="guint">guint</link>                 : Read
  &quot;<link linkend="PkControl--version-minor">version-minor</link>&quot;            <link linkend="guint">guint</link>                 : Read
</synopsis>
</refsect1>

<refsect1 id="PkControl.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<synopsis>
  &quot;<link linkend="PkControl-repo-list-changed">repo-list-changed</link>&quot;                              : Run Last
  &quot;<link linkend="PkControl-restart-schedule">restart-schedule</link>&quot;                               : Run Last
  &quot;<link linkend="PkControl-transaction-list-changed">transaction-list-changed</link>&quot;                       : Run Last
  &quot;<link linkend="PkControl-updates-changed">updates-changed</link>&quot;                                : Run Last
</synopsis>
</refsect1>


<refsect1 id="PkControl.description" role="desc">
<title role="desc.title">Description</title>
<para>
A GObject to use for accessing PackageKit asynchronously.</para>
<para>
</para>
</refsect1>

<refsect1 id="PkControl.details" role="details">
<title role="details.title">Details</title>
<refsect2 id="PK-CONTROL-ERROR--CAPS" role="macro">
<title>PK_CONTROL_ERROR</title>
<indexterm zone="PK-CONTROL-ERROR--CAPS"><primary sortas="PK_CONTROL_ERROR">PK_CONTROL_ERROR</primary></indexterm><programlisting>#define PK_CONTROL_ERROR	(pk_control_error_quark ())
</programlisting>
<para>
</para></refsect2>
<refsect2 id="PK-CONTROL-TYPE-ERROR--CAPS" role="macro">
<title>PK_CONTROL_TYPE_ERROR</title>
<indexterm zone="PK-CONTROL-TYPE-ERROR--CAPS"><primary sortas="PK_CONTROL_TYPE_ERROR">PK_CONTROL_TYPE_ERROR</primary></indexterm><programlisting>#define PK_CONTROL_TYPE_ERROR	(pk_control_error_get_type ())
</programlisting>
<para>
</para></refsect2>
<refsect2 id="PkControlPrivate" role="struct">
<title>PkControlPrivate</title>
<indexterm zone="PkControlPrivate"><primary sortas="PkControlPrivate">PkControlPrivate</primary></indexterm><programlisting>typedef struct _PkControlPrivate PkControlPrivate;</programlisting>
<para>
Private <link linkend="PkControl"><type>PkControl</type></link> data</para>
<para>
</para></refsect2>
<refsect2 id="PkControlError" role="enum">
<title>enum PkControlError</title>
<indexterm zone="PkControlError"><primary sortas="PkControlError">PkControlError</primary></indexterm><programlisting>typedef enum
{
	PK_CONTROL_ERROR_FAILED,
	PK_CONTROL_ERROR_CANNOT_START_DAEMON
} PkControlError;
</programlisting>
<para>
Errors that can be thrown</para>
<para>
</para><variablelist role="enum">
<varlistentry id="PK-CONTROL-ERROR-FAILED--CAPS" role="constant">
<term><literal>PK_CONTROL_ERROR_FAILED</literal></term>
<listitem><simpara> the transaction failed for an unknown reason
</simpara></listitem>
</varlistentry>
<varlistentry id="PK-CONTROL-ERROR-CANNOT-START-DAEMON--CAPS" role="constant">
<term><literal>PK_CONTROL_ERROR_CANNOT_START_DAEMON</literal></term>
<listitem><simpara>
</simpara></listitem>
</varlistentry>
</variablelist></refsect2>
<refsect2 id="PkControl-struct" role="struct">
<title>PkControl</title>
<indexterm zone="PkControl-struct"><primary sortas="PkControl">PkControl</primary></indexterm><programlisting>typedef struct _PkControl PkControl;</programlisting>
<para>
</para></refsect2>
<refsect2 id="pk-control-error-quark" role="function">
<title>pk_control_error_quark ()</title>
<indexterm zone="pk-control-error-quark"><primary sortas="pk_control_error_quark">pk_control_error_quark</primary></indexterm><programlisting><link linkend="GQuark">GQuark</link>              pk_control_error_quark              (void);</programlisting>
<para>
We are a GObject that sets errors</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> Our personal error quark.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-new" role="function">
<title>pk_control_new ()</title>
<indexterm zone="pk-control-new"><primary sortas="pk_control_new">pk_control_new</primary></indexterm><programlisting><link linkend="PkControl">PkControl</link> *         pk_control_new                      (void);</programlisting>
<para>
</para>
<para>
</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> a new PkControl object.
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-test" role="function">
<title>pk_control_test ()</title>
<indexterm zone="pk-control-test"><primary sortas="pk_control_test">pk_control_test</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_test                     (<link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-tid-async" role="function">
<title>pk_control_get_tid_async ()</title>
<indexterm zone="pk-control-get-tid-async"><primary sortas="pk_control_get_tid_async">pk_control_get_tid_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_get_tid_async            (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Gets a transacton ID from the daemon.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</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>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-tid-finish" role="function">
<title>pk_control_get_tid_finish ()</title>
<indexterm zone="pk-control-get-tid-finish"><primary sortas="pk_control_get_tid_finish">pk_control_get_tid_finish</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             pk_control_get_tid_finish           (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the ID, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if unset, free with <link linkend="g-free"><function>g_free()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-daemon-state-async" role="function">
<title>pk_control_get_daemon_state_async ()</title>
<indexterm zone="pk-control-get-daemon-state-async"><primary sortas="pk_control_get_daemon_state_async">pk_control_get_daemon_state_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_get_daemon_state_async   (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Gets the debugging state from the daemon.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</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>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-daemon-state-finish" role="function">
<title>pk_control_get_daemon_state_finish ()</title>
<indexterm zone="pk-control-get-daemon-state-finish"><primary sortas="pk_control_get_daemon_state_finish">pk_control_get_daemon_state_finish</primary></indexterm><programlisting><link linkend="gchar">gchar</link> *             pk_control_get_daemon_state_finish  (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the ID, or <link linkend="NULL--CAPS"><literal>NULL</literal></link> if unset, free with <link linkend="g-free"><function>g_free()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-set-proxy-async" role="function">
<title>pk_control_set_proxy_async ()</title>
<indexterm zone="pk-control-set-proxy-async"><primary sortas="pk_control_set_proxy_async">pk_control_set_proxy_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_set_proxy_async          (<link linkend="PkControl">PkControl</link> *control,
                                                         const <link linkend="gchar">gchar</link> *proxy_http,
                                                         const <link linkend="gchar">gchar</link> *proxy_ftp,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Set a proxy on the PK daemon</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>proxy_http</parameter>&#160;:</term>
<listitem><simpara> a HTTP proxy string such as "username:password<parameter>server.lan</parameter>:8080"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>proxy_ftp</parameter>&#160;:</term>
<listitem><simpara> a FTP proxy string such as "server.lan:8080"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-set-proxy-finish" role="function">
<title>pk_control_set_proxy_finish ()</title>
<indexterm zone="pk-control-set-proxy-finish"><primary sortas="pk_control_set_proxy_finish">pk_control_set_proxy_finish</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_control_set_proxy_finish         (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if we set the proxy successfully
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-network-state-async" role="function">
<title>pk_control_get_network_state_async ()</title>
<indexterm zone="pk-control-get-network-state-async"><primary sortas="pk_control_get_network_state_async">pk_control_get_network_state_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_get_network_state_async  (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Gets the network state.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</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>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-network-state-finish" role="function">
<title>pk_control_get_network_state_finish ()</title>
<indexterm zone="pk-control-get-network-state-finish"><primary sortas="pk_control_get_network_state_finish">pk_control_get_network_state_finish</primary></indexterm><programlisting><link linkend="PkNetworkEnum">PkNetworkEnum</link>       pk_control_get_network_state_finish (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> an enumerated network state
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-time-since-action-async" role="function">
<title>pk_control_get_time_since_action_async ()</title>
<indexterm zone="pk-control-get-time-since-action-async"><primary sortas="pk_control_get_time_since_action_async">pk_control_get_time_since_action_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_get_time_since_action_async
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="PkRoleEnum">PkRoleEnum</link> role,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
We may want to know how long it has been since we refreshed the cache or
retrieved the update list.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>role</parameter>&#160;:</term>
<listitem><simpara> the role enum, e.g. <link linkend="PK-ROLE-ENUM-GET-UPDATES--CAPS"><literal>PK_ROLE_ENUM_GET_UPDATES</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>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-time-since-action-finish" role="function">
<title>pk_control_get_time_since_action_finish ()</title>
<indexterm zone="pk-control-get-time-since-action-finish"><primary sortas="pk_control_get_time_since_action_finish">pk_control_get_time_since_action_finish</primary></indexterm><programlisting><link linkend="guint">guint</link>               pk_control_get_time_since_action_finish
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if the daemon serviced the request
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-transaction-list-async" role="function">
<title>pk_control_get_transaction_list_async ()</title>
<indexterm zone="pk-control-get-transaction-list-async"><primary sortas="pk_control_get_transaction_list_async">pk_control_get_transaction_list_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_get_transaction_list_async
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Gets the transactions currently running in the daemon.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</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>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-transaction-list-finish" role="function">
<title>pk_control_get_transaction_list_finish ()</title>
<indexterm zone="pk-control-get-transaction-list-finish"><primary sortas="pk_control_get_transaction_list_finish">pk_control_get_transaction_list_finish</primary></indexterm><programlisting><link linkend="gchar">gchar</link> **            pk_control_get_transaction_list_finish
                                                        (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> A GStrv list of transaction ID's, free with <link linkend="g-strfreev"><function>g_strfreev()</function></link>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-can-authorize-async" role="function">
<title>pk_control_can_authorize_async ()</title>
<indexterm zone="pk-control-can-authorize-async"><primary sortas="pk_control_can_authorize_async">pk_control_can_authorize_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_can_authorize_async      (<link linkend="PkControl">PkControl</link> *control,
                                                         const <link linkend="gchar">gchar</link> *action_id,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
We may want to know before we run a method if we are going to be denied,
accepted or challenged for authentication.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>action_id</parameter>&#160;:</term>
<listitem><simpara> The action ID, for instance "org.freedesktop.PackageKit.install-untrusted"
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>cancellable</parameter>&#160;:</term>
<listitem><simpara> a <link linkend="GCancellable"><type>GCancellable</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-can-authorize-finish" role="function">
<title>pk_control_can_authorize_finish ()</title>
<indexterm zone="pk-control-can-authorize-finish"><primary sortas="pk_control_can_authorize_finish">pk_control_can_authorize_finish</primary></indexterm><programlisting><link linkend="PkAuthorizeEnum">PkAuthorizeEnum</link>     pk_control_can_authorize_finish     (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> the <link linkend="PkAuthorizeEnum"><literal>PkAuthorizeEnum</literal></link> or <link linkend="PK-AUTHORIZE-ENUM-UNKNOWN--CAPS"><literal>PK_AUTHORIZE_ENUM_UNKNOWN</literal></link> if the method failed
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-properties-async" role="function">
<title>pk_control_get_properties_async ()</title>
<indexterm zone="pk-control-get-properties-async"><primary sortas="pk_control_get_properties_async">pk_control_get_properties_async</primary></indexterm><programlisting><link linkend="void">void</link>                pk_control_get_properties_async     (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
                                                         <link linkend="gpointer">gpointer</link> user_data);</programlisting>
<para>
Gets global properties from the daemon.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</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>callback</parameter>&#160;:</term>
<listitem><simpara> the function to run on completion
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara> the data to pass to <parameter>callback</parameter>
</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2 id="pk-control-get-properties-finish" role="function">
<title>pk_control_get_properties_finish ()</title>
<indexterm zone="pk-control-get-properties-finish"><primary sortas="pk_control_get_properties_finish">pk_control_get_properties_finish</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            pk_control_get_properties_finish    (<link linkend="PkControl">PkControl</link> *control,
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *res,
                                                         <link linkend="GError">GError</link> **error);</programlisting>
<para>
Gets the result from the asynchronous function.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> a valid <link linkend="PkControl"><type>PkControl</type></link> instance
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>res</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="GAsyncResult"><type>GAsyncResult</type></link>
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>error</parameter>&#160;:</term>
<listitem><simpara> A <link linkend="GError"><type>GError</type></link> or <link linkend="NULL--CAPS"><literal>NULL</literal></link>
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&#160;:</term><listitem><simpara> <link linkend="TRUE--CAPS"><literal>TRUE</literal></link> if we set the proxy successfully
</simpara></listitem></varlistentry>
</variablelist></refsect2>

</refsect1>
<refsect1 id="PkControl.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="PkControl--backend-author" role="property"><title>The <literal>&quot;backend-author&quot;</literal> property</title>
<indexterm zone="PkControl--backend-author"><primary sortas="PkControl:backend-author">PkControl:backend-author</primary></indexterm><programlisting>  &quot;backend-author&quot;           <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="PkControl--backend-description" role="property"><title>The <literal>&quot;backend-description&quot;</literal> property</title>
<indexterm zone="PkControl--backend-description"><primary sortas="PkControl:backend-description">PkControl:backend-description</primary></indexterm><programlisting>  &quot;backend-description&quot;      <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="PkControl--backend-name" role="property"><title>The <literal>&quot;backend-name&quot;</literal> property</title>
<indexterm zone="PkControl--backend-name"><primary sortas="PkControl:backend-name">PkControl:backend-name</primary></indexterm><programlisting>  &quot;backend-name&quot;             <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="PkControl--connected" role="property"><title>The <literal>&quot;connected&quot;</literal> property</title>
<indexterm zone="PkControl--connected"><primary sortas="PkControl:connected">PkControl:connected</primary></indexterm><programlisting>  &quot;connected&quot;                <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="PkControl--distro-id" role="property"><title>The <literal>&quot;distro-id&quot;</literal> property</title>
<indexterm zone="PkControl--distro-id"><primary sortas="PkControl:distro-id">PkControl:distro-id</primary></indexterm><programlisting>  &quot;distro-id&quot;                <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="PkControl--filters" role="property"><title>The <literal>&quot;filters&quot;</literal> property</title>
<indexterm zone="PkControl--filters"><primary sortas="PkControl:filters">PkControl:filters</primary></indexterm><programlisting>  &quot;filters&quot;                  <link linkend="guint64">guint64</link>               : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="PkControl--groups" role="property"><title>The <literal>&quot;groups&quot;</literal> property</title>
<indexterm zone="PkControl--groups"><primary sortas="PkControl:groups">PkControl:groups</primary></indexterm><programlisting>  &quot;groups&quot;                   <link linkend="guint64">guint64</link>               : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="PkControl--locked" role="property"><title>The <literal>&quot;locked&quot;</literal> property</title>
<indexterm zone="PkControl--locked"><primary sortas="PkControl:locked">PkControl:locked</primary></indexterm><programlisting>  &quot;locked&quot;                   <link linkend="gboolean">gboolean</link>              : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: FALSE</para>
</refsect2>
<refsect2 id="PkControl--mime-types" role="property"><title>The <literal>&quot;mime-types&quot;</literal> property</title>
<indexterm zone="PkControl--mime-types"><primary sortas="PkControl:mime-types">PkControl:mime-types</primary></indexterm><programlisting>  &quot;mime-types&quot;               <link linkend="gchar">gchar</link>*                : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: NULL</para>
</refsect2>
<refsect2 id="PkControl--network-state" role="property"><title>The <literal>&quot;network-state&quot;</literal> property</title>
<indexterm zone="PkControl--network-state"><primary sortas="PkControl:network-state">PkControl:network-state</primary></indexterm><programlisting>  &quot;network-state&quot;            <link linkend="guint">guint</link>                 : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: 6</para>
</refsect2>
<refsect2 id="PkControl--roles" role="property"><title>The <literal>&quot;roles&quot;</literal> property</title>
<indexterm zone="PkControl--roles"><primary sortas="PkControl:roles">PkControl:roles</primary></indexterm><programlisting>  &quot;roles&quot;                    <link linkend="guint64">guint64</link>               : Read / Write</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="PkControl--version-major" role="property"><title>The <literal>&quot;version-major&quot;</literal> property</title>
<indexterm zone="PkControl--version-major"><primary sortas="PkControl:version-major">PkControl:version-major</primary></indexterm><programlisting>  &quot;version-major&quot;            <link linkend="guint">guint</link>                 : Read</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="PkControl--version-micro" role="property"><title>The <literal>&quot;version-micro&quot;</literal> property</title>
<indexterm zone="PkControl--version-micro"><primary sortas="PkControl:version-micro">PkControl:version-micro</primary></indexterm><programlisting>  &quot;version-micro&quot;            <link linkend="guint">guint</link>                 : Read</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
<refsect2 id="PkControl--version-minor" role="property"><title>The <literal>&quot;version-minor&quot;</literal> property</title>
<indexterm zone="PkControl--version-minor"><primary sortas="PkControl:version-minor">PkControl:version-minor</primary></indexterm><programlisting>  &quot;version-minor&quot;            <link linkend="guint">guint</link>                 : Read</programlisting>
<para>
</para>
<para>
</para><para>Default value: 0</para>
</refsect2>
</refsect1>

<refsect1 id="PkControl.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="PkControl-repo-list-changed" role="signal"><title>The <literal>&quot;repo-list-changed&quot;</literal> signal</title>
<indexterm zone="PkControl-repo-list-changed"><primary sortas="PkControl::repo-list-changed">PkControl::repo-list-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="PkControl">PkControl</link> *control,
                                                        <link linkend="gpointer">gpointer</link>   user_data)      : Run Last</programlisting>
<para>
The ::repo-list-changed signal is emitted when the repo list may have
changed and the control program may have to update some UI.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="PkControl"><type>PkControl</type></link> instance that emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="PkControl-restart-schedule" role="signal"><title>The <literal>&quot;restart-schedule&quot;</literal> signal</title>
<indexterm zone="PkControl-restart-schedule"><primary sortas="PkControl::restart-schedule">PkControl::restart-schedule</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="PkControl">PkControl</link> *control,
                                                        <link linkend="gpointer">gpointer</link>   user_data)      : Run Last</programlisting>
<para>
The ::restart_schedule signal is emitted when the packagekitd service
has been restarted because it has been upgraded.
Client programs should reload themselves when it is convenient to
do so, as old client tools may not be compatable with the new daemon.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="PkControl"><type>PkControl</type></link> instance that emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="PkControl-transaction-list-changed" role="signal"><title>The <literal>&quot;transaction-list-changed&quot;</literal> signal</title>
<indexterm zone="PkControl-transaction-list-changed"><primary sortas="PkControl::transaction-list-changed">PkControl::transaction-list-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="PkControl">PkControl</link> *control,
                                                        <link linkend="GStrv">GStrv</link>     *arg1,
                                                        <link linkend="gpointer">gpointer</link>   user_data)      : Run Last</programlisting>
<para>
The ::transaction-list-changed signal is emitted when the list
of transactions handled by the daemon is changed.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="PkControl"><type>PkControl</type></link> instance that emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2 id="PkControl-updates-changed" role="signal"><title>The <literal>&quot;updates-changed&quot;</literal> signal</title>
<indexterm zone="PkControl-updates-changed"><primary sortas="PkControl::updates-changed">PkControl::updates-changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="PkControl">PkControl</link> *control,
                                                        <link linkend="gpointer">gpointer</link>   user_data)      : Run Last</programlisting>
<para>
The ::updates-changed signal is emitted when the update list may have
changed and the control program may have to update some UI.</para>
<para>
</para><variablelist role="params">
<varlistentry><term><parameter>control</parameter>&#160;:</term>
<listitem><simpara> the <link linkend="PkControl"><type>PkControl</type></link> instance that emitted the signal
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
