Commit e9d73bfa authored by Muneendra Kumar's avatar Muneendra Kumar Committed by Martin K. Petersen
Browse files

scsi: documentation: Document Fibre Channel sysfs node for appid 

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

Link: https://lore.kernel.org/r/20210913015853.2086512-1-muneendra.kumar@broadcom.com


Reviewed-by: default avatarHimanshu Madhani <himanshu.madhani@oracle.com>
Signed-off-by: default avatarMuneendra Kumar <muneendra.kumar@broadcom.com>
Signed-off-by: default avatarMartin K. Petersen <martin.petersen@oracle.com>
parent 0a5e20fc

Documentation/ABI/testing/sysfs-class-fc

0 → 100644
+27 −0
Original line number Diff line number Diff line 
What:		/sys/class/fc/fc_udev_device/appid_store

Date:		Aug 2021

Contact:	Muneendra Kumar <muneendra.kumar@broadconm.com>

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>:"