Debian Codegraph @

doc/html/ref-dbus-block-devices.html

raw
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2 <html>
3 <head>
4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
5 <title>The /org/freedesktop/UDisks2/block_devices/* objects: UDisks Reference Manual</title>
6 <meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
7 <link rel="home" href="index.html" title="UDisks Reference Manual">
8 <link rel="up" href="ref-dbus-overview.html" title="Overview">
9 <link rel="prev" href="ref-dbus-manager-well-known-object.html" title="The /org/freedesktop/UDisks2/Manager object">
10 <link rel="next" href="ref-dbus-drives.html" title="The /org/freedesktop/UDisks2/drives/* objects">
11 <meta name="generator" content="GTK-Doc V1.35.1 (XML mode)">
12 <link rel="stylesheet" href="style.css" type="text/css">
13 </head>
14 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
15 <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
16 <td width="100%" align="left" class="shortcuts"></td>
17 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
18 <td><a accesskey="u" href="ref-dbus-overview.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
19 <td><a accesskey="p" href="ref-dbus-manager-well-known-object.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
20 <td><a accesskey="n" href="ref-dbus-drives.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
21 </tr></table>
22 <div class="sect1">
23 <div class="titlepage"><div><div><h2 class="title" style="clear: both">
24 <a name="ref-dbus-block-devices"></a>The /org/freedesktop/UDisks2/block_devices/* objects</h2></div></div></div>
25 <p>
26 Objects with object paths starting with
27 <code class="literal">/org/freedesktop/UDisks2/block_devices/</code>
28 all represent <a class="ulink" href="http://en.wikipedia.org/wiki/Block_device#Block_devices" target="_top">block devices</a>.
29 Such objects implement the
30 <a class="link" href="gdbus-org.freedesktop.UDisks2.Block.html#gdbus-interface-org-freedesktop-UDisks2-Block.top_of_page">org.freedesktop.UDisks2.Block</a>
31 D-Bus interface and may optionally implement other D-Bus interfaces such as
32 <a class="link" href="gdbus-org.freedesktop.UDisks2.Filesystem.html#gdbus-interface-org-freedesktop-UDisks2-Filesystem.top_of_page">org.freedesktop.UDisks2.Filesystem</a>,
33 <a class="link" href="gdbus-org.freedesktop.UDisks2.Partition.html#gdbus-interface-org-freedesktop-UDisks2-Partition.top_of_page">org.freedesktop.UDisks2.Partition</a> or
34 <a class="link" href="gdbus-org.freedesktop.UDisks2.Loop.html#gdbus-interface-org-freedesktop-UDisks2-Loop.top_of_page">org.freedesktop.UDisks2.Loop</a> depending on the block device in question.
35 </p>
36 <p>
37 Note that interfaces may be added and removed at
38 run-time. For example, if a block device is full of zeroes
39 (or, at least, have zeroes in the known metadata areas), it
40 will not initially implement the <a class="link" href="gdbus-org.freedesktop.UDisks2.Filesystem.html#gdbus-interface-org-freedesktop-UDisks2-Filesystem.top_of_page">org.freedesktop.UDisks2.Filesystem</a>
41 interface; however, if a filesystem is later created on the device
42 (using, say, the
43 <span class="citerefentry"><span class="refentrytitle">mkfs</span>(8)</span>
44 command) and the filesystem is recognized by the OS (specifically, recognized by
45 <span class="citerefentry"><span class="refentrytitle">udev</span>(7)</span> and its device probers), the object will gain the interface. If the device is later zeroed or formatted for use as e.g. swap-space, it will lose the
46 <a class="link" href="gdbus-org.freedesktop.UDisks2.Filesystem.html#gdbus-interface-org-freedesktop-UDisks2-Filesystem.top_of_page">org.freedesktop.UDisks2.Filesystem</a>
47 interface.
48 </p>
49 </div>
50 <div class="footer">
51 <hr>Generated by GTK-Doc V1.35.1</div>
52 </body>
53 </html>