xref: /linux/Documentation/ABI/testing/sysfs-class-fc (revision a4eb44a6435d6d8f9e642407a4a06f65eb90ca04)
1What:		/sys/class/fc/fc_udev_device/appid_store
2Date:		Aug 2021
3Contact:	Muneendra Kumar <muneendra.kumar@broadconm.com>
4Description:
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