1 package PVE
::QemuServer
;
11 use File
::Copy
qw(copy);
24 use Storable
qw(dclone);
25 use Time
::HiRes
qw(gettimeofday);
29 use PVE
::Cluster
qw(cfs_register_file cfs_read_file cfs_write_file cfs_lock_file);
30 use PVE
::DataCenterConfig
;
31 use PVE
::Exception
qw(raise raise_param_exc);
32 use PVE
::GuestHelpers
;
34 use PVE
::JSONSchema
qw(get_standard_option);
36 use PVE
::RPCEnvironment
;
40 use PVE
::Tools
qw(run_command lock_file lock_file_full file_read_firstline file_get_contents dir_glob_foreach get_host_arch $IPV6RE);
44 use PVE
::QemuServer
::Helpers
qw(min_version config_aware_timeout);
45 use PVE
::QemuServer
::Cloudinit
;
46 use PVE
::QemuServer
::CPUConfig
qw(print_cpu_device get_cpu_options);
47 use PVE
::QemuServer
::Machine
;
48 use PVE
::QemuServer
::Memory
;
49 use PVE
::QemuServer
::Monitor
qw(mon_cmd);
50 use PVE
::QemuServer
::PCI
qw(print_pci_addr print_pcie_addr print_pcie_root_port);
51 use PVE
::QemuServer
::USB
qw(parse_usb_device);
53 my $EDK2_FW_BASE = '/usr/share/pve-edk2-firmware/';
56 "$EDK2_FW_BASE/OVMF_CODE.fd",
57 "$EDK2_FW_BASE/OVMF_VARS.fd"
60 "$EDK2_FW_BASE/AAVMF_CODE.fd",
61 "$EDK2_FW_BASE/AAVMF_VARS.fd"
65 my $cpuinfo = PVE
::ProcFSTools
::read_cpuinfo
();
67 my $QEMU_FORMAT_RE = qr/raw|cow|qcow|qcow2|qed|vmdk|cloop/;
69 # Note about locking: we use flock on the config file protect
70 # against concurent actions.
71 # Aditionaly, we have a 'lock' setting in the config file. This
72 # can be set to 'migrate', 'backup', 'snapshot' or 'rollback'. Most actions are not
73 # allowed when such lock is set. But you can ignore this kind of
74 # lock with the --skiplock flag.
76 cfs_register_file
('/qemu-server/',
80 PVE
::JSONSchema
::register_standard_option
('pve-qm-stateuri', {
81 description
=> "Some command save/restore state from this location.",
87 PVE
::JSONSchema
::register_standard_option
('pve-qm-image-format', {
89 enum
=> [qw(raw cow qcow qed qcow2 vmdk cloop)],
90 description
=> "The drive's backing file's data format.",
94 PVE
::JSONSchema
::register_standard_option
('pve-qemu-machine', {
95 description
=> "Specifies the Qemu machine type.",
97 pattern
=> '(pc|pc(-i440fx)?-\d+(\.\d+)+(\+pve\d+)?(\.pxe)?|q35|pc-q35-\d+(\.\d+)+(\+pve\d+)?(\.pxe)?|virt(?:-\d+(\.\d+)+)?(\+pve\d+)?)',
102 #no warnings 'redefine';
105 my ($controller, $vmid, $option, $value) = @_;
107 my $path = "/sys/fs/cgroup/$controller/qemu.slice/$vmid.scope/$option";
108 PVE
::ProcFSTools
::write_proc_entry
($path, $value);
114 $nodename_cache //= PVE
::INotify
::nodename
();
115 return $nodename_cache;
122 enum
=> [qw(i6300esb ib700)],
123 description
=> "Watchdog type to emulate.",
124 default => 'i6300esb',
129 enum
=> [qw(reset shutdown poweroff pause debug none)],
130 description
=> "The action to perform if after activation the guest fails to poll the watchdog in time.",
134 PVE
::JSONSchema
::register_format
('pve-qm-watchdog', $watchdog_fmt);
138 description
=> "Enable/disable Qemu GuestAgent.",
143 fstrim_cloned_disks
=> {
144 description
=> "Run fstrim after cloning/moving a disk.",
150 description
=> "Select the agent type",
154 enum
=> [qw(virtio isa)],
160 description
=> "Select the VGA type.",
165 enum
=> [qw(cirrus qxl qxl2 qxl3 qxl4 none serial0 serial1 serial2 serial3 std virtio vmware)],
168 description
=> "Sets the VGA memory (in MiB). Has no effect with serial display.",
180 description
=> "The size of the file in MB.",
184 pattern
=> '[a-zA-Z0-9\-]+',
186 format_description
=> 'string',
187 description
=> "The name of the file. Will be prefixed with 'pve-shm-'. Default is the VMID. Will be deleted when the VM is stopped.",
194 enum
=> [qw(ich9-intel-hda intel-hda AC97)],
195 description
=> "Configure an audio device."
202 description
=> "Driver backend for the audio device."
206 my $spice_enhancements_fmt = {
211 description
=> "Enable folder sharing via SPICE. Needs Spice-WebDAV daemon installed in the VM."
215 enum
=> ['off', 'all', 'filter'],
218 description
=> "Enable video streaming. Uses compression for detected video streams."
226 description
=> "Specifies whether a VM will be started during system bootup.",
232 description
=> "Automatic restart after crash (currently ignored).",
237 type
=> 'string', format
=> 'pve-hotplug-features',
238 description
=> "Selectively enable hotplug features. This is a comma separated list of hotplug features: 'network', 'disk', 'cpu', 'memory' and 'usb'. Use '0' to disable hotplug completely. Value '1' is an alias for the default 'network,disk,usb'.",
239 default => 'network,disk,usb',
244 description
=> "Allow reboot. If set to '0' the VM exit on reboot.",
250 description
=> "Lock/unlock the VM.",
251 enum
=> [qw(backup clone create migrate rollback snapshot snapshot-delete suspending suspended)],
256 description
=> "Limit of CPU usage.",
257 verbose_description
=> "Limit of CPU usage.\n\nNOTE: If the computer has 2 CPUs, it has total of '2' CPU time. Value '0' indicates no CPU limit.",
265 description
=> "CPU weight for a VM.",
266 verbose_description
=> "CPU weight for a VM. Argument is used in the kernel fair scheduler. The larger the number is, the more CPU time this VM gets. Number is relative to weights of all the other running VMs.",
274 description
=> "Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.",
281 description
=> "Amount of target RAM for the VM in MB. Using zero disables the ballon driver.",
287 description
=> "Amount of memory shares for auto-ballooning. The larger the number is, the more memory this VM gets. Number is relative to weights of all other running VMs. Using zero disables auto-ballooning. Auto-ballooning is done by pvestatd.",
295 description
=> "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.".
296 "It should not be necessary to set it.",
297 enum
=> PVE
::Tools
::kvmkeymaplist
(),
302 type
=> 'string', format
=> 'dns-name',
303 description
=> "Set a name for the VM. Only used on the configuration web interface.",
308 description
=> "SCSI controller model",
309 enum
=> [qw(lsi lsi53c810 virtio-scsi-pci virtio-scsi-single megasas pvscsi)],
315 description
=> "Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.",
320 enum
=> [qw(other wxp w2k w2k3 w2k8 wvista win7 win8 win10 l24 l26 solaris)],
321 description
=> "Specify guest operating system.",
322 verbose_description
=> <<EODESC,
323 Specify guest operating system. This is used to enable special
324 optimization/features for specific operating systems:
327 other;; unspecified OS
328 wxp;; Microsoft Windows XP
329 w2k;; Microsoft Windows 2000
330 w2k3;; Microsoft Windows 2003
331 w2k8;; Microsoft Windows 2008
332 wvista;; Microsoft Windows Vista
333 win7;; Microsoft Windows 7
334 win8;; Microsoft Windows 8/2012/2012r2
335 win10;; Microsoft Windows 10/2016
336 l24;; Linux 2.4 Kernel
337 l26;; Linux 2.6 - 5.X Kernel
338 solaris;; Solaris/OpenSolaris/OpenIndiania kernel
344 description
=> "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).",
345 pattern
=> '[acdn]{1,4}',
350 type
=> 'string', format
=> 'pve-qm-bootdisk',
351 description
=> "Enable booting from specified disk.",
352 pattern
=> '(ide|sata|scsi|virtio)\d+',
357 description
=> "The number of CPUs. Please use option -sockets instead.",
364 description
=> "The number of CPU sockets.",
371 description
=> "The number of cores per socket.",
378 description
=> "Enable/disable NUMA.",
384 description
=> "Enable/disable hugepages memory.",
385 enum
=> [qw(any 2 1024)],
390 description
=> "Number of hotplugged vcpus.",
397 description
=> "Enable/disable ACPI.",
402 description
=> "Enable/disable Qemu GuestAgent and its properties.",
404 format
=> $agent_fmt,
409 description
=> "Enable/disable KVM hardware virtualization.",
415 description
=> "Enable/disable time drift fix.",
421 description
=> "Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.",
426 description
=> "Freeze CPU at startup (use 'c' monitor command to start execution).",
430 type
=> 'string', format
=> $vga_fmt,
431 description
=> "Configure the VGA hardware.",
432 verbose_description
=> "Configure the VGA Hardware. If you want to use ".
433 "high resolution modes (>= 1280x1024x16) you may need to increase " .
434 "the vga memory option. Since QEMU 2.9 the default VGA display type " .
435 "is 'std' for all OS types besides some Windows versions (XP and " .
436 "older) which use 'cirrus'. The 'qxl' option enables the SPICE " .
437 "display server. For win* OS you can select how many independent " .
438 "displays you want, Linux guests can add displays them self.\n".
439 "You can also run without any graphic card, using a serial device as terminal.",
443 type
=> 'string', format
=> 'pve-qm-watchdog',
444 description
=> "Create a virtual hardware watchdog device.",
445 verbose_description
=> "Create a virtual hardware watchdog device. Once enabled" .
446 " (by a guest action), the watchdog must be periodically polled " .
447 "by an agent inside the guest or else the watchdog will reset " .
448 "the guest (or execute the respective action specified)",
453 typetext
=> "(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)",
454 description
=> "Set the initial date of the real time clock. Valid format for date are: 'now' or '2006-06-17T16:01:21' or '2006-06-17'.",
455 pattern
=> '(now|\d{4}-\d{1,2}-\d{1,2}(T\d{1,2}:\d{1,2}:\d{1,2})?)',
458 startup
=> get_standard_option
('pve-startup-order'),
462 description
=> "Enable/disable Template.",
468 description
=> "Arbitrary arguments passed to kvm.",
469 verbose_description
=> <<EODESCR,
470 Arbitrary arguments passed to kvm, for example:
472 args: -no-reboot -no-hpet
474 NOTE: this option is for experts only.
481 description
=> "Enable/disable the USB tablet device.",
482 verbose_description
=> "Enable/disable the USB tablet device. This device is " .
483 "usually needed to allow absolute mouse positioning with VNC. " .
484 "Else the mouse runs out of sync with normal VNC clients. " .
485 "If you're running lots of console-only guests on one host, " .
486 "you may consider disabling this to save some context switches. " .
487 "This is turned off by default if you use spice (-vga=qxl).",
492 description
=> "Set maximum speed (in MB/s) for migrations. Value 0 is no limit.",
496 migrate_downtime
=> {
499 description
=> "Set maximum tolerated downtime (in seconds) for migrations.",
505 type
=> 'string', format
=> 'pve-qm-ide',
506 typetext
=> '<volume>',
507 description
=> "This is an alias for option -ide2",
511 description
=> "Emulated CPU type.",
513 format
=> $PVE::QemuServer
::CPUConfig
::cpu_fmt
,
515 parent
=> get_standard_option
('pve-snapshot-name', {
517 description
=> "Parent snapshot name. This is used internally, and should not be modified.",
521 description
=> "Timestamp for snapshots.",
527 type
=> 'string', format
=> 'pve-volume-id',
528 description
=> "Reference to a volume which stores the VM state. This is used internally for snapshots.",
530 vmstatestorage
=> get_standard_option
('pve-storage-id', {
531 description
=> "Default storage for VM state volumes/files.",
534 runningmachine
=> get_standard_option
('pve-qemu-machine', {
535 description
=> "Specifies the Qemu machine type of the running vm. This is used internally for snapshots.",
537 machine
=> get_standard_option
('pve-qemu-machine'),
539 description
=> "Virtual processor architecture. Defaults to the host.",
542 enum
=> [qw(x86_64 aarch64)],
545 description
=> "Specify SMBIOS type 1 fields.",
546 type
=> 'string', format
=> 'pve-qm-smbios1',
553 description
=> "Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.",
559 enum
=> [ qw(seabios ovmf) ],
560 description
=> "Select BIOS implementation.",
561 default => 'seabios',
565 pattern
=> '(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])',
566 format_description
=> 'UUID',
567 description
=> "Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.",
568 verbose_description
=> "The VM generation ID (vmgenid) device exposes a".
569 " 128-bit integer value identifier to the guest OS. This allows to".
570 " notify the guest operating system when the virtual machine is".
571 " executed with a different configuration (e.g. snapshot execution".
572 " or creation from a template). The guest operating system notices".
573 " the change, and is then able to react as appropriate by marking".
574 " its copies of distributed databases as dirty, re-initializing its".
575 " random number generator, etc.\n".
576 "Note that auto-creation only works when done throug API/CLI create".
577 " or update methods, but not when manually editing the config file.",
578 default => "1 (autogenerated)",
583 format
=> 'pve-volume-id',
585 description
=> "Script that will be executed during various steps in the vms lifetime.",
589 format
=> $ivshmem_fmt,
590 description
=> "Inter-VM shared memory. Useful for direct communication between VMs, or to the host.",
595 format
=> $audio_fmt,
596 description
=> "Configure a audio device, useful in combination with QXL/Spice.",
599 spice_enhancements
=> {
601 format
=> $spice_enhancements_fmt,
602 description
=> "Configure additional enhancements for SPICE.",
606 type
=> 'string', format
=> 'pve-tag-list',
607 description
=> 'Tags of the VM. This is only meta information.',
616 description
=> 'Specify a custom file containing all meta data passed to the VM via cloud-init. This is provider specific meaning configdrive2 and nocloud differ.',
617 format
=> 'pve-volume-id',
618 format_description
=> 'volume',
623 description
=> 'Specify a custom file containing all network data passed to the VM via cloud-init.',
624 format
=> 'pve-volume-id',
625 format_description
=> 'volume',
630 description
=> 'Specify a custom file containing all user data passed to the VM via cloud-init.',
631 format
=> 'pve-volume-id',
632 format_description
=> 'volume',
635 PVE
::JSONSchema
::register_format
('pve-qm-cicustom', $cicustom_fmt);
637 my $confdesc_cloudinit = {
641 description
=> 'Specifies the cloud-init configuration format. The default depends on the configured operating system type (`ostype`. We use the `nocloud` format for Linux, and `configdrive2` for windows.',
642 enum
=> ['configdrive2', 'nocloud'],
647 description
=> "cloud-init: User name to change ssh keys and password for instead of the image's configured default user.",
652 description
=> 'cloud-init: Password to assign the user. Using this is generally not recommended. Use ssh keys instead. Also note that older cloud-init versions do not support hashed passwords.',
657 description
=> 'cloud-init: Specify custom files to replace the automatically generated ones at start.',
658 format
=> 'pve-qm-cicustom',
663 description
=> "cloud-init: Sets DNS search domains for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.",
667 type
=> 'string', format
=> 'address-list',
668 description
=> "cloud-init: Sets DNS server IP address for a container. Create will automatically use the setting from the host if neither searchdomain nor nameserver are set.",
673 format
=> 'urlencoded',
674 description
=> "cloud-init: Setup public SSH keys (one key per line, OpenSSH format).",
678 # what about other qemu settings ?
680 #machine => 'string',
693 ##soundhw => 'string',
695 while (my ($k, $v) = each %$confdesc) {
696 PVE
::JSONSchema
::register_standard_option
("pve-qm-$k", $v);
699 my $MAX_IDE_DISKS = 4;
700 my $MAX_SCSI_DISKS = 14;
701 my $MAX_VIRTIO_DISKS = 16;
702 my $MAX_SATA_DISKS = 6;
703 my $MAX_USB_DEVICES = 5;
705 my $MAX_UNUSED_DISKS = 256;
706 my $MAX_HOSTPCI_DEVICES = 16;
707 my $MAX_SERIAL_PORTS = 4;
708 my $MAX_PARALLEL_PORTS = 3;
714 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
715 description
=> "CPUs accessing this NUMA node.",
716 format_description
=> "id[-id];...",
720 description
=> "Amount of memory this NUMA node provides.",
725 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
726 description
=> "Host NUMA nodes to use.",
727 format_description
=> "id[-id];...",
732 enum
=> [qw(preferred bind interleave)],
733 description
=> "NUMA allocation policy.",
737 PVE
::JSONSchema
::register_format
('pve-qm-numanode', $numa_fmt);
740 type
=> 'string', format
=> $numa_fmt,
741 description
=> "NUMA topology.",
743 PVE
::JSONSchema
::register_standard_option
("pve-qm-numanode", $numadesc);
745 for (my $i = 0; $i < $MAX_NUMA; $i++) {
746 $confdesc->{"numa$i"} = $numadesc;
749 my $nic_model_list = ['rtl8139', 'ne2k_pci', 'e1000', 'pcnet', 'virtio',
750 'ne2k_isa', 'i82551', 'i82557b', 'i82559er', 'vmxnet3',
751 'e1000-82540em', 'e1000-82544gc', 'e1000-82545em'];
752 my $nic_model_list_txt = join(' ', sort @$nic_model_list);
754 my $net_fmt_bridge_descr = <<__EOD__;
755 Bridge to attach the network device to. The Proxmox VE standard bridge
758 If you do not specify a bridge, we create a kvm user (NATed) network
759 device, which provides DHCP and DNS services. The following addresses
766 The DHCP server assign addresses to the guest starting from 10.0.2.15.
770 macaddr
=> get_standard_option
('mac-addr', {
771 description
=> "MAC address. That address must be unique withing your network. This is automatically generated if not specified.",
775 description
=> "Network Card Model. The 'virtio' model provides the best performance with very low CPU overhead. If your guest does not support this driver, it is usually best to use 'e1000'.",
776 enum
=> $nic_model_list,
779 (map { $_ => { keyAlias
=> 'model', alias
=> 'macaddr' }} @$nic_model_list),
782 description
=> $net_fmt_bridge_descr,
783 format_description
=> 'bridge',
788 minimum
=> 0, maximum
=> 16,
789 description
=> 'Number of packet queues to be used on the device.',
795 description
=> "Rate limit in mbps (megabytes per second) as floating point number.",
800 minimum
=> 1, maximum
=> 4094,
801 description
=> 'VLAN tag to apply to packets on this interface.',
806 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
807 description
=> 'VLAN trunks to pass through this interface.',
808 format_description
=> 'vlanid[;vlanid...]',
813 description
=> 'Whether this interface should be protected by the firewall.',
818 description
=> 'Whether this interface should be disconnected (like pulling the plug).',
825 type
=> 'string', format
=> $net_fmt,
826 description
=> "Specify network devices.",
829 PVE
::JSONSchema
::register_standard_option
("pve-qm-net", $netdesc);
834 format
=> 'pve-ipv4-config',
835 format_description
=> 'IPv4Format/CIDR',
836 description
=> 'IPv4 address in CIDR format.',
843 format_description
=> 'GatewayIPv4',
844 description
=> 'Default gateway for IPv4 traffic.',
850 format
=> 'pve-ipv6-config',
851 format_description
=> 'IPv6Format/CIDR',
852 description
=> 'IPv6 address in CIDR format.',
859 format_description
=> 'GatewayIPv6',
860 description
=> 'Default gateway for IPv6 traffic.',
865 PVE
::JSONSchema
::register_format
('pve-qm-ipconfig', $ipconfig_fmt);
868 type
=> 'string', format
=> 'pve-qm-ipconfig',
869 description
=> <<'EODESCR',
870 cloud-init: Specify IP addresses and gateways for the corresponding interface.
872 IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
874 The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
875 For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
877 If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
880 PVE
::JSONSchema
::register_standard_option
("pve-qm-ipconfig", $netdesc);
882 for (my $i = 0; $i < $MAX_NETS; $i++) {
883 $confdesc->{"net$i"} = $netdesc;
884 $confdesc_cloudinit->{"ipconfig$i"} = $ipconfigdesc;
887 foreach my $key (keys %$confdesc_cloudinit) {
888 $confdesc->{$key} = $confdesc_cloudinit->{$key};
891 PVE
::JSONSchema
::register_format
('pve-volume-id-or-qm-path', \
&verify_volume_id_or_qm_path
);
892 sub verify_volume_id_or_qm_path
{
893 my ($volid, $noerr) = @_;
895 if ($volid eq 'none' || $volid eq 'cdrom' || $volid =~ m
|^/|) {
899 # if its neither 'none' nor 'cdrom' nor a path, check if its a volume-id
900 $volid = eval { PVE
::JSONSchema
::check_format
('pve-volume-id', $volid, '') };
902 return undef if $noerr;
910 my %drivedesc_base = (
911 volume
=> { alias
=> 'file' },
914 format
=> 'pve-volume-id-or-qm-path',
916 format_description
=> 'volume',
917 description
=> "The drive's backing volume.",
921 enum
=> [qw(cdrom disk)],
922 description
=> "The drive's media type.",
928 description
=> "Force the drive's physical geometry to have a specific cylinder count.",
933 description
=> "Force the drive's physical geometry to have a specific head count.",
938 description
=> "Force the drive's physical geometry to have a specific sector count.",
943 enum
=> [qw(none lba auto)],
944 description
=> "Force disk geometry bios translation mode.",
949 description
=> "Controls qemu's snapshot mode feature."
950 . " If activated, changes made to the disk are temporary and will"
951 . " be discarded when the VM is shutdown.",
956 enum
=> [qw(none writethrough writeback unsafe directsync)],
957 description
=> "The drive's cache mode",
960 format
=> get_standard_option
('pve-qm-image-format'),
963 format
=> 'disk-size',
964 format_description
=> 'DiskSize',
965 description
=> "Disk size. This is purely informational and has no effect.",
970 description
=> "Whether the drive should be included when making backups.",
975 description
=> 'Whether the drive should considered for replication jobs.',
981 enum
=> [qw(ignore report stop)],
982 description
=> 'Read error action.',
987 enum
=> [qw(enospc ignore report stop)],
988 description
=> 'Write error action.',
993 enum
=> [qw(native threads)],
994 description
=> 'AIO type to use.',
999 enum
=> [qw(ignore on)],
1000 description
=> 'Controls whether to pass discard/trim requests to the underlying storage.',
1005 description
=> 'Controls whether to detect and try to optimize writes of zeroes.',
1010 format
=> 'urlencoded',
1011 format_description
=> 'serial',
1012 maxLength
=> 20*3, # *3 since it's %xx url enoded
1013 description
=> "The drive's reported serial number, url-encoded, up to 20 bytes long.",
1018 description
=> 'Mark this locally-managed volume as available on all nodes',
1019 verbose_description
=> "Mark this locally-managed volume as available on all nodes.\n\nWARNING: This option does not share the volume automatically, it assumes it is shared already!",
1025 my %iothread_fmt = ( iothread
=> {
1027 description
=> "Whether to use iothreads for this drive",
1034 format
=> 'urlencoded',
1035 format_description
=> 'model',
1036 maxLength
=> 40*3, # *3 since it's %xx url enoded
1037 description
=> "The drive's reported model name, url-encoded, up to 40 bytes long.",
1045 description
=> "Number of queues.",
1051 my %scsiblock_fmt = (
1054 description
=> "whether to use scsi-block for full passthrough of host block device\n\nWARNING: can lead to I/O errors in combination with low memory or high memory fragmentation on host",
1063 description
=> "Whether to expose this drive as an SSD, rather than a rotational hard disk.",
1071 pattern
=> qr/^(0x)[0-9a-fA-F]{16}/,
1072 format_description
=> 'wwn',
1073 description
=> "The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.",
1078 my $add_throttle_desc = sub {
1079 my ($key, $type, $what, $unit, $longunit, $minimum) = @_;
1082 format_description
=> $unit,
1083 description
=> "Maximum $what in $longunit.",
1086 $d->{minimum
} = $minimum if defined($minimum);
1087 $drivedesc_base{$key} = $d;
1089 # throughput: (leaky bucket)
1090 $add_throttle_desc->('bps', 'integer', 'r/w speed', 'bps', 'bytes per second');
1091 $add_throttle_desc->('bps_rd', 'integer', 'read speed', 'bps', 'bytes per second');
1092 $add_throttle_desc->('bps_wr', 'integer', 'write speed', 'bps', 'bytes per second');
1093 $add_throttle_desc->('mbps', 'number', 'r/w speed', 'mbps', 'megabytes per second');
1094 $add_throttle_desc->('mbps_rd', 'number', 'read speed', 'mbps', 'megabytes per second');
1095 $add_throttle_desc->('mbps_wr', 'number', 'write speed', 'mbps', 'megabytes per second');
1096 $add_throttle_desc->('iops', 'integer', 'r/w I/O', 'iops', 'operations per second');
1097 $add_throttle_desc->('iops_rd', 'integer', 'read I/O', 'iops', 'operations per second');
1098 $add_throttle_desc->('iops_wr', 'integer', 'write I/O', 'iops', 'operations per second');
1100 # pools: (pool of IO before throttling starts taking effect)
1101 $add_throttle_desc->('mbps_max', 'number', 'unthrottled r/w pool', 'mbps', 'megabytes per second');
1102 $add_throttle_desc->('mbps_rd_max', 'number', 'unthrottled read pool', 'mbps', 'megabytes per second');
1103 $add_throttle_desc->('mbps_wr_max', 'number', 'unthrottled write pool', 'mbps', 'megabytes per second');
1104 $add_throttle_desc->('iops_max', 'integer', 'unthrottled r/w I/O pool', 'iops', 'operations per second');
1105 $add_throttle_desc->('iops_rd_max', 'integer', 'unthrottled read I/O pool', 'iops', 'operations per second');
1106 $add_throttle_desc->('iops_wr_max', 'integer', 'unthrottled write I/O pool', 'iops', 'operations per second');
1109 $add_throttle_desc->('bps_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1110 $add_throttle_desc->('bps_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1111 $add_throttle_desc->('bps_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1112 $add_throttle_desc->('iops_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1113 $add_throttle_desc->('iops_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1114 $add_throttle_desc->('iops_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1117 $drivedesc_base{'bps_rd_length'} = { alias
=> 'bps_rd_max_length' };
1118 $drivedesc_base{'bps_wr_length'} = { alias
=> 'bps_wr_max_length' };
1119 $drivedesc_base{'iops_rd_length'} = { alias
=> 'iops_rd_max_length' };
1120 $drivedesc_base{'iops_wr_length'} = { alias
=> 'iops_wr_max_length' };
1128 PVE
::JSONSchema
::register_format
("pve-qm-ide", $ide_fmt);
1132 type
=> 'string', format
=> $ide_fmt,
1133 description
=> "Use volume as IDE hard disk or CD-ROM (n is 0 to " .($MAX_IDE_DISKS -1) . ").",
1135 PVE
::JSONSchema
::register_standard_option
("pve-qm-ide", $idedesc);
1147 type
=> 'string', format
=> $scsi_fmt,
1148 description
=> "Use volume as SCSI hard disk or CD-ROM (n is 0 to " . ($MAX_SCSI_DISKS - 1) . ").",
1150 PVE
::JSONSchema
::register_standard_option
("pve-qm-scsi", $scsidesc);
1159 type
=> 'string', format
=> $sata_fmt,
1160 description
=> "Use volume as SATA hard disk or CD-ROM (n is 0 to " . ($MAX_SATA_DISKS - 1). ").",
1162 PVE
::JSONSchema
::register_standard_option
("pve-qm-sata", $satadesc);
1170 type
=> 'string', format
=> $virtio_fmt,
1171 description
=> "Use volume as VIRTIO hard disk (n is 0 to " . ($MAX_VIRTIO_DISKS - 1) . ").",
1173 PVE
::JSONSchema
::register_standard_option
("pve-qm-virtio", $virtiodesc);
1175 my $alldrive_fmt = {
1186 volume
=> { alias
=> 'file' },
1189 format
=> 'pve-volume-id-or-qm-path',
1191 format_description
=> 'volume',
1192 description
=> "The drive's backing volume.",
1194 format
=> get_standard_option
('pve-qm-image-format'),
1197 format
=> 'disk-size',
1198 format_description
=> 'DiskSize',
1199 description
=> "Disk size. This is purely informational and has no effect.",
1204 my $efidisk_desc = {
1206 type
=> 'string', format
=> $efidisk_fmt,
1207 description
=> "Configure a Disk for storing EFI vars",
1210 PVE
::JSONSchema
::register_standard_option
("pve-qm-efidisk", $efidisk_desc);
1215 type
=> 'string', format
=> 'pve-qm-usb-device',
1216 format_description
=> 'HOSTUSBDEVICE|spice',
1217 description
=> <<EODESCR,
1218 The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:
1220 'bus-port(.port)*' (decimal numbers) or
1221 'vendor_id:product_id' (hexadeciaml numbers) or
1224 You can use the 'lsusb -t' command to list existing usb devices.
1226 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1228 The value 'spice' can be used to add a usb redirection devices for spice.
1234 description
=> "Specifies whether if given host option is a USB3 device or port.",
1241 type
=> 'string', format
=> $usb_fmt,
1242 description
=> "Configure an USB device (n is 0 to 4).",
1244 PVE
::JSONSchema
::register_standard_option
("pve-qm-usb", $usbdesc);
1246 my $PCIRE = qr/([a-f0-9]{4}:)?[a-f0-9]{2}:[a-f0-9]{2}(?:\.[a-f0-9])?/;
1251 pattern
=> qr/$PCIRE(;$PCIRE)*/,
1252 format_description
=> 'HOSTPCIID[;HOSTPCIID2...]',
1253 description
=> <<EODESCR,
1254 Host PCI device pass through. The PCI ID of a host's PCI device or a list
1255 of PCI virtual functions of the host. HOSTPCIID syntax is:
1257 'bus:dev.func' (hexadecimal numbers)
1259 You can us the 'lspci' command to list existing PCI devices.
1264 description
=> "Specify whether or not the device's ROM will be visible in the guest's memory map.",
1270 pattern
=> '[^,;]+',
1271 format_description
=> 'string',
1272 description
=> "Custom pci device rom filename (must be located in /usr/share/kvm/).",
1277 description
=> "Choose the PCI-express bus (needs the 'q35' machine model).",
1283 description
=> "Enable vfio-vga device support.",
1289 format_description
=> 'string',
1290 pattern
=> '[^/\.:]+',
1292 description
=> <<EODESCR
1293 The type of mediated device to use.
1294 An instance of this type will be created on startup of the VM and
1295 will be cleaned up when the VM stops.
1299 PVE
::JSONSchema
::register_format
('pve-qm-hostpci', $hostpci_fmt);
1303 type
=> 'string', format
=> 'pve-qm-hostpci',
1304 description
=> "Map host PCI devices into guest.",
1305 verbose_description
=> <<EODESCR,
1306 Map host PCI devices into guest.
1308 NOTE: This option allows direct access to host hardware. So it is no longer
1309 possible to migrate such machines - use with special care.
1311 CAUTION: Experimental! User reported problems with this option.
1314 PVE
::JSONSchema
::register_standard_option
("pve-qm-hostpci", $hostpcidesc);
1319 pattern
=> '(/dev/.+|socket)',
1320 description
=> "Create a serial device inside the VM (n is 0 to 3)",
1321 verbose_description
=> <<EODESCR,
1322 Create a serial device inside the VM (n is 0 to 3), and pass through a
1323 host serial device (i.e. /dev/ttyS0), or create a unix socket on the
1324 host side (use 'qm terminal' to open a terminal connection).
1326 NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
1328 CAUTION: Experimental! User reported problems with this option.
1335 pattern
=> '/dev/parport\d+|/dev/usb/lp\d+',
1336 description
=> "Map host parallel devices (n is 0 to 2).",
1337 verbose_description
=> <<EODESCR,
1338 Map host parallel devices (n is 0 to 2).
1340 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1342 CAUTION: Experimental! User reported problems with this option.
1346 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
1347 $confdesc->{"parallel$i"} = $paralleldesc;
1350 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
1351 $confdesc->{"serial$i"} = $serialdesc;
1354 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
1355 $confdesc->{"hostpci$i"} = $hostpcidesc;
1358 for (my $i = 0; $i < $MAX_IDE_DISKS; $i++) {
1359 $drivename_hash->{"ide$i"} = 1;
1360 $confdesc->{"ide$i"} = $idedesc;
1363 for (my $i = 0; $i < $MAX_SATA_DISKS; $i++) {
1364 $drivename_hash->{"sata$i"} = 1;
1365 $confdesc->{"sata$i"} = $satadesc;
1368 for (my $i = 0; $i < $MAX_SCSI_DISKS; $i++) {
1369 $drivename_hash->{"scsi$i"} = 1;
1370 $confdesc->{"scsi$i"} = $scsidesc ;
1373 for (my $i = 0; $i < $MAX_VIRTIO_DISKS; $i++) {
1374 $drivename_hash->{"virtio$i"} = 1;
1375 $confdesc->{"virtio$i"} = $virtiodesc;
1378 $drivename_hash->{efidisk0
} = 1;
1379 $confdesc->{efidisk0
} = $efidisk_desc;
1381 for (my $i = 0; $i < $MAX_USB_DEVICES; $i++) {
1382 $confdesc->{"usb$i"} = $usbdesc;
1387 type
=> 'string', format
=> 'pve-volume-id',
1388 description
=> "Reference to unused volumes. This is used internally, and should not be modified manually.",
1391 for (my $i = 0; $i < $MAX_UNUSED_DISKS; $i++) {
1392 $confdesc->{"unused$i"} = $unuseddesc;
1395 my $kvm_api_version = 0;
1398 return $kvm_api_version if $kvm_api_version;
1400 open my $fh, '<', '/dev/kvm'
1403 # 0xae00 => KVM_GET_API_VERSION
1404 $kvm_api_version = ioctl($fh, 0xae00, 0);
1406 return $kvm_api_version;
1409 my $kvm_user_version = {};
1412 sub kvm_user_version
{
1415 $binary //= get_command_for_arch
(get_host_arch
()); # get the native arch by default
1416 my $st = stat($binary);
1418 my $cachedmtime = $kvm_mtime->{$binary} // -1;
1419 return $kvm_user_version->{$binary} if $kvm_user_version->{$binary} &&
1420 $cachedmtime == $st->mtime;
1422 $kvm_user_version->{$binary} = 'unknown';
1423 $kvm_mtime->{$binary} = $st->mtime;
1427 if ($line =~ m/^QEMU( PC)? emulator version (\d+\.\d+(\.\d+)?)(\.\d+)?[,\s]/) {
1428 $kvm_user_version->{$binary} = $2;
1432 eval { run_command
([$binary, '--version'], outfunc
=> $code); };
1435 return $kvm_user_version->{$binary};
1439 sub kernel_has_vhost_net
{
1440 return -c
'/dev/vhost-net';
1443 sub valid_drive_names
{
1444 # order is important - used to autoselect boot disk
1445 return ((map { "ide$_" } (0 .. ($MAX_IDE_DISKS - 1))),
1446 (map { "scsi$_" } (0 .. ($MAX_SCSI_DISKS - 1))),
1447 (map { "virtio$_" } (0 .. ($MAX_VIRTIO_DISKS - 1))),
1448 (map { "sata$_" } (0 .. ($MAX_SATA_DISKS - 1))),
1452 sub is_valid_drivename
{
1455 return defined($drivename_hash->{$dev});
1460 return defined($confdesc->{$key});
1464 sub get_cdrom_path
{
1466 return $cdrom_path if $cdrom_path;
1468 return $cdrom_path = "/dev/cdrom" if -l
"/dev/cdrom";
1469 return $cdrom_path = "/dev/cdrom1" if -l
"/dev/cdrom1";
1470 return $cdrom_path = "/dev/cdrom2" if -l
"/dev/cdrom2";
1474 my ($storecfg, $vmid, $cdrom) = @_;
1476 if ($cdrom eq 'cdrom') {
1477 return get_cdrom_path
();
1478 } elsif ($cdrom eq 'none') {
1480 } elsif ($cdrom =~ m
|^/|) {
1483 return PVE
::Storage
::path
($storecfg, $cdrom);
1487 # try to convert old style file names to volume IDs
1488 sub filename_to_volume_id
{
1489 my ($vmid, $file, $media) = @_;
1491 if (!($file eq 'none' || $file eq 'cdrom' ||
1492 $file =~ m
|^/dev/.+| || $file =~ m/^([^:]+):(.+)$/)) {
1494 return undef if $file =~ m
|/|;
1496 if ($media && $media eq 'cdrom') {
1497 $file = "local:iso/$file";
1499 $file = "local:$vmid/$file";
1506 sub verify_media_type
{
1507 my ($opt, $vtype, $media) = @_;
1512 if ($media eq 'disk') {
1514 } elsif ($media eq 'cdrom') {
1517 die "internal error";
1520 return if ($vtype eq $etype);
1522 raise_param_exc
({ $opt => "unexpected media type ($vtype != $etype)" });
1525 sub cleanup_drive_path
{
1526 my ($opt, $storecfg, $drive) = @_;
1528 # try to convert filesystem paths to volume IDs
1530 if (($drive->{file
} !~ m/^(cdrom|none)$/) &&
1531 ($drive->{file
} !~ m
|^/dev/.+|) &&
1532 ($drive->{file
} !~ m/^([^:]+):(.+)$/) &&
1533 ($drive->{file
} !~ m/^\d+$/)) {
1534 my ($vtype, $volid) = PVE
::Storage
::path_to_volume_id
($storecfg, $drive->{file
});
1535 raise_param_exc
({ $opt => "unable to associate path '$drive->{file}' to any storage"}) if !$vtype;
1536 $drive->{media
} = 'cdrom' if !$drive->{media
} && $vtype eq 'iso';
1537 verify_media_type
($opt, $vtype, $drive->{media
});
1538 $drive->{file
} = $volid;
1541 $drive->{media
} = 'cdrom' if !$drive->{media
} && $drive->{file
} =~ m/^(cdrom|none)$/;
1544 sub parse_hotplug_features
{
1549 return $res if $data eq '0';
1551 $data = $confdesc->{hotplug
}->{default} if $data eq '1';
1553 foreach my $feature (PVE
::Tools
::split_list
($data)) {
1554 if ($feature =~ m/^(network|disk|cpu|memory|usb)$/) {
1557 die "invalid hotplug feature '$feature'\n";
1563 PVE
::JSONSchema
::register_format
('pve-hotplug-features', \
&pve_verify_hotplug_features
);
1564 sub pve_verify_hotplug_features
{
1565 my ($value, $noerr) = @_;
1567 return $value if parse_hotplug_features
($value);
1569 return undef if $noerr;
1571 die "unable to parse hotplug option\n";
1574 # ideX = [volume=]volume-id[,media=d][,cyls=c,heads=h,secs=s[,trans=t]]
1575 # [,snapshot=on|off][,cache=on|off][,format=f][,backup=yes|no]
1576 # [,rerror=ignore|report|stop][,werror=enospc|ignore|report|stop]
1577 # [,aio=native|threads][,discard=ignore|on][,detect_zeroes=on|off]
1578 # [,iothread=on][,serial=serial][,model=model]
1581 my ($key, $data) = @_;
1583 my ($interface, $index);
1585 if ($key =~ m/^([^\d]+)(\d+)$/) {
1592 my $desc = $key =~ /^unused\d+$/ ?
$alldrive_fmt
1593 : $confdesc->{$key}->{format
};
1595 warn "invalid drive key: $key\n";
1598 my $res = eval { PVE
::JSONSchema
::parse_property_string
($desc, $data) };
1599 return undef if !$res;
1600 $res->{interface
} = $interface;
1601 $res->{index} = $index;
1604 foreach my $opt (qw(bps bps_rd bps_wr)) {
1605 if (my $bps = defined(delete $res->{$opt})) {
1606 if (defined($res->{"m$opt"})) {
1607 warn "both $opt and m$opt specified\n";
1611 $res->{"m$opt"} = sprintf("%.3f", $bps / (1024*1024.0));
1615 # can't use the schema's 'requires' because of the mbps* => bps* "transforming aliases"
1616 for my $requirement (
1617 [mbps_max
=> 'mbps'],
1618 [mbps_rd_max
=> 'mbps_rd'],
1619 [mbps_wr_max
=> 'mbps_wr'],
1620 [miops_max
=> 'miops'],
1621 [miops_rd_max
=> 'miops_rd'],
1622 [miops_wr_max
=> 'miops_wr'],
1623 [bps_max_length
=> 'mbps_max'],
1624 [bps_rd_max_length
=> 'mbps_rd_max'],
1625 [bps_wr_max_length
=> 'mbps_wr_max'],
1626 [iops_max_length
=> 'iops_max'],
1627 [iops_rd_max_length
=> 'iops_rd_max'],
1628 [iops_wr_max_length
=> 'iops_wr_max']) {
1629 my ($option, $requires) = @$requirement;
1630 if ($res->{$option} && !$res->{$requires}) {
1631 warn "$option requires $requires\n";
1636 return undef if $error;
1638 return undef if $res->{mbps_rd
} && $res->{mbps
};
1639 return undef if $res->{mbps_wr
} && $res->{mbps
};
1640 return undef if $res->{iops_rd
} && $res->{iops
};
1641 return undef if $res->{iops_wr
} && $res->{iops
};
1643 if ($res->{media
} && ($res->{media
} eq 'cdrom')) {
1644 return undef if $res->{snapshot
} || $res->{trans
} || $res->{format
};
1645 return undef if $res->{heads
} || $res->{secs
} || $res->{cyls
};
1646 return undef if $res->{interface
} eq 'virtio';
1649 if (my $size = $res->{size
}) {
1650 return undef if !defined($res->{size
} = PVE
::JSONSchema
::parse_size
($size));
1658 my $data = { %$drive };
1659 delete $data->{$_} for qw(index interface);
1660 return PVE
::JSONSchema
::print_property_string
($data, $alldrive_fmt);
1664 my($fh, $noerr) = @_;
1667 my $SG_GET_VERSION_NUM = 0x2282;
1669 my $versionbuf = "\x00" x
8;
1670 my $ret = ioctl($fh, $SG_GET_VERSION_NUM, $versionbuf);
1672 die "scsi ioctl SG_GET_VERSION_NUM failoed - $!\n" if !$noerr;
1675 my $version = unpack("I", $versionbuf);
1676 if ($version < 30000) {
1677 die "scsi generic interface too old\n" if !$noerr;
1681 my $buf = "\x00" x
36;
1682 my $sensebuf = "\x00" x
8;
1683 my $cmd = pack("C x3 C x1", 0x12, 36);
1685 # see /usr/include/scsi/sg.h
1686 my $sg_io_hdr_t = "i i C C s I P P P I I i P C C C C S S i I I";
1688 my $packet = pack($sg_io_hdr_t, ord('S'), -3, length($cmd),
1689 length($sensebuf), 0, length($buf), $buf,
1690 $cmd, $sensebuf, 6000);
1692 $ret = ioctl($fh, $SG_IO, $packet);
1694 die "scsi ioctl SG_IO failed - $!\n" if !$noerr;
1698 my @res = unpack($sg_io_hdr_t, $packet);
1699 if ($res[17] || $res[18]) {
1700 die "scsi ioctl SG_IO status error - $!\n" if !$noerr;
1705 (my $byte0, my $byte1, $res->{vendor
},
1706 $res->{product
}, $res->{revision
}) = unpack("C C x6 A8 A16 A4", $buf);
1708 $res->{removable
} = $byte1 & 128 ?
1 : 0;
1709 $res->{type
} = $byte0 & 31;
1717 my $fh = IO
::File-
>new("+<$path") || return undef;
1718 my $res = scsi_inquiry
($fh, 1);
1724 sub print_tabletdevice_full
{
1725 my ($conf, $arch) = @_;
1727 my $q35 = PVE
::QemuServer
::Machine
::machine_type_is_q35
($conf);
1729 # we use uhci for old VMs because tablet driver was buggy in older qemu
1731 if (PVE
::QemuServer
::Machine
::machine_type_is_q35
($conf) || $arch eq 'aarch64') {
1737 return "usb-tablet,id=tablet,bus=$usbbus.0,port=1";
1740 sub print_keyboarddevice_full
{
1741 my ($conf, $arch, $machine) = @_;
1743 return undef if $arch ne 'aarch64';
1745 return "usb-kbd,id=keyboard,bus=ehci.0,port=2";
1748 sub print_drivedevice_full
{
1749 my ($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type) = @_;
1754 if ($drive->{interface
} eq 'virtio') {
1755 my $pciaddr = print_pci_addr
("$drive->{interface}$drive->{index}", $bridges, $arch, $machine_type);
1756 $device = "virtio-blk-pci,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}$pciaddr";
1757 $device .= ",iothread=iothread-$drive->{interface}$drive->{index}" if $drive->{iothread
};
1758 } elsif ($drive->{interface
} eq 'scsi') {
1760 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
1761 my $unit = $drive->{index} % $maxdev;
1762 my $devicetype = 'hd';
1764 if (drive_is_cdrom
($drive)) {
1767 if ($drive->{file
} =~ m
|^/|) {
1768 $path = $drive->{file
};
1769 if (my $info = path_is_scsi
($path)) {
1770 if ($info->{type
} == 0 && $drive->{scsiblock
}) {
1771 $devicetype = 'block';
1772 } elsif ($info->{type
} == 1) { # tape
1773 $devicetype = 'generic';
1777 $path = PVE
::Storage
::path
($storecfg, $drive->{file
});
1780 # for compatibility only, we prefer scsi-hd (#2408, #2355, #2380)
1781 my $version = PVE
::QemuServer
::Machine
::extract_version
($machine_type, kvm_user_version
());
1782 if ($path =~ m/^iscsi\:\/\
// &&
1783 !min_version
($version, 4, 1)) {
1784 $devicetype = 'generic';
1788 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)){
1789 $device = "scsi-$devicetype,bus=$controller_prefix$controller.0,scsi-id=$unit,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1791 $device = "scsi-$devicetype,bus=$controller_prefix$controller.0,channel=0,scsi-id=0,lun=$drive->{index},drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1794 if ($drive->{ssd
} && ($devicetype eq 'block' || $devicetype eq 'hd')) {
1795 $device .= ",rotation_rate=1";
1797 $device .= ",wwn=$drive->{wwn}" if $drive->{wwn
};
1799 } elsif ($drive->{interface
} eq 'ide' || $drive->{interface
} eq 'sata') {
1800 my $maxdev = ($drive->{interface
} eq 'sata') ?
$MAX_SATA_DISKS : 2;
1801 my $controller = int($drive->{index} / $maxdev);
1802 my $unit = $drive->{index} % $maxdev;
1803 my $devicetype = ($drive->{media
} && $drive->{media
} eq 'cdrom') ?
"cd" : "hd";
1805 $device = "ide-$devicetype";
1806 if ($drive->{interface
} eq 'ide') {
1807 $device .= ",bus=ide.$controller,unit=$unit";
1809 $device .= ",bus=ahci$controller.$unit";
1811 $device .= ",drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1813 if ($devicetype eq 'hd') {
1814 if (my $model = $drive->{model
}) {
1815 $model = URI
::Escape
::uri_unescape
($model);
1816 $device .= ",model=$model";
1818 if ($drive->{ssd
}) {
1819 $device .= ",rotation_rate=1";
1822 $device .= ",wwn=$drive->{wwn}" if $drive->{wwn
};
1823 } elsif ($drive->{interface
} eq 'usb') {
1825 # -device ide-drive,bus=ide.1,unit=0,drive=drive-ide0-1-0,id=ide0-1-0
1827 die "unsupported interface type";
1830 $device .= ",bootindex=$drive->{bootindex}" if $drive->{bootindex
};
1832 if (my $serial = $drive->{serial
}) {
1833 $serial = URI
::Escape
::uri_unescape
($serial);
1834 $device .= ",serial=$serial";
1841 sub get_initiator_name
{
1844 my $fh = IO
::File-
>new('/etc/iscsi/initiatorname.iscsi') || return undef;
1845 while (defined(my $line = <$fh>)) {
1846 next if $line !~ m/^\s*InitiatorName\s*=\s*([\.\-:\w]+)/;
1855 sub print_drive_full
{
1856 my ($storecfg, $vmid, $drive) = @_;
1859 my $volid = $drive->{file
};
1862 if (drive_is_cdrom
($drive)) {
1863 $path = get_iso_path
($storecfg, $vmid, $volid);
1865 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
1867 $path = PVE
::Storage
::path
($storecfg, $volid);
1868 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
1869 $format = qemu_img_format
($scfg, $volname);
1877 my @qemu_drive_options = qw(heads secs cyls trans media format cache rerror werror aio discard);
1878 foreach my $o (@qemu_drive_options) {
1879 $opts .= ",$o=$drive->{$o}" if defined($drive->{$o});
1882 # snapshot only accepts on|off
1883 if (defined($drive->{snapshot
})) {
1884 my $v = $drive->{snapshot
} ?
'on' : 'off';
1885 $opts .= ",snapshot=$v";
1888 foreach my $type (['', '-total'], [_rd
=> '-read'], [_wr
=> '-write']) {
1889 my ($dir, $qmpname) = @$type;
1890 if (my $v = $drive->{"mbps$dir"}) {
1891 $opts .= ",throttling.bps$qmpname=".int($v*1024*1024);
1893 if (my $v = $drive->{"mbps${dir}_max"}) {
1894 $opts .= ",throttling.bps$qmpname-max=".int($v*1024*1024);
1896 if (my $v = $drive->{"bps${dir}_max_length"}) {
1897 $opts .= ",throttling.bps$qmpname-max-length=$v";
1899 if (my $v = $drive->{"iops${dir}"}) {
1900 $opts .= ",throttling.iops$qmpname=$v";
1902 if (my $v = $drive->{"iops${dir}_max"}) {
1903 $opts .= ",throttling.iops$qmpname-max=$v";
1905 if (my $v = $drive->{"iops${dir}_max_length"}) {
1906 $opts .= ",throttling.iops$qmpname-max-length=$v";
1910 $opts .= ",format=$format" if $format && !$drive->{format
};
1912 my $cache_direct = 0;
1914 if (my $cache = $drive->{cache
}) {
1915 $cache_direct = $cache =~ /^(?:off|none|directsync)$/;
1916 } elsif (!drive_is_cdrom
($drive)) {
1917 $opts .= ",cache=none";
1921 # aio native works only with O_DIRECT
1922 if (!$drive->{aio
}) {
1924 $opts .= ",aio=native";
1926 $opts .= ",aio=threads";
1930 if (!drive_is_cdrom
($drive)) {
1932 if (defined($drive->{detect_zeroes
}) && !$drive->{detect_zeroes
}) {
1933 $detectzeroes = 'off';
1934 } elsif ($drive->{discard
}) {
1935 $detectzeroes = $drive->{discard
} eq 'on' ?
'unmap' : 'on';
1937 # This used to be our default with discard not being specified:
1938 $detectzeroes = 'on';
1940 $opts .= ",detect-zeroes=$detectzeroes" if $detectzeroes;
1943 my $pathinfo = $path ?
"file=$path," : '';
1945 return "${pathinfo}if=none,id=drive-$drive->{interface}$drive->{index}$opts";
1948 sub print_netdevice_full
{
1949 my ($vmid, $conf, $net, $netid, $bridges, $use_old_bios_files, $arch, $machine_type) = @_;
1951 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
1953 my $device = $net->{model
};
1954 if ($net->{model
} eq 'virtio') {
1955 $device = 'virtio-net-pci';
1958 my $pciaddr = print_pci_addr
("$netid", $bridges, $arch, $machine_type);
1959 my $tmpstr = "$device,mac=$net->{macaddr},netdev=$netid$pciaddr,id=$netid";
1960 if ($net->{queues
} && $net->{queues
} > 1 && $net->{model
} eq 'virtio'){
1961 #Consider we have N queues, the number of vectors needed is 2*N + 2 (plus one config interrupt and control vq)
1962 my $vectors = $net->{queues
} * 2 + 2;
1963 $tmpstr .= ",vectors=$vectors,mq=on";
1965 $tmpstr .= ",bootindex=$net->{bootindex}" if $net->{bootindex
} ;
1967 if ($use_old_bios_files) {
1969 if ($device eq 'virtio-net-pci') {
1970 $romfile = 'pxe-virtio.rom';
1971 } elsif ($device eq 'e1000') {
1972 $romfile = 'pxe-e1000.rom';
1973 } elsif ($device eq 'ne2k') {
1974 $romfile = 'pxe-ne2k_pci.rom';
1975 } elsif ($device eq 'pcnet') {
1976 $romfile = 'pxe-pcnet.rom';
1977 } elsif ($device eq 'rtl8139') {
1978 $romfile = 'pxe-rtl8139.rom';
1980 $tmpstr .= ",romfile=$romfile" if $romfile;
1986 sub print_netdev_full
{
1987 my ($vmid, $conf, $arch, $net, $netid, $hotplug) = @_;
1990 if ($netid =~ m/^net(\d+)$/) {
1994 die "got strange net id '$i'\n" if $i >= ${MAX_NETS
};
1996 my $ifname = "tap${vmid}i$i";
1998 # kvm uses TUNSETIFF ioctl, and that limits ifname length
1999 die "interface name '$ifname' is too long (max 15 character)\n"
2000 if length($ifname) >= 16;
2002 my $vhostparam = '';
2003 if (is_native
($arch)) {
2004 $vhostparam = ',vhost=on' if kernel_has_vhost_net
() && $net->{model
} eq 'virtio';
2007 my $vmname = $conf->{name
} || "vm$vmid";
2010 my $script = $hotplug ?
"pve-bridge-hotplug" : "pve-bridge";
2012 if ($net->{bridge
}) {
2013 $netdev = "type=tap,id=$netid,ifname=${ifname},script=/var/lib/qemu-server/$script,downscript=/var/lib/qemu-server/pve-bridgedown$vhostparam";
2015 $netdev = "type=user,id=$netid,hostname=$vmname";
2018 $netdev .= ",queues=$net->{queues}" if ($net->{queues
} && $net->{model
} eq 'virtio');
2024 'cirrus' => 'cirrus-vga',
2026 'vmware' => 'vmware-svga',
2027 'virtio' => 'virtio-vga',
2030 sub print_vga_device
{
2031 my ($conf, $vga, $arch, $machine_version, $machine, $id, $qxlnum, $bridges) = @_;
2033 my $type = $vga_map->{$vga->{type
}};
2034 if ($arch eq 'aarch64' && defined($type) && $type eq 'virtio-vga') {
2035 $type = 'virtio-gpu';
2037 my $vgamem_mb = $vga->{memory
};
2039 my $max_outputs = '';
2041 $type = $id ?
'qxl' : 'qxl-vga';
2043 if (!$conf->{ostype
} || $conf->{ostype
} =~ m/^(?:l\d\d)|(?:other)$/) {
2044 # set max outputs so linux can have up to 4 qxl displays with one device
2045 if (min_version
($machine_version, 4, 1)) {
2046 $max_outputs = ",max_outputs=4";
2051 die "no devicetype for $vga->{type}\n" if !$type;
2055 if ($vga->{type
} eq 'virtio') {
2056 my $bytes = PVE
::Tools
::convert_size
($vgamem_mb, "mb" => "b");
2057 $memory = ",max_hostmem=$bytes";
2059 # from https://www.spice-space.org/multiple-monitors.html
2060 $memory = ",vgamem_mb=$vga->{memory}";
2061 my $ram = $vgamem_mb * 4;
2062 my $vram = $vgamem_mb * 2;
2063 $memory .= ",ram_size_mb=$ram,vram_size_mb=$vram";
2065 $memory = ",vgamem_mb=$vga->{memory}";
2067 } elsif ($qxlnum && $id) {
2068 $memory = ",ram_size=67108864,vram_size=33554432";
2071 my $q35 = PVE
::QemuServer
::Machine
::machine_type_is_q35
($conf);
2072 my $vgaid = "vga" . ($id // '');
2075 if ($q35 && $vgaid eq 'vga') {
2076 # the first display uses pcie.0 bus on q35 machines
2077 $pciaddr = print_pcie_addr
($vgaid, $bridges, $arch, $machine);
2079 $pciaddr = print_pci_addr
($vgaid, $bridges, $arch, $machine);
2082 return "$type,id=${vgaid}${memory}${max_outputs}${pciaddr}";
2085 sub drive_is_cloudinit
{
2087 return $drive->{file
} =~ m
@[:/]vm-\d
+-cloudinit
(?
:\
.$QEMU_FORMAT_RE)?
$@;
2090 sub drive_is_cdrom
{
2091 my ($drive, $exclude_cloudinit) = @_;
2093 return 0 if $exclude_cloudinit && drive_is_cloudinit
($drive);
2095 return $drive && $drive->{media
} && ($drive->{media
} eq 'cdrom');
2099 sub parse_number_sets
{
2102 foreach my $part (split(/;/, $set)) {
2103 if ($part =~ /^\s*(\d+)(?:-(\d+))?\s*$/) {
2104 die "invalid range: $part ($2 < $1)\n" if defined($2) && $2 < $1;
2105 push @$res, [ $1, $2 ];
2107 die "invalid range: $part\n";
2116 my $res = PVE
::JSONSchema
::parse_property_string
($numa_fmt, $data);
2117 $res->{cpus
} = parse_number_sets
($res->{cpus
}) if defined($res->{cpus
});
2118 $res->{hostnodes
} = parse_number_sets
($res->{hostnodes
}) if defined($res->{hostnodes
});
2125 return undef if !$value;
2127 my $res = PVE
::JSONSchema
::parse_property_string
($hostpci_fmt, $value);
2129 my @idlist = split(/;/, $res->{host
});
2130 delete $res->{host
};
2131 foreach my $id (@idlist) {
2132 my $devs = PVE
::SysFSTools
::lspci
($id);
2133 die "no PCI device found for '$id'\n" if !scalar(@$devs);
2134 push @{$res->{pciid
}}, @$devs;
2139 # netX: e1000=XX:XX:XX:XX:XX:XX,bridge=vmbr0,rate=<mbps>
2143 my $res = eval { PVE
::JSONSchema
::parse_property_string
($net_fmt, $data) };
2148 if (!defined($res->{macaddr
})) {
2149 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
2150 $res->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
});
2155 # ipconfigX ip=cidr,gw=ip,ip6=cidr,gw6=ip
2156 sub parse_ipconfig
{
2159 my $res = eval { PVE
::JSONSchema
::parse_property_string
($ipconfig_fmt, $data) };
2165 if ($res->{gw
} && !$res->{ip
}) {
2166 warn 'gateway specified without specifying an IP address';
2169 if ($res->{gw6
} && !$res->{ip6
}) {
2170 warn 'IPv6 gateway specified without specifying an IPv6 address';
2173 if ($res->{gw
} && $res->{ip
} eq 'dhcp') {
2174 warn 'gateway specified together with DHCP';
2177 if ($res->{gw6
} && $res->{ip6
} !~ /^$IPV6RE/) {
2179 warn "IPv6 gateway specified together with $res->{ip6} address";
2183 if (!$res->{ip
} && !$res->{ip6
}) {
2184 return { ip
=> 'dhcp', ip6
=> 'dhcp' };
2193 return PVE
::JSONSchema
::print_property_string
($net, $net_fmt);
2196 sub add_random_macs
{
2197 my ($settings) = @_;
2199 foreach my $opt (keys %$settings) {
2200 next if $opt !~ m/^net(\d+)$/;
2201 my $net = parse_net
($settings->{$opt});
2203 $settings->{$opt} = print_net
($net);
2207 sub vm_is_volid_owner
{
2208 my ($storecfg, $vmid, $volid) = @_;
2210 if ($volid !~ m
|^/|) {
2212 eval { ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid); };
2213 if ($owner && ($owner == $vmid)) {
2221 sub vmconfig_register_unused_drive
{
2222 my ($storecfg, $vmid, $conf, $drive) = @_;
2224 if (drive_is_cloudinit
($drive)) {
2225 eval { PVE
::Storage
::vdisk_free
($storecfg, $drive->{file
}) };
2227 } elsif (!drive_is_cdrom
($drive)) {
2228 my $volid = $drive->{file
};
2229 if (vm_is_volid_owner
($storecfg, $vmid, $volid)) {
2230 PVE
::QemuConfig-
>add_unused_volume($conf, $volid, $vmid);
2235 # smbios: [manufacturer=str][,product=str][,version=str][,serial=str][,uuid=uuid][,sku=str][,family=str][,base64=bool]
2239 pattern
=> '[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}',
2240 format_description
=> 'UUID',
2241 description
=> "Set SMBIOS1 UUID.",
2246 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2247 format_description
=> 'Base64 encoded string',
2248 description
=> "Set SMBIOS1 version.",
2253 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2254 format_description
=> 'Base64 encoded string',
2255 description
=> "Set SMBIOS1 serial number.",
2260 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2261 format_description
=> 'Base64 encoded string',
2262 description
=> "Set SMBIOS1 manufacturer.",
2267 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2268 format_description
=> 'Base64 encoded string',
2269 description
=> "Set SMBIOS1 product ID.",
2274 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2275 format_description
=> 'Base64 encoded string',
2276 description
=> "Set SMBIOS1 SKU string.",
2281 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2282 format_description
=> 'Base64 encoded string',
2283 description
=> "Set SMBIOS1 family string.",
2288 description
=> 'Flag to indicate that the SMBIOS values are base64 encoded',
2296 my $res = eval { PVE
::JSONSchema
::parse_property_string
($smbios1_fmt, $data) };
2303 return PVE
::JSONSchema
::print_property_string
($smbios1, $smbios1_fmt);
2306 PVE
::JSONSchema
::register_format
('pve-qm-smbios1', $smbios1_fmt);
2308 PVE
::JSONSchema
::register_format
('pve-qm-bootdisk', \
&verify_bootdisk
);
2309 sub verify_bootdisk
{
2310 my ($value, $noerr) = @_;
2312 return $value if is_valid_drivename
($value);
2314 return undef if $noerr;
2316 die "invalid boot disk '$value'\n";
2319 sub parse_watchdog
{
2322 return undef if !$value;
2324 my $res = eval { PVE
::JSONSchema
::parse_property_string
($watchdog_fmt, $value) };
2329 sub parse_guest_agent
{
2332 return {} if !defined($value->{agent
});
2334 my $res = eval { PVE
::JSONSchema
::parse_property_string
($agent_fmt, $value->{agent
}) };
2337 # if the agent is disabled ignore the other potentially set properties
2338 return {} if !$res->{enabled
};
2345 return {} if !$value;
2346 my $res = eval { PVE
::JSONSchema
::parse_property_string
($vga_fmt, $value) };
2351 PVE
::JSONSchema
::register_format
('pve-qm-usb-device', \
&verify_usb_device
);
2352 sub verify_usb_device
{
2353 my ($value, $noerr) = @_;
2355 return $value if parse_usb_device
($value);
2357 return undef if $noerr;
2359 die "unable to parse usb device\n";
2362 # add JSON properties for create and set function
2363 sub json_config_properties
{
2366 foreach my $opt (keys %$confdesc) {
2367 next if $opt eq 'parent' || $opt eq 'snaptime' || $opt eq 'vmstate' || $opt eq 'runningmachine';
2368 $prop->{$opt} = $confdesc->{$opt};
2374 # return copy of $confdesc_cloudinit to generate documentation
2375 sub cloudinit_config_properties
{
2377 return dclone
($confdesc_cloudinit);
2381 my ($key, $value) = @_;
2383 die "unknown setting '$key'\n" if !$confdesc->{$key};
2385 my $type = $confdesc->{$key}->{type
};
2387 if (!defined($value)) {
2388 die "got undefined value\n";
2391 if ($value =~ m/[\n\r]/) {
2392 die "property contains a line feed\n";
2395 if ($type eq 'boolean') {
2396 return 1 if ($value eq '1') || ($value =~ m/^(on|yes|true)$/i);
2397 return 0 if ($value eq '0') || ($value =~ m/^(off|no|false)$/i);
2398 die "type check ('boolean') failed - got '$value'\n";
2399 } elsif ($type eq 'integer') {
2400 return int($1) if $value =~ m/^(\d+)$/;
2401 die "type check ('integer') failed - got '$value'\n";
2402 } elsif ($type eq 'number') {
2403 return $value if $value =~ m/^(\d+)(\.\d+)?$/;
2404 die "type check ('number') failed - got '$value'\n";
2405 } elsif ($type eq 'string') {
2406 if (my $fmt = $confdesc->{$key}->{format
}) {
2407 PVE
::JSONSchema
::check_format
($fmt, $value);
2410 $value =~ s/^\"(.*)\"$/$1/;
2413 die "internal error"
2418 my ($storecfg, $vmid, $skiplock, $replacement_conf) = @_;
2420 my $conf = PVE
::QemuConfig-
>load_config($vmid);
2422 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
2424 if ($conf->{template
}) {
2425 # check if any base image is still used by a linked clone
2426 foreach_drive
($conf, sub {
2427 my ($ds, $drive) = @_;
2428 return if drive_is_cdrom
($drive);
2430 my $volid = $drive->{file
};
2431 return if !$volid || $volid =~ m
|^/|;
2433 die "base volume '$volid' is still in use by linked cloned\n"
2434 if PVE
::Storage
::volume_is_base_and_used
($storecfg, $volid);
2439 # only remove disks owned by this VM
2440 foreach_drive
($conf, sub {
2441 my ($ds, $drive) = @_;
2442 return if drive_is_cdrom
($drive, 1);
2444 my $volid = $drive->{file
};
2445 return if !$volid || $volid =~ m
|^/|;
2447 my ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid);
2448 return if !$path || !$owner || ($owner != $vmid);
2450 eval { PVE
::Storage
::vdisk_free
($storecfg, $volid) };
2451 warn "Could not remove disk '$volid', check manually: $@" if $@;
2454 # also remove unused disk
2455 my $vmdisks = PVE
::Storage
::vdisk_list
($storecfg, undef, $vmid);
2456 PVE
::Storage
::foreach_volid
($vmdisks, sub {
2457 my ($volid, $sid, $volname, $d) = @_;
2458 eval { PVE
::Storage
::vdisk_free
($storecfg, $volid) };
2462 if (defined $replacement_conf) {
2463 PVE
::QemuConfig-
>write_config($vmid, $replacement_conf);
2465 PVE
::QemuConfig-
>destroy_config($vmid);
2469 sub parse_vm_config
{
2470 my ($filename, $raw) = @_;
2472 return undef if !defined($raw);
2475 digest
=> Digest
::SHA
::sha1_hex
($raw),
2480 $filename =~ m
|/qemu-server/(\d
+)\
.conf
$|
2481 || die "got strange filename '$filename'";
2489 my @lines = split(/\n/, $raw);
2490 foreach my $line (@lines) {
2491 next if $line =~ m/^\s*$/;
2493 if ($line =~ m/^\[PENDING\]\s*$/i) {
2494 $section = 'pending';
2495 if (defined($descr)) {
2497 $conf->{description
} = $descr;
2500 $conf = $res->{$section} = {};
2503 } elsif ($line =~ m/^\[([a-z][a-z0-9_\-]+)\]\s*$/i) {
2505 if (defined($descr)) {
2507 $conf->{description
} = $descr;
2510 $conf = $res->{snapshots
}->{$section} = {};
2514 if ($line =~ m/^\#(.*)\s*$/) {
2515 $descr = '' if !defined($descr);
2516 $descr .= PVE
::Tools
::decode_text
($1) . "\n";
2520 if ($line =~ m/^(description):\s*(.*\S)\s*$/) {
2521 $descr = '' if !defined($descr);
2522 $descr .= PVE
::Tools
::decode_text
($2);
2523 } elsif ($line =~ m/snapstate:\s*(prepare|delete)\s*$/) {
2524 $conf->{snapstate
} = $1;
2525 } elsif ($line =~ m/^(args):\s*(.*\S)\s*$/) {
2528 $conf->{$key} = $value;
2529 } elsif ($line =~ m/^delete:\s*(.*\S)\s*$/) {
2531 if ($section eq 'pending') {
2532 $conf->{delete} = $value; # we parse this later
2534 warn "vm $vmid - propertry 'delete' is only allowed in [PENDING]\n";
2536 } elsif ($line =~ m/^([a-z][a-z_]*\d*):\s*(.+?)\s*$/) {
2539 eval { $value = check_type
($key, $value); };
2541 warn "vm $vmid - unable to parse value of '$key' - $@";
2543 $key = 'ide2' if $key eq 'cdrom';
2544 my $fmt = $confdesc->{$key}->{format
};
2545 if ($fmt && $fmt =~ /^pve-qm-(?:ide|scsi|virtio|sata)$/) {
2546 my $v = parse_drive
($key, $value);
2547 if (my $volid = filename_to_volume_id
($vmid, $v->{file
}, $v->{media
})) {
2548 $v->{file
} = $volid;
2549 $value = print_drive
($v);
2551 warn "vm $vmid - unable to parse value of '$key'\n";
2556 $conf->{$key} = $value;
2561 if (defined($descr)) {
2563 $conf->{description
} = $descr;
2565 delete $res->{snapstate
}; # just to be sure
2570 sub write_vm_config
{
2571 my ($filename, $conf) = @_;
2573 delete $conf->{snapstate
}; # just to be sure
2575 if ($conf->{cdrom
}) {
2576 die "option ide2 conflicts with cdrom\n" if $conf->{ide2
};
2577 $conf->{ide2
} = $conf->{cdrom
};
2578 delete $conf->{cdrom
};
2581 # we do not use 'smp' any longer
2582 if ($conf->{sockets
}) {
2583 delete $conf->{smp
};
2584 } elsif ($conf->{smp
}) {
2585 $conf->{sockets
} = $conf->{smp
};
2586 delete $conf->{cores
};
2587 delete $conf->{smp
};
2590 my $used_volids = {};
2592 my $cleanup_config = sub {
2593 my ($cref, $pending, $snapname) = @_;
2595 foreach my $key (keys %$cref) {
2596 next if $key eq 'digest' || $key eq 'description' || $key eq 'snapshots' ||
2597 $key eq 'snapstate' || $key eq 'pending';
2598 my $value = $cref->{$key};
2599 if ($key eq 'delete') {
2600 die "propertry 'delete' is only allowed in [PENDING]\n"
2602 # fixme: check syntax?
2605 eval { $value = check_type
($key, $value); };
2606 die "unable to parse value of '$key' - $@" if $@;
2608 $cref->{$key} = $value;
2610 if (!$snapname && is_valid_drivename
($key)) {
2611 my $drive = parse_drive
($key, $value);
2612 $used_volids->{$drive->{file
}} = 1 if $drive && $drive->{file
};
2617 &$cleanup_config($conf);
2619 &$cleanup_config($conf->{pending
}, 1);
2621 foreach my $snapname (keys %{$conf->{snapshots
}}) {
2622 die "internal error: snapshot name '$snapname' is forbidden" if lc($snapname) eq 'pending';
2623 &$cleanup_config($conf->{snapshots
}->{$snapname}, undef, $snapname);
2626 # remove 'unusedX' settings if we re-add a volume
2627 foreach my $key (keys %$conf) {
2628 my $value = $conf->{$key};
2629 if ($key =~ m/^unused/ && $used_volids->{$value}) {
2630 delete $conf->{$key};
2634 my $generate_raw_config = sub {
2635 my ($conf, $pending) = @_;
2639 # add description as comment to top of file
2640 if (defined(my $descr = $conf->{description
})) {
2642 foreach my $cl (split(/\n/, $descr)) {
2643 $raw .= '#' . PVE
::Tools
::encode_text
($cl) . "\n";
2646 $raw .= "#\n" if $pending;
2650 foreach my $key (sort keys %$conf) {
2651 next if $key eq 'digest' || $key eq 'description' || $key eq 'pending' || $key eq 'snapshots';
2652 $raw .= "$key: $conf->{$key}\n";
2657 my $raw = &$generate_raw_config($conf);
2659 if (scalar(keys %{$conf->{pending
}})){
2660 $raw .= "\n[PENDING]\n";
2661 $raw .= &$generate_raw_config($conf->{pending
}, 1);
2664 foreach my $snapname (sort keys %{$conf->{snapshots
}}) {
2665 $raw .= "\n[$snapname]\n";
2666 $raw .= &$generate_raw_config($conf->{snapshots
}->{$snapname});
2676 # we use static defaults from our JSON schema configuration
2677 foreach my $key (keys %$confdesc) {
2678 if (defined(my $default = $confdesc->{$key}->{default})) {
2679 $res->{$key} = $default;
2687 my $vmlist = PVE
::Cluster
::get_vmlist
();
2689 return $res if !$vmlist || !$vmlist->{ids
};
2690 my $ids = $vmlist->{ids
};
2691 my $nodename = nodename
();
2693 foreach my $vmid (keys %$ids) {
2694 my $d = $ids->{$vmid};
2695 next if !$d->{node
} || $d->{node
} ne $nodename;
2696 next if !$d->{type
} || $d->{type
} ne 'qemu';
2697 $res->{$vmid}->{exists} = 1;
2702 # test if VM uses local resources (to prevent migration)
2703 sub check_local_resources
{
2704 my ($conf, $noerr) = @_;
2708 push @loc_res, "hostusb" if $conf->{hostusb
}; # old syntax
2709 push @loc_res, "hostpci" if $conf->{hostpci
}; # old syntax
2711 push @loc_res, "ivshmem" if $conf->{ivshmem
};
2713 foreach my $k (keys %$conf) {
2714 next if $k =~ m/^usb/ && ($conf->{$k} =~ m/^spice(?![^,])/);
2715 # sockets are safe: they will recreated be on the target side post-migrate
2716 next if $k =~ m/^serial/ && ($conf->{$k} eq 'socket');
2717 push @loc_res, $k if $k =~ m/^(usb|hostpci|serial|parallel)\d+$/;
2720 die "VM uses local resources\n" if scalar @loc_res && !$noerr;
2725 # check if used storages are available on all nodes (use by migrate)
2726 sub check_storage_availability
{
2727 my ($storecfg, $conf, $node) = @_;
2729 foreach_drive
($conf, sub {
2730 my ($ds, $drive) = @_;
2732 my $volid = $drive->{file
};
2735 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2738 # check if storage is available on both nodes
2739 my $scfg = PVE
::Storage
::storage_check_node
($storecfg, $sid);
2740 PVE
::Storage
::storage_check_node
($storecfg, $sid, $node);
2744 # list nodes where all VM images are available (used by has_feature API)
2746 my ($conf, $storecfg) = @_;
2748 my $nodelist = PVE
::Cluster
::get_nodelist
();
2749 my $nodehash = { map { $_ => 1 } @$nodelist };
2750 my $nodename = nodename
();
2752 foreach_drive
($conf, sub {
2753 my ($ds, $drive) = @_;
2755 my $volid = $drive->{file
};
2758 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2760 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
2761 if ($scfg->{disable
}) {
2763 } elsif (my $avail = $scfg->{nodes
}) {
2764 foreach my $node (keys %$nodehash) {
2765 delete $nodehash->{$node} if !$avail->{$node};
2767 } elsif (!$scfg->{shared
}) {
2768 foreach my $node (keys %$nodehash) {
2769 delete $nodehash->{$node} if $node ne $nodename
2778 sub check_local_storage_availability
{
2779 my ($conf, $storecfg) = @_;
2781 my $nodelist = PVE
::Cluster
::get_nodelist
();
2782 my $nodehash = { map { $_ => {} } @$nodelist };
2784 foreach_drive
($conf, sub {
2785 my ($ds, $drive) = @_;
2787 my $volid = $drive->{file
};
2790 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2792 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
2794 if ($scfg->{disable
}) {
2795 foreach my $node (keys %$nodehash) {
2796 $nodehash->{$node}->{unavailable_storages
}->{$storeid} = 1;
2798 } elsif (my $avail = $scfg->{nodes
}) {
2799 foreach my $node (keys %$nodehash) {
2800 if (!$avail->{$node}) {
2801 $nodehash->{$node}->{unavailable_storages
}->{$storeid} = 1;
2808 foreach my $node (values %$nodehash) {
2809 if (my $unavail = $node->{unavailable_storages
}) {
2810 $node->{unavailable_storages
} = [ sort keys %$unavail ];
2817 # Compat only, use assert_config_exists_on_node and vm_running_locally where possible
2819 my ($vmid, $nocheck, $node) = @_;
2821 PVE
::QemuConfig
::assert_config_exists_on_node
($vmid, $node) if !$nocheck;
2822 return PVE
::QemuServer
::Helpers
::vm_running_locally
($vmid);
2827 my $vzlist = config_list
();
2829 my $fd = IO
::Dir-
>new($PVE::QemuServer
::Helpers
::var_run_tmpdir
) || return $vzlist;
2831 while (defined(my $de = $fd->read)) {
2832 next if $de !~ m/^(\d+)\.pid$/;
2834 next if !defined($vzlist->{$vmid});
2835 if (my $pid = check_running
($vmid)) {
2836 $vzlist->{$vmid}->{pid
} = $pid;
2844 my ($storecfg, $conf) = @_;
2846 my $bootdisk = $conf->{bootdisk
};
2847 return undef if !$bootdisk;
2848 return undef if !is_valid_drivename
($bootdisk);
2850 return undef if !$conf->{$bootdisk};
2852 my $drive = parse_drive
($bootdisk, $conf->{$bootdisk});
2853 return undef if !defined($drive);
2855 return undef if drive_is_cdrom
($drive);
2857 my $volid = $drive->{file
};
2858 return undef if !$volid;
2860 return $drive->{size
};
2863 our $vmstatus_return_properties = {
2864 vmid
=> get_standard_option
('pve-vmid'),
2866 description
=> "Qemu process status.",
2868 enum
=> ['stopped', 'running'],
2871 description
=> "Maximum memory in bytes.",
2874 renderer
=> 'bytes',
2877 description
=> "Root disk size in bytes.",
2880 renderer
=> 'bytes',
2883 description
=> "VM name.",
2888 description
=> "Qemu QMP agent status.",
2893 description
=> "PID of running qemu process.",
2898 description
=> "Uptime.",
2901 renderer
=> 'duration',
2904 description
=> "Maximum usable CPUs.",
2909 description
=> "The current config lock, if any.",
2914 description
=> "The current configured tags, if any",
2920 my $last_proc_pid_stat;
2922 # get VM status information
2923 # This must be fast and should not block ($full == false)
2924 # We only query KVM using QMP if $full == true (this can be slow)
2926 my ($opt_vmid, $full) = @_;
2930 my $storecfg = PVE
::Storage
::config
();
2932 my $list = vzlist
();
2933 my $defaults = load_defaults
();
2935 my ($uptime) = PVE
::ProcFSTools
::read_proc_uptime
(1);
2937 my $cpucount = $cpuinfo->{cpus
} || 1;
2939 foreach my $vmid (keys %$list) {
2940 next if $opt_vmid && ($vmid ne $opt_vmid);
2942 my $conf = PVE
::QemuConfig-
>load_config($vmid);
2944 my $d = { vmid
=> $vmid };
2945 $d->{pid
} = $list->{$vmid}->{pid
};
2947 # fixme: better status?
2948 $d->{status
} = $list->{$vmid}->{pid
} ?
'running' : 'stopped';
2950 my $size = disksize
($storecfg, $conf);
2951 if (defined($size)) {
2952 $d->{disk
} = 0; # no info available
2953 $d->{maxdisk
} = $size;
2959 $d->{cpus
} = ($conf->{sockets
} || $defaults->{sockets
})
2960 * ($conf->{cores
} || $defaults->{cores
});
2961 $d->{cpus
} = $cpucount if $d->{cpus
} > $cpucount;
2962 $d->{cpus
} = $conf->{vcpus
} if $conf->{vcpus
};
2964 $d->{name
} = $conf->{name
} || "VM $vmid";
2965 $d->{maxmem
} = $conf->{memory
} ?
$conf->{memory
}*(1024*1024)
2966 : $defaults->{memory
}*(1024*1024);
2968 if ($conf->{balloon
}) {
2969 $d->{balloon_min
} = $conf->{balloon
}*(1024*1024);
2970 $d->{shares
} = defined($conf->{shares
}) ?
$conf->{shares
}
2971 : $defaults->{shares
};
2982 $d->{diskwrite
} = 0;
2984 $d->{template
} = PVE
::QemuConfig-
>is_template($conf);
2986 $d->{serial
} = 1 if conf_has_serial
($conf);
2987 $d->{lock} = $conf->{lock} if $conf->{lock};
2988 $d->{tags
} = $conf->{tags
} if defined($conf->{tags
});
2993 my $netdev = PVE
::ProcFSTools
::read_proc_net_dev
();
2994 foreach my $dev (keys %$netdev) {
2995 next if $dev !~ m/^tap([1-9]\d*)i/;
2997 my $d = $res->{$vmid};
3000 $d->{netout
} += $netdev->{$dev}->{receive
};
3001 $d->{netin
} += $netdev->{$dev}->{transmit
};
3004 $d->{nics
}->{$dev}->{netout
} = $netdev->{$dev}->{receive
};
3005 $d->{nics
}->{$dev}->{netin
} = $netdev->{$dev}->{transmit
};
3010 my $ctime = gettimeofday
;
3012 foreach my $vmid (keys %$list) {
3014 my $d = $res->{$vmid};
3015 my $pid = $d->{pid
};
3018 my $pstat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
3019 next if !$pstat; # not running
3021 my $used = $pstat->{utime} + $pstat->{stime
};
3023 $d->{uptime
} = int(($uptime - $pstat->{starttime
})/$cpuinfo->{user_hz
});
3025 if ($pstat->{vsize
}) {
3026 $d->{mem
} = int(($pstat->{rss
}/$pstat->{vsize
})*$d->{maxmem
});
3029 my $old = $last_proc_pid_stat->{$pid};
3031 $last_proc_pid_stat->{$pid} = {
3039 my $dtime = ($ctime - $old->{time}) * $cpucount * $cpuinfo->{user_hz
};
3041 if ($dtime > 1000) {
3042 my $dutime = $used - $old->{used
};
3044 $d->{cpu
} = (($dutime/$dtime)* $cpucount) / $d->{cpus
};
3045 $last_proc_pid_stat->{$pid} = {
3051 $d->{cpu
} = $old->{cpu
};
3055 return $res if !$full;
3057 my $qmpclient = PVE
::QMPClient-
>new();
3059 my $ballooncb = sub {
3060 my ($vmid, $resp) = @_;
3062 my $info = $resp->{'return'};
3063 return if !$info->{max_mem
};
3065 my $d = $res->{$vmid};
3067 # use memory assigned to VM
3068 $d->{maxmem
} = $info->{max_mem
};
3069 $d->{balloon
} = $info->{actual
};
3071 if (defined($info->{total_mem
}) && defined($info->{free_mem
})) {
3072 $d->{mem
} = $info->{total_mem
} - $info->{free_mem
};
3073 $d->{freemem
} = $info->{free_mem
};
3076 $d->{ballooninfo
} = $info;
3079 my $blockstatscb = sub {
3080 my ($vmid, $resp) = @_;
3081 my $data = $resp->{'return'} || [];
3082 my $totalrdbytes = 0;
3083 my $totalwrbytes = 0;
3085 for my $blockstat (@$data) {
3086 $totalrdbytes = $totalrdbytes + $blockstat->{stats
}->{rd_bytes
};
3087 $totalwrbytes = $totalwrbytes + $blockstat->{stats
}->{wr_bytes
};
3089 $blockstat->{device
} =~ s/drive-//;
3090 $res->{$vmid}->{blockstat
}->{$blockstat->{device
}} = $blockstat->{stats
};
3092 $res->{$vmid}->{diskread
} = $totalrdbytes;
3093 $res->{$vmid}->{diskwrite
} = $totalwrbytes;
3096 my $statuscb = sub {
3097 my ($vmid, $resp) = @_;
3099 $qmpclient->queue_cmd($vmid, $blockstatscb, 'query-blockstats');
3100 # this fails if ballon driver is not loaded, so this must be
3101 # the last commnand (following command are aborted if this fails).
3102 $qmpclient->queue_cmd($vmid, $ballooncb, 'query-balloon');
3104 my $status = 'unknown';
3105 if (!defined($status = $resp->{'return'}->{status
})) {
3106 warn "unable to get VM status\n";
3110 $res->{$vmid}->{qmpstatus
} = $resp->{'return'}->{status
};
3113 foreach my $vmid (keys %$list) {
3114 next if $opt_vmid && ($vmid ne $opt_vmid);
3115 next if !$res->{$vmid}->{pid
}; # not running
3116 $qmpclient->queue_cmd($vmid, $statuscb, 'query-status');
3119 $qmpclient->queue_execute(undef, 2);
3121 foreach my $vmid (keys %$list) {
3122 next if $opt_vmid && ($vmid ne $opt_vmid);
3123 $res->{$vmid}->{qmpstatus
} = $res->{$vmid}->{status
} if !$res->{$vmid}->{qmpstatus
};
3130 my ($conf, $func, @param) = @_;
3132 foreach my $ds (valid_drive_names
()) {
3133 next if !defined($conf->{$ds});
3135 my $drive = parse_drive
($ds, $conf->{$ds});
3138 &$func($ds, $drive, @param);
3143 my ($conf, $func, @param) = @_;
3147 my $test_volid = sub {
3148 my ($volid, $is_cdrom, $replicate, $shared, $snapname, $size) = @_;
3152 $volhash->{$volid}->{cdrom
} //= 1;
3153 $volhash->{$volid}->{cdrom
} = 0 if !$is_cdrom;
3155 $volhash->{$volid}->{replicate
} //= 0;
3156 $volhash->{$volid}->{replicate
} = 1 if $replicate;
3158 $volhash->{$volid}->{shared
} //= 0;
3159 $volhash->{$volid}->{shared
} = 1 if $shared;
3161 $volhash->{$volid}->{referenced_in_config
} //= 0;
3162 $volhash->{$volid}->{referenced_in_config
} = 1 if !defined($snapname);
3164 $volhash->{$volid}->{referenced_in_snapshot
}->{$snapname} = 1
3165 if defined($snapname);
3166 $volhash->{$volid}->{size
} = $size if $size;
3169 foreach_drive
($conf, sub {
3170 my ($ds, $drive) = @_;
3171 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, undef, $drive->{size
});
3174 foreach my $snapname (keys %{$conf->{snapshots
}}) {
3175 my $snap = $conf->{snapshots
}->{$snapname};
3176 $test_volid->($snap->{vmstate
}, 0, 1, $snapname);
3177 foreach_drive
($snap, sub {
3178 my ($ds, $drive) = @_;
3179 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, $snapname);
3183 foreach my $volid (keys %$volhash) {
3184 &$func($volid, $volhash->{$volid}, @param);
3188 sub conf_has_serial
{
3191 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3192 if ($conf->{"serial$i"}) {
3200 sub conf_has_audio
{
3201 my ($conf, $id) = @_;
3204 my $audio = $conf->{"audio$id"};
3205 return undef if !defined($audio);
3207 my $audioproperties = PVE
::JSONSchema
::parse_property_string
($audio_fmt, $audio);
3208 my $audiodriver = $audioproperties->{driver
} // 'spice';
3211 dev
=> $audioproperties->{device
},
3212 dev_id
=> "audiodev$id",
3213 backend
=> $audiodriver,
3214 backend_id
=> "$audiodriver-backend${id}",
3218 sub vga_conf_has_spice
{
3221 my $vgaconf = parse_vga
($vga);
3222 my $vgatype = $vgaconf->{type
};
3223 return 0 if !$vgatype || $vgatype !~ m/^qxl([234])?$/;
3230 return get_host_arch
() eq $arch;
3235 return $conf->{arch
} // get_host_arch
();
3238 my $default_machines = {
3243 sub get_vm_machine
{
3244 my ($conf, $forcemachine, $arch, $add_pve_version) = @_;
3246 my $machine = $forcemachine || $conf->{machine
};
3248 if (!$machine || $machine =~ m/^(?:pc|q35|virt)$/) {
3250 $machine ||= $default_machines->{$arch};
3251 $machine .= "+pve$PVE::QemuServer::Machine::PVE_MACHINE_VERSION" if $add_pve_version;
3257 sub get_ovmf_files
($) {
3260 my $ovmf = $OVMF->{$arch}
3261 or die "no OVMF images known for architecture '$arch'\n";
3267 aarch64
=> '/usr/bin/qemu-system-aarch64',
3268 x86_64
=> '/usr/bin/qemu-system-x86_64',
3270 sub get_command_for_arch
($) {
3272 return '/usr/bin/kvm' if is_native
($arch);
3274 my $cmd = $Arch2Qemu->{$arch}
3275 or die "don't know how to emulate architecture '$arch'\n";
3279 # To use query_supported_cpu_flags and query_understood_cpu_flags to get flags
3280 # to use in a QEMU command line (-cpu element), first array_intersect the result
3281 # of query_supported_ with query_understood_. This is necessary because:
3283 # a) query_understood_ returns flags the host cannot use and
3284 # b) query_supported_ (rather the QMP call) doesn't actually return CPU
3285 # flags, but CPU settings - with most of them being flags. Those settings
3286 # (and some flags, curiously) cannot be specified as a "-cpu" argument.
3288 # query_supported_ needs to start up to 2 temporary VMs and is therefore rather
3289 # expensive. If you need the value returned from this, you can get it much
3290 # cheaper from pmxcfs using PVE::Cluster::get_node_kv('cpuflags-$accel') with
3291 # $accel being 'kvm' or 'tcg'.
3293 # pvestatd calls this function on startup and whenever the QEMU/KVM version
3294 # changes, automatically populating pmxcfs.
3296 # Returns: { kvm => [ flagX, flagY, ... ], tcg => [ flag1, flag2, ... ] }
3297 # since kvm and tcg machines support different flags
3299 sub query_supported_cpu_flags
{
3302 $arch //= get_host_arch
();
3303 my $default_machine = $default_machines->{$arch};
3307 # FIXME: Once this is merged, the code below should work for ARM as well:
3308 # https://lists.nongnu.org/archive/html/qemu-devel/2019-06/msg04947.html
3309 die "QEMU/KVM cannot detect CPU flags on ARM (aarch64)\n" if
3312 my $kvm_supported = defined(kvm_version
());
3313 my $qemu_cmd = get_command_for_arch
($arch);
3315 my $pidfile = PVE
::QemuServer
::Helpers
::pidfile_name
($fakevmid);
3317 # Start a temporary (frozen) VM with vmid -1 to allow sending a QMP command
3318 my $query_supported_run_qemu = sub {
3324 '-machine', $default_machine,
3326 '-chardev', "socket,id=qmp,path=/var/run/qemu-server/$fakevmid.qmp,server,nowait",
3327 '-mon', 'chardev=qmp,mode=control',
3328 '-pidfile', $pidfile,
3333 push @$cmd, '-accel', 'tcg';
3336 my $rc = run_command
($cmd, noerr
=> 1, quiet
=> 0);
3337 die "QEMU flag querying VM exited with code " . $rc if $rc;
3340 my $cmd_result = mon_cmd
(
3342 'query-cpu-model-expansion',
3344 model
=> { name
=> 'host' }
3347 my $props = $cmd_result->{model
}->{props
};
3348 foreach my $prop (keys %$props) {
3349 next if $props->{$prop} ne '1';
3350 # QEMU returns some flags multiple times, with '_', '.' or '-'
3351 # (e.g. lahf_lm and lahf-lm; sse4.2, sse4-2 and sse4_2; ...).
3352 # We only keep those with underscores, to match /proc/cpuinfo
3353 $prop =~ s/\.|-/_/g;
3354 $flags->{$prop} = 1;
3359 # force stop with 10 sec timeout and 'nocheck'
3360 # always stop, even if QMP failed
3361 vm_stop
(undef, $fakevmid, 1, 1, 10, 0, 1);
3365 return [ sort keys %$flags ];
3368 # We need to query QEMU twice, since KVM and TCG have different supported flags
3369 PVE
::QemuConfig-
>lock_config($fakevmid, sub {
3370 $flags->{tcg
} = eval { $query_supported_run_qemu->(0) };
3371 warn "warning: failed querying supported tcg flags: $@\n" if $@;
3373 if ($kvm_supported) {
3374 $flags->{kvm
} = eval { $query_supported_run_qemu->(1) };
3375 warn "warning: failed querying supported kvm flags: $@\n" if $@;
3382 # Understood CPU flags are written to a file at 'pve-qemu' compile time
3383 my $understood_cpu_flag_dir = "/usr/share/kvm";
3384 sub query_understood_cpu_flags
{
3385 my $arch = get_host_arch
();
3386 my $filepath = "$understood_cpu_flag_dir/recognized-CPUID-flags-$arch";
3388 die "Cannot query understood QEMU CPU flags for architecture: $arch (file not found)\n"
3391 my $raw = file_get_contents
($filepath);
3392 $raw =~ s/^\s+|\s+$//g;
3393 my @flags = split(/\s+/, $raw);
3398 sub config_to_command
{
3399 my ($storecfg, $vmid, $conf, $defaults, $forcemachine) = @_;
3402 my $globalFlags = [];
3403 my $machineFlags = [];
3408 my $vernum = 0; # unknown
3409 my $ostype = $conf->{ostype
};
3410 my $winversion = windows_version
($ostype);
3411 my $kvm = $conf->{kvm
};
3412 my $nodename = nodename
();
3414 my $arch = get_vm_arch
($conf);
3415 my $kvm_binary = get_command_for_arch
($arch);
3416 my $kvmver = kvm_user_version
($kvm_binary);
3418 my $add_pve_version = min_version
($kvmver, 4, 1);
3420 my $machine_type = get_vm_machine
($conf, $forcemachine, $arch, $add_pve_version);
3421 my $machine_version = PVE
::QemuServer
::Machine
::extract_version
($machine_type, $kvmver);
3422 $kvm //= 1 if is_native
($arch);
3424 $machine_version =~ m/(\d+)\.(\d+)/;
3425 die "Installed QEMU version '$kvmver' is too old to run machine type '$machine_type', please upgrade node '$nodename'\n"
3426 if !PVE
::QemuServer
::min_version
($kvmver, $1, $2);
3429 die "KVM virtualisation configured, but not available. Either disable in VM configuration or enable in BIOS.\n"
3430 if !defined kvm_version
();
3433 if ($kvmver =~ m/^(\d+)\.(\d+)$/) {
3434 $vernum = $1*1000000+$2*1000;
3435 } elsif ($kvmver =~ m/^(\d+)\.(\d+)\.(\d+)$/) {
3436 $vernum = $1*1000000+$2*1000+$3;
3439 die "detected old qemu-kvm binary ($kvmver)\n" if $vernum < 15000;
3441 my $q35 = PVE
::QemuServer
::Machine
::machine_type_is_q35
($conf);
3442 my $hotplug_features = parse_hotplug_features
(defined($conf->{hotplug
}) ?
$conf->{hotplug
} : '1');
3443 my $use_old_bios_files = undef;
3444 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
3446 my $cpuunits = defined($conf->{cpuunits
}) ?
3447 $conf->{cpuunits
} : $defaults->{cpuunits
};
3449 push @$cmd, $kvm_binary;
3451 push @$cmd, '-id', $vmid;
3453 my $vmname = $conf->{name
} || "vm$vmid";
3455 push @$cmd, '-name', $vmname;
3459 my $qmpsocket = PVE
::QemuServer
::Helpers
::qmp_socket
($vmid);
3460 push @$cmd, '-chardev', "socket,id=qmp,path=$qmpsocket,server,nowait";
3461 push @$cmd, '-mon', "chardev=qmp,mode=control";
3463 if (min_version
($machine_version, 2, 12)) {
3464 push @$cmd, '-chardev', "socket,id=qmp-event,path=/var/run/qmeventd.sock,reconnect=5";
3465 push @$cmd, '-mon', "chardev=qmp-event,mode=control";
3468 push @$cmd, '-pidfile' , PVE
::QemuServer
::Helpers
::pidfile_name
($vmid);
3470 push @$cmd, '-daemonize';
3472 if ($conf->{smbios1
}) {
3473 my $smbios_conf = parse_smbios1
($conf->{smbios1
});
3474 if ($smbios_conf->{base64
}) {
3475 # Do not pass base64 flag to qemu
3476 delete $smbios_conf->{base64
};
3477 my $smbios_string = "";
3478 foreach my $key (keys %$smbios_conf) {
3480 if ($key eq "uuid") {
3481 $value = $smbios_conf->{uuid
}
3483 $value = decode_base64
($smbios_conf->{$key});
3485 # qemu accepts any binary data, only commas need escaping by double comma
3487 $smbios_string .= "," . $key . "=" . $value if $value;
3489 push @$cmd, '-smbios', "type=1" . $smbios_string;
3491 push @$cmd, '-smbios', "type=1,$conf->{smbios1}";
3495 my ($ovmf_code, $ovmf_vars) = get_ovmf_files
($arch);
3496 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3497 die "uefi base image not found\n" if ! -f
$ovmf_code;
3501 if (my $efidisk = $conf->{efidisk0
}) {
3502 my $d = PVE
::JSONSchema
::parse_property_string
($efidisk_fmt, $efidisk);
3503 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($d->{file
}, 1);
3504 $format = $d->{format
};
3506 $path = PVE
::Storage
::path
($storecfg, $d->{file
});
3507 if (!defined($format)) {
3508 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
3509 $format = qemu_img_format
($scfg, $volname);
3513 die "efidisk format must be specified\n"
3514 if !defined($format);
3517 warn "no efidisk configured! Using temporary efivars disk.\n";
3518 $path = "/tmp/$vmid-ovmf.fd";
3519 PVE
::Tools
::file_copy
($ovmf_vars, $path, -s
$ovmf_vars);
3523 push @$cmd, '-drive', "if=pflash,unit=0,format=raw,readonly,file=$ovmf_code";
3524 push @$cmd, '-drive', "if=pflash,unit=1,format=$format,id=drive-efidisk0,file=$path";
3529 # we use different pcie-port hardware for qemu >= 4.0 for passthrough
3530 if (min_version
($machine_version, 4, 0)) {
3531 push @$devices, '-readconfig', '/usr/share/qemu-server/pve-q35-4.0.cfg';
3533 push @$devices, '-readconfig', '/usr/share/qemu-server/pve-q35.cfg';
3537 if ($conf->{vmgenid
}) {
3538 push @$devices, '-device', 'vmgenid,guid='.$conf->{vmgenid
};
3541 # add usb controllers
3542 my @usbcontrollers = PVE
::QemuServer
::USB
::get_usb_controllers
($conf, $bridges, $arch, $machine_type, $usbdesc->{format
}, $MAX_USB_DEVICES);
3543 push @$devices, @usbcontrollers if @usbcontrollers;
3544 my $vga = parse_vga
($conf->{vga
});
3546 my $qxlnum = vga_conf_has_spice
($conf->{vga
});
3547 $vga->{type
} = 'qxl' if $qxlnum;
3549 if (!$vga->{type
}) {
3550 if ($arch eq 'aarch64') {
3551 $vga->{type
} = 'virtio';
3552 } elsif (min_version
($machine_version, 2, 9)) {
3553 $vga->{type
} = (!$winversion || $winversion >= 6) ?
'std' : 'cirrus';
3555 $vga->{type
} = ($winversion >= 6) ?
'std' : 'cirrus';
3559 # enable absolute mouse coordinates (needed by vnc)
3561 if (defined($conf->{tablet
})) {
3562 $tablet = $conf->{tablet
};
3564 $tablet = $defaults->{tablet
};
3565 $tablet = 0 if $qxlnum; # disable for spice because it is not needed
3566 $tablet = 0 if $vga->{type
} =~ m/^serial\d+$/; # disable if we use serial terminal (no vga card)
3570 push @$devices, '-device', print_tabletdevice_full
($conf, $arch) if $tablet;
3571 my $kbd = print_keyboarddevice_full
($conf, $arch);
3572 push @$devices, '-device', $kbd if defined($kbd);
3576 my $gpu_passthrough;
3579 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
3580 my $id = "hostpci$i";
3581 my $d = parse_hostpci
($conf->{$id});
3584 if (my $pcie = $d->{pcie
}) {
3585 die "q35 machine model is not enabled" if !$q35;
3586 # win7 wants to have the pcie devices directly on the pcie bus
3587 # instead of in the root port
3588 if ($winversion == 7) {
3589 $pciaddr = print_pcie_addr
("${id}bus0");
3591 # add more root ports if needed, 4 are present by default
3592 # by pve-q35 cfgs, rest added here on demand.
3594 push @$devices, '-device', print_pcie_root_port
($i);
3596 $pciaddr = print_pcie_addr
($id);
3599 $pciaddr = print_pci_addr
($id, $bridges, $arch, $machine_type);
3603 if ($d->{'x-vga'}) {
3604 $xvga = ',x-vga=on' if !($conf->{bios
} && $conf->{bios
} eq 'ovmf');
3606 $vga->{type
} = 'none' if !defined($conf->{vga
});
3607 $gpu_passthrough = 1;
3610 my $pcidevices = $d->{pciid
};
3611 my $multifunction = 1 if @$pcidevices > 1;
3614 if ($d->{mdev
} && scalar(@$pcidevices) == 1) {
3615 my $pci_id = $pcidevices->[0]->{id
};
3616 my $uuid = PVE
::SysFSTools
::generate_mdev_uuid
($vmid, $i);
3617 $sysfspath = "/sys/bus/pci/devices/$pci_id/$uuid";
3618 } elsif ($d->{mdev
}) {
3619 warn "ignoring mediated device '$id' with multifunction device\n";
3623 foreach my $pcidevice (@$pcidevices) {
3624 my $devicestr = "vfio-pci";
3627 $devicestr .= ",sysfsdev=$sysfspath";
3629 $devicestr .= ",host=$pcidevice->{id}";
3632 my $mf_addr = $multifunction ?
".$j" : '';
3633 $devicestr .= ",id=${id}${mf_addr}${pciaddr}${mf_addr}";
3636 $devicestr .= ',rombar=0' if defined($d->{rombar
}) && !$d->{rombar
};
3637 $devicestr .= "$xvga";
3638 $devicestr .= ",multifunction=on" if $multifunction;
3639 $devicestr .= ",romfile=/usr/share/kvm/$d->{romfile}" if $d->{romfile
};
3642 push @$devices, '-device', $devicestr;
3648 my $usb_dev_features = {};
3649 $usb_dev_features->{spice_usb3
} = 1 if min_version
($machine_version, 4, 0);
3651 my @usbdevices = PVE
::QemuServer
::USB
::get_usb_devices
($conf, $usbdesc->{format
}, $MAX_USB_DEVICES, $usb_dev_features);
3652 push @$devices, @usbdevices if @usbdevices;
3654 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3655 if (my $path = $conf->{"serial$i"}) {
3656 if ($path eq 'socket') {
3657 my $socket = "/var/run/qemu-server/${vmid}.serial$i";
3658 push @$devices, '-chardev', "socket,id=serial$i,path=$socket,server,nowait";
3659 # On aarch64, serial0 is the UART device. Qemu only allows
3660 # connecting UART devices via the '-serial' command line, as
3661 # the device has a fixed slot on the hardware...
3662 if ($arch eq 'aarch64' && $i == 0) {
3663 push @$devices, '-serial', "chardev:serial$i";
3665 push @$devices, '-device', "isa-serial,chardev=serial$i";
3668 die "no such serial device\n" if ! -c
$path;
3669 push @$devices, '-chardev', "tty,id=serial$i,path=$path";
3670 push @$devices, '-device', "isa-serial,chardev=serial$i";
3676 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
3677 if (my $path = $conf->{"parallel$i"}) {
3678 die "no such parallel device\n" if ! -c
$path;
3679 my $devtype = $path =~ m!^/dev/usb/lp! ?
'tty' : 'parport';
3680 push @$devices, '-chardev', "$devtype,id=parallel$i,path=$path";
3681 push @$devices, '-device', "isa-parallel,chardev=parallel$i";
3685 if (my $audio = conf_has_audio
($conf)) {
3687 my $audiopciaddr = print_pci_addr
("audio0", $bridges, $arch, $machine_type);
3689 my $id = $audio->{dev_id
};
3690 if ($audio->{dev
} eq 'AC97') {
3691 push @$devices, '-device', "AC97,id=${id}${audiopciaddr}";
3692 } elsif ($audio->{dev
} =~ /intel\-hda$/) {
3693 push @$devices, '-device', "$audio->{dev},id=${id}${audiopciaddr}";
3694 push @$devices, '-device', "hda-micro,id=${id}-codec0,bus=${id}.0,cad=0";
3695 push @$devices, '-device', "hda-duplex,id=${id}-codec1,bus=${id}.0,cad=1";
3697 die "unkown audio device '$audio->{dev}', implement me!";
3700 push @$devices, '-audiodev', "$audio->{backend},id=$audio->{backend_id}";
3704 $sockets = $conf->{smp
} if $conf->{smp
}; # old style - no longer iused
3705 $sockets = $conf->{sockets
} if $conf->{sockets
};
3707 my $cores = $conf->{cores
} || 1;
3709 my $maxcpus = $sockets * $cores;
3711 my $vcpus = $conf->{vcpus
} ?
$conf->{vcpus
} : $maxcpus;
3713 my $allowed_vcpus = $cpuinfo->{cpus
};
3715 die "MAX $allowed_vcpus vcpus allowed per VM on this node\n"
3716 if ($allowed_vcpus < $maxcpus);
3718 if($hotplug_features->{cpu
} && min_version
($machine_version, 2, 7)) {
3720 push @$cmd, '-smp', "1,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3721 for (my $i = 2; $i <= $vcpus; $i++) {
3722 my $cpustr = print_cpu_device
($conf,$i);
3723 push @$cmd, '-device', $cpustr;
3728 push @$cmd, '-smp', "$vcpus,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3730 push @$cmd, '-nodefaults';
3732 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
3734 my $bootindex_hash = {};
3736 foreach my $o (split(//, $bootorder)) {
3737 $bootindex_hash->{$o} = $i*100;
3741 push @$cmd, '-boot', "menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg";
3743 push @$cmd, '-no-acpi' if defined($conf->{acpi
}) && $conf->{acpi
} == 0;
3745 push @$cmd, '-no-reboot' if defined($conf->{reboot
}) && $conf->{reboot
} == 0;
3747 if ($vga->{type
} && $vga->{type
} !~ m/^serial\d+$/ && $vga->{type
} ne 'none'){
3748 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_version, $machine_type, undef, $qxlnum, $bridges);
3749 my $socket = PVE
::QemuServer
::Helpers
::vnc_socket
($vmid);
3750 push @$cmd, '-vnc', "unix:$socket,password";
3752 push @$cmd, '-vga', 'none' if $vga->{type
} eq 'none';
3753 push @$cmd, '-nographic';
3757 my $tdf = defined($conf->{tdf
}) ?
$conf->{tdf
} : $defaults->{tdf
};
3759 my $useLocaltime = $conf->{localtime};
3761 if ($winversion >= 5) { # windows
3762 $useLocaltime = 1 if !defined($conf->{localtime});
3764 # use time drift fix when acpi is enabled
3765 if (!(defined($conf->{acpi
}) && $conf->{acpi
} == 0)) {
3766 $tdf = 1 if !defined($conf->{tdf
});
3770 if ($winversion >= 6) {
3771 push @$globalFlags, 'kvm-pit.lost_tick_policy=discard';
3772 push @$cmd, '-no-hpet';
3775 push @$rtcFlags, 'driftfix=slew' if $tdf;
3778 push @$machineFlags, 'accel=tcg';
3781 if ($machine_type) {
3782 push @$machineFlags, "type=${machine_type}";
3785 if (($conf->{startdate
}) && ($conf->{startdate
} ne 'now')) {
3786 push @$rtcFlags, "base=$conf->{startdate}";
3787 } elsif ($useLocaltime) {
3788 push @$rtcFlags, 'base=localtime';
3791 push @$cmd, get_cpu_options
($conf, $arch, $kvm, $kvm_off, $machine_version, $winversion, $gpu_passthrough);
3793 PVE
::QemuServer
::Memory
::config
($conf, $vmid, $sockets, $cores, $defaults, $hotplug_features, $cmd);
3795 push @$cmd, '-S' if $conf->{freeze
};
3797 push @$cmd, '-k', $conf->{keyboard
} if defined($conf->{keyboard
});
3799 my $guest_agent = parse_guest_agent
($conf);
3801 if ($guest_agent->{enabled
}) {
3802 my $qgasocket = PVE
::QemuServer
::Helpers
::qmp_socket
($vmid, 1);
3803 push @$devices, '-chardev', "socket,path=$qgasocket,server,nowait,id=qga0";
3805 if (!$guest_agent->{type
} || $guest_agent->{type
} eq 'virtio') {
3806 my $pciaddr = print_pci_addr
("qga0", $bridges, $arch, $machine_type);
3807 push @$devices, '-device', "virtio-serial,id=qga0$pciaddr";
3808 push @$devices, '-device', 'virtserialport,chardev=qga0,name=org.qemu.guest_agent.0';
3809 } elsif ($guest_agent->{type
} eq 'isa') {
3810 push @$devices, '-device', "isa-serial,chardev=qga0";
3819 for(my $i = 1; $i < $qxlnum; $i++){
3820 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_version, $machine_type, $i, $qxlnum, $bridges);
3823 # assume other OS works like Linux
3824 my ($ram, $vram) = ("134217728", "67108864");
3825 if ($vga->{memory
}) {
3826 $ram = PVE
::Tools
::convert_size
($qxlnum*4*$vga->{memory
}, 'mb' => 'b');
3827 $vram = PVE
::Tools
::convert_size
($qxlnum*2*$vga->{memory
}, 'mb' => 'b');
3829 push @$cmd, '-global', "qxl-vga.ram_size=$ram";
3830 push @$cmd, '-global', "qxl-vga.vram_size=$vram";
3834 my $pciaddr = print_pci_addr
("spice", $bridges, $arch, $machine_type);
3836 my $pfamily = PVE
::Tools
::get_host_address_family
($nodename);
3837 my @nodeaddrs = PVE
::Tools
::getaddrinfo_all
('localhost', family
=> $pfamily);
3838 die "failed to get an ip address of type $pfamily for 'localhost'\n" if !@nodeaddrs;
3840 push @$devices, '-device', "virtio-serial,id=spice$pciaddr";
3841 push @$devices, '-chardev', "spicevmc,id=vdagent,name=vdagent";
3842 push @$devices, '-device', "virtserialport,chardev=vdagent,name=com.redhat.spice.0";
3844 my $localhost = PVE
::Network
::addr_to_ip
($nodeaddrs[0]->{addr
});
3845 $spice_port = PVE
::Tools
::next_spice_port
($pfamily, $localhost);
3847 my $spice_enhancement = PVE
::JSONSchema
::parse_property_string
($spice_enhancements_fmt, $conf->{spice_enhancements
} // '');
3848 if ($spice_enhancement->{foldersharing
}) {
3849 push @$devices, '-chardev', "spiceport,id=foldershare,name=org.spice-space.webdav.0";
3850 push @$devices, '-device', "virtserialport,chardev=foldershare,name=org.spice-space.webdav.0";
3853 my $spice_opts = "tls-port=${spice_port},addr=$localhost,tls-ciphers=HIGH,seamless-migration=on";
3854 $spice_opts .= ",streaming-video=$spice_enhancement->{videostreaming}" if $spice_enhancement->{videostreaming
};
3855 push @$devices, '-spice', "$spice_opts";
3858 # enable balloon by default, unless explicitly disabled
3859 if (!defined($conf->{balloon
}) || $conf->{balloon
}) {
3860 $pciaddr = print_pci_addr
("balloon0", $bridges, $arch, $machine_type);
3861 push @$devices, '-device', "virtio-balloon-pci,id=balloon0$pciaddr";
3864 if ($conf->{watchdog
}) {
3865 my $wdopts = parse_watchdog
($conf->{watchdog
});
3866 $pciaddr = print_pci_addr
("watchdog", $bridges, $arch, $machine_type);
3867 my $watchdog = $wdopts->{model
} || 'i6300esb';
3868 push @$devices, '-device', "$watchdog$pciaddr";
3869 push @$devices, '-watchdog-action', $wdopts->{action
} if $wdopts->{action
};
3873 my $scsicontroller = {};
3874 my $ahcicontroller = {};
3875 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : $defaults->{scsihw
};
3877 # Add iscsi initiator name if available
3878 if (my $initiator = get_initiator_name
()) {
3879 push @$devices, '-iscsi', "initiator-name=$initiator";
3882 foreach_drive
($conf, sub {
3883 my ($ds, $drive) = @_;
3885 if (PVE
::Storage
::parse_volume_id
($drive->{file
}, 1)) {
3886 push @$vollist, $drive->{file
};
3889 # ignore efidisk here, already added in bios/fw handling code above
3890 return if $drive->{interface
} eq 'efidisk';
3892 $use_virtio = 1 if $ds =~ m/^virtio/;
3894 if (drive_is_cdrom
($drive)) {
3895 if ($bootindex_hash->{d
}) {
3896 $drive->{bootindex
} = $bootindex_hash->{d
};
3897 $bootindex_hash->{d
} += 1;
3900 if ($bootindex_hash->{c
}) {
3901 $drive->{bootindex
} = $bootindex_hash->{c
} if $conf->{bootdisk
} && ($conf->{bootdisk
} eq $ds);
3902 $bootindex_hash->{c
} += 1;
3906 if($drive->{interface
} eq 'virtio'){
3907 push @$cmd, '-object', "iothread,id=iothread-$ds" if $drive->{iothread
};
3910 if ($drive->{interface
} eq 'scsi') {
3912 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
3914 $pciaddr = print_pci_addr
("$controller_prefix$controller", $bridges, $arch, $machine_type);
3915 my $scsihw_type = $scsihw =~ m/^virtio-scsi-single/ ?
"virtio-scsi-pci" : $scsihw;
3918 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{iothread
}){
3919 $iothread .= ",iothread=iothread-$controller_prefix$controller";
3920 push @$cmd, '-object', "iothread,id=iothread-$controller_prefix$controller";
3921 } elsif ($drive->{iothread
}) {
3922 warn "iothread is only valid with virtio disk or virtio-scsi-single controller, ignoring\n";
3926 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{queues
}){
3927 $queues = ",num_queues=$drive->{queues}";
3930 push @$devices, '-device', "$scsihw_type,id=$controller_prefix$controller$pciaddr$iothread$queues" if !$scsicontroller->{$controller};
3931 $scsicontroller->{$controller}=1;
3934 if ($drive->{interface
} eq 'sata') {
3935 my $controller = int($drive->{index} / $MAX_SATA_DISKS);
3936 $pciaddr = print_pci_addr
("ahci$controller", $bridges, $arch, $machine_type);
3937 push @$devices, '-device', "ahci,id=ahci$controller,multifunction=on$pciaddr" if !$ahcicontroller->{$controller};
3938 $ahcicontroller->{$controller}=1;
3941 my $drive_cmd = print_drive_full
($storecfg, $vmid, $drive);
3942 push @$devices, '-drive',$drive_cmd;
3943 push @$devices, '-device', print_drivedevice_full
($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type);
3946 for (my $i = 0; $i < $MAX_NETS; $i++) {
3947 next if !$conf->{"net$i"};
3948 my $d = parse_net
($conf->{"net$i"});
3951 $use_virtio = 1 if $d->{model
} eq 'virtio';
3953 if ($bootindex_hash->{n
}) {
3954 $d->{bootindex
} = $bootindex_hash->{n
};
3955 $bootindex_hash->{n
} += 1;
3958 my $netdevfull = print_netdev_full
($vmid, $conf, $arch, $d, "net$i");
3959 push @$devices, '-netdev', $netdevfull;
3961 my $netdevicefull = print_netdevice_full
($vmid, $conf, $d, "net$i", $bridges, $use_old_bios_files, $arch, $machine_type);
3962 push @$devices, '-device', $netdevicefull;
3965 if ($conf->{ivshmem
}) {
3966 my $ivshmem = PVE
::JSONSchema
::parse_property_string
($ivshmem_fmt, $conf->{ivshmem
});
3970 $bus = print_pcie_addr
("ivshmem");
3972 $bus = print_pci_addr
("ivshmem", $bridges, $arch, $machine_type);
3975 my $ivshmem_name = $ivshmem->{name
} // $vmid;
3976 my $path = '/dev/shm/pve-shm-' . $ivshmem_name;
3978 push @$devices, '-device', "ivshmem-plain,memdev=ivshmem$bus,";
3979 push @$devices, '-object', "memory-backend-file,id=ivshmem,share=on,mem-path=$path,size=$ivshmem->{size}M";
3984 if (min_version
($machine_version, 2, 3)) {
3989 $bridges->{3} = 1 if $scsihw =~ m/^virtio-scsi-single/;
3991 for my $k (sort {$b cmp $a} keys %$bridges) {
3992 $pciaddr = print_pci_addr
("pci.$k", undef, $arch, $machine_type);
3993 unshift @$devices, '-device', "pci-bridge,id=pci.$k,chassis_nr=$k$pciaddr" if $k > 0;
3997 push @$cmd, @$devices;
3998 push @$cmd, '-rtc', join(',', @$rtcFlags)
3999 if scalar(@$rtcFlags);
4000 push @$cmd, '-machine', join(',', @$machineFlags)
4001 if scalar(@$machineFlags);
4002 push @$cmd, '-global', join(',', @$globalFlags)
4003 if scalar(@$globalFlags);
4005 if (my $vmstate = $conf->{vmstate
}) {
4006 my $statepath = PVE
::Storage
::path
($storecfg, $vmstate);
4007 push @$vollist, $vmstate;
4008 push @$cmd, '-loadstate', $statepath;
4009 print "activating and using '$vmstate' as vmstate\n";
4013 if ($conf->{args
}) {
4014 my $aa = PVE
::Tools
::split_args
($conf->{args
});
4018 return wantarray ?
($cmd, $vollist, $spice_port) : $cmd;
4024 my $res = mon_cmd
($vmid, 'query-spice');
4026 return $res->{'tls-port'} || $res->{'port'} || die "no spice port\n";
4029 sub vm_devices_list
{
4032 my $res = mon_cmd
($vmid, 'query-pci');
4033 my $devices_to_check = [];
4035 foreach my $pcibus (@$res) {
4036 push @$devices_to_check, @{$pcibus->{devices
}},
4039 while (@$devices_to_check) {
4041 for my $d (@$devices_to_check) {
4042 $devices->{$d->{'qdev_id'}} = 1 if $d->{'qdev_id'};
4043 next if !$d->{'pci_bridge'};
4045 $devices->{$d->{'qdev_id'}} += scalar(@{$d->{'pci_bridge'}->{devices
}});
4046 push @$to_check, @{$d->{'pci_bridge'}->{devices
}};
4048 $devices_to_check = $to_check;
4051 my $resblock = mon_cmd
($vmid, 'query-block');
4052 foreach my $block (@$resblock) {
4053 if($block->{device
} =~ m/^drive-(\S+)/){
4058 my $resmice = mon_cmd
($vmid, 'query-mice');
4059 foreach my $mice (@$resmice) {
4060 if ($mice->{name
} eq 'QEMU HID Tablet') {
4061 $devices->{tablet
} = 1;
4066 # for usb devices there is no query-usb
4067 # but we can iterate over the entries in
4068 # qom-list path=/machine/peripheral
4069 my $resperipheral = mon_cmd
($vmid, 'qom-list', path
=> '/machine/peripheral');
4070 foreach my $per (@$resperipheral) {
4071 if ($per->{name
} =~ m/^usb\d+$/) {
4072 $devices->{$per->{name
}} = 1;
4080 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4082 my $q35 = PVE
::QemuServer
::Machine
::machine_type_is_q35
($conf);
4084 my $devices_list = vm_devices_list
($vmid);
4085 return 1 if defined($devices_list->{$deviceid});
4087 qemu_add_pci_bridge
($storecfg, $conf, $vmid, $deviceid, $arch, $machine_type); # add PCI bridge if we need it for the device
4089 if ($deviceid eq 'tablet') {
4091 qemu_deviceadd
($vmid, print_tabletdevice_full
($conf, $arch));
4093 } elsif ($deviceid eq 'keyboard') {
4095 qemu_deviceadd
($vmid, print_keyboarddevice_full
($conf, $arch));
4097 } elsif ($deviceid =~ m/^usb(\d+)$/) {
4099 die "usb hotplug currently not reliable\n";
4100 # since we can't reliably hot unplug all added usb devices
4101 # and usb passthrough disables live migration
4102 # we disable usb hotplugging for now
4103 qemu_deviceadd
($vmid, PVE
::QemuServer
::USB
::print_usbdevice_full
($conf, $deviceid, $device));
4105 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4107 qemu_iothread_add
($vmid, $deviceid, $device);
4109 qemu_driveadd
($storecfg, $vmid, $device);
4110 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4112 qemu_deviceadd
($vmid, $devicefull);
4113 eval { qemu_deviceaddverify
($vmid, $deviceid); };
4115 eval { qemu_drivedel
($vmid, $deviceid); };
4120 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4123 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : "lsi";
4124 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4125 my $scsihw_type = $scsihw eq 'virtio-scsi-single' ?
"virtio-scsi-pci" : $scsihw;
4127 my $devicefull = "$scsihw_type,id=$deviceid$pciaddr";
4129 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{iothread
}) {
4130 qemu_iothread_add
($vmid, $deviceid, $device);
4131 $devicefull .= ",iothread=iothread-$deviceid";
4134 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{queues
}) {
4135 $devicefull .= ",num_queues=$device->{queues}";
4138 qemu_deviceadd
($vmid, $devicefull);
4139 qemu_deviceaddverify
($vmid, $deviceid);
4141 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4143 qemu_findorcreatescsihw
($storecfg,$conf, $vmid, $device, $arch, $machine_type);
4144 qemu_driveadd
($storecfg, $vmid, $device);
4146 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4147 eval { qemu_deviceadd
($vmid, $devicefull); };
4149 eval { qemu_drivedel
($vmid, $deviceid); };
4154 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4156 return undef if !qemu_netdevadd
($vmid, $conf, $arch, $device, $deviceid);
4158 my $machine_type = PVE
::QemuServer
::Machine
::qemu_machine_pxe
($vmid, $conf);
4159 my $use_old_bios_files = undef;
4160 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
4162 my $netdevicefull = print_netdevice_full
($vmid, $conf, $device, $deviceid, undef, $use_old_bios_files, $arch, $machine_type);
4163 qemu_deviceadd
($vmid, $netdevicefull);
4165 qemu_deviceaddverify
($vmid, $deviceid);
4166 qemu_set_link_status
($vmid, $deviceid, !$device->{link_down
});
4169 eval { qemu_netdevdel
($vmid, $deviceid); };
4174 } elsif (!$q35 && $deviceid =~ m/^(pci\.)(\d+)$/) {
4177 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4178 my $devicefull = "pci-bridge,id=pci.$bridgeid,chassis_nr=$bridgeid$pciaddr";
4180 qemu_deviceadd
($vmid, $devicefull);
4181 qemu_deviceaddverify
($vmid, $deviceid);
4184 die "can't hotplug device '$deviceid'\n";
4190 # fixme: this should raise exceptions on error!
4191 sub vm_deviceunplug
{
4192 my ($vmid, $conf, $deviceid) = @_;
4194 my $devices_list = vm_devices_list
($vmid);
4195 return 1 if !defined($devices_list->{$deviceid});
4197 die "can't unplug bootdisk" if $conf->{bootdisk
} && $conf->{bootdisk
} eq $deviceid;
4199 if ($deviceid eq 'tablet' || $deviceid eq 'keyboard') {
4201 qemu_devicedel
($vmid, $deviceid);
4203 } elsif ($deviceid =~ m/^usb\d+$/) {
4205 die "usb hotplug currently not reliable\n";
4206 # when unplugging usb devices this way,
4207 # there may be remaining usb controllers/hubs
4208 # so we disable it for now
4209 qemu_devicedel
($vmid, $deviceid);
4210 qemu_devicedelverify
($vmid, $deviceid);
4212 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4214 qemu_devicedel
($vmid, $deviceid);
4215 qemu_devicedelverify
($vmid, $deviceid);
4216 qemu_drivedel
($vmid, $deviceid);
4217 qemu_iothread_del
($conf, $vmid, $deviceid);
4219 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4221 qemu_devicedel
($vmid, $deviceid);
4222 qemu_devicedelverify
($vmid, $deviceid);
4223 qemu_iothread_del
($conf, $vmid, $deviceid);
4225 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4227 qemu_devicedel
($vmid, $deviceid);
4228 qemu_drivedel
($vmid, $deviceid);
4229 qemu_deletescsihw
($conf, $vmid, $deviceid);
4231 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4233 qemu_devicedel
($vmid, $deviceid);
4234 qemu_devicedelverify
($vmid, $deviceid);
4235 qemu_netdevdel
($vmid, $deviceid);
4238 die "can't unplug device '$deviceid'\n";
4244 sub qemu_deviceadd
{
4245 my ($vmid, $devicefull) = @_;
4247 $devicefull = "driver=".$devicefull;
4248 my %options = split(/[=,]/, $devicefull);
4250 mon_cmd
($vmid, "device_add" , %options);
4253 sub qemu_devicedel
{
4254 my ($vmid, $deviceid) = @_;
4256 my $ret = mon_cmd
($vmid, "device_del", id
=> $deviceid);
4259 sub qemu_iothread_add
{
4260 my($vmid, $deviceid, $device) = @_;
4262 if ($device->{iothread
}) {
4263 my $iothreads = vm_iothreads_list
($vmid);
4264 qemu_objectadd
($vmid, "iothread-$deviceid", "iothread") if !$iothreads->{"iothread-$deviceid"};
4268 sub qemu_iothread_del
{
4269 my($conf, $vmid, $deviceid) = @_;
4271 my $confid = $deviceid;
4272 if ($deviceid =~ m/^(?:virtioscsi|scsihw)(\d+)$/) {
4273 $confid = 'scsi' . $1;
4275 my $device = parse_drive
($confid, $conf->{$confid});
4276 if ($device->{iothread
}) {
4277 my $iothreads = vm_iothreads_list
($vmid);
4278 qemu_objectdel
($vmid, "iothread-$deviceid") if $iothreads->{"iothread-$deviceid"};
4282 sub qemu_objectadd
{
4283 my($vmid, $objectid, $qomtype) = @_;
4285 mon_cmd
($vmid, "object-add", id
=> $objectid, "qom-type" => $qomtype);
4290 sub qemu_objectdel
{
4291 my($vmid, $objectid) = @_;
4293 mon_cmd
($vmid, "object-del", id
=> $objectid);
4299 my ($storecfg, $vmid, $device) = @_;
4301 my $drive = print_drive_full
($storecfg, $vmid, $device);
4302 $drive =~ s/\\/\\\\/g;
4303 my $ret = PVE
::QemuServer
::Monitor
::hmp_cmd
($vmid, "drive_add auto \"$drive\"");
4305 # If the command succeeds qemu prints: "OK
"
4306 return 1 if $ret =~ m/OK/s;
4308 die "adding drive failed
: $ret\n";
4312 my($vmid, $deviceid) = @_;
4314 my $ret = PVE::QemuServer::Monitor::hmp_cmd($vmid, "drive_del drive-
$deviceid");
4317 return 1 if $ret eq "";
4319 # NB: device not found errors mean the drive was auto-deleted and we ignore the error
4320 return 1 if $ret =~ m/Device \'.*?\' not found/s;
4322 die "deleting drive
$deviceid failed
: $ret\n";
4325 sub qemu_deviceaddverify {
4326 my ($vmid, $deviceid) = @_;
4328 for (my $i = 0; $i <= 5; $i++) {
4329 my $devices_list = vm_devices_list($vmid);
4330 return 1 if defined($devices_list->{$deviceid});
4334 die "error on hotplug device
'$deviceid'\n";
4338 sub qemu_devicedelverify {
4339 my ($vmid, $deviceid) = @_;
4341 # need to verify that the device is correctly removed as device_del
4342 # is async and empty return is not reliable
4344 for (my $i = 0; $i <= 5; $i++) {
4345 my $devices_list = vm_devices_list($vmid);
4346 return 1 if !defined($devices_list->{$deviceid});
4350 die "error on hot-unplugging device
'$deviceid'\n";
4353 sub qemu_findorcreatescsihw {
4354 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4356 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4358 my $scsihwid="$controller_prefix$controller";
4359 my $devices_list = vm_devices_list($vmid);
4361 if(!defined($devices_list->{$scsihwid})) {
4362 vm_deviceplug($storecfg, $conf, $vmid, $scsihwid, $device, $arch, $machine_type);
4368 sub qemu_deletescsihw {
4369 my ($conf, $vmid, $opt) = @_;
4371 my $device = parse_drive($opt, $conf->{$opt});
4373 if ($conf->{scsihw} && ($conf->{scsihw} eq 'virtio-scsi-single')) {
4374 vm_deviceunplug($vmid, $conf, "virtioscsi
$device->{index}");
4378 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4380 my $devices_list = vm_devices_list($vmid);
4381 foreach my $opt (keys %{$devices_list}) {
4382 if (PVE::QemuServer::is_valid_drivename($opt)) {
4383 my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
4384 if($drive->{interface} eq 'scsi' && $drive->{index} < (($maxdev-1)*($controller+1))) {
4390 my $scsihwid="scsihw
$controller";
4392 vm_deviceunplug($vmid, $conf, $scsihwid);
4397 sub qemu_add_pci_bridge {
4398 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4404 print_pci_addr($device, $bridges, $arch, $machine_type);
4406 while (my ($k, $v) = each %$bridges) {
4409 return 1 if !defined($bridgeid) || $bridgeid < 1;
4411 my $bridge = "pci
.$bridgeid";
4412 my $devices_list = vm_devices_list($vmid);
4414 if (!defined($devices_list->{$bridge})) {
4415 vm_deviceplug($storecfg, $conf, $vmid, $bridge, $arch, $machine_type);
4421 sub qemu_set_link_status {
4422 my ($vmid, $device, $up) = @_;
4424 mon_cmd($vmid, "set_link
", name => $device,
4425 up => $up ? JSON::true : JSON::false);
4428 sub qemu_netdevadd {
4429 my ($vmid, $conf, $arch, $device, $deviceid) = @_;
4431 my $netdev = print_netdev_full($vmid, $conf, $arch, $device, $deviceid, 1);
4432 my %options = split(/[=,]/, $netdev);
4434 mon_cmd($vmid, "netdev_add
", %options);
4438 sub qemu_netdevdel {
4439 my ($vmid, $deviceid) = @_;
4441 mon_cmd($vmid, "netdev_del
", id => $deviceid);
4444 sub qemu_usb_hotplug {
4445 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4449 # remove the old one first
4450 vm_deviceunplug($vmid, $conf, $deviceid);
4452 # check if xhci controller is necessary and available
4453 if ($device->{usb3}) {
4455 my $devicelist = vm_devices_list($vmid);
4457 if (!$devicelist->{xhci}) {
4458 my $pciaddr = print_pci_addr("xhci
", undef, $arch, $machine_type);
4459 qemu_deviceadd($vmid, "nec-usb-xhci
,id
=xhci
$pciaddr");
4462 my $d = parse_usb_device($device->{host});
4463 $d->{usb3} = $device->{usb3};
4466 vm_deviceplug($storecfg, $conf, $vmid, $deviceid, $d, $arch, $machine_type);
4469 sub qemu_cpu_hotplug {
4470 my ($vmid, $conf, $vcpus) = @_;
4472 my $machine_type = PVE::QemuServer::Machine::get_current_qemu_machine($vmid);
4475 $sockets = $conf->{smp} if $conf->{smp}; # old style - no longer iused
4476 $sockets = $conf->{sockets} if $conf->{sockets};
4477 my $cores = $conf->{cores} || 1;
4478 my $maxcpus = $sockets * $cores;
4480 $vcpus = $maxcpus if !$vcpus;
4482 die "you can
't add more vcpus than maxcpus\n"
4483 if $vcpus > $maxcpus;
4485 my $currentvcpus = $conf->{vcpus} || $maxcpus;
4487 if ($vcpus < $currentvcpus) {
4489 if (PVE::QemuServer::Machine::machine_version($machine_type, 2, 7)) {
4491 for (my $i = $currentvcpus; $i > $vcpus; $i--) {
4492 qemu_devicedel($vmid, "cpu$i");
4494 my $currentrunningvcpus = undef;
4496 $currentrunningvcpus = mon_cmd($vmid, "query-cpus");
4497 last if scalar(@{$currentrunningvcpus}) == $i-1;
4498 raise_param_exc({ vcpus => "error unplugging cpu$i" }) if $retry > 5;
4502 #update conf after each succesfull cpu unplug
4503 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4504 PVE::QemuConfig->write_config($vmid, $conf);
4507 die "cpu hot-unplugging requires qemu version 2.7 or higher\n";
4513 my $currentrunningvcpus = mon_cmd($vmid, "query-cpus");
4514 die "vcpus in running vm does not match its configuration\n"
4515 if scalar(@{$currentrunningvcpus}) != $currentvcpus;
4517 if (PVE::QemuServer::Machine::machine_version($machine_type, 2, 7)) {
4519 for (my $i = $currentvcpus+1; $i <= $vcpus; $i++) {
4520 my $cpustr = print_cpu_device($conf, $i);
4521 qemu_deviceadd($vmid, $cpustr);
4524 my $currentrunningvcpus = undef;
4526 $currentrunningvcpus = mon_cmd($vmid, "query-cpus");
4527 last if scalar(@{$currentrunningvcpus}) == $i;
4528 raise_param_exc({ vcpus => "error hotplugging cpu$i" }) if $retry > 10;
4532 #update conf after each succesfull cpu hotplug
4533 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4534 PVE::QemuConfig->write_config($vmid, $conf);
4538 for (my $i = $currentvcpus; $i < $vcpus; $i++) {
4539 mon_cmd($vmid, "cpu-add", id => int($i));
4544 sub qemu_block_set_io_throttle {
4545 my ($vmid, $deviceid,
4546 $bps, $bps_rd, $bps_wr, $iops, $iops_rd, $iops_wr,
4547 $bps_max, $bps_rd_max, $bps_wr_max, $iops_max, $iops_rd_max, $iops_wr_max,
4548 $bps_max_length, $bps_rd_max_length, $bps_wr_max_length,
4549 $iops_max_length, $iops_rd_max_length, $iops_wr_max_length) = @_;
4551 return if !check_running($vmid) ;
4553 mon_cmd($vmid, "block_set_io_throttle", device => $deviceid,
4555 bps_rd => int($bps_rd),
4556 bps_wr => int($bps_wr),
4558 iops_rd => int($iops_rd),
4559 iops_wr => int($iops_wr),
4560 bps_max => int($bps_max),
4561 bps_rd_max => int($bps_rd_max),
4562 bps_wr_max => int($bps_wr_max),
4563 iops_max => int($iops_max),
4564 iops_rd_max => int($iops_rd_max),
4565 iops_wr_max => int($iops_wr_max),
4566 bps_max_length => int($bps_max_length),
4567 bps_rd_max_length => int($bps_rd_max_length),
4568 bps_wr_max_length => int($bps_wr_max_length),
4569 iops_max_length => int($iops_max_length),
4570 iops_rd_max_length => int($iops_rd_max_length),
4571 iops_wr_max_length => int($iops_wr_max_length),
4576 # old code, only used to shutdown old VM after update
4578 my ($fh, $timeout) = @_;
4580 my $sel = new IO::Select;
4587 while (scalar (@ready = $sel->can_read($timeout))) {
4589 if ($count = $fh->sysread($buf, 8192)) {
4590 if ($buf =~ /^(.*)\(qemu\) $/s) {
4597 if (!defined($count)) {
4604 die "monitor read timeout\n" if !scalar(@ready);
4609 sub qemu_block_resize {
4610 my ($vmid, $deviceid, $storecfg, $volid, $size) = @_;
4612 my $running = check_running($vmid);
4614 $size = 0 if !PVE::Storage::volume_resize($storecfg, $volid, $size, $running);
4616 return if !$running;
4618 mon_cmd($vmid, "block_resize", device => $deviceid, size => int($size));
4622 sub qemu_volume_snapshot {
4623 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4625 my $running = check_running($vmid);
4627 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4628 mon_cmd($vmid, 'blockdev-snapshot-internal-sync
', device => $deviceid, name => $snap);
4630 PVE::Storage::volume_snapshot($storecfg, $volid, $snap);
4634 sub qemu_volume_snapshot_delete {
4635 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4637 my $running = check_running($vmid);
4642 my $conf = PVE::QemuConfig->load_config($vmid);
4643 foreach_drive($conf, sub {
4644 my ($ds, $drive) = @_;
4645 $running = 1 if $drive->{file} eq $volid;
4649 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4650 mon_cmd($vmid, 'blockdev-snapshot-delete-internal-sync
', device => $deviceid, name => $snap);
4652 PVE::Storage::volume_snapshot_delete($storecfg, $volid, $snap, $running);
4656 sub set_migration_caps {
4662 "auto-converge" => 1,
4664 "x-rdma-pin-all" => 0,
4669 my $supported_capabilities = mon_cmd($vmid, "query-migrate-capabilities");
4671 for my $supported_capability (@$supported_capabilities) {
4673 capability => $supported_capability->{capability},
4674 state => $enabled_cap->{$supported_capability->{capability}} ? JSON::true : JSON::false,
4678 mon_cmd($vmid, "migrate-set-capabilities", capabilities => $cap_ref);
4681 my $fast_plug_option = {
4689 'vmstatestorage
' => 1,
4694 # hotplug changes in [PENDING]
4695 # $selection hash can be used to only apply specified options, for
4696 # example: { cores => 1 } (only apply changed 'cores
')
4697 # $errors ref is used to return error messages
4698 sub vmconfig_hotplug_pending {
4699 my ($vmid, $conf, $storecfg, $selection, $errors) = @_;
4701 my $defaults = load_defaults();
4702 my $arch = get_vm_arch($conf);
4703 my $machine_type = get_vm_machine($conf, undef, $arch);
4705 # commit values which do not have any impact on running VM first
4706 # Note: those option cannot raise errors, we we do not care about
4707 # $selection and always apply them.
4709 my $add_error = sub {
4710 my ($opt, $msg) = @_;
4711 $errors->{$opt} = "hotplug problem - $msg";
4715 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4716 if ($fast_plug_option->{$opt}) {
4717 $conf->{$opt} = $conf->{pending}->{$opt};
4718 delete $conf->{pending}->{$opt};
4724 PVE::QemuConfig->write_config($vmid, $conf);
4727 my $hotplug_features = parse_hotplug_features(defined($conf->{hotplug}) ? $conf->{hotplug} : '1');
4729 my $pending_delete_hash = PVE::QemuConfig->parse_pending_delete($conf->{pending}->{delete});
4730 foreach my $opt (sort keys %$pending_delete_hash) {
4731 next if $selection && !$selection->{$opt};
4732 my $force = $pending_delete_hash->{$opt}->{force};
4734 if ($opt eq 'hotplug
') {
4735 die "skip\n" if ($conf->{hotplug} =~ /memory/);
4736 } elsif ($opt eq 'tablet
') {
4737 die "skip\n" if !$hotplug_features->{usb};
4738 if ($defaults->{tablet}) {
4739 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4740 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4741 if $arch eq 'aarch64
';
4743 vm_deviceunplug($vmid, $conf, 'tablet
');
4744 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4746 } elsif ($opt =~ m/^usb\d+/) {
4748 # since we cannot reliably hot unplug usb devices
4749 # we are disabling it
4750 die "skip\n" if !$hotplug_features->{usb} || $conf->{$opt} =~ m/spice/i;
4751 vm_deviceunplug($vmid, $conf, $opt);
4752 } elsif ($opt eq 'vcpus
') {
4753 die "skip\n" if !$hotplug_features->{cpu};
4754 qemu_cpu_hotplug($vmid, $conf, undef);
4755 } elsif ($opt eq 'balloon
') {
4756 # enable balloon device is not hotpluggable
4757 die "skip\n" if defined($conf->{balloon}) && $conf->{balloon} == 0;
4758 # here we reset the ballooning value to memory
4759 my $balloon = $conf->{memory} || $defaults->{memory};
4760 mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4761 } elsif ($fast_plug_option->{$opt}) {
4763 } elsif ($opt =~ m/^net(\d+)$/) {
4764 die "skip\n" if !$hotplug_features->{network};
4765 vm_deviceunplug($vmid, $conf, $opt);
4766 } elsif (is_valid_drivename($opt)) {
4767 die "skip\n" if !$hotplug_features->{disk} || $opt =~ m/(ide|sata)(\d+)/;
4768 vm_deviceunplug($vmid, $conf, $opt);
4769 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4770 } elsif ($opt =~ m/^memory$/) {
4771 die "skip\n" if !$hotplug_features->{memory};
4772 PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt);
4773 } elsif ($opt eq 'cpuunits
') {
4774 cgroups_write("cpu", $vmid, "cpu.shares", $defaults->{cpuunits});
4775 } elsif ($opt eq 'cpulimit
') {
4776 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", -1);
4782 &$add_error($opt, $err) if $err ne "skip\n";
4784 delete $conf->{$opt};
4785 PVE::QemuConfig->remove_from_pending_delete($conf, $opt);
4789 my ($apply_pending_cloudinit, $apply_pending_cloudinit_done);
4790 $apply_pending_cloudinit = sub {
4791 return if $apply_pending_cloudinit_done; # once is enough
4792 $apply_pending_cloudinit_done = 1; # once is enough
4794 my ($key, $value) = @_;
4796 my @cloudinit_opts = keys %$confdesc_cloudinit;
4797 foreach my $opt (keys %{$conf->{pending}}) {
4798 next if !grep { $_ eq $opt } @cloudinit_opts;
4799 $conf->{$opt} = delete $conf->{pending}->{$opt};
4802 my $new_conf = { %$conf };
4803 $new_conf->{$key} = $value;
4804 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($new_conf, $vmid);
4807 foreach my $opt (keys %{$conf->{pending}}) {
4808 next if $selection && !$selection->{$opt};
4809 my $value = $conf->{pending}->{$opt};
4811 if ($opt eq 'hotplug
') {
4812 die "skip\n" if ($value =~ /memory/) || ($value !~ /memory/ && $conf->{hotplug} =~ /memory/);
4813 } elsif ($opt eq 'tablet
') {
4814 die "skip\n" if !$hotplug_features->{usb};
4816 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4817 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4818 if $arch eq 'aarch64
';
4819 } elsif ($value == 0) {
4820 vm_deviceunplug($vmid, $conf, 'tablet
');
4821 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4823 } elsif ($opt =~ m/^usb\d+$/) {
4825 # since we cannot reliably hot unplug usb devices
4826 # we are disabling it
4827 die "skip\n" if !$hotplug_features->{usb} || $value =~ m/spice/i;
4828 my $d = eval { PVE::JSONSchema::parse_property_string($usbdesc->{format}, $value) };
4829 die "skip\n" if !$d;
4830 qemu_usb_hotplug($storecfg, $conf, $vmid, $opt, $d, $arch, $machine_type);
4831 } elsif ($opt eq 'vcpus
') {
4832 die "skip\n" if !$hotplug_features->{cpu};
4833 qemu_cpu_hotplug($vmid, $conf, $value);
4834 } elsif ($opt eq 'balloon
') {
4835 # enable/disable balloning device is not hotpluggable
4836 my $old_balloon_enabled = !!(!defined($conf->{balloon}) || $conf->{balloon});
4837 my $new_balloon_enabled = !!(!defined($conf->{pending}->{balloon}) || $conf->{pending}->{balloon});
4838 die "skip\n" if $old_balloon_enabled != $new_balloon_enabled;
4840 # allow manual ballooning if shares is set to zero
4841 if ((defined($conf->{shares}) && ($conf->{shares} == 0))) {
4842 my $balloon = $conf->{pending}->{balloon} || $conf->{memory} || $defaults->{memory};
4843 mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4845 } elsif ($opt =~ m/^net(\d+)$/) {
4846 # some changes can be done without hotplug
4847 vmconfig_update_net($storecfg, $conf, $hotplug_features->{network},
4848 $vmid, $opt, $value, $arch, $machine_type);
4849 } elsif (is_valid_drivename($opt)) {
4850 die "skip\n" if $opt eq 'efidisk0
';
4851 # some changes can be done without hotplug
4852 my $drive = parse_drive($opt, $value);
4853 if (drive_is_cloudinit($drive)) {
4854 &$apply_pending_cloudinit($opt, $value);
4856 vmconfig_update_disk($storecfg, $conf, $hotplug_features->{disk},
4857 $vmid, $opt, $value, 1, $arch, $machine_type);
4858 } elsif ($opt =~ m/^memory$/) { #dimms
4859 die "skip\n" if !$hotplug_features->{memory};
4860 $value = PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt, $value);
4861 } elsif ($opt eq 'cpuunits
') {
4862 cgroups_write("cpu", $vmid, "cpu.shares", $conf->{pending}->{$opt});
4863 } elsif ($opt eq 'cpulimit
') {
4864 my $cpulimit = $conf->{pending}->{$opt} == 0 ? -1 : int($conf->{pending}->{$opt} * 100000);
4865 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", $cpulimit);
4867 die "skip\n"; # skip non-hot-pluggable options
4871 &$add_error($opt, $err) if $err ne "skip\n";
4873 $conf->{$opt} = $value;
4874 delete $conf->{pending}->{$opt};
4878 PVE::QemuConfig->write_config($vmid, $conf);
4881 sub try_deallocate_drive {
4882 my ($storecfg, $vmid, $conf, $key, $drive, $rpcenv, $authuser, $force) = @_;
4884 if (($force || $key =~ /^unused/) && !drive_is_cdrom($drive, 1)) {
4885 my $volid = $drive->{file};
4886 if (vm_is_volid_owner($storecfg, $vmid, $volid)) {
4887 my $sid = PVE::Storage::parse_volume_id($volid);
4888 $rpcenv->check($authuser, "/storage/$sid", ['Datastore
.AllocateSpace
']);
4890 # check if the disk is really unused
4891 die "unable to delete '$volid' - volume is still in use (snapshot?)\n"
4892 if is_volume_in_use($storecfg, $conf, $key, $volid);
4893 PVE::Storage::vdisk_free($storecfg, $volid);
4896 # If vm is not owner of this disk remove from config
4904 sub vmconfig_delete_or_detach_drive {
4905 my ($vmid, $storecfg, $conf, $opt, $force) = @_;
4907 my $drive = parse_drive($opt, $conf->{$opt});
4909 my $rpcenv = PVE::RPCEnvironment::get();
4910 my $authuser = $rpcenv->get_user();
4913 $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM
.Config
.Disk
']);
4914 try_deallocate_drive($storecfg, $vmid, $conf, $opt, $drive, $rpcenv, $authuser, $force);
4916 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $drive);
4922 sub vmconfig_apply_pending {
4923 my ($vmid, $conf, $storecfg, $errors) = @_;
4925 my $add_apply_error = sub {
4926 my ($opt, $msg) = @_;
4927 my $err_msg = "unable to apply pending change $opt : $msg";
4928 $errors->{$opt} = $err_msg;
4934 my $pending_delete_hash = PVE::QemuConfig->parse_pending_delete($conf->{pending}->{delete});
4935 foreach my $opt (sort keys %$pending_delete_hash) {
4936 my $force = $pending_delete_hash->{$opt}->{force};
4938 if ($opt =~ m/^unused/) {
4939 die "internal error";
4940 } elsif (defined($conf->{$opt}) && is_valid_drivename($opt)) {
4941 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4945 $add_apply_error->($opt, $err);
4947 PVE::QemuConfig->remove_from_pending_delete($conf, $opt);
4948 delete $conf->{$opt};
4952 PVE::QemuConfig->cleanup_pending($conf);
4954 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4955 next if $opt eq 'delete'; # just to be sure
4957 if (defined($conf->{$opt}) && is_valid_drivename($opt)) {
4958 vmconfig_register_unused_drive($storecfg, $vmid, $conf, parse_drive($opt, $conf->{$opt}))
4962 $add_apply_error->($opt, $err);
4964 $conf->{$opt} = delete $conf->{pending}->{$opt};
4968 # write all changes at once to avoid unnecessary i/o
4969 PVE::QemuConfig->write_config($vmid, $conf);
4972 my $safe_num_ne = sub {
4975 return 0 if !defined($a) && !defined($b);
4976 return 1 if !defined($a);
4977 return 1 if !defined($b);
4982 my $safe_string_ne = sub {
4985 return 0 if !defined($a) && !defined($b);
4986 return 1 if !defined($a);
4987 return 1 if !defined($b);
4992 sub vmconfig_update_net {
4993 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $arch, $machine_type) = @_;
4995 my $newnet = parse_net($value);
4997 if ($conf->{$opt}) {
4998 my $oldnet = parse_net($conf->{$opt});
5000 if (&$safe_string_ne($oldnet->{model}, $newnet->{model}) ||
5001 &$safe_string_ne($oldnet->{macaddr}, $newnet->{macaddr}) ||
5002 &$safe_num_ne($oldnet->{queues}, $newnet->{queues}) ||
5003 !($newnet->{bridge} && $oldnet->{bridge})) { # bridge/nat mode change
5005 # for non online change, we try to hot-unplug
5006 die "skip\n" if !$hotplug;
5007 vm_deviceunplug($vmid, $conf, $opt);
5010 die "internal error" if $opt !~ m/net(\d+)/;
5011 my $iface = "tap${vmid}i$1";
5013 if (&$safe_string_ne($oldnet->{bridge}, $newnet->{bridge}) ||
5014 &$safe_num_ne($oldnet->{tag}, $newnet->{tag}) ||
5015 &$safe_string_ne($oldnet->{trunks}, $newnet->{trunks}) ||
5016 &$safe_num_ne($oldnet->{firewall}, $newnet->{firewall})) {
5017 PVE::Network::tap_unplug($iface);
5018 PVE::Network::tap_plug($iface, $newnet->{bridge}, $newnet->{tag}, $newnet->{firewall}, $newnet->{trunks}, $newnet->{rate});
5019 } elsif (&$safe_num_ne($oldnet->{rate}, $newnet->{rate})) {
5020 # Rate can be applied on its own but any change above needs to
5021 # include the rate in tap_plug since OVS resets everything.
5022 PVE::Network::tap_rate_limit($iface, $newnet->{rate});
5025 if (&$safe_string_ne($oldnet->{link_down}, $newnet->{link_down})) {
5026 qemu_set_link_status($vmid, $opt, !$newnet->{link_down});
5034 vm_deviceplug($storecfg, $conf, $vmid, $opt, $newnet, $arch, $machine_type);
5040 sub vmconfig_update_disk {
5041 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $force, $arch, $machine_type) = @_;
5043 # fixme: do we need force?
5045 my $drive = parse_drive($opt, $value);
5047 if ($conf->{$opt}) {
5049 if (my $old_drive = parse_drive($opt, $conf->{$opt})) {
5051 my $media = $drive->{media} || 'disk
';
5052 my $oldmedia = $old_drive->{media} || 'disk
';
5053 die "unable to change media type\n" if $media ne $oldmedia;
5055 if (!drive_is_cdrom($old_drive)) {
5057 if ($drive->{file} ne $old_drive->{file}) {
5059 die "skip\n" if !$hotplug;
5061 # unplug and register as unused
5062 vm_deviceunplug($vmid, $conf, $opt);
5063 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive)
5066 # update existing disk
5068 # skip non hotpluggable value
5069 if (&$safe_string_ne($drive->{discard}, $old_drive->{discard}) ||
5070 &$safe_string_ne($drive->{iothread}, $old_drive->{iothread}) ||
5071 &$safe_string_ne($drive->{queues}, $old_drive->{queues}) ||
5072 &$safe_string_ne($drive->{cache}, $old_drive->{cache}) ||
5073 &$safe_string_ne($drive->{ssd}, $old_drive->{ssd})) {
5078 if (&$safe_num_ne($drive->{mbps}, $old_drive->{mbps}) ||
5079 &$safe_num_ne($drive->{mbps_rd}, $old_drive->{mbps_rd}) ||
5080 &$safe_num_ne($drive->{mbps_wr}, $old_drive->{mbps_wr}) ||
5081 &$safe_num_ne($drive->{iops}, $old_drive->{iops}) ||
5082 &$safe_num_ne($drive->{iops_rd}, $old_drive->{iops_rd}) ||
5083 &$safe_num_ne($drive->{iops_wr}, $old_drive->{iops_wr}) ||
5084 &$safe_num_ne($drive->{mbps_max}, $old_drive->{mbps_max}) ||
5085 &$safe_num_ne($drive->{mbps_rd_max}, $old_drive->{mbps_rd_max}) ||
5086 &$safe_num_ne($drive->{mbps_wr_max}, $old_drive->{mbps_wr_max}) ||
5087 &$safe_num_ne($drive->{iops_max}, $old_drive->{iops_max}) ||
5088 &$safe_num_ne($drive->{iops_rd_max}, $old_drive->{iops_rd_max}) ||
5089 &$safe_num_ne($drive->{iops_wr_max}, $old_drive->{iops_wr_max}) ||
5090 &$safe_num_ne($drive->{bps_max_length}, $old_drive->{bps_max_length}) ||
5091 &$safe_num_ne($drive->{bps_rd_max_length}, $old_drive->{bps_rd_max_length}) ||
5092 &$safe_num_ne($drive->{bps_wr_max_length}, $old_drive->{bps_wr_max_length}) ||
5093 &$safe_num_ne($drive->{iops_max_length}, $old_drive->{iops_max_length}) ||
5094 &$safe_num_ne($drive->{iops_rd_max_length}, $old_drive->{iops_rd_max_length}) ||
5095 &$safe_num_ne($drive->{iops_wr_max_length}, $old_drive->{iops_wr_max_length})) {
5097 qemu_block_set_io_throttle($vmid,"drive-$opt",
5098 ($drive->{mbps} || 0)*1024*1024,
5099 ($drive->{mbps_rd} || 0)*1024*1024,
5100 ($drive->{mbps_wr} || 0)*1024*1024,
5101 $drive->{iops} || 0,
5102 $drive->{iops_rd} || 0,
5103 $drive->{iops_wr} || 0,
5104 ($drive->{mbps_max} || 0)*1024*1024,
5105 ($drive->{mbps_rd_max} || 0)*1024*1024,
5106 ($drive->{mbps_wr_max} || 0)*1024*1024,
5107 $drive->{iops_max} || 0,
5108 $drive->{iops_rd_max} || 0,
5109 $drive->{iops_wr_max} || 0,
5110 $drive->{bps_max_length} || 1,
5111 $drive->{bps_rd_max_length} || 1,
5112 $drive->{bps_wr_max_length} || 1,
5113 $drive->{iops_max_length} || 1,
5114 $drive->{iops_rd_max_length} || 1,
5115 $drive->{iops_wr_max_length} || 1);
5124 if ($drive->{file} eq 'none
') {
5125 mon_cmd($vmid, "eject",force => JSON::true,device => "drive-$opt");
5126 if (drive_is_cloudinit($old_drive)) {
5127 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive);
5130 my $path = get_iso_path($storecfg, $vmid, $drive->{file});
5131 mon_cmd($vmid, "eject", force => JSON::true,device => "drive-$opt"); # force eject if locked
5132 mon_cmd($vmid, "change", device => "drive-$opt",target => "$path") if $path;
5140 die "skip\n" if !$hotplug || $opt =~ m/(ide|sata)(\d+)/;
5142 PVE::Storage::activate_volumes($storecfg, [$drive->{file}]) if $drive->{file} !~ m|^/dev/.+|;
5143 vm_deviceplug($storecfg, $conf, $vmid, $opt, $drive, $arch, $machine_type);
5147 my ($storecfg, $vmid, $statefile, $skiplock, $migratedfrom, $paused,
5148 $forcemachine, $spice_ticket, $migration_network, $migration_type, $targetstorage, $timeout) = @_;
5150 PVE::QemuConfig->lock_config($vmid, sub {
5151 my $conf = PVE::QemuConfig->load_config($vmid, $migratedfrom);
5153 die "you can't start a vm
if it
's a template\n" if PVE::QemuConfig->is_template($conf);
5155 my $is_suspended = PVE::QemuConfig->has_lock($conf, 'suspended
');
5157 PVE::QemuConfig->check_lock($conf)
5158 if !($skiplock || $is_suspended);
5160 die "VM $vmid already running\n" if check_running($vmid, undef, $migratedfrom);
5162 # clean up leftover reboot request files
5163 eval { clear_reboot_request($vmid); };
5166 if (!$statefile && scalar(keys %{$conf->{pending}})) {
5167 vmconfig_apply_pending($vmid, $conf, $storecfg);
5168 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5171 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($conf, $vmid);
5173 my $defaults = load_defaults();
5175 # set environment variable useful inside network script
5176 $ENV{PVE_MIGRATED_FROM} = $migratedfrom if $migratedfrom;
5178 my $local_volumes = {};
5180 if ($targetstorage) {
5181 foreach_drive($conf, sub {
5182 my ($ds, $drive) = @_;
5184 return if drive_is_cdrom($drive);
5186 my $volid = $drive->{file};
5190 my ($storeid, $volname) = PVE::Storage::parse_volume_id($volid);
5192 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5193 return if $scfg->{shared};
5194 $local_volumes->{$ds} = [$volid, $storeid, $volname];
5199 foreach my $opt (sort keys %$local_volumes) {
5201 my ($volid, $storeid, $volname) = @{$local_volumes->{$opt}};
5202 my $drive = parse_drive($opt, $conf->{$opt});
5204 # If a remote storage is specified and the format of the original
5205 # volume is not available there, fall back to the default format.
5206 # Otherwise use the same format as the original.
5207 if ($targetstorage && $targetstorage ne "1") {
5208 $storeid = $targetstorage;
5209 my ($defFormat, $validFormats) = PVE::Storage::storage_default_format($storecfg, $storeid);
5210 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5211 my $fileFormat = qemu_img_format($scfg, $volname);
5212 $format = (grep {$fileFormat eq $_} @{$validFormats}) ? $fileFormat : $defFormat;
5214 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5215 $format = qemu_img_format($scfg, $volname);
5218 my $newvolid = PVE::Storage::vdisk_alloc($storecfg, $storeid, $vmid, $format, undef, ($drive->{size}/1024));
5219 my $newdrive = $drive;
5220 $newdrive->{format} = $format;
5221 $newdrive->{file} = $newvolid;
5222 my $drivestr = print_drive($newdrive);
5223 $local_volumes->{$opt} = $drivestr;
5224 #pass drive to conf for command line
5225 $conf->{$opt} = $drivestr;
5229 PVE::GuestHelpers::exec_hookscript($conf, $vmid, 'pre-start
', 1);
5231 if ($is_suspended) {
5232 # enforce machine type on suspended vm to ensure HW compatibility
5233 $forcemachine = $conf->{runningmachine};
5234 print "Resuming suspended VM\n";
5237 my ($cmd, $vollist, $spice_port) = config_to_command($storecfg, $vmid, $conf, $defaults, $forcemachine);
5240 my $get_migration_ip = sub {
5241 my ($cidr, $nodename) = @_;
5243 return $migration_ip if defined($migration_ip);
5245 if (!defined($cidr)) {
5246 my $dc_conf = PVE::Cluster::cfs_read_file('datacenter
.cfg
');
5247 $cidr = $dc_conf->{migration}->{network};
5250 if (defined($cidr)) {
5251 my $ips = PVE::Network::get_local_ip_from_cidr($cidr);
5253 die "could not get IP: no address configured on local " .
5254 "node for network '$cidr'\n" if scalar(@$ips) == 0;
5256 die "could not get IP: multiple addresses configured on local " .
5257 "node for network '$cidr'\n" if scalar(@$ips) > 1;
5259 $migration_ip = @$ips[0];
5262 $migration_ip = PVE::Cluster::remote_node_ip($nodename, 1)
5263 if !defined($migration_ip);
5265 return $migration_ip;
5270 if ($statefile eq 'tcp
') {
5271 my $localip = "localhost";
5272 my $datacenterconf = PVE::Cluster::cfs_read_file('datacenter
.cfg
');
5273 my $nodename = nodename();
5275 if (!defined($migration_type)) {
5276 if (defined($datacenterconf->{migration}->{type})) {
5277 $migration_type = $datacenterconf->{migration}->{type};
5279 $migration_type = 'secure
';
5283 if ($migration_type eq 'insecure
') {
5284 $localip = $get_migration_ip->($migration_network, $nodename);
5285 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5288 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5289 my $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5290 $migrate_uri = "tcp:${localip}:${migrate_port}";
5291 push @$cmd, '-incoming
', $migrate_uri;
5294 } elsif ($statefile eq 'unix
') {
5295 # should be default for secure migrations as a ssh TCP forward
5296 # tunnel is not deterministic reliable ready and fails regurarly
5297 # to set up in time, so use UNIX socket forwards
5298 my $socket_addr = "/run/qemu-server/$vmid.migrate";
5299 unlink $socket_addr;
5301 $migrate_uri = "unix:$socket_addr";
5303 push @$cmd, '-incoming
', $migrate_uri;
5306 } elsif (-e $statefile) {
5307 push @$cmd, '-loadstate
', $statefile;
5309 my $statepath = PVE::Storage::path($storecfg, $statefile);
5310 push @$vollist, $statefile;
5311 push @$cmd, '-loadstate
', $statepath;
5318 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
5319 my $d = parse_hostpci($conf->{"hostpci$i"});
5321 my $pcidevices = $d->{pciid};
5322 foreach my $pcidevice (@$pcidevices) {
5323 my $pciid = $pcidevice->{id};
5325 my $info = PVE::SysFSTools::pci_device_info("$pciid");
5326 die "IOMMU not present\n" if !PVE::SysFSTools::check_iommu_support();
5327 die "no pci device info for device '$pciid'\n" if !$info;
5330 my $uuid = PVE::SysFSTools::generate_mdev_uuid($vmid, $i);
5331 PVE::SysFSTools::pci_create_mdev_device($pciid, $uuid, $d->{mdev});
5333 die "can't unbind
/bind pci group to vfio
'$pciid'\n"
5334 if !PVE::SysFSTools::pci_dev_group_bind_to_vfio($pciid);
5335 die "can
't reset pci device '$pciid'\n"
5336 if $info->{has_fl_reset} and !PVE::SysFSTools::pci_dev_reset($info);
5341 PVE::Storage::activate_volumes($storecfg, $vollist);
5344 run_command(['/bin/systemctl
', 'stop
', "$vmid.scope"],
5345 outfunc => sub {}, errfunc => sub {});
5347 # Issues with the above 'stop
' not being fully completed are extremely rare, a very low
5348 # timeout should be more than enough here...
5349 PVE::Systemd::wait_for_unit_removed("$vmid.scope", 5);
5351 my $cpuunits = defined($conf->{cpuunits}) ? $conf->{cpuunits}
5352 : $defaults->{cpuunits};
5354 my $start_timeout = $timeout // config_aware_timeout($conf, $is_suspended);
5356 timeout => $statefile ? undef : $start_timeout,
5361 # when migrating, prefix QEMU output so other side can pick up any
5362 # errors that might occur and show the user
5363 if ($migratedfrom) {
5364 $run_params{quiet} = 1;
5365 $run_params{logfunc} = sub { print "QEMU: $_[0]\n" };
5369 Slice => 'qemu
.slice
',
5371 CPUShares => $cpuunits
5374 if (my $cpulimit = $conf->{cpulimit}) {
5375 $properties{CPUQuota} = int($cpulimit * 100);
5377 $properties{timeout} = 10 if $statefile; # setting up the scope shoul be quick
5379 my $run_qemu = sub {
5380 PVE::Tools::run_fork sub {
5381 PVE::Systemd::enter_systemd_scope($vmid, "Proxmox VE VM $vmid", %properties);
5383 my $exitcode = run_command($cmd, %run_params);
5384 die "QEMU exited with code $exitcode\n" if $exitcode;
5388 if ($conf->{hugepages}) {
5391 my $hugepages_topology = PVE::QemuServer::Memory::hugepages_topology($conf);
5392 my $hugepages_host_topology = PVE::QemuServer::Memory::hugepages_host_topology();
5394 PVE::QemuServer::Memory::hugepages_mount();
5395 PVE::QemuServer::Memory::hugepages_allocate($hugepages_topology, $hugepages_host_topology);
5397 eval { $run_qemu->() };
5399 PVE::QemuServer::Memory::hugepages_reset($hugepages_host_topology);
5403 PVE::QemuServer::Memory::hugepages_pre_deallocate($hugepages_topology);
5405 eval { PVE::QemuServer::Memory::hugepages_update_locked($code); };
5408 eval { $run_qemu->() };
5412 # deactivate volumes if start fails
5413 eval { PVE::Storage::deactivate_volumes($storecfg, $vollist); };
5414 die "start failed: $err";
5417 print "migration listens on $migrate_uri\n" if $migrate_uri;
5419 if ($statefile && $statefile ne 'tcp
' && $statefile ne 'unix
') {
5420 eval { mon_cmd($vmid, "cont"); };
5424 #start nbd server for storage migration
5425 if ($targetstorage) {
5426 my $nodename = nodename();
5427 my $localip = $get_migration_ip->($migration_network, $nodename);
5428 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5429 my $storage_migrate_port = PVE::Tools::next_migrate_port($pfamily);
5431 mon_cmd($vmid, "nbd-server-start", addr => { type => 'inet
', data => { host => "${localip}", port => "${storage_migrate_port}" } } );
5433 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5435 foreach my $opt (sort keys %$local_volumes) {
5436 my $volid = $local_volumes->{$opt};
5437 mon_cmd($vmid, "nbd-server-add", device => "drive-$opt", writable => JSON::true );
5438 my $migrate_storage_uri = "nbd:${localip}:${storage_migrate_port}:exportname=drive-$opt";
5439 print "storage migration listens on $migrate_storage_uri volume:$volid\n";
5443 if ($migratedfrom) {
5445 set_migration_caps($vmid);
5450 print "spice listens on port $spice_port\n";
5451 if ($spice_ticket) {
5452 mon_cmd($vmid, "set_password", protocol => 'spice
', password => $spice_ticket);
5453 mon_cmd($vmid, "expire_password", protocol => 'spice
', time => "+30");
5458 mon_cmd($vmid, "balloon", value => $conf->{balloon}*1024*1024)
5459 if !$statefile && $conf->{balloon};
5461 foreach my $opt (keys %$conf) {
5462 next if $opt !~ m/^net\d+$/;
5463 my $nicconf = parse_net($conf->{$opt});
5464 qemu_set_link_status($vmid, $opt, 0) if $nicconf->{link_down};
5468 mon_cmd($vmid, 'qom-set
',
5469 path => "machine/peripheral/balloon0",
5470 property => "guest-stats-polling-interval",
5471 value => 2) if (!defined($conf->{balloon}) || $conf->{balloon});
5473 if ($is_suspended) {
5474 print "Resumed VM, removing state\n";
5475 if (my $vmstate = $conf->{vmstate}) {
5476 PVE::Storage::deactivate_volumes($storecfg, [$vmstate]);
5477 PVE::Storage::vdisk_free($storecfg, $vmstate);
5479 delete $conf->@{qw(lock vmstate runningmachine)};
5480 PVE
::QemuConfig-
>write_config($vmid, $conf);
5483 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'post-start');
5487 sub vm_commandline
{
5488 my ($storecfg, $vmid, $snapname) = @_;
5490 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5494 my $snapshot = $conf->{snapshots
}->{$snapname};
5495 die "snapshot '$snapname' does not exist\n" if !defined($snapshot);
5497 # check for a 'runningmachine' in snapshot
5498 $forcemachine = $snapshot->{runningmachine
} if $snapshot->{runningmachine
};
5500 $snapshot->{digest
} = $conf->{digest
}; # keep file digest for API
5505 my $defaults = load_defaults
();
5507 my $cmd = config_to_command
($storecfg, $vmid, $conf, $defaults, $forcemachine);
5509 return PVE
::Tools
::cmd2string
($cmd);
5513 my ($vmid, $skiplock) = @_;
5515 PVE
::QemuConfig-
>lock_config($vmid, sub {
5517 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5519 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5521 mon_cmd
($vmid, "system_reset");
5525 sub get_vm_volumes
{
5529 foreach_volid
($conf, sub {
5530 my ($volid, $attr) = @_;
5532 return if $volid =~ m
|^/|;
5534 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
5537 push @$vollist, $volid;
5543 sub vm_stop_cleanup
{
5544 my ($storecfg, $vmid, $conf, $keepActive, $apply_pending_changes) = @_;
5549 my $vollist = get_vm_volumes
($conf);
5550 PVE
::Storage
::deactivate_volumes
($storecfg, $vollist);
5553 foreach my $ext (qw(mon qmp pid vnc qga)) {
5554 unlink "/var/run/qemu-server/${vmid}.$ext";
5557 if ($conf->{ivshmem
}) {
5558 my $ivshmem = PVE
::JSONSchema
::parse_property_string
($ivshmem_fmt, $conf->{ivshmem
});
5559 # just delete it for now, VMs which have this already open do not
5560 # are affected, but new VMs will get a separated one. If this
5561 # becomes an issue we either add some sort of ref-counting or just
5562 # add a "don't delete on stop" flag to the ivshmem format.
5563 unlink '/dev/shm/pve-shm-' . ($ivshmem->{name
} // $vmid);
5566 foreach my $key (keys %$conf) {
5567 next if $key !~ m/^hostpci(\d+)$/;
5568 my $hostpciindex = $1;
5569 my $d = parse_hostpci
($conf->{$key});
5570 my $uuid = PVE
::SysFSTools
::generate_mdev_uuid
($vmid, $hostpciindex);
5572 foreach my $pci (@{$d->{pciid
}}) {
5573 my $pciid = $pci->{id
};
5574 PVE
::SysFSTools
::pci_cleanup_mdev_device
($pciid, $uuid);
5578 vmconfig_apply_pending
($vmid, $conf, $storecfg) if $apply_pending_changes;
5580 warn $@ if $@; # avoid errors - just warn
5583 # call only in locked context
5585 my ($storecfg, $vmid, $skiplock, $nocheck, $timeout, $shutdown, $force, $keepActive) = @_;
5587 my $pid = check_running
($vmid, $nocheck);
5592 $conf = PVE
::QemuConfig-
>load_config($vmid);
5593 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5594 if (!defined($timeout) && $shutdown && $conf->{startup
}) {
5595 my $opts = PVE
::JSONSchema
::pve_parse_startup_order
($conf->{startup
});
5596 $timeout = $opts->{down
} if $opts->{down
};
5598 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'pre-stop');
5603 if (defined($conf) && parse_guest_agent
($conf)->{enabled
}) {
5604 mon_cmd
($vmid, "guest-shutdown", timeout
=> $timeout);
5606 mon_cmd
($vmid, "system_powerdown");
5609 mon_cmd
($vmid, "quit");
5615 $timeout = 60 if !defined($timeout);
5618 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5623 if ($count >= $timeout) {
5625 warn "VM still running - terminating now with SIGTERM\n";
5628 die "VM quit/powerdown failed - got timeout\n";
5631 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5636 warn "VM quit/powerdown failed - terminating now with SIGTERM\n";
5639 die "VM quit/powerdown failed\n";
5647 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5652 if ($count >= $timeout) {
5653 warn "VM still running - terminating now with SIGKILL\n";
5658 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5661 # Note: use $nocheck to skip tests if VM configuration file exists.
5662 # We need that when migration VMs to other nodes (files already moved)
5663 # Note: we set $keepActive in vzdump stop mode - volumes need to stay active
5665 my ($storecfg, $vmid, $skiplock, $nocheck, $timeout, $shutdown, $force, $keepActive, $migratedfrom) = @_;
5667 $force = 1 if !defined($force) && !$shutdown;
5670 my $pid = check_running
($vmid, $nocheck, $migratedfrom);
5671 kill 15, $pid if $pid;
5672 my $conf = PVE
::QemuConfig-
>load_config($vmid, $migratedfrom);
5673 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 0);
5677 PVE
::QemuConfig-
>lock_config($vmid, sub {
5678 _do_vm_stop
($storecfg, $vmid, $skiplock, $nocheck, $timeout, $shutdown, $force, $keepActive);
5683 my ($vmid, $timeout) = @_;
5685 PVE
::QemuConfig-
>lock_config($vmid, sub {
5688 # only reboot if running, as qmeventd starts it again on a stop event
5689 return if !check_running
($vmid);
5691 create_reboot_request
($vmid);
5693 my $storecfg = PVE
::Storage
::config
();
5694 _do_vm_stop
($storecfg, $vmid, undef, undef, $timeout, 1);
5698 # avoid that the next normal shutdown will be confused for a reboot
5699 clear_reboot_request
($vmid);
5705 # note: if using the statestorage parameter, the caller has to check privileges
5707 my ($vmid, $skiplock, $includestate, $statestorage) = @_;
5714 PVE
::QemuConfig-
>lock_config($vmid, sub {
5716 $conf = PVE
::QemuConfig-
>load_config($vmid);
5718 my $is_backing_up = PVE
::QemuConfig-
>has_lock($conf, 'backup');
5719 PVE
::QemuConfig-
>check_lock($conf)
5720 if !($skiplock || $is_backing_up);
5722 die "cannot suspend to disk during backup\n"
5723 if $is_backing_up && $includestate;
5725 if ($includestate) {
5726 $conf->{lock} = 'suspending';
5727 my $date = strftime
("%Y-%m-%d", localtime(time()));
5728 $storecfg = PVE
::Storage
::config
();
5729 if (!$statestorage) {
5730 $statestorage = find_vmstate_storage
($conf, $storecfg);
5731 # check permissions for the storage
5732 my $rpcenv = PVE
::RPCEnvironment
::get
();
5733 if ($rpcenv->{type
} ne 'cli') {
5734 my $authuser = $rpcenv->get_user();
5735 $rpcenv->check($authuser, "/storage/$statestorage", ['Datastore.AllocateSpace']);
5740 $vmstate = PVE
::QemuConfig-
>__snapshot_save_vmstate($vmid, $conf, "suspend-$date", $storecfg, $statestorage, 1);
5741 $path = PVE
::Storage
::path
($storecfg, $vmstate);
5742 PVE
::QemuConfig-
>write_config($vmid, $conf);
5744 mon_cmd
($vmid, "stop");
5748 if ($includestate) {
5750 PVE
::Storage
::activate_volumes
($storecfg, [$vmstate]);
5753 mon_cmd
($vmid, "savevm-start", statefile
=> $path);
5755 my $state = mon_cmd
($vmid, "query-savevm");
5756 if (!$state->{status
}) {
5757 die "savevm not active\n";
5758 } elsif ($state->{status
} eq 'active') {
5761 } elsif ($state->{status
} eq 'completed') {
5762 print "State saved, quitting\n";
5764 } elsif ($state->{status
} eq 'failed' && $state->{error
}) {
5765 die "query-savevm failed with error '$state->{error}'\n"
5767 die "query-savevm returned status '$state->{status}'\n";
5773 PVE
::QemuConfig-
>lock_config($vmid, sub {
5774 $conf = PVE
::QemuConfig-
>load_config($vmid);
5776 # cleanup, but leave suspending lock, to indicate something went wrong
5778 mon_cmd
($vmid, "savevm-end");
5779 PVE
::Storage
::deactivate_volumes
($storecfg, [$vmstate]);
5780 PVE
::Storage
::vdisk_free
($storecfg, $vmstate);
5781 delete $conf->@{qw(vmstate runningmachine)};
5782 PVE
::QemuConfig-
>write_config($vmid, $conf);
5788 die "lock changed unexpectedly\n"
5789 if !PVE
::QemuConfig-
>has_lock($conf, 'suspending');
5791 mon_cmd
($vmid, "quit");
5792 $conf->{lock} = 'suspended';
5793 PVE
::QemuConfig-
>write_config($vmid, $conf);
5799 my ($vmid, $skiplock, $nocheck) = @_;
5801 PVE
::QemuConfig-
>lock_config($vmid, sub {
5802 my $res = mon_cmd
($vmid, 'query-status');
5803 my $resume_cmd = 'cont';
5805 if ($res->{status
} && $res->{status
} eq 'suspended') {
5806 $resume_cmd = 'system_wakeup';
5811 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5813 PVE
::QemuConfig-
>check_lock($conf)
5814 if !($skiplock || PVE
::QemuConfig-
>has_lock($conf, 'backup'));
5817 mon_cmd
($vmid, $resume_cmd);
5822 my ($vmid, $skiplock, $key) = @_;
5824 PVE
::QemuConfig-
>lock_config($vmid, sub {
5826 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5828 # there is no qmp command, so we use the human monitor command
5829 my $res = PVE
::QemuServer
::Monitor
::hmp_cmd
($vmid, "sendkey $key");
5830 die $res if $res ne '';
5834 # vzdump restore implementaion
5836 sub tar_archive_read_firstfile
{
5837 my $archive = shift;
5839 die "ERROR: file '$archive' does not exist\n" if ! -f
$archive;
5841 # try to detect archive type first
5842 my $pid = open (my $fh, '-|', 'tar', 'tf', $archive) ||
5843 die "unable to open file '$archive'\n";
5844 my $firstfile = <$fh>;
5848 die "ERROR: archive contaions no data\n" if !$firstfile;
5854 sub tar_restore_cleanup
{
5855 my ($storecfg, $statfile) = @_;
5857 print STDERR
"starting cleanup\n";
5859 if (my $fd = IO
::File-
>new($statfile, "r")) {
5860 while (defined(my $line = <$fd>)) {
5861 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
5864 if ($volid =~ m
|^/|) {
5865 unlink $volid || die 'unlink failed\n';
5867 PVE
::Storage
::vdisk_free
($storecfg, $volid);
5869 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
5871 print STDERR
"unable to cleanup '$volid' - $@" if $@;
5873 print STDERR
"unable to parse line in statfile - $line";
5880 sub restore_archive
{
5881 my ($archive, $vmid, $user, $opts) = @_;
5883 my $format = $opts->{format
};
5886 if ($archive =~ m/\.tgz$/ || $archive =~ m/\.tar\.gz$/) {
5887 $format = 'tar' if !$format;
5889 } elsif ($archive =~ m/\.tar$/) {
5890 $format = 'tar' if !$format;
5891 } elsif ($archive =~ m/.tar.lzo$/) {
5892 $format = 'tar' if !$format;
5894 } elsif ($archive =~ m/\.vma$/) {
5895 $format = 'vma' if !$format;
5896 } elsif ($archive =~ m/\.vma\.gz$/) {
5897 $format = 'vma' if !$format;
5899 } elsif ($archive =~ m/\.vma\.lzo$/) {
5900 $format = 'vma' if !$format;
5903 $format = 'vma' if !$format; # default
5906 # try to detect archive format
5907 if ($format eq 'tar') {
5908 return restore_tar_archive
($archive, $vmid, $user, $opts);
5910 return restore_vma_archive
($archive, $vmid, $user, $opts, $comp);
5914 sub restore_update_config_line
{
5915 my ($outfd, $cookie, $vmid, $map, $line, $unique) = @_;
5917 return if $line =~ m/^\#qmdump\#/;
5918 return if $line =~ m/^\#vzdump\#/;
5919 return if $line =~ m/^lock:/;
5920 return if $line =~ m/^unused\d+:/;
5921 return if $line =~ m/^parent:/;
5923 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
5924 if (($line =~ m/^(vlan(\d+)):\s*(\S+)\s*$/)) {
5925 # try to convert old 1.X settings
5926 my ($id, $ind, $ethcfg) = ($1, $2, $3);
5927 foreach my $devconfig (PVE
::Tools
::split_list
($ethcfg)) {
5928 my ($model, $macaddr) = split(/\=/, $devconfig);
5929 $macaddr = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if !$macaddr || $unique;
5932 bridge
=> "vmbr$ind",
5933 macaddr
=> $macaddr,
5935 my $netstr = print_net
($net);
5937 print $outfd "net$cookie->{netcount}: $netstr\n";
5938 $cookie->{netcount
}++;
5940 } elsif (($line =~ m/^(net\d+):\s*(\S+)\s*$/) && $unique) {
5941 my ($id, $netstr) = ($1, $2);
5942 my $net = parse_net
($netstr);
5943 $net->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if $net->{macaddr
};
5944 $netstr = print_net
($net);
5945 print $outfd "$id: $netstr\n";
5946 } elsif ($line =~ m/^((ide|scsi|virtio|sata|efidisk)\d+):\s*(\S+)\s*$/) {
5949 my $di = parse_drive
($virtdev, $value);
5950 if (defined($di->{backup
}) && !$di->{backup
}) {
5951 print $outfd "#$line";
5952 } elsif ($map->{$virtdev}) {
5953 delete $di->{format
}; # format can change on restore
5954 $di->{file
} = $map->{$virtdev};
5955 $value = print_drive
($di);
5956 print $outfd "$virtdev: $value\n";
5960 } elsif (($line =~ m/^vmgenid: (.*)/)) {
5962 if ($vmgenid ne '0') {
5963 # always generate a new vmgenid if there was a valid one setup
5964 $vmgenid = generate_uuid
();
5966 print $outfd "vmgenid: $vmgenid\n";
5967 } elsif (($line =~ m/^(smbios1: )(.*)/) && $unique) {
5968 my ($uuid, $uuid_str);
5969 UUID
::generate
($uuid);
5970 UUID
::unparse
($uuid, $uuid_str);
5971 my $smbios1 = parse_smbios1
($2);
5972 $smbios1->{uuid
} = $uuid_str;
5973 print $outfd $1.print_smbios1
($smbios1)."\n";
5980 my ($cfg, $vmid) = @_;
5982 my $info = PVE
::Storage
::vdisk_list
($cfg, undef, $vmid);
5984 my $volid_hash = {};
5985 foreach my $storeid (keys %$info) {
5986 foreach my $item (@{$info->{$storeid}}) {
5987 next if !($item->{volid
} && $item->{size
});
5988 $item->{path
} = PVE
::Storage
::path
($cfg, $item->{volid
});
5989 $volid_hash->{$item->{volid
}} = $item;
5996 sub is_volume_in_use
{
5997 my ($storecfg, $conf, $skip_drive, $volid) = @_;
5999 my $path = PVE
::Storage
::path
($storecfg, $volid);
6001 my $scan_config = sub {
6002 my ($cref, $snapname) = @_;
6004 foreach my $key (keys %$cref) {
6005 my $value = $cref->{$key};
6006 if (is_valid_drivename
($key)) {
6007 next if $skip_drive && $key eq $skip_drive;
6008 my $drive = parse_drive
($key, $value);
6009 next if !$drive || !$drive->{file
} || drive_is_cdrom
($drive);
6010 return 1 if $volid eq $drive->{file
};
6011 if ($drive->{file
} =~ m!^/!) {
6012 return 1 if $drive->{file
} eq $path;
6014 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
}, 1);
6016 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid, 1);
6018 return 1 if $path eq PVE
::Storage
::path
($storecfg, $drive->{file
}, $snapname);
6026 return 1 if &$scan_config($conf);
6030 foreach my $snapname (keys %{$conf->{snapshots
}}) {
6031 return 1 if &$scan_config($conf->{snapshots
}->{$snapname}, $snapname);
6037 sub update_disksize
{
6038 my ($drive, $volid_hash) = @_;
6040 my $volid = $drive->{file
};
6041 return undef if !defined($volid);
6043 my $oldsize = $drive->{size
};
6044 my $newsize = $volid_hash->{$volid}->{size
};
6046 if (defined($newsize) && defined($oldsize) && $newsize != $oldsize) {
6047 $drive->{size
} = $newsize;
6049 my $old_fmt = PVE
::JSONSchema
::format_size
($oldsize);
6050 my $new_fmt = PVE
::JSONSchema
::format_size
($newsize);
6052 return wantarray ?
($drive, $old_fmt, $new_fmt) : $drive;
6058 sub update_disk_config
{
6059 my ($vmid, $conf, $volid_hash) = @_;
6062 my $prefix = "VM $vmid:";
6064 # used and unused disks
6065 my $referenced = {};
6067 # Note: it is allowed to define multiple storages with same path (alias), so
6068 # we need to check both 'volid' and real 'path' (two different volid can point
6069 # to the same path).
6071 my $referencedpath = {};
6074 foreach my $opt (keys %$conf) {
6075 if (is_valid_drivename
($opt)) {
6076 my $drive = parse_drive
($opt, $conf->{$opt});
6077 my $volid = $drive->{file
};
6080 # mark volid as "in-use" for next step
6081 $referenced->{$volid} = 1;
6082 if ($volid_hash->{$volid} &&
6083 (my $path = $volid_hash->{$volid}->{path
})) {
6084 $referencedpath->{$path} = 1;
6087 next if drive_is_cdrom
($drive);
6088 next if !$volid_hash->{$volid};
6090 my ($updated, $old_size, $new_size) = update_disksize
($drive, $volid_hash);
6091 if (defined($updated)) {
6093 $conf->{$opt} = print_drive
($updated);
6094 print "$prefix size of disk '$volid' ($opt) updated from $old_size to $new_size\n";
6099 # remove 'unusedX' entry if volume is used
6100 foreach my $opt (keys %$conf) {
6101 next if $opt !~ m/^unused\d+$/;
6102 my $volid = $conf->{$opt};
6103 my $path = $volid_hash->{$volid}->{path
} if $volid_hash->{$volid};
6104 if ($referenced->{$volid} || ($path && $referencedpath->{$path})) {
6105 print "$prefix remove entry '$opt', its volume '$volid' is in use\n";
6107 delete $conf->{$opt};
6110 $referenced->{$volid} = 1;
6111 $referencedpath->{$path} = 1 if $path;
6114 foreach my $volid (sort keys %$volid_hash) {
6115 next if $volid =~ m/vm-$vmid-state-/;
6116 next if $referenced->{$volid};
6117 my $path = $volid_hash->{$volid}->{path
};
6118 next if !$path; # just to be sure
6119 next if $referencedpath->{$path};
6121 my $key = PVE
::QemuConfig-
>add_unused_volume($conf, $volid);
6122 print "$prefix add unreferenced volume '$volid' as '$key' to config\n";
6123 $referencedpath->{$path} = 1; # avoid to add more than once (aliases)
6130 my ($vmid, $nolock, $dryrun) = @_;
6132 my $cfg = PVE
::Storage
::config
();
6134 # FIXME: Remove once our RBD plugin can handle CT and VM on a single storage
6135 # see: https://pve.proxmox.com/pipermail/pve-devel/2018-July/032900.html
6136 foreach my $stor (keys %{$cfg->{ids
}}) {
6137 delete($cfg->{ids
}->{$stor}) if ! $cfg->{ids
}->{$stor}->{content
}->{images
};
6140 print "rescan volumes...\n";
6141 my $volid_hash = scan_volids
($cfg, $vmid);
6143 my $updatefn = sub {
6146 my $conf = PVE
::QemuConfig-
>load_config($vmid);
6148 PVE
::QemuConfig-
>check_lock($conf);
6151 foreach my $volid (keys %$volid_hash) {
6152 my $info = $volid_hash->{$volid};
6153 $vm_volids->{$volid} = $info if $info->{vmid
} && $info->{vmid
} == $vmid;
6156 my $changes = update_disk_config
($vmid, $conf, $vm_volids);
6158 PVE
::QemuConfig-
>write_config($vmid, $conf) if $changes && !$dryrun;
6161 if (defined($vmid)) {
6165 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6168 my $vmlist = config_list
();
6169 foreach my $vmid (keys %$vmlist) {
6173 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6179 sub restore_vma_archive
{
6180 my ($archive, $vmid, $user, $opts, $comp) = @_;
6182 my $readfrom = $archive;
6184 my $cfg = PVE
::Storage
::config
();
6186 my $bwlimit = $opts->{bwlimit
};
6188 my $dbg_cmdstring = '';
6189 my $add_pipe = sub {
6191 push @$commands, $cmd;
6192 $dbg_cmdstring .= ' | ' if length($dbg_cmdstring);
6193 $dbg_cmdstring .= PVE
::Tools
::cmd2string
($cmd);
6198 if ($archive eq '-') {
6201 # If we use a backup from a PVE defined storage we also consider that
6202 # storage's rate limit:
6203 my (undef, $volid) = PVE
::Storage
::path_to_volume_id
($cfg, $archive);
6204 if (defined($volid)) {
6205 my ($sid, undef) = PVE
::Storage
::parse_volume_id
($volid);
6206 my $readlimit = PVE
::Storage
::get_bandwidth_limit
('restore', [$sid], $bwlimit);
6208 print STDERR
"applying read rate limit: $readlimit\n";
6209 my $cstream = ['cstream', '-t', $readlimit*1024, '--', $readfrom];
6210 $add_pipe->($cstream);
6217 if ($comp eq 'gzip') {
6218 $cmd = ['zcat', $readfrom];
6219 } elsif ($comp eq 'lzop') {
6220 $cmd = ['lzop', '-d', '-c', $readfrom];
6222 die "unknown compression method '$comp'\n";
6227 my $tmpdir = "/var/tmp/vzdumptmp$$";
6230 # disable interrupts (always do cleanups)
6234 local $SIG{HUP
} = sub { warn "got interrupt - ignored\n"; };
6236 my $mapfifo = "/var/tmp/vzdumptmp$$.fifo";
6237 POSIX
::mkfifo
($mapfifo, 0600);
6240 my $openfifo = sub {
6241 open($fifofh, '>', $mapfifo) || die $!;
6244 $add_pipe->(['vma', 'extract', '-v', '-r', $mapfifo, $readfrom, $tmpdir]);
6251 my $rpcenv = PVE
::RPCEnvironment
::get
();
6253 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6254 my $tmpfn = "$conffile.$$.tmp";
6256 # Note: $oldconf is undef if VM does not exist
6257 my $cfs_path = PVE
::QemuConfig-
>cfs_config_path($vmid);
6258 my $oldconf = PVE
::Cluster
::cfs_read_file
($cfs_path);
6262 my $print_devmap = sub {
6263 my $virtdev_hash = {};
6265 my $cfgfn = "$tmpdir/qemu-server.conf";
6267 # we can read the config - that is already extracted
6268 my $fh = IO
::File-
>new($cfgfn, "r") ||
6269 "unable to read qemu-server.conf - $!\n";
6271 my $fwcfgfn = "$tmpdir/qemu-server.fw";
6273 my $pve_firewall_dir = '/etc/pve/firewall';
6274 mkdir $pve_firewall_dir; # make sure the dir exists
6275 PVE
::Tools
::file_copy
($fwcfgfn, "${pve_firewall_dir}/$vmid.fw");
6278 while (defined(my $line = <$fh>)) {
6279 if ($line =~ m/^\#qmdump\#map:(\S+):(\S+):(\S*):(\S*):$/) {
6280 my ($virtdev, $devname, $storeid, $format) = ($1, $2, $3, $4);
6281 die "archive does not contain data for drive '$virtdev'\n"
6282 if !$devinfo->{$devname};
6283 if (defined($opts->{storage
})) {
6284 $storeid = $opts->{storage
} || 'local';
6285 } elsif (!$storeid) {
6288 $format = 'raw' if !$format;
6289 $devinfo->{$devname}->{devname
} = $devname;
6290 $devinfo->{$devname}->{virtdev
} = $virtdev;
6291 $devinfo->{$devname}->{format
} = $format;
6292 $devinfo->{$devname}->{storeid
} = $storeid;
6294 # check permission on storage
6295 my $pool = $opts->{pool
}; # todo: do we need that?
6296 if ($user ne 'root@pam') {
6297 $rpcenv->check($user, "/storage/$storeid", ['Datastore.AllocateSpace']);
6300 $storage_limits{$storeid} = $bwlimit;
6302 $virtdev_hash->{$virtdev} = $devinfo->{$devname};
6303 } elsif ($line =~ m/^((?:ide|sata|scsi)\d+):\s*(.*)\s*$/) {
6305 my $drive = parse_drive
($virtdev, $2);
6306 if (drive_is_cloudinit
($drive)) {
6307 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
});
6308 my $scfg = PVE
::Storage
::storage_config
($cfg, $storeid);
6309 my $format = qemu_img_format
($scfg, $volname); # has 'raw' fallback
6313 storeid
=> $opts->{storage
} // $storeid,
6314 size
=> PVE
::QemuServer
::Cloudinit
::CLOUDINIT_DISK_SIZE
,
6315 file
=> $drive->{file
}, # to make drive_is_cloudinit check possible
6316 name
=> "vm-$vmid-cloudinit",
6319 $virtdev_hash->{$virtdev} = $d;
6324 foreach my $key (keys %storage_limits) {
6325 my $limit = PVE
::Storage
::get_bandwidth_limit
('restore', [$key], $bwlimit);
6327 print STDERR
"rate limit for storage $key: $limit KiB/s\n";
6328 $storage_limits{$key} = $limit * 1024;
6331 foreach my $devname (keys %$devinfo) {
6332 die "found no device mapping information for device '$devname'\n"
6333 if !$devinfo->{$devname}->{virtdev
};
6336 # create empty/temp config
6338 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
6339 foreach_drive
($oldconf, sub {
6340 my ($ds, $drive) = @_;
6342 return if drive_is_cdrom
($drive, 1);
6344 my $volid = $drive->{file
};
6345 return if !$volid || $volid =~ m
|^/|;
6347 my ($path, $owner) = PVE
::Storage
::path
($cfg, $volid);
6348 return if !$path || !$owner || ($owner != $vmid);
6350 # Note: only delete disk we want to restore
6351 # other volumes will become unused
6352 if ($virtdev_hash->{$ds}) {
6353 eval { PVE
::Storage
::vdisk_free
($cfg, $volid); };
6360 # delete vmstate files, after the restore we have no snapshots anymore
6361 foreach my $snapname (keys %{$oldconf->{snapshots
}}) {
6362 my $snap = $oldconf->{snapshots
}->{$snapname};
6363 if ($snap->{vmstate
}) {
6364 eval { PVE
::Storage
::vdisk_free
($cfg, $snap->{vmstate
}); };
6373 foreach my $virtdev (sort keys %$virtdev_hash) {
6374 my $d = $virtdev_hash->{$virtdev};
6375 my $alloc_size = int(($d->{size
} + 1024 - 1)/1024);
6376 my $storeid = $d->{storeid
};
6377 my $scfg = PVE
::Storage
::storage_config
($cfg, $storeid);
6380 if (my $limit = $storage_limits{$storeid}) {
6381 $map_opts .= "throttling.bps=$limit:throttling.group=$storeid:";
6384 # test if requested format is supported
6385 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($cfg, $storeid);
6386 my $supported = grep { $_ eq $d->{format
} } @$validFormats;
6387 $d->{format
} = $defFormat if !$supported;
6390 if ($d->{is_cloudinit
}) {
6392 $name .= ".$d->{format}" if $d->{format
} ne 'raw';
6395 my $volid = PVE
::Storage
::vdisk_alloc
($cfg, $storeid, $vmid, $d->{format
}, $name, $alloc_size);
6396 print STDERR
"new volume ID is '$volid'\n";
6397 $d->{volid
} = $volid;
6399 PVE
::Storage
::activate_volumes
($cfg, [$volid]);
6401 my $write_zeros = 1;
6402 if (PVE
::Storage
::volume_has_feature
($cfg, 'sparseinit', $volid)) {
6406 if (!$d->{is_cloudinit
}) {
6407 my $path = PVE
::Storage
::path
($cfg, $volid);
6409 print $fifofh "${map_opts}format=$d->{format}:${write_zeros}:$d->{devname}=$path\n";
6411 print "map '$d->{devname}' to '$path' (write zeros = ${write_zeros})\n";
6413 $map->{$virtdev} = $volid;
6416 $fh->seek(0, 0) || die "seek failed - $!\n";
6418 my $outfd = new IO
::File
($tmpfn, "w") ||
6419 die "unable to write config for VM $vmid\n";
6421 my $cookie = { netcount
=> 0 };
6422 while (defined(my $line = <$fh>)) {
6423 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6436 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6437 local $SIG{ALRM
} = sub { die "got timeout\n"; };
6439 $oldtimeout = alarm($timeout);
6446 if ($line =~ m/^DEV:\sdev_id=(\d+)\ssize:\s(\d+)\sdevname:\s(\S+)$/) {
6447 my ($dev_id, $size, $devname) = ($1, $2, $3);
6448 $devinfo->{$devname} = { size
=> $size, dev_id
=> $dev_id };
6449 } elsif ($line =~ m/^CTIME: /) {
6450 # we correctly received the vma config, so we can disable
6451 # the timeout now for disk allocation (set to 10 minutes, so
6452 # that we always timeout if something goes wrong)
6455 print $fifofh "done\n";
6456 my $tmp = $oldtimeout || 0;
6457 $oldtimeout = undef;
6463 print "restore vma archive: $dbg_cmdstring\n";
6464 run_command
($commands, input
=> $input, outfunc
=> $parser, afterfork
=> $openfifo);
6468 alarm($oldtimeout) if $oldtimeout;
6471 foreach my $devname (keys %$devinfo) {
6472 my $volid = $devinfo->{$devname}->{volid
};
6473 push @$vollist, $volid if $volid;
6476 PVE
::Storage
::deactivate_volumes
($cfg, $vollist);
6484 foreach my $devname (keys %$devinfo) {
6485 my $volid = $devinfo->{$devname}->{volid
};
6488 if ($volid =~ m
|^/|) {
6489 unlink $volid || die 'unlink failed\n';
6491 PVE
::Storage
::vdisk_free
($cfg, $volid);
6493 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
6495 print STDERR
"unable to cleanup '$volid' - $@" if $@;
6502 rename($tmpfn, $conffile) ||
6503 die "unable to commit configuration file '$conffile'\n";
6505 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6507 eval { rescan
($vmid, 1); };
6511 sub restore_tar_archive
{
6512 my ($archive, $vmid, $user, $opts) = @_;
6514 if ($archive ne '-') {
6515 my $firstfile = tar_archive_read_firstfile
($archive);
6516 die "ERROR: file '$archive' dos not lock like a QemuServer vzdump backup\n"
6517 if $firstfile ne 'qemu-server.conf';
6520 my $storecfg = PVE
::Storage
::config
();
6522 # avoid zombie disks when restoring over an existing VM -> cleanup first
6523 # pass keep_empty_config=1 to keep the config (thus VMID) reserved for us
6524 # skiplock=1 because qmrestore has set the 'create' lock itself already
6525 my $vmcfgfn = PVE
::QemuConfig-
>config_file($vmid);
6526 destroy_vm
($storecfg, $vmid, 1, { lock => 'restore' }) if -f
$vmcfgfn;
6528 my $tocmd = "/usr/lib/qemu-server/qmextract";
6530 $tocmd .= " --storage " . PVE
::Tools
::shellquote
($opts->{storage
}) if $opts->{storage
};
6531 $tocmd .= " --pool " . PVE
::Tools
::shellquote
($opts->{pool
}) if $opts->{pool
};
6532 $tocmd .= ' --prealloc' if $opts->{prealloc
};
6533 $tocmd .= ' --info' if $opts->{info
};
6535 # tar option "xf" does not autodetect compression when read from STDIN,
6536 # so we pipe to zcat
6537 my $cmd = "zcat -f|tar xf " . PVE
::Tools
::shellquote
($archive) . " " .
6538 PVE
::Tools
::shellquote
("--to-command=$tocmd");
6540 my $tmpdir = "/var/tmp/vzdumptmp$$";
6543 local $ENV{VZDUMP_TMPDIR
} = $tmpdir;
6544 local $ENV{VZDUMP_VMID
} = $vmid;
6545 local $ENV{VZDUMP_USER
} = $user;
6547 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6548 my $tmpfn = "$conffile.$$.tmp";
6550 # disable interrupts (always do cleanups)
6554 local $SIG{HUP
} = sub { print STDERR
"got interrupt - ignored\n"; };
6562 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6564 if ($archive eq '-') {
6565 print "extracting archive from STDIN\n";
6566 run_command
($cmd, input
=> "<&STDIN");
6568 print "extracting archive '$archive'\n";
6572 return if $opts->{info
};
6576 my $statfile = "$tmpdir/qmrestore.stat";
6577 if (my $fd = IO
::File-
>new($statfile, "r")) {
6578 while (defined (my $line = <$fd>)) {
6579 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
6580 $map->{$1} = $2 if $1;
6582 print STDERR
"unable to parse line in statfile - $line\n";
6588 my $confsrc = "$tmpdir/qemu-server.conf";
6590 my $srcfd = new IO
::File
($confsrc, "r") ||
6591 die "unable to open file '$confsrc'\n";
6593 my $outfd = new IO
::File
($tmpfn, "w") ||
6594 die "unable to write config for VM $vmid\n";
6596 my $cookie = { netcount
=> 0 };
6597 while (defined (my $line = <$srcfd>)) {
6598 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6606 tar_restore_cleanup
($storecfg, "$tmpdir/qmrestore.stat") if !$opts->{info
};
6612 rename $tmpfn, $conffile ||
6613 die "unable to commit configuration file '$conffile'\n";
6615 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6617 eval { rescan
($vmid, 1); };
6621 sub foreach_storage_used_by_vm
{
6622 my ($conf, $func) = @_;
6626 foreach_drive
($conf, sub {
6627 my ($ds, $drive) = @_;
6628 return if drive_is_cdrom
($drive);
6630 my $volid = $drive->{file
};
6632 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
6633 $sidhash->{$sid} = $sid if $sid;
6636 foreach my $sid (sort keys %$sidhash) {
6641 my $qemu_snap_storage = {
6644 sub do_snapshots_with_qemu
{
6645 my ($storecfg, $volid) = @_;
6647 my $storage_name = PVE
::Storage
::parse_volume_id
($volid);
6648 my $scfg = $storecfg->{ids
}->{$storage_name};
6650 if ($qemu_snap_storage->{$scfg->{type
}} && !$scfg->{krbd
}){
6654 if ($volid =~ m/\.(qcow2|qed)$/){
6661 sub qga_check_running
{
6662 my ($vmid, $nowarn) = @_;
6664 eval { mon_cmd
($vmid, "guest-ping", timeout
=> 3); };
6666 warn "Qemu Guest Agent is not running - $@" if !$nowarn;
6672 sub template_create
{
6673 my ($vmid, $conf, $disk) = @_;
6675 my $storecfg = PVE
::Storage
::config
();
6677 foreach_drive
($conf, sub {
6678 my ($ds, $drive) = @_;
6680 return if drive_is_cdrom
($drive);
6681 return if $disk && $ds ne $disk;
6683 my $volid = $drive->{file
};
6684 return if !PVE
::Storage
::volume_has_feature
($storecfg, 'template', $volid);
6686 my $voliddst = PVE
::Storage
::vdisk_create_base
($storecfg, $volid);
6687 $drive->{file
} = $voliddst;
6688 $conf->{$ds} = print_drive
($drive);
6689 PVE
::QemuConfig-
>write_config($vmid, $conf);
6693 sub convert_iscsi_path
{
6696 if ($path =~ m
|^iscsi
://([^/]+)/([^/]+)/(.+)$|) {
6701 my $initiator_name = get_initiator_name
();
6703 return "file.driver=iscsi,file.transport=tcp,file.initiator-name=$initiator_name,".
6704 "file.portal=$portal,file.target=$target,file.lun=$lun,driver=raw";
6707 die "cannot convert iscsi path '$path', unkown format\n";
6710 sub qemu_img_convert
{
6711 my ($src_volid, $dst_volid, $size, $snapname, $is_zero_initialized) = @_;
6713 my $storecfg = PVE
::Storage
::config
();
6714 my ($src_storeid, $src_volname) = PVE
::Storage
::parse_volume_id
($src_volid, 1);
6715 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid, 1);
6717 die "destination '$dst_volid' is not a valid volid form qemu-img convert\n" if !$dst_storeid;
6721 my $src_is_iscsi = 0;
6725 PVE
::Storage
::activate_volumes
($storecfg, [$src_volid], $snapname);
6726 my $src_scfg = PVE
::Storage
::storage_config
($storecfg, $src_storeid);
6727 $src_format = qemu_img_format
($src_scfg, $src_volname);
6728 $src_path = PVE
::Storage
::path
($storecfg, $src_volid, $snapname);
6729 $src_is_iscsi = ($src_path =~ m
|^iscsi
://|);
6730 $cachemode = 'none' if $src_scfg->{type
} eq 'zfspool';
6731 } elsif (-f
$src_volid) {
6732 $src_path = $src_volid;
6733 if ($src_path =~ m/\.($QEMU_FORMAT_RE)$/) {
6738 die "source '$src_volid' is not a valid volid nor path for qemu-img convert\n" if !$src_path;
6740 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6741 my $dst_format = qemu_img_format
($dst_scfg, $dst_volname);
6742 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6743 my $dst_is_iscsi = ($dst_path =~ m
|^iscsi
://|);
6746 push @$cmd, '/usr/bin/qemu-img', 'convert', '-p', '-n';
6747 push @$cmd, '-l', "snapshot.name=$snapname"
6748 if $snapname && $src_format && $src_format eq "qcow2";
6749 push @$cmd, '-t', 'none' if $dst_scfg->{type
} eq 'zfspool';
6750 push @$cmd, '-T', $cachemode if defined($cachemode);
6752 if ($src_is_iscsi) {
6753 push @$cmd, '--image-opts';
6754 $src_path = convert_iscsi_path
($src_path);
6755 } elsif ($src_format) {
6756 push @$cmd, '-f', $src_format;
6759 if ($dst_is_iscsi) {
6760 push @$cmd, '--target-image-opts';
6761 $dst_path = convert_iscsi_path
($dst_path);
6763 push @$cmd, '-O', $dst_format;
6766 push @$cmd, $src_path;
6768 if (!$dst_is_iscsi && $is_zero_initialized) {
6769 push @$cmd, "zeroinit:$dst_path";
6771 push @$cmd, $dst_path;
6776 if($line =~ m/\((\S+)\/100\
%\)/){
6778 my $transferred = int($size * $percent / 100);
6779 my $remaining = $size - $transferred;
6781 print "transferred: $transferred bytes remaining: $remaining bytes total: $size bytes progression: $percent %\n";
6786 eval { run_command
($cmd, timeout
=> undef, outfunc
=> $parser); };
6788 die "copy failed: $err" if $err;
6791 sub qemu_img_format
{
6792 my ($scfg, $volname) = @_;
6794 if ($scfg->{path
} && $volname =~ m/\.($QEMU_FORMAT_RE)$/) {
6801 sub qemu_drive_mirror
{
6802 my ($vmid, $drive, $dst_volid, $vmiddst, $is_zero_initialized, $jobs, $skipcomplete, $qga, $bwlimit) = @_;
6804 $jobs = {} if !$jobs;
6808 $jobs->{"drive-$drive"} = {};
6810 if ($dst_volid =~ /^nbd:/) {
6811 $qemu_target = $dst_volid;
6814 my $storecfg = PVE
::Storage
::config
();
6815 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid);
6817 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6819 $format = qemu_img_format
($dst_scfg, $dst_volname);
6821 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6823 $qemu_target = $is_zero_initialized ?
"zeroinit:$dst_path" : $dst_path;
6826 my $opts = { timeout
=> 10, device
=> "drive-$drive", mode
=> "existing", sync
=> "full", target
=> $qemu_target };
6827 $opts->{format
} = $format if $format;
6829 if (defined($bwlimit)) {
6830 $opts->{speed
} = $bwlimit * 1024;
6831 print "drive mirror is starting for drive-$drive with bandwidth limit: ${bwlimit} KB/s\n";
6833 print "drive mirror is starting for drive-$drive\n";
6836 # if a job already runs for this device we get an error, catch it for cleanup
6837 eval { mon_cmd
($vmid, "drive-mirror", %$opts); };
6839 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6841 die "mirroring error: $err\n";
6844 qemu_drive_mirror_monitor
($vmid, $vmiddst, $jobs, $skipcomplete, $qga);
6847 sub qemu_drive_mirror_monitor
{
6848 my ($vmid, $vmiddst, $jobs, $skipcomplete, $qga) = @_;
6851 my $err_complete = 0;
6854 die "storage migration timed out\n" if $err_complete > 300;
6856 my $stats = mon_cmd
($vmid, "query-block-jobs");
6858 my $running_mirror_jobs = {};
6859 foreach my $stat (@$stats) {
6860 next if $stat->{type
} ne 'mirror';
6861 $running_mirror_jobs->{$stat->{device
}} = $stat;
6864 my $readycounter = 0;
6866 foreach my $job (keys %$jobs) {
6868 if(defined($jobs->{$job}->{complete
}) && !defined($running_mirror_jobs->{$job})) {
6869 print "$job : finished\n";
6870 delete $jobs->{$job};
6874 die "$job: mirroring has been cancelled\n" if !defined($running_mirror_jobs->{$job});
6876 my $busy = $running_mirror_jobs->{$job}->{busy
};
6877 my $ready = $running_mirror_jobs->{$job}->{ready
};
6878 if (my $total = $running_mirror_jobs->{$job}->{len
}) {
6879 my $transferred = $running_mirror_jobs->{$job}->{offset
} || 0;
6880 my $remaining = $total - $transferred;
6881 my $percent = sprintf "%.2f", ($transferred * 100 / $total);
6883 print "$job: transferred: $transferred bytes remaining: $remaining bytes total: $total bytes progression: $percent % busy: $busy ready: $ready \n";
6886 $readycounter++ if $running_mirror_jobs->{$job}->{ready
};
6889 last if scalar(keys %$jobs) == 0;
6891 if ($readycounter == scalar(keys %$jobs)) {
6892 print "all mirroring jobs are ready \n";
6893 last if $skipcomplete; #do the complete later
6895 if ($vmiddst && $vmiddst != $vmid) {
6896 my $agent_running = $qga && qga_check_running
($vmid);
6897 if ($agent_running) {
6898 print "freeze filesystem\n";
6899 eval { mon_cmd
($vmid, "guest-fsfreeze-freeze"); };
6901 print "suspend vm\n";
6902 eval { PVE
::QemuServer
::vm_suspend
($vmid, 1); };
6905 # if we clone a disk for a new target vm, we don't switch the disk
6906 PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs);
6908 if ($agent_running) {
6909 print "unfreeze filesystem\n";
6910 eval { mon_cmd
($vmid, "guest-fsfreeze-thaw"); };
6912 print "resume vm\n";
6913 eval { PVE
::QemuServer
::vm_resume
($vmid, 1, 1); };
6919 foreach my $job (keys %$jobs) {
6920 # try to switch the disk if source and destination are on the same guest
6921 print "$job: Completing block job...\n";
6923 eval { mon_cmd
($vmid, "block-job-complete", device
=> $job) };
6924 if ($@ =~ m/cannot be completed/) {
6925 print "$job: Block job cannot be completed, try again.\n";
6928 print "$job: Completed successfully.\n";
6929 $jobs->{$job}->{complete
} = 1;
6940 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6941 die "mirroring error: $err";
6946 sub qemu_blockjobs_cancel
{
6947 my ($vmid, $jobs) = @_;
6949 foreach my $job (keys %$jobs) {
6950 print "$job: Cancelling block job\n";
6951 eval { mon_cmd
($vmid, "block-job-cancel", device
=> $job); };
6952 $jobs->{$job}->{cancel
} = 1;
6956 my $stats = mon_cmd
($vmid, "query-block-jobs");
6958 my $running_jobs = {};
6959 foreach my $stat (@$stats) {
6960 $running_jobs->{$stat->{device
}} = $stat;
6963 foreach my $job (keys %$jobs) {
6965 if (defined($jobs->{$job}->{cancel
}) && !defined($running_jobs->{$job})) {
6966 print "$job: Done.\n";
6967 delete $jobs->{$job};
6971 last if scalar(keys %$jobs) == 0;
6978 my ($storecfg, $vmid, $running, $drivename, $drive, $snapname,
6979 $newvmid, $storage, $format, $full, $newvollist, $jobs, $skipcomplete, $qga, $bwlimit) = @_;
6984 print "create linked clone of drive $drivename ($drive->{file})\n";
6985 $newvolid = PVE
::Storage
::vdisk_clone
($storecfg, $drive->{file
}, $newvmid, $snapname);
6986 push @$newvollist, $newvolid;
6989 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
});
6990 $storeid = $storage if $storage;
6992 my $dst_format = resolve_dst_disk_format
($storecfg, $storeid, $volname, $format);
6993 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $drive->{file
}, 3);
6995 print "create full clone of drive $drivename ($drive->{file})\n";
6997 if (drive_is_cloudinit
($drive)) {
6998 $name = "vm-$newvmid-cloudinit";
6999 $name .= ".$dst_format" if $dst_format ne 'raw';
7001 $size = PVE
::QemuServer
::Cloudinit
::CLOUDINIT_DISK_SIZE
;
7003 $newvolid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $newvmid, $dst_format, $name, ($size/1024));
7004 push @$newvollist, $newvolid;
7006 PVE
::Storage
::activate_volumes
($storecfg, [$newvolid]);
7008 if (drive_is_cloudinit
($drive)) {
7012 my $sparseinit = PVE
::Storage
::volume_has_feature
($storecfg, 'sparseinit', $newvolid);
7013 if (!$running || $snapname) {
7014 # TODO: handle bwlimits
7015 qemu_img_convert
($drive->{file
}, $newvolid, $size, $snapname, $sparseinit);
7018 my $kvmver = get_running_qemu_version
($vmid);
7019 if (!min_version
($kvmver, 2, 7)) {
7020 die "drive-mirror with iothread requires qemu version 2.7 or higher\n"
7021 if $drive->{iothread
};
7024 qemu_drive_mirror
($vmid, $drivename, $newvolid, $newvmid, $sparseinit, $jobs, $skipcomplete, $qga, $bwlimit);
7029 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $newvolid, 3);
7032 $disk->{format
} = undef;
7033 $disk->{file
} = $newvolid;
7034 $disk->{size
} = $size;
7039 sub get_running_qemu_version
{
7041 my $res = mon_cmd
($vmid, "query-version");
7042 return "$res->{qemu}->{major}.$res->{qemu}->{minor}";
7045 sub qemu_use_old_bios_files
{
7046 my ($machine_type) = @_;
7048 return if !$machine_type;
7050 my $use_old_bios_files = undef;
7052 if ($machine_type =~ m/^(\S+)\.pxe$/) {
7054 $use_old_bios_files = 1;
7056 my $version = PVE
::QemuServer
::Machine
::extract_version
($machine_type, kvm_user_version
());
7057 # Note: kvm version < 2.4 use non-efi pxe files, and have problems when we
7058 # load new efi bios files on migration. So this hack is required to allow
7059 # live migration from qemu-2.2 to qemu-2.4, which is sometimes used when
7060 # updrading from proxmox-ve-3.X to proxmox-ve 4.0
7061 $use_old_bios_files = !min_version
($version, 2, 4);
7064 return ($use_old_bios_files, $machine_type);
7067 sub create_efidisk
($$$$$) {
7068 my ($storecfg, $storeid, $vmid, $fmt, $arch) = @_;
7070 my (undef, $ovmf_vars) = get_ovmf_files
($arch);
7071 die "EFI vars default image not found\n" if ! -f
$ovmf_vars;
7073 my $vars_size_b = -s
$ovmf_vars;
7074 my $vars_size = PVE
::Tools
::convert_size
($vars_size_b, 'b' => 'kb');
7075 my $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $vmid, $fmt, undef, $vars_size);
7076 PVE
::Storage
::activate_volumes
($storecfg, [$volid]);
7078 qemu_img_convert
($ovmf_vars, $volid, $vars_size_b, undef, 0);
7079 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $volid, 3);
7081 return ($volid, $size/1024);
7084 sub vm_iothreads_list
{
7087 my $res = mon_cmd
($vmid, 'query-iothreads');
7090 foreach my $iothread (@$res) {
7091 $iothreads->{ $iothread->{id
} } = $iothread->{"thread-id"};
7098 my ($conf, $drive) = @_;
7102 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)) {
7104 } elsif ($conf->{scsihw
} && ($conf->{scsihw
} eq 'virtio-scsi-single')) {
7110 my $controller = int($drive->{index} / $maxdev);
7111 my $controller_prefix = ($conf->{scsihw
} && $conf->{scsihw
} eq 'virtio-scsi-single') ?
"virtioscsi" : "scsihw";
7113 return ($maxdev, $controller, $controller_prefix);
7116 sub windows_version
{
7119 return 0 if !$ostype;
7123 if($ostype eq 'wxp' || $ostype eq 'w2k3' || $ostype eq 'w2k') {
7125 } elsif($ostype eq 'w2k8' || $ostype eq 'wvista') {
7127 } elsif ($ostype =~ m/^win(\d+)$/) {
7134 sub resolve_dst_disk_format
{
7135 my ($storecfg, $storeid, $src_volname, $format) = @_;
7136 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($storecfg, $storeid);
7139 # if no target format is specified, use the source disk format as hint
7141 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
7142 $format = qemu_img_format
($scfg, $src_volname);
7148 # test if requested format is supported - else use default
7149 my $supported = grep { $_ eq $format } @$validFormats;
7150 $format = $defFormat if !$supported;
7154 sub resolve_first_disk
{
7156 my @disks = PVE
::QemuServer
::valid_drive_names
();
7158 foreach my $ds (reverse @disks) {
7159 next if !$conf->{$ds};
7160 my $disk = PVE
::QemuServer
::parse_drive
($ds, $conf->{$ds});
7161 next if PVE
::QemuServer
::drive_is_cdrom
($disk);
7167 # NOTE: if this logic changes, please update docs & possibly gui logic
7168 sub find_vmstate_storage
{
7169 my ($conf, $storecfg) = @_;
7171 # first, return storage from conf if set
7172 return $conf->{vmstatestorage
} if $conf->{vmstatestorage
};
7174 my ($target, $shared, $local);
7176 foreach_storage_used_by_vm
($conf, sub {
7178 my $scfg = PVE
::Storage
::storage_config
($storecfg, $sid);
7179 my $dst = $scfg->{shared
} ? \
$shared : \
$local;
7180 $$dst = $sid if !$$dst || $scfg->{path
}; # prefer file based storage
7183 # second, use shared storage where VM has at least one disk
7184 # third, use local storage where VM has at least one disk
7185 # fall back to local storage
7186 $target = $shared // $local // 'local';
7192 my ($uuid, $uuid_str);
7193 UUID
::generate
($uuid);
7194 UUID
::unparse
($uuid, $uuid_str);
7198 sub generate_smbios1_uuid
{
7199 return "uuid=".generate_uuid
();
7205 mon_cmd
($vmid, 'nbd-server-stop');
7208 sub create_reboot_request
{
7210 open(my $fh, '>', "/run/qemu-server/$vmid.reboot")
7211 or die "failed to create reboot trigger file: $!\n";
7215 sub clear_reboot_request
{
7217 my $path = "/run/qemu-server/$vmid.reboot";
7220 $res = unlink($path);
7221 die "could not remove reboot request for $vmid: $!"
7222 if !$res && $! != POSIX
::ENOENT
;
7227 # bash completion helper
7229 sub complete_backup_archives
{
7230 my ($cmdname, $pname, $cvalue) = @_;
7232 my $cfg = PVE
::Storage
::config
();
7236 if ($cvalue =~ m/^([^:]+):/) {
7240 my $data = PVE
::Storage
::template_list
($cfg, $storeid, 'backup');
7243 foreach my $id (keys %$data) {
7244 foreach my $item (@{$data->{$id}}) {
7245 next if $item->{format
} !~ m/^vma\.(gz|lzo)$/;
7246 push @$res, $item->{volid
} if defined($item->{volid
});
7253 my $complete_vmid_full = sub {
7256 my $idlist = vmstatus
();
7260 foreach my $id (keys %$idlist) {
7261 my $d = $idlist->{$id};
7262 if (defined($running)) {
7263 next if $d->{template
};
7264 next if $running && $d->{status
} ne 'running';
7265 next if !$running && $d->{status
} eq 'running';
7274 return &$complete_vmid_full();
7277 sub complete_vmid_stopped
{
7278 return &$complete_vmid_full(0);
7281 sub complete_vmid_running
{
7282 return &$complete_vmid_full(1);
7285 sub complete_storage
{
7287 my $cfg = PVE
::Storage
::config
();
7288 my $ids = $cfg->{ids
};
7291 foreach my $sid (keys %$ids) {
7292 next if !PVE
::Storage
::storage_check_enabled
($cfg, $sid, undef, 1);
7293 next if !$ids->{$sid}->{content
}->{images
};
7300 sub complete_migration_storage
{
7301 my ($cmd, $param, $current_value, $all_args) = @_;
7303 my $targetnode = @$all_args[1];
7305 my $cfg = PVE
::Storage
::config
();
7306 my $ids = $cfg->{ids
};
7309 foreach my $sid (keys %$ids) {
7310 next if !PVE
::Storage
::storage_check_enabled
($cfg, $sid, $targetnode, 1);
7311 next if !$ids->{$sid}->{content
}->{images
};