mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-05 10:29:37 +00:00
![Kimberly Brown](/assets/img/avatar_default.png)
There are two methods for signaling the host: the monitor page mechanism and hypercalls. The monitor page mechanism is used by performance critical channels (storage, networking, etc.) because it provides improved throughput. However, latency is increased. Monitor pages are allocated to these channels. Monitor pages are not allocated to channels that do not use the monitor page mechanism. Therefore, these channels do not have a valid monitor id or valid monitor page data. In these cases, some of the "_show" functions return incorrect data. They return an invalid monitor id and data that is beyond the bounds of the hv_monitor_page array fields. The "channel->offermsg.monitor_allocated" value can be used to determine whether monitor pages have been allocated to a channel. Add "is_visible()" callback functions for the device-level and channel-level attribute groups. These functions will hide the monitor sysfs files when the monitor mechanism is not used. Remove ".default_attributes" from "vmbus_chan_attrs" and create a channel-level attribute group. These changes allow the new "is_visible()" callback function to be applied to the channel-level attributes. Call "sysfs_create_group()" in "vmbus_add_channel_kobj()" to create the channel's sysfs files. Add a new function, “vmbus_remove_channel_attr_group()”, and call it in "free_channel()" to remove the channel's sysfs files when the channel is closed. Signed-off-by: Kimberly Brown <kimbrownkd@gmail.com> Reviewed-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org> Reviewed-by: Michael Kelley <mikelley@microsoft.com> Signed-off-by: Sasha Levin <sashal@kernel.org>
187 lines
6.6 KiB
Text
187 lines
6.6 KiB
Text
What: /sys/bus/vmbus/devices/<UUID>/id
|
|
Date: Jul 2009
|
|
KernelVersion: 2.6.31
|
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
|
Description: The VMBus child_relid of the device's primary channel
|
|
Users: tools/hv/lsvmbus
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/class_id
|
|
Date: Jul 2009
|
|
KernelVersion: 2.6.31
|
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
|
Description: The VMBus interface type GUID of the device
|
|
Users: tools/hv/lsvmbus
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/device_id
|
|
Date: Jul 2009
|
|
KernelVersion: 2.6.31
|
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
|
Description: The VMBus interface instance GUID of the device
|
|
Users: tools/hv/lsvmbus
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channel_vp_mapping
|
|
Date: Jul 2015
|
|
KernelVersion: 4.2.0
|
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
|
Description: The mapping of which primary/sub channels are bound to which
|
|
Virtual Processors.
|
|
Format: <channel's child_relid:the bound cpu's number>
|
|
Users: tools/hv/lsvmbus
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/device
|
|
Date: Dec. 2015
|
|
KernelVersion: 4.5
|
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
|
Description: The 16 bit device ID of the device
|
|
Users: tools/hv/lsvmbus and user level RDMA libraries
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/vendor
|
|
Date: Dec. 2015
|
|
KernelVersion: 4.5
|
|
Contact: K. Y. Srinivasan <kys@microsoft.com>
|
|
Description: The 16 bit vendor ID of the device
|
|
Users: tools/hv/lsvmbus and user level RDMA libraries
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/numa_node
|
|
Date: Jul 2018
|
|
KernelVersion: 4.19
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: This NUMA node to which the VMBUS device is
|
|
attached, or -1 if the node is unknown.
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Directory for per-channel information
|
|
NN is the VMBUS relid associtated with the channel.
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/cpu
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: VCPU (sub)channel is affinitized to
|
|
Users: tools/hv/lsvmbus and other debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/cpu
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: VCPU (sub)channel is affinitized to
|
|
Users: tools/hv/lsvmbus and other debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/in_mask
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Host to guest channel interrupt mask
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/latency
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Channel signaling latency. This file is available only for
|
|
performance critical channels (storage, network, etc.) that use
|
|
the monitor page mechanism.
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_mask
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Guest to host channel interrupt mask
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/pending
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Channel interrupt pending state. This file is available only for
|
|
performance critical channels (storage, network, etc.) that use
|
|
the monitor page mechanism.
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/read_avail
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Bytes available to read
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/write_avail
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Bytes available to write
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/events
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Number of times we have signaled the host
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/interrupts
|
|
Date: September. 2017
|
|
KernelVersion: 4.14
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Number of times we have taken an interrupt (incoming)
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/subchannel_id
|
|
Date: January. 2018
|
|
KernelVersion: 4.16
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Subchannel ID associated with VMBUS channel
|
|
Users: Debugging tools and userspace drivers
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/monitor_id
|
|
Date: January. 2018
|
|
KernelVersion: 4.16
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Monitor bit associated with channel. This file is available only
|
|
for performance critical channels (storage, network, etc.) that
|
|
use the monitor page mechanism.
|
|
Users: Debugging tools and userspace drivers
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/ring
|
|
Date: January. 2018
|
|
KernelVersion: 4.16
|
|
Contact: Stephen Hemminger <sthemmin@microsoft.com>
|
|
Description: Binary file created by uio_hv_generic for ring buffer
|
|
Users: Userspace drivers
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_in_full
|
|
Date: February 2019
|
|
KernelVersion: 5.0
|
|
Contact: Michael Kelley <mikelley@microsoft.com>
|
|
Description: Number of guest to host interrupts caused by the inbound ring
|
|
buffer transitioning from full to not full while a packet is
|
|
waiting for buffer space to become available
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/intr_out_empty
|
|
Date: February 2019
|
|
KernelVersion: 5.0
|
|
Contact: Michael Kelley <mikelley@microsoft.com>
|
|
Description: Number of guest to host interrupts caused by the outbound ring
|
|
buffer transitioning from empty to not empty
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_first
|
|
Date: February 2019
|
|
KernelVersion: 5.0
|
|
Contact: Michael Kelley <mikelley@microsoft.com>
|
|
Description: Number of write operations that were the first to encounter an
|
|
outbound ring buffer full condition
|
|
Users: Debugging tools
|
|
|
|
What: /sys/bus/vmbus/devices/<UUID>/channels/<N>/out_full_total
|
|
Date: February 2019
|
|
KernelVersion: 5.0
|
|
Contact: Michael Kelley <mikelley@microsoft.com>
|
|
Description: Total number of write operations that encountered an outbound
|
|
ring buffer full condition
|
|
Users: Debugging tools
|