archives/linux
1
0
Fork 0
mirror of https://github.com/torvalds/linux.git synced 2026-03-08 01:04:41 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

scsi: ufs: core: Improve the documentation of UFS data frames

Browse source 
In source code comments, use terminology that comes from the JEDEC UFS
standard. This makes it easier to compare the UFS driver code with the
JEDEC UFS standard. Add static_assert() statements that verify the size
of data structures defined in the UFS standard.

Signed-off-by: Bart Van Assche <bvanassche@acm.org>
Link: https://patch.msgid.link/20260106190017.2527978-1-bvanassche@acm.org
Signed-off-by: Martin K. Petersen <martin.petersen@oracle.com>
This commit is contained in:
Bart Van Assche 2026-01-06 12:00:17 -07:00 • committed by Martin K. Petersen
parent bf286f5558
commit 309b23a155
2 changed files with 12 additions and 10 deletions
Download patch file Download diff file Expand all files Collapse all files

17
include/uapi/scsi/scsi_bsg_ufs.h
View file

@ -94,16 +94,15 @@ struct utp_upiu_header {
};
/**
* struct utp_upiu_query - upiu request buffer structure for
* query request.
* @opcode: command to perform B-0
* @idn: a value that indicates the particular type of data B-1
* @index: Index to further identify data B-2
* @selector: Index to further identify data B-3
* struct utp_upiu_query - QUERY REQUEST UPIU structure.
* @opcode: query function to perform B-0
* @idn: descriptor or attribute identification number B-1
* @index: Index that further identifies which data to access B-2
* @selector: Index that further identifies which data to access B-3
* @reserved_osf: spec reserved field B-4,5
* @length: number of descriptor bytes to read/write B-6,7
* @value: Attribute value to be written DW-5
* @reserved: spec reserved DW-6,7
* @length: number of descriptor bytes to read or write B-6,7
* @value: if @opcode == UPIU_QUERY_OPCODE_WRITE_ATTR, the value to be written B-6,7
* @reserved: reserved for future use DW-6,7
*/
struct utp_upiu_query {
__u8 opcode;

5
include/ufs/ufs.h
View file

@ -21,6 +21,7 @@
* in this header file of the size of struct utp_upiu_header.
*/
static_assert(sizeof(struct utp_upiu_header) == 12);
static_assert(sizeof(struct utp_upiu_query) == 20);
#define GENERAL_UPIU_REQUEST_SIZE (sizeof(struct utp_upiu_req))
#define QUERY_DESC_MAX_SIZE 255
@ -561,7 +562,7 @@ enum ufs_dev_pwr_mode {
#define UFS_WB_BUF_REMAIN_PERCENT(val) ((val) / 10)
/**
* struct utp_cmd_rsp - Response UPIU structure
* struct utp_cmd_rsp - RESPONSE UPIU structure
* @residual_transfer_count: Residual transfer count DW-3
* @reserved: Reserved double words DW-4 to DW-7
* @sense_data_len: Sense data length DW-8 U16
@ -574,6 +575,8 @@ struct utp_cmd_rsp {
u8 sense_data[UFS_SENSE_SIZE];
};
static_assert(sizeof(struct utp_cmd_rsp) == 40);
/**
* struct utp_upiu_rsp - general upiu response structure
* @header: UPIU header structure DW-0 to DW-2