15
15
<refname>udisks</refname>
16
<refpurpose>Introduction to udisks</refpurpose>
16
<refpurpose>Disk Manager</refpurpose>
19
19
<refsect1><title>DESCRIPTION</title>
21
21
udisks provides interfaces to enumerate and perform operations
22
on storage devices. Any application (including unprivileged
22
on disks and storage devices. Any application (including
23
unprivileged ones) can access the
24
24
<citerefentry><refentrytitle>udisksd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
25
25
daemon via the name <emphasis>org.freedesktop.UDisks2</emphasis>
26
26
on the system message bus. In addition to the D-Bus API, a
27
27
library, <filename>libudisks2</filename> is also provided. This
28
28
library can be used from C/C++ and any high-level language with
29
<ulink url="https://live.gnome.org/GObjectIntrospection">GObjectIntrospection</ulink>
30
url="https://live.gnome.org/GObjectIntrospection">GObjectIntrospection</ulink>
30
31
support such as Javascript and Python.
33
Except for providing a list of devices, support for udev
34
properties as well as routines used to present the devices to
35
the end user, udisks, as a system-level component, is not
36
involved with what a desktop user interface shows the user. For
37
GNOME see these <ulink
38
url="http://git.gnome.org/browse/gvfs/tree/monitor/udisks2/what-is-shown.txt">GVfs
39
notes</ulink> about what is shown in the desktop user interface
40
and how to influence it.
32
udisks is only indirectly involved in what devices and objects
33
are shown in the user interface. See these
34
<ulink url="http://git.gnome.org/browse/gvfs/tree/monitor/udisks2/what-is-shown.txt">notes</ulink>
35
for what is shown in GNOME 3.
54
49
more information (<ulink
55
50
url="http://udisks.freedesktop.org/docs/latest/udisks-polkit-actions.html">available
56
51
online here</ulink>).
59
52
Note that the <literal>x-udisks-auth</literal> option can be
60
53
used in the <filename>/etc/fstab</filename> and
61
54
<filename>/etc/crypttab</filename> files to specify that