at v2.6.21 34 kB view raw
1/* 2 * linux/include/linux/ext4_fs.h 3 * 4 * Copyright (C) 1992, 1993, 1994, 1995 5 * Remy Card (card@masi.ibp.fr) 6 * Laboratoire MASI - Institut Blaise Pascal 7 * Universite Pierre et Marie Curie (Paris VI) 8 * 9 * from 10 * 11 * linux/include/linux/minix_fs.h 12 * 13 * Copyright (C) 1991, 1992 Linus Torvalds 14 */ 15 16#ifndef _LINUX_EXT4_FS_H 17#define _LINUX_EXT4_FS_H 18 19#include <linux/types.h> 20#include <linux/blkdev.h> 21#include <linux/magic.h> 22 23/* 24 * The second extended filesystem constants/structures 25 */ 26 27/* 28 * Define EXT4FS_DEBUG to produce debug messages 29 */ 30#undef EXT4FS_DEBUG 31 32/* 33 * Define EXT4_RESERVATION to reserve data blocks for expanding files 34 */ 35#define EXT4_DEFAULT_RESERVE_BLOCKS 8 36/*max window size: 1024(direct blocks) + 3([t,d]indirect blocks) */ 37#define EXT4_MAX_RESERVE_BLOCKS 1027 38#define EXT4_RESERVE_WINDOW_NOT_ALLOCATED 0 39/* 40 * Always enable hashed directories 41 */ 42#define CONFIG_EXT4_INDEX 43 44/* 45 * Debug code 46 */ 47#ifdef EXT4FS_DEBUG 48#define ext4_debug(f, a...) \ 49 do { \ 50 printk (KERN_DEBUG "EXT4-fs DEBUG (%s, %d): %s:", \ 51 __FILE__, __LINE__, __FUNCTION__); \ 52 printk (KERN_DEBUG f, ## a); \ 53 } while (0) 54#else 55#define ext4_debug(f, a...) do {} while (0) 56#endif 57 58/* 59 * Special inodes numbers 60 */ 61#define EXT4_BAD_INO 1 /* Bad blocks inode */ 62#define EXT4_ROOT_INO 2 /* Root inode */ 63#define EXT4_BOOT_LOADER_INO 5 /* Boot loader inode */ 64#define EXT4_UNDEL_DIR_INO 6 /* Undelete directory inode */ 65#define EXT4_RESIZE_INO 7 /* Reserved group descriptors inode */ 66#define EXT4_JOURNAL_INO 8 /* Journal inode */ 67 68/* First non-reserved inode for old ext4 filesystems */ 69#define EXT4_GOOD_OLD_FIRST_INO 11 70 71/* 72 * Maximal count of links to a file 73 */ 74#define EXT4_LINK_MAX 32000 75 76/* 77 * Macro-instructions used to manage several block sizes 78 */ 79#define EXT4_MIN_BLOCK_SIZE 1024 80#define EXT4_MAX_BLOCK_SIZE 4096 81#define EXT4_MIN_BLOCK_LOG_SIZE 10 82#ifdef __KERNEL__ 83# define EXT4_BLOCK_SIZE(s) ((s)->s_blocksize) 84#else 85# define EXT4_BLOCK_SIZE(s) (EXT4_MIN_BLOCK_SIZE << (s)->s_log_block_size) 86#endif 87#define EXT4_ADDR_PER_BLOCK(s) (EXT4_BLOCK_SIZE(s) / sizeof (__u32)) 88#ifdef __KERNEL__ 89# define EXT4_BLOCK_SIZE_BITS(s) ((s)->s_blocksize_bits) 90#else 91# define EXT4_BLOCK_SIZE_BITS(s) ((s)->s_log_block_size + 10) 92#endif 93#ifdef __KERNEL__ 94#define EXT4_ADDR_PER_BLOCK_BITS(s) (EXT4_SB(s)->s_addr_per_block_bits) 95#define EXT4_INODE_SIZE(s) (EXT4_SB(s)->s_inode_size) 96#define EXT4_FIRST_INO(s) (EXT4_SB(s)->s_first_ino) 97#else 98#define EXT4_INODE_SIZE(s) (((s)->s_rev_level == EXT4_GOOD_OLD_REV) ? \ 99 EXT4_GOOD_OLD_INODE_SIZE : \ 100 (s)->s_inode_size) 101#define EXT4_FIRST_INO(s) (((s)->s_rev_level == EXT4_GOOD_OLD_REV) ? \ 102 EXT4_GOOD_OLD_FIRST_INO : \ 103 (s)->s_first_ino) 104#endif 105 106/* 107 * Macro-instructions used to manage fragments 108 */ 109#define EXT4_MIN_FRAG_SIZE 1024 110#define EXT4_MAX_FRAG_SIZE 4096 111#define EXT4_MIN_FRAG_LOG_SIZE 10 112#ifdef __KERNEL__ 113# define EXT4_FRAG_SIZE(s) (EXT4_SB(s)->s_frag_size) 114# define EXT4_FRAGS_PER_BLOCK(s) (EXT4_SB(s)->s_frags_per_block) 115#else 116# define EXT4_FRAG_SIZE(s) (EXT4_MIN_FRAG_SIZE << (s)->s_log_frag_size) 117# define EXT4_FRAGS_PER_BLOCK(s) (EXT4_BLOCK_SIZE(s) / EXT4_FRAG_SIZE(s)) 118#endif 119 120/* 121 * Structure of a blocks group descriptor 122 */ 123struct ext4_group_desc 124{ 125 __le32 bg_block_bitmap; /* Blocks bitmap block */ 126 __le32 bg_inode_bitmap; /* Inodes bitmap block */ 127 __le32 bg_inode_table; /* Inodes table block */ 128 __le16 bg_free_blocks_count; /* Free blocks count */ 129 __le16 bg_free_inodes_count; /* Free inodes count */ 130 __le16 bg_used_dirs_count; /* Directories count */ 131 __u16 bg_flags; 132 __u32 bg_reserved[3]; 133 __le32 bg_block_bitmap_hi; /* Blocks bitmap block MSB */ 134 __le32 bg_inode_bitmap_hi; /* Inodes bitmap block MSB */ 135 __le32 bg_inode_table_hi; /* Inodes table block MSB */ 136}; 137 138#ifdef __KERNEL__ 139#include <linux/ext4_fs_i.h> 140#include <linux/ext4_fs_sb.h> 141#endif 142/* 143 * Macro-instructions used to manage group descriptors 144 */ 145#define EXT4_MIN_DESC_SIZE 32 146#define EXT4_MIN_DESC_SIZE_64BIT 64 147#define EXT4_MAX_DESC_SIZE EXT4_MIN_BLOCK_SIZE 148#define EXT4_DESC_SIZE(s) (EXT4_SB(s)->s_desc_size) 149#ifdef __KERNEL__ 150# define EXT4_BLOCKS_PER_GROUP(s) (EXT4_SB(s)->s_blocks_per_group) 151# define EXT4_DESC_PER_BLOCK(s) (EXT4_SB(s)->s_desc_per_block) 152# define EXT4_INODES_PER_GROUP(s) (EXT4_SB(s)->s_inodes_per_group) 153# define EXT4_DESC_PER_BLOCK_BITS(s) (EXT4_SB(s)->s_desc_per_block_bits) 154#else 155# define EXT4_BLOCKS_PER_GROUP(s) ((s)->s_blocks_per_group) 156# define EXT4_DESC_PER_BLOCK(s) (EXT4_BLOCK_SIZE(s) / EXT4_DESC_SIZE(s)) 157# define EXT4_INODES_PER_GROUP(s) ((s)->s_inodes_per_group) 158#endif 159 160/* 161 * Constants relative to the data blocks 162 */ 163#define EXT4_NDIR_BLOCKS 12 164#define EXT4_IND_BLOCK EXT4_NDIR_BLOCKS 165#define EXT4_DIND_BLOCK (EXT4_IND_BLOCK + 1) 166#define EXT4_TIND_BLOCK (EXT4_DIND_BLOCK + 1) 167#define EXT4_N_BLOCKS (EXT4_TIND_BLOCK + 1) 168 169/* 170 * Inode flags 171 */ 172#define EXT4_SECRM_FL 0x00000001 /* Secure deletion */ 173#define EXT4_UNRM_FL 0x00000002 /* Undelete */ 174#define EXT4_COMPR_FL 0x00000004 /* Compress file */ 175#define EXT4_SYNC_FL 0x00000008 /* Synchronous updates */ 176#define EXT4_IMMUTABLE_FL 0x00000010 /* Immutable file */ 177#define EXT4_APPEND_FL 0x00000020 /* writes to file may only append */ 178#define EXT4_NODUMP_FL 0x00000040 /* do not dump file */ 179#define EXT4_NOATIME_FL 0x00000080 /* do not update atime */ 180/* Reserved for compression usage... */ 181#define EXT4_DIRTY_FL 0x00000100 182#define EXT4_COMPRBLK_FL 0x00000200 /* One or more compressed clusters */ 183#define EXT4_NOCOMPR_FL 0x00000400 /* Don't compress */ 184#define EXT4_ECOMPR_FL 0x00000800 /* Compression error */ 185/* End compression flags --- maybe not all used */ 186#define EXT4_INDEX_FL 0x00001000 /* hash-indexed directory */ 187#define EXT4_IMAGIC_FL 0x00002000 /* AFS directory */ 188#define EXT4_JOURNAL_DATA_FL 0x00004000 /* file data should be journaled */ 189#define EXT4_NOTAIL_FL 0x00008000 /* file tail should not be merged */ 190#define EXT4_DIRSYNC_FL 0x00010000 /* dirsync behaviour (directories only) */ 191#define EXT4_TOPDIR_FL 0x00020000 /* Top of directory hierarchies*/ 192#define EXT4_RESERVED_FL 0x80000000 /* reserved for ext4 lib */ 193#define EXT4_EXTENTS_FL 0x00080000 /* Inode uses extents */ 194 195#define EXT4_FL_USER_VISIBLE 0x000BDFFF /* User visible flags */ 196#define EXT4_FL_USER_MODIFIABLE 0x000380FF /* User modifiable flags */ 197 198/* 199 * Inode dynamic state flags 200 */ 201#define EXT4_STATE_JDATA 0x00000001 /* journaled data exists */ 202#define EXT4_STATE_NEW 0x00000002 /* inode is newly created */ 203#define EXT4_STATE_XATTR 0x00000004 /* has in-inode xattrs */ 204 205/* Used to pass group descriptor data when online resize is done */ 206struct ext4_new_group_input { 207 __u32 group; /* Group number for this data */ 208 __u64 block_bitmap; /* Absolute block number of block bitmap */ 209 __u64 inode_bitmap; /* Absolute block number of inode bitmap */ 210 __u64 inode_table; /* Absolute block number of inode table start */ 211 __u32 blocks_count; /* Total number of blocks in this group */ 212 __u16 reserved_blocks; /* Number of reserved blocks in this group */ 213 __u16 unused; 214}; 215 216/* The struct ext4_new_group_input in kernel space, with free_blocks_count */ 217struct ext4_new_group_data { 218 __u32 group; 219 __u64 block_bitmap; 220 __u64 inode_bitmap; 221 __u64 inode_table; 222 __u32 blocks_count; 223 __u16 reserved_blocks; 224 __u16 unused; 225 __u32 free_blocks_count; 226}; 227 228 229/* 230 * ioctl commands 231 */ 232#define EXT4_IOC_GETFLAGS FS_IOC_GETFLAGS 233#define EXT4_IOC_SETFLAGS FS_IOC_SETFLAGS 234#define EXT4_IOC_GETVERSION _IOR('f', 3, long) 235#define EXT4_IOC_SETVERSION _IOW('f', 4, long) 236#define EXT4_IOC_GROUP_EXTEND _IOW('f', 7, unsigned long) 237#define EXT4_IOC_GROUP_ADD _IOW('f', 8,struct ext4_new_group_input) 238#define EXT4_IOC_GETVERSION_OLD FS_IOC_GETVERSION 239#define EXT4_IOC_SETVERSION_OLD FS_IOC_SETVERSION 240#ifdef CONFIG_JBD_DEBUG 241#define EXT4_IOC_WAIT_FOR_READONLY _IOR('f', 99, long) 242#endif 243#define EXT4_IOC_GETRSVSZ _IOR('f', 5, long) 244#define EXT4_IOC_SETRSVSZ _IOW('f', 6, long) 245 246/* 247 * ioctl commands in 32 bit emulation 248 */ 249#define EXT4_IOC32_GETFLAGS FS_IOC32_GETFLAGS 250#define EXT4_IOC32_SETFLAGS FS_IOC32_SETFLAGS 251#define EXT4_IOC32_GETVERSION _IOR('f', 3, int) 252#define EXT4_IOC32_SETVERSION _IOW('f', 4, int) 253#define EXT4_IOC32_GETRSVSZ _IOR('f', 5, int) 254#define EXT4_IOC32_SETRSVSZ _IOW('f', 6, int) 255#define EXT4_IOC32_GROUP_EXTEND _IOW('f', 7, unsigned int) 256#ifdef CONFIG_JBD_DEBUG 257#define EXT4_IOC32_WAIT_FOR_READONLY _IOR('f', 99, int) 258#endif 259#define EXT4_IOC32_GETVERSION_OLD FS_IOC32_GETVERSION 260#define EXT4_IOC32_SETVERSION_OLD FS_IOC32_SETVERSION 261 262 263/* 264 * Mount options 265 */ 266struct ext4_mount_options { 267 unsigned long s_mount_opt; 268 uid_t s_resuid; 269 gid_t s_resgid; 270 unsigned long s_commit_interval; 271#ifdef CONFIG_QUOTA 272 int s_jquota_fmt; 273 char *s_qf_names[MAXQUOTAS]; 274#endif 275}; 276 277/* 278 * Structure of an inode on the disk 279 */ 280struct ext4_inode { 281 __le16 i_mode; /* File mode */ 282 __le16 i_uid; /* Low 16 bits of Owner Uid */ 283 __le32 i_size; /* Size in bytes */ 284 __le32 i_atime; /* Access time */ 285 __le32 i_ctime; /* Creation time */ 286 __le32 i_mtime; /* Modification time */ 287 __le32 i_dtime; /* Deletion Time */ 288 __le16 i_gid; /* Low 16 bits of Group Id */ 289 __le16 i_links_count; /* Links count */ 290 __le32 i_blocks; /* Blocks count */ 291 __le32 i_flags; /* File flags */ 292 union { 293 struct { 294 __u32 l_i_reserved1; 295 } linux1; 296 struct { 297 __u32 h_i_translator; 298 } hurd1; 299 struct { 300 __u32 m_i_reserved1; 301 } masix1; 302 } osd1; /* OS dependent 1 */ 303 __le32 i_block[EXT4_N_BLOCKS];/* Pointers to blocks */ 304 __le32 i_generation; /* File version (for NFS) */ 305 __le32 i_file_acl; /* File ACL */ 306 __le32 i_dir_acl; /* Directory ACL */ 307 __le32 i_faddr; /* Fragment address */ 308 union { 309 struct { 310 __u8 l_i_frag; /* Fragment number */ 311 __u8 l_i_fsize; /* Fragment size */ 312 __le16 l_i_file_acl_high; 313 __le16 l_i_uid_high; /* these 2 fields */ 314 __le16 l_i_gid_high; /* were reserved2[0] */ 315 __u32 l_i_reserved2; 316 } linux2; 317 struct { 318 __u8 h_i_frag; /* Fragment number */ 319 __u8 h_i_fsize; /* Fragment size */ 320 __u16 h_i_mode_high; 321 __u16 h_i_uid_high; 322 __u16 h_i_gid_high; 323 __u32 h_i_author; 324 } hurd2; 325 struct { 326 __u8 m_i_frag; /* Fragment number */ 327 __u8 m_i_fsize; /* Fragment size */ 328 __le16 m_i_file_acl_high; 329 __u32 m_i_reserved2[2]; 330 } masix2; 331 } osd2; /* OS dependent 2 */ 332 __le16 i_extra_isize; 333 __le16 i_pad1; 334}; 335 336#define i_size_high i_dir_acl 337 338#if defined(__KERNEL__) || defined(__linux__) 339#define i_reserved1 osd1.linux1.l_i_reserved1 340#define i_frag osd2.linux2.l_i_frag 341#define i_fsize osd2.linux2.l_i_fsize 342#define i_file_acl_high osd2.linux2.l_i_file_acl_high 343#define i_uid_low i_uid 344#define i_gid_low i_gid 345#define i_uid_high osd2.linux2.l_i_uid_high 346#define i_gid_high osd2.linux2.l_i_gid_high 347#define i_reserved2 osd2.linux2.l_i_reserved2 348 349#elif defined(__GNU__) 350 351#define i_translator osd1.hurd1.h_i_translator 352#define i_frag osd2.hurd2.h_i_frag; 353#define i_fsize osd2.hurd2.h_i_fsize; 354#define i_uid_high osd2.hurd2.h_i_uid_high 355#define i_gid_high osd2.hurd2.h_i_gid_high 356#define i_author osd2.hurd2.h_i_author 357 358#elif defined(__masix__) 359 360#define i_reserved1 osd1.masix1.m_i_reserved1 361#define i_frag osd2.masix2.m_i_frag 362#define i_fsize osd2.masix2.m_i_fsize 363#define i_file_acl_high osd2.masix2.m_i_file_acl_high 364#define i_reserved2 osd2.masix2.m_i_reserved2 365 366#endif /* defined(__KERNEL__) || defined(__linux__) */ 367 368/* 369 * File system states 370 */ 371#define EXT4_VALID_FS 0x0001 /* Unmounted cleanly */ 372#define EXT4_ERROR_FS 0x0002 /* Errors detected */ 373#define EXT4_ORPHAN_FS 0x0004 /* Orphans being recovered */ 374 375/* 376 * Mount flags 377 */ 378#define EXT4_MOUNT_CHECK 0x00001 /* Do mount-time checks */ 379#define EXT4_MOUNT_OLDALLOC 0x00002 /* Don't use the new Orlov allocator */ 380#define EXT4_MOUNT_GRPID 0x00004 /* Create files with directory's group */ 381#define EXT4_MOUNT_DEBUG 0x00008 /* Some debugging messages */ 382#define EXT4_MOUNT_ERRORS_CONT 0x00010 /* Continue on errors */ 383#define EXT4_MOUNT_ERRORS_RO 0x00020 /* Remount fs ro on errors */ 384#define EXT4_MOUNT_ERRORS_PANIC 0x00040 /* Panic on errors */ 385#define EXT4_MOUNT_MINIX_DF 0x00080 /* Mimics the Minix statfs */ 386#define EXT4_MOUNT_NOLOAD 0x00100 /* Don't use existing journal*/ 387#define EXT4_MOUNT_ABORT 0x00200 /* Fatal error detected */ 388#define EXT4_MOUNT_DATA_FLAGS 0x00C00 /* Mode for data writes: */ 389#define EXT4_MOUNT_JOURNAL_DATA 0x00400 /* Write data to journal */ 390#define EXT4_MOUNT_ORDERED_DATA 0x00800 /* Flush data before commit */ 391#define EXT4_MOUNT_WRITEBACK_DATA 0x00C00 /* No data ordering */ 392#define EXT4_MOUNT_UPDATE_JOURNAL 0x01000 /* Update the journal format */ 393#define EXT4_MOUNT_NO_UID32 0x02000 /* Disable 32-bit UIDs */ 394#define EXT4_MOUNT_XATTR_USER 0x04000 /* Extended user attributes */ 395#define EXT4_MOUNT_POSIX_ACL 0x08000 /* POSIX Access Control Lists */ 396#define EXT4_MOUNT_RESERVATION 0x10000 /* Preallocation */ 397#define EXT4_MOUNT_BARRIER 0x20000 /* Use block barriers */ 398#define EXT4_MOUNT_NOBH 0x40000 /* No bufferheads */ 399#define EXT4_MOUNT_QUOTA 0x80000 /* Some quota option set */ 400#define EXT4_MOUNT_USRQUOTA 0x100000 /* "old" user quota */ 401#define EXT4_MOUNT_GRPQUOTA 0x200000 /* "old" group quota */ 402#define EXT4_MOUNT_EXTENTS 0x400000 /* Extents support */ 403 404/* Compatibility, for having both ext2_fs.h and ext4_fs.h included at once */ 405#ifndef _LINUX_EXT2_FS_H 406#define clear_opt(o, opt) o &= ~EXT4_MOUNT_##opt 407#define set_opt(o, opt) o |= EXT4_MOUNT_##opt 408#define test_opt(sb, opt) (EXT4_SB(sb)->s_mount_opt & \ 409 EXT4_MOUNT_##opt) 410#else 411#define EXT2_MOUNT_NOLOAD EXT4_MOUNT_NOLOAD 412#define EXT2_MOUNT_ABORT EXT4_MOUNT_ABORT 413#define EXT2_MOUNT_DATA_FLAGS EXT4_MOUNT_DATA_FLAGS 414#endif 415 416#define ext4_set_bit ext2_set_bit 417#define ext4_set_bit_atomic ext2_set_bit_atomic 418#define ext4_clear_bit ext2_clear_bit 419#define ext4_clear_bit_atomic ext2_clear_bit_atomic 420#define ext4_test_bit ext2_test_bit 421#define ext4_find_first_zero_bit ext2_find_first_zero_bit 422#define ext4_find_next_zero_bit ext2_find_next_zero_bit 423 424/* 425 * Maximal mount counts between two filesystem checks 426 */ 427#define EXT4_DFL_MAX_MNT_COUNT 20 /* Allow 20 mounts */ 428#define EXT4_DFL_CHECKINTERVAL 0 /* Don't use interval check */ 429 430/* 431 * Behaviour when detecting errors 432 */ 433#define EXT4_ERRORS_CONTINUE 1 /* Continue execution */ 434#define EXT4_ERRORS_RO 2 /* Remount fs read-only */ 435#define EXT4_ERRORS_PANIC 3 /* Panic */ 436#define EXT4_ERRORS_DEFAULT EXT4_ERRORS_CONTINUE 437 438/* 439 * Structure of the super block 440 */ 441struct ext4_super_block { 442/*00*/ __le32 s_inodes_count; /* Inodes count */ 443 __le32 s_blocks_count; /* Blocks count */ 444 __le32 s_r_blocks_count; /* Reserved blocks count */ 445 __le32 s_free_blocks_count; /* Free blocks count */ 446/*10*/ __le32 s_free_inodes_count; /* Free inodes count */ 447 __le32 s_first_data_block; /* First Data Block */ 448 __le32 s_log_block_size; /* Block size */ 449 __le32 s_log_frag_size; /* Fragment size */ 450/*20*/ __le32 s_blocks_per_group; /* # Blocks per group */ 451 __le32 s_frags_per_group; /* # Fragments per group */ 452 __le32 s_inodes_per_group; /* # Inodes per group */ 453 __le32 s_mtime; /* Mount time */ 454/*30*/ __le32 s_wtime; /* Write time */ 455 __le16 s_mnt_count; /* Mount count */ 456 __le16 s_max_mnt_count; /* Maximal mount count */ 457 __le16 s_magic; /* Magic signature */ 458 __le16 s_state; /* File system state */ 459 __le16 s_errors; /* Behaviour when detecting errors */ 460 __le16 s_minor_rev_level; /* minor revision level */ 461/*40*/ __le32 s_lastcheck; /* time of last check */ 462 __le32 s_checkinterval; /* max. time between checks */ 463 __le32 s_creator_os; /* OS */ 464 __le32 s_rev_level; /* Revision level */ 465/*50*/ __le16 s_def_resuid; /* Default uid for reserved blocks */ 466 __le16 s_def_resgid; /* Default gid for reserved blocks */ 467 /* 468 * These fields are for EXT4_DYNAMIC_REV superblocks only. 469 * 470 * Note: the difference between the compatible feature set and 471 * the incompatible feature set is that if there is a bit set 472 * in the incompatible feature set that the kernel doesn't 473 * know about, it should refuse to mount the filesystem. 474 * 475 * e2fsck's requirements are more strict; if it doesn't know 476 * about a feature in either the compatible or incompatible 477 * feature set, it must abort and not try to meddle with 478 * things it doesn't understand... 479 */ 480 __le32 s_first_ino; /* First non-reserved inode */ 481 __le16 s_inode_size; /* size of inode structure */ 482 __le16 s_block_group_nr; /* block group # of this superblock */ 483 __le32 s_feature_compat; /* compatible feature set */ 484/*60*/ __le32 s_feature_incompat; /* incompatible feature set */ 485 __le32 s_feature_ro_compat; /* readonly-compatible feature set */ 486/*68*/ __u8 s_uuid[16]; /* 128-bit uuid for volume */ 487/*78*/ char s_volume_name[16]; /* volume name */ 488/*88*/ char s_last_mounted[64]; /* directory where last mounted */ 489/*C8*/ __le32 s_algorithm_usage_bitmap; /* For compression */ 490 /* 491 * Performance hints. Directory preallocation should only 492 * happen if the EXT4_FEATURE_COMPAT_DIR_PREALLOC flag is on. 493 */ 494 __u8 s_prealloc_blocks; /* Nr of blocks to try to preallocate*/ 495 __u8 s_prealloc_dir_blocks; /* Nr to preallocate for dirs */ 496 __le16 s_reserved_gdt_blocks; /* Per group desc for online growth */ 497 /* 498 * Journaling support valid if EXT4_FEATURE_COMPAT_HAS_JOURNAL set. 499 */ 500/*D0*/ __u8 s_journal_uuid[16]; /* uuid of journal superblock */ 501/*E0*/ __le32 s_journal_inum; /* inode number of journal file */ 502 __le32 s_journal_dev; /* device number of journal file */ 503 __le32 s_last_orphan; /* start of list of inodes to delete */ 504 __le32 s_hash_seed[4]; /* HTREE hash seed */ 505 __u8 s_def_hash_version; /* Default hash version to use */ 506 __u8 s_reserved_char_pad; 507 __le16 s_desc_size; /* size of group descriptor */ 508/*100*/ __le32 s_default_mount_opts; 509 __le32 s_first_meta_bg; /* First metablock block group */ 510 __le32 s_mkfs_time; /* When the filesystem was created */ 511 __le32 s_jnl_blocks[17]; /* Backup of the journal inode */ 512 /* 64bit support valid if EXT4_FEATURE_COMPAT_64BIT */ 513/*150*/ __le32 s_blocks_count_hi; /* Blocks count */ 514 __le32 s_r_blocks_count_hi; /* Reserved blocks count */ 515 __le32 s_free_blocks_count_hi; /* Free blocks count */ 516 __u32 s_reserved[169]; /* Padding to the end of the block */ 517}; 518 519#ifdef __KERNEL__ 520static inline struct ext4_sb_info * EXT4_SB(struct super_block *sb) 521{ 522 return sb->s_fs_info; 523} 524static inline struct ext4_inode_info *EXT4_I(struct inode *inode) 525{ 526 return container_of(inode, struct ext4_inode_info, vfs_inode); 527} 528 529static inline int ext4_valid_inum(struct super_block *sb, unsigned long ino) 530{ 531 return ino == EXT4_ROOT_INO || 532 ino == EXT4_JOURNAL_INO || 533 ino == EXT4_RESIZE_INO || 534 (ino >= EXT4_FIRST_INO(sb) && 535 ino <= le32_to_cpu(EXT4_SB(sb)->s_es->s_inodes_count)); 536} 537#else 538/* Assume that user mode programs are passing in an ext4fs superblock, not 539 * a kernel struct super_block. This will allow us to call the feature-test 540 * macros from user land. */ 541#define EXT4_SB(sb) (sb) 542#endif 543 544#define NEXT_ORPHAN(inode) EXT4_I(inode)->i_dtime 545 546/* 547 * Codes for operating systems 548 */ 549#define EXT4_OS_LINUX 0 550#define EXT4_OS_HURD 1 551#define EXT4_OS_MASIX 2 552#define EXT4_OS_FREEBSD 3 553#define EXT4_OS_LITES 4 554 555/* 556 * Revision levels 557 */ 558#define EXT4_GOOD_OLD_REV 0 /* The good old (original) format */ 559#define EXT4_DYNAMIC_REV 1 /* V2 format w/ dynamic inode sizes */ 560 561#define EXT4_CURRENT_REV EXT4_GOOD_OLD_REV 562#define EXT4_MAX_SUPP_REV EXT4_DYNAMIC_REV 563 564#define EXT4_GOOD_OLD_INODE_SIZE 128 565 566/* 567 * Feature set definitions 568 */ 569 570#define EXT4_HAS_COMPAT_FEATURE(sb,mask) \ 571 ( EXT4_SB(sb)->s_es->s_feature_compat & cpu_to_le32(mask) ) 572#define EXT4_HAS_RO_COMPAT_FEATURE(sb,mask) \ 573 ( EXT4_SB(sb)->s_es->s_feature_ro_compat & cpu_to_le32(mask) ) 574#define EXT4_HAS_INCOMPAT_FEATURE(sb,mask) \ 575 ( EXT4_SB(sb)->s_es->s_feature_incompat & cpu_to_le32(mask) ) 576#define EXT4_SET_COMPAT_FEATURE(sb,mask) \ 577 EXT4_SB(sb)->s_es->s_feature_compat |= cpu_to_le32(mask) 578#define EXT4_SET_RO_COMPAT_FEATURE(sb,mask) \ 579 EXT4_SB(sb)->s_es->s_feature_ro_compat |= cpu_to_le32(mask) 580#define EXT4_SET_INCOMPAT_FEATURE(sb,mask) \ 581 EXT4_SB(sb)->s_es->s_feature_incompat |= cpu_to_le32(mask) 582#define EXT4_CLEAR_COMPAT_FEATURE(sb,mask) \ 583 EXT4_SB(sb)->s_es->s_feature_compat &= ~cpu_to_le32(mask) 584#define EXT4_CLEAR_RO_COMPAT_FEATURE(sb,mask) \ 585 EXT4_SB(sb)->s_es->s_feature_ro_compat &= ~cpu_to_le32(mask) 586#define EXT4_CLEAR_INCOMPAT_FEATURE(sb,mask) \ 587 EXT4_SB(sb)->s_es->s_feature_incompat &= ~cpu_to_le32(mask) 588 589#define EXT4_FEATURE_COMPAT_DIR_PREALLOC 0x0001 590#define EXT4_FEATURE_COMPAT_IMAGIC_INODES 0x0002 591#define EXT4_FEATURE_COMPAT_HAS_JOURNAL 0x0004 592#define EXT4_FEATURE_COMPAT_EXT_ATTR 0x0008 593#define EXT4_FEATURE_COMPAT_RESIZE_INODE 0x0010 594#define EXT4_FEATURE_COMPAT_DIR_INDEX 0x0020 595 596#define EXT4_FEATURE_RO_COMPAT_SPARSE_SUPER 0x0001 597#define EXT4_FEATURE_RO_COMPAT_LARGE_FILE 0x0002 598#define EXT4_FEATURE_RO_COMPAT_BTREE_DIR 0x0004 599 600#define EXT4_FEATURE_INCOMPAT_COMPRESSION 0x0001 601#define EXT4_FEATURE_INCOMPAT_FILETYPE 0x0002 602#define EXT4_FEATURE_INCOMPAT_RECOVER 0x0004 /* Needs recovery */ 603#define EXT4_FEATURE_INCOMPAT_JOURNAL_DEV 0x0008 /* Journal device */ 604#define EXT4_FEATURE_INCOMPAT_META_BG 0x0010 605#define EXT4_FEATURE_INCOMPAT_EXTENTS 0x0040 /* extents support */ 606#define EXT4_FEATURE_INCOMPAT_64BIT 0x0080 607 608#define EXT4_FEATURE_COMPAT_SUPP EXT2_FEATURE_COMPAT_EXT_ATTR 609#define EXT4_FEATURE_INCOMPAT_SUPP (EXT4_FEATURE_INCOMPAT_FILETYPE| \ 610 EXT4_FEATURE_INCOMPAT_RECOVER| \ 611 EXT4_FEATURE_INCOMPAT_META_BG| \ 612 EXT4_FEATURE_INCOMPAT_EXTENTS| \ 613 EXT4_FEATURE_INCOMPAT_64BIT) 614#define EXT4_FEATURE_RO_COMPAT_SUPP (EXT4_FEATURE_RO_COMPAT_SPARSE_SUPER| \ 615 EXT4_FEATURE_RO_COMPAT_LARGE_FILE| \ 616 EXT4_FEATURE_RO_COMPAT_BTREE_DIR) 617 618/* 619 * Default values for user and/or group using reserved blocks 620 */ 621#define EXT4_DEF_RESUID 0 622#define EXT4_DEF_RESGID 0 623 624/* 625 * Default mount options 626 */ 627#define EXT4_DEFM_DEBUG 0x0001 628#define EXT4_DEFM_BSDGROUPS 0x0002 629#define EXT4_DEFM_XATTR_USER 0x0004 630#define EXT4_DEFM_ACL 0x0008 631#define EXT4_DEFM_UID16 0x0010 632#define EXT4_DEFM_JMODE 0x0060 633#define EXT4_DEFM_JMODE_DATA 0x0020 634#define EXT4_DEFM_JMODE_ORDERED 0x0040 635#define EXT4_DEFM_JMODE_WBACK 0x0060 636 637/* 638 * Structure of a directory entry 639 */ 640#define EXT4_NAME_LEN 255 641 642struct ext4_dir_entry { 643 __le32 inode; /* Inode number */ 644 __le16 rec_len; /* Directory entry length */ 645 __le16 name_len; /* Name length */ 646 char name[EXT4_NAME_LEN]; /* File name */ 647}; 648 649/* 650 * The new version of the directory entry. Since EXT4 structures are 651 * stored in intel byte order, and the name_len field could never be 652 * bigger than 255 chars, it's safe to reclaim the extra byte for the 653 * file_type field. 654 */ 655struct ext4_dir_entry_2 { 656 __le32 inode; /* Inode number */ 657 __le16 rec_len; /* Directory entry length */ 658 __u8 name_len; /* Name length */ 659 __u8 file_type; 660 char name[EXT4_NAME_LEN]; /* File name */ 661}; 662 663/* 664 * Ext4 directory file types. Only the low 3 bits are used. The 665 * other bits are reserved for now. 666 */ 667#define EXT4_FT_UNKNOWN 0 668#define EXT4_FT_REG_FILE 1 669#define EXT4_FT_DIR 2 670#define EXT4_FT_CHRDEV 3 671#define EXT4_FT_BLKDEV 4 672#define EXT4_FT_FIFO 5 673#define EXT4_FT_SOCK 6 674#define EXT4_FT_SYMLINK 7 675 676#define EXT4_FT_MAX 8 677 678/* 679 * EXT4_DIR_PAD defines the directory entries boundaries 680 * 681 * NOTE: It must be a multiple of 4 682 */ 683#define EXT4_DIR_PAD 4 684#define EXT4_DIR_ROUND (EXT4_DIR_PAD - 1) 685#define EXT4_DIR_REC_LEN(name_len) (((name_len) + 8 + EXT4_DIR_ROUND) & \ 686 ~EXT4_DIR_ROUND) 687/* 688 * Hash Tree Directory indexing 689 * (c) Daniel Phillips, 2001 690 */ 691 692#ifdef CONFIG_EXT4_INDEX 693 #define is_dx(dir) (EXT4_HAS_COMPAT_FEATURE(dir->i_sb, \ 694 EXT4_FEATURE_COMPAT_DIR_INDEX) && \ 695 (EXT4_I(dir)->i_flags & EXT4_INDEX_FL)) 696#define EXT4_DIR_LINK_MAX(dir) (!is_dx(dir) && (dir)->i_nlink >= EXT4_LINK_MAX) 697#define EXT4_DIR_LINK_EMPTY(dir) ((dir)->i_nlink == 2 || (dir)->i_nlink == 1) 698#else 699 #define is_dx(dir) 0 700#define EXT4_DIR_LINK_MAX(dir) ((dir)->i_nlink >= EXT4_LINK_MAX) 701#define EXT4_DIR_LINK_EMPTY(dir) ((dir)->i_nlink == 2) 702#endif 703 704/* Legal values for the dx_root hash_version field: */ 705 706#define DX_HASH_LEGACY 0 707#define DX_HASH_HALF_MD4 1 708#define DX_HASH_TEA 2 709 710#ifdef __KERNEL__ 711 712/* hash info structure used by the directory hash */ 713struct dx_hash_info 714{ 715 u32 hash; 716 u32 minor_hash; 717 int hash_version; 718 u32 *seed; 719}; 720 721#define EXT4_HTREE_EOF 0x7fffffff 722 723/* 724 * Control parameters used by ext4_htree_next_block 725 */ 726#define HASH_NB_ALWAYS 1 727 728 729/* 730 * Describe an inode's exact location on disk and in memory 731 */ 732struct ext4_iloc 733{ 734 struct buffer_head *bh; 735 unsigned long offset; 736 unsigned long block_group; 737}; 738 739static inline struct ext4_inode *ext4_raw_inode(struct ext4_iloc *iloc) 740{ 741 return (struct ext4_inode *) (iloc->bh->b_data + iloc->offset); 742} 743 744/* 745 * This structure is stuffed into the struct file's private_data field 746 * for directories. It is where we put information so that we can do 747 * readdir operations in hash tree order. 748 */ 749struct dir_private_info { 750 struct rb_root root; 751 struct rb_node *curr_node; 752 struct fname *extra_fname; 753 loff_t last_pos; 754 __u32 curr_hash; 755 __u32 curr_minor_hash; 756 __u32 next_hash; 757}; 758 759/* calculate the first block number of the group */ 760static inline ext4_fsblk_t 761ext4_group_first_block_no(struct super_block *sb, unsigned long group_no) 762{ 763 return group_no * (ext4_fsblk_t)EXT4_BLOCKS_PER_GROUP(sb) + 764 le32_to_cpu(EXT4_SB(sb)->s_es->s_first_data_block); 765} 766 767/* 768 * Special error return code only used by dx_probe() and its callers. 769 */ 770#define ERR_BAD_DX_DIR -75000 771 772void ext4_get_group_no_and_offset(struct super_block *sb, ext4_fsblk_t blocknr, 773 unsigned long *blockgrpp, ext4_grpblk_t *offsetp); 774 775/* 776 * Function prototypes 777 */ 778 779/* 780 * Ok, these declarations are also in <linux/kernel.h> but none of the 781 * ext4 source programs needs to include it so they are duplicated here. 782 */ 783# define NORET_TYPE /**/ 784# define ATTRIB_NORET __attribute__((noreturn)) 785# define NORET_AND noreturn, 786 787/* balloc.c */ 788extern unsigned int ext4_block_group(struct super_block *sb, 789 ext4_fsblk_t blocknr); 790extern ext4_grpblk_t ext4_block_group_offset(struct super_block *sb, 791 ext4_fsblk_t blocknr); 792extern int ext4_bg_has_super(struct super_block *sb, int group); 793extern unsigned long ext4_bg_num_gdb(struct super_block *sb, int group); 794extern ext4_fsblk_t ext4_new_block (handle_t *handle, struct inode *inode, 795 ext4_fsblk_t goal, int *errp); 796extern ext4_fsblk_t ext4_new_blocks (handle_t *handle, struct inode *inode, 797 ext4_fsblk_t goal, unsigned long *count, int *errp); 798extern void ext4_free_blocks (handle_t *handle, struct inode *inode, 799 ext4_fsblk_t block, unsigned long count); 800extern void ext4_free_blocks_sb (handle_t *handle, struct super_block *sb, 801 ext4_fsblk_t block, unsigned long count, 802 unsigned long *pdquot_freed_blocks); 803extern ext4_fsblk_t ext4_count_free_blocks (struct super_block *); 804extern void ext4_check_blocks_bitmap (struct super_block *); 805extern struct ext4_group_desc * ext4_get_group_desc(struct super_block * sb, 806 unsigned int block_group, 807 struct buffer_head ** bh); 808extern int ext4_should_retry_alloc(struct super_block *sb, int *retries); 809extern void ext4_init_block_alloc_info(struct inode *); 810extern void ext4_rsv_window_add(struct super_block *sb, struct ext4_reserve_window_node *rsv); 811 812/* dir.c */ 813extern int ext4_check_dir_entry(const char *, struct inode *, 814 struct ext4_dir_entry_2 *, 815 struct buffer_head *, unsigned long); 816extern int ext4_htree_store_dirent(struct file *dir_file, __u32 hash, 817 __u32 minor_hash, 818 struct ext4_dir_entry_2 *dirent); 819extern void ext4_htree_free_dir_info(struct dir_private_info *p); 820 821/* fsync.c */ 822extern int ext4_sync_file (struct file *, struct dentry *, int); 823 824/* hash.c */ 825extern int ext4fs_dirhash(const char *name, int len, struct 826 dx_hash_info *hinfo); 827 828/* ialloc.c */ 829extern struct inode * ext4_new_inode (handle_t *, struct inode *, int); 830extern void ext4_free_inode (handle_t *, struct inode *); 831extern struct inode * ext4_orphan_get (struct super_block *, unsigned long); 832extern unsigned long ext4_count_free_inodes (struct super_block *); 833extern unsigned long ext4_count_dirs (struct super_block *); 834extern void ext4_check_inodes_bitmap (struct super_block *); 835extern unsigned long ext4_count_free (struct buffer_head *, unsigned); 836 837 838/* inode.c */ 839int ext4_forget(handle_t *handle, int is_metadata, struct inode *inode, 840 struct buffer_head *bh, ext4_fsblk_t blocknr); 841struct buffer_head * ext4_getblk (handle_t *, struct inode *, long, int, int *); 842struct buffer_head * ext4_bread (handle_t *, struct inode *, int, int, int *); 843int ext4_get_blocks_handle(handle_t *handle, struct inode *inode, 844 sector_t iblock, unsigned long maxblocks, struct buffer_head *bh_result, 845 int create, int extend_disksize); 846 847extern void ext4_read_inode (struct inode *); 848extern int ext4_write_inode (struct inode *, int); 849extern int ext4_setattr (struct dentry *, struct iattr *); 850extern void ext4_delete_inode (struct inode *); 851extern int ext4_sync_inode (handle_t *, struct inode *); 852extern void ext4_discard_reservation (struct inode *); 853extern void ext4_dirty_inode(struct inode *); 854extern int ext4_change_inode_journal_flag(struct inode *, int); 855extern int ext4_get_inode_loc(struct inode *, struct ext4_iloc *); 856extern void ext4_truncate (struct inode *); 857extern void ext4_set_inode_flags(struct inode *); 858extern void ext4_set_aops(struct inode *inode); 859extern int ext4_writepage_trans_blocks(struct inode *); 860extern int ext4_block_truncate_page(handle_t *handle, struct page *page, 861 struct address_space *mapping, loff_t from); 862 863/* ioctl.c */ 864extern int ext4_ioctl (struct inode *, struct file *, unsigned int, 865 unsigned long); 866extern long ext4_compat_ioctl (struct file *, unsigned int, unsigned long); 867 868/* namei.c */ 869extern int ext4_orphan_add(handle_t *, struct inode *); 870extern int ext4_orphan_del(handle_t *, struct inode *); 871extern int ext4_htree_fill_tree(struct file *dir_file, __u32 start_hash, 872 __u32 start_minor_hash, __u32 *next_hash); 873 874/* resize.c */ 875extern int ext4_group_add(struct super_block *sb, 876 struct ext4_new_group_data *input); 877extern int ext4_group_extend(struct super_block *sb, 878 struct ext4_super_block *es, 879 ext4_fsblk_t n_blocks_count); 880 881/* super.c */ 882extern void ext4_error (struct super_block *, const char *, const char *, ...) 883 __attribute__ ((format (printf, 3, 4))); 884extern void __ext4_std_error (struct super_block *, const char *, int); 885extern void ext4_abort (struct super_block *, const char *, const char *, ...) 886 __attribute__ ((format (printf, 3, 4))); 887extern void ext4_warning (struct super_block *, const char *, const char *, ...) 888 __attribute__ ((format (printf, 3, 4))); 889extern void ext4_update_dynamic_rev (struct super_block *sb); 890extern ext4_fsblk_t ext4_block_bitmap(struct super_block *sb, 891 struct ext4_group_desc *bg); 892extern ext4_fsblk_t ext4_inode_bitmap(struct super_block *sb, 893 struct ext4_group_desc *bg); 894extern ext4_fsblk_t ext4_inode_table(struct super_block *sb, 895 struct ext4_group_desc *bg); 896extern void ext4_block_bitmap_set(struct super_block *sb, 897 struct ext4_group_desc *bg, ext4_fsblk_t blk); 898extern void ext4_inode_bitmap_set(struct super_block *sb, 899 struct ext4_group_desc *bg, ext4_fsblk_t blk); 900extern void ext4_inode_table_set(struct super_block *sb, 901 struct ext4_group_desc *bg, ext4_fsblk_t blk); 902 903static inline ext4_fsblk_t ext4_blocks_count(struct ext4_super_block *es) 904{ 905 return ((ext4_fsblk_t)le32_to_cpu(es->s_blocks_count_hi) << 32) | 906 le32_to_cpu(es->s_blocks_count); 907} 908 909static inline ext4_fsblk_t ext4_r_blocks_count(struct ext4_super_block *es) 910{ 911 return ((ext4_fsblk_t)le32_to_cpu(es->s_r_blocks_count_hi) << 32) | 912 le32_to_cpu(es->s_r_blocks_count); 913} 914 915static inline ext4_fsblk_t ext4_free_blocks_count(struct ext4_super_block *es) 916{ 917 return ((ext4_fsblk_t)le32_to_cpu(es->s_free_blocks_count_hi) << 32) | 918 le32_to_cpu(es->s_free_blocks_count); 919} 920 921static inline void ext4_blocks_count_set(struct ext4_super_block *es, 922 ext4_fsblk_t blk) 923{ 924 es->s_blocks_count = cpu_to_le32((u32)blk); 925 es->s_blocks_count_hi = cpu_to_le32(blk >> 32); 926} 927 928static inline void ext4_free_blocks_count_set(struct ext4_super_block *es, 929 ext4_fsblk_t blk) 930{ 931 es->s_free_blocks_count = cpu_to_le32((u32)blk); 932 es->s_free_blocks_count_hi = cpu_to_le32(blk >> 32); 933} 934 935static inline void ext4_r_blocks_count_set(struct ext4_super_block *es, 936 ext4_fsblk_t blk) 937{ 938 es->s_r_blocks_count = cpu_to_le32((u32)blk); 939 es->s_r_blocks_count_hi = cpu_to_le32(blk >> 32); 940} 941 942 943 944#define ext4_std_error(sb, errno) \ 945do { \ 946 if ((errno)) \ 947 __ext4_std_error((sb), __FUNCTION__, (errno)); \ 948} while (0) 949 950/* 951 * Inodes and files operations 952 */ 953 954/* dir.c */ 955extern const struct file_operations ext4_dir_operations; 956 957/* file.c */ 958extern const struct inode_operations ext4_file_inode_operations; 959extern const struct file_operations ext4_file_operations; 960 961/* namei.c */ 962extern const struct inode_operations ext4_dir_inode_operations; 963extern const struct inode_operations ext4_special_inode_operations; 964 965/* symlink.c */ 966extern const struct inode_operations ext4_symlink_inode_operations; 967extern const struct inode_operations ext4_fast_symlink_inode_operations; 968 969/* extents.c */ 970extern int ext4_ext_tree_init(handle_t *handle, struct inode *); 971extern int ext4_ext_writepage_trans_blocks(struct inode *, int); 972extern int ext4_ext_get_blocks(handle_t *handle, struct inode *inode, 973 ext4_fsblk_t iblock, 974 unsigned long max_blocks, struct buffer_head *bh_result, 975 int create, int extend_disksize); 976extern void ext4_ext_truncate(struct inode *, struct page *); 977extern void ext4_ext_init(struct super_block *); 978extern void ext4_ext_release(struct super_block *); 979static inline int 980ext4_get_blocks_wrap(handle_t *handle, struct inode *inode, sector_t block, 981 unsigned long max_blocks, struct buffer_head *bh, 982 int create, int extend_disksize) 983{ 984 if (EXT4_I(inode)->i_flags & EXT4_EXTENTS_FL) 985 return ext4_ext_get_blocks(handle, inode, block, max_blocks, 986 bh, create, extend_disksize); 987 return ext4_get_blocks_handle(handle, inode, block, max_blocks, bh, 988 create, extend_disksize); 989} 990 991 992#endif /* __KERNEL__ */ 993 994#endif /* _LINUX_EXT4_FS_H */