[PATCH] mtd-www: remove any references to dtype/UBI_SHORTTERM/UBI_LONGTTERM
Shmulik Ladkani
shmulik.ladkani at gmail.com
Tue Dec 25 02:37:05 EST 2012
These no longer exist.
Signed-off-by: Shmulik Ladkani <shmulik.ladkani at gmail.com>
---
1. Artem, this patch completely removes these parts of the documentation.
Would you prefer to keep, with a statement they no longer exist since
[whatever kernel version]?
2. Piggy backed is a tiny style fix at the affected area: </p>. to .</p>
I assumed no need for a separate patch, but let me know if you prefer a
separate patch.
diff --git a/doc/ubi.xml b/doc/ubi.xml
index 13b8174..d912b8f 100644
--- a/doc/ubi.xml
+++ b/doc/ubi.xml
@@ -974,28 +974,7 @@ go to the mapped PEB.</p>
<p>The LEB map operation is available via the <code>ubi_leb_map()</code>
UBI kernel API function, or via the <code>UBI_IOCEBMAP</code> volume character
device ioctl command. However, thie ioctl interface is available only starting
-from kernel version <code>2.6.29</code></p>.
-
-<p>The LEB map operation accepts the <code>dtype</code> parameter which suggests
-UBI which type of data the LEB will contain. Namely, <code>dtype</code> may be
-one of:</p>
-
-<ul>
- <li><code>UBI_SHORTTERM</code> - the LEB will store short-term data,
- which means that it will be erased soon; UBI will map this LEB to a
- PEB with low erase counter, so it will grow relative to other PEB
- erase counters;</li>
- <li><code>UBI_LONGTTERM</code> - the LEB will store long-term data and
- will not be erased soon; UBI will map this LEB to a PEB with high erase
- counter, so it will go down relative to other PEB erase counters;</li>
- <li><code>UBI_UNKNOWN</code> - should be used most of the time, when
- you are not sure whether the data are long-term or short term.</li>
-</ul>
-
-<p>Bear in mind that <code>dtype</code> is only a hint. Please, use
-<code>UBI_UNKNOWN</code> if unsure. And note, UBI authors never really tested
-the effects of using <code>UBI_SHORTTERM</code> and <code>UBI_LONGTTERM</code>,
-so there is not guarantee they improve anything.</p>
+from kernel version <code>2.6.29</code>.</p>
<p>One of the possible use-cases of the LEB map operation is making sure the
old LEB contents goes away forever. As it was explained in
@@ -1109,8 +1088,6 @@ struct ubi_leb_change_req req;
req.lnum = lnum_to_change;
req.len = data_len;
-req.dtype = UBI_LONGTERM; /* data persistency (may also be UBI_SHORTTERM
- and UBI_UNKNOWN) */
fd = open("/dev/my_volume");
ioctl(fd, UBI_IOCEBCH, &req);
write(fd, data_buf, data_len);
--
1.7.9
More information about the linux-mtd
mailing list