ListallerSetup

ListallerSetup — Performs the installation of an IPK package

Synopsis

#define             LISTALLER_TYPE_SETUP
ListallerIPKInstallMode listaller_setup_supported_install_modes
                                                        (ListallerSetup *self);
gboolean            listaller_setup_set_install_mode    (ListallerSetup *self,
                                                         ListallerIPKInstallMode mode);
ListallerIPKInstallMode listaller_setup_get_install_mode
                                                        (ListallerSetup *self);
gboolean            listaller_setup_initialize          (ListallerSetup *self);
ListallerAppItem *  listaller_setup_get_current_application
                                                        (ListallerSetup *self);
void                listaller_setup_kill_installation_process
                                                        (ListallerSetup *self);
gchar *             listaller_setup_get_replaced_native_packs
                                                        (ListallerSetup *self);
gboolean            listaller_setup_run_installation    (ListallerSetup *self);
ListallerIPKSecurityInfo * listaller_setup_get_security_info
                                                        (ListallerSetup *self);
ListallerSetup *    listaller_setup_new                 (const gchar *ipkfilename);
const gchar *       listaller_setup_get_fname           (ListallerSetup *self);
ListallerSetupSettings * listaller_setup_get_settings   (ListallerSetup *self);
ListallerIPKControl * listaller_setup_get_control       (ListallerSetup *self);
struct              ListallerSetup;
struct              ListallerSetupClass;

Object Hierarchy

  GObject
   +----ListallerMessageObject
         +----ListallerSetup

Properties

  "control"                  ListallerIPKControl*  : Read
  "fname"                    gchar*                : Read
  "settings"                 ListallerSetupSettings*  : Read

Signals

  "status-changed"                                 : Run Last

Description

This class handles all stuff required to install an application. All methods are syncronous right now.

Details

LISTALLER_TYPE_SETUP

#define LISTALLER_TYPE_SETUP (listaller_setup_get_type ())

The type for ListallerSetup.


listaller_setup_supported_install_modes ()

ListallerIPKInstallMode listaller_setup_supported_install_modes
                                                        (ListallerSetup *self);

self :

the ListallerSetup instance

listaller_setup_set_install_mode ()

gboolean            listaller_setup_set_install_mode    (ListallerSetup *self,
                                                         ListallerIPKInstallMode mode);

self :

the ListallerSetup instance

listaller_setup_get_install_mode ()

ListallerIPKInstallMode listaller_setup_get_install_mode
                                                        (ListallerSetup *self);

self :

the ListallerSetup instance

listaller_setup_initialize ()

gboolean            listaller_setup_initialize          (ListallerSetup *self);

self :

the ListallerSetup instance

listaller_setup_get_current_application ()

ListallerAppItem *  listaller_setup_get_current_application
                                                        (ListallerSetup *self);

self :

the ListallerSetup instance

listaller_setup_kill_installation_process ()

void                listaller_setup_kill_installation_process
                                                        (ListallerSetup *self);

Forcibly kills a running installation process. You should never use this method, it might only be useful in command-line applications, where you can catch an interrupt signal and tell the running setup about it. It might be used on mobile devices if a setup is running and the device is running out of power. (but best way in that case would be to prevent an installation in the first place, if there is not enough energy left) This function does some emergency cleanup and tries to make sure that nothing gets corrupted.

self :

the ListallerSetup instance

listaller_setup_get_replaced_native_packs ()

gchar *             listaller_setup_get_replaced_native_packs
                                                        (ListallerSetup *self);

Check if there are native packages providing the same functionality

Software packages can declare a "replaces" element, showing which native componants become obsolete if their 3rd-party app gets installed. E.g. Firefox could declare a replacement of "/usr/bin/firefox", so the user gets hinted to maybe remove the native package. This feature is optional, and Listaller won't perform any removal actions! This function will fail if the user did not request a shared installation.

self :

the ListallerSetup instance

Returns :

List of replaces package-ids, separated by newlines or NULL if no replacement was declared.

listaller_setup_run_installation ()

gboolean            listaller_setup_run_installation    (ListallerSetup *self);

Execute software installation

self :

the ListallerSetup instance

Returns :

Success of the operation (if FALSE, an error was emitted)

listaller_setup_get_security_info ()

ListallerIPKSecurityInfo * listaller_setup_get_security_info
                                                        (ListallerSetup *self);

self :

the ListallerSetup instance

listaller_setup_new ()

ListallerSetup *    listaller_setup_new                 (const gchar *ipkfilename);

listaller_setup_get_fname ()

const gchar *       listaller_setup_get_fname           (ListallerSetup *self);

Get and return the current value of the "fname" property.

self :

the ListallerSetup instance to query

Returns :

the value of the "fname" property

listaller_setup_get_settings ()

ListallerSetupSettings * listaller_setup_get_settings   (ListallerSetup *self);

Get and return the current value of the "settings" property.

self :

the ListallerSetup instance to query

Returns :

the value of the "settings" property

listaller_setup_get_control ()

ListallerIPKControl * listaller_setup_get_control       (ListallerSetup *self);

Get and return the current value of the "control" property.

self :

the ListallerSetup instance to query

Returns :

the value of the "control" property

struct ListallerSetup

struct ListallerSetup;

Performs the installation of an IPK package

This class handles all stuff required to install an application. All methods are syncronous right now.


struct ListallerSetupClass

struct ListallerSetupClass {
	ListallerMessageObjectClass parent_class;
};

The class structure for LISTALLER_TYPE_SETUP. All the fields in this structure are private and should never be accessed directly.

ListallerMessageObjectClass parent_class;

the parent class structure

Property Details

The "control" property

  "control"                  ListallerIPKControl*  : Read

control.


The "fname" property

  "fname"                    gchar*                : Read

fname.

Default value: NULL


The "settings" property

  "settings"                 ListallerSetupSettings*  : Read

settings.

Signal Details

The "status-changed" signal

void                user_function                      (ListallerSetup      *setup,
                                                        ListallerStatusItem *status,
                                                        gpointer             user_data)      : Run Last

setup :

the ListallerSetup instance that received the signal

user_data :

user data set when the signal handler was connected.