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