From nobody Tue Dec 2 02:51:15 2025 Received: from mail-pl1-f182.google.com (mail-pl1-f182.google.com [209.85.214.182]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 546ED2C21DE for ; Mon, 17 Nov 2025 17:26:22 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.214.182 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763400384; cv=none; b=egNz+3QSz4z6AjCkjQ666WTtBinHPAj2dzO70zMcMHcqQRpf0CZyZ4cXDQl0eTksY/WrcjW679KZeuo6dZYdqJHGZeQRuxDDInTxkYy/0FcYln9ooYCCx2JXbpfHZzbWJR931S1AictsRWpVmm/+nOOP6JTKYAEzKUivArWIDfs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763400384; c=relaxed/simple; bh=eNAbAlLxtfdIFI4DsoP7fW20zHjXCvlLcYgwWPPGr3w=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=h6DAZjt3UD+6Tf1iqhk2AU8XNrXXDj3J9pIRdus9eWpcEXud0ed9WnIY1WPJlMWzrx2qj/a5sKviyw6GH1l4k0EqkHzOSQ3/Q3pQ+ZebpJvdz3axXXHctoMLJsIaoi1SsQz7XqP/QP7RxcUJwctiKqSOViiMrHQX/yCzP0SxDQA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=nFgVlQxd; arc=none smtp.client-ip=209.85.214.182 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="nFgVlQxd" Received: by mail-pl1-f182.google.com with SMTP id d9443c01a7336-29845b06dd2so51951285ad.2 for ; Mon, 17 Nov 2025 09:26:22 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1763400382; x=1764005182; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=v3YaAQQfJl7oxy9ZHWXLH2rWSEnvHqvGOwv88JZqfY4=; b=nFgVlQxdW5jTK1wb5GzFogTOxl8P3sN04YS9ggh9JRN3IoEzyPm+C4Cvj0AdxvPKQb LpUEM5hKOFylV15iNfapV87w6FvuCN0CzALVbfu+O4t9+9RDKP+dhI0OSIMaNXyHDMjL SiMI4aTczmoNgyvEex2il7TDWAE8/k6lfEJV0bjiEt+8lulTKC98aIwdfYJQIBA5LKW+ W6zn/RMUi4Ta8RGcfoVnoqz7IOEmzHEcRmvW56+EDchQbkolTxzrLa1JszUzmBCdx7+V NXLuQZ64aHAI988ayztyp1U64eAxgH7E899hLa/tTNjVFKRNX2G94c9yP7BvvDISpk3h ndDA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1763400382; x=1764005182; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=v3YaAQQfJl7oxy9ZHWXLH2rWSEnvHqvGOwv88JZqfY4=; b=AB/1pk+fiVKigm02z9+iZw89CZNAgEmoGWNKOyedbJAfuVO8bODYVLPOpS11L4SrzY z2aNlSapWcdaaEol4/bYHqy6+RwtjCB8H+dl5fZ5hDfIxQvoh77V9sblurnYu6RHX/jN Yu88ptxSIjGe5oAvRa8Fl1c4WHMJLO4PD6UYwdCGuTzipbGVsCW1hy7256AE7Tqc2eq9 jvLkYcVuIzjaqGd/OzAOO3XKqw6xY/jqOLBkzXikmAA2hgPUByEwUczaHeOzhW6UYk7Z hVifrDcFDnR3D6VhxdIaWwxLDSaKoGhRAKzjSYSaIxrYbFz0x18xN0NLyoEXKAVH3Jmv fsgw== X-Forwarded-Encrypted: i=1; AJvYcCUs3yZhRFnHM1g1dszD0zjgdEh8Ro+i3zdVsAnxzeUFbDROrEm7z2drsHpOisZ+Ayka7e4fanEWEY4sLYA=@vger.kernel.org X-Gm-Message-State: AOJu0YwmEc8gEuHV+YhxyfUT6kXNREvwrpVcAw/EMZH9wtOUTnFh+rW/ 2s3JCtQm5VwSsv10rFrPUWFTU4Kns4EzUz4oJ5x0mI4QcYHAgibSo5rx X-Gm-Gg: ASbGncsGEcP5P4403i0jM/i+32WsTIU4CO7Wm1D0Qxuprk2Y4tSPiuT8MIyeLEUmmJw YPFp5ZvGCbH20hpRqCpl23BCfyHOwOLzzE/7eDNpftLa3lotgYJN0xFQ3mdcXKRoyo8hqqA0cx2 NveLjnjd+NzKhIqih3vMaxpjx3j6tFishY6CYrPATFqg4dqT/ELIcD7zsQ4D8J1nmp14xOM6WqL H3/t8aFIzq8258HUqIZTUU0SscIDZ+2BK7yKHiH8mIOx+CUO0lsSOw5vNc6J7CYQGBBtf3eJgcM cYFW6gop6Wa9QW8AEfYpXoptsXY0q1BnydQSNMswZIJXq+UJsiPwIq8bD23oAxbdOGXgy06uB7B j6q5hSV3IbP/5ablbfph89PBtSQjFihFi4Rc5kSBSFkm3H/aN1TSAzayT954+nUreTl59DDXk X-Google-Smtp-Source: AGHT+IGVOqt1KvdPHFwUMBNxRfOX0UgBscBOMeK4i00bBVPVTRd3PKUbbydP08iP89j2CLTLFzgFUQ== X-Received: by 2002:a17:902:d4c4:b0:298:55c8:eb8d with SMTP id d9443c01a7336-2986a72bf9dmr158144985ad.35.1763400382095; Mon, 17 Nov 2025 09:26:22 -0800 (PST) Received: from hsukr3.. ([2405:201:d019:4042:4a5d:d140:fa1f:849b]) by smtp.gmail.com with ESMTPSA id d9443c01a7336-2985c2565easm145017485ad.48.2025.11.17.09.26.17 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 17 Nov 2025 09:26:21 -0800 (PST) From: Sukrut Heroorkar To: Philipp Reisner , Lars Ellenberg , =?UTF-8?q?Christoph=20B=C3=B6hmwalder?= , Jens Axboe , drbd-dev@lists.linbit.com (open list:DRBD DRIVER), linux-block@vger.kernel.org (open list:BLOCK LAYER), linux-kernel@vger.kernel.org (open list) Cc: shuah@kernel.org, david.hunter.linux@gmail.com, Sukrut Heroorkar Subject: [PATCH] drbd: add missing kernel-doc for peer_device parameter Date: Mon, 17 Nov 2025 22:55:56 +0530 Message-ID: <20251117172557.355797-1-hsukrut3@gmail.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" W=3D1 build warns that peer_device is undocumented in the bitmap I/O handlers. This parameter was introduced in commit 8164dd6c8ae1 ("drbd: Add peer device parameter to whole-bitmap I/O handlers"), but the kernel-doc was not updated. Add the missing @peer_device entry. Signed-off-by: Sukrut Heroorkar --- drivers/block/drbd/drbd_bitmap.c | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/drivers/block/drbd/drbd_bitmap.c b/drivers/block/drbd/drbd_bit= map.c index 85ca000a0564..2d26f9d2454d 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 un= signed int flags, unsigned /** * drbd_bm_read() - Read the whole bitmap from its on disk location. * @device: DRBD device. + * @peer_device: Peer device for which the bitmap read is performed. */ 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: Peer device for which the bitmap write is performed. * * Will only write pages that have changed since last IO. */ @@ -1236,7 +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: Peer device for which the bitmap write is performed. * Will write all pages. */ int drbd_bm_write_all(struct drbd_device *device, @@ -1258,6 +1260,7 @@ int drbd_bm_write_lazy(struct drbd_device *device, un= signed upper_idx) __must_ho /** * drbd_bm_write_copy_pages() - Write the whole bitmap to its on disk loca= tion. * @device: DRBD device. + * @peer_device: Peer device for which the bitmap write is performed. * * Will only write pages that have changed since last IO. * In contrast to drbd_bm_write(), this will copy the bitmap pages @@ -1275,6 +1278,7 @@ int drbd_bm_write_copy_pages(struct drbd_device *devi= ce, /** * drbd_bm_write_hinted() - Write bitmap pages with "hint" marks, if they = have changed. * @device: DRBD device. + * @peer_device: Peer device for which the bitmap write is performed. */ int drbd_bm_write_hinted(struct drbd_device *device) __must_hold(local) { --=20 2.43.0