Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

libceph: fix doc warnings in cls_lock_client.c

Add description to fix the following W=1 kernel build warnings:

net/ceph/cls_lock_client.c:28: warning: Function parameter or
member 'osdc' not described in 'ceph_cls_lock'
net/ceph/cls_lock_client.c:28: warning: Function parameter or
member 'oid' not described in 'ceph_cls_lock'
net/ceph/cls_lock_client.c:28: warning: Function parameter or
member 'oloc' not described in 'ceph_cls_lock'

[ idryomov: tweak osdc description ]

Signed-off-by: Baokun Li <libaokun1@huawei.com>
Reviewed-by: Ilya Dryomov <idryomov@gmail.com>
Signed-off-by: Ilya Dryomov <idryomov@gmail.com>

authored by

Baokun Li and committed by
Ilya Dryomov
dc915ecd da6ebb4d

+9 -3
+9 -3
net/ceph/cls_lock_client.c
··· 10 10 11 11 /** 12 12 * ceph_cls_lock - grab rados lock for object 13 - * @oid, @oloc: object to lock 13 + * @osdc: OSD client instance 14 + * @oid: object to lock 15 + * @oloc: object to lock 14 16 * @lock_name: the name of the lock 15 17 * @type: lock type (CEPH_CLS_LOCK_EXCLUSIVE or CEPH_CLS_LOCK_SHARED) 16 18 * @cookie: user-defined identifier for this instance of the lock ··· 84 82 85 83 /** 86 84 * ceph_cls_unlock - release rados lock for object 87 - * @oid, @oloc: object to lock 85 + * @osdc: OSD client instance 86 + * @oid: object to lock 87 + * @oloc: object to lock 88 88 * @lock_name: the name of the lock 89 89 * @cookie: user-defined identifier for this instance of the lock 90 90 */ ··· 134 130 135 131 /** 136 132 * ceph_cls_break_lock - release rados lock for object for specified client 137 - * @oid, @oloc: object to lock 133 + * @osdc: OSD client instance 134 + * @oid: object to lock 135 + * @oloc: object to lock 138 136 * @lock_name: the name of the lock 139 137 * @cookie: user-defined identifier for this instance of the lock 140 138 * @locker: current lock owner