Changes in uspace/lib/c/include/cap.h [9d58539:120d5bc] in mainline

File:

• uspace/lib/c/include/cap.h (modified) (2 diffs)

uspace/lib/c/include/cap.h

@@ -1 +1 @@
 /*
- * Copyright (c) 2006 Jakub Jermar
+ * Copyright (c) 2015 Jiri Svoboda
  * All rights reserved.
  *
@@ -30 +30 @@
  * @{
  */
-/** @file
+/**
+ * @file Storage capacity specification.
  */
 
-#ifndef LIB_CAP_H_
-#define LIB_CAP_H_
+#ifndef LIBC_CAP_H_
+#define LIBC_CAP_H_
 
-#include <task.h>
+#include <adt/list.h>
+#include <loc.h>
+#include <stdint.h>
+#include <types/label.h>
+#include <types/vol.h>
+#include <vbd.h>
 
-extern int cap_grant(task_id_t id, unsigned int caps);
-extern int cap_revoke(task_id_t id, unsigned int caps);
+/** Capacity unit */
+typedef enum {
+        cu_byte = 0,
+        cu_kbyte,
+        cu_mbyte,
+        cu_gbyte,
+        cu_tbyte,
+        cu_pbyte,
+        cu_ebyte,
+        cu_zbyte,
+        cu_ybyte
+} cap_unit_t;
+
+/** Which of values within the precision of the capacity */
+typedef enum {
+        /** The nominal (middling) value */
+        cv_nom,
+        /** The minimum value */
+        cv_min,
+        /** The maximum value */
+        cv_max
+} cap_vsel_t;
+
+#define CU_LIMIT (cu_ybyte + 1)
+
+/** Storage capacity.
+ *
+ * Storage 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 */
+        cap_unit_t cunit;
+} cap_spec_t;
+
+extern int cap_format(cap_spec_t *, char **);
+extern int cap_parse(const char *, cap_spec_t *);
+extern void cap_simplify(cap_spec_t *);
+extern void cap_from_blocks(uint64_t, size_t, cap_spec_t *);
+extern int cap_to_blocks(cap_spec_t *, cap_vsel_t, size_t, uint64_t *);
 
 #endif