4 * Copyright (C) 1993, 1994, 1995, 1996 Theodore Ts'o.
7 * This file may be redistributed under the terms of the GNU Library
8 * General Public License, version 2.
12 #ifndef _EXT2FS_EXT2FS_H
13 #define _EXT2FS_EXT2FS_H
16 #define EXT2FS_ATTR(x) __attribute__(x)
18 #define EXT2FS_ATTR(x)
22 #define EXT2FS_NO_TDB_UNUSED
24 #define EXT2FS_NO_TDB_UNUSED EXT2FS_ATTR((unused))
32 * Non-GNU C compilers won't necessarily understand inline
34 #if (!defined(__GNUC__) && !defined(__WATCOMC__))
35 #define NO_INLINE_FUNCS
39 * Where the master copy of the superblock is located, and how big
40 * superblocks are supposed to be. We define SUPERBLOCK_SIZE because
41 * the size of the superblock structure is not necessarily trustworthy
42 * (some versions have the padding set up so that the superblock is
45 #define SUPERBLOCK_OFFSET 1024
46 #define SUPERBLOCK_SIZE 1024
48 #define UUID_STR_SIZE 37
51 * The last ext2fs revision level that this version of the library is
54 #define EXT2_LIB_CURRENT_REV EXT2_DYNAMIC_REV
56 #ifdef HAVE_SYS_TYPES_H
57 #include <sys/types.h>
66 #if EXT2_FLAT_INCLUDES
69 #include "ext3_extents.h"
71 #include <ext2fs/ext2_types.h>
72 #include <ext2fs/ext2_fs.h>
73 #include <ext2fs/ext3_extents.h>
74 #endif /* EXT2_FLAT_INCLUDES */
76 typedef __u32 __bitwise ext2_ino_t;
77 typedef __u32 __bitwise blk_t;
78 typedef __u64 __bitwise blk64_t;
79 typedef __u32 __bitwise dgrp_t;
80 typedef __s32 __bitwise ext2_off_t;
81 typedef __s64 __bitwise ext2_off64_t;
82 typedef __s64 __bitwise e2_blkcnt_t;
83 typedef __u32 __bitwise ext2_dirhash_t;
85 #if EXT2_FLAT_INCLUDES
89 #include "ext2_ext_attr.h"
91 #include <et/com_err.h>
92 #include <ext2fs/ext2_io.h>
93 #include <ext2fs/ext2_err.h>
94 #include <ext2fs/ext2_ext_attr.h>
100 * Portability help for Microsoft Visual C++
103 #define EXT2_QSORT_TYPE int __cdecl
105 #define EXT2_QSORT_TYPE int
108 typedef struct struct_ext2_filsys *ext2_filsys;
110 #define EXT2FS_MARK_ERROR 0
111 #define EXT2FS_UNMARK_ERROR 1
112 #define EXT2FS_TEST_ERROR 2
114 struct ext2fs_struct_generic_bitmap_base {
119 typedef struct ext2fs_struct_generic_bitmap_base *ext2fs_generic_bitmap;
120 typedef struct ext2fs_struct_generic_bitmap_base *ext2fs_inode_bitmap;
121 typedef struct ext2fs_struct_generic_bitmap_base *ext2fs_block_bitmap;
123 #define EXT2_FIRST_INODE(s) EXT2_FIRST_INO(s)
127 * Badblocks list definitions
130 typedef struct ext2_struct_u32_list *ext2_badblocks_list;
131 typedef struct ext2_struct_u32_iterate *ext2_badblocks_iterate;
133 typedef struct ext2_struct_u32_list *ext2_u32_list;
134 typedef struct ext2_struct_u32_iterate *ext2_u32_iterate;
137 typedef struct ext2_struct_u32_list *badblocks_list;
138 typedef struct ext2_struct_u32_iterate *badblocks_iterate;
140 #define BADBLOCKS_FLAG_DIRTY 1
143 * ext2_dblist structure and abstractions (see dblist.c)
145 struct ext2_db_entry2 {
148 e2_blkcnt_t blockcnt;
151 /* Ye Olde 32-bit version */
152 struct ext2_db_entry {
158 typedef struct ext2_struct_dblist *ext2_dblist;
160 #define DBLIST_ABORT 1
163 * ext2_fileio definitions
166 #define EXT2_FILE_WRITE 0x0001
167 #define EXT2_FILE_CREATE 0x0002
169 #define EXT2_FILE_MASK 0x00FF
171 #define EXT2_FILE_BUF_DIRTY 0x4000
172 #define EXT2_FILE_BUF_VALID 0x2000
174 typedef struct ext2_file *ext2_file_t;
176 #define EXT2_SEEK_SET 0
177 #define EXT2_SEEK_CUR 1
178 #define EXT2_SEEK_END 2
181 * Flags for the ext2_filsys structure and for ext2fs_open()
183 #define EXT2_FLAG_RW 0x01
184 #define EXT2_FLAG_CHANGED 0x02
185 #define EXT2_FLAG_DIRTY 0x04
186 #define EXT2_FLAG_VALID 0x08
187 #define EXT2_FLAG_IB_DIRTY 0x10
188 #define EXT2_FLAG_BB_DIRTY 0x20
189 #define EXT2_FLAG_SWAP_BYTES 0x40
190 #define EXT2_FLAG_SWAP_BYTES_READ 0x80
191 #define EXT2_FLAG_SWAP_BYTES_WRITE 0x100
192 #define EXT2_FLAG_MASTER_SB_ONLY 0x200
193 #define EXT2_FLAG_FORCE 0x400
194 #define EXT2_FLAG_SUPER_ONLY 0x800
195 #define EXT2_FLAG_JOURNAL_DEV_OK 0x1000
196 #define EXT2_FLAG_IMAGE_FILE 0x2000
197 #define EXT2_FLAG_EXCLUSIVE 0x4000
198 #define EXT2_FLAG_SOFTSUPP_FEATURES 0x8000
199 #define EXT2_FLAG_NOFREE_ON_ERROR 0x10000
200 #define EXT2_FLAG_64BITS 0x20000
201 #define EXT2_FLAG_PRINT_PROGRESS 0x40000
202 #define EXT2_FLAG_DIRECT_IO 0x80000
203 #define EXT2_FLAG_SKIP_MMP 0x100000
204 #define EXT2_FLAG_IGNORE_CSUM_ERRORS 0x200000
205 #define EXT2_FLAG_SHARE_DUP 0x400000
206 #define EXT2_FLAG_IGNORE_SB_ERRORS 0x800000
207 #define EXT2_FLAG_BBITMAP_TAIL_PROBLEM 0x1000000
208 #define EXT2_FLAG_IBITMAP_TAIL_PROBLEM 0x2000000
209 #define EXT2_FLAG_THREADS 0x4000000
212 * Special flag in the ext2 inode i_flag field that means that this is
213 * a new inode. (So that ext2_write_inode() can clear extra fields.)
215 #define EXT2_NEW_INODE_FL 0x80000000
218 * Flags for mkjournal
220 #define EXT2_MKJOURNAL_V1_SUPER 0x0000001 /* create V1 superblock (deprecated) */
221 #define EXT2_MKJOURNAL_LAZYINIT 0x0000002 /* don't zero journal inode before use*/
222 #define EXT2_MKJOURNAL_NO_MNT_CHECK 0x0000004 /* don't check mount status */
225 * Normal journal area size to fast commit area size ratio. This is used to
226 * set default size of fast commit area.
228 #define EXT2_JOURNAL_TO_FC_BLKS_RATIO 64
230 struct blk_alloc_ctx;
231 struct opaque_ext2_group_desc;
233 struct struct_ext2_filsys {
238 struct ext2_super_block * super;
239 unsigned int blocksize;
241 dgrp_t group_desc_count;
242 unsigned long desc_blocks;
243 struct opaque_ext2_group_desc * group_desc;
244 unsigned int inode_blocks_per_group;
245 ext2fs_inode_bitmap inode_map;
246 ext2fs_block_bitmap block_map;
247 /* XXX FIXME-64: not 64-bit safe, but not used? */
248 errcode_t (*get_blocks)(ext2_filsys fs, ext2_ino_t ino, blk_t *blocks);
249 errcode_t (*check_directory)(ext2_filsys fs, ext2_ino_t ino);
250 errcode_t (*write_bitmaps)(ext2_filsys fs);
251 errcode_t (*read_inode)(ext2_filsys fs, ext2_ino_t ino,
252 struct ext2_inode *inode);
253 errcode_t (*write_inode)(ext2_filsys fs, ext2_ino_t ino,
254 struct ext2_inode *inode);
255 ext2_badblocks_list badblocks;
257 __u32 stride; /* for mke2fs */
258 struct ext2_super_block * orig_super;
259 struct ext2_image_hdr * image_header;
262 int cluster_ratio_bits;
263 __u16 default_bitmap_type;
264 __u16 fs_num_threads;
266 * Reserved for future expansion
271 * Reserved for the use of the calling application.
278 struct ext2_inode_cache *icache;
282 * More callback functions
284 errcode_t (*get_alloc_block)(ext2_filsys fs, blk64_t goal,
286 errcode_t (*get_alloc_block2)(ext2_filsys fs, blk64_t goal,
287 blk64_t *ret, struct blk_alloc_ctx *ctx);
288 void (*block_alloc_stats)(ext2_filsys fs, blk64_t blk, int inuse);
291 * Buffers for Multiple mount protection(MMP) block.
298 * Time at which e2fsck last updated the MMP block.
300 long mmp_last_written;
302 /* progress operation functions */
303 struct ext2fs_progress_ops *progress_ops;
305 /* Precomputed FS UUID checksum for seeding other checksums */
308 io_channel journal_io;
311 /* New block range allocation hooks */
312 errcode_t (*new_range)(ext2_filsys fs, int flags, blk64_t goal,
313 blk64_t len, blk64_t *pblk, blk64_t *plen);
314 void (*block_alloc_stats_range)(ext2_filsys fs, blk64_t blk, blk_t num,
317 /* hashmap for SHA of data blocks */
318 struct ext2fs_hashmap* block_sha_map;
320 const struct ext2fs_nls_table *encoding;
323 #if EXT2_FLAT_INCLUDES
324 #include "e2_bitops.h"
326 #include <ext2fs/bitops.h>
330 * 64-bit bitmap backend types
332 #define EXT2FS_BMAP64_BITARRAY 1
333 #define EXT2FS_BMAP64_RBTREE 2
334 #define EXT2FS_BMAP64_AUTODIR 3
337 * Return flags for the block iterator functions
339 #define BLOCK_CHANGED 1
340 #define BLOCK_ABORT 2
341 #define BLOCK_ERROR 4
342 #define BLOCK_INLINE_DATA_CHANGED 8
345 * Block interate flags
347 * BLOCK_FLAG_APPEND, or BLOCK_FLAG_HOLE, indicates that the interator
348 * function should be called on blocks where the block number is zero.
349 * This is used by ext2fs_expand_dir() to be able to add a new block
350 * to an inode. It can also be used for programs that want to be able
351 * to deal with files that contain "holes".
353 * BLOCK_FLAG_DEPTH_TRAVERSE indicates that the iterator function for
354 * the indirect, doubly indirect, etc. blocks should be called after
355 * all of the blocks contained in the indirect blocks are processed.
356 * This is useful if you are going to be deallocating blocks from an
359 * BLOCK_FLAG_DATA_ONLY indicates that the iterator function should be
360 * called for data blocks only.
362 * BLOCK_FLAG_READ_ONLY is a promise by the caller that it will not
363 * modify returned block number.
365 * BLOCK_FLAG_NO_LARGE is for internal use only. It informs
366 * ext2fs_block_iterate2 that large files won't be accepted.
368 #define BLOCK_FLAG_APPEND 1
369 #define BLOCK_FLAG_HOLE 1
370 #define BLOCK_FLAG_DEPTH_TRAVERSE 2
371 #define BLOCK_FLAG_DATA_ONLY 4
372 #define BLOCK_FLAG_READ_ONLY 8
374 #define BLOCK_FLAG_NO_LARGE 0x1000
377 * Magic "block count" return values for the block iterator function.
379 #define BLOCK_COUNT_IND (-1)
380 #define BLOCK_COUNT_DIND (-2)
381 #define BLOCK_COUNT_TIND (-3)
382 #define BLOCK_COUNT_TRANSLATOR (-4)
384 #define BLOCK_ALLOC_UNKNOWN 0
385 #define BLOCK_ALLOC_DATA 1
386 #define BLOCK_ALLOC_METADATA 2
388 struct blk_alloc_ctx {
390 struct ext2_inode *inode;
397 * Flags for ext2fs_move_blocks
399 #define EXT2_BMOVE_GET_DBLIST 0x0001
400 #define EXT2_BMOVE_DEBUG 0x0002
404 * Generic (non-filesystem layout specific) extents structure
407 #define EXT2_EXTENT_FLAGS_LEAF 0x0001
408 #define EXT2_EXTENT_FLAGS_UNINIT 0x0002
409 #define EXT2_EXTENT_FLAGS_SECOND_VISIT 0x0004
411 struct ext2fs_extent {
412 blk64_t e_pblk; /* first physical block */
413 blk64_t e_lblk; /* first logical block extent covers */
414 __u32 e_len; /* number of blocks covered by extent */
415 __u32 e_flags; /* extent flags */
418 typedef struct ext2_extent_handle *ext2_extent_handle_t;
419 typedef struct ext2_extent_path *ext2_extent_path_t;
422 * Flags used by ext2fs_extent_get()
424 #define EXT2_EXTENT_CURRENT 0x0000
425 #define EXT2_EXTENT_MOVE_MASK 0x000F
426 #define EXT2_EXTENT_ROOT 0x0001
427 #define EXT2_EXTENT_LAST_LEAF 0x0002
428 #define EXT2_EXTENT_FIRST_SIB 0x0003
429 #define EXT2_EXTENT_LAST_SIB 0x0004
430 #define EXT2_EXTENT_NEXT_SIB 0x0005
431 #define EXT2_EXTENT_PREV_SIB 0x0006
432 #define EXT2_EXTENT_NEXT_LEAF 0x0007
433 #define EXT2_EXTENT_PREV_LEAF 0x0008
434 #define EXT2_EXTENT_NEXT 0x0009
435 #define EXT2_EXTENT_PREV 0x000A
436 #define EXT2_EXTENT_UP 0x000B
437 #define EXT2_EXTENT_DOWN 0x000C
438 #define EXT2_EXTENT_DOWN_AND_LAST 0x000D
441 * Flags used by ext2fs_extent_insert()
443 #define EXT2_EXTENT_INSERT_AFTER 0x0001 /* insert after handle loc'n */
444 #define EXT2_EXTENT_INSERT_NOSPLIT 0x0002 /* insert may not cause split */
447 * Flags used by ext2fs_extent_delete()
449 #define EXT2_EXTENT_DELETE_KEEP_EMPTY 0x001 /* keep node if last extent gone */
452 * Flags used by ext2fs_extent_set_bmap()
454 #define EXT2_EXTENT_SET_BMAP_UNINIT 0x0001
457 * Data structure returned by ext2fs_extent_get_info()
459 struct ext2_extent_info {
469 __u32 max_uninit_len;
473 * Flags for directory block reading and writing functions
475 #define EXT2_DIRBLOCK_V2_STRUCT 0x0001
478 * Return flags for the directory iterator functions
480 #define DIRENT_CHANGED 1
481 #define DIRENT_ABORT 2
482 #define DIRENT_ERROR 3
485 * Directory iterator flags
488 #define DIRENT_FLAG_INCLUDE_EMPTY 1
489 #define DIRENT_FLAG_INCLUDE_REMOVED 2
490 #define DIRENT_FLAG_INCLUDE_CSUM 4
491 #define DIRENT_FLAG_INCLUDE_INLINE_DATA 8
493 #define DIRENT_DOT_FILE 1
494 #define DIRENT_DOT_DOT_FILE 2
495 #define DIRENT_OTHER_FILE 3
496 #define DIRENT_DELETED_FILE 4
497 #define DIRENT_CHECKSUM 5
500 * Inode scan definitions
502 typedef struct ext2_struct_inode_scan *ext2_inode_scan;
507 #define EXT2_SF_CHK_BADBLOCKS 0x0001
508 #define EXT2_SF_BAD_INODE_BLK 0x0002
509 #define EXT2_SF_BAD_EXTRA_BYTES 0x0004
510 #define EXT2_SF_SKIP_MISSING_ITABLE 0x0008
511 #define EXT2_SF_DO_LAZY 0x0010
512 #define EXT2_SF_WARN_GARBAGE_INODES 0x0020
515 * ext2fs_check_if_mounted flags
517 #define EXT2_MF_MOUNTED 1
518 #define EXT2_MF_ISROOT 2
519 #define EXT2_MF_READONLY 4
520 #define EXT2_MF_SWAP 8
521 #define EXT2_MF_BUSY 16
524 * Ext2/linux mode flags. We define them here so that we don't need
525 * to depend on the OS's sys/stat.h, since we may be compiling on a
528 #define LINUX_S_IFMT 00170000
529 #define LINUX_S_IFSOCK 0140000
530 #define LINUX_S_IFLNK 0120000
531 #define LINUX_S_IFREG 0100000
532 #define LINUX_S_IFBLK 0060000
533 #define LINUX_S_IFDIR 0040000
534 #define LINUX_S_IFCHR 0020000
535 #define LINUX_S_IFIFO 0010000
536 #define LINUX_S_ISUID 0004000
537 #define LINUX_S_ISGID 0002000
538 #define LINUX_S_ISVTX 0001000
540 #define LINUX_S_IRWXU 00700
541 #define LINUX_S_IRUSR 00400
542 #define LINUX_S_IWUSR 00200
543 #define LINUX_S_IXUSR 00100
545 #define LINUX_S_IRWXG 00070
546 #define LINUX_S_IRGRP 00040
547 #define LINUX_S_IWGRP 00020
548 #define LINUX_S_IXGRP 00010
550 #define LINUX_S_IRWXO 00007
551 #define LINUX_S_IROTH 00004
552 #define LINUX_S_IWOTH 00002
553 #define LINUX_S_IXOTH 00001
555 #define LINUX_S_ISLNK(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFLNK)
556 #define LINUX_S_ISREG(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFREG)
557 #define LINUX_S_ISDIR(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFDIR)
558 #define LINUX_S_ISCHR(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFCHR)
559 #define LINUX_S_ISBLK(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFBLK)
560 #define LINUX_S_ISFIFO(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFIFO)
561 #define LINUX_S_ISSOCK(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFSOCK)
564 * ext2 size of an inode
566 #define EXT2_I_SIZE(i) ((i)->i_size | ((__u64) (i)->i_size_high << 32))
569 * ext2_icount_t abstraction
571 #define EXT2_ICOUNT_OPT_INCREMENT 0x01
572 #define EXT2_ICOUNT_OPT_FULLMAP 0x02
574 typedef struct ext2_icount *ext2_icount_t;
577 * Flags for ext2fs_bmap
579 #define BMAP_ALLOC 0x0001
580 #define BMAP_SET 0x0002
581 #define BMAP_UNINIT 0x0004
582 #define BMAP_ZERO 0x0008
585 * Returned flags from ext2fs_bmap
587 #define BMAP_RET_UNINIT 0x0001
590 * Flags for ext2fs_read_inode2
592 #define READ_INODE_NOCSUM 0x0001
595 * Flags for ext2fs_write_inode2
597 #define WRITE_INODE_NOCSUM 0x0001
600 * Flags for imager.c functions
602 #define IMAGER_FLAG_INODEMAP 1
603 #define IMAGER_FLAG_SPARSEWRITE 2
606 * For checking structure magic numbers...
609 #define EXT2_CHECK_MAGIC(struct, code) \
610 if ((struct)->magic != (code)) return (code)
613 * Flags for returning status of ext2fs_expand_extra_isize()
615 #define EXT2_EXPAND_EISIZE_UNSAFE 0x0001
616 #define EXT2_EXPAND_EISIZE_NEW_BLOCK 0x0002
617 #define EXT2_EXPAND_EISIZE_NOSPC 0x0004
620 * Features supported by this version of the library
622 #define EXT2_LIB_FEATURE_COMPAT_SUPP (EXT2_FEATURE_COMPAT_DIR_PREALLOC|\
623 EXT2_FEATURE_COMPAT_IMAGIC_INODES|\
624 EXT3_FEATURE_COMPAT_HAS_JOURNAL|\
625 EXT2_FEATURE_COMPAT_RESIZE_INODE|\
626 EXT2_FEATURE_COMPAT_DIR_INDEX|\
627 EXT2_FEATURE_COMPAT_EXT_ATTR|\
628 EXT4_FEATURE_COMPAT_SPARSE_SUPER2|\
629 EXT4_FEATURE_COMPAT_FAST_COMMIT|\
630 EXT4_FEATURE_COMPAT_STABLE_INODES)
633 #define EXT4_LIB_INCOMPAT_MMP EXT4_FEATURE_INCOMPAT_MMP
635 #define EXT4_LIB_INCOMPAT_MMP (0)
638 #define EXT2_LIB_FEATURE_INCOMPAT_SUPP (EXT2_FEATURE_INCOMPAT_FILETYPE|\
639 EXT3_FEATURE_INCOMPAT_JOURNAL_DEV|\
640 EXT2_FEATURE_INCOMPAT_META_BG|\
641 EXT3_FEATURE_INCOMPAT_RECOVER|\
642 EXT3_FEATURE_INCOMPAT_EXTENTS|\
643 EXT4_FEATURE_INCOMPAT_FLEX_BG|\
644 EXT4_FEATURE_INCOMPAT_EA_INODE|\
645 EXT4_FEATURE_INCOMPAT_DIRDATA|\
646 EXT4_LIB_INCOMPAT_MMP|\
647 EXT4_FEATURE_INCOMPAT_64BIT|\
648 EXT4_FEATURE_INCOMPAT_INLINE_DATA|\
649 EXT4_FEATURE_INCOMPAT_ENCRYPT|\
650 EXT4_FEATURE_INCOMPAT_CASEFOLD|\
651 EXT4_FEATURE_INCOMPAT_CSUM_SEED|\
652 EXT4_FEATURE_INCOMPAT_LARGEDIR)
654 #define EXT2_LIB_FEATURE_RO_COMPAT_SUPP (EXT2_FEATURE_RO_COMPAT_SPARSE_SUPER|\
655 EXT4_FEATURE_RO_COMPAT_HUGE_FILE|\
656 EXT2_FEATURE_RO_COMPAT_LARGE_FILE|\
657 EXT4_FEATURE_RO_COMPAT_DIR_NLINK|\
658 EXT4_FEATURE_RO_COMPAT_EXTRA_ISIZE|\
659 EXT4_FEATURE_RO_COMPAT_GDT_CSUM|\
660 EXT4_FEATURE_RO_COMPAT_BIGALLOC|\
661 EXT4_FEATURE_RO_COMPAT_QUOTA|\
662 EXT4_FEATURE_RO_COMPAT_METADATA_CSUM|\
663 EXT4_FEATURE_RO_COMPAT_READONLY |\
664 EXT4_FEATURE_RO_COMPAT_PROJECT |\
665 EXT4_FEATURE_RO_COMPAT_SHARED_BLOCKS |\
666 EXT4_FEATURE_RO_COMPAT_VERITY)
669 * These features are only allowed if EXT2_FLAG_SOFTSUPP_FEATURES is passed
672 #define EXT2_LIB_SOFTSUPP_INCOMPAT (0)
673 #define EXT2_LIB_SOFTSUPP_RO_COMPAT (EXT4_FEATURE_RO_COMPAT_REPLICA)
676 /* Translate a block number to a cluster number */
677 #define EXT2FS_CLUSTER_RATIO(fs) (1 << (fs)->cluster_ratio_bits)
678 #define EXT2FS_CLUSTER_MASK(fs) (EXT2FS_CLUSTER_RATIO(fs) - 1)
679 #define EXT2FS_B2C(fs, blk) ((blk) >> (fs)->cluster_ratio_bits)
680 /* Translate a cluster number to a block number */
681 #define EXT2FS_C2B(fs, cluster) ((cluster) << (fs)->cluster_ratio_bits)
682 /* Translate # of blks to # of clusters */
683 #define EXT2FS_NUM_B2C(fs, blks) (((blks) + EXT2FS_CLUSTER_MASK(fs)) >> \
684 (fs)->cluster_ratio_bits)
686 #if defined(HAVE_FSTAT64) && !defined(__OSX_AVAILABLE_BUT_DEPRECATED)
687 typedef struct stat64 ext2fs_struct_stat;
689 typedef struct stat ext2fs_struct_stat;
693 * For ext2fs_close2() and ext2fs_flush2(), this flag allows you to
694 * avoid the fsync call.
696 #define EXT2_FLAG_FLUSH_NO_SYNC 1
699 * Modify and iterate extended attributes
701 struct ext2_xattr_handle;
702 #define XATTR_ABORT 1
703 #define XATTR_CHANGED 2
706 * flags for ext2fs_rw_bitmaps()
708 #define EXT2FS_BITMAPS_WRITE 0x0001
709 #define EXT2FS_BITMAPS_BLOCK 0x0002
710 #define EXT2FS_BITMAPS_INODE 0x0004
711 #define EXT2FS_BITMAPS_VALID_FLAGS 0x0007
714 * function prototypes
716 static inline int ext2fs_has_group_desc_csum(ext2_filsys fs)
718 return ext2fs_has_feature_metadata_csum(fs->super) ||
719 ext2fs_has_feature_gdt_csum(fs->super);
722 /* The LARGE_FILE feature should be set if we have stored files 2GB+ in size */
723 static inline int ext2fs_needs_large_file_feature(unsigned long long file_size)
725 return file_size >= 0x80000000ULL;
729 extern void ext2fs_clear_block_uninit(ext2_filsys fs, dgrp_t group);
730 extern errcode_t ext2fs_new_inode(ext2_filsys fs, ext2_ino_t dir, int mode,
731 ext2fs_inode_bitmap map, ext2_ino_t *ret);
732 extern errcode_t ext2fs_new_block(ext2_filsys fs, blk_t goal,
733 ext2fs_block_bitmap map, blk_t *ret);
734 extern errcode_t ext2fs_new_block2(ext2_filsys fs, blk64_t goal,
735 ext2fs_block_bitmap map, blk64_t *ret);
736 extern errcode_t ext2fs_new_block3(ext2_filsys fs, blk64_t goal,
737 ext2fs_block_bitmap map, blk64_t *ret,
738 struct blk_alloc_ctx *ctx);
739 extern errcode_t ext2fs_get_free_blocks(ext2_filsys fs, blk_t start,
740 blk_t finish, int num,
741 ext2fs_block_bitmap map,
743 extern errcode_t ext2fs_get_free_blocks2(ext2_filsys fs, blk64_t start,
744 blk64_t finish, int num,
745 ext2fs_block_bitmap map,
747 extern errcode_t ext2fs_alloc_block(ext2_filsys fs, blk_t goal,
748 char *block_buf, blk_t *ret);
749 extern errcode_t ext2fs_alloc_block2(ext2_filsys fs, blk64_t goal,
750 char *block_buf, blk64_t *ret);
751 extern errcode_t ext2fs_alloc_block3(ext2_filsys fs, blk64_t goal,
752 char *block_buf, blk64_t *ret,
753 struct blk_alloc_ctx *ctx);
755 extern void ext2fs_set_alloc_block_callback(ext2_filsys fs,
756 errcode_t (*func)(ext2_filsys fs,
759 errcode_t (**old)(ext2_filsys fs,
762 blk64_t ext2fs_find_inode_goal(ext2_filsys fs, ext2_ino_t ino,
763 struct ext2_inode *inode, blk64_t lblk);
764 extern void ext2fs_set_new_range_callback(ext2_filsys fs,
765 errcode_t (*func)(ext2_filsys fs, int flags, blk64_t goal,
766 blk64_t len, blk64_t *pblk, blk64_t *plen),
767 errcode_t (**old)(ext2_filsys fs, int flags, blk64_t goal,
768 blk64_t len, blk64_t *pblk, blk64_t *plen));
769 extern void ext2fs_set_block_alloc_stats_range_callback(ext2_filsys fs,
770 void (*func)(ext2_filsys fs, blk64_t blk,
771 blk_t num, int inuse),
772 void (**old)(ext2_filsys fs, blk64_t blk,
773 blk_t num, int inuse));
774 #define EXT2_NEWRANGE_FIXED_GOAL (0x1)
775 #define EXT2_NEWRANGE_MIN_LENGTH (0x2)
776 #define EXT2_NEWRANGE_ALL_FLAGS (0x3)
777 errcode_t ext2fs_new_range(ext2_filsys fs, int flags, blk64_t goal,
778 blk64_t len, ext2fs_block_bitmap map, blk64_t *pblk,
780 #define EXT2_ALLOCRANGE_FIXED_GOAL (0x1)
781 #define EXT2_ALLOCRANGE_ZERO_BLOCKS (0x2)
782 #define EXT2_ALLOCRANGE_ALL_FLAGS (0x3)
783 errcode_t ext2fs_alloc_range(ext2_filsys fs, int flags, blk64_t goal,
784 blk_t len, blk64_t *ret);
787 extern int ext2fs_reserve_super_and_bgd(ext2_filsys fs,
789 ext2fs_block_bitmap bmap);
790 extern void ext2fs_set_block_alloc_stats_callback(ext2_filsys fs,
791 void (*func)(ext2_filsys fs,
794 void (**old)(ext2_filsys fs,
799 void ext2fs_inode_alloc_stats(ext2_filsys fs, ext2_ino_t ino, int inuse);
800 void ext2fs_inode_alloc_stats2(ext2_filsys fs, ext2_ino_t ino,
801 int inuse, int isdir);
802 void ext2fs_block_alloc_stats(ext2_filsys fs, blk_t blk, int inuse);
803 void ext2fs_block_alloc_stats2(ext2_filsys fs, blk64_t blk, int inuse);
804 void ext2fs_block_alloc_stats_range(ext2_filsys fs, blk64_t blk,
805 blk_t num, int inuse);
808 extern errcode_t ext2fs_allocate_tables(ext2_filsys fs);
809 extern errcode_t ext2fs_allocate_group_table(ext2_filsys fs, dgrp_t group,
810 ext2fs_block_bitmap bmap);
813 extern errcode_t ext2fs_u32_list_create(ext2_u32_list *ret, int size);
814 extern errcode_t ext2fs_u32_list_add(ext2_u32_list bb, __u32 blk);
815 extern int ext2fs_u32_list_find(ext2_u32_list bb, __u32 blk);
816 extern int ext2fs_u32_list_test(ext2_u32_list bb, blk_t blk);
817 extern errcode_t ext2fs_u32_list_iterate_begin(ext2_u32_list bb,
818 ext2_u32_iterate *ret);
819 extern int ext2fs_u32_list_iterate(ext2_u32_iterate iter, blk_t *blk);
820 extern void ext2fs_u32_list_iterate_end(ext2_u32_iterate iter);
821 extern errcode_t ext2fs_u32_copy(ext2_u32_list src, ext2_u32_list *dest);
822 extern int ext2fs_u32_list_equal(ext2_u32_list bb1, ext2_u32_list bb2);
824 extern errcode_t ext2fs_badblocks_list_create(ext2_badblocks_list *ret,
826 extern errcode_t ext2fs_badblocks_list_add(ext2_badblocks_list bb,
828 extern int ext2fs_badblocks_list_test(ext2_badblocks_list bb,
830 extern int ext2fs_u32_list_del(ext2_u32_list bb, __u32 blk);
831 extern void ext2fs_badblocks_list_del(ext2_u32_list bb, __u32 blk);
833 ext2fs_badblocks_list_iterate_begin(ext2_badblocks_list bb,
834 ext2_badblocks_iterate *ret);
835 extern int ext2fs_badblocks_list_iterate(ext2_badblocks_iterate iter,
837 extern void ext2fs_badblocks_list_iterate_end(ext2_badblocks_iterate iter);
838 extern errcode_t ext2fs_badblocks_copy(ext2_badblocks_list src,
839 ext2_badblocks_list *dest);
840 extern errcode_t ext2fs_badblocks_merge(ext2_badblocks_list src,
841 ext2_badblocks_list dest);
842 extern int ext2fs_badblocks_equal(ext2_badblocks_list bb1,
843 ext2_badblocks_list bb2);
844 extern int ext2fs_u32_list_count(ext2_u32_list bb);
847 extern errcode_t badblocks_list_create(badblocks_list *ret, int size);
848 extern errcode_t badblocks_list_add(badblocks_list bb, blk_t blk);
849 extern int badblocks_list_test(badblocks_list bb, blk_t blk);
850 extern errcode_t badblocks_list_iterate_begin(badblocks_list bb,
851 badblocks_iterate *ret);
852 extern int badblocks_list_iterate(badblocks_iterate iter, blk_t *blk);
853 extern void badblocks_list_iterate_end(badblocks_iterate iter);
854 extern void badblocks_list_free(badblocks_list bb);
857 extern errcode_t ext2fs_update_bb_inode(ext2_filsys fs,
858 ext2_badblocks_list bb_list);
861 extern void ext2fs_free_block_bitmap(ext2fs_block_bitmap bitmap);
862 extern void ext2fs_free_inode_bitmap(ext2fs_inode_bitmap bitmap);
863 extern errcode_t ext2fs_copy_bitmap(ext2fs_generic_bitmap src,
864 ext2fs_generic_bitmap *dest);
865 errcode_t ext2fs_merge_bitmap(ext2fs_generic_bitmap src,
866 ext2fs_generic_bitmap dest,
867 ext2fs_generic_bitmap dup,
868 ext2fs_generic_bitmap dup_allowed);
869 extern errcode_t ext2fs_allocate_block_bitmap(ext2_filsys fs,
871 ext2fs_block_bitmap *ret);
872 extern errcode_t ext2fs_allocate_subcluster_bitmap(ext2_filsys fs,
874 ext2fs_block_bitmap *ret);
875 extern int ext2fs_get_bitmap_granularity(ext2fs_block_bitmap bitmap);
876 extern errcode_t ext2fs_allocate_inode_bitmap(ext2_filsys fs,
878 ext2fs_inode_bitmap *ret);
879 extern errcode_t ext2fs_fudge_inode_bitmap_end(ext2fs_inode_bitmap bitmap,
880 ext2_ino_t end, ext2_ino_t *oend);
881 extern errcode_t ext2fs_fudge_block_bitmap_end(ext2fs_block_bitmap bitmap,
882 blk_t end, blk_t *oend);
883 extern errcode_t ext2fs_fudge_block_bitmap_end2(ext2fs_block_bitmap bitmap,
884 blk64_t end, blk64_t *oend);
885 extern void ext2fs_clear_inode_bitmap(ext2fs_inode_bitmap bitmap);
886 extern void ext2fs_clear_block_bitmap(ext2fs_block_bitmap bitmap);
887 extern errcode_t ext2fs_resize_inode_bitmap(__u32 new_end, __u32 new_real_end,
888 ext2fs_inode_bitmap bmap);
889 extern errcode_t ext2fs_resize_inode_bitmap2(__u64 new_end,
891 ext2fs_inode_bitmap bmap);
892 extern errcode_t ext2fs_resize_block_bitmap(__u32 new_end, __u32 new_real_end,
893 ext2fs_block_bitmap bmap);
894 extern errcode_t ext2fs_resize_block_bitmap2(__u64 new_end,
896 ext2fs_block_bitmap bmap);
897 extern errcode_t ext2fs_compare_block_bitmap(ext2fs_block_bitmap bm1,
898 ext2fs_block_bitmap bm2);
899 extern errcode_t ext2fs_compare_inode_bitmap(ext2fs_inode_bitmap bm1,
900 ext2fs_inode_bitmap bm2);
901 extern errcode_t ext2fs_set_inode_bitmap_range(ext2fs_inode_bitmap bmap,
902 ext2_ino_t start, unsigned int num,
904 extern errcode_t ext2fs_set_inode_bitmap_range2(ext2fs_inode_bitmap bmap,
905 __u64 start, size_t num,
907 extern errcode_t ext2fs_get_inode_bitmap_range(ext2fs_inode_bitmap bmap,
908 ext2_ino_t start, unsigned int num,
910 extern errcode_t ext2fs_get_inode_bitmap_range2(ext2fs_inode_bitmap bmap,
911 __u64 start, size_t num,
913 extern errcode_t ext2fs_set_block_bitmap_range(ext2fs_block_bitmap bmap,
914 blk_t start, unsigned int num,
916 extern errcode_t ext2fs_set_block_bitmap_range2(ext2fs_block_bitmap bmap,
917 blk64_t start, size_t num,
919 extern errcode_t ext2fs_get_block_bitmap_range(ext2fs_block_bitmap bmap,
920 blk_t start, unsigned int num,
922 extern errcode_t ext2fs_get_block_bitmap_range2(ext2fs_block_bitmap bmap,
923 blk64_t start, size_t num,
927 extern __u32 ext2fs_inode_bitmap_checksum(ext2_filsys fs, dgrp_t group);
928 extern __u32 ext2fs_block_bitmap_checksum(ext2_filsys fs, dgrp_t group);
929 extern dgrp_t ext2fs_group_of_blk2(ext2_filsys fs, blk64_t);
930 extern blk64_t ext2fs_group_first_block2(ext2_filsys fs, dgrp_t group);
931 extern blk64_t ext2fs_group_last_block2(ext2_filsys fs, dgrp_t group);
932 extern int ext2fs_group_blocks_count(ext2_filsys fs, dgrp_t group);
933 extern blk64_t ext2fs_inode_data_blocks2(ext2_filsys fs,
934 struct ext2_inode *inode);
935 extern blk64_t ext2fs_inode_i_blocks(ext2_filsys fs,
936 struct ext2_inode *inode);
937 extern blk64_t ext2fs_get_stat_i_blocks(ext2_filsys fs,
938 struct ext2_inode *inode);
939 extern blk64_t ext2fs_blocks_count(struct ext2_super_block *super);
940 extern void ext2fs_blocks_count_set(struct ext2_super_block *super,
942 extern void ext2fs_blocks_count_add(struct ext2_super_block *super,
944 extern blk64_t ext2fs_r_blocks_count(struct ext2_super_block *super);
945 extern void ext2fs_r_blocks_count_set(struct ext2_super_block *super,
947 extern void ext2fs_r_blocks_count_add(struct ext2_super_block *super,
949 extern blk64_t ext2fs_free_blocks_count(struct ext2_super_block *super);
950 extern void ext2fs_free_blocks_count_set(struct ext2_super_block *super,
952 extern void ext2fs_free_blocks_count_add(struct ext2_super_block *super,
954 /* Block group descriptor accessor functions */
955 extern struct ext2_group_desc *ext2fs_group_desc(ext2_filsys fs,
956 struct opaque_ext2_group_desc *gdp,
958 extern blk64_t ext2fs_block_bitmap_csum(ext2_filsys fs, dgrp_t group);
959 extern blk64_t ext2fs_block_bitmap_loc(ext2_filsys fs, dgrp_t group);
960 extern void ext2fs_block_bitmap_loc_set(ext2_filsys fs, dgrp_t group,
962 extern __u32 ext2fs_inode_bitmap_csum(ext2_filsys fs, dgrp_t group);
963 extern blk64_t ext2fs_inode_bitmap_loc(ext2_filsys fs, dgrp_t group);
964 extern void ext2fs_inode_bitmap_loc_set(ext2_filsys fs, dgrp_t group,
966 extern blk64_t ext2fs_inode_table_loc(ext2_filsys fs, dgrp_t group);
967 extern void ext2fs_inode_table_loc_set(ext2_filsys fs, dgrp_t group,
969 extern __u32 ext2fs_bg_free_blocks_count(ext2_filsys fs, dgrp_t group);
970 extern void ext2fs_bg_free_blocks_count_set(ext2_filsys fs, dgrp_t group,
972 extern __u32 ext2fs_bg_free_inodes_count(ext2_filsys fs, dgrp_t group);
973 extern void ext2fs_bg_free_inodes_count_set(ext2_filsys fs, dgrp_t group,
975 extern __u32 ext2fs_bg_used_dirs_count(ext2_filsys fs, dgrp_t group);
976 extern void ext2fs_bg_used_dirs_count_set(ext2_filsys fs, dgrp_t group,
978 extern __u32 ext2fs_bg_itable_unused(ext2_filsys fs, dgrp_t group);
979 extern void ext2fs_bg_itable_unused_set(ext2_filsys fs, dgrp_t group,
981 extern __u16 ext2fs_bg_flags(ext2_filsys fs, dgrp_t group);
982 extern void ext2fs_bg_flags_zap(ext2_filsys fs, dgrp_t group);
983 extern int ext2fs_bg_flags_test(ext2_filsys fs, dgrp_t group, __u16 bg_flag);
984 extern void ext2fs_bg_flags_set(ext2_filsys fs, dgrp_t group, __u16 bg_flags);
985 extern void ext2fs_bg_flags_clear(ext2_filsys fs, dgrp_t group, __u16 bg_flags);
986 extern __u16 ext2fs_bg_checksum(ext2_filsys fs, dgrp_t group);
987 extern void ext2fs_bg_checksum_set(ext2_filsys fs, dgrp_t group, __u16 checksum);
988 extern blk64_t ext2fs_file_acl_block(ext2_filsys fs,
989 const struct ext2_inode *inode);
990 extern void ext2fs_file_acl_block_set(ext2_filsys fs,
991 struct ext2_inode *inode, blk64_t blk);
992 extern errcode_t ext2fs_inode_size_set(ext2_filsys fs, struct ext2_inode *inode,
996 extern errcode_t ext2fs_block_iterate(ext2_filsys fs,
1000 int (*func)(ext2_filsys fs,
1005 errcode_t ext2fs_block_iterate2(ext2_filsys fs,
1009 int (*func)(ext2_filsys fs,
1011 e2_blkcnt_t blockcnt,
1016 errcode_t ext2fs_block_iterate3(ext2_filsys fs,
1020 int (*func)(ext2_filsys fs,
1022 e2_blkcnt_t blockcnt,
1029 extern errcode_t ext2fs_bmap(ext2_filsys fs, ext2_ino_t ino,
1030 struct ext2_inode *inode,
1031 char *block_buf, int bmap_flags,
1032 blk_t block, blk_t *phys_blk);
1033 extern errcode_t ext2fs_bmap2(ext2_filsys fs, ext2_ino_t ino,
1034 struct ext2_inode *inode,
1035 char *block_buf, int bmap_flags, blk64_t block,
1036 int *ret_flags, blk64_t *phys_blk);
1037 errcode_t ext2fs_map_cluster_block(ext2_filsys fs, ext2_ino_t ino,
1038 struct ext2_inode *inode, blk64_t lblk,
1043 extern errcode_t ext2fs_move_blocks(ext2_filsys fs,
1044 ext2fs_block_bitmap reserve,
1045 ext2fs_block_bitmap alloc_map,
1050 extern errcode_t ext2fs_check_desc(ext2_filsys fs);
1053 extern errcode_t ext2fs_close(ext2_filsys fs);
1054 extern errcode_t ext2fs_close2(ext2_filsys fs, int flags);
1055 extern errcode_t ext2fs_close_free(ext2_filsys *fs);
1056 extern errcode_t ext2fs_flush(ext2_filsys fs);
1057 extern errcode_t ext2fs_flush2(ext2_filsys fs, int flags);
1058 extern int ext2fs_bg_has_super(ext2_filsys fs, dgrp_t group_block);
1059 extern errcode_t ext2fs_super_and_bgd_loc2(ext2_filsys fs,
1061 blk64_t *ret_super_blk,
1062 blk64_t *ret_old_desc_blk,
1063 blk64_t *ret_new_desc_blk,
1064 blk_t *ret_used_blks);
1065 extern int ext2fs_super_and_bgd_loc(ext2_filsys fs,
1067 blk_t *ret_super_blk,
1068 blk_t *ret_old_desc_blk,
1069 blk_t *ret_new_desc_blk,
1071 extern void ext2fs_update_dynamic_rev(ext2_filsys fs);
1074 extern __u32 ext2fs_crc32_be(__u32 crc, unsigned char const *p, size_t len);
1075 extern __u32 ext2fs_crc32c_le(__u32 crc, unsigned char const *p, size_t len);
1078 extern void ext2fs_init_csum_seed(ext2_filsys fs);
1079 extern errcode_t ext2fs_mmp_csum_set(ext2_filsys fs, struct mmp_struct *mmp);
1080 extern int ext2fs_mmp_csum_verify(ext2_filsys, struct mmp_struct *mmp);
1081 extern int ext2fs_verify_csum_type(ext2_filsys fs, struct ext2_super_block *sb);
1082 extern errcode_t ext2fs_superblock_csum_set(ext2_filsys fs,
1083 struct ext2_super_block *sb);
1084 extern int ext2fs_superblock_csum_verify(ext2_filsys fs,
1085 struct ext2_super_block *sb);
1086 extern errcode_t ext2fs_ext_attr_block_csum_set(ext2_filsys fs,
1087 ext2_ino_t inum, blk64_t block,
1088 struct ext2_ext_attr_header *hdr);
1089 extern int ext2fs_ext_attr_block_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1091 struct ext2_ext_attr_header *hdr);
1092 #define EXT2_DIRENT_TAIL(block, blocksize) \
1093 ((struct ext2_dir_entry_tail *)(((char *)(block)) + \
1094 (blocksize) - sizeof(struct ext2_dir_entry_tail)))
1096 extern void ext2fs_initialize_dirent_tail(ext2_filsys fs,
1097 struct ext2_dir_entry_tail *t);
1098 extern int ext2fs_dirent_has_tail(ext2_filsys fs,
1099 struct ext2_dir_entry *dirent);
1100 extern int ext2fs_dirent_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1101 struct ext2_dir_entry *dirent);
1102 extern int ext2fs_dir_block_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1103 struct ext2_dir_entry *dirent);
1104 extern errcode_t ext2fs_dir_block_csum_set(ext2_filsys fs, ext2_ino_t inum,
1105 struct ext2_dir_entry *dirent);
1106 extern errcode_t ext2fs_get_dx_countlimit(ext2_filsys fs,
1107 struct ext2_dir_entry *dirent,
1108 struct ext2_dx_countlimit **cc,
1110 extern errcode_t ext2fs_dx_csum(ext2_filsys fs, ext2_ino_t inum,
1111 struct ext2_dir_entry *dirent,
1112 __u32 *crc, struct ext2_dx_tail **ret_t);
1113 extern errcode_t ext2fs_extent_block_csum_set(ext2_filsys fs,
1115 struct ext3_extent_header *eh);
1116 extern int ext2fs_extent_block_csum_verify(ext2_filsys fs,
1118 struct ext3_extent_header *eh);
1119 extern errcode_t ext2fs_block_bitmap_csum_set(ext2_filsys fs, dgrp_t group,
1120 char *bitmap, int size);
1121 extern int ext2fs_block_bitmap_csum_verify(ext2_filsys fs, dgrp_t group,
1122 char *bitmap, int size);
1123 extern errcode_t ext2fs_inode_bitmap_csum_set(ext2_filsys fs, dgrp_t group,
1124 char *bitmap, int size);
1125 extern int ext2fs_inode_bitmap_csum_verify(ext2_filsys fs, dgrp_t group,
1126 char *bitmap, int size);
1127 extern errcode_t ext2fs_inode_csum_set(ext2_filsys fs, ext2_ino_t inum,
1128 struct ext2_inode_large *inode);
1129 extern int ext2fs_inode_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1130 struct ext2_inode_large *inode);
1131 extern void ext2fs_group_desc_csum_set(ext2_filsys fs, dgrp_t group);
1132 extern int ext2fs_group_desc_csum_verify(ext2_filsys fs, dgrp_t group);
1133 extern errcode_t ext2fs_set_gdt_csum(ext2_filsys fs);
1134 extern __u16 ext2fs_group_desc_csum(ext2_filsys fs, dgrp_t group);
1137 extern errcode_t ext2fs_init_dblist(ext2_filsys fs, ext2_dblist *ret_dblist);
1138 extern errcode_t ext2fs_add_dir_block(ext2_dblist dblist, ext2_ino_t ino,
1139 blk_t blk, int blockcnt);
1140 extern errcode_t ext2fs_add_dir_block2(ext2_dblist dblist, ext2_ino_t ino,
1141 blk64_t blk, e2_blkcnt_t blockcnt);
1142 extern errcode_t ext2fs_merge_dblist(ext2_dblist src, ext2_dblist dest);
1143 extern void ext2fs_dblist_sort(ext2_dblist dblist,
1144 EXT2_QSORT_TYPE (*sortfunc)(const void *,
1146 extern void ext2fs_dblist_sort2(ext2_dblist dblist,
1147 EXT2_QSORT_TYPE (*sortfunc)(const void *,
1149 extern errcode_t ext2fs_dblist_iterate(ext2_dblist dblist,
1150 int (*func)(ext2_filsys fs, struct ext2_db_entry *db_info,
1153 extern errcode_t ext2fs_dblist_iterate2(ext2_dblist dblist,
1154 int (*func)(ext2_filsys fs, struct ext2_db_entry2 *db_info,
1157 extern errcode_t ext2fs_dblist_iterate3(ext2_dblist dblist,
1158 int (*func)(ext2_filsys fs, struct ext2_db_entry2 *db_info,
1160 unsigned long long start,
1161 unsigned long long count,
1163 extern errcode_t ext2fs_set_dir_block(ext2_dblist dblist, ext2_ino_t ino,
1164 blk_t blk, int blockcnt);
1165 extern errcode_t ext2fs_set_dir_block2(ext2_dblist dblist, ext2_ino_t ino,
1166 blk64_t blk, e2_blkcnt_t blockcnt);
1167 extern errcode_t ext2fs_copy_dblist(ext2_dblist src,
1169 extern int ext2fs_dblist_count(ext2_dblist dblist);
1170 extern blk64_t ext2fs_dblist_count2(ext2_dblist dblist);
1171 extern errcode_t ext2fs_dblist_get_last(ext2_dblist dblist,
1172 struct ext2_db_entry **entry);
1173 extern errcode_t ext2fs_dblist_get_last2(ext2_dblist dblist,
1174 struct ext2_db_entry2 **entry);
1175 extern errcode_t ext2fs_dblist_drop_last(ext2_dblist dblist);
1179 ext2fs_dblist_dir_iterate(ext2_dblist dblist,
1182 int (*func)(ext2_ino_t dir,
1184 struct ext2_dir_entry *dirent,
1192 /* digest_encode.c */
1193 #define EXT2FS_DIGEST_SIZE EXT2FS_SHA256_LENGTH
1194 extern int ext2fs_digest_encode(const char *src, int len, char *dst);
1195 extern int ext2fs_digest_decode(const char *src, int len, char *dst);
1199 extern errcode_t ext2fs_read_dir_block(ext2_filsys fs, blk_t block,
1201 extern errcode_t ext2fs_read_dir_block2(ext2_filsys fs, blk_t block,
1202 void *buf, int flags);
1203 extern errcode_t ext2fs_read_dir_block3(ext2_filsys fs, blk64_t block,
1204 void *buf, int flags);
1205 extern errcode_t ext2fs_read_dir_block4(ext2_filsys fs, blk64_t block,
1206 void *buf, int flags, ext2_ino_t ino);
1207 extern errcode_t ext2fs_write_dir_block(ext2_filsys fs, blk_t block,
1209 extern errcode_t ext2fs_write_dir_block2(ext2_filsys fs, blk_t block,
1210 void *buf, int flags);
1211 extern errcode_t ext2fs_write_dir_block3(ext2_filsys fs, blk64_t block,
1212 void *buf, int flags);
1213 extern errcode_t ext2fs_write_dir_block4(ext2_filsys fs, blk64_t block,
1214 void *buf, int flags, ext2_ino_t ino);
1217 extern errcode_t ext2fs_dirhash(int version, const char *name, int len,
1219 ext2_dirhash_t *ret_hash,
1220 ext2_dirhash_t *ret_minor_hash);
1222 extern errcode_t ext2fs_dirhash2(int version, const char *name, int len,
1223 const struct ext2fs_nls_table *charset,
1226 ext2_dirhash_t *ret_hash,
1227 ext2_dirhash_t *ret_minor_hash);
1230 extern errcode_t ext2fs_get_rec_len(ext2_filsys fs,
1231 struct ext2_dir_entry *dirent,
1232 unsigned int *rec_len);
1233 extern errcode_t ext2fs_set_rec_len(ext2_filsys fs,
1235 struct ext2_dir_entry *dirent);
1236 extern errcode_t ext2fs_dir_iterate(ext2_filsys fs,
1240 int (*func)(struct ext2_dir_entry *dirent,
1246 extern errcode_t ext2fs_dir_iterate2(ext2_filsys fs,
1250 int (*func)(ext2_ino_t dir,
1252 struct ext2_dir_entry *dirent,
1260 extern errcode_t ext2fs_dup_handle(ext2_filsys src, ext2_filsys *dest);
1263 extern errcode_t ext2fs_expand_dir(ext2_filsys fs, ext2_ino_t dir);
1266 extern errcode_t ext2fs_attr_get(ext2_filsys fs, struct ext2_inode *inode,
1267 int name_index, const char *name, char *buffer,
1268 size_t buffer_size, int *easize);
1270 extern __u32 ext2fs_ext_attr_hash_entry(struct ext2_ext_attr_entry *entry,
1272 extern errcode_t ext2fs_ext_attr_hash_entry2(ext2_filsys fs,
1273 struct ext2_ext_attr_entry *entry,
1274 void *data, __u32 *hash);
1275 int ext2fs_attr_get_next_attr(struct ext2_ext_attr_entry *entry, int name_index,
1276 char *buffer, int buffer_size, int start);
1277 errcode_t ext2fs_attr_set(ext2_filsys fs, ext2_ino_t ino,
1278 struct ext2_inode *inode,
1279 int name_index, const char *name, const char *value,
1280 int value_len, int flags);
1281 extern errcode_t ext2fs_expand_extra_isize(ext2_filsys fs, ext2_ino_t ino,
1282 struct ext2_inode_large *inode,
1283 int new_extra_isize, int *ret,
1285 extern errcode_t ext2fs_read_ext_attr(ext2_filsys fs, blk_t block, void *buf);
1286 extern errcode_t ext2fs_read_ext_attr2(ext2_filsys fs, blk64_t block,
1288 extern errcode_t ext2fs_read_ext_attr3(ext2_filsys fs, blk64_t block,
1289 void *buf, ext2_ino_t inum);
1290 extern errcode_t ext2fs_write_ext_attr(ext2_filsys fs, blk_t block,
1292 extern errcode_t ext2fs_write_ext_attr2(ext2_filsys fs, blk64_t block,
1294 extern errcode_t ext2fs_write_ext_attr3(ext2_filsys fs, blk64_t block,
1295 void *buf, ext2_ino_t inum);
1296 extern errcode_t ext2fs_adjust_ea_refcount(ext2_filsys fs, blk_t blk,
1298 int adjust, __u32 *newcount);
1299 extern errcode_t ext2fs_adjust_ea_refcount2(ext2_filsys fs, blk64_t blk,
1301 int adjust, __u32 *newcount);
1302 extern errcode_t ext2fs_adjust_ea_refcount3(ext2_filsys fs, blk64_t blk,
1304 int adjust, __u32 *newcount,
1306 errcode_t ext2fs_xattrs_write(struct ext2_xattr_handle *handle);
1307 errcode_t ext2fs_xattrs_read(struct ext2_xattr_handle *handle);
1308 errcode_t ext2fs_xattrs_iterate(struct ext2_xattr_handle *h,
1309 int (*func)(char *name, char *value,
1311 ext2_ino_t inode_num, void *data),
1313 errcode_t ext2fs_xattr_get(struct ext2_xattr_handle *h, const char *key,
1314 void **value, size_t *value_len);
1315 errcode_t ext2fs_xattr_set(struct ext2_xattr_handle *handle,
1319 errcode_t ext2fs_xattr_remove(struct ext2_xattr_handle *handle,
1321 errcode_t ext2fs_xattrs_open(ext2_filsys fs, ext2_ino_t ino,
1322 struct ext2_xattr_handle **handle);
1323 errcode_t ext2fs_xattrs_close(struct ext2_xattr_handle **handle);
1324 errcode_t ext2fs_free_ext_attr(ext2_filsys fs, ext2_ino_t ino,
1325 struct ext2_inode_large *inode);
1326 errcode_t ext2fs_xattrs_count(struct ext2_xattr_handle *handle, size_t *count);
1327 errcode_t ext2fs_xattr_inode_max_size(ext2_filsys fs, ext2_ino_t ino,
1329 #define XATTR_HANDLE_FLAG_RAW 0x0001
1330 errcode_t ext2fs_xattrs_flags(struct ext2_xattr_handle *handle,
1331 unsigned int *new_flags, unsigned int *old_flags);
1332 extern void ext2fs_ext_attr_block_rehash(struct ext2_ext_attr_header *header,
1333 struct ext2_ext_attr_entry *end);
1334 extern __u32 ext2fs_get_ea_inode_hash(struct ext2_inode *inode);
1335 extern void ext2fs_set_ea_inode_hash(struct ext2_inode *inode, __u32 hash);
1336 extern __u64 ext2fs_get_ea_inode_ref(struct ext2_inode *inode);
1337 extern void ext2fs_set_ea_inode_ref(struct ext2_inode *inode, __u64 ref_count);
1340 extern errcode_t ext2fs_extent_header_verify(void *ptr, int size);
1341 extern errcode_t ext2fs_extent_open(ext2_filsys fs, ext2_ino_t ino,
1342 ext2_extent_handle_t *handle);
1343 extern errcode_t ext2fs_extent_open2(ext2_filsys fs, ext2_ino_t ino,
1344 struct ext2_inode *inode,
1345 ext2_extent_handle_t *ret_handle);
1346 extern void ext2fs_extent_free(ext2_extent_handle_t handle);
1347 extern errcode_t ext2fs_extent_get(ext2_extent_handle_t handle,
1348 int flags, struct ext2fs_extent *extent);
1349 extern errcode_t ext2fs_extent_node_split(ext2_extent_handle_t handle);
1350 extern errcode_t ext2fs_extent_replace(ext2_extent_handle_t handle, int flags,
1351 struct ext2fs_extent *extent);
1352 extern errcode_t ext2fs_extent_insert(ext2_extent_handle_t handle, int flags,
1353 struct ext2fs_extent *extent);
1354 extern errcode_t ext2fs_extent_set_bmap(ext2_extent_handle_t handle,
1355 blk64_t logical, blk64_t physical,
1357 extern errcode_t ext2fs_extent_delete(ext2_extent_handle_t handle, int flags);
1358 extern errcode_t ext2fs_extent_get_info(ext2_extent_handle_t handle,
1359 struct ext2_extent_info *info);
1360 extern errcode_t ext2fs_extent_goto(ext2_extent_handle_t handle,
1362 extern errcode_t ext2fs_extent_goto2(ext2_extent_handle_t handle,
1363 int leaf_level, blk64_t blk);
1364 extern errcode_t ext2fs_extent_fix_parents(ext2_extent_handle_t handle);
1365 extern size_t ext2fs_max_extent_depth(ext2_extent_handle_t handle);
1366 extern errcode_t ext2fs_fix_extents_checksums(ext2_filsys fs, ext2_ino_t ino,
1367 struct ext2_inode *inode);
1368 extern errcode_t ext2fs_count_blocks(ext2_filsys fs, ext2_ino_t ino,
1369 struct ext2_inode *inode, blk64_t *ret_count);
1370 extern errcode_t ext2fs_decode_extent(struct ext2fs_extent *to, void *from,
1374 #define EXT2_FALLOCATE_ZERO_BLOCKS (0x1)
1375 #define EXT2_FALLOCATE_FORCE_INIT (0x2)
1376 #define EXT2_FALLOCATE_FORCE_UNINIT (0x4)
1377 #define EXT2_FALLOCATE_INIT_BEYOND_EOF (0x8)
1378 #define EXT2_FALLOCATE_ALL_FLAGS (0xF)
1379 errcode_t ext2fs_fallocate(ext2_filsys fs, int flags, ext2_ino_t ino,
1380 struct ext2_inode *inode, blk64_t goal,
1381 blk64_t start, blk64_t len);
1384 extern errcode_t ext2fs_file_open2(ext2_filsys fs, ext2_ino_t ino,
1385 struct ext2_inode *inode,
1386 int flags, ext2_file_t *ret);
1387 extern errcode_t ext2fs_file_open(ext2_filsys fs, ext2_ino_t ino,
1388 int flags, ext2_file_t *ret);
1389 extern ext2_filsys ext2fs_file_get_fs(ext2_file_t file);
1390 struct ext2_inode *ext2fs_file_get_inode(ext2_file_t file);
1391 extern ext2_ino_t ext2fs_file_get_inode_num(ext2_file_t file);
1392 extern errcode_t ext2fs_file_close(ext2_file_t file);
1393 extern errcode_t ext2fs_file_flush(ext2_file_t file);
1394 extern errcode_t ext2fs_file_read(ext2_file_t file, void *buf,
1395 unsigned int wanted, unsigned int *got);
1396 extern errcode_t ext2fs_file_write(ext2_file_t file, const void *buf,
1397 unsigned int nbytes, unsigned int *written);
1398 extern errcode_t ext2fs_file_llseek(ext2_file_t file, __u64 offset,
1399 int whence, __u64 *ret_pos);
1400 extern errcode_t ext2fs_file_lseek(ext2_file_t file, ext2_off_t offset,
1401 int whence, ext2_off_t *ret_pos);
1402 errcode_t ext2fs_file_get_lsize(ext2_file_t file, __u64 *ret_size);
1403 extern ext2_off_t ext2fs_file_get_size(ext2_file_t file);
1404 extern errcode_t ext2fs_file_set_size(ext2_file_t file, ext2_off_t size);
1405 extern errcode_t ext2fs_file_set_size2(ext2_file_t file, ext2_off64_t size);
1408 extern char *ext2fs_find_block_device(dev_t device);
1411 extern errcode_t ext2fs_sync_device(int fd, int flushb);
1414 extern void ext2fs_free(ext2_filsys fs);
1415 extern void ext2fs_free_dblist(ext2_dblist dblist);
1416 extern void ext2fs_badblocks_list_free(ext2_badblocks_list bb);
1417 extern void ext2fs_u32_list_free(ext2_u32_list bb);
1420 extern void ext2fs_free_generic_bitmap(ext2fs_inode_bitmap bitmap);
1421 extern errcode_t ext2fs_make_generic_bitmap(errcode_t magic, ext2_filsys fs,
1422 __u32 start, __u32 end,
1424 const char *descr, char *init_map,
1425 ext2fs_generic_bitmap *ret);
1426 extern errcode_t ext2fs_allocate_generic_bitmap(__u32 start,
1430 ext2fs_generic_bitmap *ret);
1431 extern errcode_t ext2fs_copy_generic_bitmap(ext2fs_generic_bitmap src,
1432 ext2fs_generic_bitmap *dest);
1433 extern void ext2fs_clear_generic_bitmap(ext2fs_generic_bitmap bitmap);
1434 extern errcode_t ext2fs_fudge_generic_bitmap_end(ext2fs_inode_bitmap bitmap,
1439 extern void ext2fs_set_generic_bitmap_padding(ext2fs_generic_bitmap map);
1440 extern errcode_t ext2fs_resize_generic_bitmap(errcode_t magic,
1443 ext2fs_generic_bitmap bmap);
1444 extern errcode_t ext2fs_compare_generic_bitmap(errcode_t magic, errcode_t neq,
1445 ext2fs_generic_bitmap bm1,
1446 ext2fs_generic_bitmap bm2);
1447 extern errcode_t ext2fs_get_generic_bitmap_range(ext2fs_generic_bitmap bmap,
1449 __u32 start, __u32 num,
1451 extern errcode_t ext2fs_set_generic_bitmap_range(ext2fs_generic_bitmap bmap,
1453 __u32 start, __u32 num,
1455 extern errcode_t ext2fs_find_first_zero_generic_bitmap(ext2fs_generic_bitmap bitmap,
1456 __u32 start, __u32 end,
1458 extern errcode_t ext2fs_find_first_set_generic_bitmap(ext2fs_generic_bitmap bitmap,
1459 __u32 start, __u32 end,
1462 /* gen_bitmap64.c */
1463 void ext2fs_free_generic_bmap(ext2fs_generic_bitmap bmap);
1464 errcode_t ext2fs_alloc_generic_bmap(ext2_filsys fs, errcode_t magic,
1465 int type, __u64 start, __u64 end,
1468 ext2fs_generic_bitmap *ret);
1469 errcode_t ext2fs_copy_generic_bmap(ext2fs_generic_bitmap src,
1470 ext2fs_generic_bitmap *dest);
1471 void ext2fs_clear_generic_bmap(ext2fs_generic_bitmap bitmap);
1472 errcode_t ext2fs_fudge_generic_bmap_end(ext2fs_generic_bitmap bitmap,
1474 __u64 end, __u64 *oend);
1475 void ext2fs_set_generic_bmap_padding(ext2fs_generic_bitmap bmap);
1476 errcode_t ext2fs_resize_generic_bmap(ext2fs_generic_bitmap bmap,
1478 __u64 new_real_end);
1479 errcode_t ext2fs_merge_generic_bmap(ext2fs_generic_bitmap gen_src,
1480 ext2fs_generic_bitmap gen_dest,
1481 ext2fs_generic_bitmap gen_dup,
1482 ext2fs_generic_bitmap dup_allowed);
1483 errcode_t ext2fs_compare_generic_bmap(errcode_t neq,
1484 ext2fs_generic_bitmap bm1,
1485 ext2fs_generic_bitmap bm2);
1486 errcode_t ext2fs_get_generic_bmap_range(ext2fs_generic_bitmap bmap,
1487 __u64 start, unsigned int num,
1489 errcode_t ext2fs_set_generic_bmap_range(ext2fs_generic_bitmap bmap,
1490 __u64 start, unsigned int num,
1492 errcode_t ext2fs_convert_subcluster_bitmap(ext2_filsys fs,
1493 ext2fs_block_bitmap *bitmap);
1494 errcode_t ext2fs_count_used_clusters(ext2_filsys fs, blk64_t start,
1495 blk64_t end, blk64_t *out);
1497 /* get_num_dirs.c */
1498 extern errcode_t ext2fs_get_num_dirs(ext2_filsys fs, ext2_ino_t *ret_num_dirs);
1501 extern errcode_t ext2fs_get_device_size(const char *file, int blocksize,
1503 extern errcode_t ext2fs_get_device_size2(const char *file, int blocksize,
1504 blk64_t *retblocks);
1507 extern int ext2fs_get_dio_alignment(int fd);
1508 errcode_t ext2fs_get_device_sectsize(const char *file, int *sectsize);
1509 errcode_t ext2fs_get_device_phys_sectsize(const char *file, int *sectsize);
1512 errcode_t ext2fs_iblk_add_blocks(ext2_filsys fs, struct ext2_inode *inode,
1513 blk64_t num_blocks);
1514 errcode_t ext2fs_iblk_sub_blocks(ext2_filsys fs, struct ext2_inode *inode,
1515 blk64_t num_blocks);
1516 errcode_t ext2fs_iblk_set(ext2_filsys fs, struct ext2_inode *inode, blk64_t b);
1519 extern errcode_t ext2fs_image_inode_write(ext2_filsys fs, int fd, int flags);
1520 extern errcode_t ext2fs_image_inode_read(ext2_filsys fs, int fd, int flags);
1521 extern errcode_t ext2fs_image_super_write(ext2_filsys fs, int fd, int flags);
1522 extern errcode_t ext2fs_image_super_read(ext2_filsys fs, int fd, int flags);
1523 extern errcode_t ext2fs_image_bitmap_write(ext2_filsys fs, int fd, int flags);
1524 extern errcode_t ext2fs_image_bitmap_read(ext2_filsys fs, int fd, int flags);
1527 errcode_t ext2fs_read_ind_block(ext2_filsys fs, blk_t blk, void *buf);
1528 errcode_t ext2fs_write_ind_block(ext2_filsys fs, blk_t blk, void *buf);
1531 extern errcode_t ext2fs_initialize(const char *name, int flags,
1532 struct ext2_super_block *param,
1533 io_manager manager, ext2_filsys *ret_fs);
1534 extern errcode_t ext2fs_calculate_summary_stats(ext2_filsys fs, int super_only);
1537 extern void ext2fs_free_icount(ext2_icount_t icount);
1538 extern int ext2fs_icount_is_set(ext2_icount_t icount, ext2_ino_t ino);
1539 extern errcode_t ext2fs_create_icount_tdb(ext2_filsys fs, char *tdb_dir,
1540 int flags, ext2_icount_t *ret);
1541 extern errcode_t ext2fs_create_icount2(ext2_filsys fs, int flags,
1543 ext2_icount_t hint, ext2_icount_t *ret);
1544 extern errcode_t ext2fs_create_icount(ext2_filsys fs, int flags,
1546 ext2_icount_t *ret);
1547 extern errcode_t ext2fs_icount_fetch(ext2_icount_t icount, ext2_ino_t ino,
1549 extern errcode_t ext2fs_icount_increment(ext2_icount_t icount, ext2_ino_t ino,
1551 extern errcode_t ext2fs_icount_decrement(ext2_icount_t icount, ext2_ino_t ino,
1553 extern errcode_t ext2fs_icount_store(ext2_icount_t icount, ext2_ino_t ino,
1555 extern errcode_t ext2fs_icount_merge(ext2_icount_t src, ext2_icount_t dest);
1556 extern ext2_ino_t ext2fs_get_icount_size(ext2_icount_t icount);
1557 errcode_t ext2fs_icount_validate(ext2_icount_t icount, FILE *);
1561 extern errcode_t ext2fs_get_memalign(unsigned long size,
1562 unsigned long align, void *ptr);
1565 extern errcode_t ext2fs_inline_data_init(ext2_filsys fs, ext2_ino_t ino);
1566 extern errcode_t ext2fs_inline_data_size(ext2_filsys fs, ext2_ino_t ino,
1568 extern errcode_t ext2fs_inline_data_get(ext2_filsys fs, ext2_ino_t ino,
1569 struct ext2_inode *inode,
1570 void *buf, size_t *size);
1571 extern errcode_t ext2fs_inline_data_set(ext2_filsys fs, ext2_ino_t ino,
1572 struct ext2_inode *inode,
1573 void *buf, size_t size);
1576 extern errcode_t ext2fs_create_inode_cache(ext2_filsys fs,
1577 unsigned int cache_size);
1578 extern void ext2fs_free_inode_cache(struct ext2_inode_cache *icache);
1579 extern errcode_t ext2fs_flush_icache(ext2_filsys fs);
1580 extern errcode_t ext2fs_get_next_inode_full(ext2_inode_scan scan,
1582 struct ext2_inode *inode,
1584 #define EXT2_INODE_SCAN_DEFAULT_BUFFER_BLOCKS 8
1585 extern errcode_t ext2fs_open_inode_scan(ext2_filsys fs, int buffer_blocks,
1586 ext2_inode_scan *ret_scan);
1587 extern void ext2fs_close_inode_scan(ext2_inode_scan scan);
1588 extern errcode_t ext2fs_get_next_inode(ext2_inode_scan scan, ext2_ino_t *ino,
1589 struct ext2_inode *inode);
1590 extern errcode_t ext2fs_inode_scan_goto_blockgroup(ext2_inode_scan scan,
1592 extern void ext2fs_set_inode_callback
1593 (ext2_inode_scan scan,
1594 errcode_t (*done_group)(ext2_filsys fs,
1595 ext2_inode_scan scan,
1598 void *done_group_data);
1599 extern int ext2fs_inode_scan_flags(ext2_inode_scan scan, int set_flags,
1601 extern errcode_t ext2fs_read_inode_full(ext2_filsys fs, ext2_ino_t ino,
1602 struct ext2_inode * inode,
1604 extern errcode_t ext2fs_read_inode(ext2_filsys fs, ext2_ino_t ino,
1605 struct ext2_inode * inode);
1606 extern errcode_t ext2fs_read_inode2(ext2_filsys fs, ext2_ino_t ino,
1607 struct ext2_inode * inode,
1608 int bufsize, int flags);
1609 extern errcode_t ext2fs_write_inode_full(ext2_filsys fs, ext2_ino_t ino,
1610 struct ext2_inode * inode,
1612 extern errcode_t ext2fs_write_inode(ext2_filsys fs, ext2_ino_t ino,
1613 struct ext2_inode * inode);
1614 extern errcode_t ext2fs_write_inode2(ext2_filsys fs, ext2_ino_t ino,
1615 struct ext2_inode * inode,
1616 int bufsize, int flags);
1617 extern errcode_t ext2fs_write_new_inode(ext2_filsys fs, ext2_ino_t ino,
1618 struct ext2_inode * inode);
1619 extern errcode_t ext2fs_get_blocks(ext2_filsys fs, ext2_ino_t ino, blk_t *blocks);
1620 extern errcode_t ext2fs_check_directory(ext2_filsys fs, ext2_ino_t ino);
1623 extern io_manager inode_io_manager;
1624 extern errcode_t ext2fs_inode_io_intern(ext2_filsys fs, ext2_ino_t ino,
1626 extern errcode_t ext2fs_inode_io_intern2(ext2_filsys fs, ext2_ino_t ino,
1627 struct ext2_inode *inode,
1631 extern errcode_t ext2fs_check_if_mounted(const char *file, int *mount_flags);
1632 extern errcode_t ext2fs_check_mount_point(const char *device, int *mount_flags,
1633 char *mtpt, int mtlen);
1637 * NOTE: This function removes from an inode the blocks "start", "end", and
1638 * every block in between.
1640 extern errcode_t ext2fs_punch(ext2_filsys fs, ext2_ino_t ino,
1641 struct ext2_inode *inode,
1642 char *block_buf, blk64_t start,
1646 extern errcode_t ext2fs_lookup(ext2_filsys fs, ext2_ino_t dir, const char *name,
1647 int namelen, char *buf, ext2_ino_t *inode);
1648 extern errcode_t ext2fs_namei(ext2_filsys fs, ext2_ino_t root, ext2_ino_t cwd,
1649 const char *name, ext2_ino_t *inode);
1650 errcode_t ext2fs_namei_follow(ext2_filsys fs, ext2_ino_t root, ext2_ino_t cwd,
1651 const char *name, ext2_ino_t *inode);
1652 extern errcode_t ext2fs_follow_link(ext2_filsys fs, ext2_ino_t root, ext2_ino_t cwd,
1653 ext2_ino_t inode, ext2_ino_t *res_inode);
1656 int ext2fs_native_flag(void);
1659 extern errcode_t ext2fs_new_dir_block(ext2_filsys fs, ext2_ino_t dir_ino,
1660 ext2_ino_t parent_ino, char **block);
1661 extern errcode_t ext2fs_new_dir_inline_data(ext2_filsys fs, ext2_ino_t dir_ino,
1662 ext2_ino_t parent_ino, __u32 *iblock);
1665 extern const struct ext2fs_nls_table *ext2fs_load_nls_table(int encoding);
1666 extern int ext2fs_check_encoded_name(const struct ext2fs_nls_table *table,
1667 char *s, size_t len, char **pos);
1668 extern int ext2fs_casefold_cmp(const struct ext2fs_nls_table *table,
1669 const unsigned char *str1, size_t len1,
1670 const unsigned char *str2, size_t len2);
1673 extern errcode_t ext2fs_mkdir(ext2_filsys fs, ext2_ino_t parent, ext2_ino_t inum,
1677 struct ext2fs_journal_params {
1678 blk_t num_journal_blocks;
1679 blk_t num_fc_blocks;
1681 extern errcode_t ext2fs_get_journal_params(
1682 struct ext2fs_journal_params *params, ext2_filsys fs);
1683 extern errcode_t ext2fs_zero_blocks(ext2_filsys fs, blk_t blk, int num,
1684 blk_t *ret_blk, int *ret_count);
1685 extern errcode_t ext2fs_zero_blocks2(ext2_filsys fs, blk64_t blk, int num,
1686 blk64_t *ret_blk, int *ret_count);
1687 extern errcode_t ext2fs_create_journal_superblock(ext2_filsys fs,
1688 __u32 num_blocks, int flags,
1690 extern errcode_t ext2fs_create_journal_superblock2(ext2_filsys fs,
1691 struct ext2fs_journal_params *params,
1692 int flags, char **ret_jsb);
1693 extern errcode_t ext2fs_add_journal_device(ext2_filsys fs,
1694 ext2_filsys journal_dev);
1695 extern errcode_t ext2fs_add_journal_inode(ext2_filsys fs, blk_t num_blocks,
1697 extern errcode_t ext2fs_add_journal_inode2(ext2_filsys fs, blk_t num_blocks,
1698 blk64_t goal, int flags);
1699 extern errcode_t ext2fs_add_journal_inode3(ext2_filsys fs,
1700 struct ext2fs_journal_params *params,
1701 blk64_t goal, int flags);
1702 extern int ext2fs_default_journal_size(__u64 num_blocks);
1703 extern int ext2fs_journal_sb_start(int blocksize);
1706 extern errcode_t ext2fs_open(const char *name, int flags, int superblock,
1707 unsigned int block_size, io_manager manager,
1708 ext2_filsys *ret_fs);
1709 extern errcode_t ext2fs_open2(const char *name, const char *io_options,
1710 int flags, int superblock,
1711 unsigned int block_size, io_manager manager,
1712 ext2_filsys *ret_fs);
1713 errcode_t ext2fs_open_channel(ext2_filsys fs, const char *io_options,
1714 io_manager manager, int flags,
1717 * The dgrp_t argument to these two functions is not actually a group number
1718 * but a block number offset within a group table! Convert with the formula
1719 * (group_number / groups_per_block).
1721 extern blk64_t ext2fs_descriptor_block_loc2(ext2_filsys fs,
1722 blk64_t group_block, dgrp_t i);
1723 extern blk_t ext2fs_descriptor_block_loc(ext2_filsys fs, blk_t group_block,
1725 errcode_t ext2fs_get_data_io(ext2_filsys fs, io_channel *old_io);
1726 errcode_t ext2fs_set_data_io(ext2_filsys fs, io_channel new_io);
1727 errcode_t ext2fs_rewrite_to_io(ext2_filsys fs, io_channel new_io);
1729 /* get_pathname.c */
1730 extern errcode_t ext2fs_get_pathname(ext2_filsys fs, ext2_ino_t dir, ext2_ino_t ino,
1734 #define EXT2FS_UNLINK_FORCE 0x1 /* Forcefully unlink even if
1735 * the inode number doesn't
1738 errcode_t ext2fs_link(ext2_filsys fs, ext2_ino_t dir, const char *name,
1739 ext2_ino_t ino, int flags);
1740 errcode_t ext2fs_unlink(ext2_filsys fs, ext2_ino_t dir, const char *name,
1741 ext2_ino_t ino, int flags);
1744 errcode_t ext2fs_symlink(ext2_filsys fs, ext2_ino_t parent, ext2_ino_t ino,
1745 const char *name, const char *target);
1746 int ext2fs_is_fast_symlink(struct ext2_inode *inode);
1749 errcode_t ext2fs_mmp_read(ext2_filsys fs, blk64_t mmp_blk, void *buf);
1750 errcode_t ext2fs_mmp_write(ext2_filsys fs, blk64_t mmp_blk, void *buf);
1751 errcode_t ext2fs_mmp_clear(ext2_filsys fs);
1752 errcode_t ext2fs_mmp_init(ext2_filsys fs);
1753 errcode_t ext2fs_mmp_start(ext2_filsys fs);
1754 errcode_t ext2fs_mmp_update(ext2_filsys fs);
1755 errcode_t ext2fs_mmp_update2(ext2_filsys fs, int immediately);
1756 errcode_t ext2fs_mmp_stop(ext2_filsys fs);
1757 unsigned ext2fs_mmp_new_seq(void);
1760 extern errcode_t ext2fs_read_bb_inode(ext2_filsys fs,
1761 ext2_badblocks_list *bb_list);
1763 /* read_bb_file.c */
1764 extern errcode_t ext2fs_read_bb_FILE2(ext2_filsys fs, FILE *f,
1765 ext2_badblocks_list *bb_list,
1767 void (*invalid)(ext2_filsys fs,
1771 extern errcode_t ext2fs_read_bb_FILE(ext2_filsys fs, FILE *f,
1772 ext2_badblocks_list *bb_list,
1773 void (*invalid)(ext2_filsys fs,
1777 extern errcode_t ext2fs_create_resize_inode(ext2_filsys fs);
1780 extern errcode_t ext2fs_rw_bitmaps(ext2_filsys fs, int flags, int num_threads);
1781 extern errcode_t ext2fs_read_bitmaps(ext2_filsys fs);
1782 extern errcode_t ext2fs_read_inode_bitmap (ext2_filsys fs);
1783 extern errcode_t ext2fs_read_block_bitmap(ext2_filsys fs);
1784 extern errcode_t ext2fs_write_bitmaps(ext2_filsys fs);
1785 extern errcode_t ext2fs_write_inode_bitmap(ext2_filsys fs);
1786 extern errcode_t ext2fs_write_block_bitmap (ext2_filsys fs);
1789 #define EXT2FS_SHA256_LENGTH 32
1791 extern void ext2fs_sha256(const unsigned char *in, unsigned long in_size,
1792 unsigned char out[EXT2FS_SHA256_LENGTH]);
1796 #define EXT2FS_SHA512_LENGTH 64
1797 extern void ext2fs_sha512(const unsigned char *in, unsigned long in_size,
1798 unsigned char out[EXT2FS_SHA512_LENGTH]);
1801 extern errcode_t ext2fs_dirent_swab_in2(ext2_filsys fs, char *buf, size_t size,
1803 extern errcode_t ext2fs_dirent_swab_in(ext2_filsys fs, char *buf, int flags);
1804 extern errcode_t ext2fs_dirent_swab_out2(ext2_filsys fs, char *buf, size_t size,
1806 extern errcode_t ext2fs_dirent_swab_out(ext2_filsys fs, char *buf, int flags);
1807 extern void ext2fs_swap_ext_attr(char *to, char *from, int bufsize,
1809 extern void ext2fs_swap_ext_attr_header(struct ext2_ext_attr_header *to_header,
1810 struct ext2_ext_attr_header *from_hdr);
1811 extern void ext2fs_swap_ext_attr_entry(struct ext2_ext_attr_entry *to_entry,
1812 struct ext2_ext_attr_entry *from_entry);
1813 extern void ext2fs_swap_super(struct ext2_super_block * super);
1814 extern void ext2fs_swap_group_desc(struct ext2_group_desc *gdp);
1815 extern void ext2fs_swap_group_desc2(ext2_filsys, struct ext2_group_desc *gdp);
1816 extern void ext2fs_swap_inode_full(ext2_filsys fs, struct ext2_inode_large *t,
1817 struct ext2_inode_large *f, int hostorder,
1819 extern void ext2fs_swap_inode(ext2_filsys fs,struct ext2_inode *t,
1820 struct ext2_inode *f, int hostorder);
1821 extern void ext2fs_swap_mmp(struct mmp_struct *mmp);
1824 extern int ext2fs_open_file(const char *pathname, int flags, mode_t mode);
1825 extern int ext2fs_stat(const char *path, ext2fs_struct_stat *buf);
1826 extern int ext2fs_fstat(int fd, ext2fs_struct_stat *buf);
1829 extern int ext2fs_inode_has_valid_blocks(struct ext2_inode *inode);
1830 extern int ext2fs_inode_has_valid_blocks2(ext2_filsys fs,
1831 struct ext2_inode *inode);
1834 extern int ext2fs_parse_version_string(const char *ver_string);
1835 extern int ext2fs_get_library_version(const char **ver_string,
1836 const char **date_string);
1838 /* write_bb_file.c */
1839 extern errcode_t ext2fs_write_bb_FILE(ext2_badblocks_list bb_list,
1844 /* inline functions */
1845 #ifdef NO_INLINE_FUNCS
1846 extern errcode_t ext2fs_get_mem(unsigned long size, void *ptr);
1847 extern errcode_t ext2fs_get_memzero(unsigned long size, void *ptr);
1848 extern errcode_t ext2fs_get_array(unsigned long count,
1849 unsigned long size, void *ptr);
1850 extern errcode_t ext2fs_get_arrayzero(unsigned long count,
1851 unsigned long size, void *ptr);
1852 extern errcode_t ext2fs_free_mem(void *ptr);
1853 extern errcode_t ext2fs_resize_mem(unsigned long old_size,
1854 unsigned long size, void *ptr);
1855 extern errcode_t ext2fs_resize_array(unsigned long old_count, unsigned long count,
1856 unsigned long size, void *ptr);
1857 extern void ext2fs_mark_super_dirty(ext2_filsys fs);
1858 extern void ext2fs_mark_changed(ext2_filsys fs);
1859 extern int ext2fs_test_changed(ext2_filsys fs);
1860 extern void ext2fs_mark_valid(ext2_filsys fs);
1861 extern void ext2fs_unmark_valid(ext2_filsys fs);
1862 extern int ext2fs_test_valid(ext2_filsys fs);
1863 extern void ext2fs_mark_ib_dirty(ext2_filsys fs);
1864 extern void ext2fs_mark_bb_dirty(ext2_filsys fs);
1865 extern int ext2fs_test_ib_dirty(ext2_filsys fs);
1866 extern int ext2fs_test_bb_dirty(ext2_filsys fs);
1867 extern dgrp_t ext2fs_group_of_blk(ext2_filsys fs, blk_t blk);
1868 extern dgrp_t ext2fs_group_of_ino(ext2_filsys fs, ext2_ino_t ino);
1869 extern blk_t ext2fs_group_first_block(ext2_filsys fs, dgrp_t group);
1870 extern blk_t ext2fs_group_last_block(ext2_filsys fs, dgrp_t group);
1871 extern blk_t ext2fs_inode_data_blocks(ext2_filsys fs,
1872 struct ext2_inode *inode);
1873 extern int ext2fs_htree_intnode_maxrecs(ext2_filsys fs, int blocks);
1874 extern unsigned int ext2fs_div_ceil(unsigned int a, unsigned int b);
1875 extern __u64 ext2fs_div64_ceil(__u64 a, __u64 b);
1876 extern int ext2fs_dirent_name_len(const struct ext2_dir_entry *entry);
1877 extern void ext2fs_dirent_set_name_len(struct ext2_dir_entry *entry, int len);
1878 extern int ext2fs_dirent_file_type(const struct ext2_dir_entry *entry);
1879 extern void ext2fs_dirent_set_file_type(struct ext2_dir_entry *entry, int type);
1880 extern struct ext2_inode *ext2fs_inode(struct ext2_inode_large * large_inode);
1881 extern const struct ext2_inode *ext2fs_const_inode(const struct ext2_inode_large * large_inode);
1886 * The actual inlined functions definitions themselves...
1888 * If NO_INLINE_FUNCS is defined, then we won't try to do inline
1891 #if (defined(INCLUDE_INLINE_FUNCS) || !defined(NO_INLINE_FUNCS))
1892 #ifdef INCLUDE_INLINE_FUNCS
1893 #define _INLINE_ extern
1895 #if (__STDC_VERSION__ >= 199901L)
1896 #define _INLINE_ inline
1899 #define _INLINE_ extern __inline__
1900 #else /* For Watcom C */
1901 #define _INLINE_ extern inline
1902 #endif /* __GNUC__ */
1903 #endif /* __STDC_VERSION__ >= 199901L */
1906 #ifndef EXT2_CUSTOM_MEMORY_ROUTINES
1909 * Allocate memory. The 'ptr' arg must point to a pointer.
1911 _INLINE_ errcode_t ext2fs_get_mem(unsigned long size, void *ptr)
1917 return EXT2_ET_NO_MEMORY;
1918 memcpy(ptr, &pp, sizeof (pp));
1922 _INLINE_ errcode_t ext2fs_get_memzero(unsigned long size, void *ptr)
1928 return EXT2_ET_NO_MEMORY;
1929 memset(pp, 0, size);
1930 memcpy(ptr, &pp, sizeof(pp));
1934 _INLINE_ errcode_t ext2fs_get_array(unsigned long count, unsigned long size,
1937 if (count && (~0UL)/count < size)
1938 return EXT2_ET_NO_MEMORY;
1939 return ext2fs_get_mem(count*size, ptr);
1942 _INLINE_ errcode_t ext2fs_get_arrayzero(unsigned long count,
1943 unsigned long size, void *ptr)
1945 if (count && (~0UL)/count < size)
1946 return EXT2_ET_NO_MEMORY;
1948 return ext2fs_get_memzero((size_t)count * size, ptr);
1952 * Free memory. The 'ptr' arg must point to a pointer.
1954 _INLINE_ errcode_t ext2fs_free_mem(void *ptr)
1958 memcpy(&p, ptr, sizeof(p));
1961 memcpy(ptr, &p, sizeof(p));
1966 * Resize memory. The 'ptr' arg must point to a pointer.
1968 _INLINE_ errcode_t ext2fs_resize_mem(unsigned long EXT2FS_ATTR((unused)) old_size,
1969 unsigned long size, void *ptr)
1973 /* Use "memcpy" for pointer assignments here to avoid problems
1974 * with C99 strict type aliasing rules. */
1975 memcpy(&p, ptr, sizeof(p));
1976 p = realloc(p, size);
1978 return EXT2_ET_NO_MEMORY;
1979 memcpy(ptr, &p, sizeof(p));
1984 * Resize array. The 'ptr' arg must point to a pointer.
1986 _INLINE_ errcode_t ext2fs_resize_array(unsigned long size,
1987 unsigned long old_count,
1988 unsigned long count, void *ptr)
1990 unsigned long old_size;
1993 if (count && (~0UL)/count < size)
1994 return EXT2_ET_NO_MEMORY;
1997 old_size = size * old_count;
1998 retval = ext2fs_resize_mem(old_size, size, ptr);
2002 if (size > old_size) {
2005 memcpy(&p, ptr, sizeof(p));
2006 memset((char *)p + old_size, 0, size - old_size);
2007 memcpy(ptr, &p, sizeof(p));
2012 #endif /* Custom memory routines */
2015 * Mark a filesystem superblock as dirty
2017 _INLINE_ void ext2fs_mark_super_dirty(ext2_filsys fs)
2019 fs->flags |= EXT2_FLAG_DIRTY | EXT2_FLAG_CHANGED;
2023 * Mark a filesystem as changed
2025 _INLINE_ void ext2fs_mark_changed(ext2_filsys fs)
2027 fs->flags |= EXT2_FLAG_CHANGED;
2031 * Check to see if a filesystem has changed
2033 _INLINE_ int ext2fs_test_changed(ext2_filsys fs)
2035 return (fs->flags & EXT2_FLAG_CHANGED);
2039 * Mark a filesystem as valid
2041 _INLINE_ void ext2fs_mark_valid(ext2_filsys fs)
2043 fs->flags |= EXT2_FLAG_VALID;
2047 * Mark a filesystem as NOT valid
2049 _INLINE_ void ext2fs_unmark_valid(ext2_filsys fs)
2051 fs->flags &= ~EXT2_FLAG_VALID;
2055 * Check to see if a filesystem is valid
2057 _INLINE_ int ext2fs_test_valid(ext2_filsys fs)
2059 return (fs->flags & EXT2_FLAG_VALID);
2063 * Mark the inode bitmap as dirty
2065 _INLINE_ void ext2fs_mark_ib_dirty(ext2_filsys fs)
2067 fs->flags |= EXT2_FLAG_IB_DIRTY | EXT2_FLAG_CHANGED;
2071 * Mark the block bitmap as dirty
2073 _INLINE_ void ext2fs_mark_bb_dirty(ext2_filsys fs)
2075 fs->flags |= EXT2_FLAG_BB_DIRTY | EXT2_FLAG_CHANGED;
2079 * Check to see if a filesystem's inode bitmap is dirty
2081 _INLINE_ int ext2fs_test_ib_dirty(ext2_filsys fs)
2083 return (fs->flags & EXT2_FLAG_IB_DIRTY);
2087 * Check to see if a filesystem's block bitmap is dirty
2089 _INLINE_ int ext2fs_test_bb_dirty(ext2_filsys fs)
2091 return (fs->flags & EXT2_FLAG_BB_DIRTY);
2095 * Return the group # of a block
2097 _INLINE_ dgrp_t ext2fs_group_of_blk(ext2_filsys fs, blk_t blk)
2099 return ext2fs_group_of_blk2(fs, blk);
2102 * Return the group # of an inode number
2104 _INLINE_ dgrp_t ext2fs_group_of_ino(ext2_filsys fs, ext2_ino_t ino)
2106 return (ino - 1) / fs->super->s_inodes_per_group;
2110 * Return the first block (inclusive) in a group
2112 _INLINE_ blk_t ext2fs_group_first_block(ext2_filsys fs, dgrp_t group)
2114 return (blk_t) ext2fs_group_first_block2(fs, group);
2118 * Return the last block (inclusive) in a group
2120 _INLINE_ blk_t ext2fs_group_last_block(ext2_filsys fs, dgrp_t group)
2122 return (blk_t) ext2fs_group_last_block2(fs, group);
2125 _INLINE_ blk_t ext2fs_inode_data_blocks(ext2_filsys fs,
2126 struct ext2_inode *inode)
2128 return (blk_t) ext2fs_inode_data_blocks2(fs, inode);
2131 _INLINE_ int ext2fs_htree_intnode_maxrecs(ext2_filsys fs, int blocks)
2135 if ((EXT2_SB(fs->super)->s_feature_ro_compat &
2136 EXT4_FEATURE_RO_COMPAT_METADATA_CSUM) != 0)
2137 csum_size = sizeof(struct ext2_dx_tail);
2138 return blocks * ((fs->blocksize - (8 + csum_size)) /
2139 sizeof(struct ext2_dx_entry));
2142 _INLINE_ struct ext2_dx_root_info *get_ext2_dx_root_info(ext2_filsys fs,
2145 struct ext2_dir_entry *de = (struct ext2_dir_entry *)buf;
2147 if (!(fs->super->s_feature_incompat & EXT4_FEATURE_INCOMPAT_DIRDATA))
2148 return (struct ext2_dx_root_info *)(buf +
2149 EXT2_DIR_NAME_LEN(1) +
2150 EXT2_DIR_NAME_LEN(2));
2152 /* get dotdot first */
2153 de = (struct ext2_dir_entry *)((char *)de + de->rec_len);
2155 /* dx root info is after dotdot entry */
2156 de = (struct ext2_dir_entry *)((char *)de + EXT2_DIR_REC_LEN(de));
2158 return (struct ext2_dx_root_info *)de;
2162 * This is an efficient, overflow safe way of calculating ceil((1.0 * a) / b)
2164 _INLINE_ unsigned int ext2fs_div_ceil(unsigned int a, unsigned int b)
2168 return ((a - 1) / b) + 1;
2171 _INLINE_ __u64 ext2fs_div64_ceil(__u64 a, __u64 b)
2175 return ((a - 1) / b) + 1;
2178 _INLINE_ int ext2fs_dirent_name_len(const struct ext2_dir_entry *entry)
2180 return entry->name_len & EXT2_NAME_LEN;
2183 _INLINE_ void ext2fs_dirent_set_name_len(struct ext2_dir_entry *entry, int len)
2185 entry->name_len = (entry->name_len & 0xff00) | (len & 0xff);
2188 _INLINE_ int ext2fs_dirent_file_type(const struct ext2_dir_entry *entry)
2190 return entry->name_len >> 8;
2193 _INLINE_ void ext2fs_dirent_set_file_type(struct ext2_dir_entry *entry, int type)
2195 entry->name_len = (entry->name_len & 0xff) | (type << 8);
2198 _INLINE_ struct ext2_inode *ext2fs_inode(struct ext2_inode_large * large_inode)
2200 /* It is always safe to convert large inode to a small inode */
2201 return (struct ext2_inode *) large_inode;
2204 _INLINE_ const struct ext2_inode *
2205 ext2fs_const_inode(const struct ext2_inode_large * large_inode)
2207 /* It is always safe to convert large inode to a small inode */
2208 return (const struct ext2_inode *) large_inode;
2211 static dgrp_t ext2fs_get_avg_group(ext2_filsys fs)
2214 dgrp_t average_group;
2215 unsigned flexbg_size;
2217 if (fs->fs_num_threads <= 1)
2218 return fs->group_desc_count;
2220 average_group = fs->group_desc_count / fs->fs_num_threads;
2221 if (average_group <= 1)
2224 if (ext2fs_has_feature_flex_bg(fs->super)) {
2227 flexbg_size = 1 << fs->super->s_log_groups_per_flex;
2228 if (average_group % flexbg_size) {
2229 times = average_group / flexbg_size;
2230 average_group = times * flexbg_size;
2234 return average_group;
2236 return fs->group_desc_count;
2243 /* htree levels for ext4 */
2244 #define EXT4_HTREE_LEVEL_COMPAT 2
2245 #define EXT4_HTREE_LEVEL 3
2247 static inline unsigned int ext2_dir_htree_level(ext2_filsys fs)
2249 if (ext2fs_has_feature_largedir(fs->super))
2250 return EXT4_HTREE_LEVEL;
2252 return EXT4_HTREE_LEVEL_COMPAT;
2259 #endif /* _EXT2FS_EXT2FS_H */