| PackageKit Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | ||||
PkResults * pk_task_remove_packages_sync (PkTask *task,gchar **package_ids,gboolean allow_deps,gboolean autoremove,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_install_packages_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_update_packages_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_install_files_sync (PkTask *task,gchar **files,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_resolve_sync (PkTask *task,PkBitfield filters,gchar **packages,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_search_names_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_search_details_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_search_groups_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_search_files_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_details_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_update_detail_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_download_packages_sync (PkTask *task,gchar **package_ids,const gchar *directory,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_updates_sync (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_depends_sync (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_packages_sync (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_requires_sync (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_what_provides_sync (PkTask *task,PkBitfield filters,PkProvidesEnum provides,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_files_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_categories_sync (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_refresh_cache_sync (PkTask *task,gboolean force,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_get_repo_list_sync (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_repo_enable_sync (PkTask *task,const gchar *repo_id,gboolean enabled,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error); PkResults * pk_task_repair_system_sync (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
PkResults * pk_task_remove_packages_sync (PkTask *task,gchar **package_ids,gboolean allow_deps,gboolean autoremove,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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.
Warning: this function is synchronous, and may block. Do not use it in GUI applications.
|
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.5.3
PkResults * pk_task_install_packages_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
Install a package of the newest and most correct version.
Warning: this function is synchronous, and may block. Do not use it in GUI applications.
|
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.5.3
PkResults * pk_task_update_packages_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
Update specific packages to the newest available versions.
Warning: this function is synchronous, and may block. Do not use it in GUI applications.
|
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.5.3
PkResults * pk_task_install_files_sync (PkTask *task,gchar **files,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
Install a file locally, and get the deps from the repositories. This is useful for double clicking on a .rpm or .deb file.
Warning: this function is synchronous, and may block. Do not use it in GUI applications.
|
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.5.3
PkResults * pk_task_resolve_sync (PkTask *task,PkBitfield filters,gchar **packages,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_search_names_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_search_details_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_search_groups_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_search_files_sync (PkTask *task,PkBitfield filters,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_details_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_update_detail_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_download_packages_sync (PkTask *task,gchar **package_ids,const gchar *directory,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_updates_sync (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_depends_sync (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
Get the list of dependent 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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_packages_sync (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_requires_sync (PkTask *task,PkBitfield filters,gchar **package_ids,gboolean recursive,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_what_provides_sync (PkTask *task,PkBitfield filters,PkProvidesEnum provides,gchar **values,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_files_sync (PkTask *task,gchar **package_ids,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_categories_sync (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_refresh_cache_sync (PkTask *task,gboolean force,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_get_repo_list_sync (PkTask *task,PkBitfield filters,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_repo_enable_sync (PkTask *task,const gchar *repo_id,gboolean enabled,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.6.5
PkResults * pk_task_repair_system_sync (PkTask *task,GCancellable *cancellable,PkProgressCallback progress_callback,gpointer progress_user_data,GError **error);
Recover from broken dependencies of installed packages or incomplete installations.
Warning: this function is synchronous, and may block. Do not use it in GUI applications.
|
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 GError to store any failure, or NULL
|
Returns : |
a PkResults object, or NULL for error. [transfer full]
|
Since 0.7.2