mirror of
https://github.com/cloud-hypervisor/cloud-hypervisor.git
synced 2026-08-05 02:19:16 +00:00
warning: this argument is a mutable reference, but not used mutably
--> src/bin/ch-remote.rs:397:52
|
397 | fn dbus_api_do_command(toplevel: &TopLevel, proxy: &mut DBusApi1ProxyBlocking<'_>) -> ApiResult {
| ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ help: consider changing to: `&DBusApi1ProxyBlocking<'_>`
|
= note: this is cfg-gated and may require further changes
= help: for further information visit https://rust-lang.github.io/rust-clippy/master/index.html#needless_pass_by_ref_mut
= note: `#[warn(clippy::needless_pass_by_ref_mut)]` on by default
Signed-off-by: Rob Bradford <rbradford@rivosinc.com>
1002 lines
34 KiB
Rust
1002 lines
34 KiB
Rust
// Copyright © 2020 Intel Corporation
|
|
//
|
|
// SPDX-License-Identifier: Apache-2.0
|
|
//
|
|
|
|
use api_client::simple_api_command;
|
|
use api_client::simple_api_command_with_fds;
|
|
use api_client::simple_api_full_command;
|
|
use api_client::Error as ApiClientError;
|
|
use argh::FromArgs;
|
|
use option_parser::{ByteSized, ByteSizedParseError};
|
|
use std::fmt;
|
|
use std::io::Read;
|
|
use std::marker::PhantomData;
|
|
use std::os::unix::net::UnixStream;
|
|
use std::process;
|
|
#[cfg(feature = "dbus_api")]
|
|
use zbus::{dbus_proxy, zvariant::Optional};
|
|
|
|
type ApiResult = Result<(), Error>;
|
|
|
|
#[derive(Debug)]
|
|
enum Error {
|
|
HttpApiClient(ApiClientError),
|
|
#[cfg(feature = "dbus_api")]
|
|
DBusApiClient(zbus::Error),
|
|
InvalidMemorySize(ByteSizedParseError),
|
|
InvalidBalloonSize(ByteSizedParseError),
|
|
AddDeviceConfig(vmm::config::Error),
|
|
AddDiskConfig(vmm::config::Error),
|
|
AddFsConfig(vmm::config::Error),
|
|
AddPmemConfig(vmm::config::Error),
|
|
AddNetConfig(vmm::config::Error),
|
|
AddUserDeviceConfig(vmm::config::Error),
|
|
AddVdpaConfig(vmm::config::Error),
|
|
AddVsockConfig(vmm::config::Error),
|
|
Restore(vmm::config::Error),
|
|
ReadingStdin(std::io::Error),
|
|
ReadingFile(std::io::Error),
|
|
}
|
|
|
|
impl fmt::Display for Error {
|
|
fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
|
|
use Error::*;
|
|
match self {
|
|
HttpApiClient(e) => e.fmt(f),
|
|
#[cfg(feature = "dbus_api")]
|
|
DBusApiClient(e) => write!(f, "Error D-Bus proxy: {e}"),
|
|
InvalidMemorySize(e) => write!(f, "Error parsing memory size: {e:?}"),
|
|
InvalidBalloonSize(e) => write!(f, "Error parsing balloon size: {e:?}"),
|
|
AddDeviceConfig(e) => write!(f, "Error parsing device syntax: {e}"),
|
|
AddDiskConfig(e) => write!(f, "Error parsing disk syntax: {e}"),
|
|
AddFsConfig(e) => write!(f, "Error parsing filesystem syntax: {e}"),
|
|
AddPmemConfig(e) => write!(f, "Error parsing persistent memory syntax: {e}"),
|
|
AddNetConfig(e) => write!(f, "Error parsing network syntax: {e}"),
|
|
AddUserDeviceConfig(e) => write!(f, "Error parsing user device syntax: {e}"),
|
|
AddVdpaConfig(e) => write!(f, "Error parsing vDPA device syntax: {e}"),
|
|
AddVsockConfig(e) => write!(f, "Error parsing vsock syntax: {e}"),
|
|
Restore(e) => write!(f, "Error parsing restore syntax: {e}"),
|
|
ReadingStdin(e) => write!(f, "Error reading from stdin: {e}"),
|
|
ReadingFile(e) => write!(f, "Error reading from file: {e}"),
|
|
}
|
|
}
|
|
}
|
|
|
|
enum TargetApi<'a> {
|
|
HttpApi(UnixStream, PhantomData<&'a ()>),
|
|
#[cfg(feature = "dbus_api")]
|
|
DBusApi(DBusApi1ProxyBlocking<'a>),
|
|
}
|
|
|
|
#[cfg(feature = "dbus_api")]
|
|
#[dbus_proxy(name = "org.cloudhypervisor.DBusApi1", assume_defaults = false)]
|
|
trait DBusApi1 {
|
|
fn vmm_ping(&self) -> zbus::Result<String>;
|
|
fn vmm_shutdown(&self) -> zbus::Result<()>;
|
|
fn vm_add_device(&self, device_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_disk(&self, disk_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_fs(&self, fs_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_net(&self, net_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_pmem(&self, pmem_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_user_device(&self, vm_add_user_device: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_vdpa(&self, vdpa_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_add_vsock(&self, vsock_config: &str) -> zbus::Result<Optional<String>>;
|
|
fn vm_boot(&self) -> zbus::Result<()>;
|
|
fn vm_coredump(&self, vm_coredump_data: &str) -> zbus::Result<()>;
|
|
fn vm_counters(&self) -> zbus::Result<Optional<String>>;
|
|
fn vm_create(&self, vm_config: &str) -> zbus::Result<()>;
|
|
fn vm_delete(&self) -> zbus::Result<()>;
|
|
fn vm_info(&self) -> zbus::Result<String>;
|
|
fn vm_pause(&self) -> zbus::Result<()>;
|
|
fn vm_power_button(&self) -> zbus::Result<()>;
|
|
fn vm_reboot(&self) -> zbus::Result<()>;
|
|
fn vm_remove_device(&self, vm_remove_device: &str) -> zbus::Result<()>;
|
|
fn vm_resize(&self, vm_resize: &str) -> zbus::Result<()>;
|
|
fn vm_resize_zone(&self, vm_resize_zone: &str) -> zbus::Result<()>;
|
|
fn vm_restore(&self, restore_config: &str) -> zbus::Result<()>;
|
|
fn vm_receive_migration(&self, receive_migration_data: &str) -> zbus::Result<()>;
|
|
fn vm_send_migration(&self, receive_migration_data: &str) -> zbus::Result<()>;
|
|
fn vm_resume(&self) -> zbus::Result<()>;
|
|
fn vm_shutdown(&self) -> zbus::Result<()>;
|
|
fn vm_snapshot(&self, vm_snapshot_config: &str) -> zbus::Result<()>;
|
|
}
|
|
|
|
#[cfg(feature = "dbus_api")]
|
|
impl<'a> DBusApi1ProxyBlocking<'a> {
|
|
fn new_connection(name: &'a str, path: &'a str, system_bus: bool) -> Result<Self, zbus::Error> {
|
|
let connection = if system_bus {
|
|
zbus::blocking::Connection::system()?
|
|
} else {
|
|
zbus::blocking::Connection::session()?
|
|
};
|
|
|
|
Self::builder(&connection)
|
|
.destination(name)?
|
|
.path(path)?
|
|
.build()
|
|
}
|
|
|
|
fn print_response(&self, result: zbus::Result<Optional<String>>) -> ApiResult {
|
|
result
|
|
.map(|ret| {
|
|
if let Some(ref output) = *ret {
|
|
println!("{output}");
|
|
}
|
|
})
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vmm_ping(&self) -> ApiResult {
|
|
self.vmm_ping()
|
|
.map(|ping| println!("{ping}"))
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vmm_shutdown(&self) -> ApiResult {
|
|
self.vmm_shutdown().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_add_device(&self, device_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_device(device_config))
|
|
}
|
|
|
|
fn api_vm_add_disk(&self, disk_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_disk(disk_config))
|
|
}
|
|
|
|
fn api_vm_add_fs(&self, fs_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_fs(fs_config))
|
|
}
|
|
|
|
fn api_vm_add_net(&self, net_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_net(net_config))
|
|
}
|
|
|
|
fn api_vm_add_pmem(&self, pmem_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_pmem(pmem_config))
|
|
}
|
|
|
|
fn api_vm_add_user_device(&self, vm_add_user_device: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_user_device(vm_add_user_device))
|
|
}
|
|
|
|
fn api_vm_add_vdpa(&self, vdpa_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_vdpa(vdpa_config))
|
|
}
|
|
|
|
fn api_vm_add_vsock(&self, vsock_config: &str) -> ApiResult {
|
|
self.print_response(self.vm_add_vsock(vsock_config))
|
|
}
|
|
|
|
fn api_vm_boot(&self) -> ApiResult {
|
|
self.vm_boot().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_coredump(&self, vm_coredump_data: &str) -> ApiResult {
|
|
self.vm_coredump(vm_coredump_data)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_counters(&self) -> ApiResult {
|
|
self.print_response(self.vm_counters())
|
|
}
|
|
|
|
fn api_vm_create(&self, vm_config: &str) -> ApiResult {
|
|
self.vm_create(vm_config).map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_delete(&self) -> ApiResult {
|
|
self.vm_delete().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_info(&self) -> ApiResult {
|
|
self.vm_info()
|
|
.map(|info| println!("{info}"))
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_pause(&self) -> ApiResult {
|
|
self.vm_pause().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_power_button(&self) -> ApiResult {
|
|
self.vm_power_button().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_reboot(&self) -> ApiResult {
|
|
self.vm_reboot().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_remove_device(&self, vm_remove_device: &str) -> ApiResult {
|
|
self.vm_remove_device(vm_remove_device)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_resize(&self, vm_resize: &str) -> ApiResult {
|
|
self.vm_resize(vm_resize).map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_resize_zone(&self, vm_resize_zone: &str) -> ApiResult {
|
|
self.vm_resize_zone(vm_resize_zone)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_restore(&self, restore_config: &str) -> ApiResult {
|
|
self.vm_restore(restore_config)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_receive_migration(&self, receive_migration_data: &str) -> ApiResult {
|
|
self.vm_receive_migration(receive_migration_data)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_send_migration(&self, send_migration_data: &str) -> ApiResult {
|
|
self.vm_send_migration(send_migration_data)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_resume(&self) -> ApiResult {
|
|
self.vm_resume().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_shutdown(&self) -> ApiResult {
|
|
self.vm_shutdown().map_err(Error::DBusApiClient)
|
|
}
|
|
|
|
fn api_vm_snapshot(&self, vm_snapshot_config: &str) -> ApiResult {
|
|
self.vm_snapshot(vm_snapshot_config)
|
|
.map_err(Error::DBusApiClient)
|
|
}
|
|
}
|
|
|
|
impl<'a> TargetApi<'a> {
|
|
fn do_command(&mut self, toplevel: &TopLevel) -> ApiResult {
|
|
match self {
|
|
Self::HttpApi(api_socket, _) => rest_api_do_command(toplevel, api_socket),
|
|
#[cfg(feature = "dbus_api")]
|
|
Self::DBusApi(proxy) => dbus_api_do_command(toplevel, proxy),
|
|
}
|
|
}
|
|
}
|
|
|
|
fn rest_api_do_command(toplevel: &TopLevel, socket: &mut UnixStream) -> ApiResult {
|
|
match toplevel.command {
|
|
SubCommandEnum::Boot(_) => {
|
|
simple_api_command(socket, "PUT", "boot", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Delete(_) => {
|
|
simple_api_command(socket, "PUT", "delete", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::ShutdownVmm(_) => {
|
|
simple_api_full_command(socket, "PUT", "vmm.shutdown", None)
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Resume(_) => {
|
|
simple_api_command(socket, "PUT", "resume", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::PowerButton(_) => {
|
|
simple_api_command(socket, "PUT", "power-button", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Reboot(_) => {
|
|
simple_api_command(socket, "PUT", "reboot", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Pause(_) => {
|
|
simple_api_command(socket, "PUT", "pause", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Info(_) => {
|
|
simple_api_command(socket, "GET", "info", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Counters(_) => {
|
|
simple_api_command(socket, "GET", "counters", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Ping(_) => {
|
|
simple_api_full_command(socket, "GET", "vmm.ping", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Shutdown(_) => {
|
|
simple_api_command(socket, "PUT", "shutdown", None).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Resize(ref config) => {
|
|
let resize = resize_config(config.cpus, &config.memory, &config.balloon)?;
|
|
simple_api_command(socket, "PUT", "resize", Some(&resize)).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::ResizeZone(ref config) => {
|
|
let resize_zone = resize_zone_config(&config.id, &config.size)?;
|
|
simple_api_command(socket, "PUT", "resize-zone", Some(&resize_zone))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddDevice(ref config) => {
|
|
let device_config = add_device_config(&config.device_config)?;
|
|
simple_api_command(socket, "PUT", "add-device", Some(&device_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::RemoveDevice(ref config) => {
|
|
let remove_device_data = remove_device_config(&config.device_config);
|
|
simple_api_command(socket, "PUT", "remove-device", Some(&remove_device_data))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddDisk(ref config) => {
|
|
let disk_config = add_disk_config(&config.disk_config)?;
|
|
simple_api_command(socket, "PUT", "add-disk", Some(&disk_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddFs(ref config) => {
|
|
let fs_config = add_fs_config(&config.fs_config)?;
|
|
simple_api_command(socket, "PUT", "add-fs", Some(&fs_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddPmem(ref config) => {
|
|
let pmem_config = add_pmem_config(&config.pmem_config)?;
|
|
simple_api_command(socket, "PUT", "add-pmem", Some(&pmem_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddNet(ref config) => {
|
|
let (net_config, fds) = add_net_config(&config.net_config)?;
|
|
simple_api_command_with_fds(socket, "PUT", "add-net", Some(&net_config), fds)
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddUserDevice(ref config) => {
|
|
let device_config = add_user_device_config(&config.device_config)?;
|
|
simple_api_command(socket, "PUT", "add-user-device", Some(&device_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddVdpa(ref config) => {
|
|
let vdpa_config = add_vdpa_config(&config.vdpa_config)?;
|
|
simple_api_command(socket, "PUT", "add-vdpa", Some(&vdpa_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::AddVsock(ref config) => {
|
|
let vsock_config = add_vsock_config(&config.vsock_config)?;
|
|
simple_api_command(socket, "PUT", "add-vsock", Some(&vsock_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Snapshot(ref config) => {
|
|
let snapshot_config = snapshot_api_config(&config.snapshot_config);
|
|
simple_api_command(socket, "PUT", "snapshot", Some(&snapshot_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Restore(ref config) => {
|
|
let restore_config = restore_config(&config.restore_config)?;
|
|
simple_api_command(socket, "PUT", "restore", Some(&restore_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Coredump(ref config) => {
|
|
let coredump_config = coredump_config(&config.coredump_config);
|
|
simple_api_command(socket, "PUT", "coredump", Some(&coredump_config))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::SendMigration(ref config) => {
|
|
let send_migration_data =
|
|
send_migration_data(&config.send_migration_config, config.send_migration_local);
|
|
simple_api_command(socket, "PUT", "send-migration", Some(&send_migration_data))
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::ReceiveMigration(ref config) => {
|
|
let receive_migration_data = receive_migration_data(&config.receive_migration_config);
|
|
simple_api_command(
|
|
socket,
|
|
"PUT",
|
|
"receive-migration",
|
|
Some(&receive_migration_data),
|
|
)
|
|
.map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Create(ref config) => {
|
|
let data = create_data(&config.vm_config)?;
|
|
simple_api_command(socket, "PUT", "create", Some(&data)).map_err(Error::HttpApiClient)
|
|
}
|
|
SubCommandEnum::Version(_) => {
|
|
// Already handled outside of this function
|
|
panic!()
|
|
}
|
|
}
|
|
}
|
|
|
|
#[cfg(feature = "dbus_api")]
|
|
fn dbus_api_do_command(toplevel: &TopLevel, proxy: &DBusApi1ProxyBlocking<'_>) -> ApiResult {
|
|
match toplevel.command {
|
|
SubCommandEnum::Boot(_) => proxy.api_vm_boot(),
|
|
SubCommandEnum::Delete(_) => proxy.api_vm_delete(),
|
|
SubCommandEnum::ShutdownVmm(_) => proxy.api_vmm_shutdown(),
|
|
SubCommandEnum::Resume(_) => proxy.api_vm_resume(),
|
|
SubCommandEnum::PowerButton(_) => proxy.api_vm_power_button(),
|
|
SubCommandEnum::Reboot(_) => proxy.api_vm_reboot(),
|
|
SubCommandEnum::Pause(_) => proxy.api_vm_pause(),
|
|
SubCommandEnum::Info(_) => proxy.api_vm_info(),
|
|
SubCommandEnum::Counters(_) => proxy.api_vm_counters(),
|
|
SubCommandEnum::Ping(_) => proxy.api_vmm_ping(),
|
|
SubCommandEnum::Shutdown(_) => proxy.api_vm_shutdown(),
|
|
SubCommandEnum::Resize(ref config) => {
|
|
let resize = resize_config(config.cpus, &config.memory, &config.balloon)?;
|
|
proxy.api_vm_resize(&resize)
|
|
}
|
|
SubCommandEnum::ResizeZone(ref config) => {
|
|
let resize_zone = resize_zone_config(&config.id, &config.size)?;
|
|
proxy.api_vm_resize_zone(&resize_zone)
|
|
}
|
|
SubCommandEnum::AddDevice(ref config) => {
|
|
let device_config = add_device_config(&config.device_config)?;
|
|
proxy.api_vm_add_device(&device_config)
|
|
}
|
|
SubCommandEnum::RemoveDevice(ref config) => {
|
|
let remove_device_data = remove_device_config(&config.device_config);
|
|
proxy.api_vm_remove_device(&remove_device_data)
|
|
}
|
|
SubCommandEnum::AddDisk(ref config) => {
|
|
let disk_config = add_disk_config(&config.disk_config)?;
|
|
proxy.api_vm_add_disk(&disk_config)
|
|
}
|
|
SubCommandEnum::AddFs(ref config) => {
|
|
let fs_config = add_fs_config(&config.fs_config)?;
|
|
proxy.api_vm_add_fs(&fs_config)
|
|
}
|
|
SubCommandEnum::AddPmem(ref config) => {
|
|
let pmem_config = add_pmem_config(&config.pmem_config)?;
|
|
proxy.api_vm_add_pmem(&pmem_config)
|
|
}
|
|
SubCommandEnum::AddNet(ref config) => {
|
|
let (net_config, _fds) = add_net_config(&config.net_config)?;
|
|
proxy.api_vm_add_net(&net_config)
|
|
}
|
|
SubCommandEnum::AddUserDevice(ref config) => {
|
|
let device_config = add_user_device_config(&config.device_config)?;
|
|
proxy.api_vm_add_user_device(&device_config)
|
|
}
|
|
SubCommandEnum::AddVdpa(ref config) => {
|
|
let vdpa_config = add_vdpa_config(&config.vdpa_config)?;
|
|
proxy.api_vm_add_vdpa(&vdpa_config)
|
|
}
|
|
SubCommandEnum::AddVsock(ref config) => {
|
|
let vsock_config = add_vsock_config(&config.vsock_config)?;
|
|
proxy.api_vm_add_vsock(&vsock_config)
|
|
}
|
|
SubCommandEnum::Snapshot(ref config) => {
|
|
let snapshot_config = snapshot_api_config(&config.snapshot_config);
|
|
proxy.api_vm_snapshot(&snapshot_config)
|
|
}
|
|
SubCommandEnum::Restore(ref config) => {
|
|
let restore_config = restore_config(&config.restore_config)?;
|
|
proxy.api_vm_restore(&restore_config)
|
|
}
|
|
SubCommandEnum::Coredump(ref config) => {
|
|
let coredump_config = coredump_config(&config.coredump_config);
|
|
proxy.api_vm_coredump(&coredump_config)
|
|
}
|
|
SubCommandEnum::SendMigration(ref config) => {
|
|
let send_migration_data =
|
|
send_migration_data(&config.send_migration_config, config.send_migration_local);
|
|
proxy.api_vm_send_migration(&send_migration_data)
|
|
}
|
|
SubCommandEnum::ReceiveMigration(ref config) => {
|
|
let receive_migration_data = receive_migration_data(&config.receive_migration_config);
|
|
proxy.api_vm_receive_migration(&receive_migration_data)
|
|
}
|
|
SubCommandEnum::Create(ref config) => {
|
|
let data = create_data(&config.vm_config)?;
|
|
proxy.api_vm_create(&data)
|
|
}
|
|
SubCommandEnum::Version(_) => {
|
|
// Already handled outside of this function
|
|
panic!()
|
|
}
|
|
}
|
|
}
|
|
fn resize_config(
|
|
desired_vcpus: Option<u8>,
|
|
memory: &Option<String>,
|
|
balloon: &Option<String>,
|
|
) -> Result<String, Error> {
|
|
let desired_ram: Option<u64> = if let Some(memory) = memory {
|
|
Some(
|
|
memory
|
|
.parse::<ByteSized>()
|
|
.map_err(Error::InvalidMemorySize)?
|
|
.0,
|
|
)
|
|
} else {
|
|
None
|
|
};
|
|
|
|
let desired_balloon: Option<u64> = if let Some(balloon) = balloon {
|
|
Some(
|
|
balloon
|
|
.parse::<ByteSized>()
|
|
.map_err(Error::InvalidBalloonSize)?
|
|
.0,
|
|
)
|
|
} else {
|
|
None
|
|
};
|
|
|
|
let resize = vmm::api::VmResizeData {
|
|
desired_vcpus,
|
|
desired_ram,
|
|
desired_balloon,
|
|
};
|
|
|
|
Ok(serde_json::to_string(&resize).unwrap())
|
|
}
|
|
|
|
fn resize_zone_config(id: &str, size: &str) -> Result<String, Error> {
|
|
let resize_zone = vmm::api::VmResizeZoneData {
|
|
id: id.to_owned(),
|
|
desired_ram: size
|
|
.parse::<ByteSized>()
|
|
.map_err(Error::InvalidMemorySize)?
|
|
.0,
|
|
};
|
|
|
|
Ok(serde_json::to_string(&resize_zone).unwrap())
|
|
}
|
|
|
|
fn add_device_config(config: &str) -> Result<String, Error> {
|
|
let device_config = vmm::config::DeviceConfig::parse(config).map_err(Error::AddDeviceConfig)?;
|
|
let device_config = serde_json::to_string(&device_config).unwrap();
|
|
|
|
Ok(device_config)
|
|
}
|
|
|
|
fn add_user_device_config(config: &str) -> Result<String, Error> {
|
|
let device_config =
|
|
vmm::config::UserDeviceConfig::parse(config).map_err(Error::AddUserDeviceConfig)?;
|
|
let device_config = serde_json::to_string(&device_config).unwrap();
|
|
|
|
Ok(device_config)
|
|
}
|
|
|
|
fn remove_device_config(id: &str) -> String {
|
|
let remove_device_data = vmm::api::VmRemoveDeviceData { id: id.to_owned() };
|
|
|
|
serde_json::to_string(&remove_device_data).unwrap()
|
|
}
|
|
|
|
fn add_disk_config(config: &str) -> Result<String, Error> {
|
|
let disk_config = vmm::config::DiskConfig::parse(config).map_err(Error::AddDiskConfig)?;
|
|
let disk_config = serde_json::to_string(&disk_config).unwrap();
|
|
|
|
Ok(disk_config)
|
|
}
|
|
|
|
fn add_fs_config(config: &str) -> Result<String, Error> {
|
|
let fs_config = vmm::config::FsConfig::parse(config).map_err(Error::AddFsConfig)?;
|
|
let fs_config = serde_json::to_string(&fs_config).unwrap();
|
|
|
|
Ok(fs_config)
|
|
}
|
|
|
|
fn add_pmem_config(config: &str) -> Result<String, Error> {
|
|
let pmem_config = vmm::config::PmemConfig::parse(config).map_err(Error::AddPmemConfig)?;
|
|
let pmem_config = serde_json::to_string(&pmem_config).unwrap();
|
|
|
|
Ok(pmem_config)
|
|
}
|
|
|
|
fn add_net_config(config: &str) -> Result<(String, Vec<i32>), Error> {
|
|
let mut net_config = vmm::config::NetConfig::parse(config).map_err(Error::AddNetConfig)?;
|
|
|
|
// NetConfig is modified on purpose here by taking the list of file
|
|
// descriptors out. Keeping the list and send it to the server side
|
|
// process would not make any sense since the file descriptor may be
|
|
// represented with different values.
|
|
let fds = net_config.fds.take().unwrap_or_default();
|
|
let net_config = serde_json::to_string(&net_config).unwrap();
|
|
|
|
Ok((net_config, fds))
|
|
}
|
|
|
|
fn add_vdpa_config(config: &str) -> Result<String, Error> {
|
|
let vdpa_config = vmm::config::VdpaConfig::parse(config).map_err(Error::AddVdpaConfig)?;
|
|
let vdpa_config = serde_json::to_string(&vdpa_config).unwrap();
|
|
|
|
Ok(vdpa_config)
|
|
}
|
|
|
|
fn add_vsock_config(config: &str) -> Result<String, Error> {
|
|
let vsock_config = vmm::config::VsockConfig::parse(config).map_err(Error::AddVsockConfig)?;
|
|
let vsock_config = serde_json::to_string(&vsock_config).unwrap();
|
|
|
|
Ok(vsock_config)
|
|
}
|
|
|
|
fn snapshot_api_config(url: &str) -> String {
|
|
let snapshot_config = vmm::api::VmSnapshotConfig {
|
|
destination_url: String::from(url),
|
|
};
|
|
|
|
serde_json::to_string(&snapshot_config).unwrap()
|
|
}
|
|
|
|
fn restore_config(config: &str) -> Result<String, Error> {
|
|
let restore_config = vmm::config::RestoreConfig::parse(config).map_err(Error::Restore)?;
|
|
let restore_config = serde_json::to_string(&restore_config).unwrap();
|
|
|
|
Ok(restore_config)
|
|
}
|
|
|
|
fn coredump_config(destination_url: &str) -> String {
|
|
let coredump_config = vmm::api::VmCoredumpData {
|
|
destination_url: String::from(destination_url),
|
|
};
|
|
|
|
serde_json::to_string(&coredump_config).unwrap()
|
|
}
|
|
|
|
fn receive_migration_data(url: &str) -> String {
|
|
let receive_migration_data = vmm::api::VmReceiveMigrationData {
|
|
receiver_url: url.to_owned(),
|
|
};
|
|
|
|
serde_json::to_string(&receive_migration_data).unwrap()
|
|
}
|
|
|
|
fn send_migration_data(url: &str, local: bool) -> String {
|
|
let send_migration_data = vmm::api::VmSendMigrationData {
|
|
destination_url: url.to_owned(),
|
|
local,
|
|
};
|
|
|
|
serde_json::to_string(&send_migration_data).unwrap()
|
|
}
|
|
|
|
fn create_data(path: &str) -> Result<String, Error> {
|
|
let mut data = String::default();
|
|
if path == "-" {
|
|
std::io::stdin()
|
|
.read_to_string(&mut data)
|
|
.map_err(Error::ReadingStdin)?;
|
|
} else {
|
|
data = std::fs::read_to_string(path).map_err(Error::ReadingFile)?;
|
|
}
|
|
|
|
Ok(data)
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[doc = "Remotely control a cloud-hypervisor VMM.\n\nPlease refer to cloud-hypervisor for configuration syntaxes."]
|
|
struct TopLevel {
|
|
#[argh(subcommand)]
|
|
command: SubCommandEnum,
|
|
|
|
#[argh(option, long = "api-socket")]
|
|
/// HTTP API socket path (UNIX domain socket)
|
|
api_socket: Option<String>,
|
|
|
|
#[cfg(feature = "dbus_api")]
|
|
#[argh(option, long = "dbus-service-name")]
|
|
/// well known name of the dbus service
|
|
dbus_name: Option<String>,
|
|
|
|
#[cfg(feature = "dbus_api")]
|
|
#[argh(option, long = "dbus-object-path")]
|
|
/// object path which the interface is being served at
|
|
dbus_path: Option<String>,
|
|
|
|
#[cfg(feature = "dbus_api")]
|
|
#[argh(switch, long = "dbus-system-bus")]
|
|
/// use the system bus instead of a session bus
|
|
dbus_system_bus: bool,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand)]
|
|
enum SubCommandEnum {
|
|
AddDevice(AddDeviceSubcommand),
|
|
AddDisk(AddDiskSubcommand),
|
|
AddFs(AddFsSubcommand),
|
|
AddPmem(AddPmemSubcommand),
|
|
AddNet(AddNetSubcommand),
|
|
AddUserDevice(AddUserDeviceSubcommand),
|
|
AddVdpa(AddVdpaSubcommand),
|
|
AddVsock(AddVsockSubcommand),
|
|
RemoveDevice(RemoveDeviceSubcommand),
|
|
Info(InfoSubcommand),
|
|
Counters(CountersSubcommand),
|
|
Pause(PauseSubcommand),
|
|
Reboot(RebootSubcommand),
|
|
PowerButton(PowerButtonSubcommand),
|
|
Resume(ResumeSubcommand),
|
|
Boot(BootSubcommand),
|
|
Delete(DeleteSubcommand),
|
|
Shutdown(ShutdownSubcommand),
|
|
Ping(PingSubcommand),
|
|
ShutdownVmm(ShutdownVmmSubcommand),
|
|
Resize(ResizeSubcommand),
|
|
ResizeZone(ResizeZoneSubcommand),
|
|
Snapshot(SnapshotSubcommand),
|
|
Restore(RestoreSubcommand),
|
|
Coredump(CoredumpSubcommand),
|
|
SendMigration(SendMigrationSubcommand),
|
|
ReceiveMigration(ReceiveMigrationSubcommand),
|
|
Create(CreateSubcommand),
|
|
Version(VersionSubcommand),
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-device")]
|
|
/// Add VFIO device
|
|
struct AddDeviceSubcommand {
|
|
#[argh(positional)]
|
|
/// device config
|
|
device_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-disk")]
|
|
/// Add block device
|
|
struct AddDiskSubcommand {
|
|
#[argh(positional)]
|
|
/// disk config
|
|
disk_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-fs")]
|
|
/// Add virtio-fs backed fs device
|
|
struct AddFsSubcommand {
|
|
#[argh(positional)]
|
|
/// virtio-fs config
|
|
fs_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-pmem")]
|
|
/// Add virtio-fs backed fs device
|
|
struct AddPmemSubcommand {
|
|
#[argh(positional)]
|
|
/// pmem config
|
|
pmem_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-net")]
|
|
/// Add virtio-fs backed fs device
|
|
struct AddNetSubcommand {
|
|
#[argh(positional)]
|
|
/// net config
|
|
net_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-user-device")]
|
|
/// Add userspace device
|
|
struct AddUserDeviceSubcommand {
|
|
#[argh(positional)]
|
|
/// device config
|
|
device_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-vdpa")]
|
|
/// Add vdpa device
|
|
struct AddVdpaSubcommand {
|
|
#[argh(positional)]
|
|
/// vdpa config
|
|
vdpa_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "add-vsock")]
|
|
/// Add vsock device
|
|
struct AddVsockSubcommand {
|
|
#[argh(positional)]
|
|
/// vsock config
|
|
vsock_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "remove-device")]
|
|
/// Remove VFIO device
|
|
struct RemoveDeviceSubcommand {
|
|
#[argh(positional)]
|
|
/// device config
|
|
device_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "info")]
|
|
/// Information on the VM
|
|
struct InfoSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "counters")]
|
|
/// Counters from the VM
|
|
struct CountersSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "pause")]
|
|
/// Pause the VM
|
|
struct PauseSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "reboot")]
|
|
/// Reboot the VM
|
|
struct RebootSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "power-button")]
|
|
/// Trigger a power button in the VM
|
|
struct PowerButtonSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "resume")]
|
|
/// Resume the VM
|
|
struct ResumeSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "boot")]
|
|
/// Boot a created VM
|
|
struct BootSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "delete")]
|
|
/// Delete a VM
|
|
struct DeleteSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "shutdown")]
|
|
/// Shutdown a VM
|
|
struct ShutdownSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "ping")]
|
|
/// Ping the VMM to check for API server availability
|
|
struct PingSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "shutdown-vmm")]
|
|
/// Shutdown the VMM
|
|
struct ShutdownVmmSubcommand {}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "resize")]
|
|
/// Resize the VM
|
|
struct ResizeSubcommand {
|
|
#[argh(option, long = "cpus")]
|
|
/// new VCPUs count
|
|
cpus: Option<u8>,
|
|
|
|
#[argh(option, long = "memory")]
|
|
/// new memory size in bytes (supports K/M/G suffix)"
|
|
memory: Option<String>,
|
|
|
|
#[argh(option, long = "balloon")]
|
|
/// new balloon size in bytes (supports K/M/G suffix)"
|
|
balloon: Option<String>,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "resize-zone")]
|
|
/// Resize a memory zone
|
|
struct ResizeZoneSubcommand {
|
|
#[argh(option, long = "id")]
|
|
/// memory zone identifier
|
|
id: String,
|
|
|
|
#[argh(option, long = "size")]
|
|
/// new memory size in bytes (supports K/M/G suffix)"
|
|
size: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "snapshot")]
|
|
/// Create a snapshot from VM
|
|
struct SnapshotSubcommand {
|
|
#[argh(positional)]
|
|
/// destination_url
|
|
snapshot_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "restore")]
|
|
/// Restore VM from a snapshot
|
|
struct RestoreSubcommand {
|
|
#[argh(positional)]
|
|
/// restore config
|
|
restore_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "coredump")]
|
|
/// Create a coredump from VM
|
|
struct CoredumpSubcommand {
|
|
#[argh(positional)]
|
|
/// coredump config
|
|
coredump_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "send-migration")]
|
|
/// Initiate a VM migration
|
|
struct SendMigrationSubcommand {
|
|
#[argh(switch, long = "local")]
|
|
/// local migration
|
|
send_migration_local: bool,
|
|
|
|
#[argh(positional)]
|
|
/// destination_url
|
|
send_migration_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "receive-migration")]
|
|
/// Receive a VM migration
|
|
struct ReceiveMigrationSubcommand {
|
|
#[argh(positional)]
|
|
/// receiver url
|
|
receive_migration_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "create")]
|
|
/// Create a VM from a JSON configuration
|
|
struct CreateSubcommand {
|
|
#[argh(positional, default = "String::from(\"-\")")]
|
|
/// vm config
|
|
vm_config: String,
|
|
}
|
|
|
|
#[derive(FromArgs, PartialEq, Debug)]
|
|
#[argh(subcommand, name = "version")]
|
|
/// Print version information
|
|
struct VersionSubcommand {}
|
|
|
|
fn main() {
|
|
let toplevel: TopLevel = argh::from_env();
|
|
|
|
if matches!(toplevel.command, SubCommandEnum::Version(_)) {
|
|
println!("{} {}", env!("CARGO_BIN_NAME"), env!("BUILD_VERSION"));
|
|
return;
|
|
}
|
|
|
|
let mut target_api = match (
|
|
&toplevel.api_socket,
|
|
#[cfg(feature = "dbus_api")]
|
|
&toplevel.dbus_name,
|
|
#[cfg(feature = "dbus_api")]
|
|
&toplevel.dbus_path,
|
|
) {
|
|
#[cfg(not(feature = "dbus_api"))]
|
|
(Some(ref api_socket),) => TargetApi::HttpApi(
|
|
UnixStream::connect(api_socket).unwrap_or_else(|e| {
|
|
eprintln!("Error opening HTTP socket: {e}");
|
|
process::exit(1)
|
|
}),
|
|
PhantomData,
|
|
),
|
|
#[cfg(feature = "dbus_api")]
|
|
(Some(ref api_socket), None, None) => TargetApi::HttpApi(
|
|
UnixStream::connect(api_socket).unwrap_or_else(|e| {
|
|
eprintln!("Error opening HTTP socket: {e}");
|
|
process::exit(1)
|
|
}),
|
|
PhantomData,
|
|
),
|
|
#[cfg(feature = "dbus_api")]
|
|
(None, Some(ref dbus_name), Some(ref dbus_path)) => TargetApi::DBusApi(
|
|
DBusApi1ProxyBlocking::new_connection(dbus_name, dbus_path, toplevel.dbus_system_bus)
|
|
.map_err(Error::DBusApiClient)
|
|
.unwrap_or_else(|e| {
|
|
eprintln!("Error creating D-Bus proxy: {e}");
|
|
process::exit(1)
|
|
}),
|
|
),
|
|
#[cfg(feature = "dbus_api")]
|
|
(Some(_), Some(_) | None, Some(_) | None) => {
|
|
println!(
|
|
"`api-socket` and (dbus-service-name or dbus-object-path) are mutually exclusive"
|
|
);
|
|
process::exit(1);
|
|
}
|
|
_ => {
|
|
println!("Please either provide the api-socket option or dbus-service-name and dbus-object-path options");
|
|
process::exit(1);
|
|
}
|
|
};
|
|
|
|
if let Err(e) = target_api.do_command(&toplevel) {
|
|
eprintln!("Error running command: {e}");
|
|
process::exit(1)
|
|
};
|
|
}
|