← Back to branch summary

~ubuntu-branches/ubuntu/jaunty/glib2.0/jaunty-updates

« back to all changes in this revision

Viewing changes to docs/reference/gio/xml/gvolume.xml

  • Committer: Bazaar Package Importer
  • Author(s): Sebastian Dröge
  • Date: 2009-03-14 10:53:26 UTC
  • mfrom: (1.2.44 upstream) (3.2.27 jaunty)
  • Revision ID: james.westby@ubuntu.com-20090314105326-6oo6zwt0xmc2jor2
Tags: 2.20.0-1
* New upstream stable release.
* Upload to unstable, remove check-dist include.
  This won't block any transitions because of symbol files.
* debian/libglib2.0-0.symbols,
  debian/rules:
  + Update for the API changes.

Show diffs side-by-side

added added

removed removed

Lines of Context:
docs/reference/gio/xml/gvolume.xml
139
139
<title role="details.title">Details</title>
140
140
<refsect2 id="GVolume-struct" role="struct">
141
141
<title>GVolume</title>
142
 
<indexterm zone="GVolume-struct"><primary sortas="GVolume">GVolume</primary></indexterm><programlisting>typedef struct _GVolume GVolume;</programlisting>
 
142
<indexterm zone="GVolume-struct"><primary sortas="Volume">GVolume</primary></indexterm><programlisting>typedef struct _GVolume GVolume;</programlisting>
143
143
<para>
144
144
Opaque mountable volume object.</para>
145
145
<para>
146
146
</para></refsect2>
147
147
<refsect2 id="GVolumeIface" role="struct">
148
148
<title>GVolumeIface</title>
149
 
<indexterm zone="GVolumeIface"><primary sortas="GVolumeIface">GVolumeIface</primary></indexterm><programlisting>typedef struct {
 
149
<indexterm zone="GVolumeIface"><primary sortas="VolumeIface">GVolumeIface</primary></indexterm><programlisting>typedef struct {
150
150
  GTypeInterface g_iface;
151
151
 
152
152
  /* signals */
246
246
</varlistentry>
247
247
<varlistentry>
248
248
<term><structfield>mount_fn</structfield>&#160;()</term>
249
 
<listitem><simpara> Mounts a given <link linkend="GVolume"><type>GVolume</type></link>.
 
249
<listitem><simpara> Mounts a given <link linkend="GVolume"><type>GVolume</type></link>. 
 
250
    <link linkend="GVolume"><type>GVolume</type></link> implementations must emit the <link linkend="GMountOperation-aborted"><type>"aborted"</type></link> 
 
251
    signal before completing a mount operation that is aborted while 
 
252
    awaiting input from the user through a <link linkend="GMountOperation"><type>GMountOperation</type></link> instance.
250
253
</simpara></listitem>
251
254
</varlistentry>
252
255
<varlistentry>
290
293
</variablelist></refsect2>
291
294
<refsect2 id="g-volume-get-name" role="function">
292
295
<title>g_volume_get_name ()</title>
293
 
<indexterm zone="g-volume-get-name"><primary sortas="g_volume_get_name">g_volume_get_name</primary></indexterm><programlisting><link linkend="char">char</link> *              g_volume_get_name                   (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
296
<indexterm zone="g-volume-get-name"><primary sortas="volume_get_name">g_volume_get_name</primary></indexterm><programlisting><link linkend="char">char</link> *              g_volume_get_name                   (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
294
297
<para>
295
298
Gets the name of <parameter>volume</parameter>.</para>
296
299
<para>
304
307
</variablelist></refsect2>
305
308
<refsect2 id="g-volume-get-uuid" role="function">
306
309
<title>g_volume_get_uuid ()</title>
307
 
<indexterm zone="g-volume-get-uuid"><primary sortas="g_volume_get_uuid">g_volume_get_uuid</primary></indexterm><programlisting><link linkend="char">char</link> *              g_volume_get_uuid                   (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
310
<indexterm zone="g-volume-get-uuid"><primary sortas="volume_get_uuid">g_volume_get_uuid</primary></indexterm><programlisting><link linkend="char">char</link> *              g_volume_get_uuid                   (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
308
311
<para>
309
312
Gets the UUID for the <parameter>volume</parameter>. The reference is typically based on
310
313
the file system UUID for the volume in question and should be
322
325
</variablelist></refsect2>
323
326
<refsect2 id="g-volume-get-icon" role="function">
324
327
<title>g_volume_get_icon ()</title>
325
 
<indexterm zone="g-volume-get-icon"><primary sortas="g_volume_get_icon">g_volume_get_icon</primary></indexterm><programlisting><link linkend="GIcon">GIcon</link> *             g_volume_get_icon                   (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
328
<indexterm zone="g-volume-get-icon"><primary sortas="volume_get_icon">g_volume_get_icon</primary></indexterm><programlisting><link linkend="GIcon">GIcon</link> *             g_volume_get_icon                   (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
326
329
<para>
327
330
Gets the icon for <parameter>volume</parameter>.</para>
328
331
<para>
337
340
</variablelist></refsect2>
338
341
<refsect2 id="g-volume-get-drive" role="function">
339
342
<title>g_volume_get_drive ()</title>
340
 
<indexterm zone="g-volume-get-drive"><primary sortas="g_volume_get_drive">g_volume_get_drive</primary></indexterm><programlisting><link linkend="GDrive">GDrive</link> *            g_volume_get_drive                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
343
<indexterm zone="g-volume-get-drive"><primary sortas="volume_get_drive">g_volume_get_drive</primary></indexterm><programlisting><link linkend="GDrive">GDrive</link> *            g_volume_get_drive                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
341
344
<para>
342
345
Gets the drive for the <parameter>volume</parameter>.</para>
343
346
<para>
352
355
</variablelist></refsect2>
353
356
<refsect2 id="g-volume-get-mount" role="function">
354
357
<title>g_volume_get_mount ()</title>
355
 
<indexterm zone="g-volume-get-mount"><primary sortas="g_volume_get_mount">g_volume_get_mount</primary></indexterm><programlisting><link linkend="GMount">GMount</link> *            g_volume_get_mount                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
358
<indexterm zone="g-volume-get-mount"><primary sortas="volume_get_mount">g_volume_get_mount</primary></indexterm><programlisting><link linkend="GMount">GMount</link> *            g_volume_get_mount                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
356
359
<para>
357
360
Gets the mount for the <parameter>volume</parameter>.</para>
358
361
<para>
367
370
</variablelist></refsect2>
368
371
<refsect2 id="g-volume-can-mount" role="function">
369
372
<title>g_volume_can_mount ()</title>
370
 
<indexterm zone="g-volume-can-mount"><primary sortas="g_volume_can_mount">g_volume_can_mount</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_can_mount                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
373
<indexterm zone="g-volume-can-mount"><primary sortas="volume_can_mount">g_volume_can_mount</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_can_mount                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
371
374
<para>
372
375
Checks if a volume can be mounted.</para>
373
376
<para>
380
383
</variablelist></refsect2>
381
384
<refsect2 id="g-volume-should-automount" role="function">
382
385
<title>g_volume_should_automount ()</title>
383
 
<indexterm zone="g-volume-should-automount"><primary sortas="g_volume_should_automount">g_volume_should_automount</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_should_automount           (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
386
<indexterm zone="g-volume-should-automount"><primary sortas="volume_should_automount">g_volume_should_automount</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_should_automount           (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
384
387
<para>
385
388
Returns whether the volume should be automatically mounted.</para>
386
389
<para>
393
396
</variablelist></refsect2>
394
397
<refsect2 id="g-volume-get-activation-root" role="function" condition="since:2.18">
395
398
<title>g_volume_get_activation_root ()</title>
396
 
<indexterm zone="g-volume-get-activation-root" role="2.18"><primary sortas="g_volume_get_activation_root">g_volume_get_activation_root</primary></indexterm><programlisting><link linkend="GFile">GFile</link> *             g_volume_get_activation_root        (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
399
<indexterm zone="g-volume-get-activation-root" role="2.18"><primary sortas="volume_get_activation_root">g_volume_get_activation_root</primary></indexterm><programlisting><link linkend="GFile">GFile</link> *             g_volume_get_activation_root        (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
397
400
<para>
398
401
Gets the activation root for a <link linkend="GVolume"><type>GVolume</type></link> if it is known ahead of
399
402
mount time. Returns <link linkend="NULL--CAPS"><literal>NULL</literal></link> otherwise. If not <link linkend="NULL--CAPS"><literal>NULL</literal></link> and if <parameter>volume</parameter>
426
429
will always be <link linkend="TRUE--CAPS"><literal>TRUE</literal></link>.
427
430
</para>
428
431
<para>
429
 
There is a number of possible uses of this function.
430
 
</para>
431
 
<para>
432
 
First, implementations of <link linkend="GVolumeMonitor"><type>GVolumeMonitor</type></link> can use this method to
433
 
determine if a <link linkend="GMount"><type>GMount</type></link> should be adopted in the implementation of
434
 
<link linkend="g-volume-monitor-adopt-orphan-mount"><function>g_volume_monitor_adopt_orphan_mount()</function></link> by testing if the result of
435
 
this function equals (or has as prefix) the root of the given
436
 
<link linkend="GMount"><type>GMount</type></link>. In particular this is useful in the in-process proxy part
437
 
of an out-of-process volume monitor implementation.
438
 
</para>
439
 
<para>
440
 
Second, applications such as a file manager can use this to
441
 
navigate to the correct root in response to the user navigating to
442
 
a server. Now suppose there is a volume monitor for networked
443
 
servers that creates <link linkend="GVolume"><type>GVolume</type></link> objects corresponding to the
444
 
"favorite servers" (e.g. set up by the user via some "Connect to
445
 
Server" dialog). Suppose also that one of the favorite servers is
446
 
named "public_html @ fd.o" and the URI is
447
 
<literal>sftp://people.freedesktop.org/home/david/public_html</literal>.
448
 
</para>
449
 
<para>
450
 
Now, due to the way GIO works, when the corresponding <link linkend="GVolume"><type>GVolume</type></link> is
451
 
mounted then a <link linkend="GMount"><type>GMount</type></link> (typically adopted by the volume monitor)
452
 
will appear with the mount root (e.g. the result of
453
 
<link linkend="g-mount-get-root"><function>g_mount_get_root()</function></link>)
454
 
<literal>sftp://people.freedesktop.org</literal>. However, this
455
 
function (<link linkend="g-volume-get-activation-root"><function>g_volume_get_activation_root()</function></link>) can return a <link linkend="GFile"><type>GFile</type></link> for
456
 
the URI
457
 
<literal>sftp://people.freedesktop.org/home/david/public_html</literal>.
458
 
</para>
459
 
<para>
460
 
All this means that a file manager can use the latter URI for
461
 
navigating when the user clicks an icon representing the <link linkend="GVolume"><type>GVolume</type></link>
462
 
(e.g. clicking an icon with the name "public_html @ fd.o" or
463
 
similar).</para>
 
432
Activation roots are typically used in <link linkend="GVolumeMonitor"><type>GVolumeMonitor</type></link>
 
433
implementations to find the underlying mount to shadow, see
 
434
<link linkend="g-mount-is-shadowed"><function>g_mount_is_shadowed()</function></link> for more details.</para>
464
435
<para>
465
436
</para><variablelist role="params">
466
437
<varlistentry><term><parameter>volume</parameter>&#160;:</term>
473
444
</variablelist><para role="since">Since 2.18</para></refsect2>
474
445
<refsect2 id="g-volume-mount" role="function">
475
446
<title>g_volume_mount ()</title>
476
 
<indexterm zone="g-volume-mount"><primary sortas="g_volume_mount">g_volume_mount</primary></indexterm><programlisting><link linkend="void">void</link>                g_volume_mount                      (<link linkend="GVolume">GVolume</link> *volume,
 
447
<indexterm zone="g-volume-mount"><primary sortas="volume_mount">g_volume_mount</primary></indexterm><programlisting><link linkend="void">void</link>                g_volume_mount                      (<link linkend="GVolume">GVolume</link> *volume,
477
448
                                                         <link linkend="GMountMountFlags">GMountMountFlags</link> flags,
478
449
                                                         <link linkend="GMountOperation">GMountOperation</link> *mount_operation,
479
450
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
506
477
</variablelist></refsect2>
507
478
<refsect2 id="g-volume-mount-finish" role="function">
508
479
<title>g_volume_mount_finish ()</title>
509
 
<indexterm zone="g-volume-mount-finish"><primary sortas="g_volume_mount_finish">g_volume_mount_finish</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_mount_finish               (<link linkend="GVolume">GVolume</link> *volume,
 
480
<indexterm zone="g-volume-mount-finish"><primary sortas="volume_mount_finish">g_volume_mount_finish</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_mount_finish               (<link linkend="GVolume">GVolume</link> *volume,
510
481
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *result,
511
482
                                                         <link linkend="GError">GError</link> **error);</programlisting>
512
483
<para>
513
484
Finishes mounting a volume. If any errors occured during the operation,
514
 
<parameter>error</parameter> will be set to contain the errors and <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> will be returned.</para>
 
485
<parameter>error</parameter> will be set to contain the errors and <link linkend="FALSE--CAPS"><literal>FALSE</literal></link> will be returned.
 
486
</para>
 
487
<para>
 
488
If the mount operation succeeded, <link linkend="g-volume-get-mount"><function>g_volume_get_mount()</function></link> on <parameter>volume</parameter>
 
489
is guaranteed to return the mount right after calling this
 
490
function; there's no need to listen for the 'mount-added' signal on
 
491
<link linkend="GVolumeMonitor"><type>GVolumeMonitor</type></link>.</para>
515
492
<para>
516
493
</para><variablelist role="params">
517
494
<varlistentry><term><parameter>volume</parameter>&#160;:</term>
528
505
</variablelist></refsect2>
529
506
<refsect2 id="g-volume-can-eject" role="function">
530
507
<title>g_volume_can_eject ()</title>
531
 
<indexterm zone="g-volume-can-eject"><primary sortas="g_volume_can_eject">g_volume_can_eject</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_can_eject                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
508
<indexterm zone="g-volume-can-eject"><primary sortas="volume_can_eject">g_volume_can_eject</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_can_eject                  (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
532
509
<para>
533
510
Checks if a volume can be ejected.</para>
534
511
<para>
541
518
</variablelist></refsect2>
542
519
<refsect2 id="g-volume-eject" role="function">
543
520
<title>g_volume_eject ()</title>
544
 
<indexterm zone="g-volume-eject"><primary sortas="g_volume_eject">g_volume_eject</primary></indexterm><programlisting><link linkend="void">void</link>                g_volume_eject                      (<link linkend="GVolume">GVolume</link> *volume,
 
521
<indexterm zone="g-volume-eject"><primary sortas="volume_eject">g_volume_eject</primary></indexterm><programlisting><link linkend="void">void</link>                g_volume_eject                      (<link linkend="GVolume">GVolume</link> *volume,
545
522
                                                         <link linkend="GMountUnmountFlags">GMountUnmountFlags</link> flags,
546
523
                                                         <link linkend="GCancellable">GCancellable</link> *cancellable,
547
524
                                                         <link linkend="GAsyncReadyCallback">GAsyncReadyCallback</link> callback,
570
547
</variablelist></refsect2>
571
548
<refsect2 id="g-volume-eject-finish" role="function">
572
549
<title>g_volume_eject_finish ()</title>
573
 
<indexterm zone="g-volume-eject-finish"><primary sortas="g_volume_eject_finish">g_volume_eject_finish</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_eject_finish               (<link linkend="GVolume">GVolume</link> *volume,
 
550
<indexterm zone="g-volume-eject-finish"><primary sortas="volume_eject_finish">g_volume_eject_finish</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link>            g_volume_eject_finish               (<link linkend="GVolume">GVolume</link> *volume,
574
551
                                                         <link linkend="GAsyncResult">GAsyncResult</link> *result,
575
552
                                                         <link linkend="GError">GError</link> **error);</programlisting>
576
553
<para>
592
569
</variablelist></refsect2>
593
570
<refsect2 id="G-VOLUME-IDENTIFIER-KIND-HAL-UDI--CAPS" role="macro">
594
571
<title>G_VOLUME_IDENTIFIER_KIND_HAL_UDI</title>
595
 
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-HAL-UDI--CAPS"><primary sortas="G_VOLUME_IDENTIFIER_KIND_HAL_UDI">G_VOLUME_IDENTIFIER_KIND_HAL_UDI</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_HAL_UDI "hal-udi"
 
572
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-HAL-UDI--CAPS"><primary sortas="VOLUME_IDENTIFIER_KIND_HAL_UDI">G_VOLUME_IDENTIFIER_KIND_HAL_UDI</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_HAL_UDI "hal-udi"
596
573
</programlisting>
597
574
<para>
598
575
The string used to obtain a Hal UDI with <link linkend="g-volume-get-identifier"><function>g_volume_get_identifier()</function></link>.</para>
600
577
</para></refsect2>
601
578
<refsect2 id="G-VOLUME-IDENTIFIER-KIND-LABEL--CAPS" role="macro">
602
579
<title>G_VOLUME_IDENTIFIER_KIND_LABEL</title>
603
 
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-LABEL--CAPS"><primary sortas="G_VOLUME_IDENTIFIER_KIND_LABEL">G_VOLUME_IDENTIFIER_KIND_LABEL</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_LABEL "label"
 
580
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-LABEL--CAPS"><primary sortas="VOLUME_IDENTIFIER_KIND_LABEL">G_VOLUME_IDENTIFIER_KIND_LABEL</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_LABEL "label"
604
581
</programlisting>
605
582
<para>
606
583
The string used to obtain a filesystem label with <link linkend="g-volume-get-identifier"><function>g_volume_get_identifier()</function></link>.</para>
608
585
</para></refsect2>
609
586
<refsect2 id="G-VOLUME-IDENTIFIER-KIND-NFS-MOUNT--CAPS" role="macro">
610
587
<title>G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT</title>
611
 
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-NFS-MOUNT--CAPS"><primary sortas="G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT">G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT "nfs-mount"
 
588
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-NFS-MOUNT--CAPS"><primary sortas="VOLUME_IDENTIFIER_KIND_NFS_MOUNT">G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_NFS_MOUNT "nfs-mount"
612
589
</programlisting>
613
590
<para>
614
591
The string used to obtain a NFS mount with <link linkend="g-volume-get-identifier"><function>g_volume_get_identifier()</function></link>.</para>
616
593
</para></refsect2>
617
594
<refsect2 id="G-VOLUME-IDENTIFIER-KIND-UNIX-DEVICE--CAPS" role="macro">
618
595
<title>G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE</title>
619
 
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-UNIX-DEVICE--CAPS"><primary sortas="G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE">G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE "unix-device"
 
596
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-UNIX-DEVICE--CAPS"><primary sortas="VOLUME_IDENTIFIER_KIND_UNIX_DEVICE">G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_UNIX_DEVICE "unix-device"
620
597
</programlisting>
621
598
<para>
622
599
The string used to obtain a Unix device path with <link linkend="g-volume-get-identifier"><function>g_volume_get_identifier()</function></link>.</para>
624
601
</para></refsect2>
625
602
<refsect2 id="G-VOLUME-IDENTIFIER-KIND-UUID--CAPS" role="macro">
626
603
<title>G_VOLUME_IDENTIFIER_KIND_UUID</title>
627
 
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-UUID--CAPS"><primary sortas="G_VOLUME_IDENTIFIER_KIND_UUID">G_VOLUME_IDENTIFIER_KIND_UUID</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_UUID "uuid"
 
604
<indexterm zone="G-VOLUME-IDENTIFIER-KIND-UUID--CAPS"><primary sortas="VOLUME_IDENTIFIER_KIND_UUID">G_VOLUME_IDENTIFIER_KIND_UUID</primary></indexterm><programlisting>#define G_VOLUME_IDENTIFIER_KIND_UUID "uuid"
628
605
</programlisting>
629
606
<para>
630
607
The string used to obtain a UUID with <link linkend="g-volume-get-identifier"><function>g_volume_get_identifier()</function></link>.</para>
632
609
</para></refsect2>
633
610
<refsect2 id="g-volume-enumerate-identifiers" role="function">
634
611
<title>g_volume_enumerate_identifiers ()</title>
635
 
<indexterm zone="g-volume-enumerate-identifiers"><primary sortas="g_volume_enumerate_identifiers">g_volume_enumerate_identifiers</primary></indexterm><programlisting><link linkend="char">char</link> **             g_volume_enumerate_identifiers      (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
 
612
<indexterm zone="g-volume-enumerate-identifiers"><primary sortas="volume_enumerate_identifiers">g_volume_enumerate_identifiers</primary></indexterm><programlisting><link linkend="char">char</link> **             g_volume_enumerate_identifiers      (<link linkend="GVolume">GVolume</link> *volume);</programlisting>
636
613
<para>
637
614
Gets the kinds of <link linkend="volume-identifier">identifiers</link>
638
615
that <parameter>volume</parameter> has. Use <link linkend="g-volume-get-identifer"><function>g_volume_get_identifer()</function></link> to obtain 
648
625
</variablelist></refsect2>
649
626
<refsect2 id="g-volume-get-identifier" role="function">
650
627
<title>g_volume_get_identifier ()</title>
651
 
<indexterm zone="g-volume-get-identifier"><primary sortas="g_volume_get_identifier">g_volume_get_identifier</primary></indexterm><programlisting><link linkend="char">char</link> *              g_volume_get_identifier             (<link linkend="GVolume">GVolume</link> *volume,
 
628
<indexterm zone="g-volume-get-identifier"><primary sortas="volume_get_identifier">g_volume_get_identifier</primary></indexterm><programlisting><link linkend="char">char</link> *              g_volume_get_identifier             (<link linkend="GVolume">GVolume</link> *volume,
652
629
                                                         const <link linkend="char">char</link> *kind);</programlisting>
653
630
<para>
654
631
Gets the identifier of the given kind for <parameter>volume</parameter>. 
673
650
<refsect1 id="GVolume.signal-details" role="signals">
674
651
<title role="signals.title">Signal Details</title>
675
652
<refsect2 id="GVolume-changed" role="signal"><title>The <literal>&quot;changed&quot;</literal> signal</title>
676
 
<indexterm zone="GVolume-changed"><primary sortas="GVolume::changed">GVolume::changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GVolume">GVolume</link> *arg0,
 
653
<indexterm zone="GVolume-changed"><primary sortas="Volume::changed">GVolume::changed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GVolume">GVolume</link> *arg0,
677
654
                                                        <link linkend="gpointer">gpointer</link> user_data)      : Run Last</programlisting>
678
655
<para>
679
656
Emitted when the volume has been changed.</para>
682
659
<varlistentry><term><parameter>user_data</parameter>&#160;:</term>
683
660
<listitem><simpara>user data set when the signal handler was connected.</simpara></listitem></varlistentry>
684
661
</variablelist></refsect2><refsect2 id="GVolume-removed" role="signal"><title>The <literal>&quot;removed&quot;</literal> signal</title>
685
 
<indexterm zone="GVolume-removed"><primary sortas="GVolume::removed">GVolume::removed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GVolume">GVolume</link> *arg0,
 
662
<indexterm zone="GVolume-removed"><primary sortas="Volume::removed">GVolume::removed</primary></indexterm><programlisting><link linkend="void">void</link>                user_function                      (<link linkend="GVolume">GVolume</link> *arg0,
686
663
                                                        <link linkend="gpointer">gpointer</link> user_data)      : Run Last</programlisting>
687
664
<para>
688
665
This signal is emitted when the <link linkend="GVolume"><type>GVolume</type></link> have been removed. If