![]() |
![]() |
![]() |
PackageKit Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Signals |
#define PK_CLIENT_ERROR #define PK_CLIENT_TYPE_ERROR #define PK_CLIENT_PERCENTAGE_INVALID enum PkClientError; PkClientPrivate; PkClient; GQuark pk_client_error_quark (void); GType pk_client_get_type (void); PkClient * pk_client_new (void); gboolean pk_client_set_tid (PkClient *client, const gchar *tid, GError **error); gchar * pk_client_get_tid (PkClient *client); gboolean pk_client_set_use_buffer (PkClient *client, gboolean use_buffer, GError **error); gboolean pk_client_set_synchronous (PkClient *client, gboolean synchronous, GError **error); gboolean pk_client_set_timeout (PkClient *client, gint timeout, GError **error); gboolean pk_client_get_use_buffer (PkClient *client); gboolean pk_client_get_allow_cancel (PkClient *client, gboolean *allow_cancel, GError **error); gboolean pk_client_get_status (PkClient *client, PkStatusEnum *status, GError **error); gboolean pk_client_get_role (PkClient *client, PkRoleEnum *role, gchar **text, GError **error); gboolean pk_client_get_progress (PkClient *client, guint *percentage, guint *subpercentage, guint *elapsed, guint *remaining, GError **error); gboolean pk_client_get_package (PkClient *client, gchar **package, GError **error); gboolean pk_client_set_locale (PkClient *client, const gchar *code, GError **error); gboolean pk_client_cancel (PkClient *client, GError **error); gboolean pk_client_download_packages (PkClient *client, gchar **package_ids, const gchar *directory, GError **error); gboolean pk_client_get_updates (PkClient *client, PkBitfield filters, GError **error); gboolean pk_client_update_system (PkClient *client, GError **error); gboolean pk_client_search_name (PkClient *client, PkBitfield filters, const gchar *search, GError **error); gboolean pk_client_search_details (PkClient *client, PkBitfield filters, const gchar *search, GError **error); gboolean pk_client_search_group (PkClient *client, PkBitfield filters, const gchar *search, GError **error); gboolean pk_client_search_file (PkClient *client, PkBitfield filters, const gchar *search, GError **error); gboolean pk_client_get_depends (PkClient *client, PkBitfield filters, gchar **package_ids, gboolean recursive, GError **error); gboolean pk_client_get_packages (PkClient *client, PkBitfield filters, GError **error); gboolean pk_client_get_update_detail (PkClient *client, gchar **package_ids, GError **error); gboolean pk_client_get_requires (PkClient *client, PkBitfield filters, gchar **package_ids, gboolean recursive, GError **error); gboolean pk_client_what_provides (PkClient *client, PkBitfield filters, PkProvidesEnum provides, const gchar *search, GError **error); gboolean pk_client_get_details (PkClient *client, gchar **package_ids, GError **error); gboolean pk_client_get_distro_upgrades (PkClient *client, GError **error); gboolean pk_client_get_files (PkClient *client, gchar **package_ids, GError **error); gboolean pk_client_get_categories (PkClient *client, GError **error); gboolean pk_client_remove_packages (PkClient *client, gchar **package_ids, gboolean allow_deps, gboolean autoremove, GError **error); gboolean pk_client_refresh_cache (PkClient *client, gboolean force, GError **error); gboolean pk_client_install_packages (PkClient *client, gchar **package_ids, GError **error); gboolean pk_client_install_signature (PkClient *client, PkSigTypeEnum type, const gchar *key_id, const gchar *package_id, GError **error); gboolean pk_client_update_packages (PkClient *client, gchar **package_ids, GError **error); gboolean pk_client_install_files (PkClient *client, gboolean trusted, gchar **files_rel, GError **error); gboolean pk_client_install_file (PkClient *client, gboolean trusted, const gchar *file_rel, GError **error); gboolean pk_client_resolve (PkClient *client, PkBitfield filters, gchar **packages, GError **error); gboolean pk_client_rollback (PkClient *client, const gchar *transaction_id, GError **error); gboolean pk_client_requeue (PkClient *client, GError **error); gboolean pk_client_accept_eula (PkClient *client, const gchar *eula_id, GError **error); gboolean pk_client_get_repo_list (PkClient *client, PkBitfield filters, GError **error); gboolean pk_client_repo_enable (PkClient *client, const gchar *repo_id, gboolean enabled, GError **error); gboolean pk_client_repo_set_data (PkClient *client, const gchar *repo_id, const gchar *parameter, const gchar *value, GError **error); PkPackageList * pk_client_get_package_list (PkClient *client); PkRestartEnum pk_client_get_require_restart (PkClient *client); const GPtrArray * pk_client_get_require_restart_list (PkClient *client); PkObjList * pk_client_get_cached_objects (PkClient *client); gboolean pk_client_reset (PkClient *client, GError **error); gboolean pk_client_get_old_transactions (PkClient *client, guint number, GError **error); gboolean pk_client_is_caller_active (PkClient *client, gboolean *is_active, GError **error);
"allow-cancel" : Run Last "caller-active-changed" : Run Last "category" : Run Last "destroy" : Run Last "details" : Run Last "distro-upgrade" : Run Last "error-code" : Run Last "eula-required" : Run Last "files" : Run Last "finished" : Run Last "media-change-required" : Run Last "message" : Run Last "package" : Run Last "progress-changed" : Run Last "repo-detail" : Run Last "repo-signature-required" : Run Last "require-restart" : Run Last "status-changed" : Run Last "transaction" : Run Last "update-detail" : Run Last
typedef enum { PK_CLIENT_ERROR_FAILED, PK_CLIENT_ERROR_FAILED_AUTH, PK_CLIENT_ERROR_NO_TID, PK_CLIENT_ERROR_ALREADY_TID, PK_CLIENT_ERROR_ROLE_UNKNOWN, PK_CLIENT_ERROR_CANNOT_START_DAEMON, PK_CLIENT_ERROR_INVALID_INPUT, PK_CLIENT_ERROR_INVALID_FILE, PK_CLIENT_ERROR_NOT_SUPPORTED } PkClientError;
Errors that can be thrown
the transaction failed for an unknown reason | |
the transaction id was not pre-allocated (internal error) | |
the transaction id has already been used (internal error) | |
the role was not set (internal error) | |
the package_id is invalid | |
PkClient * pk_client_new (void);
PkClient is a nice GObject wrapper for PackageKit and makes writing frontends easy.
Returns : |
A new PkClient instance
|
gboolean pk_client_set_tid (PkClient *client, const gchar *tid, GError **error);
This method sets the transaction ID that should be used for the DBUS method and then watched for any callback signals. You cannot call pk_client_set_tid multiple times for one instance.
gchar * pk_client_get_tid (PkClient *client);
The tid
is unique for this transaction.
gboolean pk_client_set_use_buffer (PkClient *client, gboolean use_buffer, GError **error);
If the package buffer is enabled then after the transaction has completed then the package list can be retrieved in one go, rather than processing each package request async. If this is not set true explicitly, then pk_client_get_package_list will always return zero items.
This is not forced on as there may be significant overhead if the list contains many hundreds of items.
gboolean pk_client_set_synchronous (PkClient *client, gboolean synchronous, GError **error);
A synchronous mode allows us to listen in all transactions.
gboolean pk_client_set_timeout (PkClient *client, gint timeout, GError **error);
A synchronous mode allows us to listen in all transactions.
gboolean pk_client_get_use_buffer (PkClient *client);
Are we using a client side package buffer?
gboolean pk_client_get_allow_cancel (PkClient *client, gboolean *allow_cancel, GError **error);
Should we be allowed to cancel this transaction?
The tid should have been set with pk_client_set_tid()
if this is being done
on a foreign object.
gboolean pk_client_get_status (PkClient *client, PkStatusEnum *status, GError **error);
Gets the status of a transaction. A transaction has one roles in it's lifetime, but many values of status.
gboolean pk_client_get_role (PkClient *client, PkRoleEnum *role, gchar **text, GError **error);
The role is the action of the transaction as does not change for the entire lifetime of the transaction.
gboolean pk_client_get_progress (PkClient *client, guint *percentage, guint *subpercentage, guint *elapsed, guint *remaining, GError **error);
To show the user a progress bar or dialog is much more friendly than
just a pulsing bar, so we can return this information here.
NOTE: the time_remaining
value is guessed and may not be accurate if the
backend does not do frequent calls to pk_backend_set_percentage()
.
|
a valid PkClient instance |
|
the percentage complete of the transaction |
|
the percentage complete of the sub-transaction |
|
the duration so far of the transaction |
|
the estimated time to completion of the transaction |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if we found the progress successfully
|
gboolean pk_client_get_package (PkClient *client, gchar **package, GError **error);
Gets the aim of the transaction, e.g. what was asked to be installed or searched for.
gboolean pk_client_set_locale (PkClient *client, const gchar *code, GError **error);
Set the locale for this transaction. You normally don't need to call this function as the locale is set automatically when the tid is requested.
gboolean pk_client_cancel (PkClient *client, GError **error);
Cancel the transaction if possible. This is good idea when downloading or depsolving, but not when writing to the disk. The daemon shouldn't let you do anything stupid, so it's quite safe to call this method.
gboolean pk_client_download_packages (PkClient *client, gchar **package_ids, const gchar *directory, GError **error);
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora" |
|
the location where packages are to be downloaded |
|
a GError to put the error code and message in, or NULL
Get the packages that depend this one, i.e. child->parent.
Return value: TRUE if the daemon queued the transaction
|
Returns : |
gboolean pk_client_get_updates (PkClient *client, PkBitfield filters, GError **error);
Get a list of all the packages that can be updated for all repositories.
gboolean pk_client_update_system (PkClient *client, GError **error);
Update all the packages on the system with the highest versions found in all
repositories.
NOTE: you can't choose what repositories to update from, but you can do:
- pk_client_repo_disable()
- pk_client_update_system()
- pk_client_repo_enable()
gboolean pk_client_search_name (PkClient *client, PkBitfield filters, const gchar *search, GError **error);
Search all the locally installed files and remote repositories for a package that matches a specific name.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
free text to search for, for instance, "power" |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_search_details (PkClient *client, PkBitfield filters, const gchar *search, GError **error);
Search all detailed summary information to try and find a keyword.
Think of this as pk_client_search_name()
, but trying much harder and
taking longer.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
free text to search for, for instance, "power" |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_search_group (PkClient *client, PkBitfield filters, const gchar *search, GError **error);
Return all packages in a specific group.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
a group enum to search for, for instance, "system-tools" |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_search_file (PkClient *client, PkBitfield filters, const gchar *search, GError **error);
Search for packages that provide a specific file.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
file to search for, for instance, "/sbin/service" |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_get_depends (PkClient *client, PkBitfield filters, gchar **package_ids, gboolean recursive, GError **error);
Get the packages that depend this one, i.e. child->parent.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora" |
|
If we should search recursively for depends |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_get_packages (PkClient *client, PkBitfield filters, GError **error);
Get the list of packages from the backend
gboolean pk_client_get_update_detail (PkClient *client, gchar **package_ids, GError **error);
Get details about the specific update, for instance any CVE urls and severity information.
gboolean pk_client_get_requires (PkClient *client, PkBitfield filters, gchar **package_ids, gboolean recursive, GError **error);
Get the packages that require this one, i.e. parent->child.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora" |
|
If we should search recursively for requires |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_what_provides (PkClient *client, PkBitfield filters, PkProvidesEnum provides, const gchar *search, 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.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
a PkProvidesEnum value such as PK_PROVIDES_ENUM_CODEC |
|
a search term such as "sound/mp3" |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_get_details (PkClient *client, gchar **package_ids, GError **error);
Get details of a package, so more information can be obtained for GUI or command line tools.
gboolean pk_client_get_distro_upgrades (PkClient *client, GError **error);
This method should return a list of distribution upgrades that are available. It should not return updates, only major upgrades.
gboolean pk_client_get_files (PkClient *client, gchar **package_ids, GError **error);
Get the file list (i.e. a list of files installed) for the specified package.
gboolean pk_client_get_categories (PkClient *client, GError **error);
Get a list of all categories supported
gboolean pk_client_remove_packages (PkClient *client, gchar **package_ids, gboolean allow_deps, gboolean autoremove, 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.
|
a valid PkClient instance |
|
a null terminated array of package_id structures such as "hal;0.0.1;i386;fedora" |
|
if other dependant packages are allowed to be removed from the computer |
|
if other packages installed at the same time should be tried to remove |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_refresh_cache (PkClient *client, gboolean force, 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.
gboolean pk_client_install_packages (PkClient *client, gchar **package_ids, GError **error);
Install a package of the newest and most correct version.
gboolean pk_client_install_signature (PkClient *client, PkSigTypeEnum type, const gchar *key_id, const gchar *package_id, GError **error);
Install a signature of the newest and most correct version.
gboolean pk_client_update_packages (PkClient *client, gchar **package_ids, GError **error);
Update specific packages to the newest available versions.
gboolean pk_client_install_files (PkClient *client, gboolean trusted, gchar **files_rel, 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.
gboolean pk_client_install_file (PkClient *client, gboolean trusted, const gchar *file_rel, GError **error);
|
|
|
|
|
|
|
|
Returns : |
gboolean pk_client_resolve (PkClient *client, PkBitfield filters, gchar **packages, 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.
|
a valid PkClient instance |
|
a PkBitfield such as PK_FILTER_ENUM_GUI | PK_FILTER_ENUM_FREE or PK_FILTER_ENUM_NONE
|
|
an array of package names to resolve, e.g. "gnome-system-tools" |
|
a GError to put the error code and message in, or NULL
|
Returns : |
TRUE if the daemon queued the transaction
|
gboolean pk_client_rollback (PkClient *client, const gchar *transaction_id, GError **error);
Roll back to a previous transaction. I think only conary supports this right now, but it's useful to add an abstract way of doing it.
gboolean pk_client_requeue (PkClient *client, GError **error);
We might need to requeue if we want to take an existing PkClient instance and re-run it after completion. Doing this allows us to do things like re-searching when the output list may have changed state.
gboolean pk_client_accept_eula (PkClient *client, const gchar *eula_id, GError **error);
We may want to agree to a EULA dialog if one is presented.
gboolean pk_client_get_repo_list (PkClient *client, PkBitfield filters, GError **error);
Get the list of repositories installed on the system.
gboolean pk_client_repo_enable (PkClient *client, const gchar *repo_id, gboolean enabled, GError **error);
Enable or disable the repository.
gboolean pk_client_repo_set_data (PkClient *client, const gchar *repo_id, const gchar *parameter, const gchar *value, 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.
PkPackageList * pk_client_get_package_list (PkClient *client);
We do not provide access to the internal package list (as it could be being updated) so provide a way to get access to objects here.
|
a valid PkClient instance |
Returns : |
The PkPackageList or NULL if not found or invalid
|
PkRestartEnum pk_client_get_require_restart (PkClient *client);
This method returns the 'worst' restart of all the transactions. It is needed as multiple sub-transactions may emit require-restart with different values, and we always want to get the most invasive of all.
For instance, if a transaction emits RequireRestart(system) and then RequireRestart(session) then pk_client_get_require_restart will return system as a session restart is implied with a system restart.
|
a valid PkClient instance |
Returns : |
a PkRestartEnum value, e.g. PK_RESTART_ENUM_SYSTEM |
const GPtrArray * pk_client_get_require_restart_list (PkClient *client);
This method allows a client program to discover what packages caused different require restarts.
|
a valid PkClient instance |
Returns : |
a PkRestartEnum value, e.g. PK_RESTART_ENUM_SYSTEM |
PkObjList * pk_client_get_cached_objects (PkClient *client);
Return the cached object list
gboolean pk_client_reset (PkClient *client, GError **error);
Resetting the client way be needed if we canceled the request without waiting for ::finished, or if we want to reuse the PkClient without unreffing and creating it again.
If you call pk_client_reset()
on a running transaction, then it will be
automatically cancelled. If the cancel fails, the reset will fail.
gboolean pk_client_get_old_transactions (PkClient *client, guint number, GError **error);
Get the old transaction list, mainly used for the rollback viewer.
"allow-cancel"
signalvoid user_function (PkClient *client, gboolean allow_cancel, gpointer user_data) : Run Last
The ::allow-cancel signal is emitted when the transaction cancellable value changes.
You probably want to enable and disable cancel buttons according to this value.
|
the PkClient instance that emitted the signal |
|
If cancel would succeed |
|
user data set when the signal handler was connected. |
"caller-active-changed"
signalvoid user_function (PkClient *client, gboolean is_active, gpointer user_data) : Run Last
The ::caller-active-changed signal is emitted when the client that issued the dbus method is exited.
|
the PkClient instance that emitted the signal |
|
if the caller is still active |
|
user data set when the signal handler was connected. |
"category"
signalvoid user_function (PkClient *client, gpointer obj, gpointer user_data) : Run Last
The ::category signal is emitted when GetCategories()
is called.
|
the PkClient instance that emitted the signal |
|
a pointer to a PkCategoryObj structure describing the category |
|
user data set when the signal handler was connected. |
"destroy"
signalvoid user_function (PkClient *client, gpointer user_data) : Run Last
The ::destroy signal is emitted when the transaction has been destroyed and is no longer available for use.
|
the PkClient instance that emitted the signal |
|
user data set when the signal handler was connected. |
"details"
signalvoid user_function (PkClient *client, gpointer obj, gpointer user_data) : Run Last
The ::details signal is emitted when GetDetails()
is called.
|
the PkClient instance that emitted the signal |
|
a pointer to a PkDetailObj structure describing the package in detail |
|
user data set when the signal handler was connected. |
"distro-upgrade"
signalvoid user_function (PkClient *pkclient, gpointer arg1, gpointer user_data) : Run Last
|
the object which received the signal. |
|
|
|
user data set when the signal handler was connected. |
"error-code"
signalvoid user_function (PkClient *tlist, guint client, gchar *code, gpointer user_data) : Run Last
The ::error-code signal is emitted when the transaction wants to convey an error in the transaction.
This can only happen once in a transaction.
|
the PkTaskList instance that emitted the signal |
|
the PkClient instance that caused the signal |
|
the PkErrorCodeEnum of the error, e.g. PK_ERROR_ENUM_DEP_RESOLUTION_FAILED |
|
the non-locaised details about the error |
|
user data set when the signal handler was connected. |
"eula-required"
signalvoid user_function (PkClient *client, gchar *eula_id, gchar *package_id, gchar *vendor_name, gchar *license_agreement, gpointer user_data) : Run Last
The ::eula signal is emitted when the transaction needs to fail for a EULA prompt.
|
the PkClient instance that emitted the signal |
|
the EULA id, e.g. vmware5_single_user
|
|
the package_id of the package |
|
the Vendor name, e.g. Acme Corp. |
|
the text of the license agreement |
|
user data set when the signal handler was connected. |
"files"
signalvoid user_function (PkClient *package_id, gchar *files, gchar *arg2, gpointer user_data) : Run Last
The ::files signal is emitted when the method GetFiles()
is used.
|
the package_id of the package |
|
the list of files owned by the package, delimited by ';' |
|
user data set when the signal handler was connected. |
"finished"
signalvoid user_function (PkClient *client, guint exit, guint runtime, gpointer user_data) : Run Last
The ::finished signal is emitted when the transaction is complete.
|
the PkClient instance that emitted the signal |
|
the PkExitEnum status value, e.g. PK_EXIT_ENUM_SUCCESS |
|
the time in seconds the transaction has been running |
|
user data set when the signal handler was connected. |
"media-change-required"
signalvoid user_function (PkClient *client, guint media_type, gchar *media_id, gchar *media_text, gpointer user_data) : Run Last
The ::media-change-required signal is emitted when the transaction needs a different media to grab the packages.
This can only happen once in a transaction.
|
the PkClient instance that emitted the signal |
|
the PkMediaTypeEnum of the error, e.g. PK_MEDIA_TYPE_ENUM_DVD |
|
the non-localised label of the media |
|
the non-localised text describing the media |
|
user data set when the signal handler was connected. |
"message"
signalvoid user_function (PkClient *client, guint message, gchar *details, gpointer user_data) : Run Last
The ::message signal is emitted when the transaction wants to tell the user something.
|
the PkClient instance that emitted the signal |
|
the PkMessageEnum type of the message, e.g. PK_MESSAGE_ENUM_BROKEN_MIRROR
|
|
the non-localised message details |
|
user data set when the signal handler was connected. |
"package"
signalvoid user_function (PkClient *client, gpointer obj, gpointer user_data) : Run Last
The ::package signal is emitted when the update list may have changed and the client program may have to update some UI.
|
the PkClient instance that emitted the signal |
|
a pointer to a PkPackageObj structure describing the package |
|
user data set when the signal handler was connected. |
"progress-changed"
signalvoid user_function (PkClient *client, guint percentage, guint subpercentage, guint elapsed, guint client, gpointer user_data) : Run Last
The ::progress-changed signal is emitted when the update list may have changed and the client program may have to update some UI.
|
the PkClient instance that emitted the signal |
|
the percentage of the transaction |
|
the percentage of the sub-transaction |
|
the elapsed time in seconds of the transaction |
|
the remaining time in seconds of the transaction |
|
user data set when the signal handler was connected. |
"repo-detail"
signalvoid user_function (PkClient *client, gchar *repo_id, gchar *description, gboolean enabled, gpointer user_data) : Run Last
The ::repo-detail signal is emitted when the method GetRepos()
is
called.
|
the PkClient instance that emitted the signal |
|
the ID of the repository |
|
the description of the repository |
|
if the repository is enabled |
|
user data set when the signal handler was connected. |
"repo-signature-required"
signalvoid user_function (PkClient *client, gchar *package_id, gchar *repository_name, gchar *key_url, gchar *key_userid, gchar *key_id, gchar *key_fingerprint, gchar *key_timestamp, guint type, gpointer user_data) : Run Last
The ::repo-signature-required signal is emitted when the transaction needs to fail for a signature prompt.
|
the PkClient instance that emitted the signal |
|
the package_id of the package |
|
the name of the repository |
|
the URL of the repository |
|
the user signing the repository |
|
the id of the repository |
|
the fingerprint of the repository |
|
the timestamp of the repository |
|
the PkSigTypeEnum of the repository, e.g. PK_SIGTYPE_ENUM_GPG |
|
user data set when the signal handler was connected. |
"require-restart"
signalvoid user_function (PkClient *client, guint restart, gpointer details, gpointer user_data) : Run Last
The ::require-restart signal is emitted when the transaction requires a application or session restart.
|
the PkClient instance that emitted the signal |
|
the PkRestartEnum type of restart, e.g. PK_RESTART_ENUM_SYSTEM |
|
the optional details about the restart, why this is needed |
|
user data set when the signal handler was connected. |
"status-changed"
signalvoid user_function (PkClient *client, guint status, gpointer user_data) : Run Last
The ::status-changed signal is emitted when the transaction status has changed.
|
the PkClient instance that emitted the signal |
|
the PkStatusEnum type, e.g. PK_STATUS_ENUM_REMOVE |
|
user data set when the signal handler was connected. |
"transaction"
signalvoid user_function (PkClient *client, gpointer obj, gpointer user_data) : Run Last
The ::transaction is emitted when the method GetOldTransactions()
is
called, and the values are being replayed from a database.
|
the PkClient instance that emitted the signal |
|
a pointer to a PkTransactionObj structure describing the transaction |
|
user data set when the signal handler was connected. |
"update-detail"
signalvoid user_function (PkClient *client, gpointer obj, gpointer user_data) : Run Last
The ::update-detail signal is emitted when GetUpdateDetail()
is
called on a set of package_id's.
|
the PkClient instance that emitted the signal |
|
a pointer to a PkUpdateDetailsObj structure describing the update |
|
user data set when the signal handler was connected. |