xref: /linux/Documentation/ABI/testing/sysfs-class-fc (revision 03ab8e6297acd1bc0eedaa050e2a1635c576fd11)
1 What:		/sys/class/fc/fc_udev_device/appid_store
2 Date:		Aug 2021
3 Contact:	Muneendra Kumar <muneendra.kumar@broadconm.com>
4 Description:
5 		This interface allows an admin to set an FC application
6 		identifier in the blkcg associated with a cgroup id. The
7 		identifier is typically a UUID that is associated with
8 		an application or logical entity such as a virtual
9 		machine or container group. The application or logical
10 		entity utilizes a block device via the cgroup id.
11 		FC adapter drivers may query the identifier and tag FC
12 		traffic based on the identifier. FC host and FC fabric
13 		entities can utilize the application id and FC traffic
14 		tag to identify traffic sources.
15 
16 		The interface expects a string "<cgroupid>:<appid>" where:
17 		<cgroupid> is inode of the cgroup in hexadecimal
18 		<appid> is user provided string upto 128 characters
19 		in length.
20 
21 		If an appid_store is done for a cgroup id that already
22 		has an appid set, the new value will override the
23 		previous value.
24 
25 		If an admin wants to remove an FC application identifier
26 		from a cgroup, an appid_store should be done with the
27 		following string: "<cgroupid>:"
28