<refentry id="gnome-vfs-20-gnome-vfs-volume-monitor">
<refmeta>
<refentrytitle id="top_of_page">GnomeVFSVolumeMonitor</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GNOME-VFS-2.0 Library</refmiscinfo>
</refmeta>

<refnamediv>
<refname>GnomeVFSVolumeMonitor</refname>
<refpurpose>Monitors volume mounts and unmounts</refpurpose>
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
</refnamediv>

<refsynopsisdiv id="synopsis">
<title id="synopsis.title">Synopsis</title>
<anchor id="GnomeVFSVolumeMonitor"/>
<synopsis>



#define     <link linkend="GNOME-IS-VFS-VOLUME-MONITOR:CAPS">GNOME_IS_VFS_VOLUME_MONITOR</link>     (o)
#define     <link linkend="GNOME-IS-VFS-VOLUME-MONITOR-CLASS:CAPS">GNOME_IS_VFS_VOLUME_MONITOR_CLASS</link>(k)
#define     <link linkend="GNOME-VFS-TYPE-VOLUME-MONITOR:CAPS">GNOME_VFS_TYPE_VOLUME_MONITOR</link>
#define     <link linkend="GNOME-VFS-VOLUME-MONITOR:CAPS">GNOME_VFS_VOLUME_MONITOR</link>        (o)
#define     <link linkend="GNOME-VFS-VOLUME-MONITOR-CLASS:CAPS">GNOME_VFS_VOLUME_MONITOR_CLASS</link>  (k)
            <link linkend="GnomeVFSVolumeMonitor-struct">GnomeVFSVolumeMonitor</link>;
            <link linkend="GnomeVFSVolumeMonitorClass">GnomeVFSVolumeMonitorClass</link>;
<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link>* <link linkend="gnome-vfs-get-volume-monitor">gnome_vfs_get_volume_monitor</link>
                                            (void);
<link linkend="void">void</link>        <link linkend="gnome-vfs-volume-monitor-emit-pre-unmount">gnome_vfs_volume_monitor_emit_pre_unmount</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *volume);
<link linkend="GList">GList</link>*      <link linkend="gnome-vfs-volume-monitor-get-connected-drives">gnome_vfs_volume_monitor_get_connected_drives</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);
<link linkend="GnomeVFSDrive">GnomeVFSDrive</link>* <link linkend="gnome-vfs-volume-monitor-get-drive-by-id">gnome_vfs_volume_monitor_get_drive_by_id</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             <link linkend="gulong">gulong</link> id);
<link linkend="GList">GList</link>*      <link linkend="gnome-vfs-volume-monitor-get-mounted-volumes">gnome_vfs_volume_monitor_get_mounted_volumes</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);
<link linkend="GType">GType</link>       <link linkend="gnome-vfs-volume-monitor-get-type">gnome_vfs_volume_monitor_get_type</link>
                                            (void);
<link linkend="GnomeVFSVolume">GnomeVFSVolume</link>* <link linkend="gnome-vfs-volume-monitor-get-volume-by-id">gnome_vfs_volume_monitor_get_volume_by_id</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             <link linkend="gulong">gulong</link> id);
<link linkend="GnomeVFSVolume">GnomeVFSVolume</link>* <link linkend="gnome-vfs-volume-monitor-get-volume-for-path">gnome_vfs_volume_monitor_get_volume_for_path</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             const <link linkend="char">char</link> *path);
<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link>* <link linkend="gnome-vfs-volume-monitor-ref">gnome_vfs_volume_monitor_ref</link>
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);
<link linkend="void">void</link>        <link linkend="gnome-vfs-volume-monitor-unref">gnome_vfs_volume_monitor_unref</link>  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);
</synopsis>
</refsynopsisdiv>

<refsect1 id="object_hierarchy">
<title id="object_hierarchy.title">Object Hierarchy</title>
<synopsis>

  <link linkend="GObject">GObject</link>
   +----GnomeVFSVolumeMonitor
</synopsis>

</refsect1>






<refsect1 id="signal_proto">
<title id="signal_proto.title">Signals</title>
<synopsis>

&quot;<link linkend="GnomeVFSVolumeMonitor-drive-connected">drive-connected</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSDrive">GnomeVFSDrive</link>         *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first
&quot;<link linkend="GnomeVFSVolumeMonitor-drive-disconnected">drive-disconnected</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSDrive">GnomeVFSDrive</link>         *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first
&quot;<link linkend="GnomeVFSVolumeMonitor-volume-mounted">volume-mounted</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link>        *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first
&quot;<link linkend="GnomeVFSVolumeMonitor-volume-pre-unmount">volume-pre-unmount</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link>        *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first
&quot;<link linkend="GnomeVFSVolumeMonitor-volume-unmounted">volume-unmounted</link>&quot;
            <link linkend="void">void</link>        user_function      (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link>        *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first
</synopsis>
</refsect1>


<refsect1 id="desc">
<title id="desc.title">Description</title>
<para>

</para>
</refsect1>

<refsect1 id="details">
<title id="details.title">Details</title>
<refsect2>
<title><anchor id="GNOME-IS-VFS-VOLUME-MONITOR:CAPS" role="macro"/>GNOME_IS_VFS_VOLUME_MONITOR()</title>
<indexterm><primary>GNOME_IS_VFS_VOLUME_MONITOR</primary></indexterm><programlisting>#define GNOME_IS_VFS_VOLUME_MONITOR(o)       (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNOME_VFS_TYPE_VOLUME_MONITOR))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>o</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-IS-VFS-VOLUME-MONITOR-CLASS:CAPS" role="macro"/>GNOME_IS_VFS_VOLUME_MONITOR_CLASS()</title>
<indexterm><primary>GNOME_IS_VFS_VOLUME_MONITOR_CLASS</primary></indexterm><programlisting>#define GNOME_IS_VFS_VOLUME_MONITOR_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GNOME_VFS_TYPE_VOLUME_MONITOR))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>k</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-VFS-TYPE-VOLUME-MONITOR:CAPS" role="macro"/>GNOME_VFS_TYPE_VOLUME_MONITOR</title>
<indexterm><primary>GNOME_VFS_TYPE_VOLUME_MONITOR</primary></indexterm><programlisting>#define GNOME_VFS_TYPE_VOLUME_MONITOR        (gnome_vfs_volume_monitor_get_type ())
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GNOME-VFS-VOLUME-MONITOR:CAPS" role="macro"/>GNOME_VFS_VOLUME_MONITOR()</title>
<indexterm><primary>GNOME_VFS_VOLUME_MONITOR</primary></indexterm><programlisting>#define GNOME_VFS_VOLUME_MONITOR(o)          (G_TYPE_CHECK_INSTANCE_CAST ((o), GNOME_VFS_TYPE_VOLUME_MONITOR, GnomeVFSVolumeMonitor))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>o</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GNOME-VFS-VOLUME-MONITOR-CLASS:CAPS" role="macro"/>GNOME_VFS_VOLUME_MONITOR_CLASS()</title>
<indexterm><primary>GNOME_VFS_VOLUME_MONITOR_CLASS</primary></indexterm><programlisting>#define GNOME_VFS_VOLUME_MONITOR_CLASS(k)    (G_TYPE_CHECK_CLASS_CAST((k), GNOME_VFS_TYPE_VOLUME_MONITOR, GnomeVFSVolumeMonitorClass))
</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>k</parameter>&nbsp;:</term>
<listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="GnomeVFSVolumeMonitor-struct" role="struct"/>GnomeVFSVolumeMonitor</title>
<indexterm><primary>GnomeVFSVolumeMonitor</primary></indexterm><programlisting>typedef struct _GnomeVFSVolumeMonitor GnomeVFSVolumeMonitor;</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="GnomeVFSVolumeMonitorClass" role="struct"/>GnomeVFSVolumeMonitorClass</title>
<indexterm><primary>GnomeVFSVolumeMonitorClass</primary></indexterm><programlisting>typedef struct {
	GObjectClass parent_class;
	
	void (* volume_mounted)	  	(GnomeVFSVolumeMonitor *volume_monitor,
				   	 GnomeVFSVolume	       *volume);
	void (* volume_pre_unmount)	(GnomeVFSVolumeMonitor *volume_monitor,
				   	 GnomeVFSVolume	       *volume);
	void (* volume_unmounted)	(GnomeVFSVolumeMonitor *volume_monitor,
				   	 GnomeVFSVolume	       *volume);
	void (* drive_connected) 	(GnomeVFSVolumeMonitor *volume_monitor,
				   	 GnomeVFSDrive	       *drive);
	void (* drive_disconnected)	(GnomeVFSVolumeMonitor *volume_monitor,
				   	 GnomeVFSDrive         *drive);
} GnomeVFSVolumeMonitorClass;
</programlisting>
<para>

</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-get-volume-monitor" role="function" condition="since:2.6"/>gnome_vfs_get_volume_monitor ()</title>
<indexterm role="2.6"><primary>gnome_vfs_get_volume_monitor</primary></indexterm><programlisting><link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link>* gnome_vfs_get_volume_monitor
                                            (void);</programlisting>
<para>
Returns a pointer to the <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link> singleton.
<link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link> is a singleton, this means it is guaranteed to
exist and be valid until <link linkend="gnome-vfs-shutdown"><function>gnome_vfs_shutdown()</function></link> is called. Consequently,
it doesn't need to be refcounted since gnome-vfs will hold a reference to 
it until it is shut down.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> a pointer to the <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link> singleton.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-emit-pre-unmount" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_emit_pre_unmount ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_emit_pre_unmount</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_volume_monitor_emit_pre_unmount
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             <link linkend="GnomeVFSVolume">GnomeVFSVolume</link> *volume);</programlisting>
<para>
Emits the "pre-unmount" signal on <parameter>volume</parameter>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>volume</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-get-connected-drives" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_get_connected_drives ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_get_connected_drives</primary></indexterm><programlisting><link linkend="GList">GList</link>*      gnome_vfs_volume_monitor_get_connected_drives
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>a <link linkend="GList"><type>GList</type></link> of all connected drives to the machine. The <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link>
objects must be unreffed by the caller when no longer needed with  
<link linkend="gnome-vfs-drive-unref"><function>gnome_vfs_drive_unref()</function></link> and the <link linkend="GList"><type>GList</type></link> must be freed.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-get-drive-by-id" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_get_drive_by_id ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_get_drive_by_id</primary></indexterm><programlisting><link linkend="GnomeVFSDrive">GnomeVFSDrive</link>* gnome_vfs_volume_monitor_get_drive_by_id
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             <link linkend="gulong">gulong</link> id);</programlisting>
<para>
Looks for a <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link> whose id is <parameter>id</parameter>. A valid <parameter>volume_monitor</parameter> to pass
to this function can be acquired using <link linkend="gnome-vfs-get-volume-monitor"><function>gnome_vfs_get_volume_monitor()</function></link></para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&nbsp;:</term>
<listitem><simpara> the <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> id to look for.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link> corresponding to <parameter>id</parameter>, or <literal>NULL</literal> if no 
<link linkend="GnomeVFSDrive"><type>GnomeVFSDrive</type></link> with a matching id could be found. The caller owns a 
reference on the returned drive, and must call <link linkend="gnome-vfs-drive-unref"><function>gnome_vfs_drive_unref()</function></link>
when it no longer needs it.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-get-mounted-volumes" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_get_mounted_volumes ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_get_mounted_volumes</primary></indexterm><programlisting><link linkend="GList">GList</link>*      gnome_vfs_volume_monitor_get_mounted_volumes
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);</programlisting>
<para>
Gets the list of all the mounted <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> volumes.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <link linkend="GList"><type>GList</type></link> of <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link>. The <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> objects must be 
unreffed by the caller when no longer needed with <link linkend="gnome-vfs-volume-unref"><function>gnome_vfs_volume_unref()</function></link>
and the <link linkend="GList"><type>GList</type></link> must be freed.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-get-type" role="function"/>gnome_vfs_volume_monitor_get_type ()</title>
<indexterm><primary>gnome_vfs_volume_monitor_get_type</primary></indexterm><programlisting><link linkend="GType">GType</link>       gnome_vfs_volume_monitor_get_type
                                            (void);</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara>


</simpara></listitem></varlistentry>
</variablelist></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-get-volume-by-id" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_get_volume_by_id ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_get_volume_by_id</primary></indexterm><programlisting><link linkend="GnomeVFSVolume">GnomeVFSVolume</link>* gnome_vfs_volume_monitor_get_volume_by_id
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             <link linkend="gulong">gulong</link> id);</programlisting>
<para>
Looks for a <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> whose id is <parameter>id</parameter>. A valid <parameter>volume_monitor</parameter> to pass
to this function can be acquired using <link linkend="gnome-vfs-get-volume-monitor"><function>gnome_vfs_get_volume_monitor()</function></link>.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>id</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> id to look for.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> corresponding to <parameter>id</parameter>, or <literal>NULL</literal> if no 
<link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> with a matching id could be found. The caller owns a 
reference on the returned volume, and must call <link linkend="gnome-vfs-volume-unref"><function>gnome_vfs_volume_unref()</function></link>
when it no longer needs it.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-get-volume-for-path" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_get_volume_for_path ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_get_volume_for_path</primary></indexterm><programlisting><link linkend="GnomeVFSVolume">GnomeVFSVolume</link>* gnome_vfs_volume_monitor_get_volume_for_path
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor,
                                             const <link linkend="char">char</link> *path);</programlisting>
<para>
</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> a <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>path</parameter>&nbsp;:</term>
<listitem><simpara> string representing a path.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> the <link linkend="GnomeVFSVolume"><type>GnomeVFSVolume</type></link> corresponding to the <parameter>path</parameter>.  Volume returned 
must be unreffed by the caller with <link linkend="gnome-vfs-volume-unref"><function>gnome_vfs_volume_unref()</function></link>.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-ref" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_ref ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_ref</primary></indexterm><programlisting><link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link>* gnome_vfs_volume_monitor_ref
                                            (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);</programlisting>
<para>
Increases the refcount of <parameter>volume_monitor</parameter> by one.
</para>
<para>
You shouldn't use this function unless you know what you are doing:
<link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link> is to be used as a singleton object, see
<link linkend="gnome-vfs-get-volume-monitor"><function>gnome_vfs_get_volume_monitor()</function></link> for more details.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
<varlistentry><term><emphasis>Returns</emphasis>&nbsp;:</term><listitem><simpara> <parameter>volume_monitor</parameter> with its refcount increased by one.

</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>
<refsect2>
<title><anchor id="gnome-vfs-volume-monitor-unref" role="function" condition="since:2.6"/>gnome_vfs_volume_monitor_unref ()</title>
<indexterm role="2.6"><primary>gnome_vfs_volume_monitor_unref</primary></indexterm><programlisting><link linkend="void">void</link>        gnome_vfs_volume_monitor_unref  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *volume_monitor);</programlisting>
<para>
Decreases the refcount of <parameter>volume_monitor</parameter> by one.
</para>
<para>
You shouldn't use this function unless you know what you are doing:
<link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link> is to be used as a singleton object, see
<link linkend="gnome-vfs-get-volume-monitor"><function>gnome_vfs_get_volume_monitor()</function></link> for more details.</para>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>volume_monitor</parameter>&nbsp;:</term>
<listitem><simpara> <link linkend="GnomeVFSVolumeMonitor"><type>GnomeVFSVolumeMonitor</type></link>.
</simpara></listitem></varlistentry>
</variablelist><para>Since  2.6
</para></refsect2>

</refsect1>

<refsect1 id="signals">
<title id="signals.title">Signal Details</title>
<refsect2><title><anchor id="GnomeVFSVolumeMonitor-drive-connected"/>The &quot;drive-connected&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSDrive">GnomeVFSDrive</link>         *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsvolumemonitor</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeVFSVolumeMonitor-drive-disconnected"/>The &quot;drive-disconnected&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSDrive">GnomeVFSDrive</link>         *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsvolumemonitor</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeVFSVolumeMonitor-volume-mounted"/>The &quot;volume-mounted&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link>        *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsvolumemonitor</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeVFSVolumeMonitor-volume-pre-unmount"/>The &quot;volume-pre-unmount&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link>        *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsvolumemonitor</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2><refsect2><title><anchor id="GnomeVFSVolumeMonitor-volume-unmounted"/>The &quot;volume-unmounted&quot; signal</title>
<programlisting><link linkend="void">void</link>        user_function                  (<link linkend="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</link> *vfsvolumemonitor,
                                            <link linkend="GnomeVFSVolume">GnomeVFSVolume</link>        *arg1,
                                            <link linkend="gpointer">gpointer</link>               user_data)             : Run first</programlisting>
<para>

</para><variablelist role="params">
<varlistentry><term><parameter>vfsvolumemonitor</parameter>&nbsp;:</term>
<listitem><simpara>the object which received the signal.
</simpara></listitem></varlistentry>
<varlistentry><term><parameter>arg1</parameter>&nbsp;:</term>
<listitem><simpara>

</simpara></listitem></varlistentry>
<varlistentry><term><parameter>user_data</parameter>&nbsp;:</term>
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
</variablelist></refsect2>
</refsect1>



</refentry>
