Linux 6.7-rc7
[linux-modified.git] / Documentation / ABI / testing / sysfs-class-fc
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>:"