libgcab-dev 1.1-2 / usr / share / gir-1.0 / GCab-1.0.gir

<?xml version="1.0"?>
<!-- This file was automatically generated from C sources - DO NOT EDIT!
To affect the contents of this file, edit the original C definitions,
and/or use gtk-doc annotations.  -->
<repository version="1.2"
            xmlns="http://www.gtk.org/introspection/core/1.0"
            xmlns:c="http://www.gtk.org/introspection/c/1.0"
            xmlns:glib="http://www.gtk.org/introspection/glib/1.0">
  <include name="GLib" version="2.0"/>
  <include name="GObject" version="2.0"/>
  <include name="Gio" version="2.0"/>
  <package name="libgcab-1.0"/>
  <c:include name="libgcab.h"/>
  <namespace name="GCab"
             version="1.0"
             shared-library="libgcab-1.0.so.0"
             c:identifier-prefixes="GCab"
             c:symbol-prefixes="gcab">
    <class name="Cabinet"
           c:symbol-prefix="cabinet"
           c:type="GCabCabinet"
           parent="GObject.Object"
           glib:type-name="GCabCabinet"
           glib:get-type="gcab_cabinet_get_type"
           glib:type-struct="CabinetClass">
      <doc xml:space="preserve">An opaque object holding a Cabinet file reference.</doc>
      <constructor name="new" c:identifier="gcab_cabinet_new">
        <doc xml:space="preserve">Create a new #GCabCabinet object to read or create a Cabinet
archive.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GCabCabinet</doc>
          <type name="Cabinet" c:type="GCabCabinet*"/>
        </return-value>
      </constructor>
      <method name="add_folder"
              c:identifier="gcab_cabinet_add_folder"
              throws="1">
        <doc xml:space="preserve">Add @folder to @cabinet.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="folder" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFolder</doc>
            <type name="Folder" c:type="GCabFolder*"/>
          </parameter>
        </parameters>
      </method>
      <method name="extract" c:identifier="gcab_cabinet_extract" throws="1">
        <doc xml:space="preserve">Extract files to given path.

If @path is NULL then the files are decompressed to memory blobs stored on
each #GCabFile.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="path"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">the path to extract files</doc>
            <type name="Gio.File" c:type="GFile*"/>
          </parameter>
          <parameter name="file_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">an optional #GCabFile callback,
    return %FALSE to filter out or skip files.</doc>
            <type name="FileCallback" c:type="GCabFileCallback"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">a progress callback</doc>
            <type name="Gio.FileProgressCallback"
                  c:type="GFileProgressCallback"/>
          </parameter>
          <parameter name="user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">callback data</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="extract_simple"
              c:identifier="gcab_cabinet_extract_simple"
              throws="1">
        <doc xml:space="preserve">Extract files to given path.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="path" transfer-ownership="none">
            <doc xml:space="preserve">the path to extract files</doc>
            <type name="Gio.File" c:type="GFile*"/>
          </parameter>
          <parameter name="file_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="2">
            <doc xml:space="preserve">an optional #GCabFile callback,
    return %FALSE to filter out or skip files.</doc>
            <type name="FileCallback" c:type="GCabFileCallback"/>
          </parameter>
          <parameter name="user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">callback data</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_folders" c:identifier="gcab_cabinet_get_folders">
        <doc xml:space="preserve">Get the Cabinet folders within the @cabinet.
Note that Cabinet folders are not like filesystem path, they are
group of files sharing some layout parameters.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">an array of #GCabFolder</doc>
          <array name="GLib.PtrArray" c:type="GPtrArray*">
            <type name="Folder"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_signature"
              c:identifier="gcab_cabinet_get_signature"
              version="0.5"
              throws="1">
        <doc xml:space="preserve">Lookup the cabinet authenticode signature if any.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the array containing the PKCS#7 signed data or %NULL on error.</doc>
          <array name="GLib.ByteArray" c:type="const GByteArray*">
            <type name="guint8" c:type="guint8"/>
          </array>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_size"
              c:identifier="gcab_cabinet_get_size"
              version="1.0">
        <doc xml:space="preserve">Get the size of the compressed cabinet file.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">size in bytes</doc>
          <type name="guint32" c:type="guint32"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="load" c:identifier="gcab_cabinet_load" throws="1">
        <doc xml:space="preserve">Load a cabinet archive.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="stream" transfer-ownership="none">
            <doc xml:space="preserve">a #GInputStream</doc>
            <type name="Gio.InputStream" c:type="GInputStream*"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="write" c:identifier="gcab_cabinet_write" throws="1">
        <doc xml:space="preserve">Save @cabinet to the output stream @out. @out must be a #GSeekable.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="stream" transfer-ownership="none">
            <doc xml:space="preserve">a #GOutputStream also #GSeekable</doc>
            <type name="Gio.OutputStream" c:type="GOutputStream*"/>
          </parameter>
          <parameter name="file_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">report current file being saved</doc>
            <type name="FileCallback" c:type="GCabFileCallback"/>
          </parameter>
          <parameter name="progress_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="3">
            <doc xml:space="preserve">report saving progress</doc>
            <type name="Gio.FileProgressCallback"
                  c:type="GFileProgressCallback"/>
          </parameter>
          <parameter name="user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">user data to pass to callbacks</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="write_simple"
              c:identifier="gcab_cabinet_write_simple"
              throws="1">
        <doc xml:space="preserve">Save @cabinet to the output stream @out. @out must be a #GSeekable.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on success.</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabinet" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabCabinet</doc>
            <type name="Cabinet" c:type="GCabCabinet*"/>
          </instance-parameter>
          <parameter name="stream" transfer-ownership="none">
            <doc xml:space="preserve">a #GOutputStream also #GSeekable</doc>
            <type name="Gio.OutputStream" c:type="GOutputStream*"/>
          </parameter>
          <parameter name="file_callback"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1"
                     scope="call"
                     closure="2">
            <doc xml:space="preserve">report current file being saved</doc>
            <type name="FileCallback" c:type="GCabFileCallback"/>
          </parameter>
          <parameter name="user_data"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">user data to pass to callbacks</doc>
            <type name="gpointer" c:type="gpointer"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <property name="reserved" writable="1" transfer-ownership="none">
        <array name="GLib.ByteArray">
          <type name="gpointer" c:type="gpointer"/>
        </array>
      </property>
      <property name="signature" writable="1" transfer-ownership="none">
        <array name="GLib.ByteArray">
          <type name="gpointer" c:type="gpointer"/>
        </array>
      </property>
    </class>
    <record name="CabinetClass"
            c:type="GCabCabinetClass"
            glib:is-gtype-struct-for="Cabinet">
      <field name="parent_class">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
    </record>
    <enumeration name="Compression"
                 glib:type-name="GCabCompression"
                 glib:get-type="gcab_compression_get_type"
                 c:type="GCabCompression">
      <doc xml:space="preserve">Compression used by the #GCabFolder.</doc>
      <member name="none"
              value="0"
              c:identifier="GCAB_COMPRESSION_NONE"
              glib:nick="none">
        <doc xml:space="preserve">No compression.</doc>
      </member>
      <member name="mszip"
              value="1"
              c:identifier="GCAB_COMPRESSION_MSZIP"
              glib:nick="mszip">
        <doc xml:space="preserve">MSZIP compression.</doc>
      </member>
      <member name="quantum"
              value="2"
              c:identifier="GCAB_COMPRESSION_QUANTUM"
              glib:nick="quantum">
        <doc xml:space="preserve">QUANTUM compression (unsupported).</doc>
      </member>
      <member name="lzx"
              value="3"
              c:identifier="GCAB_COMPRESSION_LZX"
              glib:nick="lzx">
        <doc xml:space="preserve">LZX compression (only decompression supported).</doc>
      </member>
      <member name="mask"
              value="15"
              c:identifier="GCAB_COMPRESSION_MASK"
              glib:nick="mask">
        <doc xml:space="preserve">compression value mask.</doc>
      </member>
    </enumeration>
    <enumeration name="Error"
                 c:type="GCabError"
                 glib:error-domain="gcab-error-quark">
      <doc xml:space="preserve">The various errors triggered by the GCab functions.</doc>
      <member name="format" value="0" c:identifier="GCAB_ERROR_FORMAT">
        <doc xml:space="preserve">The given file is not of Cabinet format.</doc>
      </member>
      <member name="failed" value="1" c:identifier="GCAB_ERROR_FAILED">
        <doc xml:space="preserve">General function failure.</doc>
      </member>
      <member name="not_supported"
              value="2"
              c:identifier="GCAB_ERROR_NOT_SUPPORTED">
        <doc xml:space="preserve">Action or format is not supported</doc>
      </member>
      <member name="invalid_data"
              value="3"
              c:identifier="GCAB_ERROR_INVALID_DATA">
        <doc xml:space="preserve">Data stream was invalid</doc>
      </member>
    </enumeration>
    <class name="File"
           c:symbol-prefix="file"
           c:type="GCabFile"
           parent="GObject.Object"
           glib:type-name="GCabFile"
           glib:get-type="gcab_file_get_type"
           glib:type-struct="FileClass">
      <doc xml:space="preserve">An opaque object, referencing a file in a Cabinet.</doc>
      <constructor name="new_with_bytes"
                   c:identifier="gcab_file_new_with_bytes"
                   version="1.0">
        <doc xml:space="preserve">Create a #GCabFile from a given #GBytes.

If this file is to be added to an archive you should also probably use
gcab_file_set_date() and gcab_file_set_attributes() to set sensible values.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GCabFile</doc>
          <type name="File" c:type="GCabFile*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">name of the file within the cabinet</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="bytes" transfer-ownership="none">
            <doc xml:space="preserve">a #GBytes to be added to the cabinet</doc>
            <type name="GLib.Bytes" c:type="GBytes*"/>
          </parameter>
        </parameters>
      </constructor>
      <constructor name="new_with_file" c:identifier="gcab_file_new_with_file">
        <doc xml:space="preserve">Create a #GCabFile from a given #GFile, to be added to a
#GCabCabinet for archive creation.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GCabFile</doc>
          <type name="File" c:type="GCabFile*"/>
        </return-value>
        <parameters>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">name of the file within the cabinet</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
          <parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GFile to be added to the cabinet</doc>
            <type name="Gio.File" c:type="GFile*"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="get_attributes"
              c:identifier="gcab_file_get_attributes"
              version="0.6">
        <doc xml:space="preserve">Get the file attributes.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the cabinet file attributes</doc>
          <type name="guint32" c:type="guint32"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_bytes"
              c:identifier="gcab_file_get_bytes"
              version="1.0">
        <doc xml:space="preserve">Get the #GFile associated with @file. This will only be non-%NULL if the
#GCabFile has been created using gcab_file_new_with_bytes().</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the associated #GBytes or %NULL</doc>
          <type name="GLib.Bytes" c:type="GBytes*"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_date" c:identifier="gcab_file_get_date" version="0.6">
        <doc xml:space="preserve">Get the file date, in @result.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE if @tv was set</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
          <parameter name="result" transfer-ownership="none">
            <doc xml:space="preserve">a #GTimeVal to return date</doc>
            <type name="GLib.TimeVal" c:type="GTimeVal*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_extract_name"
              c:identifier="gcab_file_get_extract_name">
        <doc xml:space="preserve">Get the file name to use for extraction, or %NULL.</doc>
        <return-value transfer-ownership="none" nullable="1">
          <doc xml:space="preserve">a file name</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_file" c:identifier="gcab_file_get_file">
        <doc xml:space="preserve">If the cabinet is being created, get the #GFile associated with
@file. This must be an exisiting file that can be read, in order to
be added to the archive during cabinet creation.

If @file is from an existing cabinet, the fuction will return
%NULL.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the associated #GFile or %NULL</doc>
          <type name="Gio.File" c:type="GFile*"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_name" c:identifier="gcab_file_get_name">
        <doc xml:space="preserve">Get the file name within the cabinet.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the cabinet file name</doc>
          <type name="utf8" c:type="const gchar*"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_size" c:identifier="gcab_file_get_size" version="0.6">
        <doc xml:space="preserve">Get the file size.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">the cabinet file size</doc>
          <type name="guint32" c:type="guint32"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="set_attributes"
              c:identifier="gcab_file_set_attributes"
              version="1.0">
        <doc xml:space="preserve">Set the file attributes.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
          <parameter name="attr" transfer-ownership="none">
            <doc xml:space="preserve">the attributes, e.g. %GCAB_FILE_ATTRIBUTE_RDONLY</doc>
            <type name="guint32" c:type="guint32"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_date" c:identifier="gcab_file_set_date" version="1.0">
        <doc xml:space="preserve">Sets the file modification date, instead of the value provided by the GFile.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
          <parameter name="tv" transfer-ownership="none">
            <doc xml:space="preserve">a #GTimeVal</doc>
            <type name="GLib.TimeVal" c:type="const GTimeVal*"/>
          </parameter>
        </parameters>
      </method>
      <method name="set_extract_name"
              c:identifier="gcab_file_set_extract_name">
        <doc xml:space="preserve">Sets the file name to use for extraction, instead of the name
provided by the Cabinet.</doc>
        <return-value transfer-ownership="none">
          <type name="none" c:type="void"/>
        </return-value>
        <parameters>
          <instance-parameter name="file" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFile</doc>
            <type name="File" c:type="GCabFile*"/>
          </instance-parameter>
          <parameter name="name"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">a file name or %NULL</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <property name="bytes" writable="1" transfer-ownership="none">
        <type name="GLib.Bytes"/>
      </property>
      <property name="file" writable="1" transfer-ownership="none">
        <type name="Gio.File"/>
      </property>
      <property name="name" writable="1" transfer-ownership="none">
        <type name="utf8" c:type="gchar*"/>
      </property>
    </class>
    <enumeration name="FileAttribute"
                 glib:type-name="GCabFileAttribute"
                 glib:get-type="gcab_file_attribute_get_type"
                 c:type="GCabFileAttribute">
      <doc xml:space="preserve">Attributes associated with the #GCabFile.</doc>
      <member name="rdonly"
              value="1"
              c:identifier="GCAB_FILE_ATTRIBUTE_RDONLY"
              glib:nick="rdonly">
        <doc xml:space="preserve">file is read-only</doc>
      </member>
      <member name="hidden"
              value="2"
              c:identifier="GCAB_FILE_ATTRIBUTE_HIDDEN"
              glib:nick="hidden">
        <doc xml:space="preserve">file is hidden</doc>
      </member>
      <member name="system"
              value="4"
              c:identifier="GCAB_FILE_ATTRIBUTE_SYSTEM"
              glib:nick="system">
        <doc xml:space="preserve">file is a system file</doc>
      </member>
      <member name="arch"
              value="32"
              c:identifier="GCAB_FILE_ATTRIBUTE_ARCH"
              glib:nick="arch">
        <doc xml:space="preserve">file modified since last backup</doc>
      </member>
      <member name="exec"
              value="64"
              c:identifier="GCAB_FILE_ATTRIBUTE_EXEC"
              glib:nick="exec">
        <doc xml:space="preserve">run after extraction</doc>
      </member>
      <member name="name_is_utf"
              value="128"
              c:identifier="GCAB_FILE_ATTRIBUTE_NAME_IS_UTF"
              glib:nick="name-is-utf">
        <doc xml:space="preserve">name contains UTF</doc>
      </member>
    </enumeration>
    <callback name="FileCallback" c:type="GCabFileCallback">
      <doc xml:space="preserve">The type used for callback called when processing Cabinet archive
files.</doc>
      <return-value transfer-ownership="none">
        <type name="gboolean" c:type="gboolean"/>
      </return-value>
      <parameters>
        <parameter name="file" transfer-ownership="none">
          <doc xml:space="preserve">the file being processed</doc>
          <type name="File" c:type="GCabFile*"/>
        </parameter>
        <parameter name="user_data"
                   transfer-ownership="none"
                   nullable="1"
                   allow-none="1"
                   closure="1">
          <doc xml:space="preserve">user data passed to the callback.</doc>
          <type name="gpointer" c:type="gpointer"/>
        </parameter>
      </parameters>
    </callback>
    <record name="FileClass"
            c:type="GCabFileClass"
            glib:is-gtype-struct-for="File">
      <field name="parent_class">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
    </record>
    <class name="Folder"
           c:symbol-prefix="folder"
           c:type="GCabFolder"
           parent="GObject.Object"
           glib:type-name="GCabFolder"
           glib:get-type="gcab_folder_get_type"
           glib:type-struct="FolderClass">
      <doc xml:space="preserve">An opaque object, referencing a folder in a Cabinet.</doc>
      <constructor name="new" c:identifier="gcab_folder_new">
        <doc xml:space="preserve">Creates a new empty Cabinet folder. Use gcab_folder_add_file() to
add files to an archive.

A Cabinet folder is not a file path, it is a container for files.</doc>
        <return-value transfer-ownership="full">
          <doc xml:space="preserve">a new #GCabFolder</doc>
          <type name="Folder" c:type="GCabFolder*"/>
        </return-value>
        <parameters>
          <parameter name="comptype" transfer-ownership="none">
            <doc xml:space="preserve">compression to used in this folder</doc>
            <type name="gint" c:type="gint"/>
          </parameter>
        </parameters>
      </constructor>
      <method name="add_file" c:identifier="gcab_folder_add_file" throws="1">
        <doc xml:space="preserve">Add @file to the #GCabFolder.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">%TRUE on succes</doc>
          <type name="gboolean" c:type="gboolean"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabfolder" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFolder</doc>
            <type name="Folder" c:type="GCabFolder*"/>
          </instance-parameter>
          <parameter name="cabfile" transfer-ownership="none">
            <doc xml:space="preserve">file to be added</doc>
            <type name="File" c:type="GCabFile*"/>
          </parameter>
          <parameter name="recurse" transfer-ownership="none">
            <doc xml:space="preserve">whether to recurse through subdirectories</doc>
            <type name="gboolean" c:type="gboolean"/>
          </parameter>
          <parameter name="cancellable"
                     transfer-ownership="none"
                     nullable="1"
                     allow-none="1">
            <doc xml:space="preserve">optional #GCancellable object,
    %NULL to ignore</doc>
            <type name="Gio.Cancellable" c:type="GCancellable*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_comptype"
              c:identifier="gcab_folder_get_comptype"
              version="1.0">
        <doc xml:space="preserve">Returns the compression used in this folder.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #GCabCompression, e.g. %GCAB_COMPRESSION_MSZIP</doc>
          <type name="gint" c:type="gint"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabfolder" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFolder</doc>
            <type name="Folder" c:type="GCabFolder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_file_by_name"
              c:identifier="gcab_folder_get_file_by_name">
        <doc xml:space="preserve">Gets a specific #GCabFile files contained in the @cabfolder.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">A #GCabFile, or %NULL if not found</doc>
          <type name="File" c:type="GCabFile*"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabfolder" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFolder</doc>
            <type name="Folder" c:type="GCabFolder*"/>
          </instance-parameter>
          <parameter name="name" transfer-ownership="none">
            <doc xml:space="preserve">a file name</doc>
            <type name="utf8" c:type="const gchar*"/>
          </parameter>
        </parameters>
      </method>
      <method name="get_files" c:identifier="gcab_folder_get_files">
        <doc xml:space="preserve">Get the list of #GCabFile files contained in the @cabfolder.</doc>
        <return-value transfer-ownership="container">
          <doc xml:space="preserve">list of files</doc>
          <type name="GLib.SList" c:type="GSList*">
            <type name="File"/>
          </type>
        </return-value>
        <parameters>
          <instance-parameter name="cabfolder" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFolder</doc>
            <type name="Folder" c:type="GCabFolder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <method name="get_nfiles" c:identifier="gcab_folder_get_nfiles">
        <doc xml:space="preserve">Get the number of files in this @folder.</doc>
        <return-value transfer-ownership="none">
          <doc xml:space="preserve">a #guint</doc>
          <type name="guint" c:type="guint"/>
        </return-value>
        <parameters>
          <instance-parameter name="cabfolder" transfer-ownership="none">
            <doc xml:space="preserve">a #GCabFolder</doc>
            <type name="Folder" c:type="GCabFolder*"/>
          </instance-parameter>
        </parameters>
      </method>
      <property name="compression" transfer-ownership="none">
        <type name="Compression"/>
      </property>
      <property name="comptype"
                writable="1"
                construct-only="1"
                transfer-ownership="none">
        <type name="gint" c:type="gint"/>
      </property>
      <property name="reserved" writable="1" transfer-ownership="none">
        <array name="GLib.ByteArray">
          <type name="gpointer" c:type="gpointer"/>
        </array>
      </property>
    </class>
    <record name="FolderClass"
            c:type="GCabFolderClass"
            glib:is-gtype-struct-for="Folder">
      <field name="parent_class">
        <type name="GObject.ObjectClass" c:type="GObjectClass"/>
      </field>
    </record>
    <function name="error_quark" c:identifier="gcab_error_quark">
      <return-value transfer-ownership="none">
        <type name="GLib.Quark" c:type="GQuark"/>
      </return-value>
    </function>
  </namespace>
</repository>