<!DOCTYPE node PUBLIC
"-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
"http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
<node name="/" xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">

<!--
 Copyright (C) 2011 David Zeuthen <zeuthen@gmail.com>

 This library is free software; you can redistribute it and/or
 modify it under the terms of the GNU Lesser General Public
 License as published by the Free Software Foundation; either
 version 2 of the License, or (at your option) any later version.

 This library is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 Lesser General Public License for more details.

 You should have received a copy of the GNU Lesser General
 Public License along with this library; if not, write to the
 Free Software Foundation, Inc., 59 Temple Place, Suite 330,
 Boston, MA 02111-1307, USA.
-->

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

  <!--
      org.freedesktop.UDisks2.Manager:
      @short_description: Manager singleton

      Interface for top-level manager singleton object located at the
      object path <literal>/org/freedesktop/UDisks2/Manager</literal>.
  -->
  <interface name="org.freedesktop.UDisks2.Manager">
    <!-- Version: The version of the daemon currently running  -->
    <property name="Version" type="s" access="read"/>

    <!--
        SupportedFilesystems:

        List of filesystems supported by UDisks2. For each such filesystem
        UDisks supports filesystem creation (<quote>mkfs</quote>) and
        changing labels.

        While UDisks2 can essentially mount any filesystem, only the listed
        types are fully supported for block operations.
    -->
    <property name="SupportedFilesystems" type="as" access="read"/>

    <!--
        SupportedEncryptionTypes:
        @since: 2.8.3

        List of supported block encryption types by UDisks2.
    -->
    <property name="SupportedEncryptionTypes" type="as" access="read"/>

    <!--
        DefaultEncryptionType:
        @since: 2.8.3

        The default block encryption type.
    -->
    <property name="DefaultEncryptionType" type="s" access="read"/>

    <!--
        CanFormat:
        @type: The filesystem type to be tested for formatting availability.
        @available: Formatting availability and the required binary name if missing (i.e. no error and returns FALSE).
        @since: 2.7.2

        Tests for availability to create the given filesystem.
        See the #org.freedesktop.UDisks2.Manager:SupportedFilesystems property
        for a list of known types. Unknown or unsupported filesystems result in an error.
    -->
    <method name="CanFormat">
      <arg name="type" direction="in" type="s"/>
      <arg name="available" direction="out" type="(bs)"/>
    </method>

    <!--
        CanResize:
        @type: The filesystem type to be tested for resize availability.
        @available: Resizing availability, flags for allowed resizing (i.e. growing/shrinking support for online/offline) and the required binary name if missing (i.e. no error and returns FALSE).
        @since: 2.7.2

        Tests for availability to resize the given filesystem.
        The mode flags indicate if growing and/or shriking resize is available if mounted/unmounted.
        The mode corresponds to bitwise-OR combined BDFSResizeFlags of the libblockdev FS plugin:
        BD_FS_OFFLINE_SHRINK = 2, shrinking resize allowed when unmounted
        BD_FS_OFFLINE_GROW = 4, growing resize allowed when unmounted
        BD_FS_ONLINE_SHRINK = 8, shrinking resize allowed when mounted
        BD_FS_ONLINE_GROW = 16, growing resize allowed when mounted
        Unknown filesystems or filesystems which do not support resizing result in errors.
    -->
    <method name="CanResize">
      <arg name="type" direction="in" type="s"/>
      <arg name="available" direction="out" type="(bts)"/>
    </method>

    <!--
        CanCheck:
        @type: The filesystem type to be tested for consistency check availability.
        @available: Checking availability and the required binary name if missing (i.e. no error and returns FALSE).
        @since: 2.7.2

        Tests for availability to check the given filesystem.
        Unsupported filesystems or filesystems which do not support checking result in errors.
    -->
    <method name="CanCheck">
      <arg name="type" direction="in" type="s"/>
      <arg name="available" direction="out" type="(bs)"/>
    </method>

    <!--
        CanRepair:
        @type: The filesystem type to be tested for repair availability.
        @available: Repair availability and the required binary name if missing (i.e. no error and returns FALSE).
        @since: 2.7.2

        Tests for availability repair the given filesystem.
        Unsupported filesystems or filesystems which do not support repairing result in errors.
    -->
    <method name="CanRepair">
      <arg name="type" direction="in" type="s"/>
      <arg name="available" direction="out" type="(bs)"/>
    </method>

    <!--
        LoopSetup:
        @fd: An index for the file descriptor to use.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>offset</parameter> (of type 't'), <parameter>size</parameter> (of type 't'), <parameter>read-only</parameter> (of type 'b'), <parameter>no-part-scan</parameter> (of type 'b') and <parameter>sector-size</parameter> (of type 't').
        @resulting_device: An object path to the object implementing the #org.freedesktop.UDisks2.Block interface.

        Creates a block device for the file represented by @fd.
    -->
    <method name="LoopSetup">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="1"/>
      <arg name="fd" direction="in" type="h"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="resulting_device" direction="out" type="o"/>
    </method>

    <!--
        MDRaidCreate:
        @blocks: An array of object paths to objects implementing the #org.freedesktop.UDisks2.Block interface.
        @level: The RAID level for the array.
        @name: The name for the array.
        @chunk: The chunk size (in bytes) or 0 if @level is <quote>raid1</quote>.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) include <parameter>bitmap</parameter> (of type 'ay') and <parameter>version</parameter> (of type 'ay').
        @resulting_array: An object path to the object implementing the #org.freedesktop.UDisks2.MDRaid interface.
        @since: 2.0.0

        Creates a new RAID array on the block devices specified by
        @blocks. Each element in this array must be an object path to
        an object implementing the #org.freedesktop.UDisks2.Block
        interface.

        Known and supported values for @level include
        <quote>raid0</quote>, <quote>raid1</quote>,
        <quote>raid4</quote>, <quote>raid5</quote>,
        <quote>raid6</quote> and <quote>raid10</quote>.

        Before the array is created, all devices in @blocks are
        erased. Once created (but before the method returns), the RAID
        array will be erased.

        The @bitmap option specifies the write-intent bitmap type, currently
        only 'none' and 'internal' values are supported. When this option
        is not present, it is up to <literal>mdadm</literal> to decide
        whether to create an internal bitmap (typically for arrays larger
        than 100 GB) or not.

        The @version option specifies the MD metadata version, for example
        '0.90'. If not specified the default medata version specified by
        <literal>mdadm</literal> is used. (since 2.11)
    -->
    <method name="MDRaidCreate">
      <arg name="blocks" direction="in" type="ao"/>
      <arg name="level" direction="in" type="s"/>
      <arg name="name" direction="in" type="s"/>
      <arg name="chunk" direction="in" type="t"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="resulting_array" direction="out" type="o"/>
    </method>

    <!--
        EnableModules:
        @enable: A boolean value indicating whether modules should be enabled. Currently only the %TRUE value is permitted.

        Loads and activates modules. Modules that have been already loaded are not reinitialized on subsequent calls to this method and are skipped.
        In case any new module is getting activated by this method call a <literal>add</literal> uevent is triggered on all exported objects.

        This takes in account an optional explicit list of modules to load as specified in the <filename>/etc/udisks2/udisks2.conf</filename>
        config file. If unspecified all available modules will be loaded.

        Modules cannot be deactivated at the moment. This method call never fails even if no module has been activated
        and by nature it cannot report any particular module initialization failures. Clients have no way of finding that
        a particular module is available.

        <note>
        <emphasis>This method is deprecated since 2.9.0.</emphasis>
        Use org.freedesktop.UDisks2.Manager.EnableModule() instead.
        </note>
    -->
    <method name="EnableModules">
      <annotation name="org.freedesktop.DBus.Deprecated" value="true"/>
      <arg name="enable" direction="in" type="b"/>
    </method>

    <!--
        EnableModule:
        @name: Name of the module.
        @enable: A boolean value indicating whether modules should be enabled. Currently only the %TRUE value is permitted.
        @since: 2.9.0

        Loads and activates single module identified by @name. In case the module is already active no reinitialization
        is done and this call has no effect. Clients are supposed to call this method before using any of the particular module API.
        In case no such module is available or its initialization fails a proper error is returned. This action also causes
        all objects to receive <literal>add</literal> uevent that allows the module to attach extra interfaces before
        this method call returns.

        Modules cannot be deactivated at the moment.
    -->
    <method name="EnableModule">
      <arg name="name" direction="in" type="s"/>
      <arg name="enable" direction="in" type="b"/>
    </method>

    <!--
        GetBlockDevices:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.7.2

        Get list of all block devices (object paths of objects implementing the #org.freedesktop.UDisks2.Block interface) known to UDisks.

    -->
    <method name="GetBlockDevices">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="block_objects" direction="out" type="ao"/>
    </method>

    <!--
        ResolveDevice:
        @devspec: Dictionary with specification of a device.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @devices: List of object paths of all devices matching @devspec.
        @since: 2.7.3

        Get device(s) matching specification given in @devspec.

        Currently supported keys for @devspec include:
        <variablelist>
          <varlistentry>
            <term>path (type <literal>'s'</literal>)</term>
            <listitem><para>
              Device path (e.g. <quote>/dev/sda</quote>). This also includes symlinks in <quote>/dev</quote>
              (both #org.freedesktop.UDisks2.Block:Device and #org.freedesktop.UDisks2.Block:Symlinks are used).
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>label (type <literal>'s'</literal>)</term>
            <listitem><para>
              Filesystem label. #org.freedesktop.UDisks2.Block:IdLabel is used.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>uuid (type <literal>'s'</literal>)</term>
            <listitem><para>
              Filesystem UUID. #org.freedesktop.UDisks2.Block:IdUUID is used.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>partuuid (type <literal>'s'</literal>)</term>
            <listitem><para>
              Partition UUID. #org.freedesktop.UDisks2.Partition:UUID is used.
            </para></listitem>
          </varlistentry>
          <varlistentry>
            <term>partlabel (type <literal>'s'</literal>)</term>
            <listitem><para>
              Partition Name. #org.freedesktop.UDisks2.Partition:Name is used.
            </para></listitem>
          </varlistentry>
        </variablelist>

        It is possbile to specify multiple keys. In this case, only devices matching all values will be returned.

    -->
    <method name="ResolveDevice">
      <arg name="devspec" direction="in" type="a{sv}"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="devices" direction="out" type="ao"/>
    </method>
  </interface>

  <!--
      org.freedesktop.UDisks2.Manager.NVMe:
      @short_description: NVMe host management

      Extension of the top-level manager singleton object exposing
      NVMe host management.
  -->
  <interface name="org.freedesktop.UDisks2.Manager.NVMe">
    <!-- HostNQN:
         @since: 2.10.0

         The Host NQN configured for the system. Reflects contents of the <filename>/etc/nvme/hostnqn</filename>
         file if present or uses autogenerated NQN value otherwise.
    -->
    <property name="HostNQN" type="ay" access="read"/>

    <!-- HostID:
         @since: 2.10.0

         The Host ID configured for the system. Reflects contents of the <filename>/etc/nvme/hostid</filename>
         file if present.
    -->
    <property name="HostID" type="ay" access="read"/>

    <!--
        SetHostNQN:
        @hostnqn: The Host NQN value to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Sets the system-wide Host NQN string,
    -->
    <method name="SetHostNQN">
      <arg name="hostnqn" direction="in" type="ay"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetHostID:
        @hostid: The Host ID value to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Sets the system-wide Host ID string,
    -->
    <method name="SetHostID">
      <arg name="hostid" direction="in" type="ay"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        Connect:
        @subsysnqn: The name for the NVMe subsystem to connect to.
        @transport: The network fabric used for a NVMe-over-Fabrics network.
        @transport_addr: The network address of the Controller. For transports using IP addressing (e.g. <literal>rdma</literal>) this should be an IP-based address.
        @options: Additional options, includes <link linkend="udisks-std-options">standard options</link>.
        @nvme_ctrl: An object path to the connected NVMeoF controller.
        @since: 2.10.0

        Create a transport connection to a remote system and create a NVMe over Fabrics controller
        for the NVMe subsystem specified by the @subsysnqn option.

        Valid values for @transport are <literal>rdma</literal>, <literal>fc</literal>,
        <literal>tcp</literal> and <literal>loop</literal>.

        By default, additional options are read from the system configuration file <filename>/etc/nvme/config.json</filename>.
        This follows the default behaviour of <literal>nvme-cli</literal>. Use the <literal>config</literal>
        option to either specify a different config file or disable use of it altogether. The naming
        of the additional options are generally kept consistent with the JSON config file schema and
        any option specified acts as an override. Available options are:
        <variablelist>
        <varlistentry><term>transport_svcid (type 's')</term>
          <listitem><para>The transport service id.  For transports using IP addressing (e.g. <literal>rdma</literal>) this field is the port number. By default, the IP port number for the RDMA transport is <literal>4420</literal>.</para></listitem></varlistentry>
        <varlistentry><term>host_traddr (type 's')</term>
          <listitem><para>The network address used on the host to connect to the Controller. For TCP, this sets the source address on the socket.</para></listitem></varlistentry>
        <varlistentry><term>host_iface (type 's')</term>
          <listitem><para>The network interface used on the host to connect to the Controller (e.g. IP <literal>eth1</literal>, <literal>enp2s0</literal>). This forces the connection to be made on a specific interface instead of letting the system decide.</para></listitem></varlistentry>
        <varlistentry><term>host_nqn (type 'ay')</term>
          <listitem><para>Overrides the default Host NQN that identifies the NVMe Host.</para></listitem></varlistentry>
        <varlistentry><term>host_id (type 'ay')</term>
          <listitem><para>Overrides the default Host UUID.</para></listitem></varlistentry>
        <varlistentry><term>config (type 'ay')</term>
          <listitem><para>Use the specified JSON configuration file instead of the default file (see above) or specify <literal>"none"</literal> to avoid reading any configuration file.</para></listitem></varlistentry>
        <varlistentry><term>dhchap_key (type 'ay')</term>
          <listitem><para>NVMe in-band authentication secret in ASCII format as described in the NVMe 2.0 specification. When not specified, the secret is by default read from <filename>/etc/nvme/hostkey</filename>. In case that file does not exist no in-band authentication is attempted.</para></listitem></varlistentry>
        <varlistentry><term>dhchap_ctrl_key (type 'ay')</term>
          <listitem><para>NVMe in-band authentication controller secret for bi-directional authentication. When not specified, no bi-directional authentication is attempted.</para></listitem></varlistentry>
        <varlistentry><term>nr_io_queues (type 'i')</term>
          <listitem><para>The number of I/O queues.</para></listitem></varlistentry>
        <varlistentry><term>nr_write_queues (type 'i')</term>
          <listitem><para>Number of additional queues that will be used for write I/O.</para></listitem></varlistentry>
        <varlistentry><term>nr_poll_queues (type 'i')</term>
          <listitem><para>Number of additional queues that will be used for polling latency sensitive I/O.</para></listitem></varlistentry>
        <varlistentry><term>queue_size (type 'i')</term>
          <listitem><para>Number of elements in the I/O queues.</para></listitem></varlistentry>
        <varlistentry><term>keep_alive_tmo (type 'i')</term>
          <listitem><para>The keep alive timeout (in seconds).</para></listitem></varlistentry>
        <varlistentry><term>reconnect_delay (type 'i')</term>
          <listitem><para>The delay (in seconds) before reconnect is attempted after a connect loss.</para></listitem></varlistentry>
        <varlistentry><term>ctrl_loss_tmo (type 'i')</term>
          <listitem><para>The controller loss timeout period (in seconds). A special value of <literal>-1</literal> will cause reconnecting forever.</para></listitem></varlistentry>
        <varlistentry><term>fast_io_fail_tmo (type 'i')</term>
          <listitem><para>Fast I/O Fail timeout (in seconds).</para></listitem></varlistentry>
        <varlistentry><term>tos (type 's')</term>
          <listitem><para>Type of service.</para></listitem></varlistentry>
        <varlistentry><term>duplicate_connect (type 'b')</term>
          <listitem><para>Allow duplicated connections between same transport host and subsystem port.</para></listitem></varlistentry>
        <varlistentry><term>disable_sqflow (type 'b')</term>
          <listitem><para>Disables SQ flow control to omit head doorbell update for submission queues when sending nvme completions.</para></listitem></varlistentry>
        <varlistentry><term>hdr_digest (type 'b')</term>
          <listitem><para>Generates/verifies header digest (TCP).</para></listitem></varlistentry>
        <varlistentry><term>data_digest (type 'b')</term>
          <listitem><para>Generates/verifies data digest (TCP).</para></listitem></varlistentry>
        <varlistentry><term>tls (type 'b')</term>
          <listitem><para>Enable TLS encryption (TCP).</para></listitem></varlistentry>
        <varlistentry><term>hostsymname (type 'ay')</term>
          <listitem><para>TP8010: NVMe host symbolic name.</para></listitem></varlistentry>
        <varlistentry><term>keyring (type 'ay')</term>
          <listitem><para>Keyring to store and lookup keys.</para></listitem></varlistentry>
        <varlistentry><term>tls_key (type 'ay')</term>
          <listitem><para>TLS PSK for the connection.</para></listitem></varlistentry>
        </variablelist>
    -->
    <method name="Connect">
      <arg name="subsysnqn" direction="in" type="ay"/>
      <arg name="transport" direction="in" type="s"/>
      <arg name="transport_addr" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="nvme_ctrl" direction="out" type="o"/>
    </method>
  </interface>

  <!--
      org.freedesktop.UDisks2.Drive:
      @short_description: Disk drives

      This interface is used to represent both hard disks and disk
      drives (with or without removable media).

      This interface should not to be confused with the
      #org.freedesktop.UDisks2.Block interface that is used for
      low-level block devices the OS knows about. For example, if
      <filename>/dev/sda</filename> and <filename>/dev/sdb</filename>
      are block devices for two paths to the same drive, there will be
      only one #org.freedesktop.UDisks2.Drive object but two
      #org.freedesktop.UDisks2.Block objects.
  -->
  <interface name="org.freedesktop.UDisks2.Drive">
    <!-- Vendor: A name for the vendor of the drive or blank if unknown. -->
    <property name="Vendor" type="s" access="read"/>
    <!-- Model: A name for the model of the drive or blank if unknown. -->
    <property name="Model" type="s" access="read"/>
    <!-- Revision: Firmware Revision or blank if unknown. -->
    <property name="Revision" type="s" access="read"/>
    <!-- Serial: Serial number of the drive or blank if unknown. -->
    <property name="Serial" type="s" access="read"/>
    <!-- WWN:

         The <ulink
         url="http://en.wikipedia.org/wiki/World_Wide_Name">World Wide
         Name</ulink> of the drive or blank if unknown.

         In case of NVMe drives please refer to namespace-level WWN properties.
    -->
    <property name="WWN" type="s" access="read"/>

    <!-- Id:
         A unique and persistent identifier for the device or blank if
         no such identifier is available.

         This identifier is guaranteed to not include the slash
         character '/' (U+002F SOLIDUS) which means it can be used as
         a filename.

         Examples:
         <quote>ST32000542AS-6XW00W51</quote>,
         <quote>HITACHI-HTS723232A7A364-E3834563KRG2HN</quote>,
         <quote>INTEL-SSDSA2MH080G1GC-CVEM842101HD080DGN</quote>.
    -->
    <property name="Id" type="s" access="read"/>

    <!-- Configuration:
         A set of configuration directives that are applied to the
         drive when it is connected (e.g. at start-up, hotplug or
         resume).

         This is an dict of items with the following known keys:
         <variablelist>
           <varlistentry>
             <term>ata-pm-standby (type <literal>'i'</literal>)</term>
             <listitem><para>
               The spindown timeout for ATA drives (See ATA command <quote>STANDBY</quote>).
             </para></listitem>
           </varlistentry>
           <varlistentry>
             <term>ata-apm-level (type <literal>'i'</literal>)</term>
             <listitem><para>
               The APM level for ATA drives (See ATA command <quote>SET FEATURES</quote>, sub-commands 0x05 and 0x85).
             </para></listitem>
           </varlistentry>
           <varlistentry>
             <term>ata-aam-level (type <literal>'i'</literal>)</term>
             <listitem><para>
               The AAM level for ATA drives (See ATA command <quote>SET FEATURES</quote>, sub-commands 0x42 and 0xc2).
             </para></listitem>
           </varlistentry>
           <varlistentry>
             <term>ata-write-cache-enabled (type <literal>'b'</literal>)</term>
             <listitem><para>
               Whether the write-cache is enabled (See ATA command <quote>SET FEATURES</quote>, sub-commands 0x82 and 0x02). Since 2.1.
             </para></listitem>
           </varlistentry>
           <varlistentry>
             <term>ata-read-lookahead-enabled (type <literal>'b'</literal>)</term>
             <listitem><para>
               Whether the read look-ahead is enabled (See ATA command <quote>SET FEATURES</quote>, sub-commands 0x55 and 0xaa). Since 2.1.7.
             </para></listitem>
           </varlistentry>
         </variablelist>
         The contents of this property is read from the configuration
         file <filename>/etc/udisks2/IDENTIFIER.conf</filename>
         where <emphasis>IDENTIFIER</emphasis> is the value of the
         #org.freedesktop.UDisks2.Drive:Id property. See <xref
         linkend="udisks.8"/> for the file format of this file.

         Use the org.freedesktop.UDisks2.Drive.SetConfiguration()
         method to change the value of this property.
    -->
    <property name="Configuration" type="a{sv}" access="read"/>

    <!-- Media: The kind of media currently in the drive or blank if unknown.
         See the #org.freedesktop.UDisks2.Drive:MediaCompatibility property for known values.
    -->
    <property name="Media" type="s" access="read"/>

    <!-- MediaCompatibility:
      The physical kind of media the drive uses or the type of the drive or blank if unknown.
      Known values include
      <variablelist>
      <varlistentry><term>thumb</term><listitem><para>The device is a thumb-drive with non-removable media (e.g. a USB stick)</para></listitem></varlistentry>
      <varlistentry><term>flash</term><listitem><para>Flash Card</para></listitem></varlistentry>
      <varlistentry><term>flash_cf</term><listitem><para>CompactFlash</para></listitem></varlistentry>
      <varlistentry><term>flash_ms</term><listitem><para>MemoryStick</para></listitem></varlistentry>
      <varlistentry><term>flash_sm</term><listitem><para>SmartMedia</para></listitem></varlistentry>
      <varlistentry><term>flash_sd</term><listitem><para>Secure Digital</para></listitem></varlistentry>
      <varlistentry><term>flash_sdhc</term><listitem><para>Secure Digital High Capacity</para></listitem></varlistentry>
      <varlistentry><term>flash_sdxc</term><listitem><para>Secure Digital eXtended Capacity</para></listitem></varlistentry>
      <varlistentry><term>flash_sdio</term><listitem><para>Secure Digital Input Output</para></listitem></varlistentry>
      <varlistentry><term>flash_sd_combo</term><listitem><para>Secure Digital Input Output combo card with storage and I/O functionality</para></listitem></varlistentry>
      <varlistentry><term>flash_mmc</term><listitem><para>MultiMediaCard</para></listitem></varlistentry>
      <varlistentry><term>floppy</term><listitem><para>Floppy Disk</para></listitem></varlistentry>
      <varlistentry><term>floppy_zip</term><listitem><para>Zip Disk</para></listitem></varlistentry>
      <varlistentry><term>floppy_jaz</term><listitem><para>Jaz Disk</para></listitem></varlistentry>
      <varlistentry><term>optical</term><listitem><para>Optical Disc</para></listitem></varlistentry>
      <varlistentry><term>optical_cd</term><listitem><para>Compact Disc</para></listitem></varlistentry>
      <varlistentry><term>optical_cd_r</term><listitem><para>Compact Disc Recordable</para></listitem></varlistentry>
      <varlistentry><term>optical_cd_rw</term><listitem><para>Compact Disc Rewritable</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd</term><listitem><para>Digital Versatile Disc</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_r</term><listitem><para>DVD-R</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_rw</term><listitem><para>DVD-RW</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_ram</term><listitem><para>DVD-RAM</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_plus_r</term><listitem><para>DVD+R</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_plus_rw</term><listitem><para>DVD+RW</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_plus_r_dl</term><listitem><para>DVD+R Dual Layer</para></listitem></varlistentry>
      <varlistentry><term>optical_dvd_plus_rw_dl</term><listitem><para>DVD+RW Dual Layer</para></listitem></varlistentry>
      <varlistentry><term>optical_bd</term><listitem><para>Blu-ray Disc</para></listitem></varlistentry>
      <varlistentry><term>optical_bd_r</term><listitem><para>Blu-ray Recordable</para></listitem></varlistentry>
      <varlistentry><term>optical_bd_re</term><listitem><para>Blu-ray Rewritable</para></listitem></varlistentry>
      <varlistentry><term>optical_hddvd</term><listitem><para>HD-DVD</para></listitem></varlistentry>
      <varlistentry><term>optical_hddvd_r</term><listitem><para>HD-DVD Recordable</para></listitem></varlistentry>
      <varlistentry><term>optical_hddvd_rw</term><listitem><para>HD-DVD Rewritable</para></listitem></varlistentry>
      <varlistentry><term>optical_mo</term><listitem><para>Magneto Optical</para></listitem></varlistentry>
      <varlistentry><term>optical_mrw</term><listitem><para>Can read Mount Rainer media</para></listitem></varlistentry>
      <varlistentry><term>optical_mrw_w</term><listitem><para>Can write Mount Rainer media</para></listitem></varlistentry>
      </variablelist>
    -->
    <property name="MediaCompatibility" type="as" access="read"/>

    <!-- MediaRemovable:
         Whether the media can be removed from the drive.

         Note that this may be overridden from what the hardware
         reports - for example, USB thumb drives often report that
         they are using removable media while in fact the media
         is not removable.
    -->
    <property name="MediaRemovable" type="b" access="read"/>

    <!-- MediaAvailable: Set to %FALSE if no medium is available.
         This is always %TRUE if #org.freedesktop.UDisks2.Drive:MediaChangeDetected is %FALSE.
    -->
    <property name="MediaAvailable" type="b" access="read"/>

    <!-- MediaChangeDetected: Set to %TRUE only if media changes are detected.
         Media changes are detected on all modern disk drives through
         either polling or an asynchronous notification mechanism. The
         only known disk drives that cannot report media changes are
         PC floppy drives.
    -->
    <property name="MediaChangeDetected" type="b" access="read"/>

    <!-- Size: The size of the drive (or the media currently in the drive).
         In case of NVMe this value indicates the total NVM capacity that is accessible by the NVMe controller.
         This is always 0 if #org.freedesktop.UDisks2.Drive:MediaChangeDetected is %FALSE.
    -->
    <property name="Size" type="t" access="read"/>

    <!-- TimeDetected: The time the drive was first detected.
         This is expressed in micro-seconds since the Epoch Jan 1, 1970 0:00 UTC.
    -->
    <property name="TimeDetected" type="t" access="read"/>

    <!-- TimeMediaDetected: The earliest time media was last detected or 0 if media is not available.
         This is expressed in micro-seconds since the Epoch Jan 1, 1970 0:00 UTC.
    -->
    <property name="TimeMediaDetected" type="t" access="read"/>

    <!-- Optical: %TRUE if the drive contains an optical disc. -->
    <property name="Optical" type="b" access="read"/>

    <!-- OpticalBlank: %TRUE if the disc is blank.
         This is only valid if the property #org.freedesktop.UDisks2.Drive:Optical is %TRUE.
      -->
    <property name="OpticalBlank" type="b" access="read"/>

    <!-- OpticalNumTracks: The number of tracks.
         This is only valid if the property #org.freedesktop.UDisks2.Drive:Optical is %TRUE.
      -->
    <property name="OpticalNumTracks" type="u" access="read"/>

    <!-- OpticalNumAudioTracks: The number of audio tracks.
         This is only valid if the property #org.freedesktop.UDisks2.Drive:Optical is %TRUE.
      -->
    <property name="OpticalNumAudioTracks" type="u" access="read"/>

    <!-- OpticalNumDataTracks: The number of data tracks.
         This is only valid if the property #org.freedesktop.UDisks2.Drive:Optical is %TRUE.
      -->
    <property name="OpticalNumDataTracks" type="u" access="read"/>

    <!-- OpticalNumSessions: The number of sessions.
         This is only valid if the property #org.freedesktop.UDisks2.Drive:Optical is %TRUE.
     -->
    <property name="OpticalNumSessions" type="u" access="read"/>

    <!-- RotationRate: The rotational rate of the drive.
      <itemizedlist>
        <listitem><para>-1 if known to be rotating media but rotation rate isn't known</para></listitem>
        <listitem><para>0 if known to be non-rotating media</para></listitem>
        <listitem><para>the rotation rate in rounds per minute otherwise</para></listitem>
      </itemizedlist>
    -->
    <property name="RotationRate" type="i" access="read"/>

    <!-- ConnectionBus:
      The physical connection bus used for the drive as seen by the
      user. This is typically used to draw a USB or Firewire emblem
      on top of an icon in an user interface.

      Note that this property has <emphasis>nothing</emphasis> to do
      with the low-level command-set used (such as ATA-8) or what
      low-level connection bus (such as SATA, eSATA, PATA, SAS2 etc)
      is used.

      Known values include:
      <variablelist>
      <varlistentry><term>usb</term><listitem><para>Connected via <ulink url="http://en.wikipedia.org/wiki/USB">USB</ulink></para></listitem></varlistentry>
      <varlistentry><term>sdio</term><listitem><para>Connected via SDHC or <ulink url="http://en.wikipedia.org/wiki/Secure_Digital">SDIO</ulink> controller (including eMMC).</para></listitem></varlistentry>
      <varlistentry><term>ieee1394</term><listitem><para>Connected via <ulink url="http://en.wikipedia.org/wiki/Firewire">Firewire</ulink></para></listitem></varlistentry>
      </variablelist>
    -->
    <property name="ConnectionBus" type="s" access="read"/>

    <!-- Seat:
         A string identifying what seat the drive is plugged into, if any.
    -->
    <property name="Seat" type="s" access="read"/>

    <!--
        Removable:
        A hint whether the drive and/or its media is considered
        <emphasis>removable</emphasis> by the user.

        This includes drives with removable media (cf. the
        #org.freedesktop.UDisks2.Drive:MediaRemovable property), Flash
        media such as SD cards and drives on hotpluggable buses such
        as USB or Firewire (cf. the
        #org.freedesktop.UDisks2.Drive:ConnectionBus property).

        Note that this is only a <emphasis>guess</emphasis>.
    -->
    <property name="Removable" type="b" access="read"/>

    <!-- Ejectable:
         Whether the media can be ejected from the drive or the drive
         accepts an eject command to switch its state so it displays
         e.g. a "Safe To Remove" message to the user.

         Note that this is only a <emphasis>guess</emphasis>.
    -->
    <property name="Ejectable" type="b" access="read"/>

    <!-- SortKey:
         A string that can be used for sorting drive objects.
    -->
    <property name="SortKey" type="s" access="read"/>

    <!--
        Eject:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Ejects media from the drive. This is only meaningful to do on
        drives with removable media.

        There are not a lot of guarantees associated with this method
        so it should only be called in response to an user action.

        On some hardware the media may be physically ejected while on
        other hardware may simply eject the disc. On some hardware it
        may not do anything physical but it may cause e.g. a display
        on the hardware to show e.g. <quote>It is now safe to remove
        the device</quote>.
    -->
    <method name="Eject">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetConfiguration:
        @value: The configuration value to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Sets the configuration for the drive. This will store the
        configuration in the file-system and also apply it to the
        drive.

        See the #org.freedesktop.UDisks2.Drive:Configuration property
        for details about valid values and the location of the
        configuration file that @value will be written to.
    -->
    <method name="SetConfiguration">
      <arg name="value" direction="in" type="a{sv}"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        PowerOff:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.0.0

        Arranges for the drive to be safely removed and powered
        off. On the OS side this includes ensuring that no process is
        using the drive, then requesting that in-flight buffers and
        caches are committed to stable storage. The exact steps for
        powering off the drive depends on the drive itself and the
        interconnect used. For drives connected through USB, the
        effect is that the USB device will be deconfigured followed by
        disabling the upstream hub port it is connected to.

        Note that as some physical devices contain multiple drives
        (for example 4-in-1 flash card reader USB devices) powering
        off one drive may affect other drives. Applications can
        examine the #org.freedesktop.UDisks2.Drive:SiblingId property
        to determine such relationships.

        There are not a lot of guarantees associated with this method
        so it should only be called in response to an user
        action. Usually the effect is that the drive disappears as if
        it was unplugged.

        This method only works if the
        #org.freedesktop.UDisks2.Drive:CanPowerOff property
        is set to %TRUE.
    -->
    <method name="PowerOff">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- CanPowerOff:
         @since: 2.0.0
         Whether the drive can be safely removed / powered off. See
         the org.freedesktop.UDisks2.Drive.PowerOff() method for more
         information.

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="CanPowerOff" type="b" access="read"/>

    <!-- SiblingId:
         @since: 2.0.0
         An opaque token that, if non-blank, is used to group drives
         that are part of the same physical device.
    -->
    <property name="SiblingId" type="s" access="read"/>

  </interface>

  <!--
    org.freedesktop.UDisks2.Drive.Ata:
    @short_description: Disk drives using the ATA command-set

    Objects implementing this interface also implement the
    #org.freedesktop.UDisks2.Drive interface.
  -->
  <interface name="org.freedesktop.UDisks2.Drive.Ata">
    <!-- SmartSupported: Whether the drive supports SMART. -->
    <property name="SmartSupported" type="b" access="read"/>

    <!-- SmartEnabled: Whether SMART is enabled. -->
    <property name="SmartEnabled" type="b" access="read"/>

    <!-- SmartUpdated:
         The point in time (seconds since the
         <ulink url="http://en.wikipedia.org/wiki/Unix_epoch">Unix Epoch</ulink>)
         that the SMART status was updated or 0 if never updated.

         The value of the other properties related to SMART are not
         meaningful if this property is 0.
    -->
    <property name="SmartUpdated" type="t" access="read"/>

    <!-- SmartFailing:
         Set to %TRUE if disk is about to fail.

         This value is read from the disk itself and does not include
         any interpretation.
    -->
    <property name="SmartFailing" type="b" access="read"/>

    <!-- SmartPowerOnSeconds:
         The amount of time the disk has been powered on (according to SMART data) or 0 if unknown.
    -->
    <property name="SmartPowerOnSeconds" type="t" access="read"/>

    <!-- SmartTemperature:
         The temperature (in Kelvin) of the disk according to SMART data or 0 if unknown.
    -->
    <property name="SmartTemperature" type="d" access="read"/>

    <!--
        SmartNumAttributesFailing:
        The number of attributes failing right now or -1 if unknown.
    -->
    <property name="SmartNumAttributesFailing" type="i" access="read"/>

    <!--
        SmartNumAttributesFailedInThePast:
        The number of attributes that have failed in the past or -1 if unknown.
    -->
    <property name="SmartNumAttributesFailedInThePast" type="i" access="read"/>

    <!--
        SmartNumBadSectors:
        The number of bad sectors (ie. pending and reallocated) or -1 if unknown.
    -->
    <property name="SmartNumBadSectors" type="x" access="read"/>

    <!-- SmartSelftestStatus:
         The status of the last self-test. Known values include
        <variablelist>
        <varlistentry><term>success</term>
          <listitem><para>Last self-test was a success (or never ran).</para></listitem></varlistentry>
        <varlistentry><term>aborted</term>
          <listitem><para>Last self-test was aborted.</para></listitem></varlistentry>
        <varlistentry><term>interrupted</term>
          <listitem><para>Last self-test was interrupted.</para></listitem></varlistentry>
        <varlistentry><term>fatal</term>
          <listitem><para>Last self-test did not complete.</para></listitem></varlistentry>
        <varlistentry><term>error_unknown</term>
          <listitem><para>Last self-test failed (Unknown).</para></listitem></varlistentry>
        <varlistentry><term>error_electrical</term>
          <listitem><para>Last self-test failed (Electrical).</para></listitem></varlistentry>
        <varlistentry><term>error_servo</term>
          <listitem><para>Last self-test failed (Servo).</para></listitem></varlistentry>
        <varlistentry><term>error_read</term>
          <listitem><para>Last self-test failed (Read).</para></listitem></varlistentry>
        <varlistentry><term>error_handling</term>
          <listitem><para>Last self-test failed (Damage).</para></listitem></varlistentry>
        <varlistentry><term>inprogress</term>
          <listitem><para>Self-test is currently in progress.</para></listitem></varlistentry>
        </variablelist>
    -->
    <property name="SmartSelftestStatus" type="s" access="read"/>

    <!--
        SmartSelftestPercentRemaining:
        The percent remaining or -1 if unknown.
    -->
    <property name="SmartSelftestPercentRemaining" type="i" access="read"/>

    <!--
        SmartUpdate:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>nowakeup</parameter> (of type 'b').

        Reads SMART data from the drive and update relevant properties.

        If the option @nowakeup is given and the disk is in a sleeping
        state, the error
        <literal>org.freedesktop.UDisks2.Error.WouldWakeup</literal> is
        returned.

        The option @atasmart_blob can be used to inject libatasmart
        compatible blobs for testing how clients react to different
        kinds of SMART data. This option may be removed in the future
        without it being considered an ABI break.
    -->
    <method name="SmartUpdate">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SmartGetAttributes:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>nowakeup</parameter> (of type 'b').
        @attributes: The SMART attributes.

        Get the SMART attributes.
        Each attribute is a struct with the following members:
        <variablelist>
        <varlistentry><term>id (type 'y')</term>
          <listitem><para>Attribute Identifier</para></listitem></varlistentry>
        <varlistentry><term>name (type 's')</term>
          <listitem><para>The identifier as a string.</para></listitem></varlistentry>
        <varlistentry><term>flags (type 'q')</term>
          <listitem><para>16-bit attribute flags (bit 0 is prefail/oldage, bit 1 is online/offline).</para></listitem></varlistentry>
        <varlistentry><term>value (type 'i')</term>
          <listitem><para>The current value or -1 if unknown.</para></listitem></varlistentry>
        <varlistentry><term>worst (type 'i')</term>
          <listitem><para>The worst value of -1 if unknown.</para></listitem></varlistentry>
        <varlistentry><term>threshold (type 'i')</term>
          <listitem><para>The threshold or -1 if unknown.</para></listitem></varlistentry>
        <varlistentry><term>pretty (type 'x')</term>
          <listitem><para>An interpretation of the value - must be ignored if @pretty_unit is 0.</para></listitem></varlistentry>
        <varlistentry><term>pretty_unit (type 'i')</term>
          <listitem><para>The unit of the @pretty value - the following units are known: 0 (unknown), 1 (dimensionless), 2 (milliseconds), 3 (sectors), 4 (millikelvin).</para></listitem></varlistentry>
        <varlistentry><term>expansion (type 'a{sv}')</term>
          <listitem><para>Currently unused. Intended for future expansion.</para></listitem></varlistentry>
        </variablelist>
        The @name parameter should be used as the authoritative identifier for the attribute since it is derived from the numerical @id and the disk's <literal>IDENTIFY</literal> data and thus handles ID collisions between drives of different make and model.
    -->
    <method name="SmartGetAttributes">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="attributes" direction="out" type="a(ysqiiixia{sv})"/>
    </method>

    <!--
        SmartSelftestStart:
        @type: The type test to run.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Starts a SMART selftest. The @type parameter is for the type
        of test to start - valid values are <literal>short</literal>,
        <literal>extended</literal> and <literal>conveyance</literal>.

        Note that the method returns immediately after the test has
        been started successfully.
    -->
    <method name="SmartSelftestStart">
      <arg name="type" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SmartSelftestAbort:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Aborts a running SMART selftest.
    -->
    <method name="SmartSelftestAbort">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SmartSetEnabled:
        @value: %TRUE to enable SMART, %FALSE to disable SMART.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.0.0

        Sets whether SMART is enabled for the drive. This setting is
        stored in the non-volatile memory in the drive itself and does
        not need to be refreshed every time the drive is powered on or
        connected.

        Since this may require authentication and thus may fail, it is
        implemented this way instead of the
        #org.freedesktop.UDisks2.Drive.Ata:SmartEnabled property being
        writable.
    -->
    <method name="SmartSetEnabled">
      <arg name="value" direction="in" type="b"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- PmSupported: Whether the drive supports power management. -->
    <property name="PmSupported" type="b" access="read"/>

    <!-- PmEnabled: Whether power management is enabled. -->
    <property name="PmEnabled" type="b" access="read"/>

    <!-- ApmSupported: Whether the drive supports Advanced Power Management (APM). -->
    <property name="ApmSupported" type="b" access="read"/>

    <!-- ApmEnabled: Whether Advanced Power Management (APM) is enabled. -->
    <property name="ApmEnabled" type="b" access="read"/>

    <!-- AamSupported: Whether the drive supports Automatic Acoustic Management (AAM). -->
    <property name="AamSupported" type="b" access="read"/>

    <!-- AamEnabled: Whether Automatic Acoustic Management (AAM) is enabled. -->
    <property name="AamEnabled" type="b" access="read"/>

    <!-- AamVendorRecommendedValue: The vendor-recommended AAM value (or 0 if AAM is not supported). -->
    <property name="AamVendorRecommendedValue" type="i" access="read"/>

    <!-- WriteCacheSupported:
         @since: 2.0.0
         Whether the drive supports configuring the write cache.
    -->
    <property name="WriteCacheSupported" type="b" access="read"/>

    <!-- WriteCacheEnabled:
         @since: 2.0.0
         Whether the write-cache is enabled (or %FALSE if not supported).
    -->
    <property name="WriteCacheEnabled" type="b" access="read"/>

    <!-- ReadLookaheadSupported:
         @since: 2.1.7
         Whether the drive supports configuring the read look-ahead.
    -->
    <property name="ReadLookaheadSupported" type="b" access="read"/>

    <!-- ReadLookaheadEnabled:
         @since: 2.1.7
         Whether the read look-ahead is enabled (or %FALSE if not supported).
    -->
    <property name="ReadLookaheadEnabled" type="b" access="read"/>

    <!--
        PmGetState:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @state: The current power state.

        Get the current power mode status. This is implemented as a
        method call as it involves sending a command from the host to
        the drive and no change notification is available.

        The format of @state is the result obtained from sending the
        ATA command <quote>CHECK POWER MODE</quote> to the drive.
        Known values include
        <variablelist>
        <varlistentry><term>0x00</term><listitem><para>Standby</para></listitem></varlistentry>
        <varlistentry><term>0x80</term><listitem><para>Idle</para></listitem></varlistentry>
        <varlistentry><term>0xff</term><listitem><para>Active/Idle</para></listitem></varlistentry>
        </variablelist>
        Typically user interfaces will report "Drive is spun down" if @state is
        0x00 and "Drive is spun up" otherwise.
    -->
    <method name="PmGetState">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="state" direction="out" type="y"/>
    </method>

    <!--
        PmStandby:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Force the drive to immediately enter the low power consumption
        <emphasis>standby</emphasis> mode, usually causing it to spin
        down. This is done by sending the ATA command
        <quote>STANDBY IMMEDIATE</quote> to the drive.
    -->
    <method name="PmStandby">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        PmWakeup:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Force the drive to immediately wake up (exiting the low power
        consumption <emphasis>standby</emphasis> mode), usually
        causing it to spin up. This is done by reading data from the
        disk.
    -->
    <method name="PmWakeup">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- SecurityEraseUnitMinutes:
         The estimated amount of minutes it takes to complete the
         <quote>SECURITY ERASE UNIT</quote> command or 0 if this
         command is not available.

         If set to 510 it means that it takes at least 508 minutes to
         complete the operation.
    -->
    <property name="SecurityEraseUnitMinutes" type="i" access="read"/>

    <!-- SecurityEnhancedEraseUnitMinutes:
         The estimated amount of minutes it takes to complete the
         <quote>SECURITY ERASE UNIT</quote> command with enhanced mode
         specified or 0 if enhanced erase is not available.

         If set to 510 it means that it takes at least 508 minutes to
         complete the operation.
    -->
    <property name="SecurityEnhancedEraseUnitMinutes" type="i" access="read"/>

    <!-- SecurityFrozen:
         If set to %TRUE the unit is frozen.
    -->
    <property name="SecurityFrozen" type="b" access="read"/>

    <!--
        SecurityEraseUnit:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>enhanced</parameter> (of type 'b').

        Does all the necessary checks and preparations and then sends
        the <quote>SECURITY ERASE UNIT</quote> command to the
        drive. If the option @enhanced is set to %TRUE an
        <emphasis>enhanced secure erase</emphasis> is requested.

        All data on the drive will be irrevocably erased.

        This operation takes either
        #org.freedesktop.UDisks2.Drive.Ata:SecurityEraseUnitMinutes or
        #org.freedesktop.UDisks2.Drive.Ata:SecurityEnhancedEraseUnitMinutes
        minutes to complete depending on whether the @enhanced option
        is %TRUE.
    -->
    <method name="SecurityEraseUnit">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

  </interface>

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

  <!--
    org.freedesktop.UDisks2.NVMe.Controller:
    @short_description: NVMe controller device

    This interface represents a controller device in a NVM subsystem.
  -->
  <interface name="org.freedesktop.UDisks2.NVMe.Controller">
    <!-- State:
         @since: 2.10.0

         The controller operating state. Values other than <literal>live</literal> may result in temporary
         refusal of any I/O and subsequent missing information provided by UDisks.

         Known values include:
         <variablelist>
           <varlistentry><term>live</term><listitem><para>Controller is up and running.</para></listitem></varlistentry>
           <varlistentry><term>new</term><listitem><para></para></listitem></varlistentry>
           <varlistentry><term>resetting</term><listitem><para></para></listitem></varlistentry>
           <varlistentry><term>connecting</term><listitem><para></para></listitem></varlistentry>
           <varlistentry><term>deleting</term><listitem><para></para></listitem></varlistentry>
           <varlistentry><term>deleting (no IO)</term><listitem><para></para></listitem></varlistentry>
           <varlistentry><term>dead</term><listitem><para></para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="State" type="s" access="read"/>

    <!-- ControllerID:
         @since: 2.10.0

         The NVM subsystem unique controller identifier.
    -->
    <property name="ControllerID" type="q" access="read"/>

    <!-- SubsystemNQN:
         @since: 2.10.0

         The NVM Subsystem NVMe Qualified Name.
    -->
    <property name="SubsystemNQN" type="ay" access="read"/>

    <!-- FGUID:
         @since: 2.10.0

         The FRU Globally Unique Identifier.

         Field-Replaceable Unit (FRU) is a physical component, device, or assembly that is able
         to be removed and replaced without having to replace the entire system.

         The FRU Globally Unique Identifier is a 128-bit value that is globally unique for a given
         Field Replaceable Unit (FRU). Value of %0 indicates this feature is not supported.
    -->
    <property name="FGUID" type="s" access="read"/>

    <!-- NVMeRevision:
         @since: 2.10.0

         The major, minor, and micro version of the NVM Express base specification
         that the controller implementation supports. Note that some older devices
         (typically NVMe rev. lower than 1.2) may not always report this value.
    -->
    <property name="NVMeRevision" type="s" access="read"/>

    <!-- UnallocatedCapacity:
         @since: 2.10.0

         The unallocated NVM capacity that is accessible by the controller.
    -->
    <property name="UnallocatedCapacity" type="t" access="read"/>

    <!-- SmartUpdated:
         @since: 2.10.0

         The point in time (seconds since the
         <ulink url="http://en.wikipedia.org/wiki/Unix_epoch">Unix Epoch</ulink>)
         that the SMART/Health Information was updated or 0 if never updated.

         The value of the other properties related to SMART are not
         meaningful if this property is 0.
    -->
    <property name="SmartUpdated" type="t" access="read"/>

    <!-- SmartCriticalWarning:
         @since: 2.10.0

         Critical warnings issued for the current state of the controller. An empty array
         indicates a healthy state. This is the primary health assesment property to watch for.

         Known values include:
         <variablelist>
         <varlistentry><term>spare</term>
           <listitem><para>The available spare capacity has fallen below the threshold.</para></listitem></varlistentry>
         <varlistentry><term>temperature</term>
           <listitem><para>A temperature is either greater than or equal to an over temperature threshold; or less than or equal to an under temperature threshold.</para></listitem></varlistentry>
         <varlistentry><term>degraded</term>
           <listitem><para>The NVM subsystem reliability has been degraded due to significant media related errors or any internal error that degrades NVM subsystem reliability.</para></listitem></varlistentry>
         <varlistentry><term>readonly</term>
           <listitem><para>All of the media has been placed in read only mode. Unrelated to the write protection state of a namespace.</para></listitem></varlistentry>
         <varlistentry><term>volatile_mem</term>
           <listitem><para>The volatile memory backup device has failed. Only valid if the controller has a volatile memory backup solution.</para></listitem></varlistentry>
         <varlistentry><term>pmr_readonly</term>
           <listitem><para>Persistent Memory Region has become read-only or unreliable.</para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="SmartCriticalWarning" type="as" access="read"/>

    <!-- SmartPowerOnHours:
         @since: 2.10.0

         The amount of time the disk has been powered on (according to SMART data) or 0 if unknown.
    -->
    <property name="SmartPowerOnHours" type="t" access="read"/>

    <!-- SmartTemperature:
         @since: 2.10.0

         The temperature (in Kelvin) that represents the current composite temperature
         of the controller and associated namespaces or 0 if unknown. Values of the particular
         temperature sensors are exposed via the SmartGetAttributes() method.
    -->
    <property name="SmartTemperature" type="q" access="read"/>

    <!-- SmartSelftestStatus:
         @since: 2.10.0

         The status of the last self-test. Known values include:
         <variablelist>
         <varlistentry><term>success</term>
           <listitem><para>Operation completed without error (or never ran).</para></listitem></varlistentry>
         <varlistentry><term>aborted</term>
           <listitem><para>Operation was aborted by a Device Self-test command.</para></listitem></varlistentry>
         <varlistentry><term>ctrl_reset</term>
           <listitem><para>Operation was aborted by a Controller Level Reset.</para></listitem></varlistentry>
         <varlistentry><term>ns_removed</term>
           <listitem><para>Operation was aborted due to a removal of a namespace from the namespace inventory.</para></listitem></varlistentry>
         <varlistentry><term>aborted_format</term>
           <listitem><para>Operation was aborted due to the processing of a Format NVM command.</para></listitem></varlistentry>
         <varlistentry><term>fatal_error</term>
           <listitem><para>A fatal error or unknown test error occurred while the controller was executing the device self-test operation and the operation did not complete.</para></listitem></varlistentry>
         <varlistentry><term>unknown_seg_fail</term>
           <listitem><para>Operation completed with a segment that failed and the segment that failed is not known.</para></listitem></varlistentry>
         <varlistentry><term>known_seg_fail</term>
           <listitem><para>Operation completed with one or more failed segments.</para></listitem></varlistentry>
         <varlistentry><term>aborted_unknown</term>
           <listitem><para>Operation was aborted for unknown reason.</para></listitem></varlistentry>
         <varlistentry><term>aborted_sanitize</term>
           <listitem><para>Operation was aborted due to a sanitize operation.</para></listitem></varlistentry>
         <varlistentry><term>inprogress</term>
           <listitem><para>Self-test operation is currently in progress.</para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="SmartSelftestStatus" type="s" access="read"/>

    <!--
        SmartSelftestPercentRemaining:
        @since: 2.10.0

        The percent remaining or -1 if unknown.
    -->
    <property name="SmartSelftestPercentRemaining" type="i" access="read"/>

    <!-- SanitizeStatus:
         @since: 2.10.0

         The information about the most recent sanitize operation. Known values include:
         <variablelist>
         <varlistentry><term>never_sanitized</term>
           <listitem><para>The NVM subsystem has never been sanitized (or the status is unknown).</para></listitem></varlistentry>
         <varlistentry><term>success</term>
           <listitem><para>Operation completed successfully.</para></listitem></varlistentry>
         <varlistentry><term>failure</term>
           <listitem><para>The most recent sanitize operation failed.</para></listitem></varlistentry>
         <varlistentry><term>inprogress</term>
           <listitem><para>A sanitize operation is currently in progress.</para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="SanitizeStatus" type="s" access="read"/>

    <!--
        SanitizePercentRemaining:
        @since: 2.10.0

        The percent remaining or -1 if unknown.
    -->
    <property name="SanitizePercentRemaining" type="i" access="read"/>

    <!--
        SmartUpdate:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Reads SMART/Health Information from the NVMe controller and update relevant properties.
        Data in this interface are typically updated on every uevent or as a result of Asynchronous
        Event Notification.
    -->
    <method name="SmartUpdate">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SmartGetAttributes:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @attributes: The SMART attributes.
        @since: 2.10.0

        Get the SMART/Health Information attributes.

        Known values include:
        <variablelist>
        <varlistentry><term>avail_spare (type 'y')</term>
          <listitem><para>Available Spare: a normalized percentage (0% to 100%) of the remaining spare capacity available.</para></listitem></varlistentry>
        <varlistentry><term>spare_thresh (type 'y')</term>
          <listitem><para>Available Spare Threshold: a normalized percentage (0% to 100%) of the available spare threshold.</para></listitem></varlistentry>
        <varlistentry><term>percent_used (type 'y')</term>
          <listitem><para>Percentage Used: a vendor specific estimate of the percentage drive life used based on the actual usage
                          and the manufacturer's prediction. A value of 100 indicates that the estimated endurance has been consumed,
                          but may not indicate an NVM subsystem failure. The value is allowed to exceed 100.</para></listitem></varlistentry>
        <varlistentry><term>total_data_read (type 't')</term>
          <listitem><para>An estimated calculation of total data read in bytes based on calculation of data units read from the host.</para></listitem></varlistentry>
        <varlistentry><term>total_data_written (type 't')</term>
          <listitem><para>An estimated calculation of total data written in bytes based on calculation of data units written by the host.</para></listitem></varlistentry>
        <varlistentry><term>ctrl_busy_time (type 't')</term>
          <listitem><para>Amount of time the controller is busy with I/O commands, reported in minutes.</para></listitem></varlistentry>
        <varlistentry><term>power_cycles (type 't')</term>
          <listitem><para>The number of power cycles.</para></listitem></varlistentry>
        <varlistentry><term>unsafe_shutdowns (type 't')</term>
          <listitem><para>The number of unsafe shutdowns as a result of a Shutdown Notification not received prior to loss of power.</para></listitem></varlistentry>
        <varlistentry><term>media_errors (type 't')</term>
          <listitem><para>Media and Data Integrity Errors: the number of occurrences where the controller detected an unrecovered data integrity error
                          (e.g. uncorrectable ECC, CRC checksum failure, or LBA tag mismatch).</para></listitem></varlistentry>
        <varlistentry><term>num_err_log_entries (type 't')</term>
          <listitem><para>Number of Error Information Log Entries: the number of Error Information log entries over the life of the controller.</para></listitem></varlistentry>
        <varlistentry><term>temp_sensors (type 'aq')</term>
          <listitem><para>Array of the current temperature reported by temperature sensors 1-8 in Kelvins or 0 when the particular sensor is not available.</para></listitem></varlistentry>
        <varlistentry><term>wctemp (type 'q')</term>
          <listitem><para>Warning Composite Temperature Threshold (WCTEMP): indicates the minimum Composite Temperature (@SmartTemperature) value
                          that indicates an overheating condition during which controller operation continues.</para></listitem></varlistentry>
        <varlistentry><term>cctemp (type 'q')</term>
          <listitem><para>Critical Composite Temperature Threshold (CCTEMP): indicates the minimum Composite Temperature (@SmartTemperature) value
                          that indicates a critical overheating condition (e.g., may prevent continued normal operation, possibility of data loss,
                           automatic device shutdown, extreme performance throttling, or permanent damage).</para></listitem></varlistentry>
        <varlistentry><term>warning_temp_time (type 'u')</term>
          <listitem><para>Warning Composite Temperature Time: the amount of time in minutes that the Composite Temperature (@SmartTemperature) is greater
                          than or equal to the Warning Composite Temperature Threshold (@wctemp) and less than the Critical Composite Temperature Threshold
                          (@cctemp).</para></listitem></varlistentry>
        <varlistentry><term>critical_temp_time (type 'u')</term>
          <listitem><para>Critical Composite Temperature Time: the amount of time in minutes that the Composite Temperature (@SmartTemperature) is greater
                          than or equal to the Critical Composite Temperature Threshold (@cctemp).</para></listitem></varlistentry>
        </variablelist>
    -->
    <method name="SmartGetAttributes">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="attributes" direction="out" type="a{sv}"/>
    </method>

    <!--
        SmartSelftestStart:
        @type: The type test to run.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Starts a device selftest operation on all active namespaces accessible through the controller
        at the time the operation is started. A device selftest operation is a diagnostic testing
        sequence that tests the integrity and functionality of the controller and may include testing
        of the media associated with namespaces.

        The @type parameter indicates the type of test to start - valid values are
        <literal>short</literal>, <literal>extended</literal> and <literal>vendor-specific</literal>.

        Note that the method returns immediately after the test has been started
        successfully and the operation is performed in the background.
    -->
    <method name="SmartSelftestStart">
      <arg name="type" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SmartSelftestAbort:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Aborts a running device selftest.
    -->
    <method name="SmartSelftestAbort">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SanitizeStart:
        @action: The sanitize action to perform.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>overwrite_pass_count</parameter> (of type 'y'), <parameter>overwrite_pattern</parameter> (of type 'u') and <parameter>overwrite_invert_pattern</parameter> (of type 'b').
        @since: 2.10.0

        Starts a sanitize operation in the background. A sanitize operation alters all user data
        in the NVM subsystem such that recovery of any previous user data from any cache,
        the non-volatile media, or any Controller Memory Buffer is not possible. The scope
        of a sanitize operation is all locations in the NVM subsystem that are able to contain
        user data, including caches, Persistent Memory Regions, and unallocated or deallocated
        areas of the media.

        Once started, a sanitize operation is not able to be aborted and continues after
        a Controller Level Reset including across power cycles. Once the sanitize operation
        has run the media affected may not be immediately ready for use unless additional
        media modification mechanism is run. This is often vendor specific and also depends
        on the sanitize method (@action) used.

        The sanitize operation is set to be executed with the No-Deallocate After Sanitize
        feature turned on, i.e. the controller shall not deallocate any user data as a result
        of successfully completing the sanitize operation.

        The @action parameter indicates the type of the sanitize action to take - valid values are
        <literal>block-erase</literal>, <literal>overwrite</literal> and <literal>crypto-erase</literal>.

        In case of the <literal>overwrite</literal> action additional options are taken in account.
        The <literal>overwrite_pass_count</literal> option specifies number of overwrite passes (1-15)
        defaulting to 16 passes when not specified. The <literal>overwrite_pattern</literal> option
        specifies a 32-bit pattern, defaulting to zero if not specified. The <literal>overwrite_invert_pattern</literal>
        option indicates that the overwrite pattern should be inverted between passes.
    -->
    <method name="SanitizeStart">
      <arg name="action" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

  </interface>

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

  <!--
    org.freedesktop.UDisks2.NVMe.Namespace:
    @short_description: NVMe namespace device

    This interface represents a namespace device in a NVM subsystem.
  -->
  <interface name="org.freedesktop.UDisks2.NVMe.Namespace">
    <!-- NSID:
         @since: 2.10.0

         The Namespace Identifier.
    -->
    <property name="NSID" type="u" access="read"/>

    <!-- NGUID:
         @since: 2.10.0

         The Namespace Globally Unique Identifier.

         A 128-bit value that is globally unique and assigned to the namespace when the namespace
         is created. Remains fixed throughout the life of the namespace.
    -->
    <property name="NGUID" type="s" access="read"/>

    <!-- EUI64:
         @since: 2.10.0

         The IEEE Extended Unique Identifier.

         A 64-bit value that is globally unique and assigned to the namespace when the namespace
         is created. Remains fixed throughout the life of the namespace.
    -->
    <property name="EUI64" type="s" access="read"/>

    <!-- UUID:
         @since: 2.10.0

         The Namespace UUID.

         Contains a 128-bit Universally Unique Identifier (UUID) as specified in RFC 4122.
    -->
    <property name="UUID" type="s" access="read"/>

    <!-- WWN:
         @since: 2.10.0

         The <ulink
         url="http://en.wikipedia.org/wiki/World_Wide_Name">World Wide
         Name</ulink> of the namespace or blank if unknown.
    -->
    <property name="WWN" type="s" access="read"/>

    <!-- LBAFormats:
         @since: 2.10.0

         List of LBA formats supported by the controller.

         This is an array of triplets of (@size, @metadata_size, @performance) where @size
         denotes LBA Data Size in bytes, @metadata_size denotes the number of metadata bytes
         provided per LBA and @performance indicates the relative performance relative
         to other formats in the list.

         Known values for <literal>performance</literal> include:
         <variablelist>
           <varlistentry><term>0</term><listitem><para>Unknown relative performance index</para></listitem></varlistentry>
           <varlistentry><term>1</term><listitem><para>Best performance</para></listitem></varlistentry>
           <varlistentry><term>2</term><listitem><para>Better performance</para></listitem></varlistentry>
           <varlistentry><term>3</term><listitem><para>Good performance</para></listitem></varlistentry>
           <varlistentry><term>4</term><listitem><para>Degraded performance</para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="LBAFormats" type="a(qqy)" access="read"/>

    <!-- FormattedLBASize:
         @since: 2.10.0

         The actual LBA data size, the metadata size and the relative performance index
         that the namespace has been formatted with.

         Similar to #org.freedesktop.UDisks2.NVMe.Namespace:LBAFormats this is a triplet
         of (@size, @metadata_size, @performance) where @size denotes LBA Data Size
         in bytes, @metadata_size denotes the number of metadata bytes provided per LBA
         and @performance indicates the relative performance relative to other formats
         indicated in the #org.freedesktop.UDisks2.NVMe.Namespace:LBAFormats property.
    -->
    <property name="FormattedLBASize" type="(qqy)" access="read"/>

    <!-- NamespaceSize:
         @since: 2.10.0

         The total size of the namespace in logical blocks. The number of logical
         blocks is based on the formatted LBA size (see
         #org.freedesktop.UDisks2.NVMe.Namespace:FormattedLBASize).
    -->
    <property name="NamespaceSize" type="t" access="read"/>

    <!-- NamespaceCapacity:
         @since: 2.10.0

         The maximum number of logical blocks that may be allocated in the namespace.
         The number of logical blocks is based on the formatted LBA size (see
         #org.freedesktop.UDisks2.NVMe.Namespace:FormattedLBASize).
    -->
    <property name="NamespaceCapacity" type="t" access="read"/>

    <!-- NamespaceUtilization:
         @since: 2.10.0

         The current number of logical blocks allocated in the namespace. This value
         is less than or equal to the #org.freedesktop.UDisks2.NVMe.Namespace:NamespaceCapacity.
         The number of logical blocks is based on the formatted LBA size (see
         #org.freedesktop.UDisks2.NVMe.Namespace:FormattedLBASize).
    -->
    <property name="NamespaceUtilization" type="t" access="read"/>

    <!--
        FormatPercentRemaining:
        @since: 2.10.0

        The percent remaining of a running format operation or -1 if unknown (e.g. not reported by the drive).
    -->
    <property name="FormatPercentRemaining" type="i" access="read"/>

    <!--
        FormatNamespace:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>lba_data_size</parameter> (of type 'q'), <parameter>metadata_size</parameter> (of type 'q') and <parameter>secure_erase</parameter> (of type 's').
        @since: 2.10.0

        Performs low level format of the NVM media, destroying all data and metadata in the current namespace.

        The optional @lba_data_size parameter indicates the LBA Data Size in bytes to use (see the related
        #org.freedesktop.UDisks2.NVMe.Namespace:LBAFormats property) and similarly the @metadata_size parameter
        denotes the number of metadata bytes provided per LBA. If not specified, the current active format is used.

        The optional @secure_erase parameter can be used to perform secure erase - valid values are
        <literal>user_data</literal> where the user data are overwritten by a pattern, and <literal>crypto_erase</literal>
        which removes the encryption key with which the user data was previously encrypted.

        This call blocks until the format operation has finished.
    -->
    <method name="FormatNamespace">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

  </interface>

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

  <!--
    org.freedesktop.UDisks2.NVMe.Fabrics:
    @short_description: NVMe over Fabrics control interface

    Control interface for NVMe over Fabrics connected controllers.
  -->
  <interface name="org.freedesktop.UDisks2.NVMe.Fabrics">
    <!-- HostNQN:
         @since: 2.10.0

         The actual Host NQN used for the connection.
    -->
    <property name="HostNQN" type="ay" access="read"/>

    <!-- HostID:
         @since: 2.10.0

         The actual Host UUID used for the connection.
    -->
    <property name="HostID" type="ay" access="read"/>

    <!-- Transport:
         @since: 2.10.0

         The transport type the device is connected with.

         Known values include:
         <variablelist>
           <varlistentry><term>pcie</term><listitem><para>PCI Express Transport</para></listitem></varlistentry>
           <varlistentry><term>rdma</term><listitem><para>RDMA Transport</para></listitem></varlistentry>
           <varlistentry><term>fc</term><listitem><para>Fibre Channel Transport</para></listitem></varlistentry>
           <varlistentry><term>tcp</term><listitem><para>TCP Transport</para></listitem></varlistentry>
           <varlistentry><term>loop</term><listitem><para>Intra-host Transport (i.e., loopback)</para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="Transport" type="s" access="read"/>

    <!-- TransportAddress:
         @since: 2.10.0

         The network address of the controller. For transports using IP addressing (e.g. <literal>rdma</literal>)
         this should be an IP-based address (e.g. IPv4).
    -->
    <property name="TransportAddress" type="ay" access="read"/>

    <!--
        Disconnect:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Disconnects and removes the NVMe over Fabrics controller.
    -->
    <method name="Disconnect">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>
  </interface>

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

  <!--
    org.freedesktop.UDisks2.Block:
    @short_description: Block device

    This interface represents a block device.

    This should not be confused with the
    #org.freedesktop.UDisks2.Drive interface that is used to represent
    disk drives. For example, the #org.freedesktop.UDisks2.Block
    interface is also used for block devices that do not correspond to
    drives at all (e.g. <ulink
    url="http://en.wikipedia.org/wiki/Loop_device">Loop
    Devices</ulink>).
  -->
  <interface name="org.freedesktop.UDisks2.Block">
    <!-- Device: The special device file for the block device e.g. <filename>/dev/sda2</filename>. -->
    <property name="Device" type="ay" access="read"/>

    <!-- PreferredDevice:
         The special device file to present in the UI instead of the value
         of the #org.freedesktop.UDisks2.Block:Device property.

         For example this could be
         e.g. <filename>/dev/mapper/mpathk</filename> for a multipath
         device with special device file <filename>/dev/dm-9</filename>.
    -->
    <property name="PreferredDevice" type="ay" access="read"/>

    <!-- Symlinks:

         Known symlinks in <filename>/dev</filename> that points to
         the device file in the
         #org.freedesktop.UDisks2.Block:Device property.

         For example, this array could include symlinks such as
         <filename>/dev/disk/by-id/ata-INTEL_SSDSA2MH080G1GC_CVEM842101HD080DGN</filename>
         and
         <filename>/dev/disk/by-id/wwn-0x5001517387d61905</filename>.
    -->
    <property name="Symlinks" type="aay" access="read"/>

    <!-- DeviceNumber: The dev_t of the block device. -->
    <property name="DeviceNumber" type="t" access="read"/>

    <!-- Id:
         @since: 2.0.0
         A unique and persistent identifier for the device or blank if
         no such identifier is available.

         For devices with fixed media, this identifier is derived from
         vital product data / UUIDs / serial numbers of the drive or
         construct (e.g. LVM or MD-RAID) the block device is part
         of. For devices with removable media, this identifier is
         derived from the medium currently inserted.

         This identifier is guaranteed to not include the slash
         character '/' (U+002F SOLIDUS) which means it can be used as
         a filename.

         Examples:
         <quote>by-id-ata-INTEL_SSDSA2MH080G1GC_CVEM842101HD080DGN</quote>,
         <quote>by-id-ata-ST1000LM024_HN-M101MBB_S2TBJA0C230233-part3</quote>,
         <quote>by-id-usb-Kingston_DataTraveler_2.0_0013729940C4F9A166250D3E-0:0</quote>,
         <quote>by-id-dm-name-luks-6d81fe85-26b1-4f8b-b834-405454c1cd46</quote>,
         <quote>by-id-dm-name-vg_thinkpad-lv_swap</quote>,
         <quote>by-label-HARRY_POTTER_SORCERERS_STONE-</quote>,
         <quote>by-uuid-D22D-08B8</quote>.
    -->
    <property name="Id" type="s" access="read"/>

    <!-- Size: The size of the block device. -->
    <property name="Size" type="t" access="read"/>

    <!-- ReadOnly: If %TRUE, the device can not be written to, only read from. -->
    <property name="ReadOnly" type="b" access="read"/>

    <!-- Drive:
         The #org.freedesktop.UDisks2.Drive object that the block device
         belongs to, or '/' if no such object exists.
      -->
    <property name="Drive" type="o" access="read"/>

    <!-- MDRaid:
         @since: 2.0.0
         If the block device is a running MD-RAID array, this is set
         to the #org.freedesktop.UDisks2.MDRaid object that it
         correspond to. Is '/' if no such object exists.
      -->
    <property name="MDRaid" type="o" access="read"/>

    <!-- MDRaidMember:
         @since: 2.0.0
         If the block device is a member of a MD-RAID array, this
         is set to the #org.freedesktop.UDisks2.MDRaid object that it
         correspond to. Is '/' if no such object exists.
      -->
    <property name="MDRaidMember" type="o" access="read"/>

    <!-- IdUsage:
         A result of probing for signatures on the block device. Known values include:
         <variablelist>
         <varlistentry>
           <term>filesystem</term>
           <listitem><para>Used for mountable filesystems</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>crypto</term>
           <listitem><para>Used for e.g. LUKS devices</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>raid</term>
           <listitem><para>Used for e.g. RAID members and LVM PVs</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>other</term>
           <listitem><para>Something else was detected.</para></listitem>
         </varlistentry>
         </variablelist>
         If blank, no known signature was detected. This doesn't
         necessarily mean the device contains no structured data; it
         only means that no signature known to the probing code was
         detected.

         Applications should not rely on the value in this or the
         #org.freedesktop.UDisks2.Block:IdType property - instead,
         applications should check for whether the object in question
         implements interfaces such as
         e.g. #org.freedesktop.UDisks2.Filesystem,
         #org.freedesktop.UDisks2.Swapspace or
         #org.freedesktop.UDisks2.Encrypted.
    -->
    <property name="IdUsage" type="s" access="read"/>

    <!--
        IdType:
        This property contains more information about the result of
        probing the block device. Its value depends of the value the
        #org.freedesktop.UDisks2.Block:IdUsage property:
        <variablelist>
        <varlistentry><term>filesystem</term>
          <listitem><para>The mountable file system that was detected (e.g. <literal>vfat</literal>).</para></listitem>
        </varlistentry>
        <varlistentry><term>crypto</term>
          <listitem><para>Encrypted data. Known values include <literal>crypto_LUKS</literal>.</para></listitem>
        </varlistentry>
        <varlistentry><term>raid</term>
          <listitem><para><ulink url="http://en.wikipedia.org/wiki/RAID">RAID</ulink> or similar. Known values include <literal>LVM2_member</literal> (for LVM2 components), <literal>linux_raid_member</literal> (for MD-RAID components.)</para></listitem>
        </varlistentry>
        <varlistentry><term>other</term>
          <listitem><para>Something else. Known values include <literal>swap</literal> (for swap space), <literal>suspend</literal> (data used when resuming from suspend-to-disk.</para></listitem>
        </varlistentry>
        </variablelist>
        See the note for the #org.freedesktop.UDisks2.Block:IdUsage property about usage.
    -->
    <property name="IdType" type="s" access="read"/>

    <!-- IdVersion:
         The version of the filesystem or other structured data on the block device.
         Do not make any assumptions about the format.

         This property is blank if there is no version or the version is unknown.
    -->
    <property name="IdVersion" type="s" access="read"/>
    <!-- IdLabel:
         The label of the filesystem or other structured data on the block device.

         This property is blank if there is no label or the label is unknown.
    -->
    <property name="IdLabel" type="s" access="read"/>
    <!-- IdUUID:
         The <ulink url="http://en.wikipedia.org/wiki/UUID">UUID</ulink> of the
         filesystem or other structured data on the block device. Do not make
         any assumptions about the UUID as its format depends on what kind of
         data is on the device.

         This property is blank if there is no UUID or the UUID is unknown.
    -->
    <property name="IdUUID" type="s" access="read"/>

    <!-- Configuration:
         The configuration for the device.

         This is an array of pairs of (@type, @details) where @type is
         a string identifying the configuration source
         (e.g. <literal>fstab</literal>) and @details contains the
         actual configuration data.

         Use the
         org.freedesktop.UDisks2.Block.AddConfigurationItem(),
         org.freedesktop.UDisks2.Block.RemoveConfigurationItem()
         and
         org.freedesktop.UDisks2.Block.UpdateConfigurationItem()
         methods to add, remove and update configuration items.

         Use
         org.freedesktop.UDisks2.Block.GetSecretConfiguration()
         to get the secrets (e.g. passphrases) that may be part of the
         configuration but isn't exported in this property for
         security reasons.

         For entries of type <literal>fstab</literal>, it means that
         the block device is referenced in the system-wide
         <filename>/etc/fstab</filename> file. Known configuration
         items for type <literal>fstab</literal> are
         <variablelist>
         <varlistentry>
           <term>fsname (type <literal>'ay'</literal>)</term>
           <listitem><para>The special device</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>dir (type <literal>'ay'</literal>)</term>
           <listitem><para>The mount point</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>type (type <literal>'ay'</literal>)</term>
           <listitem><para>The filesystem type</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>opts (type <literal>'ay'</literal>)</term>
           <listitem><para>Options</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>freq (type <literal>'i'</literal>)</term>
           <listitem><para>Dump frequency in days</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>passno (type <literal>'i'</literal>)</term>
           <listitem><para>Pass number of parallel fsck</para></listitem>
         </varlistentry>
         </variablelist>

         For entries of type <literal>crypttab</literal>, it means that
         the block device is referenced in the system-wide
         <filename>/etc/crypttab</filename> file. Known configuration
         items for type <literal>crypttab</literal> are
         <variablelist>
         <varlistentry>
           <term>name (type <literal>'ay'</literal>)</term>
           <listitem><para>The name to set the device up as</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>device (type <literal>'ay'</literal>)</term>
           <listitem><para>The special device</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>passphrase-path (type <literal>'ay'</literal>)</term>
           <listitem><para>Either empty to specify that no password is set,
           otherwise a path to a file containing the encryption password.
           This may also point to a special device file in <filename>/dev</filename>
           such as <literal>/dev/random</literal>.
           </para></listitem>
         </varlistentry>
         <varlistentry>
           <term>passphrase-contents (type <literal>'ay'</literal>)</term>
           <listitem><para>The contents of the file containing the encryption password, if applicable.
           This is only available via the org.freedesktop.UDisks2.Block.GetSecretConfiguration()
           method.</para></listitem>
         </varlistentry>
         <varlistentry>
           <term>options (type <literal>'ay'</literal>)</term>
           <listitem><para>Options</para></listitem>
         </varlistentry>
         </variablelist>
         For security reasons, when creating a new
         <literal>crypttab</literal> entry (via the
         org.freedesktop.UDisks2.Block.AddConfigurationItem()
         method), then the <option>passphrase-path</option> must
         reference an unexisting file in the
         <filename>/etc/luks-keys</filename> directory.
    -->
    <property name="Configuration" type="a(sa{sv})" access="read"/>

    <!-- CryptoBackingDevice:
         The #org.freedesktop.UDisks2.Block object that is
         backing the device or <literal>/</literal> if unknown or if
         the block device is not the cleartext device for an encrypted
         device.
    -->
    <property name="CryptoBackingDevice" type="o" access="read"/>

    <!-- HintPartitionable:
         If %TRUE, the device is normally expected to be
         partitionable. Devices for which this is not the case include
         floppy drives, optical drives and LVM logical volumes.
    -->
    <property name="HintPartitionable" type="b" access="read"/>

    <!-- HintSystem: If %TRUE, the device is considered a <emphasis>system device</emphasis>.
         System devices are devices that require additional permissions to access.

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="HintSystem" type="b" access="read"/>

    <!-- HintIgnore: If %TRUE, the device should be hidden from users.

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="HintIgnore" type="b" access="read"/>

    <!-- HintAuto: If %TRUE, the device should be automatically started (e.g. mounted, unlocked etc.).

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="HintAuto" type="b" access="read"/>

    <!-- HintName: If not blank, the name to use when presenting the device.

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="HintName" type="s" access="read"/>

    <!-- HintIconName: If not blank, the icon name to use when presenting the device.
         The name must adhere to the
         <ulink url="http://www.freedesktop.org/wiki/Specifications/icon-theme-spec">freedesktop.org icon theme specification</ulink>.

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="HintIconName" type="s" access="read"/>

    <!-- HintSymbolicIconName:
         @since: 2.0.0
         If not blank, the icon name to use when presenting the device using a symbolic icon.

         The name must adhere to the
         <ulink url="http://www.freedesktop.org/wiki/Specifications/icon-theme-spec">freedesktop.org icon theme specification</ulink>.

         See <xref linkend="udisks.8"/> for how to influence the value of this property.
    -->
    <property name="HintSymbolicIconName" type="s" access="read"/>

    <!-- UserspaceMountOptions: List of userspace mount options. -->
    <property name="UserspaceMountOptions" type="as" access="read"/>

    <!--
        AddConfigurationItem:
        @item: The configuration item to add.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Adds a new configuration item.

        See the #org.freedesktop.UDisks2.Block:Configuration
        property for details about valid configuration items.

        Some fields can be omitted and will then receive default
        values.  This is useful when passing configuration items to
        Format, for example, because the proper values are not known
        before the formatting is done.

        If 'fsname' is omitted in a 'fstab' entry, or 'device' is
        omitted in a 'crypttab' entry, it defaults to "UUID=..." when
        the block device has a filesystem UUID, or to the name of the
        device in the filesystem..

        If 'name' is omitted in a 'crypttab' entry, it defaults to
        "luks-&lt;UUID&gt;".

        If 'passphrase-path' is omitted, it defaults to
        "/etc/luks-keys/&lt;NAME&gt;".

        If 'track-parents' is set to true in @item, then the 'opts'
        and 'options' fields will be augmented with "x-parent"
        elements, as appropriate.  This will make @item appear in the
        ChildConfiguration properties, and will allow the 'tear-down'
        option of Format, DeletePartition, and other methods to remove
        this item reliably.
    -->
    <method name="AddConfigurationItem">
      <arg name="item" direction="in" type="(sa{sv})"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        RemoveConfigurationItem:
        @item: The configuration item to remove.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Removes an existing configuration item.

        See the #org.freedesktop.UDisks2.Block:Configuration
        property for details about valid configuration items.
    -->
    <method name="RemoveConfigurationItem">
      <arg name="item" direction="in" type="(sa{sv})"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        UpdateConfigurationItem:
        @old_item: The configuration item to remove.
        @new_item: The configuration item to add. Must be of the same type as @old_item.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Removes a configuration item and adds a new one. This is
        equivalent to calling
        org.freedesktop.UDisks2.Block.RemoveConfigurationItem()
        followed by
        org.freedesktop.UDisks2.Block.AddConfigurationItem()
        with the change that only one PolicyKit check is made
        and that @new_item can be validated against @old_item.

        See the #org.freedesktop.UDisks2.Block:Configuration
        property for details about valid configuration items.
    -->
    <method name="UpdateConfigurationItem">
      <arg name="old_item" direction="in" type="(sa{sv})"/>
      <arg name="new_item" direction="in" type="(sa{sv})"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        GetSecretConfiguration:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @configuration: The resulting configuration.

        Returns the same value as in the
        #org.freedesktop.UDisks2.Block:Configuration property
        but without secret information filtered out.
    -->
    <method name="GetSecretConfiguration">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="configuration" direction="out" type="a(sa{sv})"/>
    </method>

    <!--
        Format:
        @type: The type of file system, partition table or other content to format the device with.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>label</parameter> (of type 's'), <parameter>uuid</parameter> (of type 's'), <parameter>take-ownership</parameter> (of type 'b'), <parameter>encrypt.passphrase</parameter> (of type 's' or 'ay'), <parameter>encrypt.type</parameter> (of type 's'), <parameter>erase</parameter> (of type 's'), <parameter>mkfs-args</parameter> (of type 'as'), <parameter>no-block</parameter> (of type 'b') and <parameter>update-partition-type</parameter> (of type 'b').

        Formats the device with a file system, partition table or
        other well-known content.

        Known values for @type includes <constant>empty</constant> (to
        just zero out areas of the device known to host file system
        signatures) and <constant>swap</constant> (Linux swap space)
        and most file systems supported by the <citerefentry><refentrytitle>mkfs</refentrytitle><manvolnum>8</manvolnum></citerefentry>
        program through its <option>-t</option> option.

        Known partition table formats includes
        <constant>dos</constant> and <constant>gpt</constant>.

        If @type supports it, you can specify a label with the
        <parameter>label</parameter> option in the @options parameter;
        however, note that this may not be supported on all file
        systems and, if supported, the maximum allowed length may
        vary. Similarly, you can specify filesystem UUID with the
        <parameter>uuid</parameter> option in the @options parameter
        given that the particular filesystem type supports this feature.
        The format of the UUID string should match the #org.freedesktop.UDisks2.Block:IdUUID
        property.

        If the file system in question supports owners and the option
        <parameter>take-ownership</parameter> is set to %TRUE then the
        root directory of the created file system will be owned by the
        caller of this method.

        If the option <parameter>encrypt.passphrase</parameter> is
        given then a LUKS device is created with the given passphrase
        and the file system is created on the unlocked device. The
        unlocked device will be left open. This parameter can be used
        to supply the binary contents of an arbitrary keyfile by passing
        a value of type <quote>ay</quote>.
        Option <parameter>encrypt.type</parameter> can be used to
        specify encryption "technology" that will be used. Currently
        only <quote>luks1</quote> and <quote>luks2</quote> are supported.

        If the option <parameter>erase</parameter> is used then the
        underlying device will be erased. Valid values include
        <quote>zero</quote> to write zeroes over the entire device
        before formatting, <quote>ata-secure-erase</quote> to perform
        a secure erase or <quote>ata-secure-erase-enhanced</quote> to
        perform an enhanced secure erase.

        If the option <parameter>update-partition-type</parameter> is
        set to %TRUE and the object in question is a partition, then
        its type (cf. the #org.freedesktop.UDisks2.Partition:Type
        property) will be set to the <emphasis>natural</emphasis>
        partition type matching @type, if any. For example, if
        formatting a GPT partition with a FAT filesystem, the
        <quote>Microsoft Basic Data</quote> partition type will be
        chosen; similar, if formatting a DOS partition with a Ext4
        filesystem then partition type 0x83 is chosen.

        If the option <parameter>no-block</parameter> is set to %TRUE
        then the method returns just before the actual formatting
        takes place but after authorization and other checks are
        done. This is useful for applications that want to format
        several devices in parallel.

        If the option <parameter>dry-run-first</parameter> is set to
        %TRUE then a dry run of the formatting command is performed
        first, if UDisks knows how to do that.  The idea is that
        this allows a deeper check of the parameters even when
        <parameter>no-block</parameter> is %TRUE. Note that the block
        device has already been modified (wiped) when the dry run
        check is called.

        If the option <parameter>mkfs-args</parameter> is set then the
        caller can provide a list of additional command-line arguments
        that will be passed to the mkfs program. The arguments
        specified in this way are not validated by UDisks, and the
        user is responsible for making sure that the available mkfs
        program for that filesystem supports them and that they work
        for the intended purpose. Note that UDisks can also pass its
        own additional arguments to mkfs, and they may vary between
        releases, with no guarantees of stability in this regard. The
        position in which the user-provided arguments are appended to
        the final mkfs command line is also not defined. Because of
        all this, <parameter>mkfs-args</parameter> should only be used
        as a last resort when no other dedicated option is available.

        If the option <parameter>no-discard</parameter> is set to
        %TRUE then Udisks tells the formatting utility not to issue
        BLKDISCARD ioctls.

        If the option <parameter>config-items</parameter> is set, it
        should be an array of configuration items suitable for
        org.freedesktop.UDisks2.Block.AddConfigurationItem.  They will
        all be added after the formatting is done.

        If the option <parameter>tear-down</parameter> is set to
        %TRUE, then the block device and all its children will be
        cleaned up before formatting.  This cleanup consists of
        removing entries from /etc/fstab and /etc/crypttab, and
        locking of encrypted block devices.  Entries in /etc/fstab and
        /etc/crypttab that have been created with the 'track-parents'
        options to AddConfigurationItem will be removed even if their
        block device is currently unavailable.

        Note that if the operation fails the block device may be left
        in an inconsistent state. In cases of removing partition table
        and failed operation it's advised to validate the device e.g.
        by re-reading the partition table or force-wiping it before
        performing further operations.

        In case the <parameter>tear-down</parameter> option is not set
        and the block device being formatted is partitioned and
        contains mounted filesystem or an active layered structure
        inside then the Format operation may not fail, yet could still
        overwrite nested foreign data regions. It is the caller
        responsibility to ensure the device is ready for destructive
        operations. This may be subject to further restrictions
        in the future.
    -->
    <method name="Format">
      <arg name="type" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        OpenForBackup:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @fd: An index for the returned file descriptor.

        Gets a read-only file descriptor for the device intended for a
        byte-by-byte imaging of the device. This can only be done if
        the device is not already in use.

        <emphasis>This method is deprecated since 2.7.3.</emphasis>
        Use org.freedesktop.UDisks2.Block.OpenDevice() with <literal>O_EXCL</literal>
        and <literal>O_CLOEXEC</literal> flags instead.
    -->
    <method name="OpenForBackup">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="1"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="fd" direction="out" type="h"/>
    </method>

    <!--
        OpenForRestore:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @fd: An index for the returned file descriptor.

        Gets a writable file descriptor for the device intended for a
        byte-by-byte restore of a disk image onto the device. This can
        only be done if the device is not already in use.

        <emphasis>This method is deprecated since 2.7.3.</emphasis>
        Use org.freedesktop.UDisks2.Block.OpenDevice() with <literal>O_EXCL</literal>,
        <literal>O_SYNC</literal> and <literal>O_CLOEXEC</literal> flags instead.

    -->
    <method name="OpenForRestore">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="1"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="fd" direction="out" type="h"/>
    </method>

    <!--
        OpenForBenchmark:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @fd: An index for the returned file descriptor.

        Gets a file descriptor for the device that is suitable to be
        used for benchmarking the device (transfer rate, access time
        etc.). Note that the file descriptor may be opened with the
        <literal>O_DIRECT</literal> and <literal>O_SYNC</literal>
        flags so care must be taken to only perform block-aligned I/O.

        If the <parameter>writable</parameter> in @options is %TRUE
        then the returned file descriptor will be writable. This only
        works if the device is not already in use.

        <emphasis>This method is deprecated since 2.7.3.</emphasis>
        Use org.freedesktop.UDisks2.Block.OpenDevice() with <literal>O_DIRECT</literal>,
        <literal>O_SYNC</literal> and <literal>O_CLOEXEC</literal> flags instead.
    -->
    <method name="OpenForBenchmark">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="1"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="fd" direction="out" type="h"/>
    </method>

    <!--
        OpenDevice:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>flags</parameter> (of type 'i')
        @mode: Mode: "r" for read-only, "w" for write-only or "rw" for read-write
        @fd: An index for the returned file descriptor.
        @since: 2.7.3

        Option <parameter>flags</parameter> can be used to specify additional flags.
        See <literal>man 2 open</literal> for list of supported flags.
        <literal>O_RDONLY</literal>, <literal>O_WRONLY</literal> and
        <literal>O_RDWR</literal> are not allowed, use @mode instead.

        Gets a file descriptor for the device.
    -->
    <method name="OpenDevice">
      <annotation name="org.gtk.GDBus.C.UnixFD" value="1"/>
      <arg name="mode" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="fd" direction="out" type="h"/>
    </method>

    <!--
        Rescan:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Request that the kernel and core OS rescans the contents of
        the device and update their state to reflect this (including
        things such as the <filename>/dev/disk/</filename> hierarchy
        of symlinks). This includes requesting that the kernel
        re-reads the partition table, if appropriate.

        This is usually not needed since the OS automatically does
        this when the last process with a writable file descriptor for
        the device closes it.
    -->
    <method name="Rescan">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

  </interface>

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

  <!--
      org.freedesktop.UDisks2.PartitionTable:
      @short_description: Block device containing a partition table

      This interface is used for #org.freedesktop.UDisks2.Block
      devices that contain a partition table.
  -->
  <interface name="org.freedesktop.UDisks2.PartitionTable">
    <!-- prereq: org.freedesktop.UDisks2.Block -->

    <!-- Partitions: List of object paths of the #org.freedesktop.UDisks2.Partition
         objects that belongs to this partition table.
         @since: 2.7.2
    -->
    <property name="Partitions" type="ao" access="read"/>

    <!-- Type: The type of partition table detected.
         Known values include:
         <variablelist>
           <varlistentry><term>dos</term><listitem><para><ulink url="http://en.wikipedia.org/wiki/Master_Boot_Record">Master Boot Record</ulink></para></listitem></varlistentry>
           <varlistentry><term>gpt</term><listitem><para><ulink url="http://en.wikipedia.org/wiki/GUID_Partition_Table">GUID Partition Table</ulink></para></listitem></varlistentry>
         </variablelist>
         If blank it means that a partition table was detected but its
         scheme is unknown.
    -->
    <property name="Type" type="s" access="read"/>

    <!--
        CreatePartition:
        @offset: The desired offset where the partition should be created, in bytes.
        @size: The desired size of the partition, in bytes (0 for maximal size).
        @type: The type of partition to create (cf. the #org.freedesktop.UDisks2.Partition:Type property) or blank to use the default for the partition table type and OS.
        @name: The name for the new partition or blank if the partition table do not support names.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) include <parameter>partition-type</parameter> (of type 's') and <parameter>partition-uuid</parameter> (of type 's').
        @created_partition: An object path to the created block device object implementing the #org.freedesktop.UDisks2.Partition interface.

        Creates a new partition.

        Note that the created partition won't necessarily be created
        at the exact @offset but slightly behind due to disk geometry
        and other alignment constraints (e.g. 1MiB alignment).

        The newly created partition may also end up being slightly
        larger than the requested @size bytes for the same reasons.
        The maximal size can be automatically set by using 0 as size.

        For <literal>dos</literal> partition tables, the partition type can be
        set with the @partition-type option. Possible values are: "primary",
        "extended" or "logical".

        An optional parameter <parameter>partition-uuid</parameter> denotes
        the partition UUID to set for the newly created partition (GPT only).

        The newly created partition will be wiped of known filesystem
        signatures using the
        <citerefentry><refentrytitle>wipefs</refentrytitle><manvolnum>8</manvolnum></citerefentry>
        command.
    -->
    <method name="CreatePartition">
      <arg name="offset" direction="in" type="t"/>
      <arg name="size" direction="in" type="t"/>
      <arg name="type" direction="in" type="s"/>
      <arg name="name" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="created_partition" direction="out" type="o"/>
    </method>

    <!--
        CreatePartitionAndFormat:
        @offset: The desired offset where the partition should be created, in bytes.
        @size: The desired size of the partition, in bytes (0 for maximal size).
        @type: The type of partition to create (cf. the #org.freedesktop.UDisks2.Partition:Type property) or blank to use the default for the partition table type and OS.
        @name: The name for the new partition or blank if the partition table do not support names.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) include <parameter>partition-type</parameter> (of type 's') and <parameter>partition-uuid</parameter> (of type 's').
        @created_partition: An object path to the created block device object implementing the #org.freedesktop.UDisks2.Partition interface.
        @format_type: The type to use for Format.
        @format_options: Options for Format.

        This is a combination of
        #org.freedesktop.UDisks2.PartitionTable:CreatePartition and
        #org.freedesktop.UDisks2.Block:Format.  After creating the
        partition, the resulting block device is formatted.
    -->
    <method name="CreatePartitionAndFormat">
      <arg name="offset" direction="in" type="t"/>
      <arg name="size" direction="in" type="t"/>
      <arg name="type" direction="in" type="s"/>
      <arg name="name" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="format_type" direction="in" type="s"/>
      <arg name="format_options" direction="in" type="a{sv}"/>
      <arg name="created_partition" direction="out" type="o"/>
    </method>

  </interface>

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

  <!--
      org.freedesktop.UDisks2.Partition:
      @short_description: Block device representing a partition

      This interface is used for #org.freedesktop.UDisks2.Block
      devices that represent entries in a partition table.
  -->
  <interface name="org.freedesktop.UDisks2.Partition">
    <!-- prereq: org.freedesktop.UDisks2.Block -->

    <!-- Number: The number of the partition in the partition table. -->
    <property name="Number" type="u" access="read"/>

    <!-- Type: The type of the partition.

         For <literal>dos</literal> partition tables, this string is a
         hexadecimal number e.g. <literal>0x83</literal> or
         <literal>0xfd</literal>. For <literal>gpt</literal> partition
         tables this is the UUID
         e.g. <literal>ebd0a0a2-b9e5-4433-87c0-68b6b72699c7</literal>.
    -->
    <property name="Type" type="s" access="read"/>

    <!-- Flags: Flags describing the partition.

         Known flags for <literal>dos</literal> partitions include:
         <variablelist>
           <varlistentry><term>Bit 7</term><listitem><para>The partition is marked as bootable</para></listitem></varlistentry>
         </variablelist>
         Known flags for <literal>gpt</literal> partitions include:
         <variablelist>
           <varlistentry><term>Bit 0</term><listitem><para>System partition</para></listitem></varlistentry>
           <varlistentry><term>Bit 2</term><listitem><para>Legacy BIOS Bootable</para></listitem></varlistentry>
           <varlistentry><term>Bit 60</term><listitem><para>Read-only</para></listitem></varlistentry>
           <varlistentry><term>Bit 62</term><listitem><para>Hidden</para></listitem></varlistentry>
           <varlistentry><term>Bit 63</term><listitem><para>Do not automount</para></listitem></varlistentry>
         </variablelist>
    -->
    <property name="Flags" type="t" access="read"/>

    <!-- Offset: Offset of partition, in bytes. -->
    <property name="Offset" type="t" access="read"/>

    <!-- Size: Size of partition, in bytes. -->
    <property name="Size" type="t" access="read"/>

    <!-- Name: Label of partition or blank if not supported or unknown. -->
    <property name="Name" type="s" access="read"/>

    <!-- UUID: The UUID of the partition or blank if not supported or unknown. -->
    <property name="UUID" type="s" access="read"/>

    <!-- Table:
         The object path of the #org.freedesktop.UDisks2.PartitionTable
         object that the partition entry belongs to.
    -->
    <property name="Table" type="o" access="read"/>

    <!-- IsContainer:
         Set to %TRUE if the partition itself is a container for other
         partitions.

         For example, for <literal>dos</literal> partition tables,
         this applies to socalled <emphasis>extended partition</emphasis> (partitions of type
         <constant>0x05</constant>, <constant>0x0f</constant> or <constant>0x85</constant>)
         containing socalled <emphasis>logical partitions</emphasis>.
    -->
    <property name="IsContainer" type="b" access="read"/>

    <!-- IsContained:
         Set to %TRUE of the partition is contained in another partition.
         See the #org.freedesktop.UDisks2.Partition:IsContainer property for more information.
    -->
    <property name="IsContained" type="b" access="read"/>

    <!-- SetType:
         @type: New type to set.
         @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

         Sets the partition type. See the
         #org.freedesktop.UDisks2.Partition:Type property for a
         description of known partition types.
    -->
    <method name="SetType">
      <arg name="type" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- SetName:
         @name: New name to set.
         @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

         Sets the partition name (label).
    -->
    <method name="SetName">
      <arg name="name" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetUUID:
        @uuid: The UUID to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Sets the partition UUID (GPT only).
    -->
    <method name="SetUUID">
      <arg name="uuid" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- SetFlags:
         @flags: New flags to set.
         @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

         Sets the partition flags. See the
         #org.freedesktop.UDisks2.Partition:Flags property for a
         description of known flags.
    -->
    <method name="SetFlags">
      <arg name="flags" direction="in" type="t"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- Resize:
         @size: New partition size in bytes, 0 for maximal size.
         @options: Options.
         @since: 2.7.2

         Resizes the partition.

         The partition will not change its position but might be slightly bigger
         than requested due to sector counts and alignment (e.g. 1MiB).
         If the requested size can't be allocated it results in an error.
         The maximal size can automatically be set by using 0 as size.
    -->
    <method name="Resize">
      <arg name="size" direction="in" type="t"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- Delete:
         @options: Options.

         Deletes the partition.

         If the option <parameter>tear-down</parameter> is set to
         %TRUE, then the block device and all its children will be
         cleaned up before formatting.  This cleanup consists of
         removing entries from /etc/fstab and /etc/crypttab, and
         locking of encrypted block devices.  Entries in /etc/fstab
         and /etc/crypttab that have been created with the
         'track-parents' options to AddConfigurationItem will be
         removed even if their block device is currently unavailable.
    -->
    <method name="Delete">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>
  </interface>

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

  <!--
      org.freedesktop.UDisks2.Filesystem:
      @short_description: Block device containing a mountable filesystem

      This interface is used for #org.freedesktop.UDisks2.Block
      devices that contain a mountable filesystem.
  -->
  <interface name="org.freedesktop.UDisks2.Filesystem">
    <!-- prereq: org.freedesktop.UDisks2.Block -->

    <!--
        SetLabel:
        @label: The label to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Sets the filesystem label.
    -->
    <method name="SetLabel">
      <arg name="label" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetUUID:
        @uuid: The UUID to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Sets the filesystem UUID value.
    -->
    <method name="SetUUID">
      <arg name="uuid" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- MountPoints:
         An array of filesystems paths for where the file system on
         the device is mounted. If the device is not mounted, this
         array is empty.
    -->
    <property name="MountPoints" type="aay" access="read"/>

    <!--
        Mount:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>fstype</parameter> (of type 's'), <parameter>as-user</parameter> (of type 's') and <parameter>options</parameter> (of type 's').
        @mount_path: The filesystem path where the device was mounted.

        Mounts the filesystem.

        The directory the filesystem will be mounted in is determined
        by looking at data related to the device or filesystem (such
        the filesystem UUID and label) and will be created
        automatically except if the device the filesystem resides on
        is referenced in the <filename>/etc/fstab</filename> file, see
        below. In either case, the directory the filesystem is mounted
        in, is returned in @mount_path on success - it is usually a
        sub-directory of <filename
        class='directory'>/run/media/$USER</filename> but note that
        any directory may be returned.

        The filesystem type to use can be overridden with the @fstype
        option and mount options (a comma-separated string) can be
        given in @options option. Note that both the mount options and
        filesystem types are validated against a (small) whitelist to
        avoid unexpected privilege escalation. The filesystem type is
        by default determined by the #org.freedesktop.UDisks2.Block:IdType
        property. The @fstype option doesn't typically need to be
        specified, primarily intended as an override in corner cases.

        If the <parameter>as-user</parameter> option is set, the
        filesystem is mounted on behalf of the specified user instead
        of the calling one. This has usually an effect on the returned
        @mount_path and it also allows that user to unmount the
        filesystem later. This option expects a user name, not a UID.

        If the device in question is referenced in the
        <filename>/etc/fstab</filename> file, the
        <command>mount</command> command is called directly (as root)
        and the given options or filesystem type given in @options are
        ignored.

        If <literal>x-udisks-auth</literal> is specified as an option
        for the device in the <filename>/etc/fstab</filename> file,
        then the <command>mount</command> command is run as the
        calling user, without performing any authorization check
        mentioned above. If this fails because of insufficient
        permissions, an authorization check is performed (which
        typically results in the user having to authenticate as an
        administrator). If authorized, the <command>mount</command>
        command is then run as root.

        The filesystem should be unmounted using the
        org.freedesktop.UDisks2.Filesystem.Unmount() method.

        If the device is removed without being unmounted (e.g. the
        user yanking the device or pulling the media out) or unmounted
        in a way that bypasses the
        org.freedesktop.UDisks2.Filesystem.Unmount() method
        (e.g. unmounted by the super-user by using the
        <citerefentry><refentrytitle>umount</refentrytitle><manvolnum>8</manvolnum></citerefentry>
        command directly), the device will be unmounted (if needed)
        and/or the mount point will be cleaned up.
    -->
    <method name="Mount">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="mount_path" direction="out" type="s"/>
    </method>

    <!--
        Unmount:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>force</parameter> (of type 'b').

        Unmount a mounted device.

        If the device in question was mounted by the calling user
        via the org.freedesktop.UDisks2.Filesystem.Mount() method the
        filesystem is unmounted without any authorization checks.
        Otherwise, an authorization check is performed (which
        typically results in the user having to authenticate as an
        administrator). If authorized, the filesystem is unmounted.

        If the mountpoint was previously created by udisks it is
        guaranteed it will be removed upon returning from this method
        call.

        If the filesystem is busy, this operation fails with the error
        <link linkend="UDISKS-ERROR-DEVICE-BUSY:CAPS"><constant>org.freedesktop.UDisks2.Error.DeviceBusy</constant></link>
        unless the @force option is used.
    -->
    <method name="Unmount">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- Size: The size of the filesystem.  This is the amount of
         bytes used on the block device representing an outer filesystem
         boundary. If this is smaller than org.freedesktop.Udisks2.Block.Size,
         then the filesystem can be made larger with Resize.

         If the size is unknown, the property is zero. Currently limited
         to xfs and ext filesystems only.

         Please note that reading value of this property typically causes
         some I/O to read the filesystem superblock. Unlike the rest
         of the properties this one is set to be retrieved on-demand
         and is not proactively cached by the daemon.
    -->
    <property name="Size" type="t" access="read"/>

    <!--
        Resize:
        @size: The target size in bytes, 0 for maximum.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.7.2

        Resizes the filesystem.

        Shrinking operations need to move data which causes this action to be
        slow. The filesystem-resize job for the object might expose progress.
    -->
    <method name="Resize">
      <arg name="size" direction="in" type="t"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- Check:
         @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
         @consistent: Whether the filesystem is undamaged.
         @since: 2.7.2

         Checks the filesystem for consistency avoiding any modifications or repairs.

         Mounted or unsupported filesystems will result in an error.
    -->
    <method name="Check">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="consistent" direction="out" type="b"/>
    </method>

    <!-- Repair:
         @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
         @repaired: Whether the filesystem could be successfully repaired.
         @since: 2.7.2

         Tries to repair the filesystem.

         Mounted or unsupported filesystems will result in an error.
    -->
    <method name="Repair">
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="repaired" direction="out" type="b"/>
    </method>

    <!-- TakeOwnership:
         @options: Options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>recursive</parameter> (of type 'b').
         @since: 2.7.2

         Changes ownership of the filesystem to the UID and GID of the calling
         user.

         Filesystems that don't support ownership result in an error.
    -->
    <method name="TakeOwnership">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>
  </interface>

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

  <!--
      org.freedesktop.UDisks2.Swapspace:
      @short_description: Block device containing swap data

      This interface is used for #org.freedesktop.UDisks2.Block
      devices that contain swap space.
  -->
  <interface name="org.freedesktop.UDisks2.Swapspace">
    <!-- prereq: org.freedesktop.UDisks2.Block -->

    <!-- Active: Set to %TRUE if the device is currently in use by the OS. -->
    <property name="Active" type="b" access="read"/>

    <!--
        Start:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Activates the swap device.
    -->
    <method name="Start">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        Stop:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Deactivates the swap device.
    -->
    <method name="Stop">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetLabel:
        @label: The label to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Set label for the swap device.
    -->
    <method name="SetLabel">
      <arg name="label" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetUUID:
        @uuid: The UUID to set.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).
        @since: 2.10.0

        Set UUID for the swap device.
    -->
    <method name="SetUUID">
      <arg name="uuid" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>
  </interface>

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

  <!--
      org.freedesktop.UDisks2.Encrypted:
      @short_description: Block device containing encrypted data

      This interface is used for #org.freedesktop.UDisks2.Block
      devices that contain encrypted data.
  -->
  <interface name="org.freedesktop.UDisks2.Encrypted">
    <!-- prereq: org.freedesktop.UDisks2.Block -->

    <!-- ChildConfiguration: Configuration items belonging to the
         clear text device of this encrypted block device and its
         children.  This is also valid when this block device is
         currently locked and there is no clear text device for it.
         It works via the 'track-parents' options of
         org.freedesktop.UDisks2.Block.AddConfigurationItem(), which
         see.
    -->
    <property name="ChildConfiguration" type="a(sa{sv})" access="read"/>

    <!-- HintEncryptionType:
         If not blank, the type of the encryption used to encrypt this device.

         This is set during successful unlocking of an encrypted device.
         It is required for encryption types which can only be determined
         by decrypting the device (for example TCRYPT), but is used for all
         encryption types for consistency reasons.
    -->
    <property name="HintEncryptionType" type="s" access="read"/>

    <!-- MetadataSize: Size of the metadata on the encrypted device in bytes
    -->
    <property name="MetadataSize" type="t" access="read"/>

    <!-- CleartextDevice:
         For an unlocked device, the object path of its cleartext device.
    -->
    <property name="CleartextDevice" type="o" access="read"/>

    <!--
        Unlock:
        @passphrase: The passphrase to use.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>keyfile_contents</parameter> (of type 'ay') which is preferred over @passphrase if specified and <parameter>read-only</parameter> (of type 'b').
        @cleartext_device: An object path to the unlocked object implementing the #org.freedesktop.UDisks2.Block interface.

        Tries to unlock the encrypted device using @passphrase.

        If the device in question is referenced in a system-wide
        configuration file (such as the <filename>/etc/crypttab</filename> file),
        then name, options and passphrase (if available) is used from that
        file after requesting additional authorization.

        If an empty passphrase should be used to unlock the device, it has to be
        passed using the @keyfile_contents parameter. Empty string passed as
        @passphrase means "Use the passphrase from the configuration file".

        If the device is removed without being locked (e.g. the user
        yanking the device or pulling the media out) the cleartext
        device will be cleaned up.
    -->
    <method name="Unlock">
      <arg name="passphrase" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
      <arg name="cleartext_device" direction="out" type="o"/>
    </method>

    <!--
        Lock:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Locks the encrypted device.
    -->
    <method name="Lock">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        ChangePassphrase:
        @passphrase: The existing passphrase.
        @new_passphrase: The new passphrase to use.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>old_keyfile_contents</parameter> and <parameter>new_keyfile_contents</parameter> (of type 's' or 'ay').

        Changes the passphrase to @new_passphrase. An existing passphrase is required.

        If <parameter>old_keyfile_contents</parameter> or
        <parameter>new_keyfile_contents</parameter> are given, they take
        precedence over the corresponding passphrase parameters individually.

        If the device in question is referenced in a system-wide
        configuration file (such as the
        <filename>/etc/crypttab</filename> file) and this
        configuration references the passphrase, it is not
        automatically updated.
    -->
    <method name="ChangePassphrase">
      <arg name="passphrase" direction="in" type="s"/>
      <arg name="new_passphrase" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        Resize:
        @size: The target cleartext size in bytes, 0 for maximum.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>passphrase</parameter> (of type 's') and <parameter>keyfile_contents</parameter> (of type 'ay') which is preferred over @passphrase if specified.
        @since: 2.8.0

        Resizes the encrypted device.  The device must be unlocked.
        The given size is the target size for the cleartext device.

        You need to specify either @passphrase or @keyfile_contents for LUKS 2
        devices that don't have verified key loaded in kernel keyring.
    -->
    <method name="Resize">
      <arg name="size" direction="in" type="t"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

  </interface>

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

  <!--
      org.freedesktop.UDisks2.Loop:
      @short_description: Block device backed by a file

      This interface is used for #org.freedesktop.UDisks2.Block
      devices that are loop devices.
  -->
  <interface name="org.freedesktop.UDisks2.Loop">
    <!-- prereq: org.freedesktop.UDisks2.Block -->

    <!--
        Delete:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Deletes the loop device.
    -->
    <method name="Delete">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- BackingFile:
         A path to the file that is backing the block device or blank
         if unknown.
    -->
    <property name="BackingFile" type="ay" access="read"/>

    <!-- Autoclear:
         If %TRUE, the kernel will automatically clear the loop device
         when the last closer closes the device. This typically
         happens when the loop device is unmounted.
    -->
    <property name="Autoclear" type="b" access="read"/>

    <!-- SetupByUID:
         The id of the user who set up the loop device or 0 if set up
         by root or not through udisks.
    -->
    <property name="SetupByUID" type="u" access="read"/>

    <!--
        SetAutoclear:
        @value: The new value of autoclear.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Setter for the #org.freedesktop.UDisks2.Loop:Autoclear
        property. Since this may require authentication and thus may
        fail, it is implemented this way instead of the property being
        writable.
    -->
    <method name="SetAutoclear">
      <arg name="value" direction="in" type="b"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>
  </interface>

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

  <!--
      org.freedesktop.UDisks2.MDRaid:
      @short_description: Linux Software RAID
      @since: 2.0.0

      Objects implementing this interface represent
      <ulink url="https://raid.wiki.kernel.org/index.php/Linux_Raid">Linux Software RAID arrays</ulink>
      detected on the system. Both running and not-running arrays are represented.

      Block devices point to objects implementing this interface, see
      the #org.freedesktop.UDisks2.Block:MDRaid and
      #org.freedesktop.UDisks2.Block:MDRaidMember properties on the
      #org.freedesktop.UDisks2.Block D-Bus interface.
  -->
  <interface name="org.freedesktop.UDisks2.MDRaid">
    <!-- UUID:
         The UUID of the array.
    -->
    <property name="UUID" type="s" access="read"/>

    <!-- Name:
         The name of the array (TODO: homehost etc).
    -->
    <property name="Name" type="s" access="read"/>

    <!-- Level:
         The RAID level.

         Known values include <literal>raid0</literal>, <literal>raid1</literal>, <literal>raid4</literal>, <literal>raid5</literal>, <literal>raid6</literal> and <literal>raid10</literal>.
    -->
    <property name="Level" type="s" access="read"/>

    <!-- NumDevices:
         Number of devices that are part of the array.
    -->
    <property name="NumDevices" type="u" access="read"/>

    <!-- Size:
         The size of the array or 0 if unknown.

         This is the usable size, e.g. for a RAID-5 array backed by 4
         1TB disks, this will be approximately 3 TB.
    -->
    <property name="Size" type="t" access="read"/>

    <!-- SyncAction:
         The current state of the array or empty if the array is not
         running or if the array does not have any redundancy
         (e.g. RAID-0 or linear).

         Use the org.freedesktop.UDisks2.MDRaid.RequestSyncAction()
         method to change this.

         This property corresponds to the
         <literal>sync_action</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="SyncAction" type="s" access="read"/>

    <!-- SyncCompleted:
         The fraction or sectors completed (always between <constant>0.0</constant> and <constant>1.0</constant>) in the sync operation or 0.0 if no operation is in progress.

         This property corresponds to the
         <literal>sync_completed</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="SyncCompleted" type="d" access="read"/>

    <!-- SyncRate:
         The rate (or speed) at which the sync operation takes
         place. It is averaged over the last 30 seconds and measured
         in bytes per second.

         If the rate is unknown or no operation is in progress, the
         value of this property is 0.

         This property corresponds to the
         <literal>sync_speed</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="SyncRate" type="t" access="read"/>

    <!-- SyncRemainingTime:
         The estimated number of micro-seconds until the operation is
         finished

         If the amount of remaining time is unknown or no operation is
         in progress, the value of this property is 0.

         This property is based on the value of the
         <literal>sync_speed</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="SyncRemainingTime" type="t" access="read"/>

    <!-- Degraded:
         Number of devices by which the array is degraded (0 if not degraded or not running).

         This property corresponds to the
         <literal>degraded</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="Degraded" type="u" access="read"/>

    <!-- BitmapLocation:
         The location of a write-intent bitmap (empty if the array is not running), if any.

         If the RAID array does not support write-intent bitmaps (for
         example RAID-0 arrays), this is empty.

         This property corresponds to the
         <literal>bitmap/location</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="BitmapLocation" type="ay" access="read"/>

    <!-- ChunkSize:
         The chunk size (0 if the array is not running or not using striping).

         This property corresponds to the
         <literal>chunk_size</literal> sysfs file, see the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="ChunkSize" type="t" access="read"/>

    <!-- ActiveDevices:
         This property is an array with block devices that are
         currently associated with the with the array. It is empty if
         the array is not running.

         Each element of the array is a struct with the following members:
         <variablelist>
         <varlistentry><term>block (type 'o')</term>
         <listitem><para>The object path for the underlying block device (guaranteed to implement the #org.freedesktop.UDisks2.Block interface)</para></listitem></varlistentry>
         <varlistentry><term>slot (type 'i')</term>
         <listitem><para>-1 if the device is not currently part of the array (ie. <literal>spare</literal> or <literal>faulty</literal>), otherwise the slot number the device currently fills (between 0 and #org.freedesktop.UDisks2.MDRaid:NumDevices)</para></listitem></varlistentry>
         <varlistentry><term>state (type 'as')</term>
         <listitem><para>The state of the device - known elements include <literal>faulty</literal>, <literal>in_sync</literal>, <literal>write_mostly</literal>, <literal>blocked</literal> and <literal>spare</literal></para></listitem></varlistentry>
         <varlistentry><term>num_read_errors (type 't')</term>
         <listitem><para>An ongoing count of read errors that have been detected on this device but have not caused the device to be evicted from the array</para></listitem></varlistentry>
         <varlistentry><term>expansion (type 'a{sv}')</term>
         <listitem><para>Currently unused. Intended for future expansion.</para></listitem></varlistentry>
         </variablelist>
         This property correspond to the
         <filename>/sys/block/mdN/md/dev-*</filename> directories in sysfs and the sysfs files in each directory.
         See the
         <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
         file shipped with the kernel sources.
    -->
    <property name="ActiveDevices" type="a(oiasta{sv})" access="read"/>

    <!-- ChildConfiguration: Configuration items belonging to the
         block devices of this array (recursively).  This is also
         valid when the array is stopped and there are no actual block
         devices for it.  It works via the 'track-parents' options of
         org.freedesktop.UDisks2.Block.AddConfigurationItem(), which
         see.
    -->
    <property name="ChildConfiguration" type="a(sa{sv})" access="read"/>

    <!-- Running: Whether or not the array is considered running.

         It is an error to call Start on a running array, and Stop on
         a non-running array, for example.
    -->
    <property name="Running" type="b" access="read"/>

    <!--
        Start:
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>start-degraded</parameter> (of type 'b').

        Starts the RAID array.

        If the @option parameter contains the key @start-degraded with
        the value %TRUE, the array will be started even if some members
        are missing.
    -->
    <method name="Start">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        Stop:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Stops the RAID array.
    -->
    <method name="Stop">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        RemoveDevice:
        @device: An object path to an object implementing the #org.freedesktop.UDisks2.Block interface.
        @options: Options - known options (in addition to <link linkend="udisks-std-options">standard options</link>) includes <parameter>wipe</parameter> (of type 'b').

        Removes @device from the array.

        For this to work @device must already be associated with the
        array, e.g. referenced in the
        #org.freedesktop.UDisks2.MDRaid:ActiveDevices property.

        If the @option parameter contains the key @wipe with the value
        %TRUE, all known filesystem signatures will be erased from the
        @device after removal.
    -->
    <method name="RemoveDevice">
      <arg name="device" direction="in" type="o"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        AddDevice:
        @device: An object path to an object implementing the #org.freedesktop.UDisks2.Block interface.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Adds @device to the array.
    -->
    <method name="AddDevice">
      <arg name="device" direction="in" type="o"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        SetBitmapLocation:
        @value: The value for the bitmap, currently only the values 'none' and 'internal' are supported.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Sets whether the array has a write-intent bitmap.
    -->
    <method name="SetBitmapLocation">
      <arg name="value" direction="in" type="ay"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!--
        RequestSyncAction:
        @sync_action: The action to request.
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        This method call can be used to trigger and cancel data
        redundancy checks and repairs. Currently only the values
        <literal>check</literal>, <literal>repair</literal> and
        <literal>idle</literal> can be used for @sync_action.

        See also the property #org.freedesktop.UDisks2.MDRaid:SyncAction.

        This method call is similar to writing to the
        <literal>sync_action</literal> sysfs file, see the
        <filename><ulink url="https://www.kernel.org/doc/Documentation/admin-guide/md.rst">Documentation/admin-guide/md.rst</ulink></filename>
        file shipped with the kernel sources.
    -->
    <method name="RequestSyncAction">
      <arg name="sync_action" direction="in" type="s"/>
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- Delete:
         @options: Options.

         Stops the RAID array and destroys all RAID metadata on member devices.

         If the option <parameter>tear-down</parameter> is set to
         %TRUE, then the RAID array block device and all its children
         will be cleaned up before stopping.  This cleanup consists of
         removing entries from /etc/fstab and /etc/crypttab, and
         locking of encrypted block devices.  Entries in /etc/fstab
         and /etc/crypttab that have been created with the
         'track-parents' options to AddConfigurationItem will be
         removed even if their block device is currently unavailable.
    -->
    <method name="Delete">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

  </interface>

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

  <!--
      org.freedesktop.UDisks2.Job:
      @short_description: Long-running tasks

      Some operations may take a long time (hours) to complete, that
      is, to actually send the D-Bus reply message back. One example
      of such an operation is the
      org.freedesktop.UDisks2.Block.Format() method that is used to
      format a block device.

      When such operations are initiated, a job object implementing
      this interface may be created so the progress can be tracked by
      the caller (and also other observers).

      The object(s) that a job affects (such as block devices or
      drives) can be determined by looking at the
      #org.freedesktop.UDisks2.Job:Objects property. Among other
      things, this can be used to draw a spinner in the user interface
      next to e.g. an icon for the drive or device in question.

      The #org.freedesktop.UDisks2.Job:Operation property is used to
      convey the type of job currently in progress.

      The user id of the user who started the job is set in the
      #org.freedesktop.UDisks2.Job:StartedByUID property.

      A job <emphasis>may</emphasis> convey how much progress has been
      made, see the #org.freedesktop.UDisks2.Job:Progress and
      #org.freedesktop.UDisks2.Job:ProgressValid properties.

      When a job completes, the #org.freedesktop.UDisks2.Job::Completed signal
      is emitted.

      A job may or may not be cancelable, see the
      #org.freedesktop.UDisks2.Job:Cancelable property. To cancel a
      job use the org.freedesktop.UDisks2.Job.Cancel() method. This
      will cause the job to complete (with @success set to %FALSE) and
      the D-Bus method used to initiate the operation to return,
      usually returning the
      <literal>org.freedesktop.UDisks2.Error.Cancelled</literal>
      error. Once cancellation is requested it may take some time before
      the job is actually completed as there might be ongoing I/O.
  -->
  <interface name="org.freedesktop.UDisks2.Job">

    <!-- Operation:
         The type of the operation that the job represents.

         Known job operation types include:
         <variablelist>
           <varlistentry><term>ata-smart-selftest</term>
             <listitem><para>SMART self-test operation.</para></listitem></varlistentry>
           <varlistentry><term>drive-eject</term>
             <listitem><para>Ejecting the medium from a drive.</para></listitem></varlistentry>
           <varlistentry><term>encrypted-unlock</term>
             <listitem><para>Unlocking encrypted device.</para></listitem></varlistentry>
           <varlistentry><term>encrypted-lock</term>
             <listitem><para>Locking encrypted device.</para></listitem></varlistentry>
           <varlistentry><term>encrypted-modify</term>
             <listitem><para>Modifying encrypted device.</para></listitem></varlistentry>
           <varlistentry><term>encrypted-resize</term>
             <listitem><para>Resizing encrypted device.</para></listitem></varlistentry>
           <varlistentry><term>swapspace-start</term>
             <listitem><para>Starting swapspace.</para></listitem></varlistentry>
           <varlistentry><term>swapspace-stop</term>
             <listitem><para>Stopping swapspace.</para></listitem></varlistentry>
           <varlistentry><term>swapspace-modify</term>
             <listitem><para>Modifying swapspace.</para></listitem></varlistentry>
           <varlistentry><term>filesystem-mount</term>
             <listitem><para>Mounting a filesystem.</para></listitem></varlistentry>
           <varlistentry><term>filesystem-unmount</term>
             <listitem><para>Unmounting a filesystem.</para></listitem></varlistentry>
           <varlistentry><term>filesystem-modify</term>
             <listitem><para>Modifying a filesystem.</para></listitem></varlistentry>
           <varlistentry><term>filesystem-resize</term>
             <listitem><para>Resizing a filesystem.</para></listitem></varlistentry>
           <varlistentry><term>format-erase</term>
             <listitem><para>Erasing a device.</para></listitem></varlistentry>
           <varlistentry><term>format-mkfs</term>
             <listitem><para>Creating a filesystem.</para></listitem></varlistentry>
           <varlistentry><term>loop-setup</term>
             <listitem><para>Setting up a loop device.</para></listitem></varlistentry>
           <varlistentry><term>partition-modify</term>
             <listitem><para>Modifying a partition.</para></listitem></varlistentry>
           <varlistentry><term>partition-delete</term>
             <listitem><para>Deleting a partition.</para></listitem></varlistentry>
           <varlistentry><term>partition-create</term>
             <listitem><para>Creating a partition.</para></listitem></varlistentry>
           <varlistentry><term>cleanup</term>
             <listitem><para>Cleaning up devices that were removed without being properly unmounted or shut down.</para></listitem></varlistentry>
           <varlistentry><term>ata-secure-erase</term>
             <listitem><para>ATA Secure Erase.</para></listitem></varlistentry>
           <varlistentry><term>ata-enhanced-secure-erase</term>
             <listitem><para>ATA Enhanced Secure Erase.</para></listitem></varlistentry>
           <varlistentry><term>md-raid-stop</term>
             <listitem><para>Stopping a RAID Array.</para></listitem></varlistentry>
           <varlistentry><term>md-raid-start</term>
             <listitem><para>Starting a RAID Array.</para></listitem></varlistentry>
           <varlistentry><term>md-raid-fault-device</term>
             <listitem><para>Marking device in RAID Array as faulty.</para></listitem></varlistentry>
           <varlistentry><term>md-raid-remove-device</term>
             <listitem><para>Removing device from RAID Array.</para></listitem></varlistentry>
           <varlistentry><term>md-raid-create</term>
             <listitem><para>Create a RAID Array.</para></listitem></varlistentry>
           <varlistentry><term>nvme-selftest</term>
             <listitem><para>NVMe device self-test operation.</para></listitem></varlistentry>
           <varlistentry><term>nvme-sanitize</term>
             <listitem><para>NVMe sanitize operation.</para></listitem></varlistentry>
           <varlistentry><term>nvme-format-ns</term>
             <listitem><para>NVMe format namespace operation.</para></listitem></varlistentry>
         </variablelist>
         The
         <link linkend="udisks-client-get-job-description">udisks_client_get_job_description()</link>
         function can be used to get a localized human readable description.
    -->
    <property name="Operation" type="s" access="read"/>

    <!-- Progress:
         How much progress has been made. Values are in the range 0 to 1.

         Do not use unless #org.freedesktop.UDisks2.Job:ProgressValid is %TRUE.
    -->
    <property name="Progress" type="d" access="read"/>

    <!-- ProgressValid: Set to %TRUE if the #org.freedesktop.UDisks2.Job:Progress is valid. -->
    <property name="ProgressValid" type="b" access="read"/>

    <!-- Bytes:
         @since: 2.0.0
         If the job involves processing a known number of bytes (for
         example, erasing a disk), this property contains the total
         number of bytes to process. If not, the value of this
         property is zero.

         The intent of this property is for user interfaces to convey
         information such as <quote>123 GB of 1.0 TB completed</quote>.
    -->
    <property name="Bytes" type="t" access="read"/>

    <!-- Rate:
         @since: 2.0.0
         If the job involves processing a number of bytes (for
         example, erasing) and the rate at which the processing takes
         place is known, this property contains the rate (measured in
         bytes per second).  Otherwise the value of this property is
         zero.

         The intent of this property is for user interfaces to convey
         information such as <quote>110 MB/sec</quote>.
    -->
    <property name="Rate" type="t" access="read"/>

    <!-- StartTime:

         The point in time (micro-seconds since the <ulink
         url="http://en.wikipedia.org/wiki/Unix_epoch">Unix
         Epoch</ulink>) that the job was started.
    -->
    <property name="StartTime" type="t" access="read"/>

    <!-- ExpectedEndTime:

         The expected point in time (micro-seconds since the <ulink
         url="http://en.wikipedia.org/wiki/Unix_epoch">Unix
         Epoch</ulink>) that the job will complete or 0 if unknown.
    -->
    <property name="ExpectedEndTime" type="t" access="read"/>

    <!-- Objects: The objects that the job is related to, if any. -->
    <property name="Objects" type="ao" access="read"/>

    <!-- StartedByUID:
         The id of the user who started the job or 0 if started
         by root or not through udisks.
    -->
    <property name="StartedByUID" type="u" access="read"/>

    <!--
        Cancel:
        @options: Options (currently unused except for <link linkend="udisks-std-options">standard options</link>).

        Cancels the job. Fails with the
        <literal>org.freedesktop.UDisks2.Error.Failed</literal> error
        if #org.freedesktop.UDisks2.Job:Cancelable is %FALSE.
    -->
    <method name="Cancel">
      <arg name="options" direction="in" type="a{sv}"/>
    </method>

    <!-- Cancelable: Whether the job can be canceled. -->
    <property name="Cancelable" type="b" access="read"/>

    <!--
        Completed:
        @success: If %TRUE, the job completed successfully.
        @message: A message describing the completion of the job, e.g. an error message.

        Emitted when a job completes.
    -->
    <signal name="Completed">
      <arg name="success" type="b"/>
      <arg name="message" type="s"/>
    </signal>
  </interface>

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

</node>