[RFC PATCH mtd-utils 031/110] libubi: Add new interface ubi_leb_map()

From: Zhihao Cheng
Date: Fri Jun 07 2024 - 00:34:22 EST


Add ubi_leb_map() implementation, it is used in UBIFS linux kernel libs.

This is a preparation for replacing implementation of UBIFS utils with
linux kernel libs.

Signed-off-by: Zhihao Cheng <chengzhihao1@xxxxxxxxxx>
---
include/libubi.h | 15 +++++++++++++++
lib/libubi.c | 10 ++++++++++
2 files changed, 25 insertions(+)

diff --git a/include/libubi.h b/include/libubi.h
index e1e234e1..213948d5 100644
--- a/include/libubi.h
+++ b/include/libubi.h
@@ -487,6 +487,21 @@ int ubi_leb_unmap(int fd, int lnum);
*/
int ubi_is_mapped(int fd, int lnum);

+/**
+ * ubi_leb_map - map logical eraseblock to a physical eraseblock.
+ * @fd: volume character device file descriptor
+ * @lnum: logical eraseblock number
+ *
+ * This function maps an un-mapped logical eraseblock @lnum to a physical
+ * eraseblock. This means, that after a successful invocation of this
+ * function the logical eraseblock @lnum will be empty (contain only %0xFF
+ * bytes) and be mapped to a physical eraseblock, even if an unclean reboot
+ * happens.
+ *
+ * This function returns zero in case of success, %-1 in case of failures.
+ */
+int ubi_leb_map(int fd, int lnum);
+
#ifdef __cplusplus
}
#endif
diff --git a/lib/libubi.c b/lib/libubi.c
index 6b57e50d..86736dd5 100644
--- a/lib/libubi.c
+++ b/lib/libubi.c
@@ -1364,3 +1364,13 @@ int ubi_is_mapped(int fd, int lnum)
{
return ioctl(fd, UBI_IOCEBISMAP, &lnum);
}
+
+int ubi_leb_map(int fd, int lnum)
+{
+ struct ubi_map_req r;
+
+ memset(&r, 0, sizeof(struct ubi_map_req));
+ r.lnum = lnum;
+
+ return ioctl(fd, UBI_IOCEBMAP, &r);
+}
--
2.13.6