<!DOCTYPE node PUBLIC

"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"

"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd" [

  <!ENTITY ERROR_GENERAL "org.freedesktop.PackageKit.Denied">

]>

<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">

  <interface name="org.freedesktop.PackageKit.Transaction">

    <doc:doc>

      <doc:description>

        <doc:para>

          The transaction interface is used for interacting with individual transactions.

        </doc:para>

      </doc:description>

    </doc:doc>

    <!--*****************************************************************************************-->

    <property name="Role" type="s" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The transaction role, e.g. <doc:tt>update-system</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="Status" type="s" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The transaction status, e.g. <doc:tt>downloading</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="LastPackage" type="s" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The last package_id that was processed, e.g. <doc:tt>hal;0.1.2;i386;fedora</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="Uid" type="u" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The uid of the user that started the transaction.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="Percentage" type="u" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The percentage complete of the transaction.

          </doc:para>

          <doc:para>

            Backends should set this value to 101 if the amount complete cannot be calculated.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="Subpercentage" type="u" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The sub-percentage complete of the transaction.

          </doc:para>

          <doc:para>

            Backends should set this value to 101 if the amount complete cannot be calculated.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="AllowCancel" type="b" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            If the transaction can be cancelled.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="CallerActive" type="b" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            If the original caller of the method is still connected to the system bus.

            This is usually an indication that the client can handle it's own error handling and

            EULA callbacks rather than another program taking over.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="ElapsedTime" type="u" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The amount of time elapsed during the transaction in seconds.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="RemainingTime" type="u" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The estimated time remaining of the transaction in seconds, or 0 if not known.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <property name="Speed" type="u" access="read">

      <doc:doc>

        <doc:description>

          <doc:para>

            The estimated speed of the transaction (copying, downloading, etc.) in bits per second, or 0 if not known.

          </doc:para>

        </doc:description>

      </doc:doc>

    </property>

    <!--*****************************************************************************************-->

    <method name="SetHints">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method allows the calling session to set transaction hints for

            the package manager which can change as the transaction runs.

          </doc:para>

          <doc:para>

            This method can be sent before the transaction has been run or

            whilst it is running. There is no limit to the number of times this

            method can be sent, although some backends may only use the values

            that were set before the transaction was started.

          </doc:para>

          <doc:para>

            Each parameter value is optional.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="hints" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              The values as an array of strings, for example

              <doc:tt>['locale=en_GB.utf8','idle=true','interactive=false','cache-age=3600']</doc:tt>.

            </doc:para>

            <doc:para>

              The following parameter values are understood:

            </doc:para>

            <doc:list>

              <doc:item>

                <doc:term>locale</doc:term>

                <doc:definition>

                  The locale code, for example <doc:tt>en_GB</doc:tt>.

                </doc:definition>

              </doc:item>

              <doc:item>

                <doc:term>background</doc:term>

                <doc:definition>

                  If the method should be executed as a background task, valid

                  values are <doc:tt>true</doc:tt> and <doc:tt>false</doc:tt>,

                  and other values will result in an error.

                  Background tasks are normally treated with a low priority than

                  regular tasks, and normally only use idle CPU and network.

                </doc:definition>

              </doc:item>

              <doc:item>

                <doc:term>interactive</doc:term>

                <doc:definition>

                  If the method can ask interactive questions whilst running,

                  valid values are <doc:tt>true</doc:tt> and <doc:tt>false</doc:tt>,

                  and other values will result in an error.

                </doc:definition>

              </doc:item>

              <doc:item>

                <doc:term>cache-age</doc:term>

                <doc:definition>

                  This allows the frontend to set how fresh it needs the

                  metadata used in the transaction.

                  This allows fine control of the age of the returned results,

                  but means the frontend probably has to query the updates

                  check value and pass it this value for <doc:tt>GetUpdates</doc:tt>,

                  and choose something sane otherwise.

                  Most interactive clients will set this to <doc:tt>intmax</doc:tt>doc:tt>

                  which means "never download new metadata, unless required to return results".

                  Most transactions will not have this value set.

                </doc:definition>

              </doc:item>

            </doc:list>

            <doc:para>

              Other values will cause a verbose warning in the daemon, but will

              not cause the method to fail. This will preserve forward and

              backwards compatibility for future API versions.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="AcceptEula">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method allows the user to accept a end user licence agreement.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.accept-eula</doc:permission>

      </doc:doc>

      <arg type="s" name="eula_id" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A valid EULA ID

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="Cancel">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method cancels a transaction that is already running

          </doc:para>

        </doc:description>

      </doc:doc>

    </method>

    <!--*****************************************************************************************-->

    <method name="DownloadPackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method downloads packages into a temporary directory.

          </doc:para>

          <doc:para>

            This method should emit one

            <doc:tt>Files</doc:tt> signal for each package that is downloaded,

            with the file list set as the name of the complete downloaded file

            and directory, so for example:

          </doc:para>

          <doc:para>

            <doc:tt>DownloadPackages('hal;0.1.2;i386;fedora','hal-info;2009-09-07;no-arch;updates')</doc:tt>

            should send two signals, e.g.

            <doc:tt>Files('hal;0.1.2;i386;fedora', '/tmp/hal-0.1.2.i386.rpm')</doc:tt>

            and

            <doc:tt>Files('hal-info;2009-09-07;no-arch;updates', '/tmp/hal-info-2009-09-07.noarch.rpm')</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="b" name="store_in_cache" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              If the downloaded files should be stored in the system

              package cache rather than copied into a newly created

              directory.

            </doc:para>

            <doc:para>

              See <doc:ulink url="http://packagekit.org/gtk-doc/introduction-ideas-transactions.html">

              the developer docs</doc:ulink> for more details on how

              this is supposed to work.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetCategories">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method return the collection categories

          </doc:para>

        </doc:description>

          <doc:para>

            This method typically emits

            <doc:tt>Categories</doc:tt> and <doc:tt>Error</doc:tt>.

          </doc:para>

          <doc:para>

            Note: Categories can be returned that represent groups of

            packages in a specific repository.

            These will have a category prefix of <doc:tt>repo:</doc:tt>

            which should be understood by <doc:tt>SearchGroups</doc:tt>

            if this feature is used.

          </doc:para>

      </doc:doc>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetDepends">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns packages that this package depends on.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="b" name="recursive" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              Either <doc:tt>true</doc:tt> or <doc:tt>false</doc:tt>. If yes then the requirements should be

              returned for all packages returned.

              This means if gnome-power-manager depends on NetworkManager

              and NetworkManager depends on HAL, then GetDepends on

              gnome-power-manager should return both HAL and NetworkManager.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetDetails">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method should return all the details about a specific

            <doc:tt>package_id</doc:tt>.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Details</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetFiles">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method should return the file list of the <doc:tt>package_id</doc:tt>.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Files</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetOldTransactions">

      <doc:doc>

        <doc:description>

          <doc:para>

            This method allows a client to view details for old transactions.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="u" name="number" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              The number of past transactions, or 0 for all known transactions.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetPackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns all the packages without a search term.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetRepoList">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns the list of repositories used in the system.

          </doc:para>

          <doc:para>

            This method should emit <doc:tt>RepoDetail</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetRequires">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns packages that depend on this package.

            This is useful to know, as if <doc:tt>package_id</doc:tt> is being

            removed, we can warn the user what else would be removed.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="b" name="recursive" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              Either <doc:tt>true</doc:tt> or <doc:tt>false</doc:tt>. If yes then the requirements should be

              returned for all packages returned.

              This means if gnome-power-manager depends on NetworkManager

              and NetworkManager depends on HAL, then GetRequires on

              HAL should return both gnome-power-manager and NetworkManager.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetUpdateDetail">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns details about a specific update.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>UpdateDetail</doc:tt> and

            <doc:tt>Error</doc:tt>

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetUpdates">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method should return a list of packages that are installed and are upgradable.

            It should only return the newest update for each installed package.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>blocked</doc:tt>,

            <doc:tt>low</doc:tt>,

            <doc:tt>normal</doc:tt>,

            <doc:tt>important</doc:tt> or

            <doc:tt>security</doc:tt>.

          </doc:para>

          <doc:para>

            The status <doc:tt>blocked</doc:tt> signifies the package cannot be

            updated, probably due to other dependencies not being met.

            This type allows the GUI tools to show to the user that an update

            exists, but cannot be installed.

            The reason for it not being installed should be put into the update

            description when doing GetUpdateDetail.

          </doc:para>

          <doc:para>

            A filter such as <doc:tt>basename</doc:tt> or <doc:tt>gui</doc:tt>

            is also useful if you want to do filtering on the method to only show

            the main packages rather than the complete list.

            The complete list is available but specifying <doc:tt>none</doc:tt>

            as the filter.

            Using no filter which may be useful in advanced tools or when using

            libpackagekit and searching for an update of a specific name.

            Other filter types may be present, but can be safely ignored of the

            backend does not support them.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="GetDistroUpgrades">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method should return a list of distribution upgrades that are

            available.

            It should not return updates, only major upgrades.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>DistroUpgrade</doc:tt>,

            <doc:tt>Error</doc:tt> and

          </doc:para>

        </doc:description>

      </doc:doc>

    </method>

    <!--*****************************************************************************************-->

    <method name="InstallFiles">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method installs local package files onto the local system.

          </doc:para>

          <doc:para>

            The installer should always install extra dependant packages automatically.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>downloading</doc:tt>,

            <doc:tt>updating</doc:tt>,

            <doc:tt>installing</doc:tt> or

            <doc:tt>removing</doc:tt>.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.localinstall-untrusted</doc:permission>

      </doc:doc>

      <arg type="b" name="only_trusted" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              If the transaction is only allowed to install trusted files.

              Unsigned files should not be installed if this parameter is <doc:tt>TRUE</doc:tt>.

            </doc:para>

            <doc:para>

              If this method is can only install trusted files, and the files are unsigned, then

              the backend will send a <doc:tt>ErrorCode(missing-gpg-signature)</doc:tt>.

              On recieving this error, the client may choose to retry with only_trusted <doc:tt>FALSE</doc:tt>

              after gaining further authentication.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="full_paths" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of full path and filenames to packages.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="InstallPackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method installs new packages on the local system.

          </doc:para>

          <doc:para>

            The installer should always install extra packages automatically

            as the use could call GetDepends prior to the install if a confirmation

            is required in the UI.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>downloading</doc:tt>,

            <doc:tt>updating</doc:tt>,

            <doc:tt>installing</doc:tt> or

            <doc:tt>removing</doc:tt>.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.install-untrusted</doc:permission>

      </doc:doc>

      <arg type="b" name="only_trusted" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              If the transaction is only allowed to install trusted packages.

              Unsigned packages should not be installed if this parameter is <doc:tt>TRUE</doc:tt>.

            </doc:para>

            <doc:para>

              If this method is can only install trusted packages, and the packages are unsigned, then

              the backend will send a <doc:tt>ErrorCode(missing-gpg-signature)</doc:tt>.

              On recieving this error, the client may choose to retry with only_trusted <doc:tt>FALSE</doc:tt>

              after gaining further authentication.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="InstallSignature">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method allows us to install new security keys.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.install-signature</doc:permission>

      </doc:doc>

      <arg type="s" name="sig_type" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A key type, e.g. <doc:tt>gpg</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="s" name="key_id" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A key ID, e.g. <doc:tt>BB7576AC</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="s" name="package_id" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A PackageID for the package that the user is trying to install

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="RefreshCache">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method should fetch updated meta-data for all enabled repositories.

            This operation should be only scheduled when the computer is idle as

            the network connection will be very active, and will the computer will

            have have non-trivial levels of hard disk and processor activity.

            For these reasons, it should not be done automatically when on battery

            power.

          </doc:para>

          <doc:para>

            When fetching each software source, ensure to emit RepoDetail for the

            current source to give the user interface some extra details. Be sure to

            have the "enabled" field set to true, otherwise you wouldn't be fetching

            that source.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>RepoDetail</doc:tt>.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.refresh-cache</doc:permission>

      </doc:doc>

      <arg type="b" name="force" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              If the caches should be cleaned and reloaded even if there is valid, up to date data.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="RemovePackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method removes packages from the local system.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>downloading</doc:tt>,

            <doc:tt>updating</doc:tt>,

            <doc:tt>installing</doc:tt> or

            <doc:tt>removing</doc:tt>.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.remove</doc:permission>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="b" name="allow_deps" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              Either <doc:tt>true</doc:tt> or <doc:tt>false</doc:tt>.

              If <doc:tt>true</doc:tt> allow other packages to be removed with the package,

              but <doc:tt>false</doc:tt> should cause the script to abort if other packages

              are dependant on the package.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="b" name="autoremove" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              Either <doc:tt>true</doc:tt> or <doc:tt>false</doc:tt>.

              This option is only really interesting on embedded devices with a limited amount of

              flash storage.

              It suggests to the packagekit backend that dependencies installed at the same time as

              the package should also be removed if they are not required by anything else.

              For instance, if you install OpenOffice, it might download libneon as a dependency.

              When <doc:tt>auto_remove</doc:tt> is set to true, and you remove OpenOffice then

              libneon will also get removed automatically.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="RepoEnable">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method enables the repository specified.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.repo-change</doc:permission>

      </doc:doc>

      <arg type="s" name="repo_id" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A repository identifier, e.g. <doc:tt>fedora-development-debuginfo</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="b" name="enabled" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              <doc:tt>true</doc:tt> if enabled, <doc:tt>false</doc:tt> if disabled.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="RepoSetData">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method allows arbitary data to be passed to the repository handler.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.repo-change</doc:permission>

      </doc:doc>

      <arg type="s" name="repo_id" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A repository identifier, e.g. <doc:tt>fedora-development-debuginfo</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="s" name="parameter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              The backend specific value, e.g. <doc:tt>set-download-url</doc:tt>.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="s" name="value" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              The backend specific value, e.g. <doc:tt>http://foo.bar.org/baz</doc:tt>.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="Resolve">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method turns a single package name into a package_id suitable for the

            other methods.

          </doc:para>

          <doc:para>

            If the package is a fully formed package_id, then this should be treated

            as an exact package match. This is useful to find the summary or installed

            status of a package_id returned from other methods.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="packages" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package names, e.g. <doc:tt>scribus-clipart</doc:tt>.

            </doc:para>

            <doc:para>

              The package names are case sensitive, so for instance:

              <doc:tt>Resolve('Packagekit')</doc:tt> would not match <doc:tt>PackageKit</doc:tt>.

            </doc:para>

            <doc:para>

              As a special case, if <doc:tt>Resolve()</doc:tt>doc:tt> is called

              with a name prefixed with <doc:tt>@</doc:tt> then

              this should be treated as a category, for example:

              <doc:tt>@web-development</doc:tt>.

              In this instance, a meta-package should be emitted, for example:

              <doc:tt>web-development;;;meta</doc:tt> with the correct

              installed status and summary for the category.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="Rollback">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method rolls back the package database to a previous transaction.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.rollback</doc:permission>

      </doc:doc>

      <arg type="s" name="transaction_id" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A valid transaction ID.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SearchDetails">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method allows deeper searching than SearchName().

          </doc:para>

          <doc:para>

            Do not refresh the package cache. This should be fast.

            This is very similar to search-name.

            This should search as much data as possible, including, if possible

            repo names, package summaries, descriptions, licenses and URLs.

          </doc:para>

          <doc:para>

            Try to emit <doc:tt>installed</doc:tt> before

            <doc:tt>available</doc:tt> packages first, as it allows the client

            program to perform the GUI filtering and matching whilst the daemon is

            running the transaction.

          </doc:para>

          <doc:para>

            If the backend includes <doc:tt>installed</doc:tt> and

            <doc:tt>available</doc:tt> versions of the same package when searching

            then the <doc:tt>available</doc:tt> version will have to be filtered

            in the backend.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="values" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A single word search term with no wildcard chars. The search can

              contain many words separated by spaces. In this case, the

              search operator is <doc:tt>AND</doc:tt> and the words can be found

              in any details section/field. For example, search of

              <doc:tt>GPL games</doc:tt> should returns every games with a GPL

              license.

            </doc:para>

            <doc:para>

              The search should not be treated as case sensitive.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SearchFiles">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method searches for files on the local system and files in available packages.

          </doc:para>

          <doc:para>

            This should search for files.

            This should allow an application to find out what package owns

            a file on the system.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="values" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A filename or fully qualified path and filename on the system.

              If the search term begins with a <doc:tt>/</doc:tt> it will be assumed the entire path has been given and only packages that contain this exact path and filename will be returned.

              If the search term does not start with <doc:tt>/</doc:tt> then it should be treated as a single filename, which can be in any directory.

            </doc:para>

            <doc:para>

              The search is case sensitive, and should not be escaped or surrounded in quotes.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SearchGroups">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns packages from a given group enumerated type.

          </doc:para>

          <doc:para>

            Do not refresh the package cache. This should be fast.

          </doc:para>

          <doc:para>

            Try to emit <doc:tt>installed</doc:tt> before

            <doc:tt>available</doc:tt> packages first, as it allows the client

            program to perform the GUI filtering and matching whilst the daemon is

            running the transaction.

          </doc:para>

          <doc:para>

            If the backend includes <doc:tt>installed</doc:tt> and

            <doc:tt>available</doc:tt> versions of the same package when searching

            then the <doc:tt>available</doc:tt> version will have to be filtered

            in the backend.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="values" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An enumerated group type, or <doc:tt>unknown</doc:tt>. The search

              cannot contain spaces.

              The following recommendations are made below:

            </doc:para>

            <doc:para>

              If the values strings are prefixed with <doc:tt>category:</doc:tt> then

              the request is treated as a 'category search', for example:

              <doc:tt>category:web-development</doc:tt>.

              Note: the old nomenclature for a 'category search' suggested

              using a <doc:tt>@</doc:tt> prefix for the values options.

              This is still supported, and backends should continue to support

              category searches like <doc:tt>@web-development</doc:tt>.

            </doc:para>

            <doc:para>

              If the values strings are prefixed with <doc:tt>repo:</doc:tt> then

              the request is treated as a 'repository search', for example:

              <doc:tt>repo:fedora-debuginfo</doc:tt>.

              In this instance all packages that were either installed

              from, or can be installed from the <doc:tt>fedora-debuginfo</doc:tt>

              source would be returned.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SearchNames">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method searches the package database by package name.

          </doc:para>

          <doc:para>

            Do not refresh the package cache. This should be fast.

          </doc:para>

          <doc:para>

            Try to emit <doc:tt>installed</doc:tt> before

            <doc:tt>available</doc:tt> packages first, as it allows the client

            program to perform the GUI filtering and matching whilst the daemon is

            running the transaction.

          </doc:para>

          <doc:para>

            If the backend includes <doc:tt>installed</doc:tt> and

            <doc:tt>available</doc:tt> versions of the same package when searching

            then the <doc:tt>available</doc:tt> version will have to be filtered

            in the backend.

          </doc:para>

          <doc:para>

            The search methods should return all results in all repositories.

            This may mean that multiple versions of package are returned.

            If this is not what is wanted by the client program, then the

            <doc:tt>newest</doc:tt> filter should be used.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="values" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A single word search term with no wildcard chars. The search term

              can contain many words separated by spaces. In this case, the

              search operator is <doc:tt>AND</doc:tt>. For example, search of

              <doc:tt>gnome power</doc:tt> should returns

              <doc:tt>gnome-power-manager</doc:tt> but not

              <doc:tt>gnomesword</doc:tt> or <doc:tt>powertop</doc:tt>.

            </doc:para>

            <doc:para>

              The search should not be treated as case sensitive.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SimulateInstallFiles">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method simulates a package file instalation emitting packages required to be

            installed, removed, updated, reinstalled, downgraded, obsoleted or untrusted.

            The latter is used to present the user untrusted packages that are about to be installed.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="full_paths" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of full path and filenames to packages.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SimulateInstallPackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method simulates a package instalation emitting packages required to be

            installed, removed, updated, reinstalled, downgraded, obsoleted or untrusted.

            The latter is used to present the user untrusted packages that are about to be installed.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SimulateRemovePackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method simulates a package removal emitting packages required to be

            installed, removed, updated, reinstalled, downgraded, obsoleted or untrusted.

            The latter is used to present the user untrusted packages that are about to be installed.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="b" name="autoremove" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              Either <doc:tt>true</doc:tt> or <doc:tt>false</doc:tt>.

              This option is only really interesting on embedded devices with a limited amount of

              flash storage.

              It suggests to the packagekit backend that dependencies installed at the same time as

              the package should also be removed if they are not required by anything else.

              For instance, if you install OpenOffice, it might download libneon as a dependency.

              When <doc:tt>auto_remove</doc:tt> is set to true, and you remove OpenOffice then

              libneon will also get removed automatically.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="SimulateUpdatePackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method simulates a package update emitting packages required to be

            installed, removed, updated, reinstalled, downgraded, obsoleted or untrusted.

            The latter is used to present the user untrusted packages that are about to be installed.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="UpdatePackages">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method updates existing packages on the local system.

          </doc:para>

          <doc:para>

            The installer should always update extra packages automatically to fulfil dependencies.

          </doc:para>

          <doc:para>

            This should allow an application to find out what package owns a file on the system.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

        </doc:description>

        <doc:permission>Callers need the org.freedesktop.packagekit.update-package</doc:permission>

      </doc:doc>

      <arg type="b" name="only_trusted" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              If the transaction is only allowed to update to trusted packages.

              Unsigned packages should not be installed if this parameter is <doc:tt>TRUE</doc:tt>.

            </doc:para>

            <doc:para>

              If this method is can only update trusted packages, and the packages are unsigned, then

              the backend will send a <doc:tt>ErrorCode(missing-gpg-signature)</doc:tt>.

              On recieving this error, the client may choose to retry with only_trusted <doc:tt>FALSE</doc:tt>

              after gaining further authentication.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="package_ids" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              An array of package IDs.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="UpdateSystem">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method updates all packages on the system to thier newest versions.

          </doc:para>

          <doc:para>

            The installer should update all the updateable packages on the system,

            including automatically installing any new packages that are needed for

            dependancies.

          </doc:para>

        </doc:description>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Error</doc:tt> and

            <doc:tt>RequireRestart</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>downloading</doc:tt>,

            <doc:tt>updating</doc:tt>,

            <doc:tt>installing</doc:tt> or

            <doc:tt>removing</doc:tt>.

          </doc:para>

        <doc:permission>Callers need the org.freedesktop.packagekit.update-system</doc:permission>

      </doc:doc>

      <arg type="b" name="only_trusted" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              If the transaction is only allowed to update to trusted packages.

              Unsigned packages should not be installed if this parameter is <doc:tt>TRUE</doc:tt>.

            </doc:para>

            <doc:para>

              If this method is can only update trusted packages, and the packages are unsigned, then

              the backend will send a <doc:tt>ErrorCode(missing-gpg-signature)</doc:tt>.

              On recieving this error, the client may choose to retry with only_trusted <doc:tt>FALSE</doc:tt>

              after gaining further authentication.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

    </method>

    <!--*****************************************************************************************-->

    <method name="WhatProvides">

      <annotation name="org.freedesktop.DBus.GLib.Async" value=""/>

      <doc:doc>

        <doc:description>

          <doc:para>

            This method returns packages that provide the supplied attributes.

            This method is useful for finding out what package(s) provide a modalias

            or GStreamer codec string.

          </doc:para>

          <doc:para>

            This method typically emits

            <doc:tt>Progress</doc:tt>,

            <doc:tt>Status</doc:tt> and

            <doc:tt>Error</doc:tt> and

            <doc:tt>Package</doc:tt>.

          </doc:para>

          <doc:para>

            <doc:tt>Package</doc:tt> enumerated types should be

            <doc:tt>available</doc:tt> or <doc:tt>installed</doc:tt>.

          </doc:para>

        </doc:description>

      </doc:doc>

      <arg type="s" name="filter" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A correct filter, e.g. <doc:tt>none</doc:tt> or <doc:tt>installed;~devel</doc:tt>

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="s" name="type" direction="in">

        <doc:doc>

          <doc:summary>

            <doc:para>

              A PkProvideType, e.g. <doc:tt>PK_PROVIDES_ENUM_CODEC</doc:tt>.

            </doc:para>

          </doc:summary>

        </doc:doc>

      </arg>

      <arg type="as" name="values" direction="in">

        <doc:doc>