From: Nikolay Borisov Date: Tue, 1 Sep 2020 14:40:00 +0000 (+0300) Subject: btrfs: add kerneldoc for setup_items_for_insert X-Git-Tag: v5.10-rc1~178^2~44 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=da9ffb242c448af20f70b431d3f04df50c6cb0d2;p=thirdparty%2Fkernel%2Flinux.git btrfs: add kerneldoc for setup_items_for_insert Reviewed-by: Josef Bacik Reviewed-by: Johannes Thumshirn Signed-off-by: Nikolay Borisov Reviewed-by: David Sterba Signed-off-by: David Sterba --- diff --git a/fs/btrfs/ctree.c b/fs/btrfs/ctree.c index a0a4a885664e9..4fb2b06739504 100644 --- a/fs/btrfs/ctree.c +++ b/fs/btrfs/ctree.c @@ -4753,10 +4753,16 @@ void btrfs_extend_item(struct btrfs_path *path, u32 data_size) } } -/* - * this is a helper for btrfs_insert_empty_items, the main goal here is - * to save stack depth by doing the bulk of the work in a function - * that doesn't call btrfs_search_slot +/** + * setup_items_for_insert - Helper called before inserting one or more items + * to a leaf. Main purpose is to save stack depth by doing the bulk of the work + * in a function that doesn't call btrfs_search_slot + * + * @root: root we are inserting items to + * @path: points to the leaf/slot where we are going to insert new items + * @cpu_key: array of keys for items to be inserted + * @data_size: size of the body of each item we are going to insert + * @nr: size of @cpu_key/@data_size arrays */ void setup_items_for_insert(struct btrfs_root *root, struct btrfs_path *path, const struct btrfs_key *cpu_key, u32 *data_size,