<refentry id="gnome-disks">
  <refentryinfo>
    <title>gnome-disk-utility</title>
    <date>March 2013</date>
    <productname>GNOME</productname>
  </refentryinfo>

  <refnamediv>
    <refname>gnome-disks</refname>
    <refpurpose>the GNOME Disks application</refpurpose>
  </refnamediv>

  <refsynopsisdiv><title>SYNOPSIS</title>
    <cmdsynopsis>
      <command>gnome-disks</command>
      <arg choice="opt">OPTIONS</arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1><title>DESCRIPTION</title>
    <para>
      <command>gnome-disks</command> is the command to launch the
      GNOME Disks application. Disks provides a way to inspect,
      format, partition and configure disks and block devices.
    </para>
    <para>
      The Disks application is
      <emphasis>single-instance</emphasis>. What this means is that if
      the application is not already running when the
      <command>gnome-disks</command> command is invoked, it will get
      launched and the command invocation will block until the
      application exits. Otherwise the existing application instance
      will be used and the <command>gnome-disks</command> command will
      exit immediately.
    </para>
  </refsect1>

  <refsect1><title>OPTIONS</title>
    <para>
      The following options are understood:
    </para>

    <variablelist>
      <varlistentry>
        <term><option>--block-device <replaceable>DEVICE</replaceable></option></term>
        <listitem>
          <para>
            Switches to the Disks application and selects the block
            device given by <replaceable>DEVICE</replaceable> (for
            example, <filename>/dev/sda</filename>).
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <option>--block-device <replaceable>DEVICE</replaceable></option>
          <option>--format-device</option>
          <optional><option>--xid <replaceable>WINDOW-ID</replaceable></option></optional>
        </term>
        <listitem>
          <para>
            Shows the “Format Volume” dialog for the block device
            given by <replaceable>DEVICE</replaceable> (for example,
            <filename>/dev/sdb1</filename>). If
            <replaceable>WINDOW-ID</replaceable> is given, makes the
            dialog transient to the given XID.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
        <term>
          <option>--restore-disk-image <replaceable>FILE</replaceable></option>
        </term>
        <listitem>
          <para>
            Shows the “Restore Disk Image” dialog for the file given
            by <replaceable>FILE</replaceable> (for example,
            <filename>/home/user/Downloads/SuperOS.iso</filename>) and
            prompts the user to choose a disk to restore the image
            unto.
          </para>
        </listitem>
      </varlistentry>

      <varlistentry>
	<term><option>-h, --help</option></term>
        <listitem>
          <para>
            Prints a short help text and exits.
          </para>
        </listitem>
      </varlistentry>
    </variablelist>
  </refsect1>

  <refsect1><title>AUTHOR</title>
    <para>
      Written by David Zeuthen <email>zeuthen@gmail.com</email> with
      a lot of help from many others.
    </para>
  </refsect1>

  <refsect1>
    <title>BUGS</title>
    <para>
      Please send bug reports to either the distribution bug tracker
      or the upstream bug tracker at
      <ulink url="https://bugzilla.gnome.org/enter_bug.cgi?product=gnome-disk-utility"/>.
    </para>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <link linkend="gnome-disk-image-mounter.1"><citerefentry><refentrytitle>gnome-disk-image-mounter</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
      <citerefentry><refentrytitle>udisks</refentrytitle><manvolnum>8</manvolnum></citerefentry>
    </para>
  </refsect1>
</refentry>
