xref: /linux/Documentation/ABI/stable/sysfs-bus-vmbus (revision ec8a42e7343234802b9054874fe01810880289ce)
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>/in_mask
67Date:		September. 2017
68KernelVersion:	4.14
69Contact:	Stephen Hemminger <sthemmin@microsoft.com>
70Description:	Host to guest channel interrupt mask
71Users:		Debugging tools
72
73What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/latency
74Date:		September. 2017
75KernelVersion:	4.14
76Contact:	Stephen Hemminger <sthemmin@microsoft.com>
77Description:	Channel signaling latency. This file is available only for
78		performance critical channels (storage, network, etc.) that use
79		the monitor page mechanism.
80Users:		Debugging tools
81
82What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/out_mask
83Date:		September. 2017
84KernelVersion:	4.14
85Contact:	Stephen Hemminger <sthemmin@microsoft.com>
86Description:	Guest to host channel interrupt mask
87Users:		Debugging tools
88
89What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/pending
90Date:		September. 2017
91KernelVersion:	4.14
92Contact:	Stephen Hemminger <sthemmin@microsoft.com>
93Description:	Channel interrupt pending state. This file is available only for
94		performance critical channels (storage, network, etc.) that use
95		the monitor page mechanism.
96Users:		Debugging tools
97
98What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/read_avail
99Date:		September. 2017
100KernelVersion:	4.14
101Contact:	Stephen Hemminger <sthemmin@microsoft.com>
102Description:	Bytes available to read
103Users:		Debugging tools
104
105What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/write_avail
106Date:		September. 2017
107KernelVersion:	4.14
108Contact:	Stephen Hemminger <sthemmin@microsoft.com>
109Description:	Bytes available to write
110Users:		Debugging tools
111
112What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/events
113Date:		September. 2017
114KernelVersion:	4.14
115Contact:	Stephen Hemminger <sthemmin@microsoft.com>
116Description:	Number of times we have signaled the host
117Users:		Debugging tools
118
119What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/interrupts
120Date:		September. 2017
121KernelVersion:	4.14
122Contact:	Stephen Hemminger <sthemmin@microsoft.com>
123Description:	Number of times we have taken an interrupt (incoming)
124Users:		Debugging tools
125
126What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/subchannel_id
127Date:		January. 2018
128KernelVersion:	4.16
129Contact:	Stephen Hemminger <sthemmin@microsoft.com>
130Description:	Subchannel ID associated with VMBUS channel
131Users:		Debugging tools and userspace drivers
132
133What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/monitor_id
134Date:		January. 2018
135KernelVersion:	4.16
136Contact:	Stephen Hemminger <sthemmin@microsoft.com>
137Description:	Monitor bit associated with channel. This file is available only
138		for performance critical channels (storage, network, etc.) that
139		use the monitor page mechanism.
140Users:		Debugging tools and userspace drivers
141
142What:		/sys/bus/vmbus/devices/<UUID>/channels/<N>/ring
143Date:		January. 2018
144KernelVersion:	4.16
145Contact:	Stephen Hemminger <sthemmin@microsoft.com>
146Description:	Binary file created by uio_hv_generic for ring buffer
147Users:		Userspace drivers
148
149What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_in_full
150Date:           February 2019
151KernelVersion:  5.0
152Contact:        Michael Kelley <mikelley@microsoft.com>
153Description:    Number of guest to host interrupts caused by the inbound ring
154		buffer transitioning from full to not full while a packet is
155		waiting for buffer space to become available
156Users:          Debugging tools
157
158What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_out_empty
159Date:           February 2019
160KernelVersion:  5.0
161Contact:        Michael Kelley <mikelley@microsoft.com>
162Description:    Number of guest to host interrupts caused by the outbound ring
163		buffer transitioning from empty to not empty
164Users:          Debugging tools
165
166What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_first
167Date:           February 2019
168KernelVersion:  5.0
169Contact:        Michael Kelley <mikelley@microsoft.com>
170Description:    Number of write operations that were the first to encounter an
171		outbound ring buffer full condition
172Users:          Debugging tools
173
174What:           /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_total
175Date:           February 2019
176KernelVersion:  5.0
177Contact:        Michael Kelley <mikelley@microsoft.com>
178Description:    Total number of write operations that encountered an outbound
179		ring buffer full condition
180Users:          Debugging tools
181