1 files changed, 68 insertions, 46 deletions
diff --git a/include/slibc-human.h b/include/slibc-human.h
index 25e5162..ee55568 100644
--- a/include/slibc-human.h
+++ b/include/slibc-human.h
@@ -33,56 +33,25 @@
 
 
 
-/**
- * Ways to handled unrecognised escapes,
- * and other configurations.
- */
-enum unescape_mode
+enum machinemode_mode
   {
     /**
-     * For any unrecognised character '#',
-     * '\#' results in an EINVAL-error.
+     * Return in the format where 0750
+     * resolves to 'rwxr-x---'.
      * 
-     * Cannot be used together with
-     * `UNESCAPE_VERBATIM` or `UNESCAPE_IGNORE`.
+     * If used in combination with `MACHINEMODE_MASK`,
+     * 0750 resolves to 'u=rwx,g=r-x,o=---'.
      */
-    UNESCAPE_EINVAL = 1,
+    MACHINEMODE_STAT = 1,
     
     /**
-     * For any unrecognised character '#',
-     * '\#' results in '#'.
+     * Return in the format where 0750
+     * resolves to 'u=rwx,g=rx,o='.
      * 
-     * Cannot be used together with
-     * `UNESCAPE_EINVAL` or `UNESCAPE_IGNORE`.
-     */
-    UNESCAPE_VERBATIM = 2,
-    
-    /**
-     * For any unrecognised character '#',
-     * '\#' results in '\#'.
-     * 
-     * Cannot be used together with
-     * `UNESCAPE_EINVAL` or `UNESCAPE_VERBATIM`.
+     * If used in combination with `MACHINEMODE_STAT`,
+     * 0750 resolves to 'u=rwx,g=r-x,o=---'.
      */
-    UNESCAPE_IGNORE = 4,
-    
-    
-    /**
-     * '\&' resolves to the byte 255 (0xFF).
-     * 
-     * If not used, '\&' is handled as an
-     * unsupported escape.
-     */
-    UNESCAPE_AMPERSAND = 8,
-    
-    /**
-     * '\0' resolves to the byte sequence
-     * 192 128 (0xC0 0x80).
-     * 
-     * If not used, '\0' resolves to a
-     * 0 byte (termination).
-     */
-    UNESCAPE_MOD_UTF8 = 16,
+    MACHINEMODE_MASK = 2,
   };
 
 
@@ -134,7 +103,7 @@ enum humansize_mode
      * `detail` < 0 is allowed, 
      */
     HUMANSIZE_ROUND = 32,
-  }
+  };
 
 
 enum machinesize_mode
@@ -156,13 +125,66 @@ enum machinesize_mode
      * included, otherwise 1024-base is used.
      */
     MACHINESIZE_IEC = 2,
-  }
+  };
+
+
+/**
+ * Ways to handled unrecognised escapes,
+ * and other configurations.
+ */
+enum unescape_mode
+  {
+    /**
+     * For any unrecognised character '#',
+     * '\#' results in an EINVAL-error.
+     * 
+     * Cannot be used together with
+     * `UNESCAPE_VERBATIM` or `UNESCAPE_IGNORE`.
+     */
+    UNESCAPE_EINVAL = 1,
+    
+    /**
+     * For any unrecognised character '#',
+     * '\#' results in '#'.
+     * 
+     * Cannot be used together with
+     * `UNESCAPE_EINVAL` or `UNESCAPE_IGNORE`.
+     */
+    UNESCAPE_VERBATIM = 2,
+    
+    /**
+     * For any unrecognised character '#',
+     * '\#' results in '\#'.
+     * 
+     * Cannot be used together with
+     * `UNESCAPE_EINVAL` or `UNESCAPE_VERBATIM`.
+     */
+    UNESCAPE_IGNORE = 4,
+    
+    
+    /**
+     * '\&' resolves to the byte 255 (0xFF).
+     * 
+     * If not used, '\&' is handled as an
+     * unsupported escape.
+     */
+    UNESCAPE_AMPERSAND = 8,
+    
+    /**
+     * '\0' resolves to the byte sequence
+     * 192 128 (0xC0 0x80).
+     * 
+     * If not used, '\0' resolves to a
+     * 0 byte (termination).
+     */
+    UNESCAPE_MOD_UTF8 = 16,
+  };
 
 
 
-char* humanmode(char* restrict buffer, mode_t mode);
+char* humanmode(char* restrict buffer, mode_t perm, enum machinemode_mode mode);
 
-mode_t machinemode(const char* restrict str, mode_t mode, mode_t mask);
+int machinemode(mode_t* restrict mode, mode_t* restrict mask, const char* restrict str);
 
 
 char* humansize(char* restrict buffer, size_t size, enum humansize_mode mode, int detail);