0001 What: /sys/bus/vmbus/hibernation
0002 Date: Jan 2021
0003 KernelVersion: 5.12
0004 Contact: Dexuan Cui <decui@microsoft.com>
0005 Description: Whether the host supports hibernation for the VM.
0006 Users: Daemon that sets up swap partition/file for hibernation.
0007
0008 What: /sys/bus/vmbus/devices/<UUID>/id
0009 Date: Jul 2009
0010 KernelVersion: 2.6.31
0011 Contact: K. Y. Srinivasan <kys@microsoft.com>
0012 Description: The VMBus child_relid of the device's primary channel
0013 Users: tools/hv/lsvmbus
0014
0015 What: /sys/bus/vmbus/devices/<UUID>/class_id
0016 Date: Jul 2009
0017 KernelVersion: 2.6.31
0018 Contact: K. Y. Srinivasan <kys@microsoft.com>
0019 Description: The VMBus interface type GUID of the device
0020 Users: tools/hv/lsvmbus
0021
0022 What: /sys/bus/vmbus/devices/<UUID>/device_id
0023 Date: Jul 2009
0024 KernelVersion: 2.6.31
0025 Contact: K. Y. Srinivasan <kys@microsoft.com>
0026 Description: The VMBus interface instance GUID of the device
0027 Users: tools/hv/lsvmbus
0028
0029 What: /sys/bus/vmbus/devices/<UUID>/channel_vp_mapping
0030 Date: Jul 2015
0031 KernelVersion: 4.2.0
0032 Contact: K. Y. Srinivasan <kys@microsoft.com>
0033 Description: The mapping of which primary/sub channels are bound to which
0034 Virtual Processors.
0035 Format: <channel's child_relid:the bound cpu's number>
0036 Users: tools/hv/lsvmbus
0037
0038 What: /sys/bus/vmbus/devices/<UUID>/device
0039 Date: Dec. 2015
0040 KernelVersion: 4.5
0041 Contact: K. Y. Srinivasan <kys@microsoft.com>
0042 Description: The 16 bit device ID of the device
0043 Users: tools/hv/lsvmbus and user level RDMA libraries
0044
0045 What: /sys/bus/vmbus/devices/<UUID>/vendor
0046 Date: Dec. 2015
0047 KernelVersion: 4.5
0048 Contact: K. Y. Srinivasan <kys@microsoft.com>
0049 Description: The 16 bit vendor ID of the device
0050 Users: tools/hv/lsvmbus and user level RDMA libraries
0051
0052 What: /sys/bus/vmbus/devices/<UUID>/numa_node
0053 Date: Jul 2018
0054 KernelVersion: 4.19
0055 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0056 Description: This NUMA node to which the VMBUS device is
0057 attached, or -1 if the node is unknown.
0058
0059 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>
0060 Date: September. 2017
0061 KernelVersion: 4.14
0062 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0063 Description: Directory for per-channel information
0064 NN is the VMBUS relid associated with the channel.
0065
0066 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/cpu
0067 Date: September. 2017
0068 KernelVersion: 4.14
0069 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0070 Description: VCPU (sub)channel is affinitized to
0071 Users: tools/hv/lsvmbus and other debugging tools
0072
0073 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/in_mask
0074 Date: September. 2017
0075 KernelVersion: 4.14
0076 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0077 Description: Host to guest channel interrupt mask
0078 Users: Debugging tools
0079
0080 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/latency
0081 Date: September. 2017
0082 KernelVersion: 4.14
0083 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0084 Description: Channel signaling latency. This file is available only for
0085 performance critical channels (storage, network, etc.) that use
0086 the monitor page mechanism.
0087 Users: Debugging tools
0088
0089 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_mask
0090 Date: September. 2017
0091 KernelVersion: 4.14
0092 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0093 Description: Guest to host channel interrupt mask
0094 Users: Debugging tools
0095
0096 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/pending
0097 Date: September. 2017
0098 KernelVersion: 4.14
0099 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0100 Description: Channel interrupt pending state. This file is available only for
0101 performance critical channels (storage, network, etc.) that use
0102 the monitor page mechanism.
0103 Users: Debugging tools
0104
0105 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/read_avail
0106 Date: September. 2017
0107 KernelVersion: 4.14
0108 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0109 Description: Bytes available to read
0110 Users: Debugging tools
0111
0112 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/write_avail
0113 Date: September. 2017
0114 KernelVersion: 4.14
0115 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0116 Description: Bytes available to write
0117 Users: Debugging tools
0118
0119 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/events
0120 Date: September. 2017
0121 KernelVersion: 4.14
0122 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0123 Description: Number of times we have signaled the host
0124 Users: Debugging tools
0125
0126 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/interrupts
0127 Date: September. 2017
0128 KernelVersion: 4.14
0129 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0130 Description: Number of times we have taken an interrupt (incoming)
0131 Users: Debugging tools
0132
0133 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/subchannel_id
0134 Date: January. 2018
0135 KernelVersion: 4.16
0136 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0137 Description: Subchannel ID associated with VMBUS channel
0138 Users: Debugging tools and userspace drivers
0139
0140 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/monitor_id
0141 Date: January. 2018
0142 KernelVersion: 4.16
0143 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0144 Description: Monitor bit associated with channel. This file is available only
0145 for performance critical channels (storage, network, etc.) that
0146 use the monitor page mechanism.
0147 Users: Debugging tools and userspace drivers
0148
0149 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/ring
0150 Date: January. 2018
0151 KernelVersion: 4.16
0152 Contact: Stephen Hemminger <sthemmin@microsoft.com>
0153 Description: Binary file created by uio_hv_generic for ring buffer
0154 Users: Userspace drivers
0155
0156 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_in_full
0157 Date: February 2019
0158 KernelVersion: 5.0
0159 Contact: Michael Kelley <mikelley@microsoft.com>
0160 Description: Number of guest to host interrupts caused by the inbound ring
0161 buffer transitioning from full to not full while a packet is
0162 waiting for buffer space to become available
0163 Users: Debugging tools
0164
0165 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_out_empty
0166 Date: February 2019
0167 KernelVersion: 5.0
0168 Contact: Michael Kelley <mikelley@microsoft.com>
0169 Description: Number of guest to host interrupts caused by the outbound ring
0170 buffer transitioning from empty to not empty
0171 Users: Debugging tools
0172
0173 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_first
0174 Date: February 2019
0175 KernelVersion: 5.0
0176 Contact: Michael Kelley <mikelley@microsoft.com>
0177 Description: Number of write operations that were the first to encounter an
0178 outbound ring buffer full condition
0179 Users: Debugging tools
0180
0181 What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_total
0182 Date: February 2019
0183 KernelVersion: 5.0
0184 Contact: Michael Kelley <mikelley@microsoft.com>
0185 Description: Total number of write operations that encountered an outbound
0186 ring buffer full condition
0187 Users: Debugging tools
