Commit b8b87103 authored by Lee Jones's avatar Lee Jones Committed by Jens Axboe
Browse files

block: drbd: drbd_interval: Demote some kernel-doc abuses and fix another header 



Fixes the following W=1 kernel build warning(s):

 drivers/block/drbd/drbd_interval.c:11: warning: Function parameter or member 'node' not described in 'interval_end'
 drivers/block/drbd/drbd_interval.c:26: warning: Function parameter or member 'root' not described in 'drbd_insert_interval'
 drivers/block/drbd/drbd_interval.c:26: warning: Function parameter or member 'this' not described in 'drbd_insert_interval'
 drivers/block/drbd/drbd_interval.c:70: warning: Function parameter or member 'root' not described in 'drbd_contains_interval'
 drivers/block/drbd/drbd_interval.c:96: warning: Function parameter or member 'root' not described in 'drbd_remove_interval'
 drivers/block/drbd/drbd_interval.c:96: warning: Function parameter or member 'this' not described in 'drbd_remove_interval'
 drivers/block/drbd/drbd_interval.c:113: warning: Function parameter or member 'root' not described in 'drbd_find_overlap'

Cc: Philipp Reisner <philipp.reisner@linbit.com>
Cc: Lars Ellenberg <lars.ellenberg@linbit.com>
Cc: Jens Axboe <axboe@kernel.dk>
Cc: drbd-dev@lists.linbit.com
Cc: linux-block@vger.kernel.org
Signed-off-by: default avatarLee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20210312105530.2219008-3-lee.jones@linaro.org


Signed-off-by: default avatarJens Axboe <axboe@kernel.dk>
parent 762d6bd2

drivers/block/drbd/drbd_interval.c

+5 −3
Original line number Diff line number Diff line
@@ -3,7 +3,7 @@ 
#include <linux/rbtree_augmented.h>

#include "drbd_interval.h"



/**

/*

 * interval_end  -  return end of @node

 */

static inline
@@ -18,7 +18,7 @@ sector_t interval_end(struct rb_node *node) 
RB_DECLARE_CALLBACKS_MAX(static, augment_callbacks,

			 struct drbd_interval, rb, sector_t, end, NODE_END);



/**

/*

 * drbd_insert_interval  -  insert a new interval into a tree

 */

bool
@@ -56,6 +56,7 @@ drbd_insert_interval(struct rb_root *root, struct drbd_interval *this) 


/**

 * drbd_contains_interval  -  check if a tree contains a given interval

 * @root:	red black tree root

 * @sector:	start sector of @interval

 * @interval:	may not be a valid pointer

 *
@@ -88,7 +89,7 @@ drbd_contains_interval(struct rb_root *root, sector_t sector, 
	return false;

}



/**

/*

 * drbd_remove_interval  -  remove an interval from a tree

 */

void
@@ -99,6 +100,7 @@ drbd_remove_interval(struct rb_root *root, struct drbd_interval *this) 


/**

 * drbd_find_overlap  - search for an interval overlapping with [sector, sector + size)

 * @root:	red black tree root

 * @sector:	start sector

 * @size:	size, aligned to 512 bytes

 *