From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from out199-10.us.a.mail.aliyun.com (out199-10.us.a.mail.aliyun.com [47.90.199.10]) by mail19.linbit.com (LINBIT Mail Daemon) with ESMTP id 9AC664205E3 for ; Fri, 9 Aug 2024 11:43:50 +0200 (CEST) From: Yang Li To: axboe@kernel.dk, christoph.boehmwalder@linbit.com Subject: [PATCH -next] drbd: Add missing kernel-doc function comments. Date: Fri, 9 Aug 2024 17:32:33 +0800 Message-Id: <20240809093233.8627-1-yang.lee@linux.alibaba.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Cc: linux-block@vger.kernel.org, Yang Li , linux-kernel@vger.kernel.org, drbd-dev@lists.linbit.com List-Id: "*Coordination* of development, patches, contributions -- *Questions* \(even to developers\) go to drbd-user, please." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Add missing kernel-doc function comments to enhance code readability and maintainability in accordance with the kernel coding standards. Signed-off-by: Yang Li --- drivers/block/drbd/drbd_bitmap.c | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/drivers/block/drbd/drbd_bitmap.c b/drivers/block/drbd/drbd_bitmap.c index 85ca000a0564..746bb75ab2a4 100644 --- a/drivers/block/drbd/drbd_bitmap.c +++ b/drivers/block/drbd/drbd_bitmap.c @@ -1213,6 +1213,7 @@ static int bm_rw(struct drbd_device *device, const unsigned int flags, unsigned /** * drbd_bm_read() - Read the whole bitmap from its on disk location. * @device: DRBD device. + * @peer_device: DRBD peer device. */ int drbd_bm_read(struct drbd_device *device, struct drbd_peer_device *peer_device) __must_hold(local) @@ -1224,6 +1225,7 @@ int drbd_bm_read(struct drbd_device *device, /** * drbd_bm_write() - Write the whole bitmap to its on disk location. * @device: DRBD device. + * @peer_device: DRBD peer device. * * Will only write pages that have changed since last IO. */ @@ -1236,6 +1238,7 @@ int drbd_bm_write(struct drbd_device *device, /** * drbd_bm_write_all() - Write the whole bitmap to its on disk location. * @device: DRBD device. + * @peer_device: DRBD peer device. * * Will write all pages. */ @@ -1258,6 +1261,7 @@ int drbd_bm_write_lazy(struct drbd_device *device, unsigned upper_idx) __must_ho /** * drbd_bm_write_copy_pages() - Write the whole bitmap to its on disk location. * @device: DRBD device. + * @peer_device: DRBD peer device. * * Will only write pages that have changed since last IO. * In contrast to drbd_bm_write(), this will copy the bitmap pages -- 2.32.0.3.g01195cf9f