~ubuntu-branches/ubuntu/natty/gnome-vfs/natty

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GNOME-IS-VFS-VOLUME-MONITOR:CAPS" title="GNOME_IS_VFS_VOLUME_MONITOR()">GNOME_IS_VFS_VOLUME_MONITOR</a> (o)

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GNOME-IS-VFS-VOLUME-MONITOR-CLASS:CAPS" title="GNOME_IS_VFS_VOLUME_MONITOR_CLASS()">GNOME_IS_VFS_VOLUME_MONITOR_CLASS</a> (k)

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GNOME-VFS-TYPE-VOLUME-MONITOR:CAPS" title="GNOME_VFS_TYPE_VOLUME_MONITOR">GNOME_VFS_TYPE_VOLUME_MONITOR</a>

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GNOME-VFS-VOLUME-MONITOR:CAPS" title="GNOME_VFS_VOLUME_MONITOR()">GNOME_VFS_VOLUME_MONITOR</a> (o)

#define <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GNOME-VFS-VOLUME-MONITOR-CLASS:CAPS" title="GNOME_VFS_VOLUME_MONITOR_CLASS()">GNOME_VFS_VOLUME_MONITOR_CLASS</a> (k)

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor-struct" title="GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a>;

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitorClass" title="GnomeVFSVolumeMonitorClass">GnomeVFSVolumeMonitorClass</a>;

GList * <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-get-connected-drives" title="gnome_vfs_volume_monitor_get_connected_drives ()">gnome_vfs_volume_monitor_get_connected_drives</a>

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);

<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-volume-monitor.html#gnome-vfs-volume-monitor-get-drive-by-id" title="gnome_vfs_volume_monitor_get_drive_by_id ()">gnome_vfs_volume_monitor_get_drive_by_id</a>

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

gulong id);

GList * <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 ()">gnome_vfs_volume_monitor_get_mounted_volumes</a>

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);

GType <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-get-type" title="gnome_vfs_volume_monitor_get_type ()">gnome_vfs_volume_monitor_get_type</a> (void);

<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-volume-monitor.html#gnome-vfs-volume-monitor-get-volume-by-id" title="gnome_vfs_volume_monitor_get_volume_by_id ()">gnome_vfs_volume_monitor_get_volume_by_id</a>

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

gulong id);

<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-volume-monitor.html#gnome-vfs-volume-monitor-get-volume-for-path" title="gnome_vfs_volume_monitor_get_volume_for_path ()">gnome_vfs_volume_monitor_get_volume_for_path</a>

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

const char *path);

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> * <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-ref" title="gnome_vfs_volume_monitor_ref ()">gnome_vfs_volume_monitor_ref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);

void <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-unref" title="gnome_vfs_volume_monitor_unref ()">gnome_vfs_volume_monitor_unref</a> (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);

</pre>

</div>

<a name="gnome-vfs-2.0-gnome-vfs-volume-monitor.object-hierarchy"></a><h2>Object Hierarchy</h2>

GObject

+----GnomeVFSVolumeMonitor

</pre>

</div>

<a name="gnome-vfs-2.0-gnome-vfs-volume-monitor.signals"></a><h2>Signals</h2>

"<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor-drive-connected" title='The "drive-connected" signal'>drive-connected</a>" : Run First

"<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor-drive-disconnected" title='The "drive-disconnected" signal'>drive-disconnected</a>" : Run First

"<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor-volume-mounted" title='The "volume-mounted" signal'>volume-mounted</a>" : Run First

"<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor-volume-pre-unmount" title='The "volume-pre-unmount" signal'>volume-pre-unmount</a>" : Run First

"<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor-volume-unmounted" title='The "volume-unmounted" signal'>volume-unmounted</a>" : Run First

</pre>

</div>

<a name="gnome-vfs-2.0-gnome-vfs-volume-monitor.description"></a><h2>Description</h2>

100

<p>

101

</p>

102

</div>

103

104

<a name="gnome-vfs-2.0-gnome-vfs-volume-monitor.details"></a><h2>Details</h2>

105

106

<a name="GNOME-IS-VFS-VOLUME-MONITOR:CAPS"></a><h3>GNOME_IS_VFS_VOLUME_MONITOR()</h3>

107

<pre class="programlisting">#define GNOME_IS_VFS_VOLUME_MONITOR(o) (G_TYPE_CHECK_INSTANCE_TYPE ((o), GNOME_VFS_TYPE_VOLUME_MONITOR))

108

</pre>

109

<p>

110

</p>

111

112

113

114

115

<td>

116

</td>

117

</tr></tbody>

118

</table></div>

119

</div>

120

<hr>

121

122

<a name="GNOME-IS-VFS-VOLUME-MONITOR-CLASS:CAPS"></a><h3>GNOME_IS_VFS_VOLUME_MONITOR_CLASS()</h3>

123

<pre class="programlisting">#define GNOME_IS_VFS_VOLUME_MONITOR_CLASS(k) (G_TYPE_CHECK_CLASS_TYPE ((k), GNOME_VFS_TYPE_VOLUME_MONITOR))

124

</pre>

125

<p>

126

</p>

127

128

129

130

131

<td>

132

</td>

133

</tr></tbody>

134

</table></div>

135

</div>

136

<hr>

137

138

<a name="GNOME-VFS-TYPE-VOLUME-MONITOR:CAPS"></a><h3>GNOME_VFS_TYPE_VOLUME_MONITOR</h3>

139

<pre class="programlisting">#define GNOME_VFS_TYPE_VOLUME_MONITOR (gnome_vfs_volume_monitor_get_type ())

140

</pre>

141

<p>

142

</p>

143

</div>

144

<hr>

145

146

<a name="GNOME-VFS-VOLUME-MONITOR:CAPS"></a><h3>GNOME_VFS_VOLUME_MONITOR()</h3>

147

<pre class="programlisting">#define GNOME_VFS_VOLUME_MONITOR(o) (G_TYPE_CHECK_INSTANCE_CAST ((o), GNOME_VFS_TYPE_VOLUME_MONITOR, GnomeVFSVolumeMonitor))

148

</pre>

149

<p>

150

</p>

151

152

153

154

155

<td>

156

</td>

157

</tr></tbody>

158

</table></div>

159

</div>

160

<hr>

161

162

<a name="GNOME-VFS-VOLUME-MONITOR-CLASS:CAPS"></a><h3>GNOME_VFS_VOLUME_MONITOR_CLASS()</h3>

163

<pre class="programlisting">#define GNOME_VFS_VOLUME_MONITOR_CLASS(k) (G_TYPE_CHECK_CLASS_CAST((k), GNOME_VFS_TYPE_VOLUME_MONITOR, GnomeVFSVolumeMonitorClass))

164

</pre>

165

<p>

166

</p>

167

168

169

170

171

<td>

172

</td>

173

</tr></tbody>

174

</table></div>

175

</div>

176

<hr>

177

178

<a name="GnomeVFSVolumeMonitor-struct"></a><h3>GnomeVFSVolumeMonitor</h3>

179

<pre class="programlisting">typedef struct _GnomeVFSVolumeMonitor GnomeVFSVolumeMonitor;</pre>

180

<p>

181

</p>

182

</div>

183

<hr>

184

185

<a name="GnomeVFSVolumeMonitorClass"></a><h3>GnomeVFSVolumeMonitorClass</h3>

186

<pre class="programlisting">typedef struct {

187

GObjectClass parent_class;

188

189

/* signals */

190

void (* volume_mounted) (GnomeVFSVolumeMonitor *volume_monitor,

191

GnomeVFSVolume *volume);

192

void (* volume_pre_unmount) (GnomeVFSVolumeMonitor *volume_monitor,

193

GnomeVFSVolume *volume);

194

void (* volume_unmounted) (GnomeVFSVolumeMonitor *volume_monitor,

195

GnomeVFSVolume *volume);

196

void (* drive_connected) (GnomeVFSVolumeMonitor *volume_monitor,

197

GnomeVFSDrive *drive);

198

void (* drive_disconnected) (GnomeVFSVolumeMonitor *volume_monitor,

199

GnomeVFSDrive *drive);

200

} GnomeVFSVolumeMonitorClass;

201

</pre>

202

<p>

203

</p>

204

</div>

205

<hr>

206

207

<a name="gnome-vfs-get-volume-monitor"></a><h3>gnome_vfs_get_volume_monitor ()</h3>

208

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> * gnome_vfs_get_volume_monitor (void);</pre>

209

<p>

210

Returns a pointer to the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> singleton.

211

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> is a singleton, this means it is guaranteed to

212

exist and be valid until <a class="link" href="gnome-vfs-2.0-gnome-vfs-init.html#gnome-vfs-shutdown" title="gnome_vfs_shutdown ()"><code class="function">gnome_vfs_shutdown()</code></a> is called. Consequently,

213

it doesn't need to be refcounted since gnome-vfs will hold a reference to

214

it until it is shut down.</p>

215

<p>

216

</p>

217

218

219

220

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

221

<td> a pointer to the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> singleton.

222

223

</td>

224

</tr></tbody>

225

</table></div>

226

<p class="since">Since 2.6</p>

227

</div>

228

<hr>

229

230

<a name="gnome-vfs-volume-monitor-get-connected-drives"></a><h3>gnome_vfs_volume_monitor_get_connected_drives ()</h3>

231

<pre class="programlisting">GList * gnome_vfs_volume_monitor_get_connected_drives

232

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);</pre>

233

<p>

234

Returns a <span class="type">GList</span> of all drives connected to the machine.

235

The <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> objects must be unreffed by the caller when

236

no longer needed with <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-unref" title="gnome_vfs_drive_unref ()"><code class="function">gnome_vfs_drive_unref()</code></a> and the <span class="type">GList</span> must

237

be freed.</p>

238

<p>

239

</p>

240

241

242

<tbody>

243

<tr>

244

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

245

<td> a <span class="type">GnomeVFSVolumeMonitor.</span>

246

</td>

247

</tr>

248

<tr>

249

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

250

<td> a <span class="type">GList</span> of all connected drives.

251

252

</td>

253

</tr>

254

</tbody>

255

</table></div>

256

<p class="since">Since 2.6</p>

257

</div>

258

<hr>

259

260

<a name="gnome-vfs-volume-monitor-get-drive-by-id"></a><h3>gnome_vfs_volume_monitor_get_drive_by_id ()</h3>

261

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> * gnome_vfs_volume_monitor_get_drive_by_id

262

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

263

gulong id);</pre>

264

<p>

265

Looks for a <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> whose id is <em class="parameter"><code>id</code></em>. A valid <em class="parameter"><code>volume_monitor</code></em> to pass

266

to this function can be acquired using <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-get-volume-monitor" title="gnome_vfs_get_volume_monitor ()"><code class="function">gnome_vfs_get_volume_monitor()</code></a></p>

267

<p>

268

</p>

269

270

271

<tbody>

272

<tr>

273

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

274

<td> a <span class="type">GnomeVFSVolumeMonitor.</span>

275

</td>

276

</tr>

277

<tr>

278

279

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> id to look for.

280

</td>

281

</tr>

282

<tr>

283

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

284

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> corresponding to <em class="parameter"><code>id</code></em>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no

285

<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> with a matching id could be found. The caller owns a

286

reference on the returned drive, and must call <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#gnome-vfs-drive-unref" title="gnome_vfs_drive_unref ()"><code class="function">gnome_vfs_drive_unref()</code></a>

287

when it no longer needs it.

288

289

</td>

290

</tr>

291

</tbody>

292

</table></div>

293

<p class="since">Since 2.6</p>

294

</div>

295

<hr>

296

297

<a name="gnome-vfs-volume-monitor-get-mounted-volumes"></a><h3>gnome_vfs_volume_monitor_get_mounted_volumes ()</h3>

298

<pre class="programlisting">GList * gnome_vfs_volume_monitor_get_mounted_volumes

299

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);</pre>

300

<p>

301

Gets the list of all the mounted <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> volumes.</p>

302

<p>

303

</p>

304

305

306

<tbody>

307

<tr>

308

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

309

<td> a <span class="type">GnomeVFSVolumeMonitor.</span>

310

</td>

311

</tr>

312

<tr>

313

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

314

<td> <span class="type">GList</span> of <span class="type">GnomeVFSVolume.</span> The <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> objects must be

315

unreffed by the caller when no longer needed with <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#gnome-vfs-volume-unref" title="gnome_vfs_volume_unref ()"><code class="function">gnome_vfs_volume_unref()</code></a>

316

and the <span class="type">GList</span> must be freed.

317

318

</td>

319

</tr>

320

</tbody>

321

</table></div>

322

<p class="since">Since 2.6</p>

323

</div>

324

<hr>

325

326

<a name="gnome-vfs-volume-monitor-get-type"></a><h3>gnome_vfs_volume_monitor_get_type ()</h3>

327

<pre class="programlisting">GType gnome_vfs_volume_monitor_get_type (void);</pre>

328

<p>

329

</p>

330

331

332

333

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

334

<td>

335

</td>

336

</tr></tbody>

337

</table></div>

338

</div>

339

<hr>

340

341

<a name="gnome-vfs-volume-monitor-get-volume-by-id"></a><h3>gnome_vfs_volume_monitor_get_volume_by_id ()</h3>

342

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> * gnome_vfs_volume_monitor_get_volume_by_id

343

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

344

gulong id);</pre>

345

<p>

346

Looks for a <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> whose id is <em class="parameter"><code>id</code></em>. A valid <em class="parameter"><code>volume_monitor</code></em> to pass

347

348

<p>

349

</p>

350

351

352

<tbody>

353

<tr>

354

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

355

<td> a <span class="type">GnomeVFSVolumeMonitor.</span>

356

</td>

357

</tr>

358

<tr>

359

360

<td> <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> id to look for.

361

</td>

362

</tr>

363

<tr>

364

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

365

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> corresponding to <em class="parameter"><code>id</code></em>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> if no

366

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> with a matching id could be found. The caller owns a

367

reference on the returned volume, and must call <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#gnome-vfs-volume-unref" title="gnome_vfs_volume_unref ()"><code class="function">gnome_vfs_volume_unref()</code></a>

368

when it no longer needs it.

369

370

</td>

371

</tr>

372

</tbody>

373

</table></div>

374

<p class="since">Since 2.6</p>

375

</div>

376

<hr>

377

378

<a name="gnome-vfs-volume-monitor-get-volume-for-path"></a><h3>gnome_vfs_volume_monitor_get_volume_for_path ()</h3>

379

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> * gnome_vfs_volume_monitor_get_volume_for_path

380

(<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

381

const char *path);</pre>

382

<p>

383

Returns the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> corresponding to <em class="parameter"><code>path</code></em>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

384

</p>

385

<p>

386

The volume referring to <em class="parameter"><code>path</code></em> is found by calling <code class="literal">stat</code> on <em class="parameter"><code>path</code></em>,

387

and then iterating through the list of volumes that refer

388

to currently mounted local file systems.

389

The first volume in this list maching the <em class="parameter"><code>path</code></em>'s UNIX device

390

is returned.

391

</p>

392

<p>

393

If the <code class="literal">stat</code> on <em class="parameter"><code>path</code></em> was not successful, or no volume matches <em class="parameter"><code>path</code></em>,

394

or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a> is returned.</p>

395

<p>

396

</p>

397

398

399

<tbody>

400

<tr>

401

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

402

<td> a <span class="type">GnomeVFSVolumeMonitor.</span>

403

</td>

404

</tr>

405

<tr>

406

407

<td> string representing a path.

408

</td>

409

</tr>

410

<tr>

411

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

412

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume"><span class="type">GnomeVFSVolume</span></a> corresponding to the <em class="parameter"><code>path</code></em>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>. Volume returned

413

must be unreffed by the caller with <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#gnome-vfs-volume-unref" title="gnome_vfs_volume_unref ()"><code class="function">gnome_vfs_volume_unref()</code></a>.

414

415

</td>

416

</tr>

417

</tbody>

418

</table></div>

419

<p class="since">Since 2.6</p>

420

</div>

421

<hr>

422

423

<a name="gnome-vfs-volume-monitor-ref"></a><h3>gnome_vfs_volume_monitor_ref ()</h3>

424

<pre class="programlisting"><a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> * gnome_vfs_volume_monitor_ref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);</pre>

425

<p>

426

Increases the refcount of <em class="parameter"><code>volume_monitor</code></em> by one, if it is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

427

</p>

428

<p>

429

You shouldn't use this function unless you know what you are doing:

430

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> is to be used as a singleton object, see

431

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-get-volume-monitor" title="gnome_vfs_get_volume_monitor ()"><code class="function">gnome_vfs_get_volume_monitor()</code></a> for more details.</p>

432

<p>

433

</p>

434

435

436

<tbody>

437

<tr>

438

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

439

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

440

</td>

441

</tr>

442

<tr>

443

<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>

444

<td> <em class="parameter"><code>volume_monitor</code></em> with its refcount increased by one,

445

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>volume_monitor</code></em> is <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

446

447

</td>

448

</tr>

449

</tbody>

450

</table></div>

451

<p class="since">Since 2.6</p>

452

</div>

453

<hr>

454

455

<a name="gnome-vfs-volume-monitor-unref"></a><h3>gnome_vfs_volume_monitor_unref ()</h3>

456

<pre class="programlisting">void gnome_vfs_volume_monitor_unref (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor);</pre>

457

<p>

458

Decreases the refcount of <em class="parameter"><code>volume_monitor</code></em> by one, if it is not <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

459

</p>

460

<p>

461

You shouldn't use this function unless you know what you are doing:

462

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> is to be used as a singleton object, see

463

464

<p>

465

</p>

466

467

468

469

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

470

<td> <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a>, or <a href="/gnome/usr/share/gtk-doc/html/liboil/liboil-liboiljunk.html#NULL:CAPS"><code class="literal">NULL</code></a>.

471

</td>

472

</tr></tbody>

473

</table></div>

474

<p class="since">Since 2.6</p>

475

</div>

476

</div>

477

478

<a name="gnome-vfs-2.0-gnome-vfs-volume-monitor.signal-details"></a><h2>Signal Details</h2>

479

480

<a name="GnomeVFSVolumeMonitor-drive-connected"></a><h3>The <code class="literal">"drive-connected"</code> signal</h3>

481

<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

482

<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,

483

gpointer user_data) : Run First</pre>

484

<p>

485

This signal is emitted when 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 connected.

486

</p>

487

<p>

488

When the <em class="parameter"><code>drive</code></em> is connected, it is present in the <em class="parameter"><code>volume_monitor</code></em>'s list of connected

489

drives, which can be queried using <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#gnome-vfs-volume-monitor-get-connected-drives" title="gnome_vfs_volume_monitor_get_connected_drives ()"><code class="function">gnome_vfs_volume_monitor_get_connected_drives()</code></a>.</p>

490

<p>

491

</p>

492

493

494

<tbody>

495

<tr>

496

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

497

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> which received the signal.

498

</td>

499

</tr>

500

<tr>

501

<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>

502

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> that has been connected.

503

</td>

504

</tr>

505

<tr>

506

507

<td>user data set when the signal handler was connected.</td>

508

</tr>

509

</tbody>

510

</table></div>

511

</div>

512

<hr>

513

514

<a name="GnomeVFSVolumeMonitor-drive-disconnected"></a><h3>The <code class="literal">"drive-disconnected"</code> signal</h3>

515

<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

516

<a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive">GnomeVFSDrive</a> *drive,

517

gpointer user_data) : Run First</pre>

518

<p>

519

This signal is emitted after 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 disconnected.

520

</p>

521

<p>

522

When the <em class="parameter"><code>drive</code></em> is disconnected, it is removed from the <em class="parameter"><code>volume_monitor</code></em>'s list of connected

523

524

<p>

525

</p>

526

527

528

<tbody>

529

<tr>

530

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

531

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> which received the signal.

532

</td>

533

</tr>

534

<tr>

535

<td><p><span class="term"><em class="parameter"><code>drive</code></em> :</span></p></td>

536

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a> that has been disconnected.

537

</td>

538

</tr>

539

<tr>

540

541

<td>user data set when the signal handler was connected.</td>

542

</tr>

543

</tbody>

544

</table></div>

545

</div>

546

<hr>

547

548

<a name="GnomeVFSVolumeMonitor-volume-mounted"></a><h3>The <code class="literal">"volume-mounted"</code> signal</h3>

549

<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

550

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> *volume,

551

gpointer user_data) : Run First</pre>

552

<p>

553

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.

554

</p>

555

<p>

556

When the <em class="parameter"><code>volume</code></em> is mounted, it is present in the <em class="parameter"><code>volume_monitor</code></em>'s list of mounted

557

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>.

558

</p>

559

<p>

560

If the <em class="parameter"><code>volume</code></em> has an associated <a class="link" href="gnome-vfs-2.0-gnome-vfs-drive.html#GnomeVFSDrive"><span class="type">GnomeVFSDrive</span></a>, it also appears in the drive's

561

list of mounted 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>.</p>

562

<p>

563

</p>

564

565

566

<tbody>

567

<tr>

568

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

569

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> which received the signal.

570

</td>

571

</tr>

572

<tr>

573

<td><p><span class="term"><em class="parameter"><code>volume</code></em> :</span></p></td>

574

<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.

575

</td>

576

</tr>

577

<tr>

578

579

<td>user data set when the signal handler was connected.</td>

580

</tr>

581

</tbody>

582

</table></div>

583

</div>

584

<hr>

585

586

<a name="GnomeVFSVolumeMonitor-volume-pre-unmount"></a><h3>The <code class="literal">"volume-pre-unmount"</code> signal</h3>

587

<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

588

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> *volume,

589

gpointer user_data) : Run First</pre>

590

<p>

591

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> is about to be unmounted.

592

</p>

593

<p>

594

When the <em class="parameter"><code>volume</code></em> is unmounted, it is removed from the <em class="parameter"><code>volume_monitor</code></em>'s list of mounted

595

596

</p>

597

<p>

598

599

600

</p>

601

<p>

602

When a client application receives this signal, it must free all resources

603

associated with the <em class="parameter"><code>volume</code></em>, for instance cancel all pending file operations

604

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>

605

<p>

606

</p>

607

608

609

<tbody>

610

<tr>

611

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

612

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> which received the signal.

613

</td>

614

</tr>

615

<tr>

616

<td><p><span class="term"><em class="parameter"><code>volume</code></em> :</span></p></td>

617

<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.

618

</td>

619

</tr>

620

<tr>

621

622

<td>user data set when the signal handler was connected.</td>

623

</tr>

624

</tbody>

625

</table></div>

626

</div>

627

<hr>

628

629

<a name="GnomeVFSVolumeMonitor-volume-unmounted"></a><h3>The <code class="literal">"volume-unmounted"</code> signal</h3>

630

<pre class="programlisting">void user_function (<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor">GnomeVFSVolumeMonitor</a> *volume_monitor,

631

<a class="link" href="gnome-vfs-2.0-gnome-vfs-volume.html#GnomeVFSVolume">GnomeVFSVolume</a> *volume,

632

gpointer user_data) : Run First</pre>

633

<p>

634

635

</p>

636

<p>

637

When the <em class="parameter"><code>volume</code></em> is unmounted, it is removed from the <em class="parameter"><code>volume_monitor</code></em>'s list of mounted

638

639

</p>

640

<p>

641

642

643

<p>

644

</p>

645

646

647

<tbody>

648

<tr>

649

<td><p><span class="term"><em class="parameter"><code>volume_monitor</code></em> :</span></p></td>

650

<td> the <a class="link" href="gnome-vfs-2.0-gnome-vfs-volume-monitor.html#GnomeVFSVolumeMonitor"><span class="type">GnomeVFSVolumeMonitor</span></a> which received the signal.

651

</td>

652

</tr>

653

<tr>

654

<td><p><span class="term"><em class="parameter"><code>volume</code></em> :</span></p></td>

655

<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.

656

</td>

657

</tr>

658

<tr>

659

660

<td>user data set when the signal handler was connected.</td>

661

</tr>

662

</tbody>

663

</table></div>

664

</div>

665

</div>

666

</div>

667

668

<hr>

669

Generated by GTK-Doc V1.12</div>

670

</body>

671

</html>

Older »