virtio-balloon: Add free page hinting

Free page hinting is a mechanism which allows the guest driver to report
ranges of pages to the host device. A "hinting" run is triggered by the
device by issuing a new command id in the config space, after the update
to the id the device will hint ranges to the host which are unused. Once
the driver has exhausted all free ranges it notifies the device the run
has completed. The device can then issue another command allowing the
guest to reclaim these pages.

Adding support for hinting the firecracker balloon device, we offer
three points to manage the device; first to start a run, second to
monitor the status and a final to issue the command to allow the guest
to reclaim pages.

To note, there is a potential condition in the linux driver which would
allow a range to be reclaimed in an oom scenario before we remove the
range.

Signed-off-by: Jack Thomson <[email protected]>

Author: JackThomson2

src/vmm/src/builder.rs

@@ -1231,6 +1231,7 @@ pub(crate) mod tests {
             amount_mib: 0,
             deflate_on_oom: false,
             stats_polling_interval_s: 0,
+            free_page_hinting: false,
             free_page_reporting: false,
         };
 

src/vmm/src/device_manager/pci_mngr.rs

@@ -645,6 +645,7 @@ mod tests {
                 amount_mib: 123,
                 deflate_on_oom: false,
                 stats_polling_interval_s: 1,
+                free_page_hinting: false,
                 free_page_reporting: false,
             };
             insert_balloon_device(&mut vmm, &mut cmdline, &mut event_manager, balloon_cfg);
@@ -730,6 +731,7 @@ mod tests {
     "amount_mib": 123,
     "deflate_on_oom": false,
     "stats_polling_interval_s": 1,
+    "free_page_hinting": false,
     "free_page_reporting": false
   }},
   "drives": [

src/vmm/src/device_manager/persist.rs

@@ -669,6 +669,7 @@ mod tests {
                 amount_mib: 123,
                 deflate_on_oom: false,
                 stats_polling_interval_s: 1,
+                free_page_hinting: false,
                 free_page_reporting: false,
             };
             insert_balloon_device(&mut vmm, &mut cmdline, &mut event_manager, balloon_cfg);
@@ -750,6 +751,7 @@ mod tests {
     "amount_mib": 123,
     "deflate_on_oom": false,
     "stats_polling_interval_s": 1,
+    "free_page_hinting": false,
     "free_page_reporting": false
   }},
   "drives": [