Debian Codegraph @

doc/html/gdbus-org.freedesktop.UDisks2.Drive.LSM.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>org.freedesktop.UDisks2.Drive.LSM: 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="ch03.html" title="D-Bus Interfaces">
9 <link rel="prev" href="gdbus-org.freedesktop.UDisks2.NVMe.Fabrics.html" title="org.freedesktop.UDisks2.NVMe.Fabrics">
10 <link rel="next" href="gdbus-org.freedesktop.UDisks2.Drive.LsmLocal.html" title="org.freedesktop.UDisks2.Drive.LsmLocal">
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">
17 <a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
18 <a href="#gdbus-org.freedesktop.UDisks2.Drive.LSM.description" class="shortcut">Description</a></span><span id="nav_properties">  <span class="dim">|</span> 
19 <a href="#gdbus-org.freedesktop.UDisks2.Drive.LSM.properties" class="shortcut">Properties</a></span>
20 </td>
21 <td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
22 <td><a accesskey="u" href="ch03.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
23 <td><a accesskey="p" href="gdbus-org.freedesktop.UDisks2.NVMe.Fabrics.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
24 <td><a accesskey="n" href="gdbus-org.freedesktop.UDisks2.Drive.LsmLocal.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
25 </tr></table>
26 <div class="refentry">
27 <a name="gdbus-org.freedesktop.UDisks2.Drive.LSM"></a><div class="titlepage"></div>
28 <div class="refnamediv"><table width="100%"><tr>
29 <td valign="top">
30 <h2><span class="refentrytitle"><a name="gdbus-interface-org-freedesktop-UDisks2-Drive-LSM.top_of_page"></a>org.freedesktop.UDisks2.Drive.LSM</span></h2>
31 <p>org.freedesktop.UDisks2.Drive.LSM — LSM interface exported on disk objects</p>
32 </td>
33 <td class="gallery_image" valign="top" align="right"></td>
34 </tr></table></div>
35 <div class="refsect1">
36 <a name="id-1.3.3.18.3"></a><h2>Properties</h2>
37 <pre class="synopsis">
38 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsOK" title='The "IsOK" property'>IsOK</a> readable b
39 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidDegraded" title='The "IsRaidDegraded" property'>IsRaidDegraded</a> readable b
40 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidError" title='The "IsRaidError" property'>IsRaidError</a> readable b
41 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidVerifying" title='The "IsRaidVerifying" property'>IsRaidVerifying</a> readable b
42 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidReconstructing" title='The "IsRaidReconstructing" property'>IsRaidReconstructing</a> readable b
43 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.RaidType" title='The "RaidType" property'>RaidType</a> readable s
44 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.StatusInfo" title='The "StatusInfo" property'>StatusInfo</a> readable s
45 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.MinIoSize" title='The "MinIoSize" property'>MinIoSize</a> readable u
46 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.OptIoSize" title='The "OptIoSize" property'>OptIoSize</a> readable u
47 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.LSM.html#gdbus-property-org-freedesktop-UDisks2-Drive-LSM.RaidDiskCount" title='The "RaidDiskCount" property'>RaidDiskCount</a> readable u
48 </pre>
49 </div>
50 <div class="refsect1">
51 <a name="gdbus-interface-org-freedesktop-UDisks2-Drive-LSM"></a><h2>Description</h2>
52 <p>
53 Objects implementing this interface also implement the
54 <a class="link" href="gdbus-org.freedesktop.UDisks2.Drive.html#gdbus-interface-org-freedesktop-UDisks2-Drive.top_of_page">org.freedesktop.UDisks2.Drive</a> interface.
55 </p>
56 <p class="since">Since 2.3.0</p>
57 </div>
58 <div class="refsect1">
59 <a name="gdbus-properties-org.freedesktop.UDisks2.Drive.LSM"></a><h2>Property Details</h2>
60 <div class="refsect2">
61 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsOK"></a><h3>The "IsOK" property</h3>
62 <pre class="programlisting">
63 IsOK readable b
64 </pre>
65 <p>
66 </p>
67 <p>
68 Whether this drive is read and writeable without any error or warnings.
69 It's the single preliminary check on whether things go wrong.
70 Noted: even from user's view, RAID degrade does not cause any
71 error or warning at OS level, the 'isOK' property will still be set
72 as 'FALSE' to suggest user to do more checking on what's going on.
73 </p>
74 <p class="since">Since 2.3.0</p>
75 </div>
76 <hr>
77 <div class="refsect2">
78 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidDegraded"></a><h3>The "IsRaidDegraded" property</h3>
79 <pre class="programlisting">
80 IsRaidDegraded readable b
81 </pre>
82 <p>
83 </p>
84 <p>
85 Whether this drive is degraded RAID, for example, one disk failure
86 in RAID 5 group is considered as degraded RAID.
87 </p>
88 <p class="since">Since 2.3.0</p>
89 </div>
90 <hr>
91 <div class="refsect2">
92 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidError"></a><h3>The "IsRaidError" property</h3>
93 <pre class="programlisting">
94 IsRaidError readable b
95 </pre>
96 <p>
97 </p>
98 <p>
99 Whether this drive is facing RAID error, for example, two disks
100 failure in RAID 5 group at the same time is considered as RAID error,
101 user will lose data access and facing write failure.
102 </p>
103 <p class="since">Since 2.3.0</p>
104 </div>
105 <hr>
106 <div class="refsect2">
107 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidVerifying"></a><h3>The "IsRaidVerifying" property</h3>
108 <pre class="programlisting">
109 IsRaidVerifying readable b
110 </pre>
111 <p>
112 </p>
113 <p>
114 Whether the RAID group of current drive allocated from is
115 verifying its data integrity by comparing mirror(RAID1) or verifying
116 parity(RAID 5/6).
117 </p>
118 <p class="since">Since 2.3.0</p>
119 </div>
120 <hr>
121 <div class="refsect2">
122 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.IsRaidReconstructing"></a><h3>The "IsRaidReconstructing" property</h3>
123 <pre class="programlisting">
124 IsRaidReconstructing readable b
125 </pre>
126 <p>
127 </p>
128 <p>
129 Whether the RAID group of current drive allocated from is
130 reconstructing its data on newly joined disk or out-synced disk.
131 </p>
132 <p class="since">Since 2.3.0</p>
133 </div>
134 <hr>
135 <div class="refsect2">
136 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.RaidType"></a><h3>The "RaidType" property</h3>
137 <pre class="programlisting">
138 RaidType readable s
139 </pre>
140 <p>
141 </p>
142 <p>
143 A string of backend RAID type of this disk drive.
144 Could be one of these values:
145 JBOD, RAID 0, RAID 1, RAID 5, RAID 6, RAID 10, RAID 50, RAID 60
146 There will be a space between RAID number and 'RAID' string.
147 If unknown, leave it as empty.
148 </p>
149 <p class="since">Since 2.3.0</p>
150 </div>
151 <hr>
152 <div class="refsect2">
153 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.StatusInfo"></a><h3>The "StatusInfo" property</h3>
154 <pre class="programlisting">
155 StatusInfo readable s
156 </pre>
157 <p>
158 </p>
159 <p>
160 A message for administrator about RAID detail issue.
161 Some examples:
162 Disk enclosure 1 slot 9(serial: CVDA452606ME1207GN) is offline.
163 Disk enclosure 1 slot 10 is predicted to be fail soon.
164 Empty string if no issue or LibStorageMgmt failed to retrieve so.
165 </p>
166 <p class="since">Since 2.3.0</p>
167 </div>
168 <hr>
169 <div class="refsect2">
170 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.MinIoSize"></a><h3>The "MinIoSize" property</h3>
171 <pre class="programlisting">
172 MinIoSize readable u
173 </pre>
174 <p>
175 </p>
176 <p>
177 The minimum I/O size, device preferred I/O size for random I/O.
178 Any I/O size not equal to a multiple of this value may get
179 significant speed penalty. Normally it refers to strip size of
180 each RAID disk(extent). If LibStorageMgmt failed to detect min_io_size,
181 it will try these values in the sequence of:
182 logical sector size -&gt; physical sector size -&gt; 0
183 </p>
184 <p class="since">Since 2.3.0</p>
185 </div>
186 <hr>
187 <div class="refsect2">
188 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.OptIoSize"></a><h3>The "OptIoSize" property</h3>
189 <pre class="programlisting">
190 OptIoSize readable u
191 </pre>
192 <p>
193 </p>
194 <p>
195 The optimal I/O size, device preferred I/O size for sequential
196 I/O. Normally it refers to RAID group stripe size. If LibStorageMgmt
197 failed to detect opt_io_size, it will be set to 0.
198 </p>
199 <p class="since">Since 2.3.0</p>
200 </div>
201 <hr>
202 <div class="refsect2">
203 <a name="gdbus-property-org-freedesktop-UDisks2-Drive-LSM.RaidDiskCount"></a><h3>The "RaidDiskCount" property</h3>
204 <pre class="programlisting">
205 RaidDiskCount readable u
206 </pre>
207 <p>
208 </p>
209 <p>
210 The count of disk assebled the RAID group where this disk drive came
211 from. This impact the performance of this disk drive.
212 If LibStorageMgmt failed to detect RAID disk count, it will be set to
213 0.
214 </p>
215 <p class="since">Since 2.3.0</p>
216 </div>
217 </div>
218 </div>
219 <div class="footer">
220 <hr>Generated by GTK-Doc V1.35.1</div>
221 </body>
222 </html>