From b06aba1da8abd9e493d9423cdf596f0d982374c9 Mon Sep 17 00:00:00 2001
From: d0p1 <contact@d0p1.eu>
Date: Sun, 21 Jul 2024 11:31:09 +0000
Subject: [PATCH] refactor: reorganize source (wip)

---
 .gitignore         |   3 +-
 fuse/Makefile.am   |   2 +-
 include/stupidfs.h | 149 +++++++++++++++++++++++++++------------------
 lib/Makefile.am    |   1 +
 lib/stpdfs.h       | 126 +-------------------------------------
 tests/Makefile.am  |   2 +-
 tools/Makefile.am  |   2 +-
 tools/mkfs/main.c  |  23 +++----
 tools/tools.stpd   | Bin 16200 -> 0 bytes
 9 files changed, 110 insertions(+), 198 deletions(-)
 delete mode 100755 tools/tools.stpd

diff --git a/.gitignore b/.gitignore
index 63a6676..2bb9796 100644
--- a/.gitignore
+++ b/.gitignore
@@ -38,4 +38,5 @@ test_base64
 *.trs
 stpdfs-fuse
 test_hchacha
-test_xchacha
\ No newline at end of file
+test_xchacha
+tools.stpd
\ No newline at end of file
diff --git a/fuse/Makefile.am b/fuse/Makefile.am
index e05d1d7..3f2a7c1 100644
--- a/fuse/Makefile.am
+++ b/fuse/Makefile.am
@@ -1,4 +1,4 @@
-AM_CFLAGS = $(FUSE_CFLAGS) -I$(top_srcdir)/lib -I$(top_srcdir)
+AM_CFLAGS = $(FUSE_CFLAGS) -I$(top_srcdir)/lib -I$(top_srcdir)/include -I$(top_srcdir)
 LDADD = $(FUSE_LIBS) ../lib/libstpdfs.a
 
 bin_PROGRAMS = stpdfs-fuse
diff --git a/include/stupidfs.h b/include/stupidfs.h
index 299b112..bbc0734 100644
--- a/include/stupidfs.h
+++ b/include/stupidfs.h
@@ -1,66 +1,35 @@
 /**
  * \file stupidfs.h
  *
- * StupidFS
+ * StupidFS Filesystem
+ *
  * ```
  * ┌──────────┬───────────┬──────┬───┬──────┬────┬───┬────┐
  * │Boot block│Super block│Inodes│...│Inodes│Data│...│Data│
  * └──────────┴───────────┴──────┴───┴──────┴────┴───┴────┘
  * ```
  */
-#ifndef STPDFS_H
-# define STPDFS_H 1
+#ifndef STUPIDFS_H
+# define STUPIDFS_H 1
 
 # ifndef __KERNEL__
 #  include <stdint.h>
 #  include <stddef.h>
 # endif
 
-# define STPDFS_SB_MAGIC 0x44505453
-# define STPDFS_SB_REV   STPDFS_SB_REV_1
-# define STPDFS_SB_REV_1 1
-
-# define STPDFS_INO_ROOTDIR 1
-
-# define STPDFS_BLOCK_SIZE 512
-
-# define STPDFS_NAME_MAX 28
-
+# define STPDFS_BLOCK_SIZE 512 /**< StupidFS block size */
 # define STPDFS_INODES_PER_BLOCK (STPDFS_BLOCK_SIZE / (sizeof(struct stpdfs_inode)))
 # define STPDFS_ZONES_PER_BLOCK (STPDFS_BLOCK_SIZE / sizeof(uint32_t))
 # define STPDFS_DIRENT_PER_BLOCK (STPDFS_BLOCK_SIZE / (sizeof(struct stpdfs_dirent)))
-# define STPDFS_NDIR 7
-# define STPDFS_ROOT_INO 1
 
-# define STPDFS_INO_FLAG_ALOC   (1 << 15)
-# define STPDFS_INO_FLAG_LZP    (1 << 1)
-# define STPDFS_INO_FLAG_ENC    (1 << 2)
+# define STPDFS_SB_MAGIC 0x44505453 /**< Superblock magic number */
+# define STPDFS_SB_REV   STPDFS_SB_REV_1 /**< current revision */
+# define STPDFS_SB_REV_1 1
 
-# define STPDFS_S_IFMT   0xF000
-# define STPDFS_S_IFSOCK 0xA000
-# define STPDFS_S_IFLNK  0xC000
-# define STPDFS_S_IFREG  0x8000
-# define STPDFS_S_IFBLK  0x6000
-# define STPDFS_S_IFDIR  0x4000
+# define STPDFS_BADINO  0 /**< StupidFS bad inode number */
+# define STPDFS_ROOTINO 1 /**< StupidFS root inode number */
 
-# define STPDFS_S_ISUID 0x0800
-# define STPDFS_S_ISGID 0x0400
-# define STPDFS_S_ISVTX 0x0200
-  	  	 
-# define STPDFS_S_IRWXU 0x01C0 
-# define STPDFS_S_IRUSR 0x0100
-# define STPDFS_S_IWUSR 0x0080
-# define STPDFS_S_IXUSR 0x0040
-  	  	 
-# define STPDFS_S_IRWXG 0x0038
-# define STPDFS_S_IRGRP 0x0020
-# define STPDFS_S_IWGRP 0x0010
-# define STPDFS_S_IXGRP 0x0008
-  	  	 
-# define STPDFS_S_IRWXO 0x0007
-# define STPDFS_S_IROTH 0x0004
-# define STPDFS_S_IWOTH 0x0002
-# define STPDFS_S_IXOTH 0x0001
+# define STPDFS_NAME_MAX 28 /**< Max filename length */
 
 /**
  * \brief free block list
@@ -89,8 +58,8 @@
  * ```
  */
 struct stpdfs_free {
-	uint32_t free[100];
-	uint8_t nfree;
+	uint32_t free[100]; /**< List of free block (0-99), index 0 point to next freelist */
+	uint8_t nfree; /**< index  */
 } __attribute__((packed));
 
 enum stpdfs_state {
@@ -104,36 +73,100 @@ enum stpdfs_state {
  */
 struct stpdfs_sb {
 	uint32_t magic; /**< MUST be \ref STPDFS_SB_MAGIC */
-	uint32_t isize; /**< size in block of the I list */
-	uint32_t fsize; /**< size in block of the entire volume */
+	uint32_t isize; /**< Size in block of the I list */
+	uint32_t fsize; /**< Size in block of the entire volume */
 	struct stpdfs_free freelist; /**< \see stpdfs_free */
 	uint8_t revision; /**< MUST be \ref STPDFS_SB_REV */
 	uint16_t state; /**<  \see stpdfs_state */
-	uint64_t time; /**< last time the superblock was modified */
+	uint64_t time; /**< Last time the superblock was modified */
 } __attribute__((packed));
 
 #define STPDFS_SB_SIZE sizeof(struct stpdfs_sb)
 
 /**
  * \brief StupidFS I-node
+ *
+ * ```
+ *                         ┌────────┐                                                
+ *                         │        │                                                
+ *                ┌───────►│        │                                                
+ *                │        │        │                                                
+ * ┌──────┐ Direct│        └────────┘                                                
+ * │zone 0├───────┘                                                                  
+ * ├──────┤                                                                          
+ * │...   │                                                                          
+ * ├──────┤          ┌────────┐      ┌────────┐                                      
+ * │zone 6│          │        ├─────►│        │                                      
+ * ├──────┤ Indirect │        │      │        │                                      
+ * │zone 7├─────────►│        │      │        │                                      
+ * ├──────┤          └────────┘      └────────┘                                      
+ * │zone 8├───────┐                                                                  
+ * ├──────┤       │Double indirect┌────────┐    ┌────────┐    ┌────────┐           
+ * │zone 9│       └──────────────►│        ├───►│        ├───►│        │           
+ * └──┬───┘                       │        │    │        │    │        │           
+ *    │                           │        │    │        │    │        │           
+ *    │                           └────────┘    └────────┘    └────────┘           
+ *    │ Triple indirect ┌────────┐                                                   
+ *    └────────────────►│        │    ┌────────┐      ┌────────┐      ┌────────┐
+ *                      │        ├───►│        │      │        │      │        │
+ *                      │        │    │        ├─────►│        ├─────►│        │
+ *                      └────────┘    │        │      │        │      │        │
+ *                                    └────────┘      └────────┘      └────────┘
+ * ```
  */
 struct stpdfs_inode {
-	uint16_t mode; /**< file mode */
-	uint16_t nlink; /**< link count */
-	uint16_t uid;   /**< owner user id */
-	uint16_t gid;   /**< group id */
-	uint16_t flags;
-	uint32_t size;
+	uint16_t mode; /**< File mode */
+	uint16_t nlink; /**< Link count */
+	uint16_t uid;   /**< Owner user id */
+	uint16_t gid;   /**< Group id */
+	uint16_t flags; /** File flags */
+	uint32_t size; /** Data size in byte */
 	uint32_t zones[10];
-	uint64_t actime;
-	uint64_t modtime;
+	uint64_t actime; /**< Access time */
+	uint64_t modtime; /**< Modification time */
 } __attribute__((packed));
 #define STPDFS_INODE_SIZE sizeof(struct inode)
 
+# define STPDFS_NDIR 7 /**< Number of direct block */
+
+# define STPDFS_INO_FLAG_ALOC   (1 << 15)
+# define STPDFS_INO_FLAG_LZP    (1 << 1)
+# define STPDFS_INO_FLAG_ENC    (1 << 2)
+
+
+# define STPDFS_S_IFMT   0xF000
+# define STPDFS_S_IFSOCK 0xA000
+# define STPDFS_S_IFLNK  0xC000
+# define STPDFS_S_IFREG  0x8000
+# define STPDFS_S_IFBLK  0x6000
+# define STPDFS_S_IFDIR  0x4000
+
+# define STPDFS_S_ISUID 0x0800
+# define STPDFS_S_ISGID 0x0400
+# define STPDFS_S_ISVTX 0x0200
+  	  	 
+# define STPDFS_S_IRWXU 0x01C0 
+# define STPDFS_S_IRUSR 0x0100
+# define STPDFS_S_IWUSR 0x0080
+# define STPDFS_S_IXUSR 0x0040
+  	  	 
+# define STPDFS_S_IRWXG 0x0038
+# define STPDFS_S_IRGRP 0x0020
+# define STPDFS_S_IWGRP 0x0010
+# define STPDFS_S_IXGRP 0x0008
+  	  	 
+# define STPDFS_S_IRWXO 0x0007
+# define STPDFS_S_IROTH 0x0004
+# define STPDFS_S_IWOTH 0x0002
+# define STPDFS_S_IXOTH 0x0001
+
+/**
+ * \brief StupidFS directory entry
+ */
 struct stpdfs_dirent {
-	uint32_t inode;
-	char filename[STPDFS_NAME_MAX];
+	uint32_t inode; /**< inode containing file */
+	char filename[STPDFS_NAME_MAX]; /** null terminated file name (\see STPDFS_NAME_MAX) */
 };
 #define STPDFS_DIRENT_SIZE sizeof(struct stpdfs_dirent)
 
-#endif /* !STPDFS_H */
\ No newline at end of file
+#endif /* !STPIDFS_H */
\ No newline at end of file
diff --git a/lib/Makefile.am b/lib/Makefile.am
index 8ef82e7..0ce3799 100644
--- a/lib/Makefile.am
+++ b/lib/Makefile.am
@@ -1,4 +1,5 @@
 noinst_LIBRARIES = libstpdfs.a
+AM_CFLAGS = -I$(top_srcdir)/include -I$(top_srcdir)/lib -I$(top_srcdir)
 libstpdfs_a_SOURCES = block.c \
 						inode.c \
 						dir.c \
diff --git a/lib/stpdfs.h b/lib/stpdfs.h
index ef52273..b966152 100644
--- a/lib/stpdfs.h
+++ b/lib/stpdfs.h
@@ -11,134 +11,10 @@
 #ifndef STPDFS_H
 # define STPDFS_H 1
 
+# include <stupidfs.h>
 # include <stdint.h>
 # include <stddef.h>
 
-# define STPDFS_SB_MAGIC 0x44505453
-# define STPDFS_SB_REV   STPDFS_SB_REV_1
-# define STPDFS_SB_REV_1 1
-
-# define STPDFS_INO_ROOTDIR 1
-
-# define STPDFS_BLOCK_SIZE_BITS 9
-# define STPDFS_BLOCK_SIZE (1 << STPDFS_BLOCK_SIZE_BITS)
-
-# define STPDFS_NAME_MAX 28
-
-# define STPDFS_INODES_PER_BLOCK (STPDFS_BLOCK_SIZE / (sizeof(struct stpdfs_inode)))
-# define STPDFS_ZONES_PER_BLOCK (STPDFS_BLOCK_SIZE / sizeof(uint32_t))
-# define STPDFS_DIRENT_PER_BLOCK (STPDFS_BLOCK_SIZE / (sizeof(struct stpdfs_dirent)))
-# define STPDFS_NDIR 7
-# define STPDFS_ROOT_INO 1
-
-# define STPDFS_INO_FLAG_ALOC   (1 << 15)
-# define STPDFS_INO_FLAG_LARGE  (1 << 0)
-# define STPDFS_INO_FLAG_LZP    (1 << 1)
-# define STPDFS_INO_FLAG_ENC    (1 << 2)
-
-# define STPDFS_S_IFMT   0xF000
-# define STPDFS_S_IFSOCK 0xA000
-# define STPDFS_S_IFLNK  0xC000
-# define STPDFS_S_IFREG  0x8000
-# define STPDFS_S_IFBLK  0x6000
-# define STPDFS_S_IFDIR  0x4000
-
-# define STPDFS_S_ISUID 0x0800
-# define STPDFS_S_ISGID 0x0400
-# define STPDFS_S_ISVTX 0x0200
-  	  	 
-# define STPDFS_S_IRWXU 0x01C0 
-# define STPDFS_S_IRUSR 0x0100
-# define STPDFS_S_IWUSR 0x0080
-# define STPDFS_S_IXUSR 0x0040
-  	  	 
-# define STPDFS_S_IRWXG 0x0038
-# define STPDFS_S_IRGRP 0x0020
-# define STPDFS_S_IWGRP 0x0010
-# define STPDFS_S_IXGRP 0x0008
-  	  	 
-# define STPDFS_S_IRWXO 0x0007
-# define STPDFS_S_IROTH 0x0004
-# define STPDFS_S_IWOTH 0x0002
-# define STPDFS_S_IXOTH 0x0001
-
-typedef uint32_t zone_t; /**< zone number */
-typedef uint32_t block_t; /**< block number */
-
-/**
- * \brief free block list
- * ```
- * ┌──────────┐                                                           
- * │ block 99 │                              
- * ├──────────┤                              
- * │ block 98 │                              
- * ├──────────┤                              
- * │ ...      │                              
- * ├──────────┤                              
- * │ block 2  │                              
- * ├──────────┤                              
- * │ block 1  │                              
- * ├──────────┤    ┌──────────┐              
- * │ block 0  ├───►│ block 99 │              
- * └──────────┘    ├──────────┤              
- *                 │ ...      │              
- *                 ├──────────┤   ┌──────────┐
- *                 │ block 0  ├──►│ block 99 │
- *                 └──────────┘   ├──────────┤
- *                                │ ...      │
- *                                ├──────────┤
- *                                │ block 0  │
- *                                └──────────┘ 
- * ```
- */
-struct stpdfs_free {
-	block_t free[100];
-	uint8_t nfree;
-} __attribute__((packed));
-
-enum stpdfs_state {
-	STPDFS_CLEANLY_UNMOUNTED = 0,
-	STPDFS_ERROR             = 1,
-	STPDFS_DIRTY             = 1,
-};
-
-/**
- * \brief StupidFS Superblock
- */
-struct stpdfs_sb {
-	uint32_t magic; /**< MUST be \ref STPDFS_SB_MAGIC */
-	uint32_t isize; /**< size in block of the I list */
-	uint32_t fsize; /**< size in block of the entire volume */
-	struct stpdfs_free freelist; /**< \see stpdfs_free */
-	uint8_t revision; /**< MUST be \ref STPDFS_SB_REV */
-	uint16_t state; /**<  \see stpdfs_state */
-	uint64_t time; /**< last time the superblock was modified */
-} __attribute__((packed));
-
-#define STPDFS_SB_SIZE sizeof(struct stpdfs_sb)
-
-/**
- * \brief StupidFS I-node
- */
-struct stpdfs_inode {
-	uint16_t mode; /**< file mode */
-	uint16_t nlink; /**< link count */
-	uint16_t uid;   /**< owner user id */
-	uint16_t gid;   /**< group id */
-	uint16_t flags;
-	uint32_t size;
-	zone_t zones[10];
-	uint64_t actime;
-	uint64_t modtime;
-} __attribute__((packed));
-
-#define STPDFS_INODE_SIZE sizeof(struct inode)
-
-struct stpdfs_dirent {
-	uint32_t inode;
-	char filename[STPDFS_NAME_MAX];
-};
-
 /*
  * API
  */
diff --git a/tests/Makefile.am b/tests/Makefile.am
index 670acee..3d9aeb7 100644
--- a/tests/Makefile.am
+++ b/tests/Makefile.am
@@ -1,4 +1,4 @@
-AM_CPPFLAGS = -I$(top_srcdir)/lib
+AM_CPPFLAGS = -I$(top_srcdir)/lib -I$(top_srcdir)/include
 
 TESTS = test_lzp test_hchacha test_xchacha
 check_PROGRAMS = test_lzp test_hchacha test_xchacha
diff --git a/tools/Makefile.am b/tools/Makefile.am
index dd548dd..86a5a32 100644
--- a/tools/Makefile.am
+++ b/tools/Makefile.am
@@ -1,4 +1,4 @@
-AM_CFLAGS = -I$(top_srcdir)/lib -I$(top_srcdir)
+AM_CFLAGS = -I$(top_srcdir)/include -I$(top_srcdir)/lib -I$(top_srcdir)
 LDADD = ../lib/libstpdfs.a
 
 bin_PROGRAMS = mkfs.stpd tools.stpd
diff --git a/tools/mkfs/main.c b/tools/mkfs/main.c
index 153b2ff..70af679 100644
--- a/tools/mkfs/main.c
+++ b/tools/mkfs/main.c
@@ -2,12 +2,13 @@
 #include <stdlib.h>
 #include <string.h>
 #include <assert.h>
-#include <stpdfs.h>
 #include <sys/types.h>
 #include <sys/stat.h>
 #include <fcntl.h>
 #include <unistd.h>
 #include <time.h>
+#include <stupidfs.h>
+#include <stpdfs.h>
 #ifdef HAVE_CONFIG_H
 # include "config.h"
 #endif /* HAVE_CONFIG_H */
@@ -146,20 +147,20 @@ mkfs()
 
 	/* create root dir */
 	stpdfs_read(fd, 2, &inds, sizeof(struct stpdfs_inode) * STPDFS_INODES_PER_BLOCK);
-	inds[STPDFS_INO_ROOTDIR].modtime = time(NULL);
-	inds[STPDFS_INO_ROOTDIR].actime = time(NULL);
-	inds[STPDFS_INO_ROOTDIR].size = sizeof(struct stpdfs_dirent) * 2;
-	inds[STPDFS_INO_ROOTDIR].flags = STPDFS_INO_FLAG_ALOC;
-	inds[STPDFS_INO_ROOTDIR].mode = STPDFS_S_IFDIR | STPDFS_S_IRUSR | STPDFS_S_IWUSR | STPDFS_S_IXUSR | STPDFS_S_IRGRP | STPDFS_S_IXGRP | STPDFS_S_IXOTH;
-	inds[STPDFS_INO_ROOTDIR].zones[0] = stpdfs_alloc_block(fd, &super);
-	inds[STPDFS_INO_ROOTDIR].size = sizeof(struct stpdfs_dirent) * 2;
-	stpdfs_read(fd, inds[STPDFS_INO_ROOTDIR].zones[0], rootdirent, sizeof(struct stpdfs_dirent) * 2);
+	inds[STPDFS_ROOTINO].modtime = time(NULL);
+	inds[STPDFS_ROOTINO].actime = time(NULL);
+	inds[STPDFS_ROOTINO].size = sizeof(struct stpdfs_dirent) * 2;
+	inds[STPDFS_ROOTINO].flags = STPDFS_INO_FLAG_ALOC;
+	inds[STPDFS_ROOTINO].mode = STPDFS_S_IFDIR | STPDFS_S_IRUSR | STPDFS_S_IWUSR | STPDFS_S_IXUSR | STPDFS_S_IRGRP | STPDFS_S_IXGRP | STPDFS_S_IXOTH;
+	inds[STPDFS_ROOTINO].zones[0] = stpdfs_alloc_block(fd, &super);
+	inds[STPDFS_ROOTINO].size = sizeof(struct stpdfs_dirent) * 2;
+	stpdfs_read(fd, inds[STPDFS_ROOTINO].zones[0], rootdirent, sizeof(struct stpdfs_dirent) * 2);
 	strcpy(rootdirent[0].filename, ".");
 	rootdirent[1].inode = 1;
 	strcpy(rootdirent[1].filename, "..");
 	rootdirent[1].inode = 1;
-	inds[STPDFS_INO_ROOTDIR].nlink += 2;
-	stpdfs_write(fd, inds[STPDFS_INO_ROOTDIR].zones[0], rootdirent, sizeof(struct stpdfs_dirent) * 2);
+	inds[STPDFS_ROOTINO].nlink += 2;
+	stpdfs_write(fd, inds[STPDFS_ROOTINO].zones[0], rootdirent, sizeof(struct stpdfs_dirent) * 2);
 	stpdfs_write(fd, 2, &inds, sizeof(struct stpdfs_inode) * STPDFS_INODES_PER_BLOCK);
 
 	/* write super block */
diff --git a/tools/tools.stpd b/tools/tools.stpd
deleted file mode 100755
index 98c92d577f616fdde8f5c0fe1ce9c7c9b36fd24b..0000000000000000000000000000000000000000
GIT binary patch
literal 0
HcmV?d00001

literal 16200
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
PXMX3P&o71uAyfSWX?<?`