From nobody Sat Feb 7 08:13:41 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id A4F5C2D1931 for ; Wed, 28 Jan 2026 06:24:44 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769581487; cv=none; b=utMjajYaCwxcE8QcuSFfzx+ElICI373uR/ZiUl9nwVs+0UEHx04lF1RAab2S4b8KQ6JVU+G4XNzY/xJpEX1I6EajF+abx0LfwdyxBPn/ihLr388jpBshsZDhgsqZrTdRfRnNEsLAxXFhGGfBJdtwLBoBN8FgLUDJEUVOyjP2+Vs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1769581487; c=relaxed/simple; bh=JGVAyC0XWg8x0sIVvUTe3pKN3qk0dYZui4kIMqAsq7M=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=r5tzruMdhJEoFMhwizeU0Lti1l4QjHYkpo3pZoS/+N/63GBQY/Qfo9nVYV1RIMaPd+UCBXvCpE4MN2dJOuEslXnAL0KfyOFtylb8wZyBzHc2NvD3pLF9TboeC41v0s7cVZX297w1Kcqmq0kLnAJyutU4CoTRSj6w2UePcPXZERg= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=S/4NciC7; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="S/4NciC7" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=unSzsUcMgdCgwFwxWv0Oawmi1NrmYg5Iy3BpIo3rn78=; b=S/4NciC7YfjjqIM/EOHaLISH4F VN9HSGHJ7vPodBJcDmgJ+d5u9VBeytRdMy5hBlvI3hX8UMQe4ex/pPSfjtTlp/Xjg+tw3AK3Dq6o9 3owIlrrLRDzrjZoNKI9Kv7AJRWIoGDMbkeX0J6UfTbIuTHywKt/M8rrKWZSJZKMVSP8lIHf2KmoRL cufZy116Gd+zTNgRP46rcbuIzX2nLvFkRlHNDaTdw8h9x3nrnK5cgr88G3Dh1sjcBUe6dwk/k7pJG 8gLB9gqtC+IhuhVXrf2P4CSNQOSea0xK+2gt6dEA1yOsEtdR0hHtT5PMgkrgfp4w4fnwNHG6poSPb HTWGlt3g==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vkyyh-0000000FXGb-0ldp; Wed, 28 Jan 2026 06:24:35 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Richard Weinberger , Zhihao Cheng , Miquel Raynal , Vignesh Raghavendra , linux-mtd@lists.infradead.org Subject: [PATCH] ubi: ubi.h: fix kernel-doc warnings Date: Tue, 27 Jan 2026 22:24:34 -0800 Message-ID: <20260128062434.400750-1-rdunlap@infradead.org> X-Mailer: git-send-email 2.52.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" Fix all default warning level kernel-doc warnings in ubi.h: Warning: drivers/mtd/ubi/ubi.h:176 struct member 'u' not described in 'ubi_= wl_entry' Warning: drivers/mtd/ubi/ubi.h:370 struct member 'is_dead' not described in= 'ubi_volume' Warning: drivers/mtd/ubi/ubi.h:655 struct member 'is_dead' not described in= 'ubi_device' Warning: drivers/mtd/ubi/ubi.h:743 bad line: all existing Fastmap data stru= ctures Warning: drivers/mtd/ubi/ubi.h:783 struct member 'vidb' not described in 'u= bi_attach_info' Warning: drivers/mtd/ubi/ubi.h:1098 expecting prototype for ubi_init_vid_bu= f(). Prototype was for ubi_alloc_vid_buf() instead Signed-off-by: Randy Dunlap Reviewed-by: Zhihao Cheng --- Cc: Richard Weinberger Cc: Zhihao Cheng Cc: Miquel Raynal Cc: Vignesh Raghavendra Cc: linux-mtd@lists.infradead.org drivers/mtd/ubi/ubi.h | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) --- linux-next-20260126.orig/drivers/mtd/ubi/ubi.h +++ linux-next-20260126/drivers/mtd/ubi/ubi.h @@ -160,6 +160,7 @@ struct ubi_vid_io_buf { * struct ubi_wl_entry - wear-leveling entry. * @u.rb: link in the corresponding (free/used) RB-tree * @u.list: link in the protection queue + * @u: union of rb_node and list_head * @ec: erase counter * @pnum: physical eraseblock number * @@ -282,6 +283,7 @@ struct ubi_eba_leb_desc { * @writers: number of users holding this volume in read-write mode * @exclusive: whether somebody holds this volume in exclusive mode * @metaonly: whether somebody is altering only meta data of this volume + * @is_dead: prevents taking a reference to the volume * * @reserved_pebs: how many physical eraseblocks are reserved for this vol= ume * @vol_type: volume type (%UBI_DYNAMIC_VOLUME or %UBI_STATIC_VOLUME) @@ -449,6 +451,7 @@ struct ubi_debug_info { * @vol->eba_tbl. * @ref_count: count of references on the UBI device * @image_seq: image sequence number recorded on EC headers + * @is_dead: prevents taking a reference to the volume * * @rsvd_pebs: count of reserved physical eraseblocks * @avail_pebs: count of available physical eraseblocks @@ -741,7 +744,7 @@ struct ubi_ainf_volume { * @highest_vol_id: highest volume ID * @is_empty: flag indicating whether the MTD device is empty or not * @force_full_scan: flag indicating whether we need to do a full scan and= drop - all existing Fastmap data structures + * all existing Fastmap data structures * @min_ec: lowest erase counter value * @max_ec: highest erase counter value * @max_sqnum: highest sequence number value @@ -750,7 +753,7 @@ struct ubi_ainf_volume { * @ec_count: a temporary variable used when calculating @mean_ec * @aeb_slab_cache: slab cache for &struct ubi_ainf_peb objects * @ech: temporary EC header. Only available during scan - * @vidh: temporary VID buffer. Only available during scan + * @vidb: temporary VID buffer. Only available during scan * * This data structure contains the result of attaching an MTD device and = may * be used by other UBI sub-systems to build final UBI data structures, fu= rther @@ -1090,7 +1093,7 @@ static inline void ubi_init_vid_buf(cons } =20 /** - * ubi_init_vid_buf - Allocate a VID buffer + * ubi_alloc_vid_buf - Allocate a VID buffer * @ubi: the UBI device * @gfp_flags: GFP flags to use for the allocation */