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