1
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
4
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5
<title>GnomeVFSDrive</title>
6
<meta name="generator" content="DocBook XSL Stylesheets V1.74.3">
7
<link rel="home" href="index.html" title="GnomeVFS - Filesystem Abstraction library">
8
<link rel="up" href="volumes.html" title="Volumes and Drives Handling">
9
<link rel="prev" href="gnome-vfs-2.0-gnome-vfs-volume.html" title="GnomeVFSVolume">
10
<link rel="next" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html" title="GnomeVFSVolumeMonitor">
11
<meta name="generator" content="GTK-Doc V1.12 (XML mode)">
12
<link rel="stylesheet" href="style.css" type="text/css">
13
<link rel="chapter" href="about.html" title="Introduction to GnomeVFS">
14
<link rel="chapter" href="data-types.html" title="Basic Data Types">
15
<link rel="chapter" href="gnome-vfs-basic-file-ops.html" title="File Operations">
16
<link rel="chapter" href="gnome-vfs-directory-ops.html" title="Directory-Specific Operations">
17
<link rel="chapter" href="gnome-vfs-file-and-dirs-ops.html" title="Advanced File/Directory Operations">
18
<link rel="chapter" href="gnome-vfs-file-async-ops.html" title="Asynchronous Operations">
19
<link rel="chapter" href="volumes.html" title="Volumes and Drives Handling">
20
<link rel="chapter" href="networking.html" title="Networking">
21
<link rel="chapter" href="mime-registry.html" title="MIME Registry">
22
<link rel="chapter" href="modules.html" title="Filesystem Modules">
24
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
25
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
27
<td><a accesskey="p" href="gnome-vfs-2.0-gnome-vfs-volume.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
28
<td><a accesskey="u" href="volumes.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
29
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
30
<th width="100%" align="center">GnomeVFS - Filesystem Abstraction library</th>
31
<td><a accesskey="n" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
33
<tr><td colspan="5" class="shortcuts">
34
<a href="#gnome-vfs-2.0-gnome-vfs-drive.synopsis" class="shortcut">Top</a>
36
<a href="#gnome-vfs-2.0-gnome-vfs-drive.description" class="shortcut">Description</a>
38
<a href="#gnome-vfs-2.0-gnome-vfs-drive.object-hierarchy" class="shortcut">Object Hierarchy</a>
40
<a href="#gnome-vfs-2.0-gnome-vfs-drive.signals" class="shortcut">Signals</a>
43
<div class="refentry" lang="en">
44
<a name="gnome-vfs-2.0-gnome-vfs-drive"></a><div class="titlepage"></div>
45
<div class="refnamediv"><table width="100%"><tr>
47
<h2><span class="refentrytitle"><a name="gnome-vfs-2.0-gnome-vfs-drive.top_of_page"></a>GnomeVFSDrive</span></h2>
48
<p>GnomeVFSDrive — Container for GnomeVFSVolume (floppy drive, CD reader, ...)</p>
50
<td valign="top" align="right"></td>
52
<div class="refsynopsisdiv">
53
<a name="gnome-vfs-2.0-gnome-vfs-drive.synopsis"></a><h2>Synopsis</h2>
54
<a name="GnomeVFSDrive"></a><pre class="synopsis">
55
enum <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDeviceType" title="enum GnomeVFSDeviceType">GnomeVFSDeviceType</a>;
56
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive-struct" title="GnomeVFSDrive">GnomeVFSDrive</a>;
57
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDriveClass" title="GnomeVFSDriveClass">GnomeVFSDriveClass</a>;
58
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GNOME-IS-VFS-DRIVE:CAPS" title="GNOME_IS_VFS_DRIVE()">GNOME_IS_VFS_DRIVE</a> (o)
59
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GNOME-IS-VFS-DRIVE-CLASS:CAPS" title="GNOME_IS_VFS_DRIVE_CLASS()">GNOME_IS_VFS_DRIVE_CLASS</a> (k)
60
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GNOME-VFS-TYPE-DRIVE:CAPS" title="GNOME_VFS_TYPE_DRIVE">GNOME_VFS_TYPE_DRIVE</a>
61
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GNOME-VFS-DRIVE:CAPS" title="GNOME_VFS_DRIVE()">GNOME_VFS_DRIVE</a> (o)
62
#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GNOME-VFS-DRIVE-CLASS:CAPS" title="GNOME_VFS_DRIVE_CLASS()">GNOME_VFS_DRIVE_CLASS</a> (k)
63
gint <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-compare" title="gnome_vfs_drive_compare ()">gnome_vfs_drive_compare</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *a,
64
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *b);
65
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-eject" title="gnome_vfs_drive_eject ()">gnome_vfs_drive_eject</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
66
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()">GnomeVFSVolumeOpCallback</a> callback,
68
char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-activation-uri" title="gnome_vfs_drive_get_activation_uri ()">gnome_vfs_drive_get_activation_uri</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
69
char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-device-path" title="gnome_vfs_drive_get_device_path ()">gnome_vfs_drive_get_device_path</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
70
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDeviceType" title="enum GnomeVFSDeviceType">GnomeVFSDeviceType</a> <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-device-type" title="gnome_vfs_drive_get_device_type ()">gnome_vfs_drive_get_device_type</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
71
char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-display-name" title="gnome_vfs_drive_get_display_name ()">gnome_vfs_drive_get_display_name</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
72
char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-hal-udi" title="gnome_vfs_drive_get_hal_udi ()">gnome_vfs_drive_get_hal_udi</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
73
char * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-icon" title="gnome_vfs_drive_get_icon ()">gnome_vfs_drive_get_icon</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
74
gulong <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-id" title="gnome_vfs_drive_get_id ()">gnome_vfs_drive_get_id</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
75
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volume" title="gnome_vfs_drive_get_mounted_volume ()">gnome_vfs_drive_get_mounted_volume</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
76
GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()">gnome_vfs_drive_get_mounted_volumes</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
77
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-volume-list-free" title="gnome_vfs_drive_volume_list_free ()">gnome_vfs_drive_volume_list_free</a> (GList *volumes);
78
GType <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-type" title="gnome_vfs_drive_get_type ()">gnome_vfs_drive_get_type</a> (void);
79
gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-is-connected" title="gnome_vfs_drive_is_connected ()">gnome_vfs_drive_is_connected</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
80
gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-is-mounted" title="gnome_vfs_drive_is_mounted ()">gnome_vfs_drive_is_mounted</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
81
gboolean <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-is-user-visible" title="gnome_vfs_drive_is_user_visible ()">gnome_vfs_drive_is_user_visible</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
82
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-mount" title="gnome_vfs_drive_mount ()">gnome_vfs_drive_mount</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
83
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()">GnomeVFSVolumeOpCallback</a> callback,
85
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-ref" title="gnome_vfs_drive_ref ()">gnome_vfs_drive_ref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
86
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-unmount" title="gnome_vfs_drive_unmount ()">gnome_vfs_drive_unmount</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
87
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()">GnomeVFSVolumeOpCallback</a> callback,
89
void <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-unref" title="gnome_vfs_drive_unref ()">gnome_vfs_drive_unref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);
92
<div class="refsect1" lang="en">
93
<a name="gnome-vfs-2.0-gnome-vfs-drive.object-hierarchy"></a><h2>Object Hierarchy</h2>
94
<pre class="synopsis">
99
<div class="refsect1" lang="en">
100
<a name="gnome-vfs-2.0-gnome-vfs-drive.signals"></a><h2>Signals</h2>
101
<pre class="synopsis">
102
"<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive-volume-mounted" title='The "volume-mounted" signal'>volume-mounted</a>" : Run First
103
"<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive-volume-pre-unmount" title='The "volume-pre-unmount" signal'>volume-pre-unmount</a>" : Run First
104
"<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive-volume-unmounted" title='The "volume-unmounted" signal'>volume-unmounted</a>" : Run First
107
<div class="refsect1" lang="en">
108
<a name="gnome-vfs-2.0-gnome-vfs-drive.description"></a><h2>Description</h2>
112
<div class="refsect1" lang="en">
113
<a name="gnome-vfs-2.0-gnome-vfs-drive.details"></a><h2>Details</h2>
114
<div class="refsect2" lang="en">
115
<a name="GnomeVFSDeviceType"></a><h3>enum GnomeVFSDeviceType</h3>
116
<pre class="programlisting">typedef enum {
117
GNOME_VFS_DEVICE_TYPE_UNKNOWN,
118
GNOME_VFS_DEVICE_TYPE_AUDIO_CD,
119
GNOME_VFS_DEVICE_TYPE_VIDEO_DVD,
120
GNOME_VFS_DEVICE_TYPE_HARDDRIVE,
121
GNOME_VFS_DEVICE_TYPE_CDROM,
122
GNOME_VFS_DEVICE_TYPE_FLOPPY,
123
GNOME_VFS_DEVICE_TYPE_ZIP,
124
GNOME_VFS_DEVICE_TYPE_JAZ,
125
GNOME_VFS_DEVICE_TYPE_NFS,
126
GNOME_VFS_DEVICE_TYPE_AUTOFS,
127
GNOME_VFS_DEVICE_TYPE_CAMERA,
128
GNOME_VFS_DEVICE_TYPE_MEMORY_STICK,
129
GNOME_VFS_DEVICE_TYPE_SMB,
130
GNOME_VFS_DEVICE_TYPE_APPLE,
131
GNOME_VFS_DEVICE_TYPE_MUSIC_PLAYER,
132
GNOME_VFS_DEVICE_TYPE_WINDOWS,
133
GNOME_VFS_DEVICE_TYPE_LOOPBACK,
134
GNOME_VFS_DEVICE_TYPE_NETWORK
135
} GnomeVFSDeviceType;
138
Identifies the device type of a <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> or a <span class="type">GnomeVFSDrive.</span></p>
141
<div class="variablelist"><table border="0">
142
<col align="left" valign="top">
145
<td><p><a name="GNOME-VFS-DEVICE-TYPE-UNKNOWN:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_UNKNOWN</code></span></p></td>
146
<td> the type of this <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> or <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> is not known.
150
<td><p><a name="GNOME-VFS-DEVICE-TYPE-AUDIO-CD:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_AUDIO_CD</code></span></p></td>
151
<td> only used for <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects. Denotes that this
152
volume is an audio CD.
156
<td><p><a name="GNOME-VFS-DEVICE-TYPE-VIDEO-DVD:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_VIDEO_DVD</code></span></p></td>
157
<td> only used for <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects. Denotes that this
158
volume is a video DVD.
162
<td><p><a name="GNOME-VFS-DEVICE-TYPE-HARDDRIVE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_HARDDRIVE</code></span></p></td>
163
<td> this is a mount point refering to a harddisk partition that
164
neither has a Microsoft file system (FAT, VFAT, NTFS) nor an Apple file system (HFS, HFS+).
168
<td><p><a name="GNOME-VFS-DEVICE-TYPE-CDROM:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_CDROM</code></span></p></td>
169
<td> this may either be a mount point or a HAL drive/volume. Either way,
170
it refers to a CD-ROM device respectively volume.
174
<td><p><a name="GNOME-VFS-DEVICE-TYPE-FLOPPY:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_FLOPPY</code></span></p></td>
175
<td> the volume or drive referenced by this <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> or
176
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> is a floppy disc respectively a floppy drive.
180
<td><p><a name="GNOME-VFS-DEVICE-TYPE-ZIP:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_ZIP</code></span></p></td>
181
<td> the volume or drive referenced by this <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> or
182
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> is a ZIP disc respectively a ZIP drive.
186
<td><p><a name="GNOME-VFS-DEVICE-TYPE-JAZ:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_JAZ</code></span></p></td>
187
<td> the volume or drive referenced by this <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> or
188
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> is a JAZ disc respectively a JAZ drive.
192
<td><p><a name="GNOME-VFS-DEVICE-TYPE-NFS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_NFS</code></span></p></td>
193
<td> this is a mount point having an NFS file system.
197
<td><p><a name="GNOME-VFS-DEVICE-TYPE-AUTOFS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_AUTOFS</code></span></p></td>
198
<td> this is a mount point having an AutoFS file system.
202
<td><p><a name="GNOME-VFS-DEVICE-TYPE-CAMERA:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_CAMERA</code></span></p></td>
203
<td> only used for <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects. Denotes that this volume is a camera.
207
<td><p><a name="GNOME-VFS-DEVICE-TYPE-MEMORY-STICK:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_MEMORY_STICK</code></span></p></td>
208
<td> only used for <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects. Denotes that this volume is a memory stick.
212
<td><p><a name="GNOME-VFS-DEVICE-TYPE-SMB:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_SMB</code></span></p></td>
213
<td> this is a mount point having a Samba file system.
217
<td><p><a name="GNOME-VFS-DEVICE-TYPE-APPLE:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_APPLE</code></span></p></td>
218
<td> this is a mount point refering to a harddisk partition, that has an
219
Apple file system (HFS, HFS+).
223
<td><p><a name="GNOME-VFS-DEVICE-TYPE-MUSIC-PLAYER:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_MUSIC_PLAYER</code></span></p></td>
224
<td> only used for <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects. Denotes that this
225
volume is a music player.
229
<td><p><a name="GNOME-VFS-DEVICE-TYPE-WINDOWS:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_WINDOWS</code></span></p></td>
230
<td> this is a mount point refering to a harddisk partition, that has a
231
Microsoft file system (FAT, VFAT, NTFS).
235
<td><p><a name="GNOME-VFS-DEVICE-TYPE-LOOPBACK:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_LOOPBACK</code></span></p></td>
236
<td> this is a mount point refering to a loopback device.
240
<td><p><a name="GNOME-VFS-DEVICE-TYPE-NETWORK:CAPS"></a><span class="term"><code class="literal">GNOME_VFS_DEVICE_TYPE_NETWORK</code></span></p></td>
241
<td> only used for <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects, denoting that this volume
242
refers to a network mount that is not managed by the kernel VFS but exclusively known to GnomeVFS.
249
<div class="refsect2" lang="en">
250
<a name="GnomeVFSDrive-struct"></a><h3>GnomeVFSDrive</h3>
251
<pre class="programlisting">typedef struct _GnomeVFSDrive GnomeVFSDrive;</pre>
256
<div class="refsect2" lang="en">
257
<a name="GnomeVFSDriveClass"></a><h3>GnomeVFSDriveClass</h3>
258
<pre class="programlisting">typedef struct {
259
GObjectClass parent_class;
261
void (* volume_mounted) (GnomeVFSDrive *drive,
262
GnomeVFSVolume *volume);
263
void (* volume_pre_unmount) (GnomeVFSDrive *drive,
264
GnomeVFSVolume *volume);
265
void (* volume_unmounted) (GnomeVFSDrive *drive,
266
GnomeVFSVolume *volume);
267
} GnomeVFSDriveClass;
273
<div class="refsect2" lang="en">
274
<a name="GNOME-IS-VFS-DRIVE:CAPS"></a><h3>GNOME_IS_VFS_DRIVE()</h3>
275
<pre class="programlisting">#define GNOME_IS_VFS_DRIVE(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNOME_VFS_TYPE_DRIVE))
279
<div class="variablelist"><table border="0">
280
<col align="left" valign="top">
282
<td><p><span class="term"><em class="parameter"><code>o</code></em> :</span></p></td>
289
<div class="refsect2" lang="en">
290
<a name="GNOME-IS-VFS-DRIVE-CLASS:CAPS"></a><h3>GNOME_IS_VFS_DRIVE_CLASS()</h3>
291
<pre class="programlisting">#define GNOME_IS_VFS_DRIVE_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GNOME_VFS_TYPE_DRIVE))
295
<div class="variablelist"><table border="0">
296
<col align="left" valign="top">
298
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
305
<div class="refsect2" lang="en">
306
<a name="GNOME-VFS-TYPE-DRIVE:CAPS"></a><h3>GNOME_VFS_TYPE_DRIVE</h3>
307
<pre class="programlisting">#define GNOME_VFS_TYPE_DRIVE (gnome_vfs_drive_get_type ())
313
<div class="refsect2" lang="en">
314
<a name="GNOME-VFS-DRIVE:CAPS"></a><h3>GNOME_VFS_DRIVE()</h3>
315
<pre class="programlisting">#define GNOME_VFS_DRIVE(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GNOME_VFS_TYPE_DRIVE, GnomeVFSDrive))
319
<div class="variablelist"><table border="0">
320
<col align="left" valign="top">
322
<td><p><span class="term"><em class="parameter"><code>o</code></em> :</span></p></td>
329
<div class="refsect2" lang="en">
330
<a name="GNOME-VFS-DRIVE-CLASS:CAPS"></a><h3>GNOME_VFS_DRIVE_CLASS()</h3>
331
<pre class="programlisting">#define GNOME_VFS_DRIVE_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), GNOME_VFS_TYPE_DRIVE, GnomeVFSDriveClass))
335
<div class="variablelist"><table border="0">
336
<col align="left" valign="top">
338
<td><p><span class="term"><em class="parameter"><code>k</code></em> :</span></p></td>
345
<div class="refsect2" lang="en">
346
<a name="gnome-vfs-drive-compare"></a><h3>gnome_vfs_drive_compare ()</h3>
347
<pre class="programlisting">gint gnome_vfs_drive_compare (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *a,
348
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *b);</pre>
350
Compares two <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> objects <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em>. Two
351
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> objects referring to different drives
352
are guaranteed to not return 0 when comparing them,
353
if they refer to the same drive 0 is returned.
356
The resulting <span class="type">gint</span> should be used to determine the
357
order in which <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em> are displayed in graphical
361
The comparison algorithm first of all peeks the device
362
type of <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em>, they will be sorted in the following
365
<div class="itemizedlist"><ul type="disc">
366
<li><p>Magnetic and opto-magnetic drives (ZIP, floppy)</p></li>
367
<li><p>Optical drives (CD, DVD)</p></li>
368
<li><p>External drives (USB sticks, music players)</p></li>
369
<li><p>Mounted hard disks<</p></li>
370
<li><p>Other drives<</p></li>
375
Afterwards, the display name of <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em> is compared
376
using a locale-sensitive sorting algorithm, which
377
involves <code class="function">g_utf8_collate_key()</code>.
380
If two drives have the same display name, their
381
unique ID is compared which can be queried using
382
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-id" title="gnome_vfs_drive_get_id ()"><code class="function">gnome_vfs_drive_get_id()</code></a>.</p>
385
<div class="variablelist"><table border="0">
386
<col align="left" valign="top">
389
<td><p><span class="term"><em class="parameter"><code>a</code></em> :</span></p></td>
390
<td> a <span class="type">GnomeVFSDrive.</span>
394
<td><p><span class="term"><em class="parameter"><code>b</code></em> :</span></p></td>
395
<td> a <span class="type">GnomeVFSDrive.</span>
399
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
400
<td> 0 if the drives refer to the same <em class="parameter"><code>GnomeVFSDrive</code></em>,
401
a negative value if <em class="parameter"><code>a</code></em> should be displayed before <em class="parameter"><code>b</code></em>,
402
or a positive value if <em class="parameter"><code>a</code></em> should be displayed after <em class="parameter"><code>b</code></em>.
408
<p class="since">Since 2.6</p>
411
<div class="refsect2" lang="en">
412
<a name="gnome-vfs-drive-eject"></a><h3>gnome_vfs_drive_eject ()</h3>
413
<pre class="programlisting">void gnome_vfs_drive_eject (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
414
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()">GnomeVFSVolumeOpCallback</a> callback,
415
gpointer user_data);</pre>
417
If <em class="parameter"><code>drive</code></em> has associated <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects, all of them will be
418
unmounted by calling <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#gnome-vfs-volume-unmount" title="gnome_vfs_volume_unmount ()"><code class="function">gnome_vfs_volume_unmount()</code></a> for each volume in
419
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()"><code class="function">gnome_vfs_drive_get_mounted_volumes()</code></a>, except for the last one,
420
for which <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#gnome-vfs-volume-eject" title="gnome_vfs_volume_eject ()"><code class="function">gnome_vfs_volume_eject()</code></a> is called to ensure that the
421
<em class="parameter"><code>drive</code></em>'s media is ejected.
424
If <em class="parameter"><code>drive</code></em> however has no associated <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects, it
425
simply calls an unmount helper on the <em class="parameter"><code>drive</code></em>.</p>
428
<div class="variablelist"><table border="0">
429
<col align="left" valign="top">
432
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
433
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> that should be ejcted.
437
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
438
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()"><span class="type">GnomeVFSVolumeOpCallback</span></a> that should be invoked after ejecting <em class="parameter"><code>drive</code></em>.
442
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
443
<td> the user data to pass to <em class="parameter"><code>callback</code></em>.
448
<p class="since">Since 2.6</p>
451
<div class="refsect2" lang="en">
452
<a name="gnome-vfs-drive-get-activation-uri"></a><h3>gnome_vfs_drive_get_activation_uri ()</h3>
453
<pre class="programlisting">char * gnome_vfs_drive_get_activation_uri (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
455
Returns the activation URI of a <span class="type">GnomeVFSDrive.</span>
458
The returned URI usually refers to a valid location. You can check the
459
validity of the location by calling <a class="link" href="gnome-vfs-2.0-gnome-vfs-uri.html#gnome-vfs-uri-new" title="gnome_vfs_uri_new ()"><code class="function">gnome_vfs_uri_new()</code></a> with the URI,
460
and checking whether the return value is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
463
<div class="variablelist"><table border="0">
464
<col align="left" valign="top">
467
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
468
<td> a <span class="type">GnomeVFSDrive.</span>
472
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
473
<td> a newly allocated string for the activation uri of the <span class="type">drive.</span>
479
<p class="since">Since 2.6</p>
482
<div class="refsect2" lang="en">
483
<a name="gnome-vfs-drive-get-device-path"></a><h3>gnome_vfs_drive_get_device_path ()</h3>
484
<pre class="programlisting">char * gnome_vfs_drive_get_device_path (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
486
Returns the device path of a <span class="type">GnomeVFSDrive.</span>
489
For HAL drives, this returns the value of the
490
drives's "block.device" key. For UNIX mounts,
491
it returns the <code class="literal">mntent</code>'s <code class="literal">mnt_fsname</code> entry.
494
Otherwise, it returns <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
497
<div class="variablelist"><table border="0">
498
<col align="left" valign="top">
501
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
502
<td> a <span class="type">GnomeVFSDrive.</span>
506
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
507
<td> a newly allocated string for the device path of the <span class="type">drive.</span>
513
<p class="since">Since 2.6</p>
516
<div class="refsect2" lang="en">
517
<a name="gnome-vfs-drive-get-device-type"></a><h3>gnome_vfs_drive_get_device_type ()</h3>
518
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDeviceType" title="enum GnomeVFSDeviceType">GnomeVFSDeviceType</a> gnome_vfs_drive_get_device_type (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
521
<div class="variablelist"><table border="0">
522
<col align="left" valign="top">
525
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
526
<td> a <span class="type">GnomeVFSDrive.</span>
530
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
531
<td> device type, a <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDeviceType" title="enum GnomeVFSDeviceType"><span class="type">GnomeVFSDeviceType</span></a> value.
537
<p class="since">Since 2.6</p>
540
<div class="refsect2" lang="en">
541
<a name="gnome-vfs-drive-get-display-name"></a><h3>gnome_vfs_drive_get_display_name ()</h3>
542
<pre class="programlisting">char * gnome_vfs_drive_get_display_name (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
545
<div class="variablelist"><table border="0">
546
<col align="left" valign="top">
549
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
550
<td> a <span class="type">GnomeVFSDrive.</span>
554
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
555
<td> a newly allocated string for the display name of the <em class="parameter"><code>drive</code></em>.
561
<p class="since">Since 2.6</p>
564
<div class="refsect2" lang="en">
565
<a name="gnome-vfs-drive-get-hal-udi"></a><h3>gnome_vfs_drive_get_hal_udi ()</h3>
566
<pre class="programlisting">char * gnome_vfs_drive_get_hal_udi (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
568
Returns the HAL UDI of a <span class="type">GnomeVFSDrive.</span>
571
For HAL drives, this matches the value of the "info.udi" key,
572
for other drives it is <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
575
<div class="variablelist"><table border="0">
576
<col align="left" valign="top">
579
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
580
<td> a <span class="type">GnomeVFSDrive.</span>
584
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
585
<td> a newly allocated string for the unique device id of the <em class="parameter"><code>drive</code></em>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
591
<p class="since">Since 2.6</p>
594
<div class="refsect2" lang="en">
595
<a name="gnome-vfs-drive-get-icon"></a><h3>gnome_vfs_drive_get_icon ()</h3>
596
<pre class="programlisting">char * gnome_vfs_drive_get_icon (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
599
<div class="variablelist"><table border="0">
600
<col align="left" valign="top">
603
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
604
<td> a <span class="type">GnomeVFSDrive.</span>
608
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
609
<td> a newly allocated string for the icon filename of the <em class="parameter"><code>drive</code></em>.
615
<p class="since">Since 2.6</p>
618
<div class="refsect2" lang="en">
619
<a name="gnome-vfs-drive-get-id"></a><h3>gnome_vfs_drive_get_id ()</h3>
620
<pre class="programlisting">gulong gnome_vfs_drive_get_id (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
623
<div class="variablelist"><table border="0">
624
<col align="left" valign="top">
627
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
628
<td> a <span class="type">GnomeVFSDrive.</span>
632
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
633
<td> drive id, a <span class="type">gulong</span> value.
639
<p class="since">Since 2.6</p>
642
<div class="refsect2" lang="en">
643
<a name="gnome-vfs-drive-get-mounted-volume"></a><h3>gnome_vfs_drive_get_mounted_volume ()</h3>
644
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> * gnome_vfs_drive_get_mounted_volume (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
645
<div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
646
<h3 class="title">Warning</h3>
647
<p><code class="literal">gnome_vfs_drive_get_mounted_volume</code> is deprecated and should not be used in newly-written code. Use <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()"><code class="function">gnome_vfs_drive_get_mounted_volumes()</code></a> instead.</p>
650
Returns the first mounted volume for the <em class="parameter"><code>drive</code></em>.</p>
653
<div class="variablelist"><table border="0">
654
<col align="left" valign="top">
657
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
658
<td> a <span class="type">GnomeVFSDrive.</span>
662
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
663
<td> a <span class="type">GnomeVFSVolume.</span>
669
<p class="since">Since 2.6</p>
672
<div class="refsect2" lang="en">
673
<a name="gnome-vfs-drive-get-mounted-volumes"></a><h3>gnome_vfs_drive_get_mounted_volumes ()</h3>
674
<pre class="programlisting">GList * gnome_vfs_drive_get_mounted_volumes (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
677
<div class="variablelist"><table border="0">
678
<col align="left" valign="top">
681
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
682
<td> a <span class="type">GnomeVFSDrive.</span>
686
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
687
<td> list of mounted volumes for the <em class="parameter"><code>drive</code></em>.
693
<p class="since">Since 2.8</p>
696
<div class="refsect2" lang="en">
697
<a name="gnome-vfs-drive-volume-list-free"></a><h3>gnome_vfs_drive_volume_list_free ()</h3>
698
<pre class="programlisting">void gnome_vfs_drive_volume_list_free (GList *volumes);</pre>
700
Frees the list <em class="parameter"><code>volumes</code></em>, if it is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
703
<div class="variablelist"><table border="0">
704
<col align="left" valign="top">
706
<td><p><span class="term"><em class="parameter"><code>volumes</code></em> :</span></p></td>
707
<td> list of <span class="type">GnomeVFSVolumes</span> to be freed, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
711
<p class="since">Since 2.8</p>
714
<div class="refsect2" lang="en">
715
<a name="gnome-vfs-drive-get-type"></a><h3>gnome_vfs_drive_get_type ()</h3>
716
<pre class="programlisting">GType gnome_vfs_drive_get_type (void);</pre>
719
<div class="variablelist"><table border="0">
720
<col align="left" valign="top">
722
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
729
<div class="refsect2" lang="en">
730
<a name="gnome-vfs-drive-is-connected"></a><h3>gnome_vfs_drive_is_connected ()</h3>
731
<pre class="programlisting">gboolean gnome_vfs_drive_is_connected (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
734
<div class="variablelist"><table border="0">
735
<col align="left" valign="top">
738
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
739
<td> a <span class="type">GnomeVFSDrive.</span>
743
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
744
<td> <code class="literal">TRUE</code> if the <em class="parameter"><code>drive</code></em> is connected, <code class="literal">FALSE</code> otherwise.
750
<p class="since">Since 2.6</p>
753
<div class="refsect2" lang="en">
754
<a name="gnome-vfs-drive-is-mounted"></a><h3>gnome_vfs_drive_is_mounted ()</h3>
755
<pre class="programlisting">gboolean gnome_vfs_drive_is_mounted (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
758
<div class="variablelist"><table border="0">
759
<col align="left" valign="top">
762
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
763
<td> a <span class="type">GnomeVFSDrive.</span>
767
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
768
<td> <code class="literal">TRUE</code> if the <em class="parameter"><code>drive</code></em> is mounted, <code class="literal">FALSE</code> otherwise.
774
<p class="since">Since 2.6</p>
777
<div class="refsect2" lang="en">
778
<a name="gnome-vfs-drive-is-user-visible"></a><h3>gnome_vfs_drive_is_user_visible ()</h3>
779
<pre class="programlisting">gboolean gnome_vfs_drive_is_user_visible (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
781
Returns whether the <em class="parameter"><code>drive</code></em> is visible to the user. This
782
should be used by applications to determine whether it
783
is included in user interfaces listing available drives.</p>
786
<div class="variablelist"><table border="0">
787
<col align="left" valign="top">
790
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
791
<td> a <span class="type">GnomeVFSDrive.</span>
795
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
796
<td> <code class="literal">TRUE</code> if the <em class="parameter"><code>drive</code></em> is visible to the user, <code class="literal">FALSE</code> otherwise.
802
<p class="since">Since 2.6</p>
805
<div class="refsect2" lang="en">
806
<a name="gnome-vfs-drive-mount"></a><h3>gnome_vfs_drive_mount ()</h3>
807
<pre class="programlisting">void gnome_vfs_drive_mount (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
808
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()">GnomeVFSVolumeOpCallback</a> callback,
809
gpointer user_data);</pre>
812
<div class="variablelist"><table border="0">
813
<col align="left" valign="top">
816
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
817
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> that should be mounted.
821
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
822
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()"><span class="type">GnomeVFSVolumeOpCallback</span></a> that should be invoked after mounting <em class="parameter"><code>drive</code></em>.
826
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
827
<td> the user data to pass to <em class="parameter"><code>callback</code></em>.
832
<p class="since">Since 2.6</p>
835
<div class="refsect2" lang="en">
836
<a name="gnome-vfs-drive-ref"></a><h3>gnome_vfs_drive_ref ()</h3>
837
<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> * gnome_vfs_drive_ref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
839
Increases the refcount of the <em class="parameter"><code>drive</code></em> by 1, if it is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
842
<div class="variablelist"><table border="0">
843
<col align="left" valign="top">
846
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
847
<td> a <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
851
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
852
<td> the <em class="parameter"><code>drive</code></em> with its refcount increased by one,
853
or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if <em class="parameter"><code>drive</code></em> is <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
859
<p class="since">Since 2.6</p>
862
<div class="refsect2" lang="en">
863
<a name="gnome-vfs-drive-unmount"></a><h3>gnome_vfs_drive_unmount ()</h3>
864
<pre class="programlisting">void gnome_vfs_drive_unmount (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
865
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()">GnomeVFSVolumeOpCallback</a> callback,
866
gpointer user_data);</pre>
868
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-unmount" title="gnome_vfs_drive_unmount ()"><code class="function">gnome_vfs_drive_unmount()</code></a> invokes <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-eject" title="gnome_vfs_drive_eject ()"><code class="function">gnome_vfs_drive_eject()</code></a>, if the <em class="parameter"><code>drive</code></em> signals
869
that it should be ejected when it is unmounted. This may be true for CD-ROMs,
870
USB sticks and other devices, depending on the backend providing the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> <em class="parameter"><code>drive</code></em>.
873
If the <em class="parameter"><code>drive</code></em> does not signal that it should be ejected when it is unmounted,
874
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-unmount" title="gnome_vfs_drive_unmount ()"><code class="function">gnome_vfs_drive_unmount()</code></a> calls <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#gnome-vfs-volume-unmount" title="gnome_vfs_volume_unmount ()"><code class="function">gnome_vfs_volume_unmount()</code></a> for each of the
875
<em class="parameter"><code>drive</code></em>'s mounted <span class="type">GnomeVFSVolumes</span>, which can be queried using
876
<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()"><code class="function">gnome_vfs_drive_get_mounted_volumes()</code></a>.</p>
879
<div class="variablelist"><table border="0">
880
<col align="left" valign="top">
883
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
884
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> that should be unmounted.
888
<td><p><span class="term"><em class="parameter"><code>callback</code></em> :</span></p></td>
889
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolumeOpCallback" title="GnomeVFSVolumeOpCallback ()"><span class="type">GnomeVFSVolumeOpCallback</span></a> that should be invoked after unmounting <em class="parameter"><code>drive</code></em>.
893
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
894
<td> the user data to pass to <em class="parameter"><code>callback</code></em>.
899
<p class="since">Since 2.6</p>
902
<div class="refsect2" lang="en">
903
<a name="gnome-vfs-drive-unref"></a><h3>gnome_vfs_drive_unref ()</h3>
904
<pre class="programlisting">void gnome_vfs_drive_unref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive);</pre>
906
Decreases the refcount of the <em class="parameter"><code>drive</code></em> by 1, if it is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.</p>
909
<div class="variablelist"><table border="0">
910
<col align="left" valign="top">
912
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
913
<td> a <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.
917
<p class="since">Since 2.6</p>
920
<div class="refsect1" lang="en">
921
<a name="gnome-vfs-2.0-gnome-vfs-drive.signal-details"></a><h2>Signal Details</h2>
922
<div class="refsect2" lang="en">
923
<a name="GnomeVFSDrive-volume-mounted"></a><h3>The <code class="literal">"volume-mounted"</code> signal</h3>
924
<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
925
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> *volume,
926
gpointer user_data) : Run First</pre>
928
This signal is emitted after the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> <em class="parameter"><code>volume</code></em> has been mounted.
931
When the <em class="parameter"><code>volume</code></em> is mounted, it is added to the <em class="parameter"><code>drive</code></em>'s list of mounted
932
volumes, which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()"><code class="function">gnome_vfs_drive_get_mounted_volumes()</code></a>.
935
It is also added to the list of the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a>'s list of mounted
936
volumes, which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-get-mounted-volumes" title="gnome_vfs_volume_monitor_get_mounted_volumes ()"><code class="function">gnome_vfs_volume_monitor_get_mounted_volumes()</code></a>.</p>
939
<div class="variablelist"><table border="0">
940
<col align="left" valign="top">
943
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
944
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> which received the signal.
948
<td><p><span class="term"><em class="parameter"><code>volume</code></em> :</span></p></td>
949
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> that has been mounted.
953
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
954
<td>user data set when the signal handler was connected.</td>
960
<div class="refsect2" lang="en">
961
<a name="GnomeVFSDrive-volume-pre-unmount"></a><h3>The <code class="literal">"volume-pre-unmount"</code> signal</h3>
962
<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
963
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> *volume,
964
gpointer user_data) : Run First</pre>
966
This signal is emitted when the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> <em class="parameter"><code>volume</code></em>, which has been present in
967
the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> <em class="parameter"><code>drive</code></em>, is about to be unmounted.
970
When the <em class="parameter"><code>volume</code></em> is unmounted, it is removed from the <em class="parameter"><code>drive</code></em>'s list of mounted
971
volumes, which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()"><code class="function">gnome_vfs_drive_get_mounted_volumes()</code></a>.
974
It is also removed from the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a>'s list of mounted volumes,
975
which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-get-mounted-volumes" title="gnome_vfs_volume_monitor_get_mounted_volumes ()"><code class="function">gnome_vfs_volume_monitor_get_mounted_volumes()</code></a>.
978
When a client application receives this signal, it must free all resources
979
associated with the <em class="parameter"><code>volume</code></em>, for instance cancel all pending file operations
980
on the <em class="parameter"><code>volume</code></em>, and cancel all pending file monitors using <a class="link" href="gnome-vfs-2.0-gnome-vfs-monitor.html#gnome-vfs-monitor-cancel" title="gnome_vfs_monitor_cancel ()"><code class="function">gnome_vfs_monitor_cancel()</code></a>.</p>
983
<div class="variablelist"><table border="0">
984
<col align="left" valign="top">
987
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
988
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> which received the signal.
992
<td><p><span class="term"><em class="parameter"><code>volume</code></em> :</span></p></td>
993
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> that is about to be unmounted.
997
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
998
<td>user data set when the signal handler was connected.</td>
1004
<div class="refsect2" lang="en">
1005
<a name="GnomeVFSDrive-volume-unmounted"></a><h3>The <code class="literal">"volume-unmounted"</code> signal</h3>
1006
<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,
1007
<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> *volume,
1008
gpointer user_data) : Run First</pre>
1010
This signal is emitted after the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> <em class="parameter"><code>volume</code></em>, which had been present in
1011
the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> <em class="parameter"><code>drive</code></em>, has been unmounted.
1014
When the <em class="parameter"><code>volume</code></em> is unmounted, it is removed from the <em class="parameter"><code>drive</code></em>'s list of mounted
1015
volumes, which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-get-mounted-volumes" title="gnome_vfs_drive_get_mounted_volumes ()"><code class="function">gnome_vfs_drive_get_mounted_volumes()</code></a>.
1018
It is also removed from the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a>'s list of mounted volumes,
1019
which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-get-mounted-volumes" title="gnome_vfs_volume_monitor_get_mounted_volumes ()"><code class="function">gnome_vfs_volume_monitor_get_mounted_volumes()</code></a>.</p>
1022
<div class="variablelist"><table border="0">
1023
<col align="left" valign="top">
1026
<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>
1027
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> which received the signal.
1031
<td><p><span class="term"><em class="parameter"><code>volume</code></em> :</span></p></td>
1032
<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> that has been unmounted.
1036
<td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
1037
<td>user data set when the signal handler was connected.</td>
1044
<div class="footer">
1046
Generated by GTK-Doc V1.12</div>