ListallerSetup

ListallerSetup — Performs the installation of an IPK package

Functions

Properties

Signals

void status-changed Run Last

Types and Values

Object Hierarchy

    GObject
    ╰── ListallerMessageObject
        ╰── ListallerSetup

Description

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

Functions

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);

Parameters

self

the ListallerSetup instance

 

listaller_setup_set_install_mode ()

gboolean
listaller_setup_set_install_mode (ListallerSetup *self,
                                  ListallerIPKInstallMode mode);

Parameters

self

the ListallerSetup instance

 

mode

 

 

listaller_setup_get_install_mode ()

ListallerIPKInstallMode
listaller_setup_get_install_mode (ListallerSetup *self);

Parameters

self

the ListallerSetup instance

 

listaller_setup_initialize ()

gboolean
listaller_setup_initialize (ListallerSetup *self);

Parameters

self

the ListallerSetup instance

 

listaller_setup_get_current_application ()

ListallerAppItem *
listaller_setup_get_current_application
                               (ListallerSetup *self);

Parameters

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.

Parameters

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.

Parameters

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

Parameters

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);

Parameters

self

the ListallerSetup instance

 

listaller_setup_new ()

ListallerSetup *
listaller_setup_new (const gchar *ipkfilename);

Parameters

ipkfilename

 

 

listaller_setup_get_fname ()

const gchar *
listaller_setup_get_fname (ListallerSetup *self);

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

Parameters

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.

Parameters

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.

Parameters

self

the ListallerSetup instance to query

 

Returns

the value of the "control" property

Types and Values

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.

Members

ListallerMessageObjectClass parent_class;

the parent class structure

 

Property Details

The “control” property

  “control”                  ListallerIPKControl *

control.

Flags: Read


The “fname” property

  “fname”                    gchar *

fname.

Flags: Read

Default value: NULL


The “settings” property

  “settings”                 ListallerSetupSettings *

settings.

Flags: Read

Signal Details

The “status-changed” signal

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

Parameters

setup

the ListallerSetup instance that received the signal

 

status

 

 

user_data

user data set when the signal handler was connected.

 

Flags: Run Last