PkTask

PkTask — An abstract package task GObject, dealing with unsignedtransactions, GPG keys and EULA requests.

Synopsis

        #define             
        PK_TASK_TYPE_ERROR
        struct              
        PkTask
        ;struct              
        PkTaskClass
        ;
        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
          
        
        );
        
          PkResults
        
         *         
        pk_task_generic_finish
                      (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              GAsyncResult
            
             *res
          
        
        ,                                                         
        
          
            
              GError
            
             **error
          
        
        );
        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_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_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_files_async
                     (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              gchar
            
             **package_ids
          
        
        ,                                                         
        
          
            
              GCancellable
            
             *cancellable
          
        
        ,                                                         
        
          
            
              PkProgressCallback
            
             progress_callback
          
        
        ,                                                         
        
          
            
              gpointer
            
             progress_user_data
          
        
        ,                                                         
        
          
            
              GAsyncReadyCallback
            
             callback_ready
          
        
        ,                                                         
        
          
            
              gpointer
            
             user_data
          
        
        );
        
          gboolean
        
        pk_task_get_interactive
                     (
        
          
            
              PkTask
            
             *task
          
        
        );
        
          gboolean
        
        pk_task_get_only_download
                   (
        
          
            
              PkTask
            
             *task
          
        
        );
        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_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_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
          
        
        );
        
          gboolean
        
        pk_task_get_simulate
                        (
        
          
            
              PkTask
            
             *task
          
        
        );
        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_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_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_install_packages_async
              (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              gchar
            
             **package_ids
          
        
        ,                                                         
        
          
            
              GCancellable
            
             *cancellable
          
        
        ,                                                         
        
          
            
              PkProgressCallback
            
             progress_callback
          
        
        ,                                                         
        
          
            
              gpointer
            
             progress_user_data
          
        
        ,                                                         
        
          
            
              GAsyncReadyCallback
            
             callback_ready
          
        
        ,                                                         
        
          
            
              gpointer
            
             user_data
          
        
        );
        
          PkTask
        
         *            
        pk_task_new
                                 (
        
          
            void
          
        
        );
        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_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_repair_system_async
                 (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              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_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_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_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_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_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_set_interactive
                     (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              gboolean
            
             interactive
          
        
        );
        void
        pk_task_set_only_download
                   (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              gboolean
            
             only_download
          
        
        );
        void
        pk_task_set_simulate
                        (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              gboolean
            
             simulate
          
        
        );
        void
        pk_task_test
                                (
        
          
            
              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
          
        
        );
        
          gboolean
        
        pk_task_user_accepted
                       (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              guint
            
             request
          
        
        );
        
          gboolean
        
        pk_task_user_declined
                       (
        
          
            
              PkTask
            
             *task
          
        
        ,                                                         
        
          
            
              guint
            
             request
          
        
        );
        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
          
        
        );
      

Object Hierarchy

        GObject
           +----
        PkClient
                 +----PkTask               +----PkTaskText               +----PkTaskWrapper
      

Properties

          "
        interactive
        "              
        
          gboolean
        
                      : Read / Write  "
        only-download
        "            
        
          gboolean
        
                      : Read / Write  "
        simulate
        "                 
        
          gboolean
        
                      : Read / Write
      

Description

Details

PK_TASK_TYPE_ERROR

#define PK_TASK_TYPE_ERROR (pk_task_error_get_type ())

struct PkTask

struct PkTask;

struct PkTaskClass

struct PkTaskClass {PkClientClassparent_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);};

pk_task_download_packages_async ()

          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

task  :

a valid PkTask 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 destination directory

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_generic_finish ()

          
            PkResults
          
           *         pk_task_generic_finish              (
          
            
              
                PkTask
              
               *task
            
          
          ,                                                         
          
            
              
                GAsyncResult
              
               *res
            
          
          ,                                                         
          
            
              
                GError
              
               **error
            
          
          );
        

Gets the result from the asynchronous function.

task  :

a valid PkTask instance

res  :

the GAsyncResult

error  :

A GError or NULL

Returns  :

The PkResults of the transaction. [ transfer full ]

Since 0.5.2


pk_task_get_categories_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_depends_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

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 recurse to packages that depend on other packages

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_details_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_files_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_interactive ()

          
            gboolean
          
                      pk_task_get_interactive             (
          
            
              
                PkTask
              
               *task
            
          
          );
        

Gets if the transaction is interactive.

task  :

a valid PkTask instance

Returns  :

TRUE for an interactive transaction.

Since 0.6.10


pk_task_get_only_download ()

          
            gboolean
          
                      pk_task_get_only_download           (
          
            
              
                PkTask
              
               *task
            
          
          );
        

Gets if we are just preparing the transaction for later.

task  :

a valid PkTask instance

Returns  :

TRUE if we are simulating

Since 0.8.1


pk_task_get_packages_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_repo_list_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_requires_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

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 return packages that depend on the ones we do

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_simulate ()

          
            gboolean
          
                      pk_task_get_simulate                (
          
            
              
                PkTask
              
               *task
            
          
          );
        

Gets if we are simulating.

task  :

a valid PkTask instance

Returns  :

TRUE if we are simulating

Since 0.6.10


pk_task_get_update_detail_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_get_updates_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_install_files_async ()

          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.

task  :

a valid PkTask instance

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback_ready

Since 0.5.2


pk_task_install_packages_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.5.2


pk_task_new ()

          
            PkTask
          
           *            pk_task_new                         (
          
            
              void
            
          
          );
        

Returns  :

a new PkTask object.

Since 0.5.2


pk_task_refresh_cache_async ()

          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.

task  :

a valid PkTask instance

force  :

if the metadata should be deleted and re-downloaded even if it is correct

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_remove_packages_async ()

          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.

task  :

a valid PkTask instance

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback_ready

Since 0.5.2


pk_task_repair_system_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback_ready

Since 0.7.2


pk_task_repo_enable_async ()

          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.

task  :

a valid PkTask instance

repo_id  :

The software source ID

enabled  :

TRUE or FALSE

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_resolve_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

packages  :

package names to find

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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_search_details_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

values  :

search values. [ 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_search_files_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

values  :

search values. [ 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_search_groups_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

values  :

search values. [ 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_search_names_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

values  :

search values. [ 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5


pk_task_set_interactive ()

          void
                          pk_task_set_interactive             (
          
            
              
                PkTask
              
               *task
            
          
          ,                                                         
          
            
              
                gboolean
              
               interactive
            
          
          );
        

Sets the interactive mode, i.e. if the user is allowed to askquestions.

task  :

a valid PkTask instance

interactive  :

if we are interactive

Since 0.6.10


pk_task_set_only_download ()

          void
                          pk_task_set_only_download           (
          
            
              
                PkTask
              
               *task
            
          
          ,                                                         
          
            
              
                gboolean
              
               only_download
            
          
          );
        

If the transaction should be prepared (depsolved, packagesdownloaded, etc) but not committed.

task  :

a valid PkTask instance

only_download  :

FALSE to actually commit the transaction

Since 0.8.1


pk_task_set_simulate ()

          void
                          pk_task_set_simulate                (
          
            
              
                PkTask
              
               *task
            
          
          ,                                                         
          
            
              
                gboolean
              
               simulate
            
          
          );
        

If the simulate step should be run without the actual transaction.

task  :

a valid PkTask instance

simulate  :

the simulate mode

Since 0.6.10


pk_task_test ()

          void
                          pk_task_test                        (
          
            
              
                gpointer
              
               user_data
            
          
          );
        

pk_task_update_packages_async ()

          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.

task  :

a valid PkTask 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback_ready

Since 0.5.2


pk_task_user_accepted ()

          
            gboolean
          
                      pk_task_user_accepted               (
          
            
              
                PkTask
              
               *task
            
          
          ,                                                         
          
            
              
                guint
              
               request
            
          
          );
        

Since 0.5.2


pk_task_user_declined ()

          
            gboolean
          
                      pk_task_user_declined               (
          
            
              
                PkTask
              
               *task
            
          
          ,                                                         
          
            
              
                guint
              
               request
            
          
          );
        

Since 0.5.2


pk_task_what_provides_async ()

          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.

task  :

a valid PkTask instance

filters  :

a bitfield of filters that can be used to limit the results

provides  :

a PkProvidesEnum type

values  :

values to search for. [ 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

callback_ready  :

the function to run on completion

user_data  :

the data to pass to callback

Since 0.6.5

Property Details

The "interactive" property

            "interactive"              
          
            gboolean
          
                        : Read / Write
        

Default value: TRUE

Since 0.6.7


The "only-download" property

            "only-download"            
          
            gboolean
          
                        : Read / Write
        

Default value: FALSE

Since 0.8.1


The "simulate" property

            "simulate"                 
          
            gboolean
          
                        : Read / Write
        

Default value: TRUE

Since 0.5.2