GNOME_IS_VFS_VOLUME_MONITOR()

#define GNOME_IS_VFS_VOLUME_MONITOR(o)       (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNOME_VFS_TYPE_VOLUME_MONITOR))

GNOME_IS_VFS_VOLUME_MONITOR_CLASS()

#define GNOME_IS_VFS_VOLUME_MONITOR_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GNOME_VFS_TYPE_VOLUME_MONITOR))

GNOME_VFS_TYPE_VOLUME_MONITOR

#define GNOME_VFS_TYPE_VOLUME_MONITOR        (gnome_vfs_volume_monitor_get_type ())

GNOME_VFS_VOLUME_MONITOR()

#define GNOME_VFS_VOLUME_MONITOR(o)          (G_TYPE_CHECK_INSTANCE_CAST ((o), GNOME_VFS_TYPE_VOLUME_MONITOR, GnomeVFSVolumeMonitor))

GNOME_VFS_VOLUME_MONITOR_CLASS()

#define GNOME_VFS_VOLUME_MONITOR_CLASS(k)    (G_TYPE_CHECK_CLASS_CAST((k), GNOME_VFS_TYPE_VOLUME_MONITOR, GnomeVFSVolumeMonitorClass))

GnomeVFSVolumeMonitor

typedef struct _GnomeVFSVolumeMonitor GnomeVFSVolumeMonitor;

GnomeVFSVolumeMonitorClass

typedef struct {
	GObjectClass parent_class;

	/* signals */
	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;

gnome_vfs_get_volume_monitor ()

GnomeVFSVolumeMonitor* gnome_vfs_get_volume_monitor
                                            (void);

Returns a pointer to the GnomeVFSVolumeMonitor singleton. GnomeVFSVolumeMonitor is a singleton, this means it is guaranteed to exist and be valid until gnome_vfs_shutdown() is called. Consequently, it doesn't need to be refcounted since gnome-vfs will hold a reference to it until it is shut down.

Since 2.6

gnome_vfs_volume_monitor_get_connected_drives ()

GList*      gnome_vfs_volume_monitor_get_connected_drives
                                            (GnomeVFSVolumeMonitor *volume_monitor);

Returns a GList of all drives connected to the machine. The GnomeVFSDrive objects must be unreffed by the caller when no longer needed with gnome_vfs_drive_unref() and the GList must be freed.

Since 2.6

gnome_vfs_volume_monitor_get_drive_by_id ()

GnomeVFSDrive* gnome_vfs_volume_monitor_get_drive_by_id
                                            (GnomeVFSVolumeMonitor *volume_monitor,
                                             gulong id);

Looks for a GnomeVFSDrive whose id is id. A valid volume_monitor to pass to this function can be acquired using gnome_vfs_get_volume_monitor()

Since 2.6

gnome_vfs_volume_monitor_get_mounted_volumes ()

GList*      gnome_vfs_volume_monitor_get_mounted_volumes
                                            (GnomeVFSVolumeMonitor *volume_monitor);

Gets the list of all the mounted GnomeVFSVolume volumes.

Since 2.6

gnome_vfs_volume_monitor_get_type ()

GType       gnome_vfs_volume_monitor_get_type
                                            (void);

gnome_vfs_volume_monitor_get_volume_by_id ()

GnomeVFSVolume* gnome_vfs_volume_monitor_get_volume_by_id
                                            (GnomeVFSVolumeMonitor *volume_monitor,
                                             gulong id);

Looks for a GnomeVFSVolume whose id is id. A valid volume_monitor to pass to this function can be acquired using gnome_vfs_get_volume_monitor().

Since 2.6

gnome_vfs_volume_monitor_get_volume_for_path ()

GnomeVFSVolume* gnome_vfs_volume_monitor_get_volume_for_path
                                            (GnomeVFSVolumeMonitor *volume_monitor,
                                             const char *path);

Returns the GnomeVFSVolume corresponding to path, or NULL.

The volume referring to path is found by calling stat on path, and then iterating through the list of volumes that refer to currently mounted local file systems. The first volume in this list maching the path's UNIX device is returned.

If the stat on path was not successful, or no volume matches path, or NULL is returned.

Since 2.6

gnome_vfs_volume_monitor_ref ()

GnomeVFSVolumeMonitor* gnome_vfs_volume_monitor_ref
                                            (GnomeVFSVolumeMonitor *volume_monitor);

Increases the refcount of volume_monitor by one, if it is not NULL.

You shouldn't use this function unless you know what you are doing: GnomeVFSVolumeMonitor is to be used as a singleton object, see gnome_vfs_get_volume_monitor() for more details.

Since 2.6

gnome_vfs_volume_monitor_unref ()

void        gnome_vfs_volume_monitor_unref  (GnomeVFSVolumeMonitor *volume_monitor);

Decreases the refcount of volume_monitor by one, if it is not NULL.

You shouldn't use this function unless you know what you are doing: GnomeVFSVolumeMonitor is to be used as a singleton object, see gnome_vfs_get_volume_monitor() for more details.

Since 2.6

The "drive-connected" signal

void        user_function                  (GnomeVFSVolumeMonitor *volume_monitor,
                                            GnomeVFSDrive         *drive,
                                            gpointer               user_data)           : Run first

This signal is emitted when the GnomeVFSDrive drive has been connected.

When the drive is connected, it is present in the volume_monitor's list of connected drives, which can be queried using gnome_vfs_volume_monitor_get_connected_drives().

The "drive-disconnected" signal

void        user_function                  (GnomeVFSVolumeMonitor *volume_monitor,
                                            GnomeVFSDrive         *drive,
                                            gpointer               user_data)           : Run first

This signal is emitted after the GnomeVFSDrive drive has been disconnected.

When the drive is disconnected, it is removed from the volume_monitor's list of connected drives, which can be queried using gnome_vfs_volume_monitor_get_connected_drives().

The "volume-mounted" signal

void        user_function                  (GnomeVFSVolumeMonitor *volume_monitor,
                                            GnomeVFSVolume        *volume,
                                            gpointer               user_data)           : Run first

This signal is emitted after the GnomeVFSVolume volume has been mounted.

When the volume is mounted, it is present in the volume_monitor's list of mounted volumes, which can be queried using gnome_vfs_volume_monitor_get_mounted_volumes().

If the volume has an associated GnomeVFSDrive, it also appears in the drive's list of mounted volumes, which can be queried using gnome_vfs_drive_get_mounted_volumes().

The "volume-pre-unmount" signal

void        user_function                  (GnomeVFSVolumeMonitor *volume_monitor,
                                            GnomeVFSVolume        *volume,
                                            gpointer               user_data)           : Run first

This signal is emitted when the GnomeVFSVolume volume is about to be unmounted.

When the volume is unmounted, it is removed from the volume_monitor's list of mounted volumes, which can be queried using gnome_vfs_volume_monitor_get_mounted_volumes().

If the volume has an associated GnomeVFSDrive, it is also removed from in the drive's list of mounted volumes, which can be queried using gnome_vfs_drive_get_mounted_volumes().

When a client application receives this signal, it must free all resources associated with the volume, for instance cancel all pending file operations on the volume, and cancel all pending file monitors using gnome_vfs_monitor_cancel().

The "volume-unmounted" signal

void        user_function                  (GnomeVFSVolumeMonitor *volume_monitor,
                                            GnomeVFSVolume        *volume,
                                            gpointer               user_data)           : Run first

This signal is emitted after the GnomeVFSVolume volume has been unmounted.

When the volume is unmounted, it is removed from the volume_monitor's list of mounted volumes, which can be queried using gnome_vfs_volume_monitor_get_mounted_volumes().

If the volume has an associated GnomeVFSDrive, it is also removed from in the drive's list of mounted volumes, which can be queried using gnome_vfs_drive_get_mounted_volumes().