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

  <refnamediv>
    <refname>gnome-disk-image-mounter</refname>
    <refpurpose>Attach and mount disk images</refpurpose>
  </refnamediv>

  <refsynopsisdiv><title>SYNOPSIS</title>
    <cmdsynopsis>
      <command>gnome-disk-image-mounter</command>
      <arg choice="opt">--writable</arg>
      <arg choice="opt" rep="repeat"><replaceable>URI</replaceable></arg>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsect1><title>DESCRIPTION</title>
    <para>
      <command>gnome-disk-image-mounter</command> can be used to set
      up disk images. Both regular files and <emphasis>GVfs</emphasis>
      URIs (such as <filename>smb://filer/media/file.iso</filename>)
      can be used in the <parameter>URI</parameter> parameter. If no
      <parameter>URI</parameter>s are given and a window server is
      running, a graphical file chooser will be presented.
    </para>
    <para>
      Note that <command>gnome-disk-image-mounter</command> will not
      mount filesystems or unlock encrypted volumes in the disk image
      - this responsibility is left to the automounter in GNOME Shell
      to ensure that the same interactions happen as if the disk image
      was a regular physical device or disc.
    </para>
    <para>
      By default the disk images are attached read-only, use
      the option <option>--writable</option> to change this.
    </para>
  </refsect1>

  <refsect1><title>RETURN VALUE</title>
    <para>
      <command>gnome-disk-image-mounter</command> returns 0 on success
      and non-zero on failure.
    </para>
  </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://gitlab.gnome.org/GNOME/gnome-disk-utility/-/issues/"/>.
    </para>
  </refsect1>

  <refsect1>
    <title>SEE ALSO</title>
    <para>
      <citerefentry><refentrytitle>gnome-shell</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
      <link linkend="gnome-disks.1"><citerefentry><refentrytitle>gnome-disks</refentrytitle><manvolnum>1</manvolnum></citerefentry></link>,
      <citerefentry><refentrytitle>udisks</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
      <citerefentry><refentrytitle>losetup</refentrytitle><manvolnum>8</manvolnum></citerefentry>
    </para>
  </refsect1>
</refentry>
