2 * extent.c --- routines to implement extents support
4 * Copyright (C) 2007 Theodore Ts'o.
7 * This file may be redistributed under the terms of the GNU Public
24 #include <sys/types.h>
32 * Definitions to be dropped in lib/ext2fs/ext2fs.h
51 struct ext2_extent_handle {
55 struct ext2_inode *inode;
59 struct extent_path *path;
62 struct ext2_extent_path {
69 * Useful Debugging stuff
73 static void dbg_show_header(struct ext3_extent_header *eh)
75 printf("header: magic=%x entries=%u max=%u depth=%u generation=%u\n",
76 ext2fs_le16_to_cpu(eh->eh_magic),
77 ext2fs_le16_to_cpu(eh->eh_entries),
78 ext2fs_le16_to_cpu(eh->eh_max),
79 ext2fs_le16_to_cpu(eh->eh_depth),
80 ext2fs_le32_to_cpu(eh->eh_generation));
83 static void dbg_show_index(struct ext3_extent_idx *ix)
85 printf("index: block=%u leaf=%u leaf_hi=%u unused=%u\n",
86 ext2fs_le32_to_cpu(ix->ei_block),
87 ext2fs_le32_to_cpu(ix->ei_leaf),
88 ext2fs_le16_to_cpu(ix->ei_leaf_hi),
89 ext2fs_le16_to_cpu(ix->ei_unused));
92 static void dbg_show_extent(struct ext3_extent *ex)
94 printf("extent: block=%u-%u len=%u start=%u start_hi=%u\n",
95 ext2fs_le32_to_cpu(ex->ee_block),
96 ext2fs_le32_to_cpu(ex->ee_block) +
97 ext2fs_le16_to_cpu(ex->ee_len) - 1,
98 ext2fs_le16_to_cpu(ex->ee_len),
99 ext2fs_le32_to_cpu(ex->ee_start),
100 ext2fs_le16_to_cpu(ex->ee_start_hi));
103 static void dbg_print_extent(char *desc, struct ext2fs_extent *extent)
106 printf("%s: ", desc);
107 printf("extent: lblk %llu--%llu, len %lu, pblk %llu, flags: ",
108 extent->e_lblk, extent->e_lblk + extent->e_len - 1,
109 extent->e_len, extent->e_pblk);
110 if (extent->e_flags & EXT2_EXTENT_FLAGS_LEAF)
111 fputs("LEAF ", stdout);
112 if (extent->e_flags & EXT2_EXTENT_FLAGS_UNINIT)
113 fputs("UNINIT ", stdout);
114 if (extent->e_flags & EXT2_EXTENT_FLAGS_SECOND_VISIT)
115 fputs("2ND_VISIT ", stdout);
116 if (!extent->e_flags)
117 fputs("(none)", stdout);
123 #define dbg_show_header(eh) do { } while (0)
124 #define dbg_show_index(ix) do { } while (0)
125 #define dbg_show_extent(ex) do { } while (0)
126 #define dbg_print_extent(desc, ex) do { } while (0)
130 * Verify the extent header as being sane
132 errcode_t ext2fs_extent_header_verify(void *ptr, int size)
134 int eh_max, entry_size;
135 struct ext3_extent_header *eh = ptr;
138 if (ext2fs_le16_to_cpu(eh->eh_magic) != EXT3_EXT_MAGIC)
139 return EXT2_ET_EXTENT_HEADER_BAD;
140 if (ext2fs_le16_to_cpu(eh->eh_entries) > ext2fs_le16_to_cpu(eh->eh_max))
141 return EXT2_ET_EXTENT_HEADER_BAD;
142 if (eh->eh_depth == 0)
143 entry_size = sizeof(struct ext3_extent);
145 entry_size = sizeof(struct ext3_extent_idx);
147 eh_max = (size - sizeof(*eh)) / entry_size;
148 /* Allow two extent-sized items at the end of the block, for
149 * ext4_extent_tail with checksum in the future. */
150 if ((ext2fs_le16_to_cpu(eh->eh_max) > eh_max) ||
151 (ext2fs_le16_to_cpu(eh->eh_max) < (eh_max - 2)))
152 return EXT2_ET_EXTENT_HEADER_BAD;
159 * Begin functions to handle an inode's extent information
161 extern void ext2fs_extent_free(ext2_extent_handle_t handle)
169 ext2fs_free_mem(&handle->inode);
171 for (i=1; i <= handle->max_depth; i++) {
172 if (handle->path[i].buf)
173 ext2fs_free_mem(&handle->path[i].buf);
175 ext2fs_free_mem(&handle->path);
177 ext2fs_free_mem(&handle);
180 extern errcode_t ext2fs_extent_open(ext2_filsys fs, ext2_ino_t ino,
181 ext2_extent_handle_t *ret_handle)
183 return ext2fs_extent_open2(fs, ino, NULL, ret_handle);
186 extern errcode_t ext2fs_extent_open2(ext2_filsys fs, ext2_ino_t ino,
187 struct ext2_inode *inode,
188 ext2_extent_handle_t *ret_handle)
190 struct ext2_extent_handle *handle;
193 struct ext3_extent_header *eh;
195 EXT2_CHECK_MAGIC(fs, EXT2_ET_MAGIC_EXT2FS_FILSYS);
198 if ((ino == 0) || (ino > fs->super->s_inodes_count))
199 return EXT2_ET_BAD_INODE_NUM;
201 retval = ext2fs_get_mem(sizeof(struct ext2_extent_handle), &handle);
204 memset(handle, 0, sizeof(struct ext2_extent_handle));
206 retval = ext2fs_get_mem(sizeof(struct ext2_inode), &handle->inode);
214 memcpy(handle->inode, inode, sizeof(struct ext2_inode));
217 retval = ext2fs_read_inode(fs, ino, handle->inode);
222 eh = (struct ext3_extent_header *) &handle->inode->i_block[0];
224 for (i=0; i < EXT2_N_BLOCKS; i++)
225 if (handle->inode->i_block[i])
227 if (i >= EXT2_N_BLOCKS) {
228 eh->eh_magic = ext2fs_cpu_to_le16(EXT3_EXT_MAGIC);
231 i = (sizeof(handle->inode->i_block) - sizeof(*eh)) /
232 sizeof(struct ext3_extent);
233 eh->eh_max = ext2fs_cpu_to_le16(i);
234 handle->inode->i_flags |= EXT4_EXTENTS_FL;
237 if (!(handle->inode->i_flags & EXT4_EXTENTS_FL)) {
238 retval = EXT2_ET_INODE_NOT_EXTENT;
242 retval = ext2fs_extent_header_verify(eh, sizeof(handle->inode->i_block));
246 handle->max_depth = ext2fs_le16_to_cpu(eh->eh_depth);
247 handle->type = ext2fs_le16_to_cpu(eh->eh_magic);
249 retval = ext2fs_get_mem(((handle->max_depth+1) *
250 sizeof(struct extent_path)),
252 memset(handle->path, 0,
253 (handle->max_depth+1) * sizeof(struct extent_path));
254 handle->path[0].buf = (char *) handle->inode->i_block;
256 handle->path[0].left = handle->path[0].entries =
257 ext2fs_le16_to_cpu(eh->eh_entries);
258 handle->path[0].max_entries = ext2fs_le16_to_cpu(eh->eh_max);
259 handle->path[0].curr = 0;
260 handle->path[0].end_blk =
261 ((((__u64) handle->inode->i_size_high << 32) +
262 handle->inode->i_size + (fs->blocksize - 1))
263 >> EXT2_BLOCK_SIZE_BITS(fs->super));
264 handle->path[0].visit_num = 1;
266 handle->magic = EXT2_ET_MAGIC_EXTENT_HANDLE;
268 *ret_handle = handle;
272 ext2fs_extent_free(handle);
277 * This function is responsible for (optionally) moving through the
278 * extent tree and then returning the current extent
280 errcode_t ext2fs_extent_get(ext2_extent_handle_t handle,
281 int flags, struct ext2fs_extent *extent)
283 struct extent_path *path, *newpath;
284 struct ext3_extent_header *eh;
285 struct ext3_extent_idx *ix = 0;
286 struct ext3_extent *ex;
292 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
295 return EXT2_ET_NO_CURRENT_NODE;
297 orig_op = op = flags & EXT2_EXTENT_MOVE_MASK;
300 path = handle->path + handle->level;
301 if ((orig_op == EXT2_EXTENT_NEXT) ||
302 (orig_op == EXT2_EXTENT_NEXT_LEAF)) {
303 if (handle->level < handle->max_depth) {
305 if (path->visit_num == 0) {
307 op = EXT2_EXTENT_DOWN;
308 } else if (path->left > 0)
309 op = EXT2_EXTENT_NEXT_SIB;
310 else if (handle->level > 0)
313 return EXT2_ET_EXTENT_NO_NEXT;
317 op = EXT2_EXTENT_NEXT_SIB;
318 else if (handle->level > 0)
321 return EXT2_ET_EXTENT_NO_NEXT;
323 if (op != EXT2_EXTENT_NEXT_SIB) {
325 printf("<<<< OP = %s\n",
326 (op == EXT2_EXTENT_DOWN) ? "down" :
327 ((op == EXT2_EXTENT_UP) ? "up" : "unknown"));
332 if ((orig_op == EXT2_EXTENT_PREV) ||
333 (orig_op == EXT2_EXTENT_PREV_LEAF)) {
334 if (handle->level < handle->max_depth) {
336 if (path->visit_num > 0 ) {
337 /* path->visit_num = 0; */
338 op = EXT2_EXTENT_DOWN_AND_LAST;
339 } else if (path->left < path->entries-1)
340 op = EXT2_EXTENT_PREV_SIB;
341 else if (handle->level > 0)
344 return EXT2_ET_EXTENT_NO_PREV;
347 if (path->left < path->entries-1)
348 op = EXT2_EXTENT_PREV_SIB;
349 else if (handle->level > 0)
352 return EXT2_ET_EXTENT_NO_PREV;
354 if (op != EXT2_EXTENT_PREV_SIB) {
356 printf("<<<< OP = %s\n",
357 (op == EXT2_EXTENT_DOWN_AND_LAST) ? "down/last" :
358 ((op == EXT2_EXTENT_UP) ? "up" : "unknown"));
363 if (orig_op == EXT2_EXTENT_LAST_LEAF) {
364 if ((handle->level < handle->max_depth) &&
366 op = EXT2_EXTENT_DOWN;
368 op = EXT2_EXTENT_LAST_SIB;
370 printf("<<<< OP = %s\n",
371 (op == EXT2_EXTENT_DOWN) ? "down" : "last_sib");
376 case EXT2_EXTENT_CURRENT:
379 case EXT2_EXTENT_ROOT:
381 path = handle->path + handle->level;
382 case EXT2_EXTENT_FIRST_SIB:
383 path->left = path->entries;
385 case EXT2_EXTENT_NEXT_SIB:
387 return EXT2_ET_EXTENT_NO_NEXT;
392 eh = (struct ext3_extent_header *) path->buf;
393 ix = EXT_FIRST_INDEX(eh);
399 case EXT2_EXTENT_PREV_SIB:
401 path->left+1 >= path->entries)
402 return EXT2_ET_EXTENT_NO_PREV;
407 if (handle->level < handle->max_depth)
410 case EXT2_EXTENT_LAST_SIB:
411 eh = (struct ext3_extent_header *) path->buf;
412 path->curr = EXT_LAST_EXTENT(eh);
418 if (handle->level <= 0)
419 return EXT2_ET_EXTENT_NO_UP;
423 if ((orig_op == EXT2_EXTENT_PREV) ||
424 (orig_op == EXT2_EXTENT_PREV_LEAF))
427 case EXT2_EXTENT_DOWN:
428 case EXT2_EXTENT_DOWN_AND_LAST:
429 if (!path->curr ||(handle->level >= handle->max_depth))
430 return EXT2_ET_EXTENT_NO_DOWN;
435 retval = ext2fs_get_mem(handle->fs->blocksize,
440 blk = ext2fs_le32_to_cpu(ix->ei_leaf) +
441 ((__u64) ext2fs_le16_to_cpu(ix->ei_leaf_hi) << 32);
442 if ((handle->fs->flags & EXT2_FLAG_IMAGE_FILE) &&
443 (handle->fs->io != handle->fs->image_io))
444 memset(newpath->buf, 0, handle->fs->blocksize);
446 retval = io_channel_read_blk(handle->fs->io,
447 blk, 1, newpath->buf);
453 eh = (struct ext3_extent_header *) newpath->buf;
455 retval = ext2fs_extent_header_verify(eh, handle->fs->blocksize);
461 newpath->left = newpath->entries =
462 ext2fs_le16_to_cpu(eh->eh_entries);
463 newpath->max_entries = ext2fs_le16_to_cpu(eh->eh_max);
465 if (path->left > 0) {
467 newpath->end_blk = ext2fs_le32_to_cpu(ix->ei_block);
469 newpath->end_blk = path->end_blk;
472 if (op == EXT2_EXTENT_DOWN) {
473 ix = EXT_FIRST_INDEX((struct ext3_extent_header *) eh);
475 path->left = path->entries - 1;
478 ix = EXT_LAST_INDEX((struct ext3_extent_header *) eh);
481 if (handle->level < handle->max_depth)
485 printf("Down to level %d/%d, end_blk=%llu\n",
486 handle->level, handle->max_depth,
491 return EXT2_ET_OP_NOT_SUPPORTED;
495 return EXT2_ET_NO_CURRENT_NODE;
499 printf("(Left %d)\n", path->left);
502 if (handle->level == handle->max_depth) {
503 ex = (struct ext3_extent *) ix;
505 extent->e_pblk = ext2fs_le32_to_cpu(ex->ee_start) +
506 ((__u64) ext2fs_le16_to_cpu(ex->ee_start_hi) << 32);
507 extent->e_lblk = ext2fs_le32_to_cpu(ex->ee_block);
508 extent->e_len = ext2fs_le16_to_cpu(ex->ee_len);
509 extent->e_flags |= EXT2_EXTENT_FLAGS_LEAF;
510 if (extent->e_len > EXT_INIT_MAX_LEN) {
511 extent->e_len -= EXT_INIT_MAX_LEN;
512 extent->e_flags |= EXT2_EXTENT_FLAGS_UNINIT;
515 extent->e_pblk = ext2fs_le32_to_cpu(ix->ei_leaf) +
516 ((__u64) ext2fs_le16_to_cpu(ix->ei_leaf_hi) << 32);
517 extent->e_lblk = ext2fs_le32_to_cpu(ix->ei_block);
518 if (path->left > 0) {
520 end_blk = ext2fs_le32_to_cpu(ix->ei_block);
522 end_blk = path->end_blk;
524 extent->e_len = end_blk - extent->e_lblk;
527 extent->e_flags |= EXT2_EXTENT_FLAGS_SECOND_VISIT;
529 if (((orig_op == EXT2_EXTENT_NEXT_LEAF) ||
530 (orig_op == EXT2_EXTENT_PREV_LEAF)) &&
531 (handle->level != handle->max_depth))
534 if ((orig_op == EXT2_EXTENT_LAST_LEAF) &&
535 ((handle->level != handle->max_depth) ||
542 static errcode_t update_path(ext2_extent_handle_t handle)
546 struct ext3_extent_idx *ix;
548 if (handle->level == 0) {
549 retval = ext2fs_write_inode(handle->fs, handle->ino,
552 ix = handle->path[handle->level - 1].curr;
553 blk = ext2fs_le32_to_cpu(ix->ei_leaf) +
554 ((__u64) ext2fs_le16_to_cpu(ix->ei_leaf_hi) << 32);
556 retval = io_channel_write_blk(handle->fs->io,
557 blk, 1, handle->path[handle->level].buf);
563 errcode_t ext2fs_extent_save_path(ext2_extent_handle_t handle,
564 ext2_extent_path_t *ret_path)
566 ext2_extent_path_t save_path;
567 struct ext2fs_extent extent;
568 struct ext2_extent_info info;
571 retval = ext2fs_extent_get(handle, EXT2_EXTENT_CURRENT, &extent);
575 retval = ext2fs_extent_get_info(handle, &info);
579 retval = ext2fs_get_mem(sizeof(struct ext2_extent_path), &save_path);
582 memset(save_path, 0, sizeof(struct ext2_extent_path));
584 save_path->magic = EXT2_ET_MAGIC_EXTENT_PATH;
585 save_path->leaf_height = info.max_depth - info.curr_level - 1;
586 save_path->lblk = extent.e_lblk;
588 *ret_path = save_path;
592 errcode_t ext2fs_extent_free_path(ext2_extent_path_t path)
594 EXT2_CHECK_MAGIC(path, EXT2_ET_MAGIC_EXTENT_PATH);
596 ext2fs_free_mem(&path);
602 * Go to the node at leaf_level which contains logical block blk.
604 * leaf_level is height from the leaf node level, i.e.
605 * leaf_level 0 is at leaf node, leaf_level 1 is 1 above etc.
607 * If "blk" has no mapping (hole) then handle is left at last
610 static errcode_t extent_goto(ext2_extent_handle_t handle,
611 int leaf_level, blk64_t blk)
613 struct ext2fs_extent extent;
616 retval = ext2fs_extent_get(handle, EXT2_EXTENT_ROOT, &extent);
618 if (retval == EXT2_ET_EXTENT_NO_NEXT)
619 retval = EXT2_ET_EXTENT_NOT_FOUND;
623 if (leaf_level > handle->max_depth) {
625 printf("leaf level %d greater than tree depth %d\n",
626 leaf_level, handle->max_depth);
628 return EXT2_ET_OP_NOT_SUPPORTED;
631 dbg_print_extent("root", &extent);
633 if (handle->max_depth - handle->level == leaf_level) {
634 /* block is in this &extent */
635 if ((blk >= extent.e_lblk) &&
636 (blk < extent.e_lblk + extent.e_len))
638 if (blk < extent.e_lblk) {
639 retval = ext2fs_extent_get(handle,
640 EXT2_EXTENT_PREV_SIB,
642 return EXT2_ET_EXTENT_NOT_FOUND;
644 retval = ext2fs_extent_get(handle,
645 EXT2_EXTENT_NEXT_SIB,
647 if (retval == EXT2_ET_EXTENT_NO_NEXT)
648 return EXT2_ET_EXTENT_NOT_FOUND;
654 retval = ext2fs_extent_get(handle, EXT2_EXTENT_NEXT_SIB,
656 if (retval == EXT2_ET_EXTENT_NO_NEXT)
661 dbg_print_extent("next", &extent);
662 if (blk == extent.e_lblk)
664 if (blk > extent.e_lblk)
667 retval = ext2fs_extent_get(handle, EXT2_EXTENT_PREV_SIB,
672 dbg_print_extent("prev", &extent);
675 retval = ext2fs_extent_get(handle, EXT2_EXTENT_DOWN,
680 dbg_print_extent("down", &extent);
684 errcode_t ext2fs_extent_goto(ext2_extent_handle_t handle,
687 return extent_goto(handle, 0, blk);
691 * Traverse back up to root fixing parents of current node as needed.
693 * If we changed start of first entry in a node, fix parent index start
696 * Safe to call for any position in node; if not at the first entry,
697 * will simply return.
699 static errcode_t ext2fs_extent_fix_parents(ext2_extent_handle_t handle)
703 struct extent_path *path;
704 struct ext2fs_extent extent;
706 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
708 if (!(handle->fs->flags & EXT2_FLAG_RW))
709 return EXT2_ET_RO_FILSYS;
712 return EXT2_ET_NO_CURRENT_NODE;
714 path = handle->path + handle->level;
716 return EXT2_ET_NO_CURRENT_NODE;
718 retval = ext2fs_extent_get(handle, EXT2_EXTENT_CURRENT, &extent);
722 /* modified node's start block */
723 start = extent.e_lblk;
725 /* traverse up until index not first, or startblk matches, or top */
726 while (handle->level > 0 &&
727 (path->left == path->entries - 1)) {
728 retval = ext2fs_extent_get(handle, EXT2_EXTENT_UP, &extent);
731 if (extent.e_lblk == start)
733 path = handle->path + handle->level;
734 extent.e_len += (extent.e_lblk - start);
735 extent.e_lblk = start;
736 retval = ext2fs_extent_replace(handle, 0, &extent);
742 /* put handle back to where we started */
743 retval = ext2fs_extent_goto(handle, start);
748 errcode_t ext2fs_extent_replace(ext2_extent_handle_t handle,
749 int flags EXT2FS_ATTR((unused)),
750 struct ext2fs_extent *extent)
752 struct extent_path *path;
753 struct ext3_extent_idx *ix;
754 struct ext3_extent *ex;
756 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
758 if (!(handle->fs->flags & EXT2_FLAG_RW))
759 return EXT2_ET_RO_FILSYS;
762 return EXT2_ET_NO_CURRENT_NODE;
764 path = handle->path + handle->level;
766 return EXT2_ET_NO_CURRENT_NODE;
768 if (handle->level == handle->max_depth) {
771 ex->ee_block = ext2fs_cpu_to_le32(extent->e_lblk);
772 ex->ee_start = ext2fs_cpu_to_le32(extent->e_pblk & 0xFFFFFFFF);
773 ex->ee_start_hi = ext2fs_cpu_to_le16(extent->e_pblk >> 32);
774 if (extent->e_flags & EXT2_EXTENT_FLAGS_UNINIT) {
775 if (extent->e_len > EXT_UNINIT_MAX_LEN)
776 return EXT2_ET_EXTENT_INVALID_LENGTH;
777 ex->ee_len = ext2fs_cpu_to_le16(extent->e_len +
780 if (extent->e_len > EXT_INIT_MAX_LEN)
781 return EXT2_ET_EXTENT_INVALID_LENGTH;
782 ex->ee_len = ext2fs_cpu_to_le16(extent->e_len);
787 ix->ei_leaf = ext2fs_cpu_to_le32(extent->e_pblk & 0xFFFFFFFF);
788 ix->ei_leaf_hi = ext2fs_cpu_to_le16(extent->e_pblk >> 32);
789 ix->ei_block = ext2fs_cpu_to_le32(extent->e_lblk);
797 * allocate a new block, move half the current node to it, and update parent
799 * handle will be left pointing at original record.
801 static errcode_t extent_node_split(ext2_extent_handle_t handle)
803 errcode_t retval = 0;
805 blk64_t new_node_start;
807 blk64_t goal_blk = 0;
809 char *block_buf = NULL;
810 struct ext2fs_extent extent;
811 struct extent_path *path, *newpath = 0;
812 struct ext3_extent_header *eh, *neweh;
815 struct ext2_extent_info info;
818 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
820 if (!(handle->fs->flags & EXT2_FLAG_RW))
821 return EXT2_ET_RO_FILSYS;
824 return EXT2_ET_NO_CURRENT_NODE;
827 printf("splitting node at level %d\n", handle->level);
829 retval = ext2fs_extent_get(handle, EXT2_EXTENT_CURRENT, &extent);
833 retval = ext2fs_extent_get_info(handle, &info);
837 /* save the position we were originally splitting... */
838 orig_height = info.max_depth - info.curr_level;
839 orig_lblk = extent.e_lblk;
841 /* Is there room in the parent for a new entry? */
843 (handle->path[handle->level - 1].entries >=
844 handle->path[handle->level - 1].max_entries)) {
847 printf("parent level %d full; splitting it too\n",
850 /* split the parent */
851 retval = ext2fs_extent_get(handle, EXT2_EXTENT_UP, &extent);
854 goal_blk = extent.e_pblk;
856 retval = extent_node_split(handle);
860 /* get handle back to our original split position */
861 retval = extent_goto(handle, orig_height, orig_lblk);
866 /* At this point, parent should have room for this split */
867 path = handle->path + handle->level;
869 return EXT2_ET_NO_CURRENT_NODE;
871 /* extent header of the current node we'll split */
872 eh = (struct ext3_extent_header *)path->buf;
874 /* splitting root level means moving them all out */
875 if (handle->level == 0) {
877 tocopy = ext2fs_le16_to_cpu(eh->eh_entries);
878 retval = ext2fs_get_mem(((handle->max_depth+2) *
879 sizeof(struct extent_path)),
884 ((handle->max_depth+2) * sizeof(struct extent_path)));
886 tocopy = ext2fs_le16_to_cpu(eh->eh_entries) / 2;
890 printf("will copy out %d of %d entries at level %d\n",
891 tocopy, ext2fs_le16_to_cpu(eh->eh_entries),
897 printf("Nothing to copy to new block!\n");
899 retval = EXT2_ET_CANT_SPLIT_EXTENT;
903 /* first we need a new block, or can do nothing. */
904 block_buf = malloc(handle->fs->blocksize);
911 dgrp_t group = ext2fs_group_of_ino(handle->fs, handle->ino);
912 __u8 log_flex = handle->fs->super->s_log_groups_per_flex;
915 group = group & ~((1 << (log_flex)) - 1);
916 goal_blk = (group * handle->fs->super->s_blocks_per_group) +
917 handle->fs->super->s_first_data_block;
919 retval = ext2fs_alloc_block(handle->fs, (blk_t) goal_blk, block_buf,
925 printf("will copy to new node at block %lu\n", new_node_pblk);
928 /* Copy data into new block buffer */
929 /* First the header for the new block... */
930 neweh = (struct ext3_extent_header *) block_buf;
931 memcpy(neweh, eh, sizeof(struct ext3_extent_header));
932 neweh->eh_entries = ext2fs_cpu_to_le16(tocopy);
933 neweh->eh_max = ext2fs_cpu_to_le16((handle->fs->blocksize -
934 sizeof(struct ext3_extent_header)) /
935 sizeof(struct ext3_extent));
937 /* then the entries for the new block... */
938 memcpy(EXT_FIRST_INDEX(neweh),
939 EXT_FIRST_INDEX(eh) +
940 (ext2fs_le16_to_cpu(eh->eh_entries) - tocopy),
941 sizeof(struct ext3_extent_idx) * tocopy);
943 new_node_start = ext2fs_le32_to_cpu(EXT_FIRST_INDEX(neweh)->ei_block);
945 /* ...and write the new node block out to disk. */
946 retval = io_channel_write_blk(handle->fs->io, new_node_pblk, 1, block_buf);
951 /* OK! we've created the new node; now adjust the tree */
953 /* current path now has fewer active entries, we copied some out */
954 if (handle->level == 0) {
955 memcpy(newpath, path,
956 sizeof(struct extent_path) * (handle->max_depth+1));
957 handle->path = newpath;
961 path->left = path->max_entries - 1;
963 eh->eh_depth = ext2fs_cpu_to_le16(handle->max_depth);
965 path->entries -= tocopy;
966 path->left -= tocopy;
969 eh->eh_entries = ext2fs_cpu_to_le16(path->entries);
970 /* this writes out the node, incl. the modified header */
971 retval = update_path(handle);
975 /* now go up and insert/replace index for new node we created */
977 retval = ext2fs_extent_get(handle, EXT2_EXTENT_FIRST_SIB, &extent);
981 extent.e_lblk = new_node_start;
982 extent.e_pblk = new_node_pblk;
983 extent.e_len = handle->path[0].end_blk - extent.e_lblk;
984 retval = ext2fs_extent_replace(handle, 0, &extent);
988 __u32 new_node_length;
990 retval = ext2fs_extent_get(handle, EXT2_EXTENT_UP, &extent);
991 /* will insert after this one; it's length is shorter now */
992 new_node_length = new_node_start - extent.e_lblk;
993 extent.e_len -= new_node_length;
994 retval = ext2fs_extent_replace(handle, 0, &extent);
998 /* now set up the new extent and insert it */
999 extent.e_lblk = new_node_start;
1000 extent.e_pblk = new_node_pblk;
1001 extent.e_len = new_node_length;
1002 retval = ext2fs_extent_insert(handle, EXT2_EXTENT_INSERT_AFTER, &extent);
1007 /* get handle back to our original position */
1008 retval = extent_goto(handle, orig_height, orig_lblk);
1012 /* new node hooked in, so update inode block count (do this here?) */
1013 handle->inode->i_blocks += handle->fs->blocksize / 512;
1014 retval = ext2fs_write_inode(handle->fs, handle->ino,
1021 ext2fs_free_mem(&newpath);
1027 errcode_t ext2fs_extent_insert(ext2_extent_handle_t handle, int flags,
1028 struct ext2fs_extent *extent)
1030 struct extent_path *path;
1031 struct ext3_extent_idx *ix;
1032 struct ext3_extent_header *eh;
1035 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
1037 if (!(handle->fs->flags & EXT2_FLAG_RW))
1038 return EXT2_ET_RO_FILSYS;
1041 return EXT2_ET_NO_CURRENT_NODE;
1043 path = handle->path + handle->level;
1045 if (path->entries >= path->max_entries) {
1046 if (flags & EXT2_EXTENT_INSERT_NOSPLIT) {
1047 return EXT2_ET_CANT_INSERT_EXTENT;
1050 printf("node full (level %d) - splitting\n",
1053 retval = extent_node_split(handle);
1056 path = handle->path + handle->level;
1060 eh = (struct ext3_extent_header *) path->buf;
1063 if (flags & EXT2_EXTENT_INSERT_AFTER) {
1068 ix = EXT_FIRST_INDEX(eh);
1072 if (path->left >= 0)
1074 (path->left+1) * sizeof(struct ext3_extent_idx));
1078 eh = (struct ext3_extent_header *) path->buf;
1079 eh->eh_entries = ext2fs_cpu_to_le16(path->entries);
1081 retval = ext2fs_extent_replace(handle, 0, extent);
1085 retval = update_path(handle);
1092 ext2fs_extent_delete(handle, 0);
1097 * Sets the physical block for a logical file block in the extent tree.
1099 * May: map unmapped, unmap mapped, or remap mapped blocks.
1101 * Mapping an unmapped block adds a single-block extent.
1103 * Unmapping first or last block modifies extent in-place
1104 * - But may need to fix parent's starts too in first-block case
1106 * Mapping any unmapped block requires adding a (single-block) extent
1107 * and inserting into proper point in tree.
1109 * Modifying (unmapping or remapping) a block in the middle
1110 * of an extent requires splitting the extent.
1111 * - Remapping case requires new single-block extent.
1113 * Remapping first or last block adds an extent.
1115 * We really need extent adding to be smart about merging.
1118 errcode_t ext2fs_extent_set_bmap(ext2_extent_handle_t handle,
1119 blk64_t logical, blk64_t physical, int flags)
1121 errcode_t ec, retval = 0;
1122 int mapped = 1; /* logical is mapped? */
1124 int extent_uninit = 0;
1126 int max_len = EXT_INIT_MAX_LEN;
1128 struct extent_path *path;
1129 struct ext2fs_extent extent;
1130 struct ext2fs_extent newextent;
1131 struct ext2_extent_info info;
1133 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
1135 if (!(handle->fs->flags & EXT2_FLAG_RW))
1136 return EXT2_ET_RO_FILSYS;
1139 return EXT2_ET_NO_CURRENT_NODE;
1141 path = handle->path + handle->level;
1143 if (flags & EXT2_EXTENT_SET_BMAP_UNINIT) {
1145 max_len = EXT_UNINIT_MAX_LEN;
1148 /* if (re)mapping, set up new extent to insert */
1150 newextent.e_len = 1;
1151 newextent.e_pblk = physical;
1152 newextent.e_lblk = logical;
1153 newextent.e_flags = EXT2_EXTENT_FLAGS_LEAF;
1155 newextent.e_flags |= EXT2_EXTENT_FLAGS_UNINIT;
1158 /* special case if the extent tree is completely empty */
1159 if ((handle->max_depth == 0) && (path->entries == 0)) {
1160 retval = ext2fs_extent_insert(handle, 0, &newextent);
1164 /* save our original location in the extent tree */
1165 if ((retval = ext2fs_extent_get(handle, EXT2_EXTENT_CURRENT,
1167 if (retval != EXT2_ET_NO_CURRENT_NODE)
1169 memset(&extent, 0, sizeof(extent));
1171 if ((retval = ext2fs_extent_get_info(handle, &info)))
1173 orig_height = info.max_depth - info.curr_level;
1174 orig_lblk = extent.e_lblk;
1177 /* go to the logical spot we want to (re/un)map */
1178 retval = ext2fs_extent_goto(handle, logical);
1180 if (retval == EXT2_ET_EXTENT_NOT_FOUND) {
1185 printf("block %llu already unmapped\n",
1195 * This may be the extent *before* the requested logical,
1196 * if it's currently unmapped.
1198 retval = ext2fs_extent_get(handle, EXT2_EXTENT_CURRENT, &extent);
1201 if (extent.e_flags & EXT2_EXTENT_FLAGS_UNINIT)
1204 /* check if already pointing to the requested physical */
1205 if (mapped && (new_uninit == extent_uninit) &&
1206 (extent.e_pblk + (logical - extent.e_lblk) == physical)) {
1208 printf("physical block (at %llu) unchanged\n", logical);
1215 printf("mapping unmapped logical block %llu\n", logical);
1217 if ((logical == extent.e_lblk + extent.e_len) &&
1218 (physical == extent.e_pblk + extent.e_len) &&
1219 (new_uninit == extent_uninit) &&
1220 ((int) extent.e_len < max_len-1)) {
1222 retval = ext2fs_extent_replace(handle, 0, &extent);
1223 } else if (logical < extent.e_lblk)
1224 retval = ext2fs_extent_insert(handle, 0, &newextent);
1226 retval = ext2fs_extent_insert(handle,
1227 EXT2_EXTENT_INSERT_AFTER, &newextent);
1230 retval = ext2fs_extent_fix_parents(handle);
1233 } else if ((logical == extent.e_lblk) && (extent.e_len == 1)) {
1235 printf("(re/un)mapping only block in extent\n");
1238 retval = ext2fs_extent_replace(handle, 0, &newextent);
1240 retval = ext2fs_extent_delete(handle, 0);
1243 ec = ext2fs_extent_fix_parents(handle);
1244 if (ec != EXT2_ET_NO_CURRENT_NODE)
1250 } else if (logical == extent.e_lblk + extent.e_len - 1) {
1252 printf("(re/un)mapping last block in extent\n");
1254 /* Make sure insert works before replacing old extent */
1256 retval = ext2fs_extent_insert(handle,
1257 EXT2_EXTENT_INSERT_AFTER, &newextent);
1260 /* Now pointing at inserted extent; move back to prev */
1261 retval = ext2fs_extent_goto(handle, logical - 1);
1266 retval = ext2fs_extent_replace(handle, 0, &extent);
1269 } else if (logical == extent.e_lblk) {
1271 printf("(re/un)mapping first block in extent\n");
1276 retval = ext2fs_extent_replace(handle, 0, &extent);
1281 * We've removed the old block, now rely on
1282 * the optimized hueristics for adding a new
1283 * mapping with appropriate merging if necessary.
1287 retval = ext2fs_extent_fix_parents(handle);
1295 printf("(re/un)mapping in middle of extent\n");
1297 /* need to split this extent; later */
1299 orig_length = extent.e_len;
1301 /* shorten pre-split extent */
1302 extent.e_len = (logical - extent.e_lblk);
1303 retval = ext2fs_extent_replace(handle, 0, &extent);
1306 /* insert our new extent, if any */
1308 /* insert new extent after current */
1309 retval = ext2fs_extent_insert(handle,
1310 EXT2_EXTENT_INSERT_AFTER, &newextent);
1314 /* add post-split extent */
1315 extent.e_pblk += extent.e_len + 1;
1316 extent.e_lblk += extent.e_len + 1;
1317 extent.e_len = orig_length - extent.e_len - 1;
1318 retval = ext2fs_extent_insert(handle,
1319 EXT2_EXTENT_INSERT_AFTER, &extent);
1325 /* get handle back to its position */
1326 if (orig_height > handle->max_depth)
1327 orig_height = handle->max_depth; /* In case we shortened the tree */
1328 extent_goto(handle, orig_height, orig_lblk);
1332 errcode_t ext2fs_extent_delete(ext2_extent_handle_t handle, int flags)
1334 struct extent_path *path;
1336 struct ext3_extent_header *eh;
1337 errcode_t retval = 0;
1339 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
1341 if (!(handle->fs->flags & EXT2_FLAG_RW))
1342 return EXT2_ET_RO_FILSYS;
1345 return EXT2_ET_NO_CURRENT_NODE;
1347 path = handle->path + handle->level;
1349 return EXT2_ET_NO_CURRENT_NODE;
1354 memmove(cp, cp + sizeof(struct ext3_extent_idx),
1355 path->left * sizeof(struct ext3_extent_idx));
1358 struct ext3_extent_idx *ix = path->curr;
1362 if (--path->entries == 0)
1365 /* if non-root node has no entries left, remove it & parent ptr to it */
1366 if (path->entries == 0 && handle->level) {
1367 if (!(flags & EXT2_EXTENT_DELETE_KEEP_EMPTY)) {
1368 struct ext2fs_extent extent;
1370 retval = ext2fs_extent_get(handle, EXT2_EXTENT_UP,
1375 retval = ext2fs_extent_delete(handle, flags);
1376 handle->inode->i_blocks -= handle->fs->blocksize / 512;
1377 retval = ext2fs_write_inode(handle->fs, handle->ino,
1379 ext2fs_block_alloc_stats(handle->fs, extent.e_pblk, -1);
1382 eh = (struct ext3_extent_header *) path->buf;
1383 eh->eh_entries = ext2fs_cpu_to_le16(path->entries);
1384 if ((path->entries == 0) && (handle->level == 0))
1385 eh->eh_depth = handle->max_depth = 0;
1386 retval = update_path(handle);
1391 errcode_t ext2fs_extent_get_info(ext2_extent_handle_t handle,
1392 struct ext2_extent_info *info)
1394 struct extent_path *path;
1396 EXT2_CHECK_MAGIC(handle, EXT2_ET_MAGIC_EXTENT_HANDLE);
1398 memset(info, 0, sizeof(struct ext2_extent_info));
1400 path = handle->path + handle->level;
1403 info->curr_entry = ((char *) path->curr - path->buf) /
1404 sizeof(struct ext3_extent_idx);
1406 info->curr_entry = 0;
1407 info->num_entries = path->entries;
1408 info->max_entries = path->max_entries;
1409 info->bytes_avail = (path->max_entries - path->entries) *
1410 sizeof(struct ext3_extent);
1413 info->curr_level = handle->level;
1414 info->max_depth = handle->max_depth;
1415 info->max_lblk = ((__u64) 1 << 32) - 1;
1416 info->max_pblk = ((__u64) 1 << 48) - 1;
1417 info->max_len = (1UL << 15);
1418 info->max_uninit_len = (1UL << 15) - 1;
1427 #include "debugfs.h"
1430 * Hook in new commands into debugfs
1432 const char *debug_prog_name = "tst_extents";
1433 extern ss_request_table extent_cmds;
1434 ss_request_table *extra_cmds = &extent_cmds;
1436 ext2_ino_t current_ino = 0;
1437 ext2_extent_handle_t current_handle;
1439 int common_extent_args_process(int argc, char *argv[], int min_argc,
1440 int max_argc, const char *cmd,
1441 const char *usage, int flags)
1443 if (common_args_process(argc, argv, min_argc, max_argc, cmd,
1447 if (!current_handle) {
1448 com_err(cmd, 0, "Extent handle not open");
1454 void do_inode(int argc, char *argv[])
1458 struct ext3_extent_header *eh;
1461 if (check_fs_open(argv[0]))
1466 printf("Current inode is %d\n", current_ino);
1468 printf("No current inode\n");
1472 if (common_inode_args_process(argc, argv, &inode, 0)) {
1478 retval = ext2fs_extent_open(current_fs, inode, ¤t_handle);
1480 com_err(argv[1], retval, "while opening extent handle");
1484 current_ino = inode;
1486 printf("Loaded inode %d\n", current_ino);
1491 void generic_goto_node(char *cmd_name, int op)
1493 struct ext2fs_extent extent;
1496 if (check_fs_open(cmd_name))
1499 if (!current_handle) {
1500 com_err(cmd_name, 0, "Extent handle not open");
1504 retval = ext2fs_extent_get(current_handle, op, &extent);
1506 com_err(cmd_name, retval, 0);
1509 dbg_print_extent(0, &extent);
1512 void do_current_node(int argc, char *argv[])
1514 generic_goto_node(argv[0], EXT2_EXTENT_CURRENT);
1517 void do_root_node(int argc, char *argv[])
1519 generic_goto_node(argv[0], EXT2_EXTENT_ROOT);
1522 void do_last_leaf(int argc, char *argv[])
1524 generic_goto_node(argv[0], EXT2_EXTENT_LAST_LEAF);
1527 void do_first_sib(int argc, char *argv[])
1529 generic_goto_node(argv[0], EXT2_EXTENT_FIRST_SIB);
1532 void do_last_sib(int argc, char *argv[])
1534 generic_goto_node(argv[0], EXT2_EXTENT_LAST_SIB);
1537 void do_next_sib(int argc, char *argv[])
1539 generic_goto_node(argv[0], EXT2_EXTENT_NEXT_SIB);
1542 void do_prev_sib(int argc, char *argv[])
1544 generic_goto_node(argv[0], EXT2_EXTENT_PREV_SIB);
1547 void do_next_leaf(int argc, char *argv[])
1549 generic_goto_node(argv[0], EXT2_EXTENT_NEXT_LEAF);
1552 void do_prev_leaf(int argc, char *argv[])
1554 generic_goto_node(argv[0], EXT2_EXTENT_PREV_LEAF);
1557 void do_next(int argc, char *argv[])
1559 generic_goto_node(argv[0], EXT2_EXTENT_NEXT);
1562 void do_prev(int argc, char *argv[])
1564 generic_goto_node(argv[0], EXT2_EXTENT_PREV);
1567 void do_up(int argc, char *argv[])
1569 generic_goto_node(argv[0], EXT2_EXTENT_UP);
1572 void do_down(int argc, char *argv[])
1574 generic_goto_node(argv[0], EXT2_EXTENT_DOWN);
1577 void do_delete_node(int argc, char *argv[])
1582 if (common_extent_args_process(argc, argv, 1, 1, "delete_node",
1583 "", CHECK_FS_RW | CHECK_FS_BITMAPS))
1586 retval = ext2fs_extent_delete(current_handle, 0);
1588 com_err(argv[0], retval, 0);
1591 if (current_handle->path && current_handle->path[0].curr)
1592 do_current_node(argc, argv);
1595 void do_replace_node(int argc, char *argv[])
1597 const char *usage = "[--uninit] <lblk> <len> <pblk>";
1599 struct ext2fs_extent extent;
1602 if (common_extent_args_process(argc, argv, 3, 5, "replace_node",
1603 usage, CHECK_FS_RW | CHECK_FS_BITMAPS))
1608 if (!strcmp(argv[1], "--uninit")) {
1611 extent.e_flags |= EXT2_EXTENT_FLAGS_UNINIT;
1615 fprintf(stderr, "Usage: %s %s\n", argv[0], usage);
1619 extent.e_lblk = parse_ulong(argv[1], argv[0], "logical block", &err);
1623 extent.e_len = parse_ulong(argv[2], argv[0], "logical block", &err);
1627 extent.e_pblk = parse_ulong(argv[3], argv[0], "logical block", &err);
1631 retval = ext2fs_extent_replace(current_handle, 0, &extent);
1633 com_err(argv[0], retval, 0);
1636 do_current_node(argc, argv);
1639 void do_split_node(int argc, char *argv[])
1642 struct ext2fs_extent extent;
1645 if (common_extent_args_process(argc, argv, 1, 1, "split_node",
1646 "", CHECK_FS_RW | CHECK_FS_BITMAPS))
1649 retval = extent_node_split(current_handle);
1651 com_err(argv[0], retval, 0);
1654 do_current_node(argc, argv);
1657 void do_insert_node(int argc, char *argv[])
1659 const char *usage = "[--after] [--uninit] <lblk> <len> <pblk>";
1661 struct ext2fs_extent extent;
1666 if (common_extent_args_process(argc, argv, 3, 6, "insert_node",
1667 usage, CHECK_FS_RW | CHECK_FS_BITMAPS))
1675 if (!strcmp(argv[1], "--after")) {
1678 flags |= EXT2_EXTENT_INSERT_AFTER;
1681 if (!strcmp(argv[1], "--uninit")) {
1684 extent.e_flags |= EXT2_EXTENT_FLAGS_UNINIT;
1691 fprintf(stderr, "usage: %s %s\n", cmd, usage);
1695 extent.e_lblk = parse_ulong(argv[1], cmd,
1696 "logical block", &err);
1700 extent.e_len = parse_ulong(argv[2], cmd,
1705 extent.e_pblk = parse_ulong(argv[3], cmd,
1706 "pysical block", &err);
1710 retval = ext2fs_extent_insert(current_handle, flags, &extent);
1712 com_err(cmd, retval, 0);
1715 do_current_node(argc, argv);
1718 void do_set_bmap(int argc, char **argv)
1720 const char *usage = "[--uninit] <lblk> <pblk>";
1724 char *cmd = argv[0];
1728 if (common_extent_args_process(argc, argv, 3, 5, "set_bmap",
1729 usage, CHECK_FS_RW | CHECK_FS_BITMAPS))
1732 if (argc > 2 && !strcmp(argv[1], "--uninit")) {
1735 flags |= EXT2_EXTENT_SET_BMAP_UNINIT;
1739 fprintf(stderr, "Usage: %s %s\n", cmd, usage);
1743 logical = parse_ulong(argv[1], cmd,
1744 "logical block", &err);
1748 physical = parse_ulong(argv[2], cmd,
1749 "physical block", &err);
1753 retval = ext2fs_extent_set_bmap(current_handle, logical,
1754 (blk64_t) physical, flags);
1756 com_err(cmd, retval, 0);
1759 if (current_handle->path && current_handle->path[0].curr)
1760 do_current_node(argc, argv);
1763 void do_print_all(int argc, char **argv)
1765 const char *usage = "[--leaf-only|--reverse|--reverse-leaf]";
1766 struct ext2fs_extent extent;
1768 errcode_t end_err = EXT2_ET_EXTENT_NO_NEXT;
1769 int op = EXT2_EXTENT_NEXT;
1770 int first_op = EXT2_EXTENT_ROOT;
1773 if (common_extent_args_process(argc, argv, 1, 2, "print_all",
1778 if (!strcmp(argv[1], "--leaf-only"))
1779 op = EXT2_EXTENT_NEXT_LEAF;
1780 else if (!strcmp(argv[1], "--reverse")) {
1781 op = EXT2_EXTENT_PREV;
1782 first_op = EXT2_EXTENT_LAST_LEAF;
1783 end_err = EXT2_ET_EXTENT_NO_PREV;
1784 } else if (!strcmp(argv[1], "--reverse-leaf")) {
1785 op = EXT2_EXTENT_PREV_LEAF;
1786 first_op = EXT2_EXTENT_LAST_LEAF;
1787 end_err = EXT2_ET_EXTENT_NO_PREV;
1789 fprintf(stderr, "Usage: %s %s\n", argv[0], usage);
1794 retval = ext2fs_extent_get(current_handle, first_op, &extent);
1796 com_err(argv[0], retval, 0);
1799 dbg_print_extent(0, &extent);
1802 retval = ext2fs_extent_get(current_handle, op, &extent);
1803 if (retval == end_err)
1807 com_err(argv[0], retval, 0);
1810 dbg_print_extent(0, &extent);
1814 void do_info(int argc, char **argv)
1816 struct ext2fs_extent extent;
1817 struct ext2_extent_info info;
1820 if (common_extent_args_process(argc, argv, 1, 1, "info", "", 0))
1823 retval = ext2fs_extent_get_info(current_handle, &info);
1825 com_err(argv[0], retval, 0);
1829 retval = ext2fs_extent_get(current_handle,
1830 EXT2_EXTENT_CURRENT, &extent);
1832 com_err(argv[0], retval, 0);
1836 dbg_print_extent(0, &extent);
1838 printf("Current handle location: %d/%d (max: %d, bytes %d), level %d/%d\n",
1839 info.curr_entry, info.num_entries, info.max_entries,
1840 info.bytes_avail, info.curr_level, info.max_depth);
1841 printf("\tmax lblk: %llu, max pblk: %llu\n", info.max_lblk,
1843 printf("\tmax_len: %u, max_uninit_len: %u\n", info.max_len,
1844 info.max_uninit_len);
1847 void do_goto_block(int argc, char **argv)
1849 struct ext2fs_extent extent;
1851 int op = EXT2_EXTENT_NEXT_LEAF;
1855 if (common_extent_args_process(argc, argv, 2, 3, "goto_block",
1856 "block [level]", 0))
1859 if (strtoblk(argv[0], argv[1], &blk))
1863 if (strtoblk(argv[0], argv[2], &level))
1866 retval = extent_goto(current_handle, level, (blk64_t) blk);
1869 com_err(argv[0], retval, "while trying to go to block %lu, level %d",
1874 generic_goto_node(argv[0], EXT2_EXTENT_CURRENT);