![]() |
![]() |
![]() |
PackageKit Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Properties | Signals |
#define PK_CONTROL_ERROR #define PK_CONTROL_TYPE_ERROR PkControlPrivate; enum PkControlError; PkControl; GQuark pk_control_error_quark (void); PkControl * pk_control_new (void); void pk_control_test (gpointer user_data); void pk_control_get_tid_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gchar * pk_control_get_tid_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_get_daemon_state_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gchar * pk_control_get_daemon_state_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_set_proxy_async (PkControl *control, const gchar *proxy_http, const gchar *proxy_ftp, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gboolean pk_control_set_proxy_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_get_network_state_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); PkNetworkEnum pk_control_get_network_state_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_get_time_since_action_async (PkControl *control, PkRoleEnum role, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); guint pk_control_get_time_since_action_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_get_transaction_list_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gchar ** pk_control_get_transaction_list_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_can_authorize_async (PkControl *control, const gchar *action_id, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); PkAuthorizeEnum pk_control_can_authorize_finish (PkControl *control, GAsyncResult *res, GError **error); void pk_control_get_properties_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data); gboolean pk_control_get_properties_finish (PkControl *control, GAsyncResult *res, GError **error);
"backend-author" gchar* : Read / Write "backend-description" gchar* : Read / Write "backend-name" gchar* : Read / Write "connected" gboolean : Read / Write "distro-id" gchar* : Read / Write "filters" guint64 : Read / Write "groups" guint64 : Read / Write "locked" gboolean : Read / Write "mime-types" gchar* : Read / Write "network-state" guint : Read / Write "roles" guint64 : Read / Write "version-major" guint : Read "version-micro" guint : Read "version-minor" guint : Read
"repo-list-changed" : Run Last "restart-schedule" : Run Last "transaction-list-changed" : Run Last "updates-changed" : Run Last
typedef enum { PK_CONTROL_ERROR_FAILED, PK_CONTROL_ERROR_CANNOT_START_DAEMON } PkControlError;
Errors that can be thrown
GQuark pk_control_error_quark (void);
We are a GObject that sets errors
Returns : |
Our personal error quark. |
void pk_control_get_tid_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
Gets a transacton ID from the daemon.
|
a valid PkControl instance |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
gchar * pk_control_get_tid_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
void pk_control_get_daemon_state_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
Gets the debugging state from the daemon.
|
a valid PkControl instance |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
gchar * pk_control_get_daemon_state_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
void pk_control_set_proxy_async (PkControl *control, const gchar *proxy_http, const gchar *proxy_ftp, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
Set a proxy on the PK daemon
|
a valid PkControl instance |
|
a HTTP proxy string such as "username:passwordserver.lan :8080"
|
|
a FTP proxy string such as "server.lan:8080" |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
gboolean pk_control_set_proxy_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
|
a valid PkControl instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
TRUE if we set the proxy successfully
|
void pk_control_get_network_state_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
Gets the network state.
|
a valid PkControl instance |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
PkNetworkEnum pk_control_get_network_state_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
|
a valid PkControl instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
an enumerated network state |
void pk_control_get_time_since_action_async (PkControl *control, PkRoleEnum role, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
We may want to know how long it has been since we refreshed the cache or retrieved the update list.
|
a valid PkControl instance |
|
the role enum, e.g. PK_ROLE_ENUM_GET_UPDATES
|
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
guint pk_control_get_time_since_action_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
|
a valid PkControl instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
TRUE if the daemon serviced the request
|
void pk_control_get_transaction_list_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
Gets the transactions currently running in the daemon.
|
a valid PkControl instance |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
gchar ** pk_control_get_transaction_list_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
|
a valid PkControl instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
A GStrv list of transaction ID's, free with g_strfreev()
|
void pk_control_can_authorize_async (PkControl *control, const gchar *action_id, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
We may want to know before we run a method if we are going to be denied, accepted or challenged for authentication.
|
a valid PkControl instance |
|
The action ID, for instance "org.freedesktop.PackageKit.install-untrusted" |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
PkAuthorizeEnum pk_control_can_authorize_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
|
a valid PkControl instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
the PkAuthorizeEnum or PK_AUTHORIZE_ENUM_UNKNOWN if the method failed
|
void pk_control_get_properties_async (PkControl *control, GCancellable *cancellable, GAsyncReadyCallback callback, gpointer user_data);
Gets global properties from the daemon.
|
a valid PkControl instance |
|
a GCancellable or NULL
|
|
the function to run on completion |
|
the data to pass to callback
|
gboolean pk_control_get_properties_finish (PkControl *control, GAsyncResult *res, GError **error);
Gets the result from the asynchronous function.
|
a valid PkControl instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
TRUE if we set the proxy successfully
|
"repo-list-changed"
signalvoid user_function (PkControl *control, gpointer user_data) : Run Last
The ::repo-list-changed signal is emitted when the repo list may have changed and the control program may have to update some UI.
|
the PkControl instance that emitted the signal |
|
user data set when the signal handler was connected. |
"restart-schedule"
signalvoid user_function (PkControl *control, gpointer user_data) : Run Last
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.
|
the PkControl instance that emitted the signal |
|
user data set when the signal handler was connected. |
"transaction-list-changed"
signalvoid user_function (PkControl *control, GStrv *arg1, gpointer user_data) : Run Last
The ::transaction-list-changed signal is emitted when the list of transactions handled by the daemon is changed.
|
the PkControl instance that emitted the signal |
|
user data set when the signal handler was connected. |
"updates-changed"
signalvoid user_function (PkControl *control, gpointer user_data) : Run Last
The ::updates-changed signal is emitted when the update list may have changed and the control program may have to update some UI.
|
the PkControl instance that emitted the signal |
|
user data set when the signal handler was connected. |