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