Hash :
b54c509b
Author :
Thomas de Grivel
Date :
2025-06-30T16:51:19
fix compilation on OpenBSD
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313
/* kc3
* Copyright 2025 kmx.io <contact@kmx.io>
*
* Permission is hereby granted to use this software granted the above
* copyright notice and this permission paragraph are included in all
* copies and substantial portions of this software.
*
* THIS SOFTWARE IS PROVIDED "AS-IS" WITHOUT ANY GUARANTEE OF
* PURPOSE AND PERFORMANCE. IN NO EVENT WHATSOEVER SHALL THE
* AUTHOR BE CONSIDERED LIABLE FOR THE USE AND PERFORMANCE OF
* THIS SOFTWARE.
*/
#ifndef EXT4FS_H
#define EXT4FS_H
#include <stddef.h>
#include <stdint.h>
#include <time.h>
typedef struct {
uint32_t value;
const char *name;
} s_enum;
#define EXT4FS_REV_DYNAMIC 1
#define EXT4FS_REV_MINOR 0
#define EXT4FS_LABEL_MAX 16
#define EXT4FS_LAST_MOUNTED_MAX 64
#define EXT4FS_MAGIC 0xEF53
#define EXT4FS_SUPER_BLOCK_OFFSET 1024
#define EXT4FS_SUPER_BLOCK_SIZE 1024
#define EXT4FS_VALID_FS 1
#define EXT4FS_ERRORS_CONTINUE 1 // Log and keep going
#define EXT4FS_ERRORS_RO 2 // Remount read-only
#define EXT4FS_ERRORS_PANIC 3 // Kernel panic
extern const char *ext4fs_errors_str[];
#define EXT4FS_FEATURE_COMPAT_DIR_PREALLOC 0x0001
#define EXT4FS_FEATURE_COMPAT_IMAGIC_INODES 0x0002
#define EXT4FS_FEATURE_COMPAT_HAS_JOURNAL 0x0004
#define EXT4FS_FEATURE_COMPAT_EXT_ATTR 0x0008
#define EXT4FS_FEATURE_COMPAT_RESIZE_INODE 0x0010
#define EXT4FS_FEATURE_COMPAT_DIR_INDEX 0x0020
extern const s_enum ext4fs_feature_compat_enum[];
#define EXT4FS_FEATURE_INCOMPAT_COMPRESSION 0x00001 // Not used in ext4
#define EXT4FS_FEATURE_INCOMPAT_FILETYPE 0x00002 // Directory entry has type
#define EXT4FS_FEATURE_INCOMPAT_RECOVER 0x00004 // Needs journal replay
#define EXT4FS_FEATURE_INCOMPAT_JOURNAL_DEV 0x00008 // External journal device
#define EXT4FS_FEATURE_INCOMPAT_META_BG 0x00010 // Meta block groups
#define EXT4FS_FEATURE_INCOMPAT_EXTENTS 0x00040 // Extents instead of block map
#define EXT4FS_FEATURE_INCOMPAT_64BIT 0x00080 // 64-bit block numbers
#define EXT4FS_FEATURE_INCOMPAT_MMP 0x00100 // Multiple mount protection
#define EXT4FS_FEATURE_INCOMPAT_FLEX_BG 0x00200 // Flexible block groups
#define EXT4FS_FEATURE_INCOMPAT_EA_INODE 0x00400 // In-inode xattrs
#define EXT4FS_FEATURE_INCOMPAT_DIRDATA 0x01000 // Inline dir data
#define EXT4FS_FEATURE_INCOMPAT_CSUM_SEED 0x02000 // Metadata checksum seed
#define EXT4FS_FEATURE_INCOMPAT_LARGEDIR 0x04000 // Large dir support
#define EXT4FS_FEATURE_INCOMPAT_INLINE_DATA 0x08000 // Inline file data
#define EXT4FS_FEATURE_INCOMPAT_ENCRYPT 0x10000 // File encryption
extern const s_enum ext4fs_feature_incompat_enum[];
#define EXT4FS_FEATURE_RO_COMPAT_SPARSE_SUPER 0x0001
#define EXT4FS_FEATURE_RO_COMPAT_LARGE_FILE 0x0002
#define EXT4FS_FEATURE_RO_COMPAT_BTREE_DIR 0x0004 // Not used in ext4
#define EXT4FS_FEATURE_RO_COMPAT_HUGE_FILE 0x0008
#define EXT4FS_FEATURE_RO_COMPAT_GDT_CSUM 0x0010
#define EXT4FS_FEATURE_RO_COMPAT_DIR_NLINK 0x0020
#define EXT4FS_FEATURE_RO_COMPAT_EXTRA_ISIZE 0x0040
#define EXT4FS_FEATURE_RO_COMPAT_HAS_SNAPSHOT 0x0080 // Unused
#define EXT4FS_FEATURE_RO_COMPAT_QUOTA 0x0100
#define EXT4FS_FEATURE_RO_COMPAT_BIGALLOC 0x0200
#define EXT4FS_FEATURE_RO_COMPAT_METADATA_CSUM 0x0400
#define EXT4FS_FEATURE_RO_COMPAT_REPLICA 0x0800 // Unused
#define EXT4FS_FEATURE_RO_COMPAT_READONLY 0x1000
#define EXT4FS_FEATURE_RO_COMPAT_PROJECT 0x2000
extern const s_enum ext4fs_feature_ro_compat_enum[];
#define EXT4FS_MOUNT_READONLY 0x0001
#define EXT4FS_MOUNT_NO_ATIME 0x0002
#define EXT4FS_MOUNT_DIRSYNC 0x0004
#define EXT4FS_MOUNT_DATA_JOURNAL 0x0008
#define EXT4FS_MOUNT_DATA_ORDERED 0x0010
#define EXT4FS_MOUNT_DATA_WRITEBACK 0x0020
#define EXT4FS_MOUNT_ERRORS_CONTINUE 0x0040
#define EXT4FS_MOUNT_ERRORS_REMOUNT_RO 0x0080
#define EXT4FS_MOUNT_ERRORS_PANIC 0x0100
#define EXT4FS_MOUNT_DISCARD 0x0200
#define EXT4FS_MOUNT_NO_BUFFER_HEADS 0x0400
#define EXT4FS_MOUNT_SKIP_JOURNAL 0x0800
#define EXT4FS_MOUNT_NOAUTO_DELAYED_ALLOC 0x1000
extern const s_enum ext4fs_mount_enum[];
#define EXT4FS_OS_LINUX 0
#define EXT4FS_OS_HURD 1
#define EXT4FS_OS_MASIX 2
#define EXT4FS_OS_FREEBSD 3
#define EXT4FS_OS_LITES 4
#define EXT4FS_OS_OPENBSD 5
extern const char *ext4fs_os_str[];
#define EXT4FS_STATE_VALID 0x0001 // Clean unmount
#define EXT4FS_STATE_ERROR 0x0002 // Errors detected (fsck needed)
extern const s_enum ext4fs_state_enum[];
struct ext4fs_super_block {
uint32_t sb_inodes_count;
uint32_t sb_blocks_count_lo;
uint32_t sb_reserved_blocks_count_lo;
uint32_t sb_free_blocks_count_lo;
uint32_t sb_free_inodes_count;
uint32_t sb_first_data_block;
uint32_t sb_log_block_size; // log2(block size) - 10
uint32_t sb_log_cluster_size; // log2(cluster size) - 10
uint32_t sb_blocks_per_group;
uint32_t sb_clusters_per_group;
uint32_t sb_inodes_per_group;
uint32_t sb_mount_time;
uint32_t sb_write_time;
uint16_t sb_mount_count;
int16_t sb_max_mount_count_before_fsck;
uint16_t sb_magic;
uint16_t sb_state; // EXT4FS_STATE_*
uint16_t sb_errors; // EXT4FS_ERRORS_*
uint16_t sb_revision_level_minor;
uint32_t sb_check_time;
uint32_t sb_check_interval;
uint32_t sb_creator_os; // EXT4FS_OS_*
uint32_t sb_revision_level;
uint16_t sb_default_reserved_uid;
uint16_t sb_default_reserved_gid;
uint32_t sb_first_non_reserved_inode;
uint16_t sb_inode_size;
uint16_t sb_block_group_id;
uint32_t sb_feature_compat;
uint32_t sb_feature_incompat;
uint32_t sb_feature_ro_compat;
uint8_t sb_uuid[16];
char sb_volume_name[EXT4FS_LABEL_MAX];
char sb_last_mounted[EXT4FS_LAST_MOUNTED_MAX];
uint32_t sb_algorithm_usage_bitmap;
uint8_t sb_preallocate_blocks;
uint8_t sb_preallocate_dir_blocks;
uint16_t sb_reserved_gdt_blocks; // Per group desc for online growth
uint8_t sb_journal_uuid[16]; // UUID of journal superblock
uint32_t sb_journal_inode_number;
uint32_t sb_journal_device_number;
uint32_t sb_last_orphan;
uint32_t sb_hash_seed[4];
uint8_t sb_default_hash_version;
uint8_t sb_journal_backup_type;
uint16_t sb_group_descriptor_size;
uint32_t sb_default_mount_opts;
uint32_t sb_first_meta_block_group;
uint32_t sb_newfs_time;
uint32_t sb_jnl_blocks[17]; // Backup of journal inode
uint32_t sb_blocks_count_hi;
uint32_t sb_reserved_blocks_count_hi;
uint32_t sb_free_blocks_count_hi;
uint16_t sb_min_extra_isize;
uint16_t sb_want_extra_isize;
uint32_t sb_flags;
uint16_t sb_raid_stride;
uint16_t sb_mmp_interval;
uint64_t sb_mmp_block;
uint32_t sb_raid_stripe_width;
uint8_t sb_log_groups_per_flex;
uint8_t sb_checksum_type;
uint16_t sb_reserved_pad;
uint64_t sb_kbytes_written;
uint32_t sb_snapshot_inum;
uint32_t sb_snapshot_id;
uint64_t sb_snapshot_r_blocks_count;
uint32_t sb_snapshot_list;
uint32_t sb_error_count;
uint32_t sb_first_error_time;
uint32_t sb_first_error_ino;
uint64_t sb_first_error_block;
uint8_t sb_first_error_func[32];
uint32_t sb_first_error_line;
uint32_t sb_last_error_time;
uint32_t sb_last_error_ino;
uint32_t sb_last_error_line;
uint64_t sb_last_error_block;
uint8_t sb_last_error_func[32];
uint8_t sb_mount_opts[64];
uint32_t sb_usr_quota_inum;
uint32_t sb_grp_quota_inum;
uint32_t sb_overhead_blocks;
uint32_t sb_backup_bgs[2];
uint8_t sb_encrypt_algos[4];
uint8_t sb_encrypt_pw_salt[16];
uint32_t sb_lpf_ino;
uint32_t sb_prj_quota_inum;
uint32_t sb_checksum_seed;
uint8_t sb_wtime_hi;
uint8_t sb_mtime_hi;
uint8_t sb_mkfs_time_hi;
uint8_t sb_lastcheck_hi;
uint8_t sb_first_error_time_hi;
uint8_t sb_last_error_time_hi;
uint8_t sb_pad[2];
uint32_t sb_reserved[96];
uint32_t sb_checksum; // Superblock checksum
} __attribute__((packed));
struct ext4fs_group_desc {
uint32_t gd_block_bitmap_lo; // Block ID of block bitmap
uint32_t gd_inode_bitmap_lo; // Block ID of inode bitmap
uint32_t gd_inode_table_lo; // Starting block of inode table
uint16_t gd_free_blocks_count; // Free blocks in this group
uint16_t gd_free_inodes_count; // Free inodes in this group
uint16_t gd_used_dirs_count; // Number of directories in this group
uint16_t gd_flags;
uint32_t gd_exclude_bitmap_lo; // Optional (sparse allocation)
uint16_t gd_block_bitmap_csum;
uint16_t gd_inode_bitmap_csum;
uint16_t gd_itable_unused;
uint16_t gd_checksum;
uint32_t gd_block_bitmap_hi;
uint32_t gd_inode_bitmap_hi;
uint32_t gd_inode_table_hi;
uint16_t gd_free_blocks_count_hi;
uint16_t gd_free_inodes_count_hi;
uint16_t gd_used_dirs_count_hi;
uint16_t gd_itable_unused_hi;
uint32_t gd_exclude_bitmap_hi;
uint16_t gd_block_bitmap_csum_hi;
uint16_t gd_inode_bitmap_csum_hi;
uint32_t gd_reserved;
} __attribute__((packed));
int ext4fs_block_bitmap (const struct ext4fs_super_block *sb,
const struct ext4fs_group_desc *gd,
uint64_t *dest);
int ext4fs_block_size (const struct ext4fs_super_block *sb,
uint32_t *dest);
int ext4fs_blocks_count (const struct ext4fs_super_block *sb,
uint64_t *dest);
struct disklabel *
ext4fs_disklabel_get (struct disklabel *dl, int fd);
int ext4fs_free_blocks_count (const struct ext4fs_super_block *sb,
uint64_t *dest);
struct ext4fs_group_desc *
ext4fs_group_desc_read (struct ext4fs_group_desc *gd,
int fd,
const struct ext4fs_super_block *sb);
int ext4fs_inode_bitmap (const struct ext4fs_super_block *sb,
const struct ext4fs_group_desc *gd,
uint64_t *dest);
int ext4fs_inode_table (const struct ext4fs_super_block *sb,
const struct ext4fs_group_desc *gd,
uint64_t *dest);
int ext4fs_inspect (const char *dev, int fd);
void ext4fs_inspect_creator_os (uint16_t creator_os);
int ext4fs_inspect_enum (uint32_t x, const s_enum *enum_desc);
void ext4fs_inspect_errors (uint16_t errors);
int ext4fs_inspect_group_desc (const struct ext4fs_super_block *sb,
const struct ext4fs_group_desc *gd);
int ext4fs_inspect_super_block (const struct ext4fs_super_block *sb);
int ext4fs_reserved_blocks_count (const struct ext4fs_super_block *sb,
uint64_t *dest);
int ext4fs_size (const char *dev, int fd, uint64_t *dest);
struct ext4fs_super_block *
ext4fs_super_block_read (struct ext4fs_super_block *sb,
int fd);
int ext4fs_time_to_str (time_t time, char *str, size_t size);
#endif /* EXT4FS_H */