Btrfs: add a comment explaining what btrfs_cont_expand does
authorJosef Bacik <josef@redhat.com>
Fri, 4 Mar 2011 20:46:53 +0000 (15:46 -0500)
committerJosef Bacik <josef@redhat.com>
Thu, 17 Mar 2011 18:21:33 +0000 (14:21 -0400)
Everytime I have to deal with btrfs_cont_expand I stare at it for 20 minutes
trying to remember what exactly it does and why the hell we need it.  So add a
comment to save future-Josef some time.  Thanks,

Signed-off-by: Josef Bacik <josef@redhat.com>
fs/btrfs/inode.c

index 64d57e032b4e520978ceb2f6716a3e6f16f30fe0..888dbdb3b128beec3fc3c173045da6f92c73e79a 100644 (file)
@@ -3557,6 +3557,12 @@ out:
        return ret;
 }
 
+/*
+ * This function puts in dummy file extents for the area we're creating a hole
+ * for.  So if we are truncating this file to a larger size we need to insert
+ * these file extents so that btrfs_get_extent will return a EXTENT_MAP_HOLE for
+ * the range between oldsize and size
+ */
 int btrfs_cont_expand(struct inode *inode, loff_t oldsize, loff_t size)
 {
        struct btrfs_trans_handle *trans;