From: Javier Martinez Canillas <javierm@redhat.com>
Date: Thu, 12 Feb 2026 20:44:58 +0000 (+0100)
Subject: disk: part_dos: Document part_get_info_extended() helper function
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=d25c5d657ec057e18eb32e2e8c354d5145e79cb0;p=thirdparty%2Fu-boot.git

disk: part_dos: Document part_get_info_extended() helper function

The function receives many parameters but these are not documented.
Add a description for these to make it easier to follow what it does.

Suggested-by: Heinrich Schuchardt <xypron.glpk@gmx.de>
Signed-off-by: Javier Martinez Canillas <javierm@redhat.com>
Reviewed-by: Ilias Apalodimas <ilias.apalodimas@linaro.org>
---

diff --git a/disk/part_dos.c b/disk/part_dos.c
index 60c3d677369..a69ad896210 100644
--- a/disk/part_dos.c
+++ b/disk/part_dos.c
@@ -196,7 +196,18 @@ static void print_partition_extended(struct blk_desc *desc,
 	return;
 }
 
-/*  Print a partition that is relative to its Extended partition table
+/**
+ * part_get_info_extended() - get partition info for a DOS partition
+ *
+ * @desc:		Block device descriptor
+ * @ext_part_sector:	Partition table sector
+ * @relative:		Relative offset for the partition
+ * @part_num:		Current partition number
+ * @which_part:		Target partition number
+ * @info:		Returns a pointer to the partition info
+ * @disksig:		Disk signature
+ *
+ * Return:		0 on success, negative on error
  */
 static int part_get_info_extended(struct blk_desc *desc,
 				  lbaint_t ext_part_sector, lbaint_t relative,