versions: Update cloud-hypervisor to release v0.14.1

Highlights for cloud-hypervisor version 0.14.0 include: 1) Structured
event monitoring; 2) MSHV improvements; 3) Improved aarch64 platform; 4)
Updated hotplug documentation; 6) PTY control for serial and
virtio-console; 7) Block device rate limiting; 8) Plan to deprecate the
support of "LinuxBoot" protocol and support PVH protocol only.

Highlights for cloud-hypervisor version 0.13.0 include: 1) Wider VFIO
device support; 2) Improve huge page support; 3) MACvTAP support; 4) VHD
disk image support; 5) Improved Virtio device threading; 6) Clean
shutdown support via synthetic power button.

Details can be found:
https://github.com/cloud-hypervisor/cloud-hypervisor/releases

Note: The client code of cloud-hypervisor's OpenAPI is automatically
generated by `openapi-generator` [1-2]. As the API changes do not
impact usages in Kata, no additional changes in kata's runtime are
needed to work with the latest version of cloud-hypervisor.

[1] https://github.com/OpenAPITools/openapi-generator
[2] https://github.com/kata-containers/kata-containers/blob/main/src/runtime/virtcontainers/pkg/cloud-hypervisor/README.md

Fixes: #1591

Signed-off-by: Bo Chen <chen.bo@intel.com>
(cherry picked from commit 84b62dc3b1)

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/README.md

@@ -36,6 +36,7 @@ Class | Method | HTTP request | Description
 *DefaultApi* | [**CreateVM**](docs/DefaultApi.md#createvm) | **Put** /vm.create | Create the cloud-hypervisor Virtual Machine (VM) instance. The instance is not booted, only created.
 *DefaultApi* | [**DeleteVM**](docs/DefaultApi.md#deletevm) | **Put** /vm.delete | Delete the cloud-hypervisor Virtual Machine (VM) instance.
 *DefaultApi* | [**PauseVM**](docs/DefaultApi.md#pausevm) | **Put** /vm.pause | Pause a previously booted VM instance.
+*DefaultApi* | [**PowerButtonVM**](docs/DefaultApi.md#powerbuttonvm) | **Put** /vm.power-button | Trigger a power button in the VM
 *DefaultApi* | [**RebootVM**](docs/DefaultApi.md#rebootvm) | **Put** /vm.reboot | Reboot the VM instance.
 *DefaultApi* | [**ResumeVM**](docs/DefaultApi.md#resumevm) | **Put** /vm.resume | Resume a previously paused VM instance.
 *DefaultApi* | [**ShutdownVM**](docs/DefaultApi.md#shutdownvm) | **Put** /vm.shutdown | Shut the VM instance down.
@@ -76,9 +77,11 @@ Class | Method | HTTP request | Description
  - [NumaDistance](docs/NumaDistance.md)
  - [PciDeviceInfo](docs/PciDeviceInfo.md)
  - [PmemConfig](docs/PmemConfig.md)
+ - [RateLimiterConfig](docs/RateLimiterConfig.md)
  - [RestoreConfig](docs/RestoreConfig.md)
  - [RngConfig](docs/RngConfig.md)
  - [SgxEpcConfig](docs/SgxEpcConfig.md)
+ - [TokenBucket](docs/TokenBucket.md)
  - [VmAddDevice](docs/VmAddDevice.md)
  - [VmConfig](docs/VmConfig.md)
  - [VmInfo](docs/VmInfo.md)

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/api/openapi.yaml

@@ -123,6 +123,18 @@ paths:
         "405":
           description: The VM instance could not reboot because it is not booted.
       summary: Reboot the VM instance.
+  /vm.power-button:
+    put:
+      operationId: power-buttonVM
+      responses:
+        "204":
+          description: Power button successfully triggered in the VM
+        "404":
+          description: The button could not be triggered because it is not created
+            yet
+        "405":
+          description: The button could not be triggered because it is not booted.
+      summary: Trigger a power button in the VM
   /vm.resize:
     put:
       requestBody:
@@ -332,7 +344,7 @@ components:
     VmInfo:
       description: Virtual Machine information
       example:
-        memory_actual_size: 2
+        memory_actual_size: 3
         state: Created
         config:
           console:
@@ -340,54 +352,75 @@ components:
             file: file
             iommu: false
           balloon:
-            size: 4
+            size: 9
           memory:
             hugepages: false
             shared: false
+            hugepage_size: 4
             mergeable: false
             size: 9
             hotplugged_size: 2
             zones:
             - hugepages: false
               shared: false
+              hugepage_size: 1
               mergeable: false
               file: file
-              size: 4
+              size: 7
-              hotplugged_size: 1
+              hotplugged_size: 6
-              host_numa_node: 7
+              host_numa_node: 1
               id: id
               hotplug_size: 1
             - hugepages: false
               shared: false
+              hugepage_size: 1
               mergeable: false
               file: file
-              size: 4
+              size: 7
-              hotplugged_size: 1
+              hotplugged_size: 6
-              host_numa_node: 7
+              host_numa_node: 1
               id: id
               hotplug_size: 1
             hotplug_size: 3
             hotplug_method: acpi
           disks:
           - path: path
-            num_queues: 1
+            num_queues: 7
             readonly: false
             iommu: false
-            queue_size: 6
+            queue_size: 1
             vhost_socket: vhost_socket
             vhost_user: false
             direct: false
             poll_queue: true
+            rate_limiter_config:
+              ops:
+                size: 0
+                one_time_burst: 0
+                refill_time: 0
+              bandwidth:
+                size: 0
+                one_time_burst: 0
+                refill_time: 0
             id: id
           - path: path
-            num_queues: 1
+            num_queues: 7
             readonly: false
             iommu: false
-            queue_size: 6
+            queue_size: 1
             vhost_socket: vhost_socket
             vhost_user: false
             direct: false
             poll_queue: true
+            rate_limiter_config:
+              ops:
+                size: 0
+                one_time_burst: 0
+                refill_time: 0
+              bandwidth:
+                size: 0
+                one_time_burst: 0
+                refill_time: 0
             id: id
           cpus:
             topology:
@@ -409,25 +442,25 @@ components:
             path: path
           numa:
           - distances:
-            - distance: 1
+            - distance: 3
               destination: 6
-            - distance: 1
+            - distance: 3
               destination: 6
             cpus:
-            - 3
+            - 5
-            - 3
+            - 5
             memory_zones:
             - memory_zones
             - memory_zones
             guest_numa_id: 6
           - distances:
-            - distance: 1
+            - distance: 3
               destination: 6
-            - distance: 1
+            - distance: 3
               destination: 6
             cpus:
-            - 3
+            - 5
-            - 3
+            - 5
             memory_zones:
             - memory_zones
             - memory_zones
@@ -437,20 +470,20 @@ components:
             src: /dev/urandom
           sgx_epc:
           - prefault: false
-            size: 9
+            size: 6
           - prefault: false
-            size: 9
+            size: 6
           fs:
-          - num_queues: 5
+          - num_queues: 6
-            queue_size: 9
+            queue_size: 3
-            cache_size: 9
+            cache_size: 6
             dax: true
             tag: tag
             socket: socket
             id: id
-          - num_queues: 5
+          - num_queues: 6
-            queue_size: 9
+            queue_size: 3
-            cache_size: 9
+            cache_size: 6
             dax: true
             tag: tag
             socket: socket
@@ -463,13 +496,13 @@ components:
           pmem:
           - mergeable: false
             file: file
-            size: 6
+            size: 1
             iommu: false
             id: id
             discard_writes: false
           - mergeable: false
             file: file
-            size: 6
+            size: 1
             iommu: false
             id: id
             discard_writes: false
@@ -485,31 +518,37 @@ components:
             path: path
           net:
           - tap: tap
-            num_queues: 7
+            num_queues: 9
             iommu: false
-            queue_size: 1
+            queue_size: 6
             vhost_socket: vhost_socket
             vhost_user: false
             ip: 192.168.249.1
             id: id
             mac: mac
+            fd:
+            - 8
+            - 8
             mask: 255.255.255.0
           - tap: tap
-            num_queues: 7
+            num_queues: 9
             iommu: false
-            queue_size: 1
+            queue_size: 6
             vhost_socket: vhost_socket
             vhost_user: false
             ip: 192.168.249.1
             id: id
             mac: mac
+            fd:
+            - 8
+            - 8
             mask: 255.255.255.0
         device_tree:
           key:
             children:
             - children
             - children
-            pci_bdf: 6
+            pci_bdf: 7
             resources:
             - '{}'
             - '{}'
@@ -540,7 +579,7 @@ components:
         children:
         - children
         - children
-        pci_bdf: 6
+        pci_bdf: 7
         resources:
         - '{}'
         - '{}'
@@ -589,54 +628,75 @@ components:
           file: file
           iommu: false
         balloon:
-          size: 4
+          size: 9
         memory:
           hugepages: false
           shared: false
+          hugepage_size: 4
           mergeable: false
           size: 9
           hotplugged_size: 2
           zones:
           - hugepages: false
             shared: false
+            hugepage_size: 1
             mergeable: false
             file: file
-            size: 4
+            size: 7
-            hotplugged_size: 1
+            hotplugged_size: 6
-            host_numa_node: 7
+            host_numa_node: 1
             id: id
             hotplug_size: 1
           - hugepages: false
             shared: false
+            hugepage_size: 1
             mergeable: false
             file: file
-            size: 4
+            size: 7
-            hotplugged_size: 1
+            hotplugged_size: 6
-            host_numa_node: 7
+            host_numa_node: 1
             id: id
             hotplug_size: 1
           hotplug_size: 3
           hotplug_method: acpi
         disks:
         - path: path
-          num_queues: 1
+          num_queues: 7
           readonly: false
           iommu: false
-          queue_size: 6
+          queue_size: 1
           vhost_socket: vhost_socket
           vhost_user: false
           direct: false
           poll_queue: true
+          rate_limiter_config:
+            ops:
+              size: 0
+              one_time_burst: 0
+              refill_time: 0
+            bandwidth:
+              size: 0
+              one_time_burst: 0
+              refill_time: 0
           id: id
         - path: path
-          num_queues: 1
+          num_queues: 7
           readonly: false
           iommu: false
-          queue_size: 6
+          queue_size: 1
           vhost_socket: vhost_socket
           vhost_user: false
           direct: false
           poll_queue: true
+          rate_limiter_config:
+            ops:
+              size: 0
+              one_time_burst: 0
+              refill_time: 0
+            bandwidth:
+              size: 0
+              one_time_burst: 0
+              refill_time: 0
           id: id
         cpus:
           topology:
@@ -658,25 +718,25 @@ components:
           path: path
         numa:
         - distances:
-          - distance: 1
+          - distance: 3
             destination: 6
-          - distance: 1
+          - distance: 3
             destination: 6
           cpus:
-          - 3
+          - 5
-          - 3
+          - 5
           memory_zones:
           - memory_zones
           - memory_zones
           guest_numa_id: 6
         - distances:
-          - distance: 1
+          - distance: 3
             destination: 6
-          - distance: 1
+          - distance: 3
             destination: 6
           cpus:
-          - 3
+          - 5
-          - 3
+          - 5
           memory_zones:
           - memory_zones
           - memory_zones
@@ -686,20 +746,20 @@ components:
           src: /dev/urandom
         sgx_epc:
         - prefault: false
-          size: 9
+          size: 6
         - prefault: false
-          size: 9
+          size: 6
         fs:
-        - num_queues: 5
+        - num_queues: 6
-          queue_size: 9
+          queue_size: 3
-          cache_size: 9
+          cache_size: 6
           dax: true
           tag: tag
           socket: socket
           id: id
-        - num_queues: 5
+        - num_queues: 6
-          queue_size: 9
+          queue_size: 3
-          cache_size: 9
+          cache_size: 6
           dax: true
           tag: tag
           socket: socket
@@ -712,13 +772,13 @@ components:
         pmem:
         - mergeable: false
           file: file
-          size: 6
+          size: 1
           iommu: false
           id: id
           discard_writes: false
         - mergeable: false
           file: file
-          size: 6
+          size: 1
           iommu: false
           id: id
           discard_writes: false
@@ -734,24 +794,30 @@ components:
           path: path
         net:
         - tap: tap
-          num_queues: 7
+          num_queues: 9
           iommu: false
-          queue_size: 1
+          queue_size: 6
           vhost_socket: vhost_socket
           vhost_user: false
           ip: 192.168.249.1
           id: id
           mac: mac
+          fd:
+          - 8
+          - 8
           mask: 255.255.255.0
         - tap: tap
-          num_queues: 7
+          num_queues: 9
           iommu: false
-          queue_size: 1
+          queue_size: 6
           vhost_socket: vhost_socket
           vhost_user: false
           ip: 192.168.249.1
           id: id
           mac: mac
+          fd:
+          - 8
+          - 8
           mask: 255.255.255.0
       properties:
         cpus:
@@ -858,11 +924,12 @@ components:
       example:
         hugepages: false
         shared: false
+        hugepage_size: 1
         mergeable: false
         file: file
-        size: 4
+        size: 7
-        hotplugged_size: 1
+        hotplugged_size: 6
-        host_numa_node: 7
+        host_numa_node: 1
         id: id
         hotplug_size: 1
       properties:
@@ -882,6 +949,9 @@ components:
         hugepages:
           default: false
           type: boolean
+        hugepage_size:
+          format: int64
+          type: integer
         host_numa_node:
           format: int32
           type: integer
@@ -899,26 +969,29 @@ components:
       example:
         hugepages: false
         shared: false
+        hugepage_size: 4
         mergeable: false
         size: 9
         hotplugged_size: 2
         zones:
         - hugepages: false
           shared: false
+          hugepage_size: 1
           mergeable: false
           file: file
-          size: 4
+          size: 7
-          hotplugged_size: 1
+          hotplugged_size: 6
-          host_numa_node: 7
+          host_numa_node: 1
           id: id
           hotplug_size: 1
         - hugepages: false
           shared: false
+          hugepage_size: 1
           mergeable: false
           file: file
-          size: 4
+          size: 7
-          hotplugged_size: 1
+          hotplugged_size: 6
-          host_numa_node: 7
+          host_numa_node: 1
           id: id
           hotplug_size: 1
         hotplug_size: 3
@@ -945,6 +1018,9 @@ components:
         hugepages:
           default: false
           type: boolean
+        hugepage_size:
+          format: int64
+          type: integer
         zones:
           items:
             $ref: '#/components/schemas/MemoryZoneConfig'
@@ -980,17 +1056,78 @@ components:
       required:
       - args
       type: object
+    TokenBucket:
+      description: Defines a token bucket with a maximum capacity (_size_), an initial
+        burst size (_one_time_burst_) and an interval for refilling purposes (_refill_time_).
+        The refill-rate is derived from _size_ and _refill_time_, and it is the constant
+        rate at which the tokens replenish. The refill process only starts happening
+        after the initial burst budget is consumed. Consumption from the token bucket
+        is unbounded in speed which allows for bursts bound in size by the amount
+        of tokens available. Once the token bucket is empty, consumption speed is
+        bound by the refill-rate.
+      example:
+        size: 0
+        one_time_burst: 0
+        refill_time: 0
+      properties:
+        size:
+          description: The total number of tokens this bucket can hold.
+          format: int64
+          minimum: 0
+          type: integer
+        one_time_burst:
+          description: The initial size of a token bucket.
+          format: int64
+          minimum: 0
+          type: integer
+        refill_time:
+          description: The amount of milliseconds it takes for the bucket to refill.
+          format: int64
+          minimum: 0
+          type: integer
+      required:
+      - refill_time
+      - size
+      type: object
+    RateLimiterConfig:
+      description: Defines an IO rate limiter with independent bytes/s and ops/s limits.
+        Limits are defined by configuring each of the _bandwidth_ and _ops_ token
+        buckets.
+      example:
+        ops:
+          size: 0
+          one_time_burst: 0
+          refill_time: 0
+        bandwidth:
+          size: 0
+          one_time_burst: 0
+          refill_time: 0
+      properties:
+        bandwidth:
+          $ref: '#/components/schemas/TokenBucket'
+        ops:
+          $ref: '#/components/schemas/TokenBucket'
+      type: object
     DiskConfig:
       example:
         path: path
-        num_queues: 1
+        num_queues: 7
         readonly: false
         iommu: false
-        queue_size: 6
+        queue_size: 1
         vhost_socket: vhost_socket
         vhost_user: false
         direct: false
         poll_queue: true
+        rate_limiter_config:
+          ops:
+            size: 0
+            one_time_burst: 0
+            refill_time: 0
+          bandwidth:
+            size: 0
+            one_time_burst: 0
+            refill_time: 0
         id: id
       properties:
         path:
@@ -1018,6 +1155,8 @@ components:
         poll_queue:
           default: true
           type: boolean
+        rate_limiter_config:
+          $ref: '#/components/schemas/RateLimiterConfig'
         id:
           type: string
       required:
@@ -1026,14 +1165,17 @@ components:
     NetConfig:
       example:
         tap: tap
-        num_queues: 7
+        num_queues: 9
         iommu: false
-        queue_size: 1
+        queue_size: 6
         vhost_socket: vhost_socket
         vhost_user: false
         ip: 192.168.249.1
         id: id
         mac: mac
+        fd:
+        - 8
+        - 8
         mask: 255.255.255.0
       properties:
         tap:
@@ -1063,6 +1205,11 @@ components:
           type: string
         id:
           type: string
+        fd:
+          items:
+            format: int32
+            type: integer
+          type: array
       type: object
     RngConfig:
       example:
@@ -1080,7 +1227,7 @@ components:
       type: object
     BalloonConfig:
       example:
-        size: 4
+        size: 9
       properties:
         size:
           format: int64
@@ -1090,9 +1237,9 @@ components:
       type: object
     FsConfig:
       example:
-        num_queues: 5
+        num_queues: 6
-        queue_size: 9
+        queue_size: 3
-        cache_size: 9
+        cache_size: 6
         dax: true
         tag: tag
         socket: socket
@@ -1128,7 +1275,7 @@ components:
       example:
         mergeable: false
         file: file
-        size: 6
+        size: 1
         iommu: false
         id: id
         discard_writes: false
@@ -1163,6 +1310,7 @@ components:
         mode:
           enum:
           - "false"
+          - Pty
           - Tty
           - File
           - null
@@ -1216,7 +1364,7 @@ components:
     SgxEpcConfig:
       example:
         prefault: false
-        size: 9
+        size: 6
       properties:
         size:
           format: int64
@@ -1229,7 +1377,7 @@ components:
       type: object
     NumaDistance:
       example:
-        distance: 1
+        distance: 3
         destination: 6
       properties:
         destination:
@@ -1245,13 +1393,13 @@ components:
     NumaConfig:
       example:
         distances:
-        - distance: 1
+        - distance: 3
           destination: 6
-        - distance: 1
+        - distance: 3
           destination: 6
         cpus:
-        - 3
+        - 5
-        - 3
+        - 5
         memory_zones:
         - memory_zones
         - memory_zones

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/api_default.go

@@ -279,6 +279,69 @@ func (a *DefaultApiService) PauseVM(ctx _context.Context) (*_nethttp.Response, e
 	return localVarHTTPResponse, nil
 }
 
+/*
+PowerButtonVM Trigger a power button in the VM
+ * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().
+*/
+func (a *DefaultApiService) PowerButtonVM(ctx _context.Context) (*_nethttp.Response, error) {
+	var (
+		localVarHTTPMethod   = _nethttp.MethodPut
+		localVarPostBody     interface{}
+		localVarFormFileName string
+		localVarFileName     string
+		localVarFileBytes    []byte
+	)
+
+	// create path and map variables
+	localVarPath := a.client.cfg.BasePath + "/vm.power-button"
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _neturl.Values{}
+	localVarFormParams := _neturl.Values{}
+
+	// to determine the Content-Type header
+	localVarHTTPContentTypes := []string{}
+
+	// set Content-Type header
+	localVarHTTPContentType := selectHeaderContentType(localVarHTTPContentTypes)
+	if localVarHTTPContentType != "" {
+		localVarHeaderParams["Content-Type"] = localVarHTTPContentType
+	}
+
+	// to determine the Accept header
+	localVarHTTPHeaderAccepts := []string{}
+
+	// set Accept header
+	localVarHTTPHeaderAccept := selectHeaderAccept(localVarHTTPHeaderAccepts)
+	if localVarHTTPHeaderAccept != "" {
+		localVarHeaderParams["Accept"] = localVarHTTPHeaderAccept
+	}
+	r, err := a.client.prepareRequest(ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, localVarFormFileName, localVarFileName, localVarFileBytes)
+	if err != nil {
+		return nil, err
+	}
+
+	localVarHTTPResponse, err := a.client.callAPI(r)
+	if err != nil || localVarHTTPResponse == nil {
+		return localVarHTTPResponse, err
+	}
+
+	localVarBody, err := _ioutil.ReadAll(localVarHTTPResponse.Body)
+	localVarHTTPResponse.Body.Close()
+	if err != nil {
+		return localVarHTTPResponse, err
+	}
+
+	if localVarHTTPResponse.StatusCode >= 300 {
+		newErr := GenericOpenAPIError{
+			body:  localVarBody,
+			error: localVarHTTPResponse.Status,
+		}
+		return localVarHTTPResponse, newErr
+	}
+
+	return localVarHTTPResponse, nil
+}
+
 /*
 RebootVM Reboot the VM instance.
  * @param ctx _context.Context - for authentication, logging, cancellation, deadlines, tracing, etc. Passed from http.Request or context.Background().

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/DefaultApi.md

@@ -8,6 +8,7 @@ Method | HTTP request | Description
 [**CreateVM**](DefaultApi.md#CreateVM) | **Put** /vm.create | Create the cloud-hypervisor Virtual Machine (VM) instance. The instance is not booted, only created.
 [**DeleteVM**](DefaultApi.md#DeleteVM) | **Put** /vm.delete | Delete the cloud-hypervisor Virtual Machine (VM) instance.
 [**PauseVM**](DefaultApi.md#PauseVM) | **Put** /vm.pause | Pause a previously booted VM instance.
+[**PowerButtonVM**](DefaultApi.md#PowerButtonVM) | **Put** /vm.power-button | Trigger a power button in the VM
 [**RebootVM**](DefaultApi.md#RebootVM) | **Put** /vm.reboot | Reboot the VM instance.
 [**ResumeVM**](DefaultApi.md#ResumeVM) | **Put** /vm.resume | Resume a previously paused VM instance.
 [**ShutdownVM**](DefaultApi.md#ShutdownVM) | **Put** /vm.shutdown | Shut the VM instance down.
@@ -145,6 +146,34 @@ No authorization required
 [[Back to README]](../README.md)
 
 
+## PowerButtonVM
+
+> PowerButtonVM(ctx, )
+
+Trigger a power button in the VM
+
+### Required Parameters
+
+This endpoint does not need any parameter.
+
+### Return type
+
+ (empty response body)
+
+### Authorization
+
+No authorization required
+
+### HTTP request headers
+
+- **Content-Type**: Not defined
+- **Accept**: Not defined
+
+[[Back to top]](#) [[Back to API list]](../README.md#documentation-for-api-endpoints)
+[[Back to Model list]](../README.md#documentation-for-models)
+[[Back to README]](../README.md)
+
+
 ## RebootVM
 
 > RebootVM(ctx, )

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/DiskConfig.md

@@ -13,6 +13,7 @@ Name | Type | Description | Notes
 **VhostUser** | **bool** |  | [optional] [default to false]
 **VhostSocket** | **string** |  | [optional] 
 **PollQueue** | **bool** |  | [optional] [default to true]
+**RateLimiterConfig** | [**RateLimiterConfig**](RateLimiterConfig.md) |  | [optional] 
 **Id** | **string** |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/MemoryConfig.md

@@ -11,6 +11,7 @@ Name | Type | Description | Notes
 **HotplugMethod** | **string** |  | [optional] [default to acpi]
 **Shared** | **bool** |  | [optional] [default to false]
 **Hugepages** | **bool** |  | [optional] [default to false]
+**HugepageSize** | **int64** |  | [optional] 
 **Zones** | [**[]MemoryZoneConfig**](MemoryZoneConfig.md) |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/MemoryZoneConfig.md

@@ -10,6 +10,7 @@ Name | Type | Description | Notes
 **Mergeable** | **bool** |  | [optional] [default to false]
 **Shared** | **bool** |  | [optional] [default to false]
 **Hugepages** | **bool** |  | [optional] [default to false]
+**HugepageSize** | **int64** |  | [optional] 
 **HostNumaNode** | **int32** |  | [optional] 
 **HotplugSize** | **int64** |  | [optional] 
 **HotpluggedSize** | **int64** |  | [optional] 

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/NetConfig.md

@@ -14,6 +14,7 @@ Name | Type | Description | Notes
 **VhostUser** | **bool** |  | [optional] [default to false]
 **VhostSocket** | **string** |  | [optional] 
 **Id** | **string** |  | [optional] 
+**Fd** | **[]int32** |  | [optional] 
 
 [[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
 

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/RateLimiterConfig.md

@@ -0,0 +1,12 @@
+# RateLimiterConfig
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**Bandwidth** | [**TokenBucket**](TokenBucket.md) |  | [optional] 
+**Ops** | [**TokenBucket**](TokenBucket.md) |  | [optional] 
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/docs/TokenBucket.md

@@ -0,0 +1,13 @@
+# TokenBucket
+
+## Properties
+
+Name | Type | Description | Notes
+------------ | ------------- | ------------- | -------------
+**Size** | **int64** | The total number of tokens this bucket can hold. | 
+**OneTimeBurst** | **int64** | The initial size of a token bucket. | [optional] 
+**RefillTime** | **int64** | The amount of milliseconds it takes for the bucket to refill. | 
+
+[[Back to Model list]](../README.md#documentation-for-models) [[Back to API list]](../README.md#documentation-for-api-endpoints) [[Back to README]](../README.md)
+
+

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/model_disk_config.go

@@ -19,5 +19,6 @@ type DiskConfig struct {
 	VhostUser bool `json:"vhost_user,omitempty"`
 	VhostSocket string `json:"vhost_socket,omitempty"`
 	PollQueue bool `json:"poll_queue,omitempty"`
+	RateLimiterConfig RateLimiterConfig `json:"rate_limiter_config,omitempty"`
 	Id string `json:"id,omitempty"`
 }

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/model_memory_config.go

@@ -17,5 +17,6 @@ type MemoryConfig struct {
 	HotplugMethod string `json:"hotplug_method,omitempty"`
 	Shared bool `json:"shared,omitempty"`
 	Hugepages bool `json:"hugepages,omitempty"`
+	HugepageSize int64 `json:"hugepage_size,omitempty"`
 	Zones []MemoryZoneConfig `json:"zones,omitempty"`
 }

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/model_memory_zone_config.go

@@ -16,6 +16,7 @@ type MemoryZoneConfig struct {
 	Mergeable bool `json:"mergeable,omitempty"`
 	Shared bool `json:"shared,omitempty"`
 	Hugepages bool `json:"hugepages,omitempty"`
+	HugepageSize int64 `json:"hugepage_size,omitempty"`
 	HostNumaNode int32 `json:"host_numa_node,omitempty"`
 	HotplugSize int64 `json:"hotplug_size,omitempty"`
 	HotpluggedSize int64 `json:"hotplugged_size,omitempty"`

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/model_net_config.go

@@ -20,4 +20,5 @@ type NetConfig struct {
 	VhostUser bool `json:"vhost_user,omitempty"`
 	VhostSocket string `json:"vhost_socket,omitempty"`
 	Id string `json:"id,omitempty"`
+	Fd []int32 `json:"fd,omitempty"`
 }

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/model_rate_limiter_config.go

@@ -0,0 +1,15 @@
+/*
+ * Cloud Hypervisor API
+ *
+ * Local HTTP based API for managing and inspecting a cloud-hypervisor virtual machine.
+ *
+ * API version: 0.3.0
+ * Generated by: OpenAPI Generator (https://openapi-generator.tech)
+ */
+
+package openapi
+// RateLimiterConfig Defines an IO rate limiter with independent bytes/s and ops/s limits. Limits are defined by configuring each of the _bandwidth_ and _ops_ token buckets.
+type RateLimiterConfig struct {
+	Bandwidth TokenBucket `json:"bandwidth,omitempty"`
+	Ops TokenBucket `json:"ops,omitempty"`
+}

src/runtime/virtcontainers/pkg/cloud-hypervisor/client/model_token_bucket.go

@@ -0,0 +1,19 @@
+/*
+ * Cloud Hypervisor API
+ *
+ * Local HTTP based API for managing and inspecting a cloud-hypervisor virtual machine.
+ *
+ * API version: 0.3.0
+ * Generated by: OpenAPI Generator (https://openapi-generator.tech)
+ */
+
+package openapi
+// TokenBucket Defines a token bucket with a maximum capacity (_size_), an initial burst size (_one_time_burst_) and an interval for refilling purposes (_refill_time_). The refill-rate is derived from _size_ and _refill_time_, and it is the constant rate at which the tokens replenish. The refill process only starts happening after the initial burst budget is consumed. Consumption from the token bucket is unbounded in speed which allows for bursts bound in size by the amount of tokens available. Once the token bucket is empty, consumption speed is bound by the refill-rate.
+type TokenBucket struct {
+	// The total number of tokens this bucket can hold.
+	Size int64 `json:"size"`
+	// The initial size of a token bucket.
+	OneTimeBurst int64 `json:"one_time_burst,omitempty"`
+	// The amount of milliseconds it takes for the bucket to refill.
+	RefillTime int64 `json:"refill_time"`
+}

src/runtime/virtcontainers/pkg/cloud-hypervisor/cloud-hypervisor.yaml

@@ -134,6 +134,18 @@ paths:
         405:
           description: The VM instance could not reboot because it is not booted.
 
+  /vm.power-button:
+    put:
+      summary: Trigger a power button in the VM
+      operationId: power-buttonVM
+      responses:
+        204:
+          description: Power button successfully triggered in the VM
+        404:
+          description: The button could not be triggered because it is not created yet
+        405:
+          description: The button could not be triggered because it is not booted.
+
   /vm.resize:
     put:
       summary: Resize the VM
@@ -386,7 +398,7 @@ components:
         pci_bdf:
           type: integer
           format: int32
-        
+
     VmCounters:
       type: object
       additionalProperties:
@@ -522,6 +534,9 @@ components:
         hugepages:
           type: boolean
           default: false
+        hugepage_size:
+          type: integer
+          format: int64
         host_numa_node:
           type: integer
           format: int32
@@ -559,6 +574,9 @@ components:
         hugepages:
           type: boolean
           default: false
+        hugepage_size:
+          type: integer
+          format: int64
         zones:
           type: array
           items:
@@ -589,6 +607,48 @@ components:
         args:
           type: string
 
+    TokenBucket:
+      required:
+      - size
+      - refill_time
+      type: object
+      properties:
+        size:
+          type: integer
+          format: int64
+          minimum: 0
+          description: The total number of tokens this bucket can hold.
+        one_time_burst:
+          type: integer
+          format: int64
+          minimum: 0
+          description: The initial size of a token bucket.
+        refill_time:
+          type: integer
+          format: int64
+          minimum: 0
+          description: The amount of milliseconds it takes for the bucket to refill.
+      description:
+        Defines a token bucket with a maximum capacity (_size_), an initial burst size
+        (_one_time_burst_) and an interval for refilling purposes (_refill_time_).
+        The refill-rate is derived from _size_ and _refill_time_, and it is the constant
+        rate at which the tokens replenish. The refill process only starts happening after
+        the initial burst budget is consumed.
+        Consumption from the token bucket is unbounded in speed which allows for bursts
+        bound in size by the amount of tokens available.
+        Once the token bucket is empty, consumption speed is bound by the refill-rate.
+
+    RateLimiterConfig:
+      type: object
+      properties:
+        bandwidth:
+          $ref: '#/components/schemas/TokenBucket'
+        ops:
+          $ref: '#/components/schemas/TokenBucket'
+      description:
+        Defines an IO rate limiter with independent bytes/s and ops/s limits.
+        Limits are defined by configuring each of the _bandwidth_ and _ops_ token buckets.
+
     DiskConfig:
       required:
       - path
@@ -619,6 +679,8 @@ components:
         poll_queue:
           type: boolean
           default: true
+        rate_limiter_config:
+            $ref: '#/components/schemas/RateLimiterConfig'
         id:
           type: string
 
@@ -652,6 +714,11 @@ components:
           type: string
         id:
           type: string
+        fd:
+          type: array
+          items:
+            type: integer
+            format: int32
 
     RngConfig:
       required:
@@ -735,7 +802,7 @@ components:
           type: string
         mode:
           type: string
-          enum: [Off, Tty, File, Null]
+          enum: [Off, Pty, Tty, File, Null]
         iommu:
           type: boolean
           default: false

versions.yaml

@@ -75,7 +75,7 @@ assets:
       url: "https://github.com/cloud-hypervisor/cloud-hypervisor"
       uscan-url: >-
         https://github.com/cloud-hypervisor/cloud-hypervisor/tags.*/v?(\d\S+)\.tar\.gz
-      version: "v0.12.0"
+      version: "v0.14.1"
 
     firecracker:
       description: "Firecracker micro-VMM"