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

scsi: ufs: bsg: Fix all kernel-doc warnings

In struct utp_upiu_query_v4_0, add description for @osf3 and mark the
@reserved field as private so that no description is needed for it.

In struct utp_upiu_cmd, use the correct struct member name to eliminate a
kernel-doc warning.

Signed-off-by: Randy Dunlap <rdunlap@infradead.org>
Link: https://lore.kernel.org/r/20240424055316.1384-1-rdunlap@infradead.org
Cc: James E.J. Bottomley <James.Bottomley@HansenPartnership.com>
Cc: Martin K. Petersen <martin.petersen@oracle.com>
Cc: Alim Akhtar <alim.akhtar@samsung.com>
Cc: Avri Altman <avri.altman@wdc.com>
Cc: Bart Van Assche <bvanassche@acm.org>
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>

authored by

Randy Dunlap and committed by
Martin K. Petersen
de37677e 9cef74a9

+3 -1
+3 -1
include/uapi/scsi/scsi_bsg_ufs.h
··· 123 123 * @idn: a value that indicates the particular type of data B-1 124 124 * @index: Index to further identify data B-2 125 125 * @selector: Index to further identify data B-3 126 + * @osf3: spec field B-4 126 127 * @osf4: spec field B-5 127 128 * @osf5: spec field B 6,7 128 129 * @osf6: spec field DW 8,9 ··· 139 138 __be16 osf5; 140 139 __be32 osf6; 141 140 __be32 osf7; 141 + /* private: */ 142 142 __be32 reserved; 143 143 }; 144 144 145 145 /** 146 146 * struct utp_upiu_cmd - Command UPIU structure 147 - * @data_transfer_len: Data Transfer Length DW-3 147 + * @exp_data_transfer_len: Data Transfer Length DW-3 148 148 * @cdb: Command Descriptor Block CDB DW-4 to DW-7 149 149 */ 150 150 struct utp_upiu_cmd {