<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
               "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd"
[
  <!ENTITY % local.common.attrib "xmlns:xi  CDATA  #FIXED 'http://www.w3.org/2003/XInclude'">
]>
<refentry id="ListallerSetup">
<refmeta>
<refentrytitle role="top_of_page" id="ListallerSetup.top_of_page">ListallerSetup</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>
  LISTALLER Library
</refmiscinfo>
</refmeta>
<refnamediv>
<refname>ListallerSetup</refname>
<refpurpose>Performs the installation of an IPK package</refpurpose>
</refnamediv>

<refsect1 id="ListallerSetup.functions" role="functions_proto">
<title role="functions_proto.title">Functions</title>
<informaltable pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="functions_return" colwidth="150px"/>
<colspec colname="functions_name"/>
<tbody>
<row><entry role="define_keyword">#define</entry><entry role="function_name"><link linkend="LISTALLER-TYPE-SETUP:CAPS">LISTALLER_TYPE_SETUP</link></entry></row>
<row><entry role="function_type"><link linkend="ListallerIPKInstallMode"><returnvalue>ListallerIPKInstallMode</returnvalue></link>
</entry><entry role="function_name"><link linkend="listaller-setup-supported-install-modes">listaller_setup_supported_install_modes</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="listaller-setup-set-install-mode">listaller_setup_set_install_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="ListallerIPKInstallMode"><returnvalue>ListallerIPKInstallMode</returnvalue></link>
</entry><entry role="function_name"><link linkend="listaller-setup-get-install-mode">listaller_setup_get_install_mode</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="listaller-setup-initialize">listaller_setup_initialize</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="ListallerAppItem"><returnvalue>ListallerAppItem</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-get-current-application">listaller_setup_get_current_application</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="void"><returnvalue>void</returnvalue></link>
</entry><entry role="function_name"><link linkend="listaller-setup-kill-installation-process">listaller_setup_kill_installation_process</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-get-replaced-native-packs">listaller_setup_get_replaced_native_packs</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
</entry><entry role="function_name"><link linkend="listaller-setup-run-installation">listaller_setup_run_installation</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="ListallerIPKSecurityInfo"><returnvalue>ListallerIPKSecurityInfo</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-get-security-info">listaller_setup_get_security_info</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="ListallerSetup"><returnvalue>ListallerSetup</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-new">listaller_setup_new</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-get-fname">listaller_setup_get_fname</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="ListallerSetupSettings"><returnvalue>ListallerSetupSettings</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-get-settings">listaller_setup_get_settings</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>
<row><entry role="function_type"><link linkend="ListallerIPKControl"><returnvalue>ListallerIPKControl</returnvalue></link>&#160;*
</entry><entry role="function_name"><link linkend="listaller-setup-get-control">listaller_setup_get_control</link>&#160;<phrase role="c_punctuation">()</phrase></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="ListallerSetup.properties" role="properties">
<title role="properties.title">Properties</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="properties_type" colwidth="150px"/>
<colspec colname="properties_name" colwidth="300px"/>
<colspec colname="properties_flags" colwidth="200px"/>
<tbody>
<row><entry role="property_type"><link linkend="ListallerIPKControl"><type>ListallerIPKControl</type></link>&#160;*</entry><entry role="property_name"><link linkend="ListallerSetup--control">control</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="gchar"><type>gchar</type></link>&#160;*</entry><entry role="property_name"><link linkend="ListallerSetup--fname">fname</link></entry><entry role="property_flags">Read</entry></row>
<row><entry role="property_type"><link linkend="ListallerSetupSettings"><type>ListallerSetupSettings</type></link>&#160;*</entry><entry role="property_name"><link linkend="ListallerSetup--settings">settings</link></entry><entry role="property_flags">Read</entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="ListallerSetup.signals" role="signal_proto">
<title role="signal_proto.title">Signals</title>
<informaltable frame="none">
<tgroup cols="3">
<colspec colname="signals_return" colwidth="150px"/>
<colspec colname="signals_name" colwidth="300px"/>
<colspec colname="signals_flags" colwidth="200px"/>
<tbody>
<row><entry role="signal_type"><link linkend="void"><returnvalue>void</returnvalue></link></entry><entry role="signal_name"><link linkend="ListallerSetup-status-changed">status-changed</link></entry><entry role="signal_flags"><link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="ListallerSetup.other" role="other_proto">
<title role="other_proto.title">Types and Values</title>
<informaltable role="enum_members_table" pgwide="1" frame="none">
<tgroup cols="2">
<colspec colname="name" colwidth="150px"/>
<colspec colname="description"/>
<tbody>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="ListallerSetup-struct">ListallerSetup</link></entry></row>
<row><entry role="datatype_keyword">struct</entry><entry role="function_name"><link linkend="ListallerSetupClass">ListallerSetupClass</link></entry></row>

</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 id="ListallerSetup.object-hierarchy" role="object_hierarchy">
<title role="object_hierarchy.title">Object Hierarchy</title>
<screen>    <link linkend="GObject">GObject</link>
    <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> <link linkend="ListallerMessageObject">ListallerMessageObject</link>
        <phrase role="lineart">&#9584;&#9472;&#9472;</phrase> ListallerSetup
</screen>
</refsect1>


<refsect1 id="ListallerSetup.description" role="desc">
<title role="desc.title">Description</title>
<para>This class handles all stuff required to install an application. All methods are syncronous right now.</para>

</refsect1>
<refsect1 id="ListallerSetup.functions_details" role="details">
<title role="details.title">Functions</title>
<refsect2 id="LISTALLER-TYPE-SETUP:CAPS" role="macro">
<title>LISTALLER_TYPE_SETUP</title>
<indexterm zone="LISTALLER-TYPE-SETUP:CAPS"><primary sortas="TYPE_SETUP">LISTALLER_TYPE_SETUP</primary></indexterm>
<programlisting language="C">#define LISTALLER_TYPE_SETUP (listaller_setup_get_type ())
</programlisting>
<para>The type for <link linkend="ListallerSetup"><type>ListallerSetup</type></link>.</para>
</refsect2>
<refsect2 id="listaller-setup-supported-install-modes" role="function">
<title>listaller_setup_supported_install_modes&#160;()</title>
<indexterm zone="listaller-setup-supported-install-modes"><primary sortas="setup_supported_install_modes">listaller_setup_supported_install_modes</primary></indexterm>
<programlisting language="C"><link linkend="ListallerIPKInstallMode"><returnvalue>ListallerIPKInstallMode</returnvalue></link>
listaller_setup_supported_install_modes
                               (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-set-install-mode" role="function">
<title>listaller_setup_set_install_mode&#160;()</title>
<indexterm zone="listaller-setup-set-install-mode"><primary sortas="setup_set_install_mode">listaller_setup_set_install_mode</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
listaller_setup_set_install_mode (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>,
                                  <parameter><link linkend="ListallerIPKInstallMode"><type>ListallerIPKInstallMode</type></link> mode</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>mode</para></entry>
<entry role="parameter_description"><para>&nbsp;</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-install-mode" role="function">
<title>listaller_setup_get_install_mode&#160;()</title>
<indexterm zone="listaller-setup-get-install-mode"><primary sortas="setup_get_install_mode">listaller_setup_get_install_mode</primary></indexterm>
<programlisting language="C"><link linkend="ListallerIPKInstallMode"><returnvalue>ListallerIPKInstallMode</returnvalue></link>
listaller_setup_get_install_mode (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-initialize" role="function">
<title>listaller_setup_initialize&#160;()</title>
<indexterm zone="listaller-setup-initialize"><primary sortas="setup_initialize">listaller_setup_initialize</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
listaller_setup_initialize (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-current-application" role="function">
<title>listaller_setup_get_current_application&#160;()</title>
<indexterm zone="listaller-setup-get-current-application"><primary sortas="setup_get_current_application">listaller_setup_get_current_application</primary></indexterm>
<programlisting language="C"><link linkend="ListallerAppItem"><returnvalue>ListallerAppItem</returnvalue></link>&#160;*
listaller_setup_get_current_application
                               (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-kill-installation-process" role="function">
<title>listaller_setup_kill_installation_process&#160;()</title>
<indexterm zone="listaller-setup-kill-installation-process"><primary sortas="setup_kill_installation_process">listaller_setup_kill_installation_process</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
listaller_setup_kill_installation_process
                               (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<para>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.</para>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-replaced-native-packs" role="function">
<title>listaller_setup_get_replaced_native_packs&#160;()</title>
<indexterm zone="listaller-setup-get-replaced-native-packs"><primary sortas="setup_get_replaced_native_packs">listaller_setup_get_replaced_native_packs</primary></indexterm>
<programlisting language="C"><link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
listaller_setup_get_replaced_native_packs
                               (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<para>Check if there are native packages providing the same functionality</para>
<para>Software packages can declare a &quot;replaces&quot; element, showing which native componants become obsolete if their 3rd-party app gets installed. E.g. Firefox could declare a replacement of &quot;/usr/bin/firefox&quot;, so the user gets hinted to maybe remove the native package. This feature is optional, and Listaller won&apos;t perform any removal actions! This function will fail if the user did not request a shared installation.</para>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 role="returns">
<title>Returns</title>
<para> List of replaces package-ids, separated by newlines or NULL if no replacement was declared. </para>
<para></para>
</refsect3></refsect2>
<refsect2 id="listaller-setup-run-installation" role="function">
<title>listaller_setup_run_installation&#160;()</title>
<indexterm zone="listaller-setup-run-installation"><primary sortas="setup_run_installation">listaller_setup_run_installation</primary></indexterm>
<programlisting language="C"><link linkend="gboolean"><returnvalue>gboolean</returnvalue></link>
listaller_setup_run_installation (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<para>Execute software installation</para>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 role="returns">
<title>Returns</title>
<para> Success of the operation (if FALSE, an error was emitted) </para>
<para></para>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-security-info" role="function">
<title>listaller_setup_get_security_info&#160;()</title>
<indexterm zone="listaller-setup-get-security-info"><primary sortas="setup_get_security_info">listaller_setup_get_security_info</primary></indexterm>
<programlisting language="C"><link linkend="ListallerIPKSecurityInfo"><returnvalue>ListallerIPKSecurityInfo</returnvalue></link>&#160;*
listaller_setup_get_security_info (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-new" role="function">
<title>listaller_setup_new&#160;()</title>
<indexterm zone="listaller-setup-new"><primary sortas="setup_new">listaller_setup_new</primary></indexterm>
<programlisting language="C"><link linkend="ListallerSetup"><returnvalue>ListallerSetup</returnvalue></link>&#160;*
listaller_setup_new (<parameter>const <link linkend="gchar"><type>gchar</type></link> *ipkfilename</parameter>);</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>ipkfilename</para></entry>
<entry role="parameter_description"><para>&nbsp;</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-fname" role="function">
<title>listaller_setup_get_fname&#160;()</title>
<indexterm zone="listaller-setup-get-fname"><primary sortas="setup_get_fname">listaller_setup_get_fname</primary></indexterm>
<programlisting language="C">const <link linkend="gchar"><returnvalue>gchar</returnvalue></link>&#160;*
listaller_setup_get_fname (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<para>Get and return the current value of the <link linkend="ListallerSetup--fname"><type>"fname"</type></link> property.</para>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance to query</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 role="returns">
<title>Returns</title>
<para> the value of the <link linkend="ListallerSetup--fname"><type>"fname"</type></link> property</para>
<para></para>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-settings" role="function">
<title>listaller_setup_get_settings&#160;()</title>
<indexterm zone="listaller-setup-get-settings"><primary sortas="setup_get_settings">listaller_setup_get_settings</primary></indexterm>
<programlisting language="C"><link linkend="ListallerSetupSettings"><returnvalue>ListallerSetupSettings</returnvalue></link>&#160;*
listaller_setup_get_settings (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<para>Get and return the current value of the <link linkend="ListallerSetup--settings"><type>"settings"</type></link> property.</para>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance to query</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 role="returns">
<title>Returns</title>
<para> the value of the <link linkend="ListallerSetup--settings"><type>"settings"</type></link> property</para>
<para></para>
</refsect3></refsect2>
<refsect2 id="listaller-setup-get-control" role="function">
<title>listaller_setup_get_control&#160;()</title>
<indexterm zone="listaller-setup-get-control"><primary sortas="setup_get_control">listaller_setup_get_control</primary></indexterm>
<programlisting language="C"><link linkend="ListallerIPKControl"><returnvalue>ListallerIPKControl</returnvalue></link>&#160;*
listaller_setup_get_control (<parameter><link linkend="ListallerSetup"><type>ListallerSetup</type></link> *self</parameter>);</programlisting>
<para>Get and return the current value of the <link linkend="ListallerSetup--control"><type>"control"</type></link> property.</para>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>self</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance to query</para></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><refsect3 role="returns">
<title>Returns</title>
<para> the value of the <link linkend="ListallerSetup--control"><type>"control"</type></link> property</para>
<para></para>
</refsect3></refsect2>

</refsect1>
<refsect1 id="ListallerSetup.other_details" role="details">
<title role="details.title">Types and Values</title>
<refsect2 id="ListallerSetup-struct" role="struct">
<title>struct ListallerSetup</title>
<indexterm zone="ListallerSetup-struct"><primary sortas="Setup">ListallerSetup</primary></indexterm>
<programlisting language="C">struct ListallerSetup;</programlisting>
<para>Performs the installation of an IPK package</para>
<para>This class handles all stuff required to install an application. All methods are syncronous right now.</para>
</refsect2>
<refsect2 id="ListallerSetupClass" role="struct">
<title>struct ListallerSetupClass</title>
<indexterm zone="ListallerSetupClass"><primary sortas="SetupClass">ListallerSetupClass</primary></indexterm>
<programlisting language="C">struct ListallerSetupClass {
	ListallerMessageObjectClass parent_class;
};
</programlisting>
<para>The class structure for <link linkend="LISTALLER-TYPE-SETUP:CAPS"><literal>LISTALLER_TYPE_SETUP</literal></link>. All the fields in this structure are private and should never be accessed directly.</para>
<refsect3 role="struct_members">
<title>Members</title>
<informaltable role="struct_members_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="struct_members_name" colwidth="300px"/>
<colspec colname="struct_members_description"/>
<colspec colname="struct_members_annotations" colwidth="200px"/>
<tbody>
<row><entry role="struct_member_name"><para><link linkend="ListallerMessageObjectClass"><type>ListallerMessageObjectClass</type></link>&#160;<structfield id="ListallerSetupClass.parent-class">parent_class</structfield>;</para></entry>
<listitem><para>the parent class structure</para></listitem>
<entry role="struct_member_description"><para>the parent class structure</para></entry>
<entry role="struct_member_annotations"></entry>
</row>
</tbody></tgroup></informaltable>
</refsect3>
</refsect2>

</refsect1>
<refsect1 id="ListallerSetup.property-details" role="property_details">
<title role="property_details.title">Property Details</title>
<refsect2 id="ListallerSetup--control" role="property"><title>The <literal>“control”</literal> property</title>
<indexterm zone="ListallerSetup--control"><primary sortas="Setup:control">ListallerSetup:control</primary></indexterm>
<programlisting>  “control”                  <link linkend="ListallerIPKControl"><type>ListallerIPKControl</type></link>&#160;*</programlisting>
<para>control.</para><para>Flags: Read</para>
</refsect2>
<refsect2 id="ListallerSetup--fname" role="property"><title>The <literal>“fname”</literal> property</title>
<indexterm zone="ListallerSetup--fname"><primary sortas="Setup:fname">ListallerSetup:fname</primary></indexterm>
<programlisting>  “fname”                    <link linkend="gchar"><type>gchar</type></link>&#160;*</programlisting>
<para>fname.</para><para>Flags: Read</para>
<para>Default value: NULL</para>
</refsect2>
<refsect2 id="ListallerSetup--settings" role="property"><title>The <literal>“settings”</literal> property</title>
<indexterm zone="ListallerSetup--settings"><primary sortas="Setup:settings">ListallerSetup:settings</primary></indexterm>
<programlisting>  “settings”                 <link linkend="ListallerSetupSettings"><type>ListallerSetupSettings</type></link>&#160;*</programlisting>
<para>settings.</para><para>Flags: Read</para>
</refsect2>

</refsect1>
<refsect1 id="ListallerSetup.signal-details" role="signals">
<title role="signals.title">Signal Details</title>
<refsect2 id="ListallerSetup-status-changed" role="signal"><title>The <literal>“status-changed”</literal> signal</title>
<indexterm zone="ListallerSetup-status-changed"><primary sortas="Setup::status-changed">ListallerSetup::status-changed</primary></indexterm>
<programlisting language="C"><link linkend="void"><returnvalue>void</returnvalue></link>
user_function (<link linkend="ListallerSetup"><type>ListallerSetup</type></link>      *setup,
               <link linkend="ListallerStatusItem"><type>ListallerStatusItem</type></link> *status,
               <link linkend="gpointer"><type>gpointer</type></link>             user_data)</programlisting>
<refsect3 role="parameters">
<title>Parameters</title>
<informaltable role="parameters_table" pgwide="1" frame="none">
<tgroup cols="3">
<colspec colname="parameters_name" colwidth="150px"/>
<colspec colname="parameters_description"/>
<colspec colname="parameters_annotations" colwidth="200px"/>
<tbody>
<row><entry role="parameter_name"><para>setup</para></entry>
<entry role="parameter_description"><para>the <link linkend="ListallerSetup"><type>ListallerSetup</type></link> instance that received the signal</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><para>status</para></entry>
<entry role="parameter_description"><para>&nbsp;</para></entry>
<entry role="parameter_annotations"></entry></row>
<row><entry role="parameter_name"><simpara>user_data</simpara></entry>
<entry role="parameter_description"><simpara>user data set when the signal handler was connected.</simpara></entry>
<entry role="parameter_annotations"></entry></row>
</tbody></tgroup></informaltable>
</refsect3><para>Flags: <link linkend="G-SIGNAL-RUN-LAST:CAPS">Run Last</link></para>
</refsect2>
</refsect1>

</refentry>