[eb91db7] | 1 | /*
|
---|
| 2 | * Copyright (c) 2011 Frantisek Princ
|
---|
| 3 | * All rights reserved.
|
---|
| 4 | *
|
---|
| 5 | * Redistribution and use in source and binary forms, with or without
|
---|
| 6 | * modification, are permitted provided that the following conditions
|
---|
| 7 | * are met:
|
---|
| 8 | *
|
---|
| 9 | * - Redistributions of source code must retain the above copyright
|
---|
| 10 | * notice, this list of conditions and the following disclaimer.
|
---|
| 11 | * - Redistributions in binary form must reproduce the above copyright
|
---|
| 12 | * notice, this list of conditions and the following disclaimer in the
|
---|
| 13 | * documentation and/or other materials provided with the distribution.
|
---|
| 14 | * - The name of the author may not be used to endorse or promote products
|
---|
| 15 | * derived from this software without specific prior written permission.
|
---|
| 16 | *
|
---|
| 17 | * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
---|
| 18 | * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
---|
| 19 | * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
---|
| 20 | * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
---|
| 21 | * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
---|
| 22 | * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
---|
| 23 | * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
---|
| 24 | * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
---|
| 25 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
---|
| 26 | * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
---|
| 27 | */
|
---|
| 28 |
|
---|
| 29 | /** @addtogroup libext4
|
---|
| 30 | * @{
|
---|
[9875711] | 31 | */
|
---|
[eb91db7] | 32 |
|
---|
| 33 | #ifndef LIBEXT4_LIBEXT4_SUPERBLOCK_H_
|
---|
| 34 | #define LIBEXT4_LIBEXT4_SUPERBLOCK_H_
|
---|
| 35 |
|
---|
[01ab41b] | 36 | #include <libblock.h>
|
---|
[9875711] | 37 | #include <sys/types.h>
|
---|
| 38 |
|
---|
| 39 | /*
|
---|
| 40 | * Structure of the super block
|
---|
| 41 | */
|
---|
| 42 | typedef struct ext4_superblock {
|
---|
[9c0c0e1] | 43 | uint32_t inodes_count; // Inodes count
|
---|
[9875711] | 44 | uint32_t s_blocks_count_lo; // Blocks count
|
---|
| 45 | uint32_t s_r_blocks_count_lo; // Reserved blocks count
|
---|
[9c0c0e1] | 46 | uint32_t free_blocks_count_lo; // Free blocks count
|
---|
| 47 | uint32_t free_inodes_count; // Free inodes count
|
---|
| 48 | uint32_t first_data_block; // First Data Block
|
---|
| 49 | uint32_t log_block_size; // Block size
|
---|
[9875711] | 50 | uint32_t s_obso_log_frag_size; // Obsoleted fragment size
|
---|
| 51 | uint32_t s_blocks_per_group; // Number of blocks per group
|
---|
| 52 | uint32_t s_obso_frags_per_group; // Obsoleted fragments per group
|
---|
[3711e7e] | 53 | uint32_t inodes_per_group; // Number of inodes per group
|
---|
[9875711] | 54 | uint32_t s_mtime; // Mount time
|
---|
| 55 | uint32_t s_wtime; // Write time
|
---|
[9c0c0e1] | 56 | uint16_t mount_count; // Mount count
|
---|
| 57 | uint16_t max_mount_count; // Maximal mount count
|
---|
| 58 | uint16_t magic; // Magic signature
|
---|
| 59 | uint16_t state; // File system state
|
---|
| 60 | uint16_t errors; // Behaviour when detecting errors
|
---|
| 61 | uint16_t minor_rev_level; // Minor revision level
|
---|
| 62 | uint32_t last_check; // Time of last check
|
---|
| 63 | uint32_t checkinterval; // Maximum time between checks
|
---|
| 64 | uint32_t creator_os; // Creator OS
|
---|
| 65 | uint32_t rev_level; // Revision level
|
---|
[9875711] | 66 | uint16_t s_def_resuid; // Default uid for reserved blocks
|
---|
| 67 | uint16_t s_def_resgid; // Default gid for reserved blocks
|
---|
| 68 |
|
---|
| 69 | // Fields for EXT4_DYNAMIC_REV superblocks only.
|
---|
| 70 | uint32_t s_first_ino; // First non-reserved inode
|
---|
[3711e7e] | 71 | uint16_t inode_size; // Size of inode structure
|
---|
[9875711] | 72 | uint16_t s_block_group_nr; // Block group number of this superblock
|
---|
[9c0c0e1] | 73 | uint32_t features_compatible; // Compatible feature set
|
---|
| 74 | uint32_t features_incompatible; // Incompatible feature set
|
---|
| 75 | uint32_t features_read_only; // Readonly-compatible feature set
|
---|
[9875711] | 76 | uint8_t s_uuid[16]; // 128-bit uuid for volume
|
---|
| 77 | char s_volume_name[16]; // Volume name
|
---|
| 78 | char s_last_mounted[64]; // Directory where last mounted
|
---|
| 79 | uint32_t s_algorithm_usage_bitmap; // For compression
|
---|
| 80 |
|
---|
| 81 | /*
|
---|
| 82 | * Performance hints. Directory preallocation should only
|
---|
| 83 | * happen if the EXT4_FEATURE_COMPAT_DIR_PREALLOC flag is on.
|
---|
| 84 | */
|
---|
| 85 | uint8_t s_prealloc_blocks; // Number of blocks to try to preallocate
|
---|
| 86 | uint8_t s_prealloc_dir_blocks; // Number to preallocate for dirs
|
---|
| 87 | uint16_t s_reserved_gdt_blocks; // Per group desc for online growth
|
---|
| 88 |
|
---|
| 89 | /*
|
---|
| 90 | * Journaling support valid if EXT4_FEATURE_COMPAT_HAS_JOURNAL set.
|
---|
| 91 | */
|
---|
| 92 | uint8_t s_journal_uuid[16]; // UUID of journal superblock
|
---|
| 93 | uint32_t s_journal_inum; // Inode number of journal file
|
---|
| 94 | uint32_t s_journal_dev; // Device number of journal file
|
---|
| 95 | uint32_t s_last_orphan; // Head of list of inodes to delete
|
---|
| 96 | uint32_t s_hash_seed[4]; // HTREE hash seed
|
---|
| 97 | uint8_t s_def_hash_version; // Default hash version to use
|
---|
| 98 | uint8_t s_jnl_backup_type;
|
---|
| 99 | uint16_t s_desc_size; // Size of group descriptor
|
---|
| 100 | uint32_t s_default_mount_opts; // Default mount options
|
---|
| 101 | uint32_t s_first_meta_bg; // First metablock block group
|
---|
| 102 | uint32_t s_mkfs_time; // When the filesystem was created
|
---|
| 103 | uint32_t s_jnl_blocks[17]; // Backup of the journal inode
|
---|
| 104 |
|
---|
| 105 | /* 64bit support valid if EXT4_FEATURE_COMPAT_64BIT */
|
---|
| 106 | uint32_t s_blocks_count_hi; // Blocks count
|
---|
| 107 | uint32_t s_r_blocks_count_hi; // Reserved blocks count
|
---|
| 108 | uint32_t s_free_blocks_count_hi; // Free blocks count
|
---|
| 109 | uint16_t s_min_extra_isize; // All inodes have at least # bytes
|
---|
| 110 | uint16_t s_want_extra_isize; // New inodes should reserve # bytes
|
---|
| 111 | uint32_t s_flags; // Miscellaneous flags
|
---|
| 112 | uint16_t s_raid_stride; // RAID stride
|
---|
| 113 | uint16_t s_mmp_interval; // # seconds to wait in MMP checking
|
---|
| 114 | uint64_t s_mmp_block; // Block for multi-mount protection
|
---|
| 115 | uint32_t s_raid_stripe_width; // blocks on all data disks (N*stride)
|
---|
| 116 | uint8_t s_log_groups_per_flex; // FLEX_BG group size
|
---|
| 117 | uint8_t s_reserved_char_pad;
|
---|
| 118 | uint16_t s_reserved_pad;
|
---|
| 119 | uint64_t s_kbytes_written; // Number of lifetime kilobytes written
|
---|
| 120 | uint32_t s_snapshot_inum; // Inode number of active snapshot
|
---|
| 121 | uint32_t s_snapshot_id; // Sequential ID of active snapshot
|
---|
| 122 | uint64_t s_snapshot_r_blocks_count; /* reserved blocks for active snapshot's future use */
|
---|
| 123 | uint32_t s_snapshot_list; // inode number of the head of the on-disk snapshot list
|
---|
| 124 | uint32_t s_error_count; // number of fs errors
|
---|
| 125 | uint32_t s_first_error_time; // First time an error happened
|
---|
| 126 | uint32_t s_first_error_ino; // Inode involved in first error
|
---|
| 127 | uint64_t s_first_error_block; // block involved of first error
|
---|
| 128 | uint8_t s_first_error_func[32]; // Function where the error happened
|
---|
| 129 | uint32_t s_first_error_line; // Line number where error happened
|
---|
| 130 | uint32_t s_last_error_time; // Most recent time of an error
|
---|
| 131 | uint32_t s_last_error_ino; // Inode involved in last error
|
---|
| 132 | uint32_t s_last_error_line; // Line number where error happened
|
---|
| 133 | uint64_t s_last_error_block; /* block involved of last error */
|
---|
| 134 | uint8_t s_last_error_func[32]; /* function where the error happened */
|
---|
| 135 | uint8_t s_mount_opts[64];
|
---|
| 136 | uint32_t s_reserved[112]; // Padding to the end of the block
|
---|
| 137 |
|
---|
| 138 | } __attribute__((packed)) ext4_superblock_t;
|
---|
| 139 |
|
---|
[01ab41b] | 140 | #define EXT4_SUPERBLOCK_MAGIC 0xEF53
|
---|
| 141 | #define EXT4_SUPERBLOCK_SIZE 1024
|
---|
| 142 | #define EXT4_SUPERBLOCK_OFFSET 1024
|
---|
| 143 |
|
---|
[9c0c0e1] | 144 | extern uint16_t ext4_superblock_get_magic(ext4_superblock_t *);
|
---|
| 145 | extern uint32_t ext4_superblock_get_first_block(ext4_superblock_t *);
|
---|
[01ab41b] | 146 | extern uint32_t ext4_superblock_get_block_size_log2(ext4_superblock_t *);
|
---|
| 147 | extern uint32_t ext4_superblock_get_block_size(ext4_superblock_t *);
|
---|
[9c0c0e1] | 148 | extern uint32_t ext4_superblock_get_rev_level(ext4_superblock_t *);
|
---|
[3711e7e] | 149 | extern uint16_t ext4_superblock_get_inode_size(ext4_superblock_t *);
|
---|
| 150 | extern uint32_t ext4_superblock_get_inodes_per_group(ext4_superblock_t *);
|
---|
[9c0c0e1] | 151 | extern uint32_t ext4_superblock_get_features_compatible(ext4_superblock_t *);
|
---|
| 152 | extern uint32_t ext4_superblock_get_features_incompatible(ext4_superblock_t *);
|
---|
| 153 | extern uint32_t ext4_superblock_get_features_read_only(ext4_superblock_t *);
|
---|
[01ab41b] | 154 |
|
---|
| 155 | extern int ext4_superblock_read_direct(service_id_t, ext4_superblock_t **);
|
---|
| 156 | extern int ext4_superblock_check_sanity(ext4_superblock_t *);
|
---|
[eb91db7] | 157 |
|
---|
| 158 | #endif
|
---|
| 159 |
|
---|
| 160 | /**
|
---|
| 161 | * @}
|
---|
| 162 | */
|
---|