Merge tag 'armsoc-dt' of git://git.kernel.org/pub/scm/linux/kernel/git/soc/soc
[sfrench/cifs-2.6.git] / Documentation / ABI / stable / sysfs-bus-vmbus
1 What:           /sys/bus/vmbus/devices/<UUID>/id
2 Date:           Jul 2009
3 KernelVersion:  2.6.31
4 Contact:        K. Y. Srinivasan <kys@microsoft.com>
5 Description:    The VMBus child_relid of the device's primary channel
6 Users:          tools/hv/lsvmbus
7
8 What:           /sys/bus/vmbus/devices/<UUID>/class_id
9 Date:           Jul 2009
10 KernelVersion:  2.6.31
11 Contact:        K. Y. Srinivasan <kys@microsoft.com>
12 Description:    The VMBus interface type GUID of the device
13 Users:          tools/hv/lsvmbus
14
15 What:           /sys/bus/vmbus/devices/<UUID>/device_id
16 Date:           Jul 2009
17 KernelVersion:  2.6.31
18 Contact:        K. Y. Srinivasan <kys@microsoft.com>
19 Description:    The VMBus interface instance GUID of the device
20 Users:          tools/hv/lsvmbus
21
22 What:           /sys/bus/vmbus/devices/<UUID>/channel_vp_mapping
23 Date:           Jul 2015
24 KernelVersion:  4.2.0
25 Contact:        K. Y. Srinivasan <kys@microsoft.com>
26 Description:    The mapping of which primary/sub channels are bound to which
27                 Virtual Processors.
28                 Format: <channel's child_relid:the bound cpu's number>
29 Users:          tools/hv/lsvmbus
30
31 What:           /sys/bus/vmbus/devices/<UUID>/device
32 Date:           Dec. 2015
33 KernelVersion:  4.5
34 Contact:        K. Y. Srinivasan <kys@microsoft.com>
35 Description:    The 16 bit device ID of the device
36 Users:          tools/hv/lsvmbus and user level RDMA libraries
37
38 What:           /sys/bus/vmbus/devices/<UUID>/vendor
39 Date:           Dec. 2015
40 KernelVersion:  4.5
41 Contact:        K. Y. Srinivasan <kys@microsoft.com>
42 Description:    The 16 bit vendor ID of the device
43 Users:          tools/hv/lsvmbus and user level RDMA libraries
44
45 What:           /sys/bus/vmbus/devices/<UUID>/numa_node
46 Date:           Jul 2018
47 KernelVersion:  4.19
48 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
49 Description:    This NUMA node to which the VMBUS device is
50                 attached, or -1 if the node is unknown.
51
52 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>
53 Date:           September. 2017
54 KernelVersion:  4.14
55 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
56 Description:    Directory for per-channel information
57                 NN is the VMBUS relid associtated with the channel.
58
59 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/cpu
60 Date:           September. 2017
61 KernelVersion:  4.14
62 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
63 Description:    VCPU (sub)channel is affinitized to
64 Users:          tools/hv/lsvmbus and other debugging tools
65
66 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/cpu
67 Date:           September. 2017
68 KernelVersion:  4.14
69 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
70 Description:    VCPU (sub)channel is affinitized to
71 Users:          tools/hv/lsvmbus and other debugging tools
72
73 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/in_mask
74 Date:           September. 2017
75 KernelVersion:  4.14
76 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
77 Description:    Host to guest channel interrupt mask
78 Users:          Debugging tools
79
80 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/latency
81 Date:           September. 2017
82 KernelVersion:  4.14
83 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
84 Description:    Channel signaling latency. This file is available only for
85                 performance critical channels (storage, network, etc.) that use
86                 the monitor page mechanism.
87 Users:          Debugging tools
88
89 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_mask
90 Date:           September. 2017
91 KernelVersion:  4.14
92 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
93 Description:    Guest to host channel interrupt mask
94 Users:          Debugging tools
95
96 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/pending
97 Date:           September. 2017
98 KernelVersion:  4.14
99 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
100 Description:    Channel interrupt pending state. This file is available only for
101                 performance critical channels (storage, network, etc.) that use
102                 the monitor page mechanism.
103 Users:          Debugging tools
104
105 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/read_avail
106 Date:           September. 2017
107 KernelVersion:  4.14
108 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
109 Description:    Bytes available to read
110 Users:          Debugging tools
111
112 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/write_avail
113 Date:           September. 2017
114 KernelVersion:  4.14
115 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
116 Description:    Bytes available to write
117 Users:          Debugging tools
118
119 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/events
120 Date:           September. 2017
121 KernelVersion:  4.14
122 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
123 Description:    Number of times we have signaled the host
124 Users:          Debugging tools
125
126 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/interrupts
127 Date:           September. 2017
128 KernelVersion:  4.14
129 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
130 Description:    Number of times we have taken an interrupt (incoming)
131 Users:          Debugging tools
132
133 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/subchannel_id
134 Date:           January. 2018
135 KernelVersion:  4.16
136 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
137 Description:    Subchannel ID associated with VMBUS channel
138 Users:          Debugging tools and userspace drivers
139
140 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/monitor_id
141 Date:           January. 2018
142 KernelVersion:  4.16
143 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
144 Description:    Monitor bit associated with channel. This file is available only
145                 for performance critical channels (storage, network, etc.) that
146                 use the monitor page mechanism.
147 Users:          Debugging tools and userspace drivers
148
149 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/ring
150 Date:           January. 2018
151 KernelVersion:  4.16
152 Contact:        Stephen Hemminger <sthemmin@microsoft.com>
153 Description:    Binary file created by uio_hv_generic for ring buffer
154 Users:          Userspace drivers
155
156 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_in_full
157 Date:           February 2019
158 KernelVersion:  5.0
159 Contact:        Michael Kelley <mikelley@microsoft.com>
160 Description:    Number of guest to host interrupts caused by the inbound ring
161                 buffer transitioning from full to not full while a packet is
162                 waiting for buffer space to become available
163 Users:          Debugging tools
164
165 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_out_empty
166 Date:           February 2019
167 KernelVersion:  5.0
168 Contact:        Michael Kelley <mikelley@microsoft.com>
169 Description:    Number of guest to host interrupts caused by the outbound ring
170                 buffer transitioning from empty to not empty
171 Users:          Debugging tools
172
173 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_first
174 Date:           February 2019
175 KernelVersion:  5.0
176 Contact:        Michael Kelley <mikelley@microsoft.com>
177 Description:    Number of write operations that were the first to encounter an
178                 outbound ring buffer full condition
179 Users:          Debugging tools
180
181 What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_total
182 Date:           February 2019
183 KernelVersion:  5.0
184 Contact:        Michael Kelley <mikelley@microsoft.com>
185 Description:    Total number of write operations that encountered an outbound
186                 ring buffer full condition
187 Users:          Debugging tools