scsi: ufs: sysfs: Print string descriptors as raw data
PATCH v2 1/1 scsi: ufs: sysfs: Print string descriptors as raw data
Currently the string descriptors sysfs entries are printing in ascii format. According to Jedec UFS spec the string descriptors data is Unicode and need-not be ascii convertible. Therefore in case the device string descriptor contains non ascii convertible characters, it will produce a wrong output. In order to fix this issue, the new string descriptors entries will added to sysfs directory. Those entries will show the string descriptors in raw format
--- Documentation/ABI/testing/sysfs-driver-ufs | 44 ++++++++++++++++++++++++++++++ drivers/scsi/ufs/ufs-sysfs.c | 34 +++++++++++++++++------ 2 files changed, 70 insertions(+), 8 deletions(-)
Documentation/ABI/testing/sysfs-driver-ufs +44 -0
@@ -561,6 +561,50 @@ Description: This file contains a product revision string. The full The file is read only. +What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/manufacturer_name_raw +Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a device manufactureer name string + as raw data. The full information about the descriptor + could be found at UFS specifications 2.1. + + The file is read only. + +What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name_raw +Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a product name string as raw data. + The full information about the descriptor could be found at + UFS specifications 2.1. + + The file is read only. + +What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id_raw +Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a OEM ID string as raw data. + The full information about the descriptor could be found at + UFS specifications 2.1. + + The file is read only. + +What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number_raw +Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a device serial number string + as raw data. The full information about the descriptor could be + found at UFS specifications 2.1. + + The file is read only. + +What: /sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision_raw +Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a product revision string as raw data. + The full information about the descriptor could be found at + UFS specifications 2.1. + + The file is read only. What: /sys/class/scsi_device/*/device/unit_descriptor/boot_lun_id Date: February 2018
drivers/scsi/ufs/ufs-sysfs.c +26 -8
@@ -658,7 +658,7 @@ static const struct attribute_group ufs_sysfs_power_descriptor_group = { .attrs = ufs_sysfs_power_descriptor, }; -#define UFS_STRING_DESCRIPTOR (_name, _pname) \ +#define UFS_STRING_DESCRIPTOR (_name, _pname, _is_ascii) \ static ssize_t _name##_show(struct device *dev, \ struct device_attribute *attr, char *buf) \ { \
@@ -690,10 +690,18 @@ static ssize_t _name##_show(struct device *dev, \kfree (desc_buf); \ desc_buf =NULL ; \ ret =ufshcd_read_string_desc (hba, index, &desc_buf, \ -SD_ASCII_STD ); \ + _is_ascii); \if (ret <0 ) \ goto out; \ - ret =sysfs_emit (buf,"%s\n" , desc_buf); \ +if (_is_ascii) { \ + ret =sysfs_emit (buf,"%s\n" , desc_buf); \ + }else { \ +int i; \ + \ +for (i =0 ; i < desc_buf[0 ]; i++) \ +hex_byte_pack (buf + i *2 , desc_buf[i]); \ + ret =sysfs_emit (buf,"%s\n" , buf); \ + } \ out: \pm_runtime_put_sync (hba->dev); \kfree (desc_buf); \
@@ -702,11 +710,16 @@ out: \ } \ static DEVICE_ATTR_RO(_name) -UFS_STRING_DESCRIPTOR (manufacturer_name, _MANF_NAME); -UFS_STRING_DESCRIPTOR (product_name, _PRDCT_NAME); -UFS_STRING_DESCRIPTOR (oem_id, _OEM_ID); -UFS_STRING_DESCRIPTOR (serial_number, _SN); -UFS_STRING_DESCRIPTOR (product_revision, _PRDCT_REV); +UFS_STRING_DESCRIPTOR(manufacturer_name, _MANF_NAME, 1); +UFS_STRING_DESCRIPTOR(product_name, _PRDCT_NAME, 1); +UFS_STRING_DESCRIPTOR(oem_id, _OEM_ID, 1); +UFS_STRING_DESCRIPTOR(serial_number, _SN, 1); +UFS_STRING_DESCRIPTOR(product_revision, _PRDCT_REV, 1); +UFS_STRING_DESCRIPTOR(manufacturer_name_raw, _MANF_NAME, 0); +UFS_STRING_DESCRIPTOR(product_name_raw, _PRDCT_NAME, 0); +UFS_STRING_DESCRIPTOR(oem_id_raw, _OEM_ID, 0); +UFS_STRING_DESCRIPTOR(serial_number_raw, _SN, 0); +UFS_STRING_DESCRIPTOR(product_revision_raw, _PRDCT_REV, 0); static struct attribute *ufs_sysfs_string_descriptors[] = { &dev_attr_manufacturer_name.attr,
@@ -714,6 +727,11 @@ static struct attribute *ufs_sysfs_string_descriptors[] = { &dev_attr_oem_id.attr, &dev_attr_serial_number.attr, &dev_attr_product_revision.attr, + &dev_attr_manufacturer_name_raw.attr, + &dev_attr_product_name_raw.attr, + &dev_attr_oem_id_raw.attr, + &dev_attr_serial_number_raw.attr, + &dev_attr_product_revision_raw.attr, NULL, };
Signature · 1 line
2.7.4
Hi Martin
Could you please consider to take this patch?
Regards
Arthur
Quoted 171 lines
-----Original Message-----
From: Arthur Simchaev <[email protected]>
Sent: Monday, February 15, 2021 7:41 PM
To: James E . J . Bottomley <[email protected]>; Martin K . Petersen <[email protected]>; [email protected]; linux- [email protected]
Cc: [email protected]; Bean Huo <[email protected]>; Arthur Simchaev <[email protected]>
Subject: [PATCH v2] scsi: ufs: sysfs: Print string descriptors as raw dataCurrently the string descriptors sysfs entries are printing in ascii format. According to Jedec UFS spec the string descriptors data is Unicode and need-not be ascii convertible. Therefore in case the device string descriptor contains non ascii convertible characters, it will produce a wrong output. In order to fix this issue, the new string descriptors entries will added to sysfs directory. Those entries will show the string descriptors in raw format
Signed-off-by Arthur Simchaev <[email protected]>--- Documentation/ABI/testing/sysfs-driver-ufs | 44 ++++++++++++++++++++++++++++++ drivers/scsi/ufs/ufs-sysfs.c | 34 +++++++++++++++++------ 2 files changed, 70 insertions(+), 8 deletions(-)Documentation/ABI/testing/sysfs-driver-ufs +0
-0@@ -561,6 +561,50 @@ Description: This file contains a product revisionstring. The full
Documentation/ABI/testing/sysfs-driver-ufs +1
-0The file is read only. +What:
/sys/bus/platform/drivers/ufshcd/*/string_descriptors/manufacturer_name_rawDocumentation/ABI/testing/sysfs-driver-ufs +9
-0+Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a device manufactureer name string + as raw data. The full information about the descriptor + could be found at UFS specifications 2.1. + + The file is read only. + +What:
/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_name_rawDocumentation/ABI/testing/sysfs-driver-ufs +9
-0+Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a product name string as raw data. + The full information about the descriptor could be found at + UFS specifications 2.1. + + The file is read only. + +What:
/sys/bus/platform/drivers/ufshcd/*/string_descriptors/oem_id_rawDocumentation/ABI/testing/sysfs-driver-ufs +9
-0+Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a OEM ID string as raw data. + The full information about the descriptor could be found at + UFS specifications 2.1. + + The file is read only. + +What:
/sys/bus/platform/drivers/ufshcd/*/string_descriptors/serial_number_rawDocumentation/ABI/testing/sysfs-driver-ufs +4
-0+Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a device serial number string + as raw data. The full information about the descriptor couldbe
Documentation/ABI/testing/sysfs-driver-ufs +5
-0+ found at UFS specifications 2.1. + + The file is read only. + +What:
/sys/bus/platform/drivers/ufshcd/*/string_descriptors/product_revision_rawDocumentation/ABI/testing/sysfs-driver-ufs +7
-0+Date: February 2021 +Contact: Arthur Simchaev <[email protected]> +Description: This file contains a product revision string as raw data. + The full information about the descriptor could be found at + UFS specifications 2.1. + + The file is read only. What:
/sys/class/scsi_device/*/device/unit_descriptor/boot_lun_id
Date: February 2018drivers/scsi/ufs/ufs-sysfs.c +1
-1@@ -658,7 +658,7 @@ static const struct attribute_group ufs_sysfs_power_descriptor_group = { .attrs = ufs_sysfs_power_descriptor, }; -#define UFS_STRING_DESCRIPTOR (_name, _pname) \ +#define UFS_STRING_DESCRIPTOR (_name, _pname, _is_ascii) \static
ssize_t_name##_show(struct device *dev,\drivers/scsi/ufs/ufs-sysfs.c +10
-2struct device_attribute *attr, char *buf) \ { \@@ -690,10 +690,18 @@ static ssize_t _name##_show(struct device *dev, \kfree (desc_buf); \ desc_buf =NULL ; \ ret =ufshcd_read_string_desc (hba, index, &desc_buf, \ -SD_ASCII_STD ); \ + _is_ascii); \if (ret <0 ) \ goto out; \ - ret =sysfs_emit (buf,"%s\n" , desc_buf); \ +if (_is_ascii) { \ + ret =sysfs_emit (buf,"%s\n" , desc_buf); \ + }else { \ +int i; \ + \ +for (i =0 ; i < desc_buf[0 ]; i++) \ +hex_byte_pack (buf + i *2 , desc_buf[i]); \ + ret =sysfs_emit (buf,"%s\n" , buf); \ + } \ out: \pm_runtime_put_sync (hba->dev);\drivers/scsi/ufs/ufs-sysfs.c +10
-5kfree (desc_buf); \@@ -702,11 +710,16 @@ out: \ } \ static DEVICE_ATTR_RO(_name) -UFS_STRING_DESCRIPTOR (manufacturer_name, _MANF_NAME); -UFS_STRING_DESCRIPTOR (product_name, _PRDCT_NAME); -UFS_STRING_DESCRIPTOR (oem_id, _OEM_ID); -UFS_STRING_DESCRIPTOR (serial_number, _SN); -UFS_STRING_DESCRIPTOR (product_revision, _PRDCT_REV); +UFS_STRING_DESCRIPTOR(manufacturer_name, _MANF_NAME, 1); +UFS_STRING_DESCRIPTOR(product_name, _PRDCT_NAME, 1); +UFS_STRING_DESCRIPTOR(oem_id, _OEM_ID, 1); +UFS_STRING_DESCRIPTOR(serial_number, _SN, 1); +UFS_STRING_DESCRIPTOR(product_revision, _PRDCT_REV, 1); +UFS_STRING_DESCRIPTOR(manufacturer_name_raw, _MANF_NAME, 0); +UFS_STRING_DESCRIPTOR(product_name_raw, _PRDCT_NAME, 0); +UFS_STRING_DESCRIPTOR(oem_id_raw, _OEM_ID, 0); +UFS_STRING_DESCRIPTOR(serial_number_raw, _SN, 0); +UFS_STRING_DESCRIPTOR(product_revision_raw, _PRDCT_REV, 0); static struct attribute *ufs_sysfs_string_descriptors[] = {drivers/scsi/ufs/ufs-sysfs.c +5
-1&dev_attr_manufacturer_name.attr,@@ -714,6 +727,11 @@ static struct attribute *ufs_sysfs_string_descriptors[] = { &dev_attr_oem_id.attr, &dev_attr_serial_number.attr, &dev_attr_product_revision.attr, + &dev_attr_manufacturer_name_raw.attr, + &dev_attr_product_name_raw.attr, + &dev_attr_oem_id_raw.attr, + &dev_attr_serial_number_raw.attr, + &dev_attr_product_revision_raw.attr, NULL, }; --2.7.4
Hi Arthur!
Quoted 1 line
Could you please consider to take this patch?
The patch needs some reviews. I suggest you repost.
Signature · 1 line
Martin K. Petersen Oracle Linux Engineering
Quoted 16 lines · Arthur Simchaev
drivers/scsi/ufs/ufs-sysfs.c +4
-3-#define UFS_STRING_DESCRIPTOR (_name, _pname) \ +#define UFS_STRING_DESCRIPTOR (_name, _pname, _is_ascii) \ static ssize_t _name##_show(struct device *dev, \ struct device_attribute *attr, char *buf) \ { \@@ -690,10 +690,18 @@ static ssize_t _name##_show(struct device *dev, \kfree (desc_buf); \ desc_buf =NULL ; \ ret =ufshcd_read_string_desc (hba, index, &desc_buf, \ -SD_ASCII_STD ); \ + _is_ascii); \if (ret <0 ) \ goto out; \ - ret =sysfs_emit (buf,"%s\n" , desc_buf); \ +if (_is_ascii) { \ + ret =sysfs_emit (buf,"%s\n" , desc_buf); \
drivers/scsi/ufs/ufs-sysfs.c static ssize_t _name##_show(struct device *dev, \ · line 707
Quoted 10 lines
drivers/scsi/ufs/ufs-sysfs.c +7
-0+ }else { \ +int i; \ + \ +for (i =0 ; i < desc_buf[0 ]; i++) \ +hex_byte_pack (buf + i *2 , desc_buf[i]); \ + ret =sysfs_emit (buf,"%s\n" , buf); \ + } \ out: \pm_runtime_put_sync (hba->dev); \kfree (desc_buf); \
Hex data needs to be parsed before it can be used by any software. Has it been considered to make the "raw" attributes binary attributes instead of hex-encoded binary? See also sysfs_create_bin_file().
Thanks,
Bart.
Quoted 45 lines
-----Original Message-----
From: Bart Van Assche <[email protected]>
Sent: Wednesday, March 17, 2021 5:31 AM
To: Arthur Simchaev <[email protected]>; James E . J . Bottomley <[email protected]>; Martin K . Petersen <[email protected]>; [email protected]; linux- [email protected]
Cc: [email protected]; Bean Huo <[email protected]>
Subject: Re: [PATCH v2] scsi: ufs: sysfs: Print string descriptors as raw dataCAUTION: This email originated from outside of Western Digital. Do not click on links or open attachments unless you recognize the sender and know that the content is safe.
drivers/scsi/ufs/ufs-sysfs.c static ssize_t _name##_show(struct device *dev,
Quoted 6 lines · Arthur Simchaev
drivers/scsi/ufs/ufs-sysfs.c +1
-1-#define UFS_STRING_DESCRIPTOR (_name, _pname) \ +#define UFS_STRING_DESCRIPTOR (_name, _pname, _is_ascii) \ static ssize_t _name##_show(struct device *dev, \ struct device_attribute *attr, char *buf) \ { \@@ -690,10 +690,18 @@ static ssize_t _name##_show(struct device *dev,\
Quoted 10 lines
drivers/scsi/ufs/ufs-sysfs.c +3
-2kfree (desc_buf); \ desc_buf =NULL ; \ ret =ufshcd_read_string_desc (hba, index, &desc_buf, \ -SD_ASCII_STD ); \ + _is_ascii); \if (ret <0 ) \ goto out; \ - ret =sysfs_emit (buf,"%s\n" , desc_buf); \ +if (_is_ascii) { \ + ret =sysfs_emit (buf,"%s\n" , desc_buf); \drivers/scsi/ufs/ufs-sysfs.c static ssize_t _name##_show(struct device *dev, \ · line 707
Quoted 10 lines
drivers/scsi/ufs/ufs-sysfs.c +7
-0+ }else { \ +int i; \ + \ +for (i =0 ; i < desc_buf[0 ]; i++) \ +hex_byte_pack (buf + i *2 , desc_buf[i]); \ + ret =sysfs_emit (buf,"%s\n" , buf); \ + } \ out: \pm_runtime_put_sync (hba->dev); \kfree (desc_buf); \
Quoted 7 lines
Hex data needs to be parsed before it can be used by any software. Has it been considered to make the "raw" attributes binary attributes instead of hex-encoded binary? See also
sysfs_create_bin_file().Thanks,
Bart.
Hi Bart,
Thank you for your comments.
The typical use case that originate this issue, is of some flash vendor's field engineer reading the serial part number. All other string descriptors are less of an issue.
The current Jedec spec allows the serial number may not be ascii convertible . For example:
- ufshcd_read_string_desc(bool asci = false): 00 1d 00 20 00 95 00 20 00 ec 00 84 00 5b 00 14
- ufshcd_read_string_desc(bool asci = true): " ] "
Therefore, upon reading the "raw" serial number, the user can verify the data integrity.
How about just applying this change to the serial number sysfs entry, and drop all others?
Regards
Arthur