| PackageKit Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
PkTaskPkTask — An abstract package task GObject, dealing with unsigned transactions, GPG keys and EULA requests. |
#define PK_TASK_TYPE_ERROR struct PkTask; struct PkTaskClass; PkTask * pk_task_new (void); void pk_task_test (gpointer user_data); PkResults * pk_task_generic_finish (PkTask *task,GAsyncResult *res,GError **error); void pk_task_install_packages_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_update_packages_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_remove_packages_async (PkTask *task,gchar **package_ids,gboolean allow_deps,gboolean autoremove,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_install_files_async (PkTask *task,gchar **files,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_resolve_async (PkTask *task,PkBitfield filters,gchar **packages,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_search_names_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_search_details_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_search_groups_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_search_files_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_details_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_update_detail_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_download_packages_async (PkTask *task,gchar **package_ids,const gchar *directory,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_updates_async (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_depends_async (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_packages_async (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_requires_async (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_what_provides_async (PkTask *task,PkBitfield filters,PkProvidesEnum provides,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_files_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_categories_async (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_refresh_cache_async (PkTask *task,gboolean force,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_get_repo_list_async (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_repo_enable_async (PkTask *task,const gchar *repo_id,gboolean enabled,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); void pk_task_repair_system_async (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data); gboolean pk_task_user_accepted (PkTask *task,guint request); gboolean pk_task_user_declined (PkTask *task,guint request); void pk_task_set_simulate (PkTask *task,gboolean simulate); gboolean pk_task_get_simulate (PkTask *task); void pk_task_set_interactive (PkTask *task,gboolean interactive); gboolean pk_task_get_interactive (PkTask *task); void pk_task_set_only_download (PkTask *task,gboolean only_download); gboolean pk_task_get_only_download (PkTask *task);
struct PkTaskClass {
PkClientClass parent_class;
void (*untrusted_question) (PkTask *task,
guint request,
PkResults *results);
void (*key_question) (PkTask *task,
guint request,
PkResults *results);
void (*eula_question) (PkTask *task,
guint request,
PkResults *results);
void (*media_change_question) (PkTask *task,
guint request,
PkResults *results);
void (*simulate_question) (PkTask *task,
guint request,
PkResults *results);
/* padding for future expansion */
void (*_pk_reserved1) (void);
void (*_pk_reserved2) (void);
void (*_pk_reserved3) (void);
void (*_pk_reserved4) (void);
void (*_pk_reserved5) (void);
};
PkResults * pk_task_generic_finish (PkTask *task,GAsyncResult *res,GError **error);
Gets the result from the asynchronous function.
|
a valid PkTask instance |
|
the GAsyncResult |
|
A GError or NULL
|
Returns : |
The PkResults of the transaction. [transfer full] |
Since 0.5.2
void pk_task_install_packages_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Merges in details about packages using resolve.
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.5.2
void pk_task_update_packages_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Update specific packages to the newest available versions.
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_task_remove_packages_async (PkTask *task,gchar **package_ids,gboolean allow_deps,gboolean autoremove,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Remove a package (optionally with dependancies) from the system.
If allow_deps is set to FALSE, and other packages would have to be removed,
then the transaction would fail.
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
if other dependent packages are allowed to be removed from the computer |
|
if other packages installed at the same time should be tried to remove |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_task_install_files_async (PkTask *task,gchar **files,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Install a file locally, and get the deps from the repositories. This is useful for double clicking on a .rpm or .deb file.
|
a valid PkTask instance |
|
a file such as "/home/hughsie/Desktop/hal-devel-0.10.0.rpm". [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.5.2
void pk_task_resolve_async (PkTask *task,PkBitfield filters,gchar **packages,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Resolves a package name to a package-id.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
package names to find |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_search_names_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Searches for a package name.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
search values. [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_search_details_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Searches for some package details.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
search values. [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_search_groups_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Searches the group lists.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
search values. [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_search_files_async (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Searches for specific files.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
search values. [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_details_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Gets details about packages.
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_update_detail_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Gets details about updates.
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_download_packages_async (PkTask *task,gchar **package_ids,const gchar *directory,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Downloads packages
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
the destination directory |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_updates_async (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Gets the update lists.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_depends_async (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Get the list of dependant packages.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
if we should recurse to packages that depend on other packages |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_packages_async (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Gets the list of packages.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_requires_async (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Get the packages this package requires.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
if we should return packages that depend on the ones we do |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_what_provides_async (PkTask *task,PkBitfield filters,PkProvidesEnum provides,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Find the package that provides some resource.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
a PkProvidesEnum type |
|
values to search for. [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_files_async (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Get the files in a package.
|
a valid PkTask instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora". [array zero-terminated=1] |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_categories_async (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Get the categories available.
|
a valid PkTask instance |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_refresh_cache_async (PkTask *task,gboolean force,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Refresh the package cache.
|
a valid PkTask instance |
|
if the metadata should be deleted and re-downloaded even if it is correct |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_get_repo_list_async (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Get the list of available repositories.
|
a valid PkTask instance |
|
a bitfield of filters that can be used to limit the results |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_repo_enable_async (PkTask *task,const gchar *repo_id,gboolean enabled,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Enable or disable a specific repo.
|
a valid PkTask instance |
|
The software source ID |
|
TRUE or FALSE
|
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback
|
Since 0.6.5
void pk_task_repair_system_async (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GAsyncReadyCallback callback_ready,gpointer user_data);
Recover the system from broken dependencies and aborted installations.
|
a valid PkTask instance |
|
a GCancellable or NULL
|
|
the function to run when the progress changes. [scope call] |
|
data to pass to progress_callback
|
|
the function to run on completion |
|
the data to pass to callback_ready
|
Since 0.7.2
void pk_task_set_simulate (PkTask *task,gboolean simulate);
If the simulate step should be run without the actual transaction.
|
a valid PkTask instance |
|
the simulate mode |
Since 0.6.10
gboolean pk_task_get_simulate (PkTask *task);
Gets if we are simulating.
Since 0.6.10
void pk_task_set_interactive (PkTask *task,gboolean interactive);
Sets the interactive mode, i.e. if the user is allowed to ask questions.
This method is deprecated, use pk_client_set_interactive() instead.
|
a valid PkTask instance |
|
if we are interactive |
Since 0.6.10
gboolean pk_task_get_interactive (PkTask *task);
Gets if the transaction is interactive.
This method is deprecated, use pk_client_get_interactive() instead.
Since 0.6.10
void pk_task_set_only_download (PkTask *task,gboolean only_download);
If the transaction should be prepared (depsolved, packages downloaded, etc) but not committed.
Since 0.8.1