1

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>
This commit is contained in:
Randy Dunlap 2024-04-23 22:53:16 -07:00 committed by Martin K. Petersen
parent 9cef74a9bc
commit de37677ef1

View File

@ -123,6 +123,7 @@ struct utp_upiu_query {
* @idn: a value that indicates the particular type of data B-1 * @idn: a value that indicates the particular type of data B-1
* @index: Index to further identify data B-2 * @index: Index to further identify data B-2
* @selector: Index to further identify data B-3 * @selector: Index to further identify data B-3
* @osf3: spec field B-4
* @osf4: spec field B-5 * @osf4: spec field B-5
* @osf5: spec field B 6,7 * @osf5: spec field B 6,7
* @osf6: spec field DW 8,9 * @osf6: spec field DW 8,9
@ -138,12 +139,13 @@ struct utp_upiu_query_v4_0 {
__be16 osf5; __be16 osf5;
__be32 osf6; __be32 osf6;
__be32 osf7; __be32 osf7;
/* private: */
__be32 reserved; __be32 reserved;
}; };
/** /**
* struct utp_upiu_cmd - Command UPIU structure * struct utp_upiu_cmd - Command UPIU structure
* @data_transfer_len: Data Transfer Length DW-3 * @exp_data_transfer_len: Data Transfer Length DW-3
* @cdb: Command Descriptor Block CDB DW-4 to DW-7 * @cdb: Command Descriptor Block CDB DW-4 to DW-7
*/ */
struct utp_upiu_cmd { struct utp_upiu_cmd {