| blob | 2d7f76e52c379cf04b7f820c610c171e491d4830 |
1 /* -*- mode: c; c-basic-offset: 8; -*-
2 * vim: noexpandtab sw=8 ts=8 sts=0:
3 *
4 * alloc.c
5 *
6 * Extent allocs and frees
7 *
8 * Copyright (C) 2002, 2004 Oracle. All rights reserved.
9 *
10 * This program is free software; you can redistribute it and/or
11 * modify it under the terms of the GNU General Public
12 * License as published by the Free Software Foundation; either
13 * version 2 of the License, or (at your option) any later version.
14 *
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
18 * General Public License for more details.
19 *
20 * You should have received a copy of the GNU General Public
21 * License along with this program; if not, write to the
22 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
23 * Boston, MA 021110-1307, USA.
24 */
26 #include <linux/fs.h>
27 #include <linux/types.h>
28 #include <linux/slab.h>
29 #include <linux/highmem.h>
30 #include <linux/swap.h>
31 #include <linux/quotaops.h>
32 #include <linux/blkdev.h>
34 #include <cluster/masklog.h>
59 CONTIG_LEFT,
60 CONTIG_RIGHT,
61 CONTIG_LEFTRIGHT,
62 };
64 static enum ocfs2_contig_type
68 /*
69 * Operations for a specific extent tree type.
70 *
71 * To implement an on-disk btree (extent tree) type in ocfs2, add
72 * an ocfs2_extent_tree_operations structure and the matching
73 * ocfs2_init_<thingy>_extent_tree() function. That's pretty much it
74 * for the allocation portion of the extent tree.
75 */
77 /*
78 * last_eb_blk is the block number of the right most leaf extent
79 * block. Most on-disk structures containing an extent tree store
80 * this value for fast access. The ->eo_set_last_eb_blk() and
81 * ->eo_get_last_eb_blk() operations access this value. They are
82 * both required.
83 */
85 u64 blkno);
88 /*
89 * The on-disk structure usually keeps track of how many total
90 * clusters are stored in this extent tree. This function updates
91 * that value. new_clusters is the delta, and must be
92 * added to the total. Required.
93 */
95 u32 new_clusters);
97 /*
98 * If this extent tree is supported by an extent map, insert
99 * a record into the map.
100 */
104 /*
105 * If this extent tree is supported by an extent map, truncate the
106 * map to clusters,
107 */
109 u32 clusters);
111 /*
112 * If ->eo_insert_check() exists, it is called before rec is
113 * inserted into the extent tree. It is optional.
114 */
119 /*
120 * --------------------------------------------------------------
121 * The remaining are internal to ocfs2_extent_tree and don't have
122 * accessor functions
123 */
125 /*
126 * ->eo_fill_root_el() takes et->et_object and sets et->et_root_el.
127 * It is required.
128 */
131 /*
132 * ->eo_fill_max_leaf_clusters sets et->et_max_leaf_clusters if
133 * it exists. If it does not, et->et_max_leaf_clusters is set
134 * to 0 (unlimited). Optional.
135 */
138 /*
139 * ->eo_extent_contig test whether the 2 ocfs2_extent_rec
140 * are contiguous or not. Optional. Don't need to set it if use
141 * ocfs2_extent_rec as the tree leaf.
142 */
143 enum ocfs2_contig_type
147 };
150 /*
151 * Pre-declare ocfs2_dinode_et_ops so we can use it as a sanity check
152 * in the methods.
153 */
156 u64 blkno);
158 u32 clusters);
162 u32 clusters);
176 };
179 u64 blkno)
180 {
185 }
188 {
193 }
196 u32 clusters)
197 {
205 }
209 {
213 }
216 u32 clusters)
217 {
221 }
225 {
232 "Device %s, asking for sparse allocation: inode %llu, "
239 }
242 {
249 }
252 {
256 }
260 {
264 }
267 u64 blkno)
268 {
272 }
275 {
279 }
282 u32 clusters)
283 {
287 }
294 };
297 {
301 }
304 {
308 }
311 u64 blkno)
312 {
317 }
320 {
325 }
328 u32 clusters)
329 {
333 }
341 };
344 u64 blkno)
345 {
349 }
352 {
356 }
359 u32 clusters)
360 {
364 }
367 {
373 }
376 {
380 }
388 };
391 {
395 }
398 u64 blkno)
399 {
403 }
406 {
410 }
413 u32 clusters)
414 {
418 }
420 static enum ocfs2_contig_type
424 {
426 }
434 };
439 ocfs2_journal_access_func access,
442 {
454 else
456 }
461 {
464 }
469 {
472 }
477 {
480 }
485 {
488 }
493 {
496 }
499 u64 new_last_eb_blk)
500 {
502 }
505 {
507 }
510 u32 clusters)
511 {
513 }
517 {
520 }
523 u32 clusters)
524 {
527 }
532 {
534 type);
535 }
541 {
548 }
552 {
558 }
561 {
567 }
575 /*
576 * Reset the actual path elements so that we can re-use the structure
577 * to build another path. Generally, this involves freeing the buffer
578 * heads.
579 */
581 {
594 }
596 /*
597 * Tree depth may change during truncate, or insert. If we're
598 * keeping the root extent list, then make sure that our path
599 * structure reflects the proper depth.
600 */
603 else
607 }
610 {
614 }
615 }
617 /*
618 * All the elements of src into dest. After this call, src could be freed
619 * without affecting dest.
620 *
621 * Both paths should have the same root. Any non-root elements of dest
622 * will be freed.
623 */
625 {
640 }
641 }
643 /*
644 * Make the *dest path the same as src and re-initialize src path to
645 * have a root only.
646 */
648 {
662 }
663 }
665 /*
666 * Insert an extent block at given index.
667 *
668 * This will not take an additional reference on eb_bh.
669 */
672 {
675 /*
676 * Right now, no root bh is an extent block, so this helps
677 * catch code errors with dinode trees. The assertion can be
678 * safely removed if we ever need to insert extent block
679 * structures at the root.
680 */
685 }
689 ocfs2_journal_access_func access)
690 {
702 }
705 }
708 {
711 }
714 {
717 }
719 /*
720 * Journal the buffer at depth idx. All idx>0 are extent_blocks,
721 * otherwise it's the root_access function.
722 *
723 * I don't like the way this function's name looks next to
724 * ocfs2_journal_access_path(), but I don't have a better one.
725 */
730 {
740 OCFS2_JOURNAL_ACCESS_WRITE);
741 }
743 /*
744 * Convenience function to journal all components in a path.
745 */
749 {
760 }
761 }
763 out:
765 }
767 /*
768 * Return the index of the extent record which contains cluster #v_cluster.
769 * -1 is returned if it was not found.
770 *
771 * Should work fine on interior and exterior nodes.
772 */
774 {
791 }
792 }
795 }
797 /*
798 * NOTE: ocfs2_block_extent_contig(), ocfs2_extents_adjacent() and
799 * ocfs2_extent_rec_contig only work properly against leaf nodes!
800 */
803 u64 blkno)
804 {
811 }
815 {
816 u32 left_range;
822 }
824 static enum ocfs2_contig_type
828 {
831 /*
832 * Refuse to coalesce extent records with different flag
833 * fields - we don't want to mix unwritten extents with user
834 * data.
835 */
849 }
851 /*
852 * NOTE: We can have pretty much any combination of contiguousness and
853 * appending.
854 *
855 * The usefulness of APPEND_TAIL is more in that it lets us know that
856 * we'll have to update the path to that leaf.
857 */
860 APPEND_TAIL,
861 };
865 SPLIT_LEFT,
866 SPLIT_RIGHT,
867 };
875 };
881 };
885 {
894 /*
895 * If the ecc fails, we return the error but otherwise
896 * leave the filesystem running. We know any error is
897 * local to this block.
898 */
904 }
906 /*
907 * Errors after here are fatal.
908 */
916 }
920 "Extent block #%llu has an invalid h_blkno "
925 }
929 "Extent block #%llu has an invalid "
934 }
937 }
941 {
946 ocfs2_validate_extent_block);
948 /* If ocfs2_read_block() got us a new bh, pass it up. */
953 }
956 /*
957 * How many free extents have we got before we need more meta data?
958 */
961 {
977 }
980 }
985 bail:
990 }
992 /* expects array to already be allocated
993 *
994 * sets h_signature, h_blkno, h_suballoc_bit, h_suballoc_slot, and
995 * l_count for you
996 */
1002 {
1004 u16 suballoc_bit_start;
1005 u32 num_got;
1014 meta_ac,
1023 }
1031 }
1036 OCFS2_JOURNAL_ACCESS_CREATE);
1040 }
1044 /* Ok, setup the minimal stuff here. */
1055 suballoc_bit_start++;
1056 first_blkno++;
1058 /* We'll also be dirtied by the caller, so
1059 * this isn't absolutely necessary. */
1061 }
1064 }
1067 bail:
1072 }
1074 }
1076 }
1078 /*
1079 * Helper function for ocfs2_add_branch() and ocfs2_shift_tree_depth().
1080 *
1081 * Returns the sum of the rightmost extent rec logical offset and
1082 * cluster count.
1083 *
1084 * ocfs2_add_branch() uses this to determine what logical cluster
1085 * value should be populated into the leftmost new branch records.
1086 *
1087 * ocfs2_shift_tree_depth() uses this to determine the # clusters
1088 * value for the new topmost tree record.
1089 */
1091 {
1098 }
1100 /*
1101 * Change range of the branches in the right most path according to the leaf
1102 * extent block's rightmost record.
1103 */
1106 {
1116 }
1122 }
1128 }
1134 }
1141 out:
1144 }
1146 /*
1147 * Add an entire tree branch to our inode. eb_bh is the extent block
1148 * to start at, if we don't want to start the branch at the root
1149 * structure.
1150 *
1151 * last_eb_bh is required as we have to update it's next_leaf pointer
1152 * for the new last extent block.
1153 *
1154 * the new branch will be 'empty' in the sense that every block will
1155 * contain a single record with cluster count == 0.
1156 */
1162 {
1180 /* we never add a branch to a leaf. */
1189 /*
1190 * If there is a gap before the root end and the real end
1191 * of the righmost leaf block, we need to remove the gap
1192 * between new_cpos and root_end first so that the tree
1193 * is consistent after we add a new branch(it will start
1194 * from new_cpos).
1195 */
1206 }
1207 }
1209 /* allocate the number of new eb blocks we need */
1211 GFP_KERNEL);
1216 }
1223 }
1225 /* Note: new_eb_bhs[new_blocks - 1] is the guy which will be
1226 * linked with the rest of the tree.
1227 * conversly, new_eb_bhs[0] is the new bottommost leaf.
1228 *
1229 * when we leave the loop, new_last_eb_blk will point to the
1230 * newest leaf, and next_blkno will point to the topmost extent
1231 * block. */
1236 /* ocfs2_create_new_meta_bhs() should create it right! */
1241 OCFS2_JOURNAL_ACCESS_CREATE);
1245 }
1250 /*
1251 * This actually counts as an empty extent as
1252 * c_clusters == 0
1253 */
1256 /*
1257 * eb_el isn't always an interior node, but even leaf
1258 * nodes want a zero'd flags and reserved field so
1259 * this gets the whole 32 bits regardless of use.
1260 */
1267 }
1269 /* This is a bit hairy. We want to update up to three blocks
1270 * here without leaving any of them in an inconsistent state
1271 * in case of error. We don't have to worry about
1272 * journal_dirty erroring as it won't unless we've aborted the
1273 * handle (in which case we would never be here) so reserving
1274 * the write with journal_access is all we need to do. */
1276 OCFS2_JOURNAL_ACCESS_WRITE);
1280 }
1282 OCFS2_JOURNAL_ACCESS_WRITE);
1286 }
1289 OCFS2_JOURNAL_ACCESS_WRITE);
1293 }
1294 }
1296 /* Link the new branch into the rest of the tree (el will
1297 * either be on the root_bh, or the extent block passed in. */
1304 /* fe needs a new last extent block pointer, as does the
1305 * next_leaf on the previously last-extent-block. */
1316 /*
1317 * Some callers want to track the rightmost leaf so pass it
1318 * back here.
1319 */
1325 bail:
1330 }
1333 }
1335 /*
1336 * adds another level to the allocation tree.
1337 * returns back the new extent block so you can add a branch to it
1338 * after this call.
1339 */
1344 {
1346 u32 new_clusters;
1357 }
1360 /* ocfs2_create_new_meta_bhs() should create it right! */
1367 OCFS2_JOURNAL_ACCESS_CREATE);
1371 }
1373 /* copy the root extent list data into the new extent block */
1382 OCFS2_JOURNAL_ACCESS_WRITE);
1386 }
1390 /* update root_bh now */
1399 /* If this is our 1st tree depth shift, then last_eb_blk
1400 * becomes the allocated extent block */
1409 bail:
1413 }
1415 /*
1416 * Should only be called when there is no space left in any of the
1417 * leaf nodes. What we want to do is find the lowest tree depth
1418 * non-leaf extent block with room for new records. There are three
1419 * valid results of this search:
1420 *
1421 * 1) a lowest extent block is found, then we pass it back in
1422 * *lowest_eb_bh and return '0'
1423 *
1424 * 2) the search fails to find anything, but the root_el has room. We
1425 * pass NULL back in *lowest_eb_bh, but still return '0'
1426 *
1427 * 3) the search fails to find anything AND the root_el is full, in
1428 * which case we return > 0
1429 *
1430 * return status < 0 indicates an error.
1431 */
1434 {
1436 u64 blkno;
1449 "Owner %llu has empty "
1454 }
1459 "Owner %llu has extent "
1460 "list where extent # %d has no physical "
1465 }
1474 }
1484 }
1485 }
1487 /* If we didn't find one and the fe doesn't have any room,
1488 * then return '1' */
1494 bail:
1498 }
1500 /*
1501 * Grow a b-tree so that it has more records.
1502 *
1503 * We might shift the tree depth in which case existing paths should
1504 * be considered invalid.
1505 *
1506 * Tree depth after the grow is returned via *final_depth.
1507 *
1508 * *last_eb_bh will be updated by ocfs2_add_branch().
1509 */
1513 {
1526 }
1528 /* We traveled all the way to the bottom of the allocation tree
1529 * and didn't find room for any more extents - we need to add
1530 * another tree level */
1536 depth);
1538 /* ocfs2_shift_tree_depth will return us a buffer with
1539 * the new extent block (so we can pass that to
1540 * ocfs2_add_branch). */
1545 }
1546 depth++;
1548 /*
1549 * Special case: we have room now if we shifted from
1550 * tree_depth 0, so no more work needs to be done.
1551 *
1552 * We won't be calling add_branch, so pass
1553 * back *last_eb_bh as the new leaf. At depth
1554 * zero, it should always be null so there's
1555 * no reason to brelse.
1556 */
1561 }
1562 }
1564 /* call ocfs2_add_branch to add the final part of the tree with
1565 * the new data. */
1567 meta_ac);
1571 }
1573 out:
1578 }
1580 /*
1581 * This function will discard the rightmost extent record.
1582 */
1584 {
1590 /* This will cause us to go off the end of our extent list. */
1596 }
1600 {
1610 /* The tree code before us didn't allow enough room in the leaf. */
1613 /*
1614 * The easiest way to approach this is to just remove the
1615 * empty extent and temporarily decrement next_free.
1616 */
1618 /*
1619 * If next_free was 1 (only an empty extent), this
1620 * loop won't execute, which is fine. We still want
1621 * the decrement above to happen.
1622 */
1626 next_free--;
1627 }
1629 /*
1630 * Figure out what the new record index should be.
1631 */
1637 }
1648 /*
1649 * No need to memmove if we're just adding to the tail.
1650 */
1658 num_bytes);
1659 }
1661 /*
1662 * Either we had an empty extent, and need to re-increment or
1663 * there was no empty extent on a non full rightmost leaf node,
1664 * in which case we still need to increment.
1665 */
1666 next_free++;
1668 /*
1669 * Make sure none of the math above just messed up our tree.
1670 */
1675 }
1678 {
1684 num_recs--;
1690 }
1691 }
1693 /*
1694 * Create an empty extent record .
1695 *
1696 * l_next_free_rec may be updated.
1697 *
1698 * If an empty extent already exists do nothing.
1699 */
1701 {
1720 set_and_inc:
1723 }
1725 /*
1726 * For a rotation which involves two leaf nodes, the "root node" is
1727 * the lowest level tree node which contains a path to both leafs. This
1728 * resulting set of information can be used to form a complete "subtree"
1729 *
1730 * This function is passed two full paths from the dinode down to a
1731 * pair of adjacent leaves. It's task is to figure out which path
1732 * index contains the subtree root - this can be the root index itself
1733 * in a worst-case rotation.
1734 *
1735 * The array index of the subtree root is passed back.
1736 */
1740 {
1743 /*
1744 * Check that the caller passed in two paths from the same tree.
1745 */
1749 i++;
1751 /*
1752 * The caller didn't pass two adjacent paths.
1753 */
1765 }
1769 /*
1770 * Traverse a btree path in search of cpos, starting at root_el.
1771 *
1772 * This code can be called with a cpos larger than the tree, in which
1773 * case it will return the rightmost path.
1774 */
1778 {
1780 u32 range;
1781 u64 blkno;
1791 "Owner %llu has empty extent list at "
1798 }
1803 /*
1804 * In the case that cpos is off the allocation
1805 * tree, this should just wind up returning the
1806 * rightmost record.
1807 */
1812 }
1817 "Owner %llu has bad blkno in extent list "
1823 }
1831 }
1839 "Owner %llu has bad count in extent list "
1847 }
1851 }
1853 out:
1854 /*
1855 * Catch any trailing bh that the loop didn't handle.
1856 */
1860 }
1862 /*
1863 * Given an initialized path (that is, it has a valid root extent
1864 * list), this function will traverse the btree in search of the path
1865 * which would contain cpos.
1866 *
1867 * The path traveled is recorded in the path structure.
1868 *
1869 * Note that this will not do any comparisons on leaf node extent
1870 * records, so it will work fine in the case that we just added a tree
1871 * branch.
1872 */
1876 };
1878 {
1884 }
1887 {
1894 }
1897 {
1902 /* We want to retain only the leaf block. */
1906 }
1907 }
1908 /*
1909 * Find the leaf block in the tree which would contain cpos. No
1910 * checking of the actual leaf is done.
1911 *
1912 * Some paths want to call this instead of allocating a path structure
1913 * and calling ocfs2_find_path().
1914 *
1915 * This function doesn't handle non btree extent lists.
1916 */
1920 {
1928 }
1931 out:
1933 }
1935 /*
1936 * Adjust the adjacent records (left_rec, right_rec) involved in a rotation.
1937 *
1938 * Basically, we've moved stuff around at the bottom of the tree and
1939 * we need to fix up the extent records above the changes to reflect
1940 * the new changes.
1941 *
1942 * left_rec: the record on the left.
1943 * left_child_el: is the child list pointed to by left_rec
1944 * right_rec: the record to the right of left_rec
1945 * right_child_el: is the child list pointed to by right_rec
1946 *
1947 * By definition, this only works on interior nodes.
1948 */
1953 {
1956 /*
1957 * Interior nodes never have holes. Their cpos is the cpos of
1958 * the leftmost record in their child list. Their cluster
1959 * count covers the full theoretical range of their child list
1960 * - the range between their cpos and the cpos of the record
1961 * immediately to their right.
1962 */
1968 }
1972 /*
1973 * Calculate the rightmost cluster count boundary before
1974 * moving cpos - we will need to adjust clusters after
1975 * updating e_cpos to keep the same highest cluster count.
1976 */
1985 }
1987 /*
1988 * Adjust the adjacent root node records involved in a
1989 * rotation. left_el_blkno is passed in as a key so that we can easily
1990 * find it's index in the root list.
1991 */
1995 u64 left_el_blkno)
1996 {
2005 }
2007 /*
2008 * The path walking code should have never returned a root and
2009 * two paths which are not adjacent.
2010 */
2015 }
2017 /*
2018 * We've changed a leaf block (in right_path) and need to reflect that
2019 * change back up the subtree.
2020 *
2021 * This happens in multiple places:
2022 * - When we've moved an extent record from the left path leaf to the right
2023 * path leaf to make room for an empty extent in the left path leaf.
2024 * - When our insert into the right path leaf is at the leftmost edge
2025 * and requires an update of the path immediately to it's left. This
2026 * can occur at the end of some types of rotation and appending inserts.
2027 * - When we've adjusted the last extent record in the left path leaf and the
2028 * 1st extent record in the right path leaf during cross extent block merge.
2029 */
2034 {
2040 /*
2041 * Update the counts and position values within all the
2042 * interior nodes to reflect the leaf rotation we just did.
2043 *
2044 * The root node is handled below the loop.
2045 *
2046 * We begin the loop with right_el and left_el pointing to the
2047 * leaf lists and work our way up.
2048 *
2049 * NOTE: within this loop, left_el and right_el always refer
2050 * to the *child* lists.
2051 */
2057 /*
2058 * One nice property of knowing that all of these
2059 * nodes are below the root is that we only deal with
2060 * the leftmost right node record and the rightmost
2061 * left node record.
2062 */
2071 right_el);
2076 /*
2077 * Setup our list pointers now so that the current
2078 * parents become children in the next iteration.
2079 */
2082 }
2084 /*
2085 * At the root node, adjust the two adjacent records which
2086 * begin our path to the leaves.
2087 */
2099 }
2106 {
2119 "Inode %llu has non-full interior leaf node %llu"
2125 }
2127 /*
2128 * This extent block may already have an empty record, so we
2129 * return early if so.
2130 */
2138 subtree_index);
2142 }
2150 }
2157 }
2158 }
2163 /* This is a code error, not a disk corruption. */
2173 /* Do the copy now. */
2178 /*
2179 * Clear out the record we just copied and shift everything
2180 * over, leaving an empty extent in the left leaf.
2181 *
2182 * We temporarily subtract from next_free_rec so that the
2183 * shift will lose the tail record (which is now defunct).
2184 */
2193 subtree_index);
2195 out:
2197 }
2199 /*
2200 * Given a full path, determine what cpos value would return us a path
2201 * containing the leaf immediately to the left of the current one.
2202 *
2203 * Will return zero if the path passed in is already the leftmost path.
2204 */
2207 {
2209 u64 blkno;
2218 /* Start at the tree node just above the leaf and work our way up. */
2223 /*
2224 * Find the extent record just before the one in our
2225 * path.
2226 */
2231 /*
2232 * We've determined that the
2233 * path specified is already
2234 * the leftmost one - return a
2235 * cpos of zero.
2236 */
2238 }
2239 /*
2240 * The leftmost record points to our
2241 * leaf - we need to travel up the
2242 * tree one level.
2243 */
2245 }
2252 }
2253 }
2255 /*
2256 * If we got here, we never found a valid node where
2257 * the tree indicated one should be.
2258 */
2265 next_node:
2267 i--;
2268 }
2270 out:
2272 }
2274 /*
2275 * Extend the transaction by enough credits to complete the rotation,
2276 * and still leave at least the original number of credits allocated
2277 * to this transaction.
2278 */
2282 {
2291 }
2293 /*
2294 * Trap the case where we're inserting into the theoretical range past
2295 * the _actual_ left leaf range. Otherwise, we'll rotate a record
2296 * whose cpos is less than ours into the right leaf.
2297 *
2298 * It's only necessary to look at the rightmost record of the left
2299 * leaf because the logic that calls us should ensure that the
2300 * theoretical ranges in the path components above the leaves are
2301 * correct.
2302 */
2304 u32 insert_cpos)
2305 {
2317 }
2320 {
2330 /* Empty list. */
2334 }
2340 }
2342 /*
2343 * Rotate all the records in a btree right one record, starting at insert_cpos.
2344 *
2345 * The path to the rightmost leaf should be passed in.
2346 *
2347 * The array is assumed to be large enough to hold an entire path (tree depth).
2348 *
2349 * Upon successful return from this function:
2350 *
2351 * - The 'right_path' array will contain a path to the leaf block
2352 * whose range contains e_cpos.
2353 * - That leaf block will have a single empty extent in list index 0.
2354 * - In the case that the rotation requires a post-insert update,
2355 * *ret_left_path will contain a valid path which can be passed to
2356 * ocfs2_insert_path().
2357 */
2361 u32 insert_cpos,
2364 {
2366 u32 cpos;
2377 }
2383 }
2389 /*
2390 * What we want to do here is:
2391 *
2392 * 1) Start with the rightmost path.
2393 *
2394 * 2) Determine a path to the leaf block directly to the left
2395 * of that leaf.
2396 *
2397 * 3) Determine the 'subtree root' - the lowest level tree node
2398 * which contains a path to both leaves.
2399 *
2400 * 4) Rotate the subtree.
2401 *
2402 * 5) Find the next subtree by considering the left path to be
2403 * the new right path.
2404 *
2405 * The check at the top of this while loop also accepts
2406 * insert_cpos == cpos because cpos is only a _theoretical_
2407 * value to get us the left path - insert_cpos might very well
2408 * be filling that hole.
2409 *
2410 * Stop at a cpos of '0' because we either started at the
2411 * leftmost branch (i.e., a tree with one branch and a
2412 * rotation inside of it), or we've gone as far as we can in
2413 * rotating subtrees.
2414 */
2425 }
2429 "Owner %llu: error during insert of %u "
2430 "(left path cpos %u) results in two identical "
2439 insert_cpos)) {
2441 /*
2442 * We've rotated the tree as much as we
2443 * should. The rest is up to
2444 * ocfs2_insert_path() to complete, after the
2445 * record insertion. We indicate this
2446 * situation by returning the left path.
2447 *
2448 * The reason we don't adjust the records here
2449 * before the record insert is that an error
2450 * later might break the rule where a parent
2451 * record e_cpos will reflect the actual
2452 * e_cpos of the 1st nonempty record of the
2453 * child list.
2454 */
2457 }
2471 }
2478 }
2482 insert_cpos)) {
2483 /*
2484 * A rotate moves the rightmost left leaf
2485 * record over to the leftmost right leaf
2486 * slot. If we're doing an extent split
2487 * instead of a real insert, then we have to
2488 * check that the extent to be split wasn't
2489 * just moved over. If it was, then we can
2490 * exit here, passing left_path back -
2491 * ocfs2_split_extent() is smart enough to
2492 * search both leaves.
2493 */
2496 }
2498 /*
2499 * There is no need to re-read the next right path
2500 * as we know that it'll be our current left
2501 * path. Optimize by copying values instead.
2502 */
2509 }
2510 }
2512 out:
2515 out_ret_path:
2517 }
2522 {
2527 u32 range;
2529 /*
2530 * In normal tree rotation process, we will never touch the
2531 * tree branch above subtree_index and ocfs2_extend_rotate_transaction
2532 * doesn't reserve the credits for them either.
2533 *
2534 * But we do have a special case here which will update the rightmost
2535 * records for all the bh in the path.
2536 * So we have to allocate extra credits and access them.
2537 */
2542 }
2548 }
2550 /* Path should always be rightmost. */
2569 }
2570 out:
2572 }
2578 {
2588 /*
2589 * Not all nodes might have had their final count
2590 * decremented by the caller - handle this here.
2591 */
2595 "Inode %llu, attempted to remove extent block "
2604 }
2616 }
2617 }
2625 {
2653 }
2662 {
2680 /*
2681 * It's legal for us to proceed if the right leaf is
2682 * the rightmost one and it has an empty extent. There
2683 * are two cases to handle - whether the leaf will be
2684 * empty after removal or not. If the leaf isn't empty
2685 * then just remove the empty extent up front. The
2686 * next block will handle empty leaves by flagging
2687 * them for unlink.
2688 *
2689 * Non rightmost leaves will throw -EAGAIN and the
2690 * caller can manually move the subtree and retry.
2691 */
2699 OCFS2_JOURNAL_ACCESS_WRITE);
2703 }
2708 }
2712 /*
2713 * We have to update i_last_eb_blk during the meta
2714 * data delete.
2715 */
2717 OCFS2_JOURNAL_ACCESS_WRITE);
2721 }
2724 }
2726 /*
2727 * Getting here with an empty extent in the right path implies
2728 * that it's the rightmost path and will be deleted.
2729 */
2733 subtree_index);
2737 }
2745 }
2752 }
2753 }
2756 /*
2757 * Only do this if we're moving a real
2758 * record. Otherwise, the action is delayed until
2759 * after removal of the right path in which case we
2760 * can do a simple shift to remove the empty extent.
2761 */
2765 }
2767 /*
2768 * Move recs over to get rid of empty extent, decrease
2769 * next_free. This is allowed to remove the last
2770 * extent in our leaf (setting l_next_free_rec to
2771 * zero) - the delete code below won't care.
2772 */
2774 }
2783 left_path);
2787 }
2792 /*
2793 * Removal of the extent in the left leaf was skipped
2794 * above so we could delete the right path
2795 * 1st.
2796 */
2805 subtree_index);
2807 out:
2809 }
2811 /*
2812 * Given a full path, determine what cpos value would return us a path
2813 * containing the leaf immediately to the right of the current one.
2814 *
2815 * Will return zero if the path passed in is already the rightmost path.
2816 *
2817 * This looks similar, but is subtly different to
2818 * ocfs2_find_cpos_for_left_leaf().
2819 */
2822 {
2824 u64 blkno;
2834 /* Start at the tree node just above the leaf and work our way up. */
2841 /*
2842 * Find the extent record just after the one in our
2843 * path.
2844 */
2850 /*
2851 * We've determined that the
2852 * path specified is already
2853 * the rightmost one - return a
2854 * cpos of zero.
2855 */
2857 }
2858 /*
2859 * The rightmost record points to our
2860 * leaf - we need to travel up the
2861 * tree one level.
2862 */
2864 }
2868 }
2869 }
2871 /*
2872 * If we got here, we never found a valid node where
2873 * the tree indicated one should be.
2874 */
2881 next_node:
2883 i--;
2884 }
2886 out:
2888 }
2893 {
2906 }
2911 out:
2913 }
2921 {
2923 u32 right_cpos;
2936 }
2943 }
2952 }
2959 }
2962 right_path);
2974 }
2976 /*
2977 * Caller might still want to make changes to the
2978 * tree root, so re-add it to the journal here.
2979 */
2985 }
2991 /*
2992 * The rotation has to temporarily stop due to
2993 * the right subtree having an empty
2994 * extent. Pass it back to the caller for a
2995 * fixup.
2996 */
3000 }
3004 }
3006 /*
3007 * The subtree rotate might have removed records on
3008 * the rightmost edge. If so, then rotation is
3009 * complete.
3010 */
3021 }
3022 }
3024 out:
3029 }
3035 {
3037 u32 cpos;
3046 /*
3047 * There's two ways we handle this depending on
3048 * whether path is the only existing one.
3049 */
3052 path);
3056 }
3062 }
3069 }
3072 /*
3073 * We have a path to the left of this one - it needs
3074 * an update too.
3075 */
3081 }
3087 }
3093 }
3100 left_path);
3104 }
3109 /*
3110 * 'path' is also the leftmost path which
3111 * means it must be the only one. This gets
3112 * handled differently because we want to
3113 * revert the root back to having extents
3114 * in-line.
3115 */
3124 }
3128 out:
3131 }
3133 /*
3134 * Left rotation of btree records.
3135 *
3136 * In many ways, this is (unsurprisingly) the opposite of right
3137 * rotation. We start at some non-rightmost path containing an empty
3138 * extent in the leaf block. The code works its way to the rightmost
3139 * path by rotating records to the left in every subtree.
3140 *
3141 * This is used by any code which reduces the number of extent records
3142 * in a leaf. After removal, an empty record should be placed in the
3143 * leftmost list position.
3144 *
3145 * This won't handle a length update of the rightmost path records if
3146 * the rightmost tree leaf record is removed so the caller is
3147 * responsible for detecting and correcting that.
3148 */
3153 {
3164 rightmost_no_delete:
3165 /*
3166 * Inline extents. This is trivially handled, so do
3167 * it up front.
3168 */
3173 }
3175 /*
3176 * Handle rightmost branch now. There's several cases:
3177 * 1) simple rotation leaving records in there. That's trivial.
3178 * 2) rotation requiring a branch delete - there's no more
3179 * records left. Two cases of this:
3180 * a) There are branches to the left.
3181 * b) This is also the leftmost (the only) branch.
3182 *
3183 * 1) is handled via ocfs2_rotate_rightmost_leaf_left()
3184 * 2a) we need the left branch so that we can update it with the unlink
3185 * 2b) we need to bring the root back to inline extents.
3186 */
3191 /*
3192 * This gets a bit tricky if we're going to delete the
3193 * rightmost path. Get the other cases out of the way
3194 * 1st.
3195 */
3206 }
3208 /*
3209 * XXX: The caller can not trust "path" any more after
3210 * this as it will have been deleted. What do we do?
3211 *
3212 * In theory the rotate-for-merge code will never get
3213 * here because it'll always ask for a rotate in a
3214 * nonempty list.
3215 */
3218 dealloc);
3222 }
3224 /*
3225 * Now we can loop, remembering the path we get from -EAGAIN
3226 * and restarting from there.
3227 */
3228 try_rotate:
3234 }
3246 }
3253 }
3255 out:
3259 }
3263 {
3268 /*
3269 * We consumed all of the merged-from record. An empty
3270 * extent cannot exist anywhere but the 1st array
3271 * position, so move things over if the merged-from
3272 * record doesn't occupy that position.
3273 *
3274 * This creates a new empty extent so the caller
3275 * should be smart enough to have removed any existing
3276 * ones.
3277 */
3282 }
3284 /*
3285 * Always memset - the caller doesn't check whether it
3286 * created an empty extent, so there could be junk in
3287 * the other fields.
3288 */
3290 }
3291 }
3296 {
3298 u32 right_cpos;
3304 /* This function shouldn't be called for non-trees. */
3315 }
3317 /* This function shouldn't be called for the rightmost leaf. */
3325 }
3331 }
3334 out:
3338 }
3340 /*
3341 * Remove split_rec clusters from the record at index and merge them
3342 * onto the beginning of the record "next" to it.
3343 * For index < l_count - 1, the next means the extent rec at index + 1.
3344 * For index == l_count - 1, the "next" means the 1st extent rec of the
3345 * next extent block.
3346 */
3352 {
3369 /* we meet with a cross extent block merge. */
3374 }
3383 }
3390 right_path);
3394 right_path);
3398 }
3404 subtree_index);
3408 }
3417 }
3424 }
3425 }
3430 }
3437 }
3444 split_clusters));
3453 subtree_index);
3454 }
3455 out:
3458 }
3463 {
3465 u32 left_cpos;
3470 /* This function shouldn't be called for non-trees. */
3478 }
3480 /* This function shouldn't be called for the leftmost leaf. */
3488 }
3494 }
3497 out:
3501 }
3503 /*
3504 * Remove split_rec clusters from the record at index and merge them
3505 * onto the tail of the record "before" it.
3506 * For index > 0, the "before" means the extent rec at index - 1.
3507 *
3508 * For index == 0, the "before" means the last record of the previous
3509 * extent block. And there is also a situation that we may need to
3510 * remove the rightmost leaf extent block in the right_path and change
3511 * the right path to indicate the new rightmost path.
3512 */
3519 {
3534 /* we meet with a cross extent block merge. */
3539 }
3552 right_path);
3556 left_path);
3560 }
3566 subtree_index);
3570 }
3579 }
3586 }
3587 }
3592 }
3599 }
3602 /*
3603 * The easy case - we can just plop the record right in.
3604 */
3614 split_clusters));
3623 /*
3624 * In the situation that the right_rec is empty and the extent
3625 * block is empty also, ocfs2_complete_edge_insert can't handle
3626 * it and we need to delete the right extent block.
3627 */
3632 right_path,
3633 dealloc);
3637 }
3639 /* Now the rightmost extent block has been deleted.
3640 * So we use the new rightmost path.
3641 */
3647 }
3648 out:
3651 }
3660 {
3668 /*
3669 * The merge code will need to create an empty
3670 * extent to take the place of the newly
3671 * emptied slot. Remove any pre-existing empty
3672 * extents - having more than one in a leaf is
3673 * illegal.
3674 */
3679 }
3680 split_index--;
3682 }
3685 /*
3686 * Left-right contig implies this.
3687 */
3690 /*
3691 * Since the leftright insert always covers the entire
3692 * extent, this call will delete the insert record
3693 * entirely, resulting in an empty extent record added to
3694 * the extent block.
3695 *
3696 * Since the adding of an empty extent shifts
3697 * everything back to the right, there's no need to
3698 * update split_index here.
3699 *
3700 * When the split_index is zero, we need to merge it to the
3701 * prevoius extent block. It is more efficient and easier
3702 * if we do merge_right first and merge_left later.
3703 */
3705 split_index);
3709 }
3711 /*
3712 * We can only get this from logic error above.
3713 */
3716 /* The merge left us with an empty extent, remove it. */
3721 }
3725 /*
3726 * Note that we don't pass split_rec here on purpose -
3727 * we've merged it into the rec already.
3728 */
3735 }
3738 /*
3739 * Error from this last rotate is not critical, so
3740 * print but don't bubble it up.
3741 */
3746 /*
3747 * Merge a record to the left or right.
3748 *
3749 * 'contig_type' is relative to the existing record,
3750 * so for example, if we're "right contig", it's to
3751 * the record on the left (hence the left merge).
3752 */
3756 split_index);
3760 }
3764 split_index);
3768 }
3769 }
3772 /*
3773 * The merge may have left an empty extent in
3774 * our leaf. Try to rotate it away.
3775 */
3777 dealloc);
3781 }
3782 }
3784 out:
3786 }
3792 {
3793 u64 len_blocks;
3799 /*
3800 * Region is on the left edge of the existing
3801 * record.
3802 */
3809 /*
3810 * Region is on the right edge of the existing
3811 * record.
3812 */
3815 }
3816 }
3818 /*
3819 * Do the final bits of extent record insertion at the target leaf
3820 * list. If this leaf is part of an allocation tree, it is assumed
3821 * that the tree above has been prepared.
3822 */
3827 {
3840 insert_rec);
3842 }
3844 /*
3845 * Contiguous insert - either left or right.
3846 */
3852 }
3856 }
3858 /*
3859 * Handle insert into an empty leaf.
3860 */
3867 }
3869 /*
3870 * Appending insert.
3871 */
3881 "owner %llu, depth %u, count %u, next free %u, "
3882 "rec.cpos %u, rec.clusters %u, "
3892 i++;
3896 }
3898 rotate:
3899 /*
3900 * Ok, we have to rotate.
3901 *
3902 * At this point, it is safe to assume that inserting into an
3903 * empty leaf and appending to a leaf have both been handled
3904 * above.
3905 *
3906 * This leaf needs to have space, either by the empty 1st
3907 * extent record, or by virtue of an l_next_rec < l_count.
3908 */
3910 }
3916 {
3922 /*
3923 * Update everything except the leaf block.
3924 */
3936 }
3947 }
3948 }
3955 {
3962 /*
3963 * This shouldn't happen for non-trees. The extent rec cluster
3964 * count manipulation below only works for interior nodes.
3965 */
3968 /*
3969 * If our appending insert is at the leftmost edge of a leaf,
3970 * then we might need to update the rightmost records of the
3971 * neighboring path.
3972 */
3977 u32 left_cpos;
3984 }
3990 left_cpos);
3992 /*
3993 * No need to worry if the append is already in the
3994 * leftmost leaf.
3995 */
4002 }
4005 left_cpos);
4009 }
4011 /*
4012 * ocfs2_insert_path() will pass the left_path to the
4013 * journal for us.
4014 */
4015 }
4016 }
4022 }
4028 out:
4033 }
4040 {
4057 /*
4058 * This typically means that the record
4059 * started in the left path but moved to the
4060 * right as a result of rotation. We either
4061 * move the existing record to the left, or we
4062 * do the later insert there.
4063 *
4064 * In this case, the left path should always
4065 * exist as the rotate code will have passed
4066 * it back for a post-insert update.
4067 */
4070 /*
4071 * It's a left split. Since we know
4072 * that the rotate code gave us an
4073 * empty extent in the left path, we
4074 * can just do the insert there.
4075 */
4078 /*
4079 * Right split - we have to move the
4080 * existing record over to the left
4081 * leaf. The insert will be into the
4082 * newly created empty extent in the
4083 * right leaf.
4084 */
4092 }
4093 }
4097 /*
4098 * Left path is easy - we can just allow the insert to
4099 * happen.
4100 */
4105 }
4111 }
4113 /*
4114 * This function only does inserts on an allocation b-tree. For tree
4115 * depth = 0, ocfs2_insert_at_leaf() is called directly.
4116 *
4117 * right_path is the path we want to do the actual insert
4118 * in. left_path should only be passed in if we need to update that
4119 * portion of the tree after an edge insert.
4120 */
4127 {
4132 /*
4133 * There's a chance that left_path got passed back to
4134 * us without being accounted for in the
4135 * journal. Extend our transaction here to be sure we
4136 * can change those blocks.
4137 */
4142 }
4148 }
4149 }
4151 /*
4152 * Pass both paths to the journal. The majority of inserts
4153 * will be touching all components anyway.
4154 */
4159 }
4162 /*
4163 * We could call ocfs2_insert_at_leaf() for some types
4164 * of splits, but it's easier to just let one separate
4165 * function sort it all out.
4166 */
4170 /*
4171 * Split might have modified either leaf and we don't
4172 * have a guarantee that the later edge insert will
4173 * dirty this for us.
4174 */
4180 insert);
4185 /*
4186 * The rotate code has indicated that we need to fix
4187 * up portions of the tree after the insert.
4188 *
4189 * XXX: Should we extend the transaction here?
4190 */
4192 right_path);
4194 subtree_index);
4195 }
4198 out:
4200 }
4206 {
4208 u32 cpos;
4216 OCFS2_JOURNAL_ACCESS_WRITE);
4220 }
4225 }
4232 }
4234 /*
4235 * Determine the path to start with. Rotations need the
4236 * rightmost path, everything else can go directly to the
4237 * target leaf.
4238 */
4244 }
4250 }
4252 /*
4253 * Rotations and appends need special treatment - they modify
4254 * parts of the tree's above them.
4255 *
4256 * Both might pass back a path immediate to the left of the
4257 * one being inserted to. This will be cause
4258 * ocfs2_insert_path() to modify the rightmost records of
4259 * left_path to account for an edge insert.
4260 *
4261 * XXX: When modifying this code, keep in mind that an insert
4262 * can wind up skipping both of these two special cases...
4263 */
4271 }
4273 /*
4274 * ocfs2_rotate_tree_right() might have extended the
4275 * transaction without re-journaling our tree root.
4276 */
4278 OCFS2_JOURNAL_ACCESS_WRITE);
4282 }
4290 }
4291 }
4298 }
4300 out_update_clusters:
4307 out:
4312 }
4314 static enum ocfs2_contig_type
4319 {
4343 left_cpos);
4354 "Extent block #%llu has an "
4355 "invalid l_next_free_rec of "
4356 "%d. It should have "
4363 }
4366 }
4367 }
4369 /*
4370 * We're careful to check for an empty extent record here -
4371 * the merge code will know what to do if it sees one.
4372 */
4379 }
4380 }
4409 "Extent block #%llu has an "
4415 }
4417 }
4418 }
4429 }
4431 free_right_path:
4433 free_left_path:
4435 exit:
4437 }
4443 {
4451 insert_rec);
4455 }
4456 }
4465 /*
4466 * Caller might want us to limit the size of extents, don't
4467 * calculate contiguousness if we might exceed that limit.
4468 */
4472 }
4473 }
4475 /*
4476 * This should only be called against the righmost leaf extent list.
4477 *
4478 * ocfs2_figure_appending_type() will figure out whether we'll have to
4479 * insert at the tail of the rightmost leaf.
4480 *
4481 * This should also work against the root extent list for tree's with 0
4482 * depth. If we consider the root extent list to be the rightmost leaf node
4483 * then the logic here makes sense.
4484 */
4488 {
4501 /* Were all records empty? */
4504 }
4515 set_tail_append:
4517 }
4519 /*
4520 * Helper function called at the beginning of an insert.
4521 *
4522 * This computes a few things that are commonly used in the process of
4523 * inserting into the btree:
4524 * - Whether the new extent is contiguous with an existing one.
4525 * - The current tree depth.
4526 * - Whether the insert is an appending one.
4527 * - The total # of free records in the tree.
4528 *
4529 * All of the information is stored on the ocfs2_insert_type
4530 * structure.
4531 */
4537 {
4550 /*
4551 * If we have tree depth, we read in the
4552 * rightmost extent block ahead of time as
4553 * ocfs2_figure_insert_type() and ocfs2_add_branch()
4554 * may want it later.
4555 */
4562 }
4565 }
4567 /*
4568 * Unless we have a contiguous insert, we'll need to know if
4569 * there is room left in our allocation tree for another
4570 * extent record.
4571 *
4572 * XXX: This test is simplistic, we can search for empty
4573 * extent records too.
4574 */
4582 }
4589 }
4591 /*
4592 * In the case that we're inserting past what the tree
4593 * currently accounts for, ocfs2_find_path() will return for
4594 * us the rightmost tree path. This is accounted for below in
4595 * the appending code.
4596 */
4601 }
4605 /*
4606 * Now that we have the path, there's two things we want to determine:
4607 * 1) Contiguousness (also set contig_index if this is so)
4608 *
4609 * 2) Are we doing an append? We can trivially break this up
4610 * into two types of appends: simple record append, or a
4611 * rotate inside the tail leaf.
4612 */
4615 /*
4616 * The insert code isn't quite ready to deal with all cases of
4617 * left contiguousness. Specifically, if it's an insert into
4618 * the 1st record in a leaf, it will require the adjustment of
4619 * cluster count on the last record of the path directly to it's
4620 * left. For now, just catch that case and fool the layers
4621 * above us. This works just fine for tree_depth == 0, which
4622 * is why we allow that above.
4623 */
4628 /*
4629 * Ok, so we can simply compare against last_eb to figure out
4630 * whether the path doesn't exist. This will only happen in
4631 * the case that we're doing a tail append, so maybe we can
4632 * take advantage of that information somehow.
4633 */
4636 /*
4637 * Ok, ocfs2_find_path() returned us the rightmost
4638 * tree path. This might be an appending insert. There are
4639 * two cases:
4640 * 1) We're doing a true append at the tail:
4641 * -This might even be off the end of the leaf
4642 * 2) We're "appending" by rotating in the tail
4643 */
4645 }
4647 out:
4652 else
4655 }
4657 /*
4658 * Insert an extent into a btree.
4659 *
4660 * The caller needs to update the owning btree's cluster count.
4661 */
4664 u32 cpos,
4665 u64 start_blk,
4666 u32 new_clusters,
4667 u8 flags,
4669 {
4689 }
4696 }
4705 meta_ac);
4709 }
4710 }
4712 /* Finally, we can add clusters. This might rotate the tree for us. */
4716 else
4719 bail:
4723 }
4725 /*
4726 * Allcate and add clusters into the extent b-tree.
4727 * The new clusters(clusters_to_add) will be inserted at logical_offset.
4728 * The extent b-tree's root is specified by et, and
4729 * it is not limited to the file storage. Any extent tree can use this
4730 * function if it implements the proper ocfs2_extent_tree.
4731 */
4735 u32 clusters_to_add,
4740 {
4746 u64 block;
4761 }
4763 /* there are two cases which could cause us to EAGAIN in the
4764 * we-need-more-metadata case:
4765 * 1) we haven't reserved *any*
4766 * 2) we are so fragmented, we've needed to add metadata too
4767 * many times. */
4780 }
4788 }
4792 /* reserve our write early -- insert_extent may update the tree root */
4794 OCFS2_JOURNAL_ACCESS_WRITE);
4799 }
4811 }
4822 }
4824 bail:
4829 else
4834 num_bits);
4835 }
4837 leave:
4842 }
4846 u32 cpos,
4848 {
4862 }
4871 {
4881 leftright:
4882 /*
4883 * Store a copy of the record on the stack - it might move
4884 * around as the tree is manipulated below.
4885 */
4895 }
4904 }
4905 }
4922 /*
4923 * Left/right split. We fake this as a right split
4924 * first and then make a second pass as a left split.
4925 */
4935 }
4941 }
4944 u32 cpos;
4947 do_leftright++;
4957 }
4963 "Owner %llu has an extent at cpos %u "
4966 cpos);
4969 }
4971 }
4972 out:
4975 }
4983 {
4991 }
4996 out:
4998 }
5000 /*
5001 * Split part or all of the extent record at split_index in the leaf
5002 * pointed to by path. Merge with the contiguous extent record if needed.
5003 *
5004 * Care is taken to handle contiguousness so as to not grow the tree.
5005 *
5006 * meta_ac is not strictly necessary - we only truly need it if growth
5007 * of the tree is required. All other cases will degrade into a less
5008 * optimal tree layout.
5009 *
5010 * last_eb_bh should be the rightmost leaf block for any extent
5011 * btree. Since a split may grow the tree or a merge might shrink it,
5012 * the caller cannot trust the contents of that buffer after this call.
5013 *
5014 * This code is optimized for readability - several passes might be
5015 * made over certain portions of the tree. All of those blocks will
5016 * have been brought into cache (and pinned via the journal), so the
5017 * extra overhead is not expressed in terms of disk reads.
5018 */
5026 {
5040 }
5043 split_index,
5044 split_rec);
5046 /*
5047 * The core merge / split code wants to know how much room is
5048 * left in this allocation tree, so we pass the
5049 * rightmost extent list.
5050 */
5060 }
5070 else
5083 else
5095 }
5097 out:
5100 }
5102 /*
5103 * Change the flags of the already-existing extent at cpos for len clusters.
5104 *
5105 * new_flags: the flags we want to set.
5106 * clear_flags: the flags we want to clear.
5107 * phys: the new physical offset we want this new extent starts from.
5108 *
5109 * If the existing extent is larger than the request, initiate a
5110 * split. An attempt will be made at merging with adjacent extents.
5111 *
5112 * The caller is responsible for passing down meta_ac if we'll need it.
5113 */
5120 {
5134 }
5140 }
5146 "Owner %llu has an extent at cpos %u which can no "
5152 }
5160 new_flags);
5162 }
5168 clear_flags);
5170 }
5184 dealloc);
5188 out:
5192 }
5194 /*
5195 * Mark the already-existing extent at cpos as written for len clusters.
5196 * This removes the unwritten extent flag.
5197 *
5198 * If the existing extent is larger than the request, initiate a
5199 * split. An attempt will be made at merging with adjacent extents.
5200 *
5201 * The caller is responsible for passing down meta_ac if we'll need it.
5202 */
5208 {
5217 "that are being written to, but the feature bit "
5222 }
5224 /*
5225 * XXX: This should be fixed up so that we just re-insert the
5226 * next extent records.
5227 */
5236 out:
5238 }
5244 {
5253 /*
5254 * Setup the record to split before we grow the tree.
5255 */
5269 }
5282 }
5287 meta_ac);
5291 }
5292 }
5304 out:
5307 }
5314 {
5329 }
5331 index--;
5332 }
5336 /*
5337 * Check whether this is the rightmost tree record. If
5338 * we remove all of this record or part of its right
5339 * edge then an update of the record lengths above it
5340 * will be required.
5341 */
5345 }
5350 /*
5351 * Changing the leftmost offset (via partial or whole
5352 * record truncate) of an interior (or rightmost) path
5353 * means we have to update the subtree that is formed
5354 * by this leaf and the one to it's left.
5355 *
5356 * There are two cases we can skip:
5357 * 1) Path is the leftmost one in our btree.
5358 * 2) The leaf is rightmost and will be empty after
5359 * we remove the extent record - the rotate code
5360 * knows how to update the newly formed edge.
5361 */
5367 }
5375 }
5378 left_cpos);
5382 }
5383 }
5384 }
5388 path);
5392 }
5398 }
5404 }
5418 /*
5419 * We skip the edge update if this path will
5420 * be deleted by the rotate code.
5421 */
5424 rec);
5425 }
5427 /* Remove leftmost portion of the record. */
5432 /* Remove rightmost portion of the record */
5437 /* Caller should have trapped this. */
5444 }
5451 subtree_index);
5452 }
5460 }
5462 out:
5465 }
5472 {
5479 /*
5480 * XXX: Why are we truncating to 0 instead of wherever this
5481 * affects us?
5482 */
5490 }
5496 }
5502 "Owner %llu has an extent at cpos %u which can no "
5505 cpos);
5508 }
5510 /*
5511 * We have 3 cases of extent removal:
5512 * 1) Range covers the entire extent rec
5513 * 2) Range begins or ends on one edge of the extent rec
5514 * 3) Range is in the middle of the extent rec (no shared edges)
5515 *
5516 * For case 1 we remove the extent rec and left rotate to
5517 * fill the hole.
5518 *
5519 * For case 2 we just shrink the existing extent rec, with a
5520 * tree update if the shrinking edge is also the edge of an
5521 * extent block.
5522 *
5523 * For case 3 we do a right split to turn the extent rec into
5524 * something case 2 can handle.
5525 */
5543 }
5550 }
5552 /*
5553 * The split could have manipulated the tree enough to
5554 * move the record location, so we have to look for it again.
5555 */
5562 }
5570 cpos);
5573 }
5575 /*
5576 * Double check our values here. If anything is fishy,
5577 * it's easier to catch it at the top level.
5578 */
5584 "Owner %llu: error after split at cpos %u"
5591 }
5598 }
5599 }
5601 out:
5604 }
5606 /*
5607 * ocfs2_reserve_blocks_for_rec_trunc() would look basically the
5608 * same as ocfs2_lock_alloctors(), except for it accepts a blocks
5609 * number to reserve some extra blocks, and it only handles meta
5610 * data allocations.
5611 *
5612 * Currently, only ocfs2_remove_btree_range() uses it for truncating
5613 * and punching holes.
5614 */
5617 u32 extents_to_split,
5620 {
5632 }
5644 }
5645 }
5647 out:
5652 }
5653 }
5656 }
5663 {
5674 OCFS2_HAS_REFCOUNT_FL));
5682 }
5683 }
5686 refcount_loc,
5687 phys_blkno,
5688 len,
5694 }
5695 }
5698 extra_blocks);
5702 }
5711 }
5712 }
5720 }
5723 OCFS2_JOURNAL_ACCESS_WRITE);
5727 }
5736 }
5747 phys_blkno),
5750 else
5756 }
5758 out_commit:
5760 out:
5762 bail:
5770 }
5773 {
5782 "slot %d, invalid truncate log parameters: used = "
5786 }
5790 {
5794 /* No records, nothing to coalesce */
5803 }
5807 u64 start_blk,
5809 {
5823 /* tl_bh is loaded from ocfs2_truncate_log_init(). It's validated
5824 * by the underlying call to ocfs2_read_inode_block(), so any
5825 * corruption is a code bug */
5832 "Truncate record count on #%llu invalid "
5838 /* Caller should have known to flush before calling us. */
5844 }
5847 OCFS2_JOURNAL_ACCESS_WRITE);
5851 }
5857 /*
5858 * Move index back to the record we are coalescing with.
5859 * ocfs2_truncate_log_can_coalesce() guarantees nonzero
5860 */
5861 index--;
5867 num_clusters);
5871 }
5877 bail:
5879 }
5885 {
5889 u64 start_blk;
5900 /* Caller has given us at least enough credits to
5901 * update the truncate log dinode */
5903 OCFS2_JOURNAL_ACCESS_WRITE);
5907 }
5913 /* TODO: Perhaps we can calculate the bulk of the
5914 * credits up front rather than extending like
5915 * this. */
5917 OCFS2_TRUNCATE_LOG_FLUSH_ONE_REC);
5921 }
5928 /* if start_blk is not set, we ignore the record as
5929 * invalid. */
5937 num_clusters);
5941 }
5942 }
5943 i--;
5944 }
5948 bail:
5950 }
5952 /* Expects you to already be holding tl_inode->i_mutex */
5954 {
5969 /* tl_bh is loaded from ocfs2_truncate_log_init(). It's validated
5970 * by the underlying call to ocfs2_read_inode_block(), so any
5971 * corruption is a code bug */
5978 num_to_flush);
5982 }
5985 GLOBAL_BITMAP_SYSTEM_INODE,
5986 OCFS2_INVALID_SLOT);
5991 }
5999 }
6006 }
6009 data_alloc_bh);
6015 out_unlock:
6019 out_mutex:
6023 out:
6025 }
6028 {
6037 }
6040 {
6049 else
6051 }
6053 #define OCFS2_TRUNCATE_LOG_FLUSH_INTERVAL (2 * HZ)
6056 {
6059 /* We want to push off log flushes while truncates are
6060 * still running. */
6065 OCFS2_TRUNCATE_LOG_FLUSH_INTERVAL);
6066 }
6067 }
6073 {
6079 TRUNCATE_LOG_SYSTEM_INODE,
6080 slot_num);
6085 }
6092 }
6096 bail:
6098 }
6100 /* called during the 1st stage of node recovery. we stamp a clean
6101 * truncate log and pass back a copy for processing later. if the
6102 * truncate log does not require processing, a *tl_copy is set to
6103 * NULL. */
6107 {
6122 }
6126 /* tl_bh is loaded from ocfs2_get_truncate_log_info(). It's
6127 * validated by the underlying call to ocfs2_read_inode_block(),
6128 * so any corruption is a code bug */
6140 }
6142 /* Assuming the write-out below goes well, this copy
6143 * will be passed back to recovery for processing. */
6146 /* All we need to do to clear the truncate log is set
6147 * tl_used. */
6155 }
6156 }
6158 bail:
6167 }
6170 }
6174 {
6178 u64 start_blk;
6186 }
6192 num_recs);
6201 }
6202 }
6209 }
6221 }
6222 }
6224 bail_up:
6228 }
6231 {
6247 }
6248 }
6251 {
6263 /* ocfs2_truncate_log_shutdown keys on the existence of
6264 * osb->osb_tl_inode so we don't set any of the osb variables
6265 * until we're sure all is well. */
6267 ocfs2_truncate_log_worker);
6273 }
6275 /*
6276 * Delayed de-allocation of suballocator blocks.
6277 *
6278 * Some sets of block de-allocations might involve multiple suballocator inodes.
6279 *
6280 * The locking for this can get extremely complicated, especially when
6281 * the suballocator inodes to delete from aren't known until deep
6282 * within an unrelated codepath.
6283 *
6284 * ocfs2_extent_block structures are a good example of this - an inode
6285 * btree could have been grown by any number of nodes each allocating
6286 * out of their own suballoc inode.
6287 *
6288 * These structures allow the delay of block de-allocation until a
6289 * later time, when locking of multiple cluster inodes won't cause
6290 * deadlock.
6291 */
6293 /*
6294 * Describe a single bit freed from a suballocator. For the block
6295 * suballocators, it represents one block. For the global cluster
6296 * allocator, it represents some clusters and free_bit indicates
6297 * clusters number.
6298 */
6301 u64 free_bg;
6302 u64 free_blk;
6304 };
6311 };
6317 {
6319 u64 bg_blkno;
6330 }
6338 }
6345 }
6350 else
6361 }
6367 }
6372 }
6374 out_journal:
6377 out_unlock:
6380 out_mutex:
6383 out:
6385 /* Premature exit may have left some dangling items. */
6389 }
6392 }
6396 {
6405 }
6415 }
6419 {
6433 }
6434 }
6441 }
6454 }
6455 }
6460 /* Premature exit may have left some dangling items. */
6464 }
6467 }
6471 {
6492 }
6496 }
6507 }
6510 }
6516 {
6524 }
6534 }
6536 }
6541 {
6551 }
6558 }
6572 out:
6574 }
6578 {
6584 }
6587 {
6591 }
6596 {
6606 /*
6607 * Need to set the buffers we zero'd into uptodate
6608 * here if they aren't - ocfs2_map_page_blocks()
6609 * might've skipped some
6610 */
6613 ocfs2_zero_func);
6620 }
6626 }
6631 {
6657 }
6658 out:
6661 }
6665 {
6669 loff_t last_page_bytes;
6682 }
6684 numpages++;
6685 index++;
6688 out:
6693 }
6698 }
6702 {
6709 }
6711 /*
6712 * Zero the area past i_size but still within an allocated
6713 * cluster. This avoids exposing nonzero data on subsequent file
6714 * extends.
6715 *
6716 * We need to call this before i_size is updated on the inode because
6717 * otherwise block_write_full_page() will skip writeout of pages past
6718 * i_size. The new_i_size parameter is passed for this reason.
6719 */
6722 {
6725 u64 phys;
6729 /*
6730 * File systems which don't support sparse files zero on every
6731 * extend.
6732 */
6742 }
6753 }
6755 /*
6756 * Tail is a hole, or is marked unwritten. In either case, we
6757 * can count on read and write to return/push zero's.
6758 */
6767 }
6772 /*
6773 * Initiate writeout of the pages we zero'd here. We don't
6774 * wait on them - the truncate_inode_pages() call later will
6775 * do that for us.
6776 */
6782 out:
6786 }
6790 {
6797 xattrsize);
6798 else
6801 }
6805 {
6811 }
6814 {
6823 /*
6824 * We clear the entire i_data structure here so that all
6825 * fields can be properly initialized.
6826 */
6831 }
6835 {
6859 }
6865 }
6866 }
6874 }
6877 OCFS2_JOURNAL_ACCESS_WRITE);
6881 }
6885 u64 phys;
6900 }
6902 /*
6903 * Save two copies, one for insert, and one that can
6904 * be changed by ocfs2_map_and_dirty_page() below.
6905 */
6908 /*
6909 * Non sparse file systems zero on extend, so no need
6910 * to do that now.
6911 */
6921 }
6923 /*
6924 * This should populate the 1st page for us and mark
6925 * it up to date.
6926 */
6932 }
6941 }
6954 /*
6955 * An error at this point should be extremely rare. If
6956 * this proves to be false, we could always re-build
6957 * the in-inode data from our pages.
6958 */
6965 }
6968 }
6970 out_unlock:
6974 out_commit:
6983 else
6988 num);
6989 }
6993 out:
6996 free_pages:
6999 }
7001 /*
7002 * It is expected, that by the time you call this function,
7003 * inode->i_size and fe->i_size have been adjusted.
7004 *
7005 * WARNING: This will kfree the truncate context
7006 */
7010 {
7031 ocfs2_journal_access_di);
7036 }
7040 start:
7041 /*
7042 * Check that we still have allocation to delete.
7043 */
7047 }
7049 /*
7050 * Truncate always works against the rightmost tree branch.
7051 */
7056 }
7060 new_highest_cpos,
7064 /*
7065 * By now, el will point to the extent list on the bottom most
7066 * portion of this tree. Only the tail record is considered in
7067 * each pass.
7068 *
7069 * We handle the following cases, in order:
7070 * - empty extent: delete the remaining branch
7071 * - remove the entire record
7072 * - remove a partial record
7073 * - no record needs to be removed (truncate has completed)
7074 */
7083 }
7091 /*
7092 * Lower levels depend on this never happening, but it's best
7093 * to check it up here before changing the tree.
7094 */
7101 }
7106 /*
7107 * Truncate entire record.
7108 */
7113 /*
7114 * Partial truncate. it also should be
7115 * the last truncate we're doing.
7116 */
7123 /*
7124 * Truncate completed, leave happily.
7125 */
7128 }
7138 }
7139 }
7147 }
7151 /*
7152 * The check above will catch the case where we've truncated
7153 * away all allocation.
7154 */
7157 bail:
7168 }
7170 /*
7171 * 'start' is inclusive, 'end' is not.
7172 */
7175 {
7192 "Inline data flags for inode %llu don't agree! "
7200 }
7207 }
7210 OCFS2_JOURNAL_ACCESS_WRITE);
7214 }
7219 /*
7220 * No need to worry about the data page here - it's been
7221 * truncated already and inline data doesn't need it for
7222 * pushing zero's to disk, so we'll let readpage pick it up
7223 * later.
7224 */
7228 }
7239 out_commit:
7242 out:
7244 }
7249 {
7259 }
7264 {
7286 }
7288 }
7294 }
7298 }
7304 }
7307 {
7326 GLOBAL_BITMAP_SYSTEM_INODE,
7327 OCFS2_INVALID_SLOT);
7332 }
7340 }
7346 }
7354 /* Determine first and last group to examine based on start and len */
7358 else
7367 else
7376 }
7386 }
7393 else
7395 }
7397 out_unlock:
7400 out_mutex:
7403 out:
7405 }