Changeset 9854a8f in mainline for uspace/lib/fdisk/include

Timestamp:

2015-10-24T22:06:34Z (10 years ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

03661d19

Parents:

ef9dac04

Message:

Capacity simplification, for display.

Location:

uspace/lib/fdisk/include

Files:

• fdisk.h (modified) (1 diff)
• types/fdisk.h (modified) (1 diff)

uspace/lib/fdisk/include/fdisk.h

@@ -73 +73 @@
 extern int fdisk_cap_format(fdisk_cap_t *, char **);
 extern int fdisk_cap_parse(const char *, fdisk_cap_t *);
+extern void fdisk_cap_simplify(fdisk_cap_t *);
+extern void fdisk_cap_from_blocks(uint64_t, size_t, fdisk_cap_t *);
+extern int fdisk_cap_to_blocks(fdisk_cap_t *, size_t, uint64_t *);
+
 extern int fdisk_ltype_format(label_type_t, char **);
 extern int fdisk_fstype_format(vol_fstype_t, char **);

uspace/lib/fdisk/include/types/fdisk.h

@@ -77 +77 @@
 #define CU_LIMIT (cu_ybyte + 1)
 
-/** Partition capacity */
-typedef struct {
-        uint64_t value;
+/** Partition capacity.
+ *
+ * Partition capacity represents both value and precision.
+ * It is a decimal floating point value combined with a decimal
+ * capacity unit. There is an integer mantisa @c m which in combination
+ * with the number of decimal positions @c dp gives a decimal floating-point
+ * number. E.g. for m = 1025 and dp = 2 the number is 10.25. If the unit
+ * cunit = cu_kbyte, the capacity is 10.25 kByte, i.e. 10 250 bytes.
+ *
+ * Note that 1.000 kByte is equivalent to 1000 Byte, but 1 kByte is less
+ * precise.
+ */
+typedef struct {
+        /** Mantisa */
+        uint64_t m;
+        /** Decimal positions */
+        unsigned dp;
+        /** Capacity unit */
         fdisk_cunit_t cunit;
 } fdisk_cap_t;