Skip to contentSkip to conversation

Update documentation of sysfs nodes for appid

PATCH Applied Muneendra Kumar 3 participants 4 messages Sep 13, 2021 – Sep 22, 2021 SCSI

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Update documentation of sysfs nodes for appid

From: Muneendra <[email protected]>

Update documentation for sysfs node within
/sys/class/fc/fc_udev_device/

---
 Documentation/ABI/testing/sysfs-class-fc | 27 ++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 Documentation/ABI/testing/sysfs-class-fc
Documentation/ABI/testing/sysfs-class-fc new file +27 -0
new file mode 100644
index 000000000000..3057a6d3b8cf
@@ -0,0 +1,27 @@
+What:		/sys/class/fc/fc_udev_device/appid_store
+Date:		Aug 2021
+Contact:	Muneendra Kumar <[email protected]>
+Description:
+		This interface allows an admin to set an FC application
+		identifier in the blkcg associated with a cgroup id. The
+		identifier is typically a UUID that is associated with
+		an application or logical entity such as a virtual
+		machine or container group. The application or logical
+		entity utilizes a block device via the cgroup id.
+		FC adapter drivers may query the identifier and tag FC
+		traffic based on the identifier. FC host and FC fabric
+		entities can utilize the application id and FC traffic
+		tag to identify traffic sources.
+
+		The interface expects a string "<cgroupid>:<appid>" where:
+		<cgroupid> is inode of the cgroup in hexadecimal
+		<appid> is user provided string upto 128 characters
+		in length.
+
+		If an appid_store is done for a cgroup id that already
+		has an appid set, the new value will override the
+		previous value.
+
+		If an admin wants to remove an FC application identifier
+		from a cgroup, an appid_store should be done with the
+		following string: "<cgroupid>:"
Signature · 1 line
2.26.2
Reviewed-by on v1 1/1
#1 lore raw
Quoted 51 lines · Muneendra Kumar

From: Muneendra <[email protected]>

Update documentation for sysfs node within
/sys/class/fc/fc_udev_device/

---
Documentation/ABI/testing/sysfs-class-fc | 27 ++++++++++++++++++++++++

1 file changed, 27 insertions(+)

create mode 100644 Documentation/ABI/testing/sysfs-class-fc

Documentation/ABI/testing/sysfs-class-fc new file +27 -0
new file mode 100644
index 000000000000..3057a6d3b8cf
@@ -0,0 +1,27 @@
+What:		/sys/class/fc/fc_udev_device/appid_store
+Date:		Aug 2021
+Contact:	Muneendra Kumar <[email protected]>
+Description:
+		This interface allows an admin to set an FC application
+		identifier in the blkcg associated with a cgroup id. The
+		identifier is typically a UUID that is associated with
+		an application or logical entity such as a virtual
+		machine or container group. The application or logical
+		entity utilizes a block device via the cgroup id.
+		FC adapter drivers may query the identifier and tag FC
+		traffic based on the identifier. FC host and FC fabric
+		entities can utilize the application id and FC traffic
+		tag to identify traffic sources.
+
+		The interface expects a string "<cgroupid>:<appid>" where:
+		<cgroupid> is inode of the cgroup in hexadecimal
+		<appid> is user provided string upto 128 characters
+		in length.
+
+		If an appid_store is done for a cgroup id that already
+		has an appid set, the new value will override the
+		previous value.
+
+		If an admin wants to remove an FC application identifier
+		from a cgroup, an appid_store should be done with the
+		following string: "<cgroupid>:"
Signature · 1 line
2.26.2

Looks Good.

--
Himanshu Madhani Oracle Linux Engineering

#2 lore raw
In reply to Muneendra Kumar

Muneendra,

Quoted 2 lines

Update documentation for sysfs node within
/sys/class/fc/fc_udev_device/

Applied to 5.16/scsi-staging, thanks!

Signature · 1 line
Martin K. Petersen	Oracle Linux Engineering