docs/reference/gio/html/GMount.html

   1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <html>
   3 <head>
   4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   5 <title>GMount</title>
   6 <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
   7 <link rel="home" href="index.html" title="GIO Reference Manual">
   8 <link rel="up" href="volume_mon.html" title="Volumes and Drives">
   9 <link rel="prev" href="GVolume.html" title="GVolume">
  10 <link rel="next" href="GDrive.html" title="GDrive">
  11 <meta name="generator" content="GTK-Doc V1.13 (XML mode)">
  12 <link rel="stylesheet" href="style.css" type="text/css">
  13 <link rel="part" href="pt01.html" title="Part I. GIO Overview">
  14 <link rel="chapter" href="ch01.html" title="Introduction">
  15 <link rel="chapter" href="ch02.html" title="Compiling GIO applications">
  16 <link rel="chapter" href="ch03.html" title="Running GIO applications">
  17 <link rel="chapter" href="extending-gio.html" title="Extending GIO">
  18 <link rel="part" href="pt02.html" title="Part II. API Reference">
  19 <link rel="chapter" href="file_ops.html" title="File Operations">
  20 <link rel="chapter" href="file_mon.html" title="File System Monitoring">
  21 <link rel="chapter" href="async.html" title="Asynchronous I/O">
  22 <link rel="chapter" href="conversion.html" title="Data conversion">
  23 <link rel="chapter" href="streaming.html" title="Streaming I/O">
  24 <link rel="chapter" href="types.html" title="File types and applications">
  25 <link rel="chapter" href="volume_mon.html" title="Volumes and Drives">
  26 <link rel="chapter" href="icons.html" title="Icons">
  27 <link rel="chapter" href="failable_initialization.html" title="Failable Initialization">
  28 <link rel="chapter" href="networking.html" title="Lowlevel platform-independent network support">
  29 <link rel="chapter" href="resolver.html" title="DNS resolution">
  30 <link rel="chapter" href="highlevel-socket.html" title="Highlevel network functionallity">
  31 <link rel="chapter" href="utils.html" title="Utilities">
  32 <link rel="chapter" href="extending.html" title="Extending GIO">
  33 <link rel="part" href="migrating.html" title="Part III. Migrating to GIO">
  34 <link rel="chapter" href="ch19.html" title="Migrating from POSIX to GIO">
  35 <link rel="chapter" href="ch20.html" title="Migrating from GnomeVFS to GIO">
  36 <link rel="chapter" href="gio-hierarchy.html" title="Object Hierarchy">
  37 <link rel="index" href="api-index-full.html" title="Index">
  38 <link rel="index" href="api-index-deprecated.html" title="Index of deprecated symbols">
  39 <link rel="index" href="api-index-2-18.html" title="Index of new symbols in 2.18">
  40 <link rel="index" href="api-index-2-20.html" title="Index of new symbols in 2.20">
  41 <link rel="index" href="api-index-2-22.html" title="Index of new symbols in 2.22">
  42 <link rel="index" href="api-index-2-24.html" title="Index of new symbols in 2.24">
  43 </head>
  44 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  45 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
  46 <tr valign="middle">
  47 <td><a accesskey="p" href="GVolume.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
  48 <td><a accesskey="u" href="volume_mon.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
  49 <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
  50 <th width="100%" align="center">GIO Reference Manual</th>
  51 <td><a accesskey="n" href="GDrive.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
  52 </tr>
  53 <tr><td colspan="5" class="shortcuts">
  54 <a href="#GMount.synopsis" class="shortcut">Top</a>
  55                    |
  56                   <a href="#GMount.description" class="shortcut">Description</a>
  57                    |
  58                   <a href="#GMount.object-hierarchy" class="shortcut">Object Hierarchy</a>
  59                    |
  60                   <a href="#GMount.prerequisites" class="shortcut">Prerequisites</a>
  61                    |
  62                   <a href="#GMount.signals" class="shortcut">Signals</a>
  63 </td></tr>
  64 </table>
  65 <div class="refentry" title="GMount">
  66 <a name="GMount"></a><div class="titlepage"></div>
  67 <div class="refnamediv"><table width="100%"><tr>
  68 <td valign="top">
  69 <h2><span class="refentrytitle"><a name="GMount.top_of_page"></a>GMount</span></h2>
  70 <p>GMount — Mount management</p>
  71 </td>
  72 <td valign="top" align="right"></td>
  73 </tr></table></div>
  74 <div class="refsynopsisdiv" title="Synopsis">
  75 <a name="GMount.synopsis"></a><h2>Synopsis</h2>
  76 <pre class="synopsis">
  77 #include &lt;gio/gio.h
  78 @see also: GVolume&gt;
  79 #include &lt;GUnixMount&gt;
  80
  81                     <a class="link" href="GMount.html#GMount-struct" title="GMount">GMount</a>;
  82                     <a class="link" href="GMount.html#GMountIface" title="GMountIface">GMountIface</a>;
  83 <span class="returnvalue">char</span> *              <a class="link" href="GMount.html#g-mount-get-name" title="g_mount_get_name ()">g_mount_get_name</a>                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  84 <span class="returnvalue">char</span> *              <a class="link" href="GMount.html#g-mount-get-uuid" title="g_mount_get_uuid ()">g_mount_get_uuid</a>                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  85 <a class="link" href="GIcon.html" title="GIcon"><span class="returnvalue">GIcon</span></a> *             <a class="link" href="GMount.html#g-mount-get-icon" title="g_mount_get_icon ()">g_mount_get_icon</a>                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  86 <a class="link" href="GDrive.html" title="GDrive"><span class="returnvalue">GDrive</span></a> *            <a class="link" href="GMount.html#g-mount-get-drive" title="g_mount_get_drive ()">g_mount_get_drive</a>                   (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  87 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GMount.html#g-mount-get-root" title="g_mount_get_root ()">g_mount_get_root</a>                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  88 <a class="link" href="GVolume.html" title="GVolume"><span class="returnvalue">GVolume</span></a> *           <a class="link" href="GMount.html#g-mount-get-volume" title="g_mount_get_volume ()">g_mount_get_volume</a>                  (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  89 <a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> *             <a class="link" href="GMount.html#g-mount-get-default-location" title="g_mount_get_default_location ()">g_mount_get_default_location</a>        (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  90 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-can-unmount" title="g_mount_can_unmount ()">g_mount_can_unmount</a>                 (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
  91 enum                <a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags">GMountMountFlags</a>;
  92 enum                <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags">GMountUnmountFlags</a>;
  93 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-unmount" title="g_mount_unmount ()">g_mount_unmount</a>                     (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
  94                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
  95                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
  96                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
  97                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
  98 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-unmount-finish" title="g_mount_unmount_finish ()">g_mount_unmount_finish</a>              (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
  99                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 100                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 101 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-unmount-with-operation" title="g_mount_unmount_with_operation ()">g_mount_unmount_with_operation</a>      (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 102                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
 103                                                          <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *mount_operation,
 104                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 105                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 106                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 107 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-unmount-with-operation-finish" title="g_mount_unmount_with_operation_finish ()">g_mount_unmount_with_operation_finish</a>
 108                                                         (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 109                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 110                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 111 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-remount" title="g_mount_remount ()">g_mount_remount</a>                     (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 112                                                          <a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags"><span class="returnvalue">GMountMountFlags</span></a> flags,
 113                                                          <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *mount_operation,
 114                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 115                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 116                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 117 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-remount-finish" title="g_mount_remount_finish ()">g_mount_remount_finish</a>              (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 118                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 119                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 120 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-can-eject" title="g_mount_can_eject ()">g_mount_can_eject</a>                   (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
 121 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-eject" title="g_mount_eject ()">g_mount_eject</a>                       (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 122                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
 123                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 124                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 125                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 126 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-eject-finish" title="g_mount_eject_finish ()">g_mount_eject_finish</a>                (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 127                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 128                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 129 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-eject-with-operation" title="g_mount_eject_with_operation ()">g_mount_eject_with_operation</a>        (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 130                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
 131                                                          <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *mount_operation,
 132                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 133                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 134                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 135 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-eject-with-operation-finish" title="g_mount_eject_with_operation_finish ()">g_mount_eject_with_operation_finish</a> (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 136                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 137                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 138 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-guess-content-type" title="g_mount_guess_content_type ()">g_mount_guess_content_type</a>          (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 139                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> force_rescan,
 140                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 141                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 142                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);
 143 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="GMount.html#g-mount-guess-content-type-finish" title="g_mount_guess_content_type_finish ()">g_mount_guess_content_type_finish</a>   (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 144                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 145                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 146 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            <a class="link" href="GMount.html#g-mount-guess-content-type-sync" title="g_mount_guess_content_type_sync ()">g_mount_guess_content_type_sync</a>     (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 147                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> force_rescan,
 148                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 149                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);
 150 <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GMount.html#g-mount-is-shadowed" title="g_mount_is_shadowed ()">g_mount_is_shadowed</a>                 (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
 151 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-shadow" title="g_mount_shadow ()">g_mount_shadow</a>                      (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
 152 <span class="returnvalue">void</span>                <a class="link" href="GMount.html#g-mount-unshadow" title="g_mount_unshadow ()">g_mount_unshadow</a>                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);
 153 </pre>
 154 </div>
 155 <div class="refsect1" title="Object Hierarchy">
 156 <a name="GMount.object-hierarchy"></a><h2>Object Hierarchy</h2>
 157 <pre class="synopsis">
 158   GInterface
 159    +----GMount
 160 </pre>
 161 </div>
 162 <div class="refsect1" title="Prerequisites">
 163 <a name="GMount.prerequisites"></a><h2>Prerequisites</h2>
 164 <p>
 165 GMount requires
 166  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>.</p>
 167 </div>
 168 <div class="refsect1" title="Signals">
 169 <a name="GMount.signals"></a><h2>Signals</h2>
 170 <pre class="synopsis">
 171   "<a class="link" href="GMount.html#GMount-changed" title='The "changed" signal'>changed</a>"                                        : Run Last
 172   "<a class="link" href="GMount.html#GMount-pre-unmount" title='The "pre-unmount" signal'>pre-unmount</a>"                                    : Run Last
 173   "<a class="link" href="GMount.html#GMount-unmounted" title='The "unmounted" signal'>unmounted</a>"                                      : Run Last
 174 </pre>
 175 </div>
 176 <div class="refsect1" title="Description">
 177 <a name="GMount.description"></a><h2>Description</h2>
 178 <p>
 179 The <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> interface represents user-visible mounts. Note, when
 180 porting from GnomeVFS, <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> is the moral equivalent of <a href="/usr/share/gtk-doc/html/gnome-vfs-2.0/gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a>.
 181 </p>
 182 <p>
 183 <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> is a "mounted" filesystem that you can access. Mounted is in
 184 quotes because it's not the same as a unix mount, it might be a gvfs
 185 mount, but you can still access the files on it if you use GIO. Might or
 186 might not be related to a volume object.
 187 </p>
 188 <p>
 189 Unmounting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> instance is an asynchronous operation. For
 190 more information about asynchronous operations, see <span class="type">GAsyncReady</span>
 191 and <span class="type">GSimpleAsyncReady</span>. To unmount a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> instance, first call
 192 <a class="link" href="GMount.html#g-mount-unmount-with-operation" title="g_mount_unmount_with_operation ()"><code class="function">g_mount_unmount_with_operation()</code></a> with (at least) the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> instance and a
 193 <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>.  The callback will be fired when the
 194 operation has resolved (either with success or failure), and a
 195 <span class="type">GAsyncReady</span> structure will be passed to the callback.  That
 196 callback should then call <a class="link" href="GMount.html#g-mount-unmount-with-operation-finish" title="g_mount_unmount_with_operation_finish ()"><code class="function">g_mount_unmount_with_operation_finish()</code></a> with the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>
 197 and the <span class="type">GAsyncReady</span> data to see if the operation was completed
 198 successfully.  If an <em class="parameter"><code>error</code></em> is present when <a class="link" href="GMount.html#g-mount-unmount-with-operation-finish" title="g_mount_unmount_with_operation_finish ()"><code class="function">g_mount_unmount_with_operation_finish()</code></a>
 199 is called, then it will be filled with any error information.</p>
 200 </div>
 201 <div class="refsect1" title="Details">
 202 <a name="GMount.details"></a><h2>Details</h2>
 203 <div class="refsect2" title="GMount">
 204 <a name="GMount-struct"></a><h3>GMount</h3>
 205 <pre class="programlisting">typedef struct _GMount GMount;</pre>
 206 <p>
 207 A handle to an object implementing the <a class="link" href="GMount.html#GMountIface" title="GMountIface"><span class="type">GMountIface</span></a> interface.</p>
 208 </div>
 209 <hr>
 210 <div class="refsect2" title="GMountIface">
 211 <a name="GMountIface"></a><h3>GMountIface</h3>
 212 <pre class="programlisting">typedef struct {
 213   GTypeInterface g_iface;
 214
 215   /* signals */
 216
 217   void        (* changed)                   (GMount              *mount);
 218   void        (* unmounted)                 (GMount              *mount);
 219
 220   /* Virtual Table */
 221
 222   GFile     * (* get_root)                  (GMount              *mount);
 223   char      * (* get_name)                  (GMount              *mount);
 224   GIcon     * (* get_icon)                  (GMount              *mount);
 225   char      * (* get_uuid)                  (GMount              *mount);
 226   GVolume   * (* get_volume)                (GMount              *mount);
 227   GDrive    * (* get_drive)                 (GMount              *mount);
 228   gboolean    (* can_unmount)               (GMount              *mount);
 229   gboolean    (* can_eject)                 (GMount              *mount);
 230
 231   void        (* unmount)                   (GMount              *mount,
 232                                              GMountUnmountFlags   flags,
 233                                              GCancellable        *cancellable,
 234                                              GAsyncReadyCallback  callback,
 235                                              gpointer             user_data);
 236   gboolean    (* unmount_finish)            (GMount              *mount,
 237                                              GAsyncResult        *result,
 238                                              GError             **error);
 239
 240   void        (* eject)                     (GMount              *mount,
 241                                              GMountUnmountFlags   flags,
 242                                              GCancellable        *cancellable,
 243                                              GAsyncReadyCallback  callback,
 244                                              gpointer             user_data);
 245   gboolean    (* eject_finish)              (GMount              *mount,
 246                                              GAsyncResult        *result,
 247                                              GError             **error);
 248
 249   void        (* remount)                   (GMount              *mount,
 250                                              GMountMountFlags     flags,
 251                                              GMountOperation     *mount_operation,
 252                                              GCancellable        *cancellable,
 253                                              GAsyncReadyCallback  callback,
 254                                              gpointer             user_data);
 255   gboolean    (* remount_finish)            (GMount              *mount,
 256                                              GAsyncResult        *result,
 257                                              GError             **error);
 258
 259   void        (* guess_content_type)        (GMount              *mount,
 260                                              gboolean             force_rescan,
 261                                              GCancellable        *cancellable,
 262                                              GAsyncReadyCallback  callback,
 263                                              gpointer             user_data);
 264   gchar    ** (* guess_content_type_finish) (GMount              *mount,
 265                                              GAsyncResult        *result,
 266                                              GError             **error);
 267   gchar    ** (* guess_content_type_sync)   (GMount              *mount,
 268                                              gboolean             force_rescan,
 269                                              GCancellable        *cancellable,
 270                                              GError             **error);
 271
 272   /* Signal, not VFunc */
 273   void        (* pre_unmount)               (GMount              *mount);
 274
 275   void        (* unmount_with_operation)    (GMount              *mount,
 276                                              GMountUnmountFlags   flags,
 277                                              GMountOperation     *mount_operation,
 278                                              GCancellable        *cancellable,
 279                                              GAsyncReadyCallback  callback,
 280                                              gpointer             user_data);
 281   gboolean    (* unmount_with_operation_finish) (GMount          *mount,
 282                                              GAsyncResult        *result,
 283                                              GError             **error);
 284
 285   void        (* eject_with_operation)      (GMount              *mount,
 286                                              GMountUnmountFlags   flags,
 287                                              GMountOperation     *mount_operation,
 288                                              GCancellable        *cancellable,
 289                                              GAsyncReadyCallback  callback,
 290                                              gpointer             user_data);
 291   gboolean    (* eject_with_operation_finish) (GMount            *mount,
 292                                              GAsyncResult        *result,
 293                                              GError             **error);
 294   GFile     * (* get_default_location)      (GMount              *mount);
 295 } GMountIface;
 296 </pre>
 297 <p>
 298 Interface for implementing operations for mounts.</p>
 299 <div class="variablelist"><table border="0">
 300 <col align="left" valign="top">
 301 <tbody>
 302 <tr>
 303 <td><p><span class="term"><a href="http://library.gnome.org/devel/gobject/unstable/gobject-Type-Information.html#GTypeInterface"><span class="type">GTypeInterface</span></a> <em class="structfield"><code><a name="GMountIface.g-iface"></a>g_iface</code></em>;</span></p></td>
 304 <td> The parent interface.
 305 </td>
 306 </tr>
 307 <tr>
 308 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.changed"></a>changed</code></em> ()</span></p></td>
 309 <td> Changed signal that is emitted when the mount's state has changed.
 310 </td>
 311 </tr>
 312 <tr>
 313 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.unmounted"></a>unmounted</code></em> ()</span></p></td>
 314 <td> The unmounted signal that is emitted when the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> have been unmounted. If the recipient is holding references to the object they should release them so the object can be finalized.
 315 </td>
 316 </tr>
 317 <tr>
 318 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-root"></a>get_root</code></em> ()</span></p></td>
 319 <td> Gets a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> to the root directory of the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 320 </td>
 321 </tr>
 322 <tr>
 323 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-name"></a>get_name</code></em> ()</span></p></td>
 324 <td> Gets a string containing the name of the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 325 </td>
 326 </tr>
 327 <tr>
 328 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-icon"></a>get_icon</code></em> ()</span></p></td>
 329 <td> Gets a <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a> for the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 330 </td>
 331 </tr>
 332 <tr>
 333 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-uuid"></a>get_uuid</code></em> ()</span></p></td>
 334 <td> Gets the UUID for the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>. The reference is typically based on the file system UUID for the mount in question and should be considered an opaque string. Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no UUID available.
 335 </td>
 336 </tr>
 337 <tr>
 338 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-volume"></a>get_volume</code></em> ()</span></p></td>
 339 <td> Gets a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> the mount is located on. Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> is not associated with a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a>.
 340 </td>
 341 </tr>
 342 <tr>
 343 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-drive"></a>get_drive</code></em> ()</span></p></td>
 344 <td> Gets a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> the volume of the mount is located on. Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> is not associated with a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> or a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a>. This is convenience method for getting the <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> and using that to get the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.
 345 </td>
 346 </tr>
 347 <tr>
 348 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.can-unmount"></a>can_unmount</code></em> ()</span></p></td>
 349 <td> Checks if a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> can be unmounted.
 350 </td>
 351 </tr>
 352 <tr>
 353 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.can-eject"></a>can_eject</code></em> ()</span></p></td>
 354 <td> Checks if a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> can be ejected.
 355 </td>
 356 </tr>
 357 <tr>
 358 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.unmount"></a>unmount</code></em> ()</span></p></td>
 359 <td> Starts unmounting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 360 </td>
 361 </tr>
 362 <tr>
 363 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.unmount-finish"></a>unmount_finish</code></em> ()</span></p></td>
 364 <td> Finishes an unmounting operation.
 365 </td>
 366 </tr>
 367 <tr>
 368 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.eject"></a>eject</code></em> ()</span></p></td>
 369 <td> Starts ejecting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 370 </td>
 371 </tr>
 372 <tr>
 373 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.eject-finish"></a>eject_finish</code></em> ()</span></p></td>
 374 <td> Finishes an eject operation.
 375 </td>
 376 </tr>
 377 <tr>
 378 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.remount"></a>remount</code></em> ()</span></p></td>
 379 <td> Starts remounting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 380 </td>
 381 </tr>
 382 <tr>
 383 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.remount-finish"></a>remount_finish</code></em> ()</span></p></td>
 384 <td> Finishes a remounting operation.
 385 </td>
 386 </tr>
 387 <tr>
 388 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.guess-content-type"></a>guess_content_type</code></em> ()</span></p></td>
 389 <td> Starts guessing the type of the content of a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 390     See <a class="link" href="GMount.html#g-mount-guess-content-type" title="g_mount_guess_content_type ()"><code class="function">g_mount_guess_content_type()</code></a> for more information on content
 391     type guessing. This operation was added in 2.18.
 392 </td>
 393 </tr>
 394 <tr>
 395 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.guess-content-type-finish"></a>guess_content_type_finish</code></em> ()</span></p></td>
 396 <td> Finishes a contenet type guessing operation. Added in 2.18.
 397 </td>
 398 </tr>
 399 <tr>
 400 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.guess-content-type-sync"></a>guess_content_type_sync</code></em> ()</span></p></td>
 401 <td> Synchronous variant of <em class="parameter"><code>guess_content_type</code></em>. Added in 2.18
 402 </td>
 403 </tr>
 404 <tr>
 405 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.pre-unmount"></a>pre_unmount</code></em> ()</span></p></td>
 406 <td> The pre_unmout signal that is emitted when the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> will soon be emitted. If the recipient is somehow holding the mount open by keeping an open file on it it should close the file.
 407 </td>
 408 </tr>
 409 <tr>
 410 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.unmount-with-operation"></a>unmount_with_operation</code></em> ()</span></p></td>
 411 <td> Starts unmounting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.
 412 </td>
 413 </tr>
 414 <tr>
 415 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.unmount-with-operation-finish"></a>unmount_with_operation_finish</code></em> ()</span></p></td>
 416 <td> Finishes an unmounting operation using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.
 417 </td>
 418 </tr>
 419 <tr>
 420 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.eject-with-operation"></a>eject_with_operation</code></em> ()</span></p></td>
 421 <td> Starts ejecting a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.
 422 </td>
 423 </tr>
 424 <tr>
 425 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.eject-with-operation-finish"></a>eject_with_operation_finish</code></em> ()</span></p></td>
 426 <td> Finishes an eject operation using a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a>. Since 2.22.
 427 </td>
 428 </tr>
 429 <tr>
 430 <td><p><span class="term"><em class="structfield"><code><a name="GMountIface.get-default-location"></a>get_default_location</code></em> ()</span></p></td>
 431 <td> Gets a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a> indication a start location that can be use as the entry point for this mount. Since 2.24.
 432 </td>
 433 </tr>
 434 </tbody>
 435 </table></div>
 436 </div>
 437 <hr>
 438 <div class="refsect2" title="g_mount_get_name ()">
 439 <a name="g-mount-get-name"></a><h3>g_mount_get_name ()</h3>
 440 <pre class="programlisting"><span class="returnvalue">char</span> *              g_mount_get_name                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 441 <p>
 442 Gets the name of <em class="parameter"><code>mount</code></em>.</p>
 443 <div class="variablelist"><table border="0">
 444 <col align="left" valign="top">
 445 <tbody>
 446 <tr>
 447 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 448 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 449 </td>
 450 </tr>
 451 <tr>
 452 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 453 <td> the name for the given <em class="parameter"><code>mount</code></em>.
 454     The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
 455     when no longer needed.
 456 </td>
 457 </tr>
 458 </tbody>
 459 </table></div>
 460 </div>
 461 <hr>
 462 <div class="refsect2" title="g_mount_get_uuid ()">
 463 <a name="g-mount-get-uuid"></a><h3>g_mount_get_uuid ()</h3>
 464 <pre class="programlisting"><span class="returnvalue">char</span> *              g_mount_get_uuid                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 465 <p>
 466 Gets the UUID for the <em class="parameter"><code>mount</code></em>. The reference is typically based on
 467 the file system UUID for the mount in question and should be
 468 considered an opaque string. Returns <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if there is no UUID
 469 available.</p>
 470 <div class="variablelist"><table border="0">
 471 <col align="left" valign="top">
 472 <tbody>
 473 <tr>
 474 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 475 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 476 </td>
 477 </tr>
 478 <tr>
 479 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 480 <td> the UUID for <em class="parameter"><code>mount</code></em> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if no UUID can be computed.
 481     The returned string should be freed with <a href="http://library.gnome.org/devel/glib/unstable/glib-Memory-Allocation.html#g-free"><code class="function">g_free()</code></a>
 482     when no longer needed.
 483 </td>
 484 </tr>
 485 </tbody>
 486 </table></div>
 487 </div>
 488 <hr>
 489 <div class="refsect2" title="g_mount_get_icon ()">
 490 <a name="g-mount-get-icon"></a><h3>g_mount_get_icon ()</h3>
 491 <pre class="programlisting"><a class="link" href="GIcon.html" title="GIcon"><span class="returnvalue">GIcon</span></a> *             g_mount_get_icon                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 492 <p>
 493 Gets the icon for <em class="parameter"><code>mount</code></em>.</p>
 494 <div class="variablelist"><table border="0">
 495 <col align="left" valign="top">
 496 <tbody>
 497 <tr>
 498 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 499 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 500 </td>
 501 </tr>
 502 <tr>
 503 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 504 <td> a <a class="link" href="GIcon.html" title="GIcon"><span class="type">GIcon</span></a>.
 505      The returned object should be unreffed with
 506      <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.
 507 </td>
 508 </tr>
 509 </tbody>
 510 </table></div>
 511 </div>
 512 <hr>
 513 <div class="refsect2" title="g_mount_get_drive ()">
 514 <a name="g-mount-get-drive"></a><h3>g_mount_get_drive ()</h3>
 515 <pre class="programlisting"><a class="link" href="GDrive.html" title="GDrive"><span class="returnvalue">GDrive</span></a> *            g_mount_get_drive                   (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 516 <p>
 517 Gets the drive for the <em class="parameter"><code>mount</code></em>.
 518 </p>
 519 <p>
 520 This is a convenience method for getting the <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> and then
 521 using that object to get the <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a>.</p>
 522 <div class="variablelist"><table border="0">
 523 <col align="left" valign="top">
 524 <tbody>
 525 <tr>
 526 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 527 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 528 </td>
 529 </tr>
 530 <tr>
 531 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 532 <td> a <a class="link" href="GDrive.html" title="GDrive"><span class="type">GDrive</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>mount</code></em> is not associated with a volume or a drive.
 533      The returned object should be unreffed with
 534      <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.
 535 </td>
 536 </tr>
 537 </tbody>
 538 </table></div>
 539 </div>
 540 <hr>
 541 <div class="refsect2" title="g_mount_get_root ()">
 542 <a name="g-mount-get-root"></a><h3>g_mount_get_root ()</h3>
 543 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> *             g_mount_get_root                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 544 <p>
 545 Gets the root directory on <em class="parameter"><code>mount</code></em>.</p>
 546 <div class="variablelist"><table border="0">
 547 <col align="left" valign="top">
 548 <tbody>
 549 <tr>
 550 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 551 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 552 </td>
 553 </tr>
 554 <tr>
 555 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 556 <td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
 557      The returned object should be unreffed with
 558      <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.
 559 </td>
 560 </tr>
 561 </tbody>
 562 </table></div>
 563 </div>
 564 <hr>
 565 <div class="refsect2" title="g_mount_get_volume ()">
 566 <a name="g-mount-get-volume"></a><h3>g_mount_get_volume ()</h3>
 567 <pre class="programlisting"><a class="link" href="GVolume.html" title="GVolume"><span class="returnvalue">GVolume</span></a> *           g_mount_get_volume                  (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 568 <p>
 569 Gets the volume for the <em class="parameter"><code>mount</code></em>.</p>
 570 <div class="variablelist"><table border="0">
 571 <col align="left" valign="top">
 572 <tbody>
 573 <tr>
 574 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 575 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 576 </td>
 577 </tr>
 578 <tr>
 579 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 580 <td> a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>mount</code></em> is not associated with a volume.
 581      The returned object should be unreffed with
 582      <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.
 583 </td>
 584 </tr>
 585 </tbody>
 586 </table></div>
 587 </div>
 588 <hr>
 589 <div class="refsect2" title="g_mount_get_default_location ()">
 590 <a name="g-mount-get-default-location"></a><h3>g_mount_get_default_location ()</h3>
 591 <pre class="programlisting"><a class="link" href="GFile.html" title="GFile"><span class="returnvalue">GFile</span></a> *             g_mount_get_default_location        (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 592 <p>
 593 Gets the default location of <em class="parameter"><code>mount</code></em>. The default location of the given
 594 <em class="parameter"><code>mount</code></em> is a path that reflects the main entry point for the user (e.g.
 595 the home directory, or the root of the volume).</p>
 596 <div class="variablelist"><table border="0">
 597 <col align="left" valign="top">
 598 <tbody>
 599 <tr>
 600 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 601 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 602 </td>
 603 </tr>
 604 <tr>
 605 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 606 <td> a <a class="link" href="GFile.html" title="GFile"><span class="type">GFile</span></a>.
 607      The returned object should be unreffed with
 608      <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#g-object-unref"><code class="function">g_object_unref()</code></a> when no longer needed.
 609 </td>
 610 </tr>
 611 </tbody>
 612 </table></div>
 613 </div>
 614 <hr>
 615 <div class="refsect2" title="g_mount_can_unmount ()">
 616 <a name="g-mount-can-unmount"></a><h3>g_mount_can_unmount ()</h3>
 617 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_can_unmount                 (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 618 <p>
 619 Checks if <em class="parameter"><code>mount</code></em> can be mounted.</p>
 620 <div class="variablelist"><table border="0">
 621 <col align="left" valign="top">
 622 <tbody>
 623 <tr>
 624 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 625 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 626 </td>
 627 </tr>
 628 <tr>
 629 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 630 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>mount</code></em> can be unmounted.
 631 </td>
 632 </tr>
 633 </tbody>
 634 </table></div>
 635 </div>
 636 <hr>
 637 <div class="refsect2" title="enum GMountMountFlags">
 638 <a name="GMountMountFlags"></a><h3>enum GMountMountFlags</h3>
 639 <pre class="programlisting">typedef enum {
 640   G_MOUNT_MOUNT_NONE = 0
 641 } GMountMountFlags;
 642 </pre>
 643 <p>
 644 Flags used when mounting a mount.</p>
 645 <div class="variablelist"><table border="0">
 646 <col align="left" valign="top">
 647 <tbody><tr>
 648 <td><p><a name="G-MOUNT-MOUNT-NONE:CAPS"></a><span class="term"><code class="literal">G_MOUNT_MOUNT_NONE</code></span></p></td>
 649 <td> No flags set.
 650 </td>
 651 </tr></tbody>
 652 </table></div>
 653 </div>
 654 <hr>
 655 <div class="refsect2" title="enum GMountUnmountFlags">
 656 <a name="GMountUnmountFlags"></a><h3>enum GMountUnmountFlags</h3>
 657 <pre class="programlisting">typedef enum {
 658   G_MOUNT_UNMOUNT_NONE  = 0,
 659   G_MOUNT_UNMOUNT_FORCE = (1 &lt;&lt; 0)
 660 } GMountUnmountFlags;
 661 </pre>
 662 <p>
 663 Flags used when an unmounting a mount.</p>
 664 <div class="variablelist"><table border="0">
 665 <col align="left" valign="top">
 666 <tbody>
 667 <tr>
 668 <td><p><a name="G-MOUNT-UNMOUNT-NONE:CAPS"></a><span class="term"><code class="literal">G_MOUNT_UNMOUNT_NONE</code></span></p></td>
 669 <td> No flags set.
 670 </td>
 671 </tr>
 672 <tr>
 673 <td><p><a name="G-MOUNT-UNMOUNT-FORCE:CAPS"></a><span class="term"><code class="literal">G_MOUNT_UNMOUNT_FORCE</code></span></p></td>
 674 <td> Unmount even if there are outstanding
 675  file operations on the mount.
 676 </td>
 677 </tr>
 678 </tbody>
 679 </table></div>
 680 </div>
 681 <hr>
 682 <div class="refsect2" title="g_mount_unmount ()">
 683 <a name="g-mount-unmount"></a><h3>g_mount_unmount ()</h3>
 684 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_unmount                     (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 685                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
 686                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 687                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 688                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 689 <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 690 <h3 class="title">Warning</h3>
 691 <p><code class="literal">g_mount_unmount</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GMount.html#g-mount-unmount-with-operation" title="g_mount_unmount_with_operation ()"><code class="function">g_mount_unmount_with_operation()</code></a> instead.</p>
 692 </div>
 693 <p>
 694 Unmounts a mount. This is an asynchronous operation, and is
 695 finished by calling <a class="link" href="GMount.html#g-mount-unmount-finish" title="g_mount_unmount_finish ()"><code class="function">g_mount_unmount_finish()</code></a> with the <em class="parameter"><code>mount</code></em>
 696 and <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> data returned in the <em class="parameter"><code>callback</code></em>.</p>
 697 <div class="variablelist"><table border="0">
 698 <col align="left" valign="top">
 699 <tbody>
 700 <tr>
 701 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 702 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 703 </td>
 704 </tr>
 705 <tr>
 706 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 707 <td> flags affecting the operation
 708 </td>
 709 </tr>
 710 <tr>
 711 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 712 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
 713 </td>
 714 </tr>
 715 <tr>
 716 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 717 <td> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 718 </td>
 719 </tr>
 720 <tr>
 721 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 722 <td> user data passed to <em class="parameter"><code>callback</code></em>.
 723 </td>
 724 </tr>
 725 </tbody>
 726 </table></div>
 727 </div>
 728 <hr>
 729 <div class="refsect2" title="g_mount_unmount_finish ()">
 730 <a name="g-mount-unmount-finish"></a><h3>g_mount_unmount_finish ()</h3>
 731 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_unmount_finish              (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 732                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 733                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 734 <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 735 <h3 class="title">Warning</h3>
 736 <p><code class="literal">g_mount_unmount_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GMount.html#g-mount-unmount-with-operation-finish" title="g_mount_unmount_with_operation_finish ()"><code class="function">g_mount_unmount_with_operation_finish()</code></a> instead.</p>
 737 </div>
 738 <p>
 739 Finishes unmounting a mount. If any errors occurred during the operation,
 740 <em class="parameter"><code>error</code></em> will be set to contain the errors and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
 741 <div class="variablelist"><table border="0">
 742 <col align="left" valign="top">
 743 <tbody>
 744 <tr>
 745 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 746 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 747 </td>
 748 </tr>
 749 <tr>
 750 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 751 <td> a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.
 752 </td>
 753 </tr>
 754 <tr>
 755 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 756 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
 757     ignore.
 758 </td>
 759 </tr>
 760 <tr>
 761 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 762 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the mount was successfully unmounted. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 763
 764 </td>
 765 </tr>
 766 </tbody>
 767 </table></div>
 768 </div>
 769 <hr>
 770 <div class="refsect2" title="g_mount_unmount_with_operation ()">
 771 <a name="g-mount-unmount-with-operation"></a><h3>g_mount_unmount_with_operation ()</h3>
 772 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_unmount_with_operation      (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 773                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
 774                                                          <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *mount_operation,
 775                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 776                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 777                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 778 <p>
 779 Unmounts a mount. This is an asynchronous operation, and is
 780 finished by calling <a class="link" href="GMount.html#g-mount-unmount-with-operation-finish" title="g_mount_unmount_with_operation_finish ()"><code class="function">g_mount_unmount_with_operation_finish()</code></a> with the <em class="parameter"><code>mount</code></em>
 781 and <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> data returned in the <em class="parameter"><code>callback</code></em>.</p>
 782 <div class="variablelist"><table border="0">
 783 <col align="left" valign="top">
 784 <tbody>
 785 <tr>
 786 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 787 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 788 </td>
 789 </tr>
 790 <tr>
 791 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 792 <td> flags affecting the operation
 793 </td>
 794 </tr>
 795 <tr>
 796 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
 797 <td> a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction.
 798 </td>
 799 </tr>
 800 <tr>
 801 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 802 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
 803 </td>
 804 </tr>
 805 <tr>
 806 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 807 <td> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 808 </td>
 809 </tr>
 810 <tr>
 811 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 812 <td> user data passed to <em class="parameter"><code>callback</code></em>.
 813 </td>
 814 </tr>
 815 </tbody>
 816 </table></div>
 817 <p class="since">Since 2.22</p>
 818 </div>
 819 <hr>
 820 <div class="refsect2" title="g_mount_unmount_with_operation_finish ()">
 821 <a name="g-mount-unmount-with-operation-finish"></a><h3>g_mount_unmount_with_operation_finish ()</h3>
 822 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_unmount_with_operation_finish
 823                                                         (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 824                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 825                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 826 <p>
 827 Finishes unmounting a mount. If any errors occurred during the operation,
 828 <em class="parameter"><code>error</code></em> will be set to contain the errors and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
 829 <div class="variablelist"><table border="0">
 830 <col align="left" valign="top">
 831 <tbody>
 832 <tr>
 833 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 834 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 835 </td>
 836 </tr>
 837 <tr>
 838 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 839 <td> a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.
 840 </td>
 841 </tr>
 842 <tr>
 843 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 844 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
 845     ignore.
 846 </td>
 847 </tr>
 848 <tr>
 849 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 850 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the mount was successfully unmounted. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 851
 852 </td>
 853 </tr>
 854 </tbody>
 855 </table></div>
 856 <p class="since">Since 2.22</p>
 857 </div>
 858 <hr>
 859 <div class="refsect2" title="g_mount_remount ()">
 860 <a name="g-mount-remount"></a><h3>g_mount_remount ()</h3>
 861 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_remount                     (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 862                                                          <a class="link" href="GMount.html#GMountMountFlags" title="enum GMountMountFlags"><span class="returnvalue">GMountMountFlags</span></a> flags,
 863                                                          <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *mount_operation,
 864                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 865                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 866                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 867 <p>
 868 Remounts a mount. This is an asynchronous operation, and is
 869 finished by calling <a class="link" href="GMount.html#g-mount-remount-finish" title="g_mount_remount_finish ()"><code class="function">g_mount_remount_finish()</code></a> with the <em class="parameter"><code>mount</code></em>
 870 and <a href="GAsyncResult.html"><span class="type">GAsyncResults</span></a> data returned in the <em class="parameter"><code>callback</code></em>.
 871 </p>
 872 <p>
 873 Remounting is useful when some setting affecting the operation
 874 of the volume has been changed, as these may need a remount to
 875 take affect. While this is semantically equivalent with unmounting
 876 and then remounting not all backends might need to actually be
 877 unmounted.</p>
 878 <div class="variablelist"><table border="0">
 879 <col align="left" valign="top">
 880 <tbody>
 881 <tr>
 882 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 883 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 884 </td>
 885 </tr>
 886 <tr>
 887 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 888 <td> flags affecting the operation
 889 </td>
 890 </tr>
 891 <tr>
 892 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
 893 <td> a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction.
 894 </td>
 895 </tr>
 896 <tr>
 897 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
 898 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
 899 </td>
 900 </tr>
 901 <tr>
 902 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
 903 <td> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
 904 </td>
 905 </tr>
 906 <tr>
 907 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
 908 <td> user data passed to <em class="parameter"><code>callback</code></em>.
 909 </td>
 910 </tr>
 911 </tbody>
 912 </table></div>
 913 </div>
 914 <hr>
 915 <div class="refsect2" title="g_mount_remount_finish ()">
 916 <a name="g-mount-remount-finish"></a><h3>g_mount_remount_finish ()</h3>
 917 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_remount_finish              (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 918                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
 919                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
 920 <p>
 921 Finishes remounting a mount. If any errors occurred during the operation,
 922 <em class="parameter"><code>error</code></em> will be set to contain the errors and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
 923 <div class="variablelist"><table border="0">
 924 <col align="left" valign="top">
 925 <tbody>
 926 <tr>
 927 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 928 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 929 </td>
 930 </tr>
 931 <tr>
 932 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
 933 <td> a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.
 934 </td>
 935 </tr>
 936 <tr>
 937 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
 938 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
 939     ignore.
 940 </td>
 941 </tr>
 942 <tr>
 943 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 944 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the mount was successfully remounted. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
 945 </td>
 946 </tr>
 947 </tbody>
 948 </table></div>
 949 </div>
 950 <hr>
 951 <div class="refsect2" title="g_mount_can_eject ()">
 952 <a name="g-mount-can-eject"></a><h3>g_mount_can_eject ()</h3>
 953 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_can_eject                   (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
 954 <p>
 955 Checks if <em class="parameter"><code>mount</code></em> can be eject.</p>
 956 <div class="variablelist"><table border="0">
 957 <col align="left" valign="top">
 958 <tbody>
 959 <tr>
 960 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 961 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 962 </td>
 963 </tr>
 964 <tr>
 965 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
 966 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the <em class="parameter"><code>mount</code></em> can be ejected.
 967 </td>
 968 </tr>
 969 </tbody>
 970 </table></div>
 971 </div>
 972 <hr>
 973 <div class="refsect2" title="g_mount_eject ()">
 974 <a name="g-mount-eject"></a><h3>g_mount_eject ()</h3>
 975 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_eject                       (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
 976                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
 977                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
 978                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
 979                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
 980 <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
 981 <h3 class="title">Warning</h3>
 982 <p><code class="literal">g_mount_eject</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GMount.html#g-mount-eject-with-operation" title="g_mount_eject_with_operation ()"><code class="function">g_mount_eject_with_operation()</code></a> instead.</p>
 983 </div>
 984 <p>
 985 Ejects a mount. This is an asynchronous operation, and is
 986 finished by calling <a class="link" href="GMount.html#g-mount-eject-finish" title="g_mount_eject_finish ()"><code class="function">g_mount_eject_finish()</code></a> with the <em class="parameter"><code>mount</code></em>
 987 and <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> data returned in the <em class="parameter"><code>callback</code></em>.</p>
 988 <div class="variablelist"><table border="0">
 989 <col align="left" valign="top">
 990 <tbody>
 991 <tr>
 992 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
 993 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
 994 </td>
 995 </tr>
 996 <tr>
 997 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
 998 <td> flags affecting the unmount if required for eject
 999 </td>
1000 </tr>
1001 <tr>
1002 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1003 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
1004 </td>
1005 </tr>
1006 <tr>
1007 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1008 <td> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1009 </td>
1010 </tr>
1011 <tr>
1012 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1013 <td> user data passed to <em class="parameter"><code>callback</code></em>.
1014 </td>
1015 </tr>
1016 </tbody>
1017 </table></div>
1018 </div>
1019 <hr>
1020 <div class="refsect2" title="g_mount_eject_finish ()">
1021 <a name="g-mount-eject-finish"></a><h3>g_mount_eject_finish ()</h3>
1022 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_eject_finish                (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
1023                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
1024                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
1025 <div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;">
1026 <h3 class="title">Warning</h3>
1027 <p><code class="literal">g_mount_eject_finish</code> has been deprecated since version 2.22 and should not be used in newly-written code. Use <a class="link" href="GMount.html#g-mount-eject-with-operation-finish" title="g_mount_eject_with_operation_finish ()"><code class="function">g_mount_eject_with_operation_finish()</code></a> instead.</p>
1028 </div>
1029 <p>
1030 Finishes ejecting a mount. If any errors occurred during the operation,
1031 <em class="parameter"><code>error</code></em> will be set to contain the errors and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
1032 <div class="variablelist"><table border="0">
1033 <col align="left" valign="top">
1034 <tbody>
1035 <tr>
1036 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1037 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
1038 </td>
1039 </tr>
1040 <tr>
1041 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1042 <td> a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.
1043 </td>
1044 </tr>
1045 <tr>
1046 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1047 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
1048     ignore.
1049 </td>
1050 </tr>
1051 <tr>
1052 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1053 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the mount was successfully ejected. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1054
1055 </td>
1056 </tr>
1057 </tbody>
1058 </table></div>
1059 </div>
1060 <hr>
1061 <div class="refsect2" title="g_mount_eject_with_operation ()">
1062 <a name="g-mount-eject-with-operation"></a><h3>g_mount_eject_with_operation ()</h3>
1063 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_eject_with_operation        (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
1064                                                          <a class="link" href="GMount.html#GMountUnmountFlags" title="enum GMountUnmountFlags"><span class="returnvalue">GMountUnmountFlags</span></a> flags,
1065                                                          <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="returnvalue">GMountOperation</span></a> *mount_operation,
1066                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
1067                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
1068                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
1069 <p>
1070 Ejects a mount. This is an asynchronous operation, and is
1071 finished by calling <a class="link" href="GMount.html#g-mount-eject-with-operation-finish" title="g_mount_eject_with_operation_finish ()"><code class="function">g_mount_eject_with_operation_finish()</code></a> with the <em class="parameter"><code>mount</code></em>
1072 and <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> data returned in the <em class="parameter"><code>callback</code></em>.</p>
1073 <div class="variablelist"><table border="0">
1074 <col align="left" valign="top">
1075 <tbody>
1076 <tr>
1077 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1078 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
1079 </td>
1080 </tr>
1081 <tr>
1082 <td><p><span class="term"><em class="parameter"><code>flags</code></em> :</span></p></td>
1083 <td> flags affecting the unmount if required for eject
1084 </td>
1085 </tr>
1086 <tr>
1087 <td><p><span class="term"><em class="parameter"><code>mount_operation</code></em> :</span></p></td>
1088 <td> a <a class="link" href="GMountOperation.html" title="GMountOperation"><span class="type">GMountOperation</span></a> or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to avoid user interaction.
1089 </td>
1090 </tr>
1091 <tr>
1092 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1093 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore.
1094 </td>
1095 </tr>
1096 <tr>
1097 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1098 <td> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>.
1099 </td>
1100 </tr>
1101 <tr>
1102 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1103 <td> user data passed to <em class="parameter"><code>callback</code></em>.
1104 </td>
1105 </tr>
1106 </tbody>
1107 </table></div>
1108 <p class="since">Since 2.22</p>
1109 </div>
1110 <hr>
1111 <div class="refsect2" title="g_mount_eject_with_operation_finish ()">
1112 <a name="g-mount-eject-with-operation-finish"></a><h3>g_mount_eject_with_operation_finish ()</h3>
1113 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_eject_with_operation_finish (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
1114                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
1115                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
1116 <p>
1117 Finishes ejecting a mount. If any errors occurred during the operation,
1118 <em class="parameter"><code>error</code></em> will be set to contain the errors and <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned.</p>
1119 <div class="variablelist"><table border="0">
1120 <col align="left" valign="top">
1121 <tbody>
1122 <tr>
1123 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1124 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
1125 </td>
1126 </tr>
1127 <tr>
1128 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1129 <td> a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>.
1130 </td>
1131 </tr>
1132 <tr>
1133 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1134 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
1135     ignore.
1136 </td>
1137 </tr>
1138 <tr>
1139 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1140 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the mount was successfully ejected. <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> otherwise.
1141
1142 </td>
1143 </tr>
1144 </tbody>
1145 </table></div>
1146 <p class="since">Since 2.22</p>
1147 </div>
1148 <hr>
1149 <div class="refsect2" title="g_mount_guess_content_type ()">
1150 <a name="g-mount-guess-content-type"></a><h3>g_mount_guess_content_type ()</h3>
1151 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_guess_content_type          (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
1152                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> force_rescan,
1153                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
1154                                                          <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="returnvalue">GAsyncReadyCallback</span></a> callback,
1155                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="returnvalue">gpointer</span></a> user_data);</pre>
1156 <p>
1157 Tries to guess the type of content stored on <em class="parameter"><code>mount</code></em>. Returns one or
1158 more textual identifiers of well-known content types (typically
1159 prefixed with "x-content/"), e.g. x-content/image-dcf for camera
1160 memory cards. See the <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec" target="_top">shared-mime-info</a>
1161 specification for more on x-content types.
1162 </p>
1163 <p>
1164 This is an asynchronous operation (see
1165 <a class="link" href="GMount.html#g-mount-guess-content-type-sync" title="g_mount_guess_content_type_sync ()"><code class="function">g_mount_guess_content_type_sync()</code></a> for the synchronous version), and
1166 is finished by calling <a class="link" href="GMount.html#g-mount-guess-content-type-finish" title="g_mount_guess_content_type_finish ()"><code class="function">g_mount_guess_content_type_finish()</code></a> with the
1167 <em class="parameter"><code>mount</code></em> and <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a> data returned in the <em class="parameter"><code>callback</code></em>.</p>
1168 <div class="variablelist"><table border="0">
1169 <col align="left" valign="top">
1170 <tbody>
1171 <tr>
1172 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1173 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>
1174 </td>
1175 </tr>
1176 <tr>
1177 <td><p><span class="term"><em class="parameter"><code>force_rescan</code></em> :</span></p></td>
1178 <td> Whether to force a rescan of the content.
1179     Otherwise a cached result will be used if available
1180 </td>
1181 </tr>
1182 <tr>
1183 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1184 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
1185 </td>
1186 </tr>
1187 <tr>
1188 <td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
1189 <td> a <a class="link" href="GAsyncResult.html#GAsyncReadyCallback" title="GAsyncReadyCallback ()"><span class="type">GAsyncReadyCallback</span></a>
1190 </td>
1191 </tr>
1192 <tr>
1193 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1194 <td> user data passed to <em class="parameter"><code>callback</code></em>
1195 </td>
1196 </tr>
1197 </tbody>
1198 </table></div>
1199 <p class="since">Since 2.18</p>
1200 </div>
1201 <hr>
1202 <div class="refsect2" title="g_mount_guess_content_type_finish ()">
1203 <a name="g-mount-guess-content-type-finish"></a><h3>g_mount_guess_content_type_finish ()</h3>
1204 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            g_mount_guess_content_type_finish   (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
1205                                                          <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="returnvalue">GAsyncResult</span></a> *result,
1206                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
1207 <p>
1208 Finishes guessing content types of <em class="parameter"><code>mount</code></em>. If any errors occured
1209 during the operation, <em class="parameter"><code>error</code></em> will be set to contain the errors and
1210 <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> will be returned. In particular, you may get an
1211 <a class="link" href="gio-GIOError.html#G-IO-ERROR-NOT-SUPPORTED:CAPS"><code class="literal">G_IO_ERROR_NOT_SUPPORTED</code></a> if the mount does not support content
1212 guessing.</p>
1213 <div class="variablelist"><table border="0">
1214 <col align="left" valign="top">
1215 <tbody>
1216 <tr>
1217 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1218 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>
1219 </td>
1220 </tr>
1221 <tr>
1222 <td><p><span class="term"><em class="parameter"><code>result</code></em> :</span></p></td>
1223 <td> a <a class="link" href="GAsyncResult.html" title="GAsyncResult"><span class="type">GAsyncResult</span></a>
1224 </td>
1225 </tr>
1226 <tr>
1227 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1228 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
1229     ignore
1230 </td>
1231 </tr>
1232 <tr>
1233 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1234 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of content types or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
1235     Caller should free this array with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when done with it.
1236
1237 </td>
1238 </tr>
1239 </tbody>
1240 </table></div>
1241 <p class="since">Since 2.18</p>
1242 </div>
1243 <hr>
1244 <div class="refsect2" title="g_mount_guess_content_type_sync ()">
1245 <a name="g-mount-guess-content-type-sync"></a><h3>g_mount_guess_content_type_sync ()</h3>
1246 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gchar"><span class="returnvalue">gchar</span></a> **            g_mount_guess_content_type_sync     (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount,
1247                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a> force_rescan,
1248                                                          <a class="link" href="GCancellable.html" title="GCancellable"><span class="returnvalue">GCancellable</span></a> *cancellable,
1249                                                          <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="returnvalue">GError</span></a> **error);</pre>
1250 <p>
1251 Tries to guess the type of content stored on <em class="parameter"><code>mount</code></em>. Returns one or
1252 more textual identifiers of well-known content types (typically
1253 prefixed with "x-content/"), e.g. x-content/image-dcf for camera
1254 memory cards. See the <a class="ulink" href="http://www.freedesktop.org/wiki/Specifications/shared-mime-info-spec" target="_top">shared-mime-info</a>
1255 specification for more on x-content types.
1256 </p>
1257 <p>
1258 This is an synchronous operation and as such may block doing IO;
1259 see <a class="link" href="GMount.html#g-mount-guess-content-type" title="g_mount_guess_content_type ()"><code class="function">g_mount_guess_content_type()</code></a> for the asynchronous version.</p>
1260 <div class="variablelist"><table border="0">
1261 <col align="left" valign="top">
1262 <tbody>
1263 <tr>
1264 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1265 <td> a <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>
1266 </td>
1267 </tr>
1268 <tr>
1269 <td><p><span class="term"><em class="parameter"><code>force_rescan</code></em> :</span></p></td>
1270 <td> Whether to force a rescan of the content.
1271     Otherwise a cached result will be used if available
1272 </td>
1273 </tr>
1274 <tr>
1275 <td><p><span class="term"><em class="parameter"><code>cancellable</code></em> :</span></p></td>
1276 <td> optional <a class="link" href="GCancellable.html" title="GCancellable"><span class="type">GCancellable</span></a> object, <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to ignore
1277 </td>
1278 </tr>
1279 <tr>
1280 <td><p><span class="term"><em class="parameter"><code>error</code></em> :</span></p></td>
1281 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Error-Reporting.html#GError"><span class="type">GError</span></a> location to store the error occuring, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> to
1282     ignore
1283 </td>
1284 </tr>
1285 <tr>
1286 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1287 <td> a <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>-terminated array of content types or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a> on error.
1288     Caller should free this array with <a href="http://library.gnome.org/devel/glib/unstable/glib-String-Utility-Functions.html#g-strfreev"><code class="function">g_strfreev()</code></a> when done with it.
1289
1290 </td>
1291 </tr>
1292 </tbody>
1293 </table></div>
1294 <p class="since">Since 2.18</p>
1295 </div>
1296 <hr>
1297 <div class="refsect2" title="g_mount_is_shadowed ()">
1298 <a name="g-mount-is-shadowed"></a><h3>g_mount_is_shadowed ()</h3>
1299 <pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            g_mount_is_shadowed                 (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
1300 <p>
1301 Determines if <em class="parameter"><code>mount</code></em> is shadowed. Applications or libraries should
1302 avoid displaying <em class="parameter"><code>mount</code></em> in the user interface if it is shadowed.
1303 </p>
1304 <p>
1305 A mount is said to be shadowed if there exists one or more user
1306 visible objects (currently <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> objects) with a root that is
1307 inside the root of <em class="parameter"><code>mount</code></em>.
1308 </p>
1309 <p>
1310 One application of shadow mounts is when exposing a single file
1311 system that is used to address several logical volumes. In this
1312 situation, a <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a> implementation would create two
1313 <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> objects (for example, one for the camera functionality of
1314 the device and one for a SD card reader on the device) with
1315 activation URIs <code class="literal">gphoto2://[usb:001,002]/store1/</code>
1316 and <code class="literal">gphoto2://[usb:001,002]/store2/</code>. When the
1317 underlying mount (with root
1318 <code class="literal">gphoto2://[usb:001,002]/</code>) is mounted, said
1319 <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a> implementation would create two <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> objects
1320 (each with their root matching the corresponding volume activation
1321 root) that would shadow the original mount.
1322 </p>
1323 <p>
1324 The proxy monitor in GVfs 2.26 and later, automatically creates and
1325 manage shadow mounts (and shadows the underlying mount) if the
1326 activation root on a <a class="link" href="GVolume.html" title="GVolume"><span class="type">GVolume</span></a> is set.</p>
1327 <div class="variablelist"><table border="0">
1328 <col align="left" valign="top">
1329 <tbody>
1330 <tr>
1331 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1332 <td> A <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
1333 </td>
1334 </tr>
1335 <tr>
1336 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
1337 <td> <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if <em class="parameter"><code>mount</code></em> is shadowed.
1338
1339 </td>
1340 </tr>
1341 </tbody>
1342 </table></div>
1343 <p class="since">Since 2.20</p>
1344 </div>
1345 <hr>
1346 <div class="refsect2" title="g_mount_shadow ()">
1347 <a name="g-mount-shadow"></a><h3>g_mount_shadow ()</h3>
1348 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_shadow                      (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
1349 <p>
1350 Increments the shadow count on <em class="parameter"><code>mount</code></em>. Usually used by
1351 <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a> implementations when creating a shadow mount for
1352 <em class="parameter"><code>mount</code></em>, see <a class="link" href="GMount.html#g-mount-is-shadowed" title="g_mount_is_shadowed ()"><code class="function">g_mount_is_shadowed()</code></a> for more information. The caller
1353 will need to emit the <a class="link" href="GMount.html#GMount-changed" title='The "changed" signal'><span class="type">"changed"</span></a> signal on <em class="parameter"><code>mount</code></em> manually.</p>
1354 <div class="variablelist"><table border="0">
1355 <col align="left" valign="top">
1356 <tbody><tr>
1357 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1358 <td> A <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
1359 </td>
1360 </tr></tbody>
1361 </table></div>
1362 <p class="since">Since 2.20</p>
1363 </div>
1364 <hr>
1365 <div class="refsect2" title="g_mount_unshadow ()">
1366 <a name="g-mount-unshadow"></a><h3>g_mount_unshadow ()</h3>
1367 <pre class="programlisting"><span class="returnvalue">void</span>                g_mount_unshadow                    (<a class="link" href="GMount.html" title="GMount"><span class="returnvalue">GMount</span></a> *mount);</pre>
1368 <p>
1369 Decrements the shadow count on <em class="parameter"><code>mount</code></em>. Usually used by
1370 <a class="link" href="GVolumeMonitor.html" title="GVolumeMonitor"><span class="type">GVolumeMonitor</span></a> implementations when destroying a shadow mount for
1371 <em class="parameter"><code>mount</code></em>, see <a class="link" href="GMount.html#g-mount-is-shadowed" title="g_mount_is_shadowed ()"><code class="function">g_mount_is_shadowed()</code></a> for more information. The caller
1372 will need to emit the <a class="link" href="GMount.html#GMount-changed" title='The "changed" signal'><span class="type">"changed"</span></a> signal on <em class="parameter"><code>mount</code></em> manually.</p>
1373 <div class="variablelist"><table border="0">
1374 <col align="left" valign="top">
1375 <tbody><tr>
1376 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1377 <td> A <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>.
1378 </td>
1379 </tr></tbody>
1380 </table></div>
1381 <p class="since">Since 2.20</p>
1382 </div>
1383 </div>
1384 <div class="refsect1" title="Signal Details">
1385 <a name="GMount.signal-details"></a><h2>Signal Details</h2>
1386 <div class="refsect2" title='The "changed" signal'>
1387 <a name="GMount-changed"></a><h3>The <code class="literal">"changed"</code> signal</h3>
1388 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>  *mount,
1389                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)      : Run Last</pre>
1390 <p>
1391 Emitted when the mount has been changed.</p>
1392 <div class="variablelist"><table border="0">
1393 <col align="left" valign="top">
1394 <tbody>
1395 <tr>
1396 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1397 <td> the object on which the signal is emitted
1398 </td>
1399 </tr>
1400 <tr>
1401 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1402 <td>user data set when the signal handler was connected.</td>
1403 </tr>
1404 </tbody>
1405 </table></div>
1406 </div>
1407 <hr>
1408 <div class="refsect2" title='The "pre-unmount" signal'>
1409 <a name="GMount-pre-unmount"></a><h3>The <code class="literal">"pre-unmount"</code> signal</h3>
1410 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>  *mount,
1411                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)      : Run Last</pre>
1412 <p>
1413 This signal is emitted when the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> is about to be
1414 unmounted.</p>
1415 <div class="variablelist"><table border="0">
1416 <col align="left" valign="top">
1417 <tbody>
1418 <tr>
1419 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1420 <td> the object on which the signal is emitted
1421 </td>
1422 </tr>
1423 <tr>
1424 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1425 <td>user data set when the signal handler was connected.</td>
1426 </tr>
1427 </tbody>
1428 </table></div>
1429 <p class="since">Since 2.22</p>
1430 </div>
1431 <hr>
1432 <div class="refsect2" title='The "unmounted" signal'>
1433 <a name="GMount-unmounted"></a><h3>The <code class="literal">"unmounted"</code> signal</h3>
1434 <pre class="programlisting"><span class="returnvalue">void</span>                user_function                      (<a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a>  *mount,
1435                                                         <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gpointer"><span class="type">gpointer</span></a> user_data)      : Run Last</pre>
1436 <p>
1437 This signal is emitted when the <a class="link" href="GMount.html" title="GMount"><span class="type">GMount</span></a> have been
1438 unmounted. If the recipient is holding references to the
1439 object they should release them so the object can be
1440 finalized.</p>
1441 <div class="variablelist"><table border="0">
1442 <col align="left" valign="top">
1443 <tbody>
1444 <tr>
1445 <td><p><span class="term"><em class="parameter"><code>mount</code></em> :</span></p></td>
1446 <td> the object on which the signal is emitted
1447 </td>
1448 </tr>
1449 <tr>
1450 <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1451 <td>user data set when the signal handler was connected.</td>
1452 </tr>
1453 </tbody>
1454 </table></div>
1455 </div>
1456 </div>
1457 </div>
1458 <div class="footer">
1459 <hr>
1460           Generated by GTK-Doc V1.13</div>
1461 </body>
1462 </html>