]> git.ipfire.org Git - thirdparty/e2fsprogs.git/blob - lib/ext2fs/ext2fs.h
Merge branch 'maint' into next
[thirdparty/e2fsprogs.git] / lib / ext2fs / ext2fs.h
1 /*
2 * ext2fs.h --- ext2fs
3 *
4 * Copyright (C) 1993, 1994, 1995, 1996 Theodore Ts'o.
5 *
6 * %Begin-Header%
7 * This file may be redistributed under the terms of the GNU Library
8 * General Public License, version 2.
9 * %End-Header%
10 */
11
12 #ifndef _EXT2FS_EXT2FS_H
13 #define _EXT2FS_EXT2FS_H
14
15 #ifdef __GNUC__
16 #define EXT2FS_ATTR(x) __attribute__(x)
17 #else
18 #define EXT2FS_ATTR(x)
19 #endif
20
21 #ifdef __cplusplus
22 extern "C" {
23 #endif
24
25 /*
26 * Non-GNU C compilers won't necessarily understand inline
27 */
28 #if (!defined(__GNUC__) && !defined(__WATCOMC__))
29 #define NO_INLINE_FUNCS
30 #endif
31
32 /*
33 * Where the master copy of the superblock is located, and how big
34 * superblocks are supposed to be. We define SUPERBLOCK_SIZE because
35 * the size of the superblock structure is not necessarily trustworthy
36 * (some versions have the padding set up so that the superblock is
37 * 1032 bytes long).
38 */
39 #define SUPERBLOCK_OFFSET 1024
40 #define SUPERBLOCK_SIZE 1024
41
42 #define UUID_STR_SIZE 37
43
44 /*
45 * The last ext2fs revision level that this version of the library is
46 * able to support.
47 */
48 #define EXT2_LIB_CURRENT_REV EXT2_DYNAMIC_REV
49
50 #ifdef HAVE_SYS_TYPES_H
51 #include <sys/types.h>
52 #endif
53
54 #include <stdio.h>
55 #include <stdlib.h>
56 #include <string.h>
57 #include <errno.h>
58
59 #if EXT2_FLAT_INCLUDES
60 #include "e2_types.h"
61 #include "ext2_fs.h"
62 #include "ext3_extents.h"
63 #else
64 #include <ext2fs/ext2_types.h>
65 #include <ext2fs/ext2_fs.h>
66 #include <ext2fs/ext3_extents.h>
67 #endif /* EXT2_FLAT_INCLUDES */
68
69 typedef __u32 __bitwise ext2_ino_t;
70 typedef __u32 __bitwise blk_t;
71 typedef __u64 __bitwise blk64_t;
72 typedef __u32 __bitwise dgrp_t;
73 typedef __u32 __bitwise ext2_off_t;
74 typedef __u64 __bitwise ext2_off64_t;
75 typedef __s64 __bitwise e2_blkcnt_t;
76 typedef __u32 __bitwise ext2_dirhash_t;
77
78 #if EXT2_FLAT_INCLUDES
79 #include "com_err.h"
80 #include "ext2_io.h"
81 #include "ext2_err.h"
82 #include "ext2_ext_attr.h"
83 #else
84 #include <et/com_err.h>
85 #include <ext2fs/ext2_io.h>
86 #include <ext2fs/ext2_err.h>
87 #include <ext2fs/ext2_ext_attr.h>
88 #endif
89
90 /*
91 * Portability help for Microsoft Visual C++
92 */
93 #ifdef _MSC_VER
94 #define EXT2_QSORT_TYPE int __cdecl
95 #else
96 #define EXT2_QSORT_TYPE int
97 #endif
98
99 typedef struct struct_ext2_filsys *ext2_filsys;
100
101 #define EXT2FS_MARK_ERROR 0
102 #define EXT2FS_UNMARK_ERROR 1
103 #define EXT2FS_TEST_ERROR 2
104
105 typedef struct ext2fs_struct_generic_bitmap *ext2fs_generic_bitmap;
106 typedef struct ext2fs_struct_generic_bitmap *ext2fs_inode_bitmap;
107 typedef struct ext2fs_struct_generic_bitmap *ext2fs_block_bitmap;
108
109 #define EXT2_FIRST_INODE(s) EXT2_FIRST_INO(s)
110
111
112 /*
113 * Badblocks list definitions
114 */
115
116 typedef struct ext2_struct_u32_list *ext2_badblocks_list;
117 typedef struct ext2_struct_u32_iterate *ext2_badblocks_iterate;
118
119 typedef struct ext2_struct_u32_list *ext2_u32_list;
120 typedef struct ext2_struct_u32_iterate *ext2_u32_iterate;
121
122 /* old */
123 typedef struct ext2_struct_u32_list *badblocks_list;
124 typedef struct ext2_struct_u32_iterate *badblocks_iterate;
125
126 #define BADBLOCKS_FLAG_DIRTY 1
127
128 /*
129 * ext2_dblist structure and abstractions (see dblist.c)
130 */
131 struct ext2_db_entry2 {
132 ext2_ino_t ino;
133 blk64_t blk;
134 e2_blkcnt_t blockcnt;
135 };
136
137 /* Ye Olde 32-bit version */
138 struct ext2_db_entry {
139 ext2_ino_t ino;
140 blk_t blk;
141 int blockcnt;
142 };
143
144 typedef struct ext2_struct_dblist *ext2_dblist;
145
146 #define DBLIST_ABORT 1
147
148 /*
149 * ext2_fileio definitions
150 */
151
152 #define EXT2_FILE_WRITE 0x0001
153 #define EXT2_FILE_CREATE 0x0002
154
155 #define EXT2_FILE_MASK 0x00FF
156
157 #define EXT2_FILE_BUF_DIRTY 0x4000
158 #define EXT2_FILE_BUF_VALID 0x2000
159
160 typedef struct ext2_file *ext2_file_t;
161
162 #define EXT2_SEEK_SET 0
163 #define EXT2_SEEK_CUR 1
164 #define EXT2_SEEK_END 2
165
166 /*
167 * Flags for the ext2_filsys structure and for ext2fs_open()
168 */
169 #define EXT2_FLAG_RW 0x01
170 #define EXT2_FLAG_CHANGED 0x02
171 #define EXT2_FLAG_DIRTY 0x04
172 #define EXT2_FLAG_VALID 0x08
173 #define EXT2_FLAG_IB_DIRTY 0x10
174 #define EXT2_FLAG_BB_DIRTY 0x20
175 #define EXT2_FLAG_SWAP_BYTES 0x40
176 #define EXT2_FLAG_SWAP_BYTES_READ 0x80
177 #define EXT2_FLAG_SWAP_BYTES_WRITE 0x100
178 #define EXT2_FLAG_MASTER_SB_ONLY 0x200
179 #define EXT2_FLAG_FORCE 0x400
180 #define EXT2_FLAG_SUPER_ONLY 0x800
181 #define EXT2_FLAG_JOURNAL_DEV_OK 0x1000
182 #define EXT2_FLAG_IMAGE_FILE 0x2000
183 #define EXT2_FLAG_EXCLUSIVE 0x4000
184 #define EXT2_FLAG_SOFTSUPP_FEATURES 0x8000
185 #define EXT2_FLAG_NOFREE_ON_ERROR 0x10000
186 #define EXT2_FLAG_64BITS 0x20000
187 #define EXT2_FLAG_PRINT_PROGRESS 0x40000
188 #define EXT2_FLAG_DIRECT_IO 0x80000
189 #define EXT2_FLAG_SKIP_MMP 0x100000
190 #define EXT2_FLAG_IGNORE_CSUM_ERRORS 0x200000
191
192 /*
193 * Special flag in the ext2 inode i_flag field that means that this is
194 * a new inode. (So that ext2_write_inode() can clear extra fields.)
195 */
196 #define EXT2_NEW_INODE_FL 0x80000000
197
198 /*
199 * Flags for mkjournal
200 */
201 #define EXT2_MKJOURNAL_V1_SUPER 0x0000001 /* create V1 superblock (deprecated) */
202 #define EXT2_MKJOURNAL_LAZYINIT 0x0000002 /* don't zero journal inode before use*/
203 #define EXT2_MKJOURNAL_NO_MNT_CHECK 0x0000004 /* don't check mount status */
204
205 struct opaque_ext2_group_desc;
206
207 struct struct_ext2_filsys {
208 errcode_t magic;
209 io_channel io;
210 int flags;
211 char * device_name;
212 struct ext2_super_block * super;
213 unsigned int blocksize;
214 int fragsize;
215 dgrp_t group_desc_count;
216 unsigned long desc_blocks;
217 struct opaque_ext2_group_desc * group_desc;
218 unsigned int inode_blocks_per_group;
219 ext2fs_inode_bitmap inode_map;
220 ext2fs_block_bitmap block_map;
221 /* XXX FIXME-64: not 64-bit safe, but not used? */
222 errcode_t (*get_blocks)(ext2_filsys fs, ext2_ino_t ino, blk_t *blocks);
223 errcode_t (*check_directory)(ext2_filsys fs, ext2_ino_t ino);
224 errcode_t (*write_bitmaps)(ext2_filsys fs);
225 errcode_t (*read_inode)(ext2_filsys fs, ext2_ino_t ino,
226 struct ext2_inode *inode);
227 errcode_t (*write_inode)(ext2_filsys fs, ext2_ino_t ino,
228 struct ext2_inode *inode);
229 ext2_badblocks_list badblocks;
230 ext2_dblist dblist;
231 __u32 stride; /* for mke2fs */
232 struct ext2_super_block * orig_super;
233 struct ext2_image_hdr * image_header;
234 __u32 umask;
235 time_t now;
236 int cluster_ratio_bits;
237 __u16 default_bitmap_type;
238 __u16 pad;
239 /*
240 * Reserved for future expansion
241 */
242 __u32 reserved[5];
243
244 /*
245 * Reserved for the use of the calling application.
246 */
247 void * priv_data;
248
249 /*
250 * Inode cache
251 */
252 struct ext2_inode_cache *icache;
253 io_channel image_io;
254
255 /*
256 * More callback functions
257 */
258 errcode_t (*get_alloc_block)(ext2_filsys fs, blk64_t goal,
259 blk64_t *ret);
260 void (*block_alloc_stats)(ext2_filsys fs, blk64_t blk, int inuse);
261
262 /*
263 * Buffers for Multiple mount protection(MMP) block.
264 */
265 void *mmp_buf;
266 void *mmp_cmp;
267 int mmp_fd;
268
269 /*
270 * Time at which e2fsck last updated the MMP block.
271 */
272 long mmp_last_written;
273
274 /* progress operation functions */
275 struct ext2fs_progress_ops *progress_ops;
276
277 /* Precomputed FS UUID checksum for seeding other checksums */
278 __u32 csum_seed;
279
280 io_channel journal_io;
281 char *journal_name;
282
283 /* New block range allocation hooks */
284 errcode_t (*new_range)(ext2_filsys fs, int flags, blk64_t goal,
285 blk64_t len, blk64_t *pblk, blk64_t *plen);
286 void (*block_alloc_stats_range)(ext2_filsys fs, blk64_t blk, blk_t num,
287 int inuse);
288 };
289
290 #if EXT2_FLAT_INCLUDES
291 #include "e2_bitops.h"
292 #else
293 #include <ext2fs/bitops.h>
294 #endif
295
296 /*
297 * 64-bit bitmap backend types
298 */
299 #define EXT2FS_BMAP64_BITARRAY 1
300 #define EXT2FS_BMAP64_RBTREE 2
301 #define EXT2FS_BMAP64_AUTODIR 3
302
303 /*
304 * Return flags for the block iterator functions
305 */
306 #define BLOCK_CHANGED 1
307 #define BLOCK_ABORT 2
308 #define BLOCK_ERROR 4
309 #define BLOCK_INLINE_DATA_CHANGED 8
310
311 /*
312 * Block interate flags
313 *
314 * BLOCK_FLAG_APPEND, or BLOCK_FLAG_HOLE, indicates that the interator
315 * function should be called on blocks where the block number is zero.
316 * This is used by ext2fs_expand_dir() to be able to add a new block
317 * to an inode. It can also be used for programs that want to be able
318 * to deal with files that contain "holes".
319 *
320 * BLOCK_FLAG_DEPTH_TRAVERSE indicates that the iterator function for
321 * the indirect, doubly indirect, etc. blocks should be called after
322 * all of the blocks containined in the indirect blocks are processed.
323 * This is useful if you are going to be deallocating blocks from an
324 * inode.
325 *
326 * BLOCK_FLAG_DATA_ONLY indicates that the iterator function should be
327 * called for data blocks only.
328 *
329 * BLOCK_FLAG_READ_ONLY is a promise by the caller that it will not
330 * modify returned block number.
331 *
332 * BLOCK_FLAG_NO_LARGE is for internal use only. It informs
333 * ext2fs_block_iterate2 that large files won't be accepted.
334 */
335 #define BLOCK_FLAG_APPEND 1
336 #define BLOCK_FLAG_HOLE 1
337 #define BLOCK_FLAG_DEPTH_TRAVERSE 2
338 #define BLOCK_FLAG_DATA_ONLY 4
339 #define BLOCK_FLAG_READ_ONLY 8
340
341 #define BLOCK_FLAG_NO_LARGE 0x1000
342
343 /*
344 * Magic "block count" return values for the block iterator function.
345 */
346 #define BLOCK_COUNT_IND (-1)
347 #define BLOCK_COUNT_DIND (-2)
348 #define BLOCK_COUNT_TIND (-3)
349 #define BLOCK_COUNT_TRANSLATOR (-4)
350
351 #if 0
352 /*
353 * Flags for ext2fs_move_blocks
354 */
355 #define EXT2_BMOVE_GET_DBLIST 0x0001
356 #define EXT2_BMOVE_DEBUG 0x0002
357 #endif
358
359 /*
360 * Generic (non-filesystem layout specific) extents structure
361 */
362
363 #define EXT2_EXTENT_FLAGS_LEAF 0x0001
364 #define EXT2_EXTENT_FLAGS_UNINIT 0x0002
365 #define EXT2_EXTENT_FLAGS_SECOND_VISIT 0x0004
366
367 struct ext2fs_extent {
368 blk64_t e_pblk; /* first physical block */
369 blk64_t e_lblk; /* first logical block extent covers */
370 __u32 e_len; /* number of blocks covered by extent */
371 __u32 e_flags; /* extent flags */
372 };
373
374 typedef struct ext2_extent_handle *ext2_extent_handle_t;
375 typedef struct ext2_extent_path *ext2_extent_path_t;
376
377 /*
378 * Flags used by ext2fs_extent_get()
379 */
380 #define EXT2_EXTENT_CURRENT 0x0000
381 #define EXT2_EXTENT_MOVE_MASK 0x000F
382 #define EXT2_EXTENT_ROOT 0x0001
383 #define EXT2_EXTENT_LAST_LEAF 0x0002
384 #define EXT2_EXTENT_FIRST_SIB 0x0003
385 #define EXT2_EXTENT_LAST_SIB 0x0004
386 #define EXT2_EXTENT_NEXT_SIB 0x0005
387 #define EXT2_EXTENT_PREV_SIB 0x0006
388 #define EXT2_EXTENT_NEXT_LEAF 0x0007
389 #define EXT2_EXTENT_PREV_LEAF 0x0008
390 #define EXT2_EXTENT_NEXT 0x0009
391 #define EXT2_EXTENT_PREV 0x000A
392 #define EXT2_EXTENT_UP 0x000B
393 #define EXT2_EXTENT_DOWN 0x000C
394 #define EXT2_EXTENT_DOWN_AND_LAST 0x000D
395
396 /*
397 * Flags used by ext2fs_extent_insert()
398 */
399 #define EXT2_EXTENT_INSERT_AFTER 0x0001 /* insert after handle loc'n */
400 #define EXT2_EXTENT_INSERT_NOSPLIT 0x0002 /* insert may not cause split */
401
402 /*
403 * Flags used by ext2fs_extent_delete()
404 */
405 #define EXT2_EXTENT_DELETE_KEEP_EMPTY 0x001 /* keep node if last extnt gone */
406
407 /*
408 * Flags used by ext2fs_extent_set_bmap()
409 */
410 #define EXT2_EXTENT_SET_BMAP_UNINIT 0x0001
411
412 /*
413 * Data structure returned by ext2fs_extent_get_info()
414 */
415 struct ext2_extent_info {
416 int curr_entry;
417 int curr_level;
418 int num_entries;
419 int max_entries;
420 int max_depth;
421 int bytes_avail;
422 blk64_t max_lblk;
423 blk64_t max_pblk;
424 __u32 max_len;
425 __u32 max_uninit_len;
426 };
427
428 /*
429 * Flags for directory block reading and writing functions
430 */
431 #define EXT2_DIRBLOCK_V2_STRUCT 0x0001
432
433 /*
434 * Return flags for the directory iterator functions
435 */
436 #define DIRENT_CHANGED 1
437 #define DIRENT_ABORT 2
438 #define DIRENT_ERROR 3
439
440 /*
441 * Directory iterator flags
442 */
443
444 #define DIRENT_FLAG_INCLUDE_EMPTY 1
445 #define DIRENT_FLAG_INCLUDE_REMOVED 2
446 #define DIRENT_FLAG_INCLUDE_CSUM 4
447 #define DIRENT_FLAG_INCLUDE_INLINE_DATA 8
448
449 #define DIRENT_DOT_FILE 1
450 #define DIRENT_DOT_DOT_FILE 2
451 #define DIRENT_OTHER_FILE 3
452 #define DIRENT_DELETED_FILE 4
453 #define DIRENT_CHECKSUM 5
454
455 /*
456 * Inode scan definitions
457 */
458 typedef struct ext2_struct_inode_scan *ext2_inode_scan;
459
460 /*
461 * ext2fs_scan flags
462 */
463 #define EXT2_SF_CHK_BADBLOCKS 0x0001
464 #define EXT2_SF_BAD_INODE_BLK 0x0002
465 #define EXT2_SF_BAD_EXTRA_BYTES 0x0004
466 #define EXT2_SF_SKIP_MISSING_ITABLE 0x0008
467 #define EXT2_SF_DO_LAZY 0x0010
468 #define EXT2_SF_WARN_GARBAGE_INODES 0x0020
469
470 /*
471 * ext2fs_check_if_mounted flags
472 */
473 #define EXT2_MF_MOUNTED 1
474 #define EXT2_MF_ISROOT 2
475 #define EXT2_MF_READONLY 4
476 #define EXT2_MF_SWAP 8
477 #define EXT2_MF_BUSY 16
478
479 /*
480 * Ext2/linux mode flags. We define them here so that we don't need
481 * to depend on the OS's sys/stat.h, since we may be compiling on a
482 * non-Linux system.
483 */
484 #define LINUX_S_IFMT 00170000
485 #define LINUX_S_IFSOCK 0140000
486 #define LINUX_S_IFLNK 0120000
487 #define LINUX_S_IFREG 0100000
488 #define LINUX_S_IFBLK 0060000
489 #define LINUX_S_IFDIR 0040000
490 #define LINUX_S_IFCHR 0020000
491 #define LINUX_S_IFIFO 0010000
492 #define LINUX_S_ISUID 0004000
493 #define LINUX_S_ISGID 0002000
494 #define LINUX_S_ISVTX 0001000
495
496 #define LINUX_S_IRWXU 00700
497 #define LINUX_S_IRUSR 00400
498 #define LINUX_S_IWUSR 00200
499 #define LINUX_S_IXUSR 00100
500
501 #define LINUX_S_IRWXG 00070
502 #define LINUX_S_IRGRP 00040
503 #define LINUX_S_IWGRP 00020
504 #define LINUX_S_IXGRP 00010
505
506 #define LINUX_S_IRWXO 00007
507 #define LINUX_S_IROTH 00004
508 #define LINUX_S_IWOTH 00002
509 #define LINUX_S_IXOTH 00001
510
511 #define LINUX_S_ISLNK(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFLNK)
512 #define LINUX_S_ISREG(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFREG)
513 #define LINUX_S_ISDIR(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFDIR)
514 #define LINUX_S_ISCHR(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFCHR)
515 #define LINUX_S_ISBLK(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFBLK)
516 #define LINUX_S_ISFIFO(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFIFO)
517 #define LINUX_S_ISSOCK(m) (((m) & LINUX_S_IFMT) == LINUX_S_IFSOCK)
518
519 /*
520 * ext2 size of an inode
521 */
522 #define EXT2_I_SIZE(i) ((i)->i_size | ((__u64) (i)->i_size_high << 32))
523
524 /*
525 * ext2_icount_t abstraction
526 */
527 #define EXT2_ICOUNT_OPT_INCREMENT 0x01
528
529 typedef struct ext2_icount *ext2_icount_t;
530
531 /*
532 * Flags for ext2fs_bmap
533 */
534 #define BMAP_ALLOC 0x0001
535 #define BMAP_SET 0x0002
536 #define BMAP_UNINIT 0x0004
537 #define BMAP_ZERO 0x0008
538
539 /*
540 * Returned flags from ext2fs_bmap
541 */
542 #define BMAP_RET_UNINIT 0x0001
543
544 /*
545 * Flags for imager.c functions
546 */
547 #define IMAGER_FLAG_INODEMAP 1
548 #define IMAGER_FLAG_SPARSEWRITE 2
549
550 /*
551 * For checking structure magic numbers...
552 */
553
554 #define EXT2_CHECK_MAGIC(struct, code) \
555 if ((struct)->magic != (code)) return (code)
556
557 /*
558 * Features supported by this version of the library
559 */
560 #define EXT2_LIB_FEATURE_COMPAT_SUPP (EXT2_FEATURE_COMPAT_DIR_PREALLOC|\
561 EXT2_FEATURE_COMPAT_IMAGIC_INODES|\
562 EXT3_FEATURE_COMPAT_HAS_JOURNAL|\
563 EXT2_FEATURE_COMPAT_RESIZE_INODE|\
564 EXT2_FEATURE_COMPAT_DIR_INDEX|\
565 EXT2_FEATURE_COMPAT_EXT_ATTR|\
566 EXT4_FEATURE_COMPAT_SPARSE_SUPER2)
567
568 #ifdef CONFIG_MMP
569 #define EXT4_LIB_INCOMPAT_MMP EXT4_FEATURE_INCOMPAT_MMP
570 #else
571 #define EXT4_LIB_INCOMPAT_MMP (0)
572 #endif
573
574 #ifdef CONFIG_QUOTA
575 #define EXT4_LIB_RO_COMPAT_QUOTA EXT4_FEATURE_RO_COMPAT_QUOTA
576 #else
577 #define EXT4_LIB_RO_COMPAT_QUOTA (0)
578 #endif
579
580 #define EXT2_LIB_FEATURE_INCOMPAT_SUPP (EXT2_FEATURE_INCOMPAT_FILETYPE|\
581 EXT3_FEATURE_INCOMPAT_JOURNAL_DEV|\
582 EXT2_FEATURE_INCOMPAT_META_BG|\
583 EXT3_FEATURE_INCOMPAT_RECOVER|\
584 EXT3_FEATURE_INCOMPAT_EXTENTS|\
585 EXT4_FEATURE_INCOMPAT_FLEX_BG|\
586 EXT4_LIB_INCOMPAT_MMP|\
587 EXT4_FEATURE_INCOMPAT_64BIT|\
588 EXT4_FEATURE_INCOMPAT_INLINE_DATA|\
589 EXT4_FEATURE_INCOMPAT_ENCRYPT)
590
591 #define EXT2_LIB_FEATURE_RO_COMPAT_SUPP (EXT2_FEATURE_RO_COMPAT_SPARSE_SUPER|\
592 EXT4_FEATURE_RO_COMPAT_HUGE_FILE|\
593 EXT2_FEATURE_RO_COMPAT_LARGE_FILE|\
594 EXT4_FEATURE_RO_COMPAT_DIR_NLINK|\
595 EXT4_FEATURE_RO_COMPAT_EXTRA_ISIZE|\
596 EXT4_FEATURE_RO_COMPAT_GDT_CSUM|\
597 EXT4_FEATURE_RO_COMPAT_BIGALLOC|\
598 EXT4_LIB_RO_COMPAT_QUOTA|\
599 EXT4_FEATURE_RO_COMPAT_METADATA_CSUM|\
600 EXT4_FEATURE_RO_COMPAT_READONLY)
601
602 /*
603 * These features are only allowed if EXT2_FLAG_SOFTSUPP_FEATURES is passed
604 * to ext2fs_openfs()
605 */
606 #define EXT2_LIB_SOFTSUPP_INCOMPAT (0)
607 #define EXT2_LIB_SOFTSUPP_RO_COMPAT (EXT4_FEATURE_RO_COMPAT_REPLICA)
608
609
610 /* Translate a block number to a cluster number */
611 #define EXT2FS_CLUSTER_RATIO(fs) (1 << (fs)->cluster_ratio_bits)
612 #define EXT2FS_CLUSTER_MASK(fs) (EXT2FS_CLUSTER_RATIO(fs) - 1)
613 #define EXT2FS_B2C(fs, blk) ((blk) >> (fs)->cluster_ratio_bits)
614 /* Translate a cluster number to a block number */
615 #define EXT2FS_C2B(fs, cluster) ((cluster) << (fs)->cluster_ratio_bits)
616 /* Translate # of blks to # of clusters */
617 #define EXT2FS_NUM_B2C(fs, blks) (((blks) + EXT2FS_CLUSTER_MASK(fs)) >> \
618 (fs)->cluster_ratio_bits)
619
620 #if defined(HAVE_FSTAT64) && !defined(__OSX_AVAILABLE_BUT_DEPRECATED)
621 typedef struct stat64 ext2fs_struct_stat;
622 #else
623 typedef struct stat ext2fs_struct_stat;
624 #endif
625
626 /*
627 * For ext2fs_close2() and ext2fs_flush2(), this flag allows you to
628 * avoid the fsync call.
629 */
630 #define EXT2_FLAG_FLUSH_NO_SYNC 1
631
632 /*
633 * Modify and iterate extended attributes
634 */
635 struct ext2_xattr_handle;
636 #define XATTR_ABORT 1
637 #define XATTR_CHANGED 2
638
639 /*
640 * function prototypes
641 */
642 static inline int ext2fs_has_group_desc_csum(ext2_filsys fs)
643 {
644 return EXT2_HAS_RO_COMPAT_FEATURE(fs->super,
645 EXT4_FEATURE_RO_COMPAT_GDT_CSUM |
646 EXT4_FEATURE_RO_COMPAT_METADATA_CSUM);
647 }
648
649 /* The LARGE_FILE feature should be set if we have stored files 2GB+ in size */
650 static inline int ext2fs_needs_large_file_feature(unsigned long long file_size)
651 {
652 return file_size >= 0x80000000ULL;
653 }
654
655 /* alloc.c */
656 extern errcode_t ext2fs_new_inode(ext2_filsys fs, ext2_ino_t dir, int mode,
657 ext2fs_inode_bitmap map, ext2_ino_t *ret);
658 extern errcode_t ext2fs_new_block(ext2_filsys fs, blk_t goal,
659 ext2fs_block_bitmap map, blk_t *ret);
660 extern errcode_t ext2fs_new_block2(ext2_filsys fs, blk64_t goal,
661 ext2fs_block_bitmap map, blk64_t *ret);
662 extern errcode_t ext2fs_get_free_blocks(ext2_filsys fs, blk_t start,
663 blk_t finish, int num,
664 ext2fs_block_bitmap map,
665 blk_t *ret);
666 extern errcode_t ext2fs_get_free_blocks2(ext2_filsys fs, blk64_t start,
667 blk64_t finish, int num,
668 ext2fs_block_bitmap map,
669 blk64_t *ret);
670 extern errcode_t ext2fs_alloc_block(ext2_filsys fs, blk_t goal,
671 char *block_buf, blk_t *ret);
672 extern errcode_t ext2fs_alloc_block2(ext2_filsys fs, blk64_t goal,
673 char *block_buf, blk64_t *ret);
674 extern void ext2fs_set_alloc_block_callback(ext2_filsys fs,
675 errcode_t (*func)(ext2_filsys fs,
676 blk64_t goal,
677 blk64_t *ret),
678 errcode_t (**old)(ext2_filsys fs,
679 blk64_t goal,
680 blk64_t *ret));
681 blk64_t ext2fs_find_inode_goal(ext2_filsys fs, ext2_ino_t ino,
682 struct ext2_inode *inode, blk64_t lblk);
683 extern void ext2fs_set_new_range_callback(ext2_filsys fs,
684 errcode_t (*func)(ext2_filsys fs, int flags, blk64_t goal,
685 blk64_t len, blk64_t *pblk, blk64_t *plen),
686 errcode_t (**old)(ext2_filsys fs, int flags, blk64_t goal,
687 blk64_t len, blk64_t *pblk, blk64_t *plen));
688 extern void ext2fs_set_block_alloc_stats_range_callback(ext2_filsys fs,
689 void (*func)(ext2_filsys fs, blk64_t blk,
690 blk_t num, int inuse),
691 void (**old)(ext2_filsys fs, blk64_t blk,
692 blk_t num, int inuse));
693 #define EXT2_NEWRANGE_FIXED_GOAL (0x1)
694 #define EXT2_NEWRANGE_MIN_LENGTH (0x2)
695 #define EXT2_NEWRANGE_ALL_FLAGS (0x3)
696 errcode_t ext2fs_new_range(ext2_filsys fs, int flags, blk64_t goal,
697 blk64_t len, ext2fs_block_bitmap map, blk64_t *pblk,
698 blk64_t *plen);
699 #define EXT2_ALLOCRANGE_FIXED_GOAL (0x1)
700 #define EXT2_ALLOCRANGE_ZERO_BLOCKS (0x2)
701 #define EXT2_ALLOCRANGE_ALL_FLAGS (0x3)
702 errcode_t ext2fs_alloc_range(ext2_filsys fs, int flags, blk64_t goal,
703 blk_t len, blk64_t *ret);
704
705 /* alloc_sb.c */
706 extern int ext2fs_reserve_super_and_bgd(ext2_filsys fs,
707 dgrp_t group,
708 ext2fs_block_bitmap bmap);
709 extern void ext2fs_set_block_alloc_stats_callback(ext2_filsys fs,
710 void (*func)(ext2_filsys fs,
711 blk64_t blk,
712 int inuse),
713 void (**old)(ext2_filsys fs,
714 blk64_t blk,
715 int inuse));
716
717 /* alloc_stats.c */
718 void ext2fs_inode_alloc_stats(ext2_filsys fs, ext2_ino_t ino, int inuse);
719 void ext2fs_inode_alloc_stats2(ext2_filsys fs, ext2_ino_t ino,
720 int inuse, int isdir);
721 void ext2fs_block_alloc_stats(ext2_filsys fs, blk_t blk, int inuse);
722 void ext2fs_block_alloc_stats2(ext2_filsys fs, blk64_t blk, int inuse);
723 void ext2fs_block_alloc_stats_range(ext2_filsys fs, blk64_t blk,
724 blk_t num, int inuse);
725
726 /* alloc_tables.c */
727 extern errcode_t ext2fs_allocate_tables(ext2_filsys fs);
728 extern errcode_t ext2fs_allocate_group_table(ext2_filsys fs, dgrp_t group,
729 ext2fs_block_bitmap bmap);
730
731 /* badblocks.c */
732 extern errcode_t ext2fs_u32_list_create(ext2_u32_list *ret, int size);
733 extern errcode_t ext2fs_u32_list_add(ext2_u32_list bb, __u32 blk);
734 extern int ext2fs_u32_list_find(ext2_u32_list bb, __u32 blk);
735 extern int ext2fs_u32_list_test(ext2_u32_list bb, blk_t blk);
736 extern errcode_t ext2fs_u32_list_iterate_begin(ext2_u32_list bb,
737 ext2_u32_iterate *ret);
738 extern int ext2fs_u32_list_iterate(ext2_u32_iterate iter, blk_t *blk);
739 extern void ext2fs_u32_list_iterate_end(ext2_u32_iterate iter);
740 extern errcode_t ext2fs_u32_copy(ext2_u32_list src, ext2_u32_list *dest);
741 extern int ext2fs_u32_list_equal(ext2_u32_list bb1, ext2_u32_list bb2);
742
743 extern errcode_t ext2fs_badblocks_list_create(ext2_badblocks_list *ret,
744 int size);
745 extern errcode_t ext2fs_badblocks_list_add(ext2_badblocks_list bb,
746 blk_t blk);
747 extern int ext2fs_badblocks_list_test(ext2_badblocks_list bb,
748 blk_t blk);
749 extern int ext2fs_u32_list_del(ext2_u32_list bb, __u32 blk);
750 extern void ext2fs_badblocks_list_del(ext2_u32_list bb, __u32 blk);
751 extern errcode_t
752 ext2fs_badblocks_list_iterate_begin(ext2_badblocks_list bb,
753 ext2_badblocks_iterate *ret);
754 extern int ext2fs_badblocks_list_iterate(ext2_badblocks_iterate iter,
755 blk_t *blk);
756 extern void ext2fs_badblocks_list_iterate_end(ext2_badblocks_iterate iter);
757 extern errcode_t ext2fs_badblocks_copy(ext2_badblocks_list src,
758 ext2_badblocks_list *dest);
759 extern int ext2fs_badblocks_equal(ext2_badblocks_list bb1,
760 ext2_badblocks_list bb2);
761 extern int ext2fs_u32_list_count(ext2_u32_list bb);
762
763 /* bb_compat */
764 extern errcode_t badblocks_list_create(badblocks_list *ret, int size);
765 extern errcode_t badblocks_list_add(badblocks_list bb, blk_t blk);
766 extern int badblocks_list_test(badblocks_list bb, blk_t blk);
767 extern errcode_t badblocks_list_iterate_begin(badblocks_list bb,
768 badblocks_iterate *ret);
769 extern int badblocks_list_iterate(badblocks_iterate iter, blk_t *blk);
770 extern void badblocks_list_iterate_end(badblocks_iterate iter);
771 extern void badblocks_list_free(badblocks_list bb);
772
773 /* bb_inode.c */
774 extern errcode_t ext2fs_update_bb_inode(ext2_filsys fs,
775 ext2_badblocks_list bb_list);
776
777 /* bitmaps.c */
778 extern void ext2fs_free_block_bitmap(ext2fs_block_bitmap bitmap);
779 extern void ext2fs_free_inode_bitmap(ext2fs_inode_bitmap bitmap);
780 extern errcode_t ext2fs_copy_bitmap(ext2fs_generic_bitmap src,
781 ext2fs_generic_bitmap *dest);
782 extern errcode_t ext2fs_write_inode_bitmap(ext2_filsys fs);
783 extern errcode_t ext2fs_write_block_bitmap (ext2_filsys fs);
784 extern errcode_t ext2fs_read_inode_bitmap (ext2_filsys fs);
785 extern errcode_t ext2fs_read_block_bitmap(ext2_filsys fs);
786 extern errcode_t ext2fs_allocate_block_bitmap(ext2_filsys fs,
787 const char *descr,
788 ext2fs_block_bitmap *ret);
789 extern errcode_t ext2fs_allocate_subcluster_bitmap(ext2_filsys fs,
790 const char *descr,
791 ext2fs_block_bitmap *ret);
792 extern int ext2fs_get_bitmap_granularity(ext2fs_block_bitmap bitmap);
793 extern errcode_t ext2fs_allocate_inode_bitmap(ext2_filsys fs,
794 const char *descr,
795 ext2fs_inode_bitmap *ret);
796 extern errcode_t ext2fs_fudge_inode_bitmap_end(ext2fs_inode_bitmap bitmap,
797 ext2_ino_t end, ext2_ino_t *oend);
798 extern errcode_t ext2fs_fudge_block_bitmap_end(ext2fs_block_bitmap bitmap,
799 blk_t end, blk_t *oend);
800 extern errcode_t ext2fs_fudge_block_bitmap_end2(ext2fs_block_bitmap bitmap,
801 blk64_t end, blk64_t *oend);
802 extern void ext2fs_clear_inode_bitmap(ext2fs_inode_bitmap bitmap);
803 extern void ext2fs_clear_block_bitmap(ext2fs_block_bitmap bitmap);
804 extern errcode_t ext2fs_read_bitmaps(ext2_filsys fs);
805 extern errcode_t ext2fs_write_bitmaps(ext2_filsys fs);
806 extern errcode_t ext2fs_resize_inode_bitmap(__u32 new_end, __u32 new_real_end,
807 ext2fs_inode_bitmap bmap);
808 extern errcode_t ext2fs_resize_inode_bitmap2(__u64 new_end,
809 __u64 new_real_end,
810 ext2fs_inode_bitmap bmap);
811 extern errcode_t ext2fs_resize_block_bitmap(__u32 new_end, __u32 new_real_end,
812 ext2fs_block_bitmap bmap);
813 extern errcode_t ext2fs_resize_block_bitmap2(__u64 new_end,
814 __u64 new_real_end,
815 ext2fs_block_bitmap bmap);
816 extern errcode_t ext2fs_compare_block_bitmap(ext2fs_block_bitmap bm1,
817 ext2fs_block_bitmap bm2);
818 extern errcode_t ext2fs_compare_inode_bitmap(ext2fs_inode_bitmap bm1,
819 ext2fs_inode_bitmap bm2);
820 extern errcode_t ext2fs_set_inode_bitmap_range(ext2fs_inode_bitmap bmap,
821 ext2_ino_t start, unsigned int num,
822 void *in);
823 extern errcode_t ext2fs_set_inode_bitmap_range2(ext2fs_inode_bitmap bmap,
824 __u64 start, size_t num,
825 void *in);
826 extern errcode_t ext2fs_get_inode_bitmap_range(ext2fs_inode_bitmap bmap,
827 ext2_ino_t start, unsigned int num,
828 void *out);
829 extern errcode_t ext2fs_get_inode_bitmap_range2(ext2fs_inode_bitmap bmap,
830 __u64 start, size_t num,
831 void *out);
832 extern errcode_t ext2fs_set_block_bitmap_range(ext2fs_block_bitmap bmap,
833 blk_t start, unsigned int num,
834 void *in);
835 extern errcode_t ext2fs_set_block_bitmap_range2(ext2fs_block_bitmap bmap,
836 blk64_t start, size_t num,
837 void *in);
838 extern errcode_t ext2fs_get_block_bitmap_range(ext2fs_block_bitmap bmap,
839 blk_t start, unsigned int num,
840 void *out);
841 extern errcode_t ext2fs_get_block_bitmap_range2(ext2fs_block_bitmap bmap,
842 blk64_t start, size_t num,
843 void *out);
844
845 /* blknum.c */
846 extern __u32 ext2fs_inode_bitmap_checksum(ext2_filsys fs, dgrp_t group);
847 extern __u32 ext2fs_block_bitmap_checksum(ext2_filsys fs, dgrp_t group);
848 extern dgrp_t ext2fs_group_of_blk2(ext2_filsys fs, blk64_t);
849 extern blk64_t ext2fs_group_first_block2(ext2_filsys fs, dgrp_t group);
850 extern blk64_t ext2fs_group_last_block2(ext2_filsys fs, dgrp_t group);
851 extern int ext2fs_group_blocks_count(ext2_filsys fs, dgrp_t group);
852 extern blk64_t ext2fs_inode_data_blocks2(ext2_filsys fs,
853 struct ext2_inode *inode);
854 extern blk64_t ext2fs_inode_i_blocks(ext2_filsys fs,
855 struct ext2_inode *inode);
856 extern blk64_t ext2fs_blocks_count(struct ext2_super_block *super);
857 extern void ext2fs_blocks_count_set(struct ext2_super_block *super,
858 blk64_t blk);
859 extern void ext2fs_blocks_count_add(struct ext2_super_block *super,
860 blk64_t blk);
861 extern blk64_t ext2fs_r_blocks_count(struct ext2_super_block *super);
862 extern void ext2fs_r_blocks_count_set(struct ext2_super_block *super,
863 blk64_t blk);
864 extern void ext2fs_r_blocks_count_add(struct ext2_super_block *super,
865 blk64_t blk);
866 extern blk64_t ext2fs_free_blocks_count(struct ext2_super_block *super);
867 extern void ext2fs_free_blocks_count_set(struct ext2_super_block *super,
868 blk64_t blk);
869 extern void ext2fs_free_blocks_count_add(struct ext2_super_block *super,
870 blk64_t blk);
871 /* Block group descriptor accessor functions */
872 extern struct ext2_group_desc *ext2fs_group_desc(ext2_filsys fs,
873 struct opaque_ext2_group_desc *gdp,
874 dgrp_t group);
875 extern blk64_t ext2fs_block_bitmap_csum(ext2_filsys fs, dgrp_t group);
876 extern blk64_t ext2fs_block_bitmap_loc(ext2_filsys fs, dgrp_t group);
877 extern void ext2fs_block_bitmap_loc_set(ext2_filsys fs, dgrp_t group,
878 blk64_t blk);
879 extern __u32 ext2fs_inode_bitmap_csum(ext2_filsys fs, dgrp_t group);
880 extern blk64_t ext2fs_inode_bitmap_loc(ext2_filsys fs, dgrp_t group);
881 extern void ext2fs_inode_bitmap_loc_set(ext2_filsys fs, dgrp_t group,
882 blk64_t blk);
883 extern blk64_t ext2fs_inode_table_loc(ext2_filsys fs, dgrp_t group);
884 extern void ext2fs_inode_table_loc_set(ext2_filsys fs, dgrp_t group,
885 blk64_t blk);
886 extern __u32 ext2fs_bg_free_blocks_count(ext2_filsys fs, dgrp_t group);
887 extern void ext2fs_bg_free_blocks_count_set(ext2_filsys fs, dgrp_t group,
888 __u32 n);
889 extern __u32 ext2fs_bg_free_inodes_count(ext2_filsys fs, dgrp_t group);
890 extern void ext2fs_bg_free_inodes_count_set(ext2_filsys fs, dgrp_t group,
891 __u32 n);
892 extern __u32 ext2fs_bg_used_dirs_count(ext2_filsys fs, dgrp_t group);
893 extern void ext2fs_bg_used_dirs_count_set(ext2_filsys fs, dgrp_t group,
894 __u32 n);
895 extern __u32 ext2fs_bg_itable_unused(ext2_filsys fs, dgrp_t group);
896 extern void ext2fs_bg_itable_unused_set(ext2_filsys fs, dgrp_t group,
897 __u32 n);
898 extern __u16 ext2fs_bg_flags(ext2_filsys fs, dgrp_t group);
899 extern void ext2fs_bg_flags_zap(ext2_filsys fs, dgrp_t group);
900 extern int ext2fs_bg_flags_test(ext2_filsys fs, dgrp_t group, __u16 bg_flag);
901 extern void ext2fs_bg_flags_set(ext2_filsys fs, dgrp_t group, __u16 bg_flags);
902 extern void ext2fs_bg_flags_clear(ext2_filsys fs, dgrp_t group, __u16 bg_flags);
903 extern __u16 ext2fs_bg_checksum(ext2_filsys fs, dgrp_t group);
904 extern void ext2fs_bg_checksum_set(ext2_filsys fs, dgrp_t group, __u16 checksum);
905 extern blk64_t ext2fs_file_acl_block(ext2_filsys fs,
906 const struct ext2_inode *inode);
907 extern void ext2fs_file_acl_block_set(ext2_filsys fs,
908 struct ext2_inode *inode, blk64_t blk);
909 extern errcode_t ext2fs_inode_size_set(ext2_filsys fs, struct ext2_inode *inode,
910 ext2_off64_t size);
911
912 /* block.c */
913 extern errcode_t ext2fs_block_iterate(ext2_filsys fs,
914 ext2_ino_t ino,
915 int flags,
916 char *block_buf,
917 int (*func)(ext2_filsys fs,
918 blk_t *blocknr,
919 int blockcnt,
920 void *priv_data),
921 void *priv_data);
922 errcode_t ext2fs_block_iterate2(ext2_filsys fs,
923 ext2_ino_t ino,
924 int flags,
925 char *block_buf,
926 int (*func)(ext2_filsys fs,
927 blk_t *blocknr,
928 e2_blkcnt_t blockcnt,
929 blk_t ref_blk,
930 int ref_offset,
931 void *priv_data),
932 void *priv_data);
933 errcode_t ext2fs_block_iterate3(ext2_filsys fs,
934 ext2_ino_t ino,
935 int flags,
936 char *block_buf,
937 int (*func)(ext2_filsys fs,
938 blk64_t *blocknr,
939 e2_blkcnt_t blockcnt,
940 blk64_t ref_blk,
941 int ref_offset,
942 void *priv_data),
943 void *priv_data);
944
945 /* bmap.c */
946 extern errcode_t ext2fs_bmap(ext2_filsys fs, ext2_ino_t ino,
947 struct ext2_inode *inode,
948 char *block_buf, int bmap_flags,
949 blk_t block, blk_t *phys_blk);
950 extern errcode_t ext2fs_bmap2(ext2_filsys fs, ext2_ino_t ino,
951 struct ext2_inode *inode,
952 char *block_buf, int bmap_flags, blk64_t block,
953 int *ret_flags, blk64_t *phys_blk);
954 errcode_t ext2fs_map_cluster_block(ext2_filsys fs, ext2_ino_t ino,
955 struct ext2_inode *inode, blk64_t lblk,
956 blk64_t *pblk);
957
958 #if 0
959 /* bmove.c */
960 extern errcode_t ext2fs_move_blocks(ext2_filsys fs,
961 ext2fs_block_bitmap reserve,
962 ext2fs_block_bitmap alloc_map,
963 int flags);
964 #endif
965
966 /* check_desc.c */
967 extern errcode_t ext2fs_check_desc(ext2_filsys fs);
968
969 /* closefs.c */
970 extern errcode_t ext2fs_close(ext2_filsys fs);
971 extern errcode_t ext2fs_close2(ext2_filsys fs, int flags);
972 extern errcode_t ext2fs_close_free(ext2_filsys *fs);
973 extern errcode_t ext2fs_flush(ext2_filsys fs);
974 extern errcode_t ext2fs_flush2(ext2_filsys fs, int flags);
975 extern int ext2fs_bg_has_super(ext2_filsys fs, dgrp_t group_block);
976 extern errcode_t ext2fs_super_and_bgd_loc2(ext2_filsys fs,
977 dgrp_t group,
978 blk64_t *ret_super_blk,
979 blk64_t *ret_old_desc_blk,
980 blk64_t *ret_new_desc_blk,
981 blk_t *ret_used_blks);
982 extern int ext2fs_super_and_bgd_loc(ext2_filsys fs,
983 dgrp_t group,
984 blk_t *ret_super_blk,
985 blk_t *ret_old_desc_blk,
986 blk_t *ret_new_desc_blk,
987 int *ret_meta_bg);
988 extern void ext2fs_update_dynamic_rev(ext2_filsys fs);
989
990 /* crc32c.c */
991 extern __u32 ext2fs_crc32_be(__u32 crc, unsigned char const *p, size_t len);
992 extern __u32 ext2fs_crc32c_le(__u32 crc, unsigned char const *p, size_t len);
993
994 /* csum.c */
995 extern errcode_t ext2fs_mmp_csum_set(ext2_filsys fs, struct mmp_struct *mmp);
996 extern int ext2fs_mmp_csum_verify(ext2_filsys, struct mmp_struct *mmp);
997 extern int ext2fs_verify_csum_type(ext2_filsys fs, struct ext2_super_block *sb);
998 extern errcode_t ext2fs_superblock_csum_set(ext2_filsys fs,
999 struct ext2_super_block *sb);
1000 extern int ext2fs_superblock_csum_verify(ext2_filsys fs,
1001 struct ext2_super_block *sb);
1002 extern errcode_t ext2fs_ext_attr_block_csum_set(ext2_filsys fs,
1003 ext2_ino_t inum, blk64_t block,
1004 struct ext2_ext_attr_header *hdr);
1005 extern int ext2fs_ext_attr_block_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1006 blk64_t block,
1007 struct ext2_ext_attr_header *hdr);
1008 #define EXT2_DIRENT_TAIL(block, blocksize) \
1009 ((struct ext2_dir_entry_tail *)(((char *)(block)) + \
1010 (blocksize) - sizeof(struct ext2_dir_entry_tail)))
1011
1012 extern void ext2fs_initialize_dirent_tail(ext2_filsys fs,
1013 struct ext2_dir_entry_tail *t);
1014 extern int ext2fs_dirent_has_tail(ext2_filsys fs,
1015 struct ext2_dir_entry *dirent);
1016 extern int ext2fs_dirent_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1017 struct ext2_dir_entry *dirent);
1018 extern int ext2fs_dir_block_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1019 struct ext2_dir_entry *dirent);
1020 extern errcode_t ext2fs_dir_block_csum_set(ext2_filsys fs, ext2_ino_t inum,
1021 struct ext2_dir_entry *dirent);
1022 extern errcode_t ext2fs_get_dx_countlimit(ext2_filsys fs,
1023 struct ext2_dir_entry *dirent,
1024 struct ext2_dx_countlimit **cc,
1025 int *offset);
1026 extern errcode_t ext2fs_extent_block_csum_set(ext2_filsys fs,
1027 ext2_ino_t inum,
1028 struct ext3_extent_header *eh);
1029 extern int ext2fs_extent_block_csum_verify(ext2_filsys fs,
1030 ext2_ino_t inum,
1031 struct ext3_extent_header *eh);
1032 extern errcode_t ext2fs_block_bitmap_csum_set(ext2_filsys fs, dgrp_t group,
1033 char *bitmap, int size);
1034 extern int ext2fs_block_bitmap_csum_verify(ext2_filsys fs, dgrp_t group,
1035 char *bitmap, int size);
1036 extern errcode_t ext2fs_inode_bitmap_csum_set(ext2_filsys fs, dgrp_t group,
1037 char *bitmap, int size);
1038 extern int ext2fs_inode_bitmap_csum_verify(ext2_filsys fs, dgrp_t group,
1039 char *bitmap, int size);
1040 extern errcode_t ext2fs_inode_csum_set(ext2_filsys fs, ext2_ino_t inum,
1041 struct ext2_inode_large *inode);
1042 extern int ext2fs_inode_csum_verify(ext2_filsys fs, ext2_ino_t inum,
1043 struct ext2_inode_large *inode);
1044 extern void ext2fs_group_desc_csum_set(ext2_filsys fs, dgrp_t group);
1045 extern int ext2fs_group_desc_csum_verify(ext2_filsys fs, dgrp_t group);
1046 extern errcode_t ext2fs_set_gdt_csum(ext2_filsys fs);
1047 extern __u16 ext2fs_group_desc_csum(ext2_filsys fs, dgrp_t group);
1048
1049 /* dblist.c */
1050 extern errcode_t ext2fs_init_dblist(ext2_filsys fs, ext2_dblist *ret_dblist);
1051 extern errcode_t ext2fs_add_dir_block(ext2_dblist dblist, ext2_ino_t ino,
1052 blk_t blk, int blockcnt);
1053 extern errcode_t ext2fs_add_dir_block2(ext2_dblist dblist, ext2_ino_t ino,
1054 blk64_t blk, e2_blkcnt_t blockcnt);
1055 extern void ext2fs_dblist_sort(ext2_dblist dblist,
1056 EXT2_QSORT_TYPE (*sortfunc)(const void *,
1057 const void *));
1058 extern void ext2fs_dblist_sort2(ext2_dblist dblist,
1059 EXT2_QSORT_TYPE (*sortfunc)(const void *,
1060 const void *));
1061 extern errcode_t ext2fs_dblist_iterate(ext2_dblist dblist,
1062 int (*func)(ext2_filsys fs, struct ext2_db_entry *db_info,
1063 void *priv_data),
1064 void *priv_data);
1065 extern errcode_t ext2fs_dblist_iterate2(ext2_dblist dblist,
1066 int (*func)(ext2_filsys fs, struct ext2_db_entry2 *db_info,
1067 void *priv_data),
1068 void *priv_data);
1069 extern errcode_t ext2fs_dblist_iterate3(ext2_dblist dblist,
1070 int (*func)(ext2_filsys fs, struct ext2_db_entry2 *db_info,
1071 void *priv_data),
1072 unsigned long long start,
1073 unsigned long long count,
1074 void *priv_data);
1075 extern errcode_t ext2fs_set_dir_block(ext2_dblist dblist, ext2_ino_t ino,
1076 blk_t blk, int blockcnt);
1077 extern errcode_t ext2fs_set_dir_block2(ext2_dblist dblist, ext2_ino_t ino,
1078 blk64_t blk, e2_blkcnt_t blockcnt);
1079 extern errcode_t ext2fs_copy_dblist(ext2_dblist src,
1080 ext2_dblist *dest);
1081 extern int ext2fs_dblist_count(ext2_dblist dblist);
1082 extern blk64_t ext2fs_dblist_count2(ext2_dblist dblist);
1083 extern errcode_t ext2fs_dblist_get_last(ext2_dblist dblist,
1084 struct ext2_db_entry **entry);
1085 extern errcode_t ext2fs_dblist_get_last2(ext2_dblist dblist,
1086 struct ext2_db_entry2 **entry);
1087 extern errcode_t ext2fs_dblist_drop_last(ext2_dblist dblist);
1088
1089 /* dblist_dir.c */
1090 extern errcode_t
1091 ext2fs_dblist_dir_iterate(ext2_dblist dblist,
1092 int flags,
1093 char *block_buf,
1094 int (*func)(ext2_ino_t dir,
1095 int entry,
1096 struct ext2_dir_entry *dirent,
1097 int offset,
1098 int blocksize,
1099 char *buf,
1100 void *priv_data),
1101 void *priv_data);
1102
1103 #if 0
1104 /* digest_encode.c */
1105 #define EXT2FS_DIGEST_SIZE EXT2FS_SHA256_LENGTH
1106 extern int ext2fs_digest_encode(const char *src, int len, char *dst);
1107 extern int ext2fs_digest_decode(const char *src, int len, char *dst);
1108 #endif
1109
1110 /* dirblock.c */
1111 extern errcode_t ext2fs_read_dir_block(ext2_filsys fs, blk_t block,
1112 void *buf);
1113 extern errcode_t ext2fs_read_dir_block2(ext2_filsys fs, blk_t block,
1114 void *buf, int flags);
1115 extern errcode_t ext2fs_read_dir_block3(ext2_filsys fs, blk64_t block,
1116 void *buf, int flags);
1117 extern errcode_t ext2fs_read_dir_block4(ext2_filsys fs, blk64_t block,
1118 void *buf, int flags, ext2_ino_t ino);
1119 extern errcode_t ext2fs_write_dir_block(ext2_filsys fs, blk_t block,
1120 void *buf);
1121 extern errcode_t ext2fs_write_dir_block2(ext2_filsys fs, blk_t block,
1122 void *buf, int flags);
1123 extern errcode_t ext2fs_write_dir_block3(ext2_filsys fs, blk64_t block,
1124 void *buf, int flags);
1125 extern errcode_t ext2fs_write_dir_block4(ext2_filsys fs, blk64_t block,
1126 void *buf, int flags, ext2_ino_t ino);
1127
1128 /* dirhash.c */
1129 extern errcode_t ext2fs_dirhash(int version, const char *name, int len,
1130 const __u32 *seed,
1131 ext2_dirhash_t *ret_hash,
1132 ext2_dirhash_t *ret_minor_hash);
1133
1134
1135 /* dir_iterate.c */
1136 extern errcode_t ext2fs_get_rec_len(ext2_filsys fs,
1137 struct ext2_dir_entry *dirent,
1138 unsigned int *rec_len);
1139 extern errcode_t ext2fs_set_rec_len(ext2_filsys fs,
1140 unsigned int len,
1141 struct ext2_dir_entry *dirent);
1142 extern errcode_t ext2fs_dir_iterate(ext2_filsys fs,
1143 ext2_ino_t dir,
1144 int flags,
1145 char *block_buf,
1146 int (*func)(struct ext2_dir_entry *dirent,
1147 int offset,
1148 int blocksize,
1149 char *buf,
1150 void *priv_data),
1151 void *priv_data);
1152 extern errcode_t ext2fs_dir_iterate2(ext2_filsys fs,
1153 ext2_ino_t dir,
1154 int flags,
1155 char *block_buf,
1156 int (*func)(ext2_ino_t dir,
1157 int entry,
1158 struct ext2_dir_entry *dirent,
1159 int offset,
1160 int blocksize,
1161 char *buf,
1162 void *priv_data),
1163 void *priv_data);
1164
1165 /* dupfs.c */
1166 extern errcode_t ext2fs_dup_handle(ext2_filsys src, ext2_filsys *dest);
1167
1168 /* expanddir.c */
1169 extern errcode_t ext2fs_expand_dir(ext2_filsys fs, ext2_ino_t dir);
1170
1171 /* ext_attr.c */
1172 extern __u32 ext2fs_ext_attr_hash_entry(struct ext2_ext_attr_entry *entry,
1173 void *data);
1174 extern errcode_t ext2fs_read_ext_attr(ext2_filsys fs, blk_t block, void *buf);
1175 extern errcode_t ext2fs_read_ext_attr2(ext2_filsys fs, blk64_t block,
1176 void *buf);
1177 extern errcode_t ext2fs_read_ext_attr3(ext2_filsys fs, blk64_t block,
1178 void *buf, ext2_ino_t inum);
1179 extern errcode_t ext2fs_write_ext_attr(ext2_filsys fs, blk_t block,
1180 void *buf);
1181 extern errcode_t ext2fs_write_ext_attr2(ext2_filsys fs, blk64_t block,
1182 void *buf);
1183 extern errcode_t ext2fs_write_ext_attr3(ext2_filsys fs, blk64_t block,
1184 void *buf, ext2_ino_t inum);
1185 extern errcode_t ext2fs_adjust_ea_refcount(ext2_filsys fs, blk_t blk,
1186 char *block_buf,
1187 int adjust, __u32 *newcount);
1188 extern errcode_t ext2fs_adjust_ea_refcount2(ext2_filsys fs, blk64_t blk,
1189 char *block_buf,
1190 int adjust, __u32 *newcount);
1191 extern errcode_t ext2fs_adjust_ea_refcount3(ext2_filsys fs, blk64_t blk,
1192 char *block_buf,
1193 int adjust, __u32 *newcount,
1194 ext2_ino_t inum);
1195 errcode_t ext2fs_xattrs_write(struct ext2_xattr_handle *handle);
1196 errcode_t ext2fs_xattrs_read(struct ext2_xattr_handle *handle);
1197 errcode_t ext2fs_xattrs_iterate(struct ext2_xattr_handle *h,
1198 int (*func)(char *name, char *value,
1199 size_t value_len, void *data),
1200 void *data);
1201 errcode_t ext2fs_xattr_get(struct ext2_xattr_handle *h, const char *key,
1202 void **value, size_t *value_len);
1203 errcode_t ext2fs_xattr_set(struct ext2_xattr_handle *handle,
1204 const char *key,
1205 const void *value,
1206 size_t value_len);
1207 errcode_t ext2fs_xattr_remove(struct ext2_xattr_handle *handle,
1208 const char *key);
1209 errcode_t ext2fs_xattrs_open(ext2_filsys fs, ext2_ino_t ino,
1210 struct ext2_xattr_handle **handle);
1211 errcode_t ext2fs_xattrs_close(struct ext2_xattr_handle **handle);
1212 errcode_t ext2fs_free_ext_attr(ext2_filsys fs, ext2_ino_t ino,
1213 struct ext2_inode_large *inode);
1214 errcode_t ext2fs_xattrs_count(struct ext2_xattr_handle *handle, size_t *count);
1215 errcode_t ext2fs_xattr_inode_max_size(ext2_filsys fs, ext2_ino_t ino,
1216 size_t *size);
1217
1218 /* extent.c */
1219 extern errcode_t ext2fs_extent_header_verify(void *ptr, int size);
1220 extern errcode_t ext2fs_extent_open(ext2_filsys fs, ext2_ino_t ino,
1221 ext2_extent_handle_t *handle);
1222 extern errcode_t ext2fs_extent_open2(ext2_filsys fs, ext2_ino_t ino,
1223 struct ext2_inode *inode,
1224 ext2_extent_handle_t *ret_handle);
1225 extern void ext2fs_extent_free(ext2_extent_handle_t handle);
1226 extern errcode_t ext2fs_extent_get(ext2_extent_handle_t handle,
1227 int flags, struct ext2fs_extent *extent);
1228 extern errcode_t ext2fs_extent_node_split(ext2_extent_handle_t handle);
1229 extern errcode_t ext2fs_extent_replace(ext2_extent_handle_t handle, int flags,
1230 struct ext2fs_extent *extent);
1231 extern errcode_t ext2fs_extent_insert(ext2_extent_handle_t handle, int flags,
1232 struct ext2fs_extent *extent);
1233 extern errcode_t ext2fs_extent_set_bmap(ext2_extent_handle_t handle,
1234 blk64_t logical, blk64_t physical,
1235 int flags);
1236 extern errcode_t ext2fs_extent_delete(ext2_extent_handle_t handle, int flags);
1237 extern errcode_t ext2fs_extent_get_info(ext2_extent_handle_t handle,
1238 struct ext2_extent_info *info);
1239 extern errcode_t ext2fs_extent_goto(ext2_extent_handle_t handle,
1240 blk64_t blk);
1241 extern errcode_t ext2fs_extent_goto2(ext2_extent_handle_t handle,
1242 int leaf_level, blk64_t blk);
1243 extern errcode_t ext2fs_extent_fix_parents(ext2_extent_handle_t handle);
1244 size_t ext2fs_max_extent_depth(ext2_extent_handle_t handle);
1245
1246 /* fallocate.c */
1247 #define EXT2_FALLOCATE_ZERO_BLOCKS (0x1)
1248 #define EXT2_FALLOCATE_FORCE_INIT (0x2)
1249 #define EXT2_FALLOCATE_FORCE_UNINIT (0x4)
1250 #define EXT2_FALLOCATE_INIT_BEYOND_EOF (0x8)
1251 #define EXT2_FALLOCATE_ALL_FLAGS (0xF)
1252 errcode_t ext2fs_fallocate(ext2_filsys fs, int flags, ext2_ino_t ino,
1253 struct ext2_inode *inode, blk64_t goal,
1254 blk64_t start, blk64_t len);
1255
1256 /* fileio.c */
1257 extern errcode_t ext2fs_file_open2(ext2_filsys fs, ext2_ino_t ino,
1258 struct ext2_inode *inode,
1259 int flags, ext2_file_t *ret);
1260 extern errcode_t ext2fs_file_open(ext2_filsys fs, ext2_ino_t ino,
1261 int flags, ext2_file_t *ret);
1262 extern ext2_filsys ext2fs_file_get_fs(ext2_file_t file);
1263 struct ext2_inode *ext2fs_file_get_inode(ext2_file_t file);
1264 extern ext2_ino_t ext2fs_file_get_inode_num(ext2_file_t file);
1265 extern errcode_t ext2fs_file_close(ext2_file_t file);
1266 extern errcode_t ext2fs_file_flush(ext2_file_t file);
1267 extern errcode_t ext2fs_file_read(ext2_file_t file, void *buf,
1268 unsigned int wanted, unsigned int *got);
1269 extern errcode_t ext2fs_file_write(ext2_file_t file, const void *buf,
1270 unsigned int nbytes, unsigned int *written);
1271 extern errcode_t ext2fs_file_llseek(ext2_file_t file, __u64 offset,
1272 int whence, __u64 *ret_pos);
1273 extern errcode_t ext2fs_file_lseek(ext2_file_t file, ext2_off_t offset,
1274 int whence, ext2_off_t *ret_pos);
1275 errcode_t ext2fs_file_get_lsize(ext2_file_t file, __u64 *ret_size);
1276 extern ext2_off_t ext2fs_file_get_size(ext2_file_t file);
1277 extern errcode_t ext2fs_file_set_size(ext2_file_t file, ext2_off_t size);
1278 extern errcode_t ext2fs_file_set_size2(ext2_file_t file, ext2_off64_t size);
1279
1280 /* finddev.c */
1281 extern char *ext2fs_find_block_device(dev_t device);
1282
1283 /* flushb.c */
1284 extern errcode_t ext2fs_sync_device(int fd, int flushb);
1285
1286 /* freefs.c */
1287 extern void ext2fs_free(ext2_filsys fs);
1288 extern void ext2fs_free_dblist(ext2_dblist dblist);
1289 extern void ext2fs_badblocks_list_free(ext2_badblocks_list bb);
1290 extern void ext2fs_u32_list_free(ext2_u32_list bb);
1291
1292 /* gen_bitmap.c */
1293 extern void ext2fs_free_generic_bitmap(ext2fs_inode_bitmap bitmap);
1294 extern errcode_t ext2fs_make_generic_bitmap(errcode_t magic, ext2_filsys fs,
1295 __u32 start, __u32 end,
1296 __u32 real_end,
1297 const char *descr, char *init_map,
1298 ext2fs_generic_bitmap *ret);
1299 extern errcode_t ext2fs_allocate_generic_bitmap(__u32 start,
1300 __u32 end,
1301 __u32 real_end,
1302 const char *descr,
1303 ext2fs_generic_bitmap *ret);
1304 extern errcode_t ext2fs_copy_generic_bitmap(ext2fs_generic_bitmap src,
1305 ext2fs_generic_bitmap *dest);
1306 extern void ext2fs_clear_generic_bitmap(ext2fs_generic_bitmap bitmap);
1307 extern errcode_t ext2fs_fudge_generic_bitmap_end(ext2fs_inode_bitmap bitmap,
1308 errcode_t magic,
1309 errcode_t neq,
1310 ext2_ino_t end,
1311 ext2_ino_t *oend);
1312 extern void ext2fs_set_generic_bitmap_padding(ext2fs_generic_bitmap map);
1313 extern errcode_t ext2fs_resize_generic_bitmap(errcode_t magic,
1314 __u32 new_end,
1315 __u32 new_real_end,
1316 ext2fs_generic_bitmap bmap);
1317 extern errcode_t ext2fs_compare_generic_bitmap(errcode_t magic, errcode_t neq,
1318 ext2fs_generic_bitmap bm1,
1319 ext2fs_generic_bitmap bm2);
1320 extern errcode_t ext2fs_get_generic_bitmap_range(ext2fs_generic_bitmap bmap,
1321 errcode_t magic,
1322 __u32 start, __u32 num,
1323 void *out);
1324 extern errcode_t ext2fs_set_generic_bitmap_range(ext2fs_generic_bitmap bmap,
1325 errcode_t magic,
1326 __u32 start, __u32 num,
1327 void *in);
1328 extern errcode_t ext2fs_find_first_zero_generic_bitmap(ext2fs_generic_bitmap bitmap,
1329 __u32 start, __u32 end,
1330 __u32 *out);
1331 extern errcode_t ext2fs_find_first_set_generic_bitmap(ext2fs_generic_bitmap bitmap,
1332 __u32 start, __u32 end,
1333 __u32 *out);
1334
1335 /* gen_bitmap64.c */
1336 void ext2fs_free_generic_bmap(ext2fs_generic_bitmap bmap);
1337 errcode_t ext2fs_alloc_generic_bmap(ext2_filsys fs, errcode_t magic,
1338 int type, __u64 start, __u64 end,
1339 __u64 real_end,
1340 const char *descr,
1341 ext2fs_generic_bitmap *ret);
1342 errcode_t ext2fs_copy_generic_bmap(ext2fs_generic_bitmap src,
1343 ext2fs_generic_bitmap *dest);
1344 void ext2fs_clear_generic_bmap(ext2fs_generic_bitmap bitmap);
1345 errcode_t ext2fs_fudge_generic_bmap_end(ext2fs_generic_bitmap bitmap,
1346 errcode_t neq,
1347 __u64 end, __u64 *oend);
1348 void ext2fs_set_generic_bmap_padding(ext2fs_generic_bitmap bmap);
1349 errcode_t ext2fs_resize_generic_bmap(ext2fs_generic_bitmap bmap,
1350 __u64 new_end,
1351 __u64 new_real_end);
1352 errcode_t ext2fs_compare_generic_bmap(errcode_t neq,
1353 ext2fs_generic_bitmap bm1,
1354 ext2fs_generic_bitmap bm2);
1355 errcode_t ext2fs_get_generic_bmap_range(ext2fs_generic_bitmap bmap,
1356 __u64 start, unsigned int num,
1357 void *out);
1358 errcode_t ext2fs_set_generic_bmap_range(ext2fs_generic_bitmap bmap,
1359 __u64 start, unsigned int num,
1360 void *in);
1361 errcode_t ext2fs_convert_subcluster_bitmap(ext2_filsys fs,
1362 ext2fs_block_bitmap *bitmap);
1363
1364 /* get_num_dirs.c */
1365 extern errcode_t ext2fs_get_num_dirs(ext2_filsys fs, ext2_ino_t *ret_num_dirs);
1366
1367 /* getsize.c */
1368 extern errcode_t ext2fs_get_device_size(const char *file, int blocksize,
1369 blk_t *retblocks);
1370 extern errcode_t ext2fs_get_device_size2(const char *file, int blocksize,
1371 blk64_t *retblocks);
1372
1373 /* getsectsize.c */
1374 extern int ext2fs_get_dio_alignment(int fd);
1375 errcode_t ext2fs_get_device_sectsize(const char *file, int *sectsize);
1376 errcode_t ext2fs_get_device_phys_sectsize(const char *file, int *sectsize);
1377
1378 /* i_block.c */
1379 errcode_t ext2fs_iblk_add_blocks(ext2_filsys fs, struct ext2_inode *inode,
1380 blk64_t num_blocks);
1381 errcode_t ext2fs_iblk_sub_blocks(ext2_filsys fs, struct ext2_inode *inode,
1382 blk64_t num_blocks);
1383 errcode_t ext2fs_iblk_set(ext2_filsys fs, struct ext2_inode *inode, blk64_t b);
1384
1385 /* imager.c */
1386 extern errcode_t ext2fs_image_inode_write(ext2_filsys fs, int fd, int flags);
1387 extern errcode_t ext2fs_image_inode_read(ext2_filsys fs, int fd, int flags);
1388 extern errcode_t ext2fs_image_super_write(ext2_filsys fs, int fd, int flags);
1389 extern errcode_t ext2fs_image_super_read(ext2_filsys fs, int fd, int flags);
1390 extern errcode_t ext2fs_image_bitmap_write(ext2_filsys fs, int fd, int flags);
1391 extern errcode_t ext2fs_image_bitmap_read(ext2_filsys fs, int fd, int flags);
1392
1393 /* ind_block.c */
1394 errcode_t ext2fs_read_ind_block(ext2_filsys fs, blk_t blk, void *buf);
1395 errcode_t ext2fs_write_ind_block(ext2_filsys fs, blk_t blk, void *buf);
1396
1397 /* initialize.c */
1398 extern errcode_t ext2fs_initialize(const char *name, int flags,
1399 struct ext2_super_block *param,
1400 io_manager manager, ext2_filsys *ret_fs);
1401
1402 /* icount.c */
1403 extern void ext2fs_free_icount(ext2_icount_t icount);
1404 extern errcode_t ext2fs_create_icount_tdb(ext2_filsys fs, char *tdb_dir,
1405 int flags, ext2_icount_t *ret);
1406 extern errcode_t ext2fs_create_icount2(ext2_filsys fs, int flags,
1407 unsigned int size,
1408 ext2_icount_t hint, ext2_icount_t *ret);
1409 extern errcode_t ext2fs_create_icount(ext2_filsys fs, int flags,
1410 unsigned int size,
1411 ext2_icount_t *ret);
1412 extern errcode_t ext2fs_icount_fetch(ext2_icount_t icount, ext2_ino_t ino,
1413 __u16 *ret);
1414 extern errcode_t ext2fs_icount_increment(ext2_icount_t icount, ext2_ino_t ino,
1415 __u16 *ret);
1416 extern errcode_t ext2fs_icount_decrement(ext2_icount_t icount, ext2_ino_t ino,
1417 __u16 *ret);
1418 extern errcode_t ext2fs_icount_store(ext2_icount_t icount, ext2_ino_t ino,
1419 __u16 count);
1420 extern ext2_ino_t ext2fs_get_icount_size(ext2_icount_t icount);
1421 errcode_t ext2fs_icount_validate(ext2_icount_t icount, FILE *);
1422
1423 /* inline.c */
1424
1425 extern errcode_t ext2fs_get_memalign(unsigned long size,
1426 unsigned long align, void *ptr);
1427
1428 /* inline_data.c */
1429 extern errcode_t ext2fs_inline_data_init(ext2_filsys fs, ext2_ino_t ino);
1430 extern errcode_t ext2fs_inline_data_size(ext2_filsys fs, ext2_ino_t ino,
1431 size_t *size);
1432 extern errcode_t ext2fs_inline_data_get(ext2_filsys fs, ext2_ino_t ino,
1433 struct ext2_inode *inode,
1434 void *buf, size_t *size);
1435 extern errcode_t ext2fs_inline_data_set(ext2_filsys fs, ext2_ino_t ino,
1436 struct ext2_inode *inode,
1437 void *buf, size_t size);
1438
1439 /* inode.c */
1440 extern errcode_t ext2fs_create_inode_cache(ext2_filsys fs,
1441 unsigned int cache_size);
1442 extern void ext2fs_free_inode_cache(struct ext2_inode_cache *icache);
1443 extern errcode_t ext2fs_flush_icache(ext2_filsys fs);
1444 extern errcode_t ext2fs_get_next_inode_full(ext2_inode_scan scan,
1445 ext2_ino_t *ino,
1446 struct ext2_inode *inode,
1447 int bufsize);
1448 #define EXT2_INODE_SCAN_DEFAULT_BUFFER_BLOCKS 8
1449 extern errcode_t ext2fs_open_inode_scan(ext2_filsys fs, int buffer_blocks,
1450 ext2_inode_scan *ret_scan);
1451 extern void ext2fs_close_inode_scan(ext2_inode_scan scan);
1452 extern errcode_t ext2fs_get_next_inode(ext2_inode_scan scan, ext2_ino_t *ino,
1453 struct ext2_inode *inode);
1454 extern errcode_t ext2fs_inode_scan_goto_blockgroup(ext2_inode_scan scan,
1455 int group);
1456 extern void ext2fs_set_inode_callback
1457 (ext2_inode_scan scan,
1458 errcode_t (*done_group)(ext2_filsys fs,
1459 ext2_inode_scan scan,
1460 dgrp_t group,
1461 void * priv_data),
1462 void *done_group_data);
1463 extern int ext2fs_inode_scan_flags(ext2_inode_scan scan, int set_flags,
1464 int clear_flags);
1465 extern errcode_t ext2fs_read_inode_full(ext2_filsys fs, ext2_ino_t ino,
1466 struct ext2_inode * inode,
1467 int bufsize);
1468 extern errcode_t ext2fs_read_inode (ext2_filsys fs, ext2_ino_t ino,
1469 struct ext2_inode * inode);
1470 extern errcode_t ext2fs_write_inode_full(ext2_filsys fs, ext2_ino_t ino,
1471 struct ext2_inode * inode,
1472 int bufsize);
1473 extern errcode_t ext2fs_write_inode(ext2_filsys fs, ext2_ino_t ino,
1474 struct ext2_inode * inode);
1475 extern errcode_t ext2fs_write_new_inode(ext2_filsys fs, ext2_ino_t ino,
1476 struct ext2_inode * inode);
1477 extern errcode_t ext2fs_get_blocks(ext2_filsys fs, ext2_ino_t ino, blk_t *blocks);
1478 extern errcode_t ext2fs_check_directory(ext2_filsys fs, ext2_ino_t ino);
1479
1480 /* inode_io.c */
1481 extern io_manager inode_io_manager;
1482 extern errcode_t ext2fs_inode_io_intern(ext2_filsys fs, ext2_ino_t ino,
1483 char **name);
1484 extern errcode_t ext2fs_inode_io_intern2(ext2_filsys fs, ext2_ino_t ino,
1485 struct ext2_inode *inode,
1486 char **name);
1487
1488 /* ismounted.c */
1489 extern errcode_t ext2fs_check_if_mounted(const char *file, int *mount_flags);
1490 extern errcode_t ext2fs_check_mount_point(const char *device, int *mount_flags,
1491 char *mtpt, int mtlen);
1492
1493 /* punch.c */
1494 /*
1495 * NOTE: This function removes from an inode the blocks "start", "end", and
1496 * every block in between.
1497 */
1498 extern errcode_t ext2fs_punch(ext2_filsys fs, ext2_ino_t ino,
1499 struct ext2_inode *inode,
1500 char *block_buf, blk64_t start,
1501 blk64_t end);
1502
1503 /* namei.c */
1504 extern errcode_t ext2fs_lookup(ext2_filsys fs, ext2_ino_t dir, const char *name,
1505 int namelen, char *buf, ext2_ino_t *inode);
1506 extern errcode_t ext2fs_namei(ext2_filsys fs, ext2_ino_t root, ext2_ino_t cwd,
1507 const char *name, ext2_ino_t *inode);
1508 errcode_t ext2fs_namei_follow(ext2_filsys fs, ext2_ino_t root, ext2_ino_t cwd,
1509 const char *name, ext2_ino_t *inode);
1510 extern errcode_t ext2fs_follow_link(ext2_filsys fs, ext2_ino_t root, ext2_ino_t cwd,
1511 ext2_ino_t inode, ext2_ino_t *res_inode);
1512
1513 /* native.c */
1514 int ext2fs_native_flag(void);
1515
1516 /* newdir.c */
1517 extern errcode_t ext2fs_new_dir_block(ext2_filsys fs, ext2_ino_t dir_ino,
1518 ext2_ino_t parent_ino, char **block);
1519 extern errcode_t ext2fs_new_dir_inline_data(ext2_filsys fs, ext2_ino_t dir_ino,
1520 ext2_ino_t parent_ino, __u32 *iblock);
1521
1522 /* mkdir.c */
1523 extern errcode_t ext2fs_mkdir(ext2_filsys fs, ext2_ino_t parent, ext2_ino_t inum,
1524 const char *name);
1525
1526 /* mkjournal.c */
1527 extern errcode_t ext2fs_zero_blocks(ext2_filsys fs, blk_t blk, int num,
1528 blk_t *ret_blk, int *ret_count);
1529 extern errcode_t ext2fs_zero_blocks2(ext2_filsys fs, blk64_t blk, int num,
1530 blk64_t *ret_blk, int *ret_count);
1531 extern errcode_t ext2fs_create_journal_superblock(ext2_filsys fs,
1532 __u32 num_blocks, int flags,
1533 char **ret_jsb);
1534 extern errcode_t ext2fs_add_journal_device(ext2_filsys fs,
1535 ext2_filsys journal_dev);
1536 extern errcode_t ext2fs_add_journal_inode(ext2_filsys fs, blk_t num_blocks,
1537 int flags);
1538 extern errcode_t ext2fs_add_journal_inode2(ext2_filsys fs, blk_t num_blocks,
1539 blk64_t goal, int flags);
1540 extern int ext2fs_default_journal_size(__u64 num_blocks);
1541 extern int ext2fs_journal_sb_start(int blocksize);
1542
1543 /* openfs.c */
1544 extern errcode_t ext2fs_open(const char *name, int flags, int superblock,
1545 unsigned int block_size, io_manager manager,
1546 ext2_filsys *ret_fs);
1547 extern errcode_t ext2fs_open2(const char *name, const char *io_options,
1548 int flags, int superblock,
1549 unsigned int block_size, io_manager manager,
1550 ext2_filsys *ret_fs);
1551 /*
1552 * The dgrp_t argument to these two functions is not actually a group number
1553 * but a block number offset within a group table! Convert with the formula
1554 * (group_number / groups_per_block).
1555 */
1556 extern blk64_t ext2fs_descriptor_block_loc2(ext2_filsys fs,
1557 blk64_t group_block, dgrp_t i);
1558 extern blk_t ext2fs_descriptor_block_loc(ext2_filsys fs, blk_t group_block,
1559 dgrp_t i);
1560 errcode_t ext2fs_get_data_io(ext2_filsys fs, io_channel *old_io);
1561 errcode_t ext2fs_set_data_io(ext2_filsys fs, io_channel new_io);
1562 errcode_t ext2fs_rewrite_to_io(ext2_filsys fs, io_channel new_io);
1563
1564 /* get_pathname.c */
1565 extern errcode_t ext2fs_get_pathname(ext2_filsys fs, ext2_ino_t dir, ext2_ino_t ino,
1566 char **name);
1567
1568 /* link.c */
1569 errcode_t ext2fs_link(ext2_filsys fs, ext2_ino_t dir, const char *name,
1570 ext2_ino_t ino, int flags);
1571 errcode_t ext2fs_unlink(ext2_filsys fs, ext2_ino_t dir, const char *name,
1572 ext2_ino_t ino, int flags);
1573
1574 /* symlink.c */
1575 errcode_t ext2fs_symlink(ext2_filsys fs, ext2_ino_t parent, ext2_ino_t ino,
1576 const char *name, char *target);
1577
1578 /* mmp.c */
1579 errcode_t ext2fs_mmp_read(ext2_filsys fs, blk64_t mmp_blk, void *buf);
1580 errcode_t ext2fs_mmp_write(ext2_filsys fs, blk64_t mmp_blk, void *buf);
1581 errcode_t ext2fs_mmp_clear(ext2_filsys fs);
1582 errcode_t ext2fs_mmp_init(ext2_filsys fs);
1583 errcode_t ext2fs_mmp_start(ext2_filsys fs);
1584 errcode_t ext2fs_mmp_update(ext2_filsys fs);
1585 errcode_t ext2fs_mmp_update2(ext2_filsys fs, int immediately);
1586 errcode_t ext2fs_mmp_stop(ext2_filsys fs);
1587 unsigned ext2fs_mmp_new_seq(void);
1588
1589 /* read_bb.c */
1590 extern errcode_t ext2fs_read_bb_inode(ext2_filsys fs,
1591 ext2_badblocks_list *bb_list);
1592
1593 /* read_bb_file.c */
1594 extern errcode_t ext2fs_read_bb_FILE2(ext2_filsys fs, FILE *f,
1595 ext2_badblocks_list *bb_list,
1596 void *priv_data,
1597 void (*invalid)(ext2_filsys fs,
1598 blk_t blk,
1599 char *badstr,
1600 void *priv_data));
1601 extern errcode_t ext2fs_read_bb_FILE(ext2_filsys fs, FILE *f,
1602 ext2_badblocks_list *bb_list,
1603 void (*invalid)(ext2_filsys fs,
1604 blk_t blk));
1605
1606 /* res_gdt.c */
1607 extern errcode_t ext2fs_create_resize_inode(ext2_filsys fs);
1608
1609 /*sha256.c */
1610 #define EXT2FS_SHA256_LENGTH 32
1611 #if 0
1612 extern void ext2fs_sha256(const unsigned char *in, unsigned long in_size,
1613 unsigned char out[EXT2FS_SHA256_LENGTH]);
1614 #endif
1615
1616 /* sha512.c */
1617 #define EXT2FS_SHA512_LENGTH 64
1618 extern void ext2fs_sha512(const unsigned char *in, unsigned long in_size,
1619 unsigned char out[EXT2FS_SHA512_LENGTH]);
1620
1621 /* swapfs.c */
1622 extern errcode_t ext2fs_dirent_swab_in2(ext2_filsys fs, char *buf, size_t size,
1623 int flags);
1624 extern errcode_t ext2fs_dirent_swab_in(ext2_filsys fs, char *buf, int flags);
1625 extern errcode_t ext2fs_dirent_swab_out2(ext2_filsys fs, char *buf, size_t size,
1626 int flags);
1627 extern errcode_t ext2fs_dirent_swab_out(ext2_filsys fs, char *buf, int flags);
1628 extern void ext2fs_swap_ext_attr(char *to, char *from, int bufsize,
1629 int has_header);
1630 extern void ext2fs_swap_ext_attr_header(struct ext2_ext_attr_header *to_header,
1631 struct ext2_ext_attr_header *from_hdr);
1632 extern void ext2fs_swap_ext_attr_entry(struct ext2_ext_attr_entry *to_entry,
1633 struct ext2_ext_attr_entry *from_entry);
1634 extern void ext2fs_swap_super(struct ext2_super_block * super);
1635 extern void ext2fs_swap_group_desc(struct ext2_group_desc *gdp);
1636 extern void ext2fs_swap_group_desc2(ext2_filsys, struct ext2_group_desc *gdp);
1637 extern void ext2fs_swap_inode_full(ext2_filsys fs, struct ext2_inode_large *t,
1638 struct ext2_inode_large *f, int hostorder,
1639 int bufsize);
1640 extern void ext2fs_swap_inode(ext2_filsys fs,struct ext2_inode *t,
1641 struct ext2_inode *f, int hostorder);
1642 extern void ext2fs_swap_mmp(struct mmp_struct *mmp);
1643
1644 /* unix_io.c */
1645 extern int ext2fs_open_file(const char *pathname, int flags, mode_t mode);
1646 extern int ext2fs_stat(const char *path, ext2fs_struct_stat *buf);
1647 extern int ext2fs_fstat(int fd, ext2fs_struct_stat *buf);
1648
1649 /* valid_blk.c */
1650 extern int ext2fs_inode_has_valid_blocks(struct ext2_inode *inode);
1651 extern int ext2fs_inode_has_valid_blocks2(ext2_filsys fs,
1652 struct ext2_inode *inode);
1653
1654 /* version.c */
1655 extern int ext2fs_parse_version_string(const char *ver_string);
1656 extern int ext2fs_get_library_version(const char **ver_string,
1657 const char **date_string);
1658
1659 /* write_bb_file.c */
1660 extern errcode_t ext2fs_write_bb_FILE(ext2_badblocks_list bb_list,
1661 unsigned int flags,
1662 FILE *f);
1663
1664
1665 /* inline functions */
1666 #ifdef NO_INLINE_FUNCS
1667 extern void ext2fs_init_csum_seed(ext2_filsys fs);
1668 extern errcode_t ext2fs_get_mem(unsigned long size, void *ptr);
1669 extern errcode_t ext2fs_get_memzero(unsigned long size, void *ptr);
1670 extern errcode_t ext2fs_get_array(unsigned long count,
1671 unsigned long size, void *ptr);
1672 extern errcode_t ext2fs_get_arrayzero(unsigned long count,
1673 unsigned long size, void *ptr);
1674 extern errcode_t ext2fs_free_mem(void *ptr);
1675 extern errcode_t ext2fs_resize_mem(unsigned long old_size,
1676 unsigned long size, void *ptr);
1677 extern void ext2fs_mark_super_dirty(ext2_filsys fs);
1678 extern void ext2fs_mark_changed(ext2_filsys fs);
1679 extern int ext2fs_test_changed(ext2_filsys fs);
1680 extern void ext2fs_mark_valid(ext2_filsys fs);
1681 extern void ext2fs_unmark_valid(ext2_filsys fs);
1682 extern int ext2fs_test_valid(ext2_filsys fs);
1683 extern void ext2fs_mark_ib_dirty(ext2_filsys fs);
1684 extern void ext2fs_mark_bb_dirty(ext2_filsys fs);
1685 extern int ext2fs_test_ib_dirty(ext2_filsys fs);
1686 extern int ext2fs_test_bb_dirty(ext2_filsys fs);
1687 extern dgrp_t ext2fs_group_of_blk(ext2_filsys fs, blk_t blk);
1688 extern dgrp_t ext2fs_group_of_ino(ext2_filsys fs, ext2_ino_t ino);
1689 extern blk_t ext2fs_group_first_block(ext2_filsys fs, dgrp_t group);
1690 extern blk_t ext2fs_group_last_block(ext2_filsys fs, dgrp_t group);
1691 extern blk_t ext2fs_inode_data_blocks(ext2_filsys fs,
1692 struct ext2_inode *inode);
1693 extern unsigned int ext2fs_div_ceil(unsigned int a, unsigned int b);
1694 extern __u64 ext2fs_div64_ceil(__u64 a, __u64 b);
1695 extern int ext2fs_dirent_name_len(const struct ext2_dir_entry *entry);
1696 extern void ext2fs_dirent_set_name_len(struct ext2_dir_entry *entry, int len);
1697 extern int ext2fs_dirent_file_type(const struct ext2_dir_entry *entry);
1698 extern void ext2fs_dirent_set_file_type(struct ext2_dir_entry *entry, int type);
1699
1700 #endif
1701
1702 /*
1703 * The actual inlined functions definitions themselves...
1704 *
1705 * If NO_INLINE_FUNCS is defined, then we won't try to do inline
1706 * functions at all!
1707 */
1708 #if (defined(INCLUDE_INLINE_FUNCS) || !defined(NO_INLINE_FUNCS))
1709 #ifdef INCLUDE_INLINE_FUNCS
1710 #define _INLINE_ extern
1711 #else
1712 #if (__STDC_VERSION__ >= 199901L)
1713 #define _INLINE_ inline
1714 #else
1715 #ifdef __GNUC__
1716 #define _INLINE_ extern __inline__
1717 #else /* For Watcom C */
1718 #define _INLINE_ extern inline
1719 #endif /* __GNUC__ */
1720 #endif /* __STDC_VERSION__ >= 199901L */
1721 #endif
1722
1723 _INLINE_ void ext2fs_init_csum_seed(ext2_filsys fs)
1724 {
1725 if (!EXT2_HAS_RO_COMPAT_FEATURE(fs->super,
1726 EXT4_FEATURE_RO_COMPAT_METADATA_CSUM))
1727 return;
1728
1729 fs->csum_seed = ext2fs_crc32c_le(~0, fs->super->s_uuid,
1730 sizeof(fs->super->s_uuid));
1731 }
1732
1733 #ifndef EXT2_CUSTOM_MEMORY_ROUTINES
1734 #include <string.h>
1735 /*
1736 * Allocate memory. The 'ptr' arg must point to a pointer.
1737 */
1738 _INLINE_ errcode_t ext2fs_get_mem(unsigned long size, void *ptr)
1739 {
1740 void *pp;
1741
1742 pp = malloc(size);
1743 if (!pp)
1744 return EXT2_ET_NO_MEMORY;
1745 memcpy(ptr, &pp, sizeof (pp));
1746 return 0;
1747 }
1748
1749 _INLINE_ errcode_t ext2fs_get_memzero(unsigned long size, void *ptr)
1750 {
1751 void *pp;
1752
1753 pp = malloc(size);
1754 if (!pp)
1755 return EXT2_ET_NO_MEMORY;
1756 memset(pp, 0, size);
1757 memcpy(ptr, &pp, sizeof(pp));
1758 return 0;
1759 }
1760
1761 _INLINE_ errcode_t ext2fs_get_array(unsigned long count, unsigned long size, void *ptr)
1762 {
1763 if (count && (~0UL)/count < size)
1764 return EXT2_ET_NO_MEMORY;
1765 return ext2fs_get_mem(count*size, ptr);
1766 }
1767
1768 _INLINE_ errcode_t ext2fs_get_arrayzero(unsigned long count,
1769 unsigned long size, void *ptr)
1770 {
1771 void *pp;
1772
1773 if (count && (~0UL)/count < size)
1774 return EXT2_ET_NO_MEMORY;
1775 pp = calloc(count, size);
1776 if (!pp)
1777 return EXT2_ET_NO_MEMORY;
1778 memcpy(ptr, &pp, sizeof(pp));
1779 return 0;
1780 }
1781
1782 /*
1783 * Free memory. The 'ptr' arg must point to a pointer.
1784 */
1785 _INLINE_ errcode_t ext2fs_free_mem(void *ptr)
1786 {
1787 void *p;
1788
1789 memcpy(&p, ptr, sizeof(p));
1790 free(p);
1791 p = 0;
1792 memcpy(ptr, &p, sizeof(p));
1793 return 0;
1794 }
1795
1796 /*
1797 * Resize memory. The 'ptr' arg must point to a pointer.
1798 */
1799 _INLINE_ errcode_t ext2fs_resize_mem(unsigned long EXT2FS_ATTR((unused)) old_size,
1800 unsigned long size, void *ptr)
1801 {
1802 void *p;
1803
1804 /* Use "memcpy" for pointer assignments here to avoid problems
1805 * with C99 strict type aliasing rules. */
1806 memcpy(&p, ptr, sizeof(p));
1807 p = realloc(p, size);
1808 if (!p)
1809 return EXT2_ET_NO_MEMORY;
1810 memcpy(ptr, &p, sizeof(p));
1811 return 0;
1812 }
1813 #endif /* Custom memory routines */
1814
1815 /*
1816 * Mark a filesystem superblock as dirty
1817 */
1818 _INLINE_ void ext2fs_mark_super_dirty(ext2_filsys fs)
1819 {
1820 fs->flags |= EXT2_FLAG_DIRTY | EXT2_FLAG_CHANGED;
1821 }
1822
1823 /*
1824 * Mark a filesystem as changed
1825 */
1826 _INLINE_ void ext2fs_mark_changed(ext2_filsys fs)
1827 {
1828 fs->flags |= EXT2_FLAG_CHANGED;
1829 }
1830
1831 /*
1832 * Check to see if a filesystem has changed
1833 */
1834 _INLINE_ int ext2fs_test_changed(ext2_filsys fs)
1835 {
1836 return (fs->flags & EXT2_FLAG_CHANGED);
1837 }
1838
1839 /*
1840 * Mark a filesystem as valid
1841 */
1842 _INLINE_ void ext2fs_mark_valid(ext2_filsys fs)
1843 {
1844 fs->flags |= EXT2_FLAG_VALID;
1845 }
1846
1847 /*
1848 * Mark a filesystem as NOT valid
1849 */
1850 _INLINE_ void ext2fs_unmark_valid(ext2_filsys fs)
1851 {
1852 fs->flags &= ~EXT2_FLAG_VALID;
1853 }
1854
1855 /*
1856 * Check to see if a filesystem is valid
1857 */
1858 _INLINE_ int ext2fs_test_valid(ext2_filsys fs)
1859 {
1860 return (fs->flags & EXT2_FLAG_VALID);
1861 }
1862
1863 /*
1864 * Mark the inode bitmap as dirty
1865 */
1866 _INLINE_ void ext2fs_mark_ib_dirty(ext2_filsys fs)
1867 {
1868 fs->flags |= EXT2_FLAG_IB_DIRTY | EXT2_FLAG_CHANGED;
1869 }
1870
1871 /*
1872 * Mark the block bitmap as dirty
1873 */
1874 _INLINE_ void ext2fs_mark_bb_dirty(ext2_filsys fs)
1875 {
1876 fs->flags |= EXT2_FLAG_BB_DIRTY | EXT2_FLAG_CHANGED;
1877 }
1878
1879 /*
1880 * Check to see if a filesystem's inode bitmap is dirty
1881 */
1882 _INLINE_ int ext2fs_test_ib_dirty(ext2_filsys fs)
1883 {
1884 return (fs->flags & EXT2_FLAG_IB_DIRTY);
1885 }
1886
1887 /*
1888 * Check to see if a filesystem's block bitmap is dirty
1889 */
1890 _INLINE_ int ext2fs_test_bb_dirty(ext2_filsys fs)
1891 {
1892 return (fs->flags & EXT2_FLAG_BB_DIRTY);
1893 }
1894
1895 /*
1896 * Return the group # of a block
1897 */
1898 _INLINE_ dgrp_t ext2fs_group_of_blk(ext2_filsys fs, blk_t blk)
1899 {
1900 return ext2fs_group_of_blk2(fs, blk);
1901 }
1902 /*
1903 * Return the group # of an inode number
1904 */
1905 _INLINE_ dgrp_t ext2fs_group_of_ino(ext2_filsys fs, ext2_ino_t ino)
1906 {
1907 return (ino - 1) / fs->super->s_inodes_per_group;
1908 }
1909
1910 /*
1911 * Return the first block (inclusive) in a group
1912 */
1913 _INLINE_ blk_t ext2fs_group_first_block(ext2_filsys fs, dgrp_t group)
1914 {
1915 return (blk_t) ext2fs_group_first_block2(fs, group);
1916 }
1917
1918 /*
1919 * Return the last block (inclusive) in a group
1920 */
1921 _INLINE_ blk_t ext2fs_group_last_block(ext2_filsys fs, dgrp_t group)
1922 {
1923 return (blk_t) ext2fs_group_last_block2(fs, group);
1924 }
1925
1926 _INLINE_ blk_t ext2fs_inode_data_blocks(ext2_filsys fs,
1927 struct ext2_inode *inode)
1928 {
1929 return (blk_t) ext2fs_inode_data_blocks2(fs, inode);
1930 }
1931
1932 /*
1933 * This is an efficient, overflow safe way of calculating ceil((1.0 * a) / b)
1934 */
1935 _INLINE_ unsigned int ext2fs_div_ceil(unsigned int a, unsigned int b)
1936 {
1937 if (!a)
1938 return 0;
1939 return ((a - 1) / b) + 1;
1940 }
1941
1942 _INLINE_ __u64 ext2fs_div64_ceil(__u64 a, __u64 b)
1943 {
1944 if (!a)
1945 return 0;
1946 return ((a - 1) / b) + 1;
1947 }
1948
1949 _INLINE_ int ext2fs_dirent_name_len(const struct ext2_dir_entry *entry)
1950 {
1951 return entry->name_len & 0xff;
1952 }
1953
1954 _INLINE_ void ext2fs_dirent_set_name_len(struct ext2_dir_entry *entry, int len)
1955 {
1956 entry->name_len = (entry->name_len & 0xff00) | (len & 0xff);
1957 }
1958
1959 _INLINE_ int ext2fs_dirent_file_type(const struct ext2_dir_entry *entry)
1960 {
1961 return entry->name_len >> 8;
1962 }
1963
1964 _INLINE_ void ext2fs_dirent_set_file_type(struct ext2_dir_entry *entry, int type)
1965 {
1966 entry->name_len = (entry->name_len & 0xff) | (type << 8);
1967 }
1968
1969 #undef _INLINE_
1970 #endif
1971
1972 #ifdef __cplusplus
1973 }
1974 #endif
1975
1976 #endif /* _EXT2FS_EXT2FS_H */