pk-client-sync: PackageKit Reference Manual

pk-client-sync

Functions

PkResults *	pk_client_resolve ()
PkResults *	pk_client_search_names ()
PkResults *	pk_client_search_details ()
PkResults *	pk_client_search_groups ()
PkResults *	pk_client_search_files ()
PkResults *	pk_client_get_details ()
PkResults *	pk_client_get_details_local ()
PkResults *	pk_client_get_files_local ()
PkResults *	pk_client_get_update_detail ()
PkResults *	pk_client_download_packages ()
PkResults *	pk_client_get_updates ()
PkResults *	pk_client_get_old_transactions ()
PkResults *	pk_client_depends_on ()
PkResults *	pk_client_get_packages ()
PkResults *	pk_client_required_by ()
PkResults *	pk_client_what_provides ()
PkResults *	pk_client_get_distro_upgrades ()
PkResults *	pk_client_get_files ()
PkResults *	pk_client_get_categories ()
PkResults *	pk_client_remove_packages ()
PkResults *	pk_client_refresh_cache ()
PkResults *	pk_client_install_packages ()
PkResults *	pk_client_install_signature ()
PkResults *	pk_client_update_packages ()
PkResults *	pk_client_install_files ()
PkResults *	pk_client_accept_eula ()
PkResults *	pk_client_get_repo_list ()
PkResults *	pk_client_repo_enable ()
PkResults *	pk_client_repo_set_data ()
PkResults *	pk_client_repo_remove ()
PkResults *	pk_client_upgrade_system ()
PkResults *	pk_client_repair_system ()
PkResults *	pk_client_adopt ()
PkProgress *	pk_client_get_progress ()

Description

Functions

pk_client_resolve ()

PkResults *
pk_client_resolve (PkClient *client,
                   PkBitfield filters,
                   gchar **packages,
                   GCancellable *cancellable,
                   PkProgressCallback progress_callback,
                   gpointer progress_user_data,
                   GError **error);

Resolve a package name into a package_id. This can return installed and available packages and allows you find out if a package is installed locally or is available in a repository.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
packages	an array of package names to resolve, e.g. "gnome-system-tools".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_search_names ()

PkResults *
pk_client_search_names (PkClient *client,
                        PkBitfield filters,
                        gchar **values,
                        GCancellable *cancellable,
                        PkProgressCallback progress_callback,
                        gpointer progress_user_data,
                        GError **error);

Search all the locally installed files and remote repositories for a package that matches a specific name.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
values	free text to search for, for instance, "power".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.5

pk_client_search_details ()

PkResults *
pk_client_search_details (PkClient *client,
                          PkBitfield filters,
                          gchar **values,
                          GCancellable *cancellable,
                          PkProgressCallback progress_callback,
                          gpointer progress_user_data,
                          GError **error);

Search all detailed summary information to try and find a keyword. Think of this as pk_client_search_names(), but trying much harder and taking longer.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
values	free text to search for, for instance, "power".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.5

pk_client_search_groups ()

PkResults *
pk_client_search_groups (PkClient *client,
                         PkBitfield filters,
                         gchar **values,
                         GCancellable *cancellable,
                         PkProgressCallback progress_callback,
                         gpointer progress_user_data,
                         GError **error);

Return all packages in a specific group.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
values	a group enum to search for, for instance, "system-tools".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.5

pk_client_search_files ()

PkResults *
pk_client_search_files (PkClient *client,
                        PkBitfield filters,
                        gchar **values,
                        GCancellable *cancellable,
                        PkProgressCallback progress_callback,
                        gpointer progress_user_data,
                        GError **error);

Search for packages that provide a specific file.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
values	file to search for, for instance, "/sbin/service".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.5

pk_client_get_details ()

PkResults *
pk_client_get_details (PkClient *client,
                       gchar **package_ids,
                       GCancellable *cancellable,
                       PkProgressCallback progress_callback,
                       gpointer progress_user_data,
                       GError **error);

Get details of a package, so more information can be obtained for GUI or command line tools.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_details_local ()

PkResults *
pk_client_get_details_local (PkClient *client,
                             gchar **files,
                             GCancellable *cancellable,
                             PkProgressCallback progress_callback,
                             gpointer progress_user_data,
                             GError **error);

Get details of a local package, so more information can be obtained for GUI or command line tools.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
files	a null terminated array of filenames.	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.8.17

pk_client_get_files_local ()

PkResults *
pk_client_get_files_local (PkClient *client,
                           gchar **files,
                           GCancellable *cancellable,
                           PkProgressCallback progress_callback,
                           gpointer progress_user_data,
                           GError **error);

Get file list of a local package, so more information can be obtained for GUI or command line tools.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
files	a null terminated array of filenames.	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.9.1

pk_client_get_update_detail ()

PkResults *
pk_client_get_update_detail (PkClient *client,
                             gchar **package_ids,
                             GCancellable *cancellable,
                             PkProgressCallback progress_callback,
                             gpointer progress_user_data,
                             GError **error);

Get details about the specific update, for instance any CVE urls and severity information.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_download_packages ()

PkResults *
pk_client_download_packages (PkClient *client,
                             gchar **package_ids,
                             const gchar *directory,
                             GCancellable *cancellable,
                             PkProgressCallback progress_callback,
                             gpointer progress_user_data,
                             GError **error);

Downloads package files to a specified location.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
directory	the location where packages are to be downloaded
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_updates ()

PkResults *
pk_client_get_updates (PkClient *client,
                       PkBitfield filters,
                       GCancellable *cancellable,
                       PkProgressCallback progress_callback,
                       gpointer progress_user_data,
                       GError **error);

Get a list of all the packages that can be updated for all repositories.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_DEVEL` or `PK_FILTER_ENUM_NONE`
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_old_transactions ()

PkResults *
pk_client_get_old_transactions (PkClient *client,
                                guint number,
                                GCancellable *cancellable,
                                PkProgressCallback progress_callback,
                                gpointer progress_user_data,
                                GError **error);

Get the old transaction list, mainly used for the transaction viewer.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
number	the number of past transactions to return, or 0 for all
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_depends_on ()

PkResults *
pk_client_depends_on (PkClient *client,
                      PkBitfield filters,
                      gchar **package_ids,
                      gboolean recursive,
                      GCancellable *cancellable,
                      PkProgressCallback progress_callback,
                      gpointer progress_user_data,
                      GError **error);

Get the packages that depend this one, i.e. child.parent.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
recursive	If we should search recursively for depends
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_packages ()

PkResults *
pk_client_get_packages (PkClient *client,
                        PkBitfield filters,
                        GCancellable *cancellable,
                        PkProgressCallback progress_callback,
                        gpointer progress_user_data,
                        GError **error);

Get the list of packages from the backend

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_required_by ()

PkResults *
pk_client_required_by (PkClient *client,
                       PkBitfield filters,
                       gchar **package_ids,
                       gboolean recursive,
                       GCancellable *cancellable,
                       PkProgressCallback progress_callback,
                       gpointer progress_user_data,
                       GError **error);

Get the packages that require this one, i.e. parent.child.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
recursive	If we should search recursively for requires
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_what_provides ()

PkResults *
pk_client_what_provides (PkClient *client,
                         PkBitfield filters,
                         gchar **values,
                         GCancellable *cancellable,
                         PkProgressCallback progress_callback,
                         gpointer progress_user_data,
                         GError **error);

This should return packages that provide the supplied attributes. This method is useful for finding out what package(s) provide a modalias or GStreamer codec string.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_GUI` \| `PK_FILTER_ENUM_FREE` or `PK_FILTER_ENUM_NONE`
values	a search term such as "sound/mp3".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_distro_upgrades ()

PkResults *
pk_client_get_distro_upgrades (PkClient *client,
                               GCancellable *cancellable,
                               PkProgressCallback progress_callback,
                               gpointer progress_user_data,
                               GError **error);

This method should return a list of distribution upgrades that are available. It should not return updates, only major upgrades.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_files ()

PkResults *
pk_client_get_files (PkClient *client,
                     gchar **package_ids,
                     GCancellable *cancellable,
                     PkProgressCallback progress_callback,
                     gpointer progress_user_data,
                     GError **error);

Get the file list (i.e. a list of files installed) for the specified package.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_categories ()

PkResults *
pk_client_get_categories (PkClient *client,
                          GCancellable *cancellable,
                          PkProgressCallback progress_callback,
                          gpointer progress_user_data,
                          GError **error);

Get a list of all categories supported.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_remove_packages ()

PkResults *
pk_client_remove_packages (PkClient *client,
                           PkBitfield transaction_flags,
                           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.

Parameters

client	a valid PkClient instance
transaction_flags	a transaction type bitfield
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
allow_deps	if other dependent packages are allowed to be removed from the computer
autoremove	if other packages installed at the same time should be tried to remove
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.8.1

pk_client_refresh_cache ()

PkResults *
pk_client_refresh_cache (PkClient *client,
                         gboolean force,
                         GCancellable *cancellable,
                         PkProgressCallback progress_callback,
                         gpointer progress_user_data,
                         GError **error);

Refresh the cache, i.e. download new metadata from a remote URL so that package lists are up to date. This action may take a few minutes and should be done when the session and system are idle.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
force	if we should aggressively drop caches
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_install_packages ()

PkResults *
pk_client_install_packages (PkClient *client,
                            PkBitfield transaction_flags,
                            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.

Parameters

client	a valid PkClient instance
transaction_flags	a transaction type bitfield
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.8.1

pk_client_install_signature ()

PkResults *
pk_client_install_signature (PkClient *client,
                             PkSigTypeEnum type,
                             const gchar *key_id,
                             const gchar *package_id,
                             GCancellable *cancellable,
                             PkProgressCallback progress_callback,
                             gpointer progress_user_data,
                             GError **error);

Install a software source signature of the newest and most correct version.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
type	the signature type, e.g. `PK_SIGTYPE_ENUM_GPG`
key_id	a key ID such as "0df23df"
package_id	a signature_id structure such as "hal;0.0.1;i386;fedora"
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_update_packages ()

PkResults *
pk_client_update_packages (PkClient *client,
                           PkBitfield transaction_flags,
                           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.

Parameters

client	a valid PkClient instance
transaction_flags	a transaction type bitfield
package_ids	a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.8.1

pk_client_install_files ()

PkResults *
pk_client_install_files (PkClient *client,
                         PkBitfield transaction_flags,
                         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.

Parameters

client	a valid PkClient instance
transaction_flags	a transaction type bitfield
files	a file such as "/home/hughsie/Desktop/hal-devel-0.10.0.rpm".	[array zero-terminated=1]
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.8.1

pk_client_accept_eula ()

PkResults *
pk_client_accept_eula (PkClient *client,
                       const gchar *eula_id,
                       GCancellable *cancellable,
                       PkProgressCallback progress_callback,
                       gpointer progress_user_data,
                       GError **error);

We may want to agree to a EULA dialog if one is presented.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
eula_id	the `eula_id` we are agreeing to
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_repo_list ()

PkResults *
pk_client_get_repo_list (PkClient *client,
                         PkBitfield filters,
                         GCancellable *cancellable,
                         PkProgressCallback progress_callback,
                         gpointer progress_user_data,
                         GError **error);

Get the list of repositories installed on the system.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
filters	a `PkBitfield` such as `PK_FILTER_ENUM_DEVEL` or `PK_FILTER_ENUM_NONE`
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_repo_enable ()

PkResults *
pk_client_repo_enable (PkClient *client,
                       const gchar *repo_id,
                       gboolean enabled,
                       GCancellable *cancellable,
                       PkProgressCallback progress_callback,
                       gpointer progress_user_data,
                       GError **error);

Enable or disable the repository.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
repo_id	a repo_id structure such as "livna-devel"
enabled	if we should enable the repository
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_repo_set_data ()

PkResults *
pk_client_repo_set_data (PkClient *client,
                         const gchar *repo_id,
                         const gchar *parameter,
                         const gchar *value,
                         GCancellable *cancellable,
                         PkProgressCallback progress_callback,
                         gpointer progress_user_data,
                         GError **error);

We may want to set a repository parameter. NOTE: this is free text, and is left to the backend to define a format.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
repo_id	a repo_id structure such as "livna-devel"
parameter	the parameter to change
value	what we should change it to
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_repo_remove ()

PkResults *
pk_client_repo_remove (PkClient *client,
                       PkBitfield transaction_flags,
                       const gchar *repo_id,
                       gboolean autoremove,
                       GCancellable *cancellable,
                       PkProgressCallback progress_callback,
                       gpointer progress_user_data,
                       GError **error);

Removes a repo and optionally the packages installed from it.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
transaction_flags	transaction flags
repo_id	a repo_id structure such as "livna-devel"
autoremove	If packages should be auto-removed
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.9.1

pk_client_upgrade_system ()

PkResults *
pk_client_upgrade_system (PkClient *client,
                          PkBitfield transaction_flags,
                          const gchar *distro_id,
                          PkUpgradeKindEnum upgrade_kind,
                          GCancellable *cancellable,
                          PkProgressCallback progress_callback,
                          gpointer progress_user_data,
                          GError **error);

This transaction will upgrade the distro to the next version, which may involve just downloading the installer and setting up the boot device, or may involve doing an on-line upgrade.

The backend will decide what is best to do.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

distro_id	a distro ID such as "fedora-14"
upgrade_kind	a PkUpgradeKindEnum such as `PK_UPGRADE_KIND_ENUM_COMPLETE`
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 1.0.10

pk_client_repair_system ()

PkResults *
pk_client_repair_system (PkClient *client,
                         PkBitfield transaction_flags,
                         GCancellable *cancellable,
                         PkProgressCallback progress_callback,
                         gpointer progress_user_data,
                         GError **error);

This transaction will try to recover from a broken package management system: e.g. the installation of a package with unsatisfied dependencies has been forced by using a low level tool (rpm or dpkg) or the system was shutdown during processing an installation.

The backend will decide what is best to do.

Warning: this function is synchronous, and may block. Do not use it in GUI applications.

Parameters

transaction_flags	if only trusted packages should be installed
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.8.1

pk_client_adopt ()

PkResults *
pk_client_adopt (PkClient *client,
                 const gchar *transaction_id,
                 GCancellable *cancellable,
                 PkProgressCallback progress_callback,
                 gpointer progress_user_data,
                 GError **error);

Adopt a transaction.

Warning: this function is synchronous, and will block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
transaction_id	a transaction ID such as "/21_ebcbdaae_data"
cancellable	a GCancellable or `NULL`
progress_callback	the function to run when the progress changes.	[scope call]
progress_user_data	data to pass to `progress_callback`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3

pk_client_get_progress ()

PkProgress *
pk_client_get_progress (PkClient *client,
                        const gchar *transaction_id,
                        GCancellable *cancellable,
                        GError **error);

Get the progress of a transaction.

Warning: this function is synchronous, and will block. Do not use it in GUI applications.

Parameters

client	a valid PkClient instance
transaction_id	The transaction id
cancellable	a GCancellable or `NULL`
error	the GError to store any failure, or `NULL`

Returns

a PkResults object, or NULL for error.

[transfer full]

Since: 0.5.3