1 package PVE
::QemuServer
;
22 use Storable
qw(dclone);
23 use PVE
::Exception
qw(raise raise_param_exc);
25 use PVE
::Tools
qw(run_command lock_file lock_file_full file_read_firstline dir_glob_foreach $IPV6RE);
26 use PVE
::JSONSchema
qw(get_standard_option);
27 use PVE
::Cluster
qw(cfs_register_file cfs_read_file cfs_write_file cfs_lock_file);
32 use PVE
::RPCEnvironment
;
33 use PVE
::GuestHelpers
;
34 use PVE
::QemuServer
::PCI
qw(print_pci_addr print_pcie_addr);
35 use PVE
::QemuServer
::Memory
;
36 use PVE
::QemuServer
::USB
qw(parse_usb_device);
37 use PVE
::QemuServer
::Cloudinit
;
40 use Time
::HiRes
qw(gettimeofday);
41 use File
::Copy
qw(copy);
44 my $EDK2_FW_BASE = '/usr/share/pve-edk2-firmware/';
47 "$EDK2_FW_BASE/OVMF_CODE.fd",
48 "$EDK2_FW_BASE/OVMF_VARS.fd"
51 "$EDK2_FW_BASE/AAVMF_CODE.fd",
52 "$EDK2_FW_BASE/AAVMF_VARS.fd"
56 my $qemu_snap_storage = {rbd
=> 1, sheepdog
=> 1};
58 my $cpuinfo = PVE
::ProcFSTools
::read_cpuinfo
();
60 my $QEMU_FORMAT_RE = qr/raw|cow|qcow|qcow2|qed|vmdk|cloop/;
62 # Note about locking: we use flock on the config file protect
63 # against concurent actions.
64 # Aditionaly, we have a 'lock' setting in the config file. This
65 # can be set to 'migrate', 'backup', 'snapshot' or 'rollback'. Most actions are not
66 # allowed when such lock is set. But you can ignore this kind of
67 # lock with the --skiplock flag.
69 cfs_register_file
('/qemu-server/',
73 PVE
::JSONSchema
::register_standard_option
('pve-qm-stateuri', {
74 description
=> "Some command save/restore state from this location.",
80 PVE
::JSONSchema
::register_standard_option
('pve-snapshot-name', {
81 description
=> "The name of the snapshot.",
82 type
=> 'string', format
=> 'pve-configid',
86 PVE
::JSONSchema
::register_standard_option
('pve-qm-image-format', {
88 enum
=> [qw(raw cow qcow qed qcow2 vmdk cloop)],
89 description
=> "The drive's backing file's data format.",
93 PVE
::JSONSchema
::register_standard_option
('pve-qemu-machine', {
94 description
=> "Specifies the Qemu machine type.",
96 pattern
=> '(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)',
101 #no warnings 'redefine';
104 my ($controller, $vmid, $option, $value) = @_;
106 my $path = "/sys/fs/cgroup/$controller/qemu.slice/$vmid.scope/$option";
107 PVE
::ProcFSTools
::write_proc_entry
($path, $value);
111 my $nodename = PVE
::INotify
::nodename
();
113 mkdir "/etc/pve/nodes/$nodename";
114 my $confdir = "/etc/pve/nodes/$nodename/qemu-server";
117 my $var_run_tmpdir = "/var/run/qemu-server";
118 mkdir $var_run_tmpdir;
120 my $lock_dir = "/var/lock/qemu-server";
123 my $cpu_vendor_list = {
125 486 => 'GenuineIntel',
126 pentium
=> 'GenuineIntel',
127 pentium2
=> 'GenuineIntel',
128 pentium3
=> 'GenuineIntel',
129 coreduo
=> 'GenuineIntel',
130 core2duo
=> 'GenuineIntel',
131 Conroe
=> 'GenuineIntel',
132 Penryn
=> 'GenuineIntel',
133 Nehalem
=> 'GenuineIntel',
134 'Nehalem-IBRS' => 'GenuineIntel',
135 Westmere
=> 'GenuineIntel',
136 'Westmere-IBRS' => 'GenuineIntel',
137 SandyBridge
=> 'GenuineIntel',
138 'SandyBridge-IBRS' => 'GenuineIntel',
139 IvyBridge
=> 'GenuineIntel',
140 'IvyBridge-IBRS' => 'GenuineIntel',
141 Haswell
=> 'GenuineIntel',
142 'Haswell-IBRS' => 'GenuineIntel',
143 'Haswell-noTSX' => 'GenuineIntel',
144 'Haswell-noTSX-IBRS' => 'GenuineIntel',
145 Broadwell
=> 'GenuineIntel',
146 'Broadwell-IBRS' => 'GenuineIntel',
147 'Broadwell-noTSX' => 'GenuineIntel',
148 'Broadwell-noTSX-IBRS' => 'GenuineIntel',
149 'Skylake-Client' => 'GenuineIntel',
150 'Skylake-Client-IBRS' => 'GenuineIntel',
151 'Skylake-Server' => 'GenuineIntel',
152 'Skylake-Server-IBRS' => 'GenuineIntel',
155 athlon
=> 'AuthenticAMD',
156 phenom
=> 'AuthenticAMD',
157 Opteron_G1
=> 'AuthenticAMD',
158 Opteron_G2
=> 'AuthenticAMD',
159 Opteron_G3
=> 'AuthenticAMD',
160 Opteron_G4
=> 'AuthenticAMD',
161 Opteron_G5
=> 'AuthenticAMD',
162 EPYC
=> 'AuthenticAMD',
163 'EPYC-IBPB' => 'AuthenticAMD',
165 # generic types, use vendor from host node
174 my $cpu_flag = qr/[+-](pcid|spec-ctrl|ibpb|ssbd|virt-ssbd|amd-ssbd|amd-no-ssb|pdpe1gb)/;
178 description
=> "Emulated CPU type.",
180 enum
=> [ sort { "\L$a" cmp "\L$b" } keys %$cpu_vendor_list ],
185 description
=> "Do not identify as a KVM virtual machine.",
192 pattern
=> qr/[a-zA-Z0-9]{1,12}/,
193 format_description
=> 'vendor-id',
194 description
=> 'The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a specific ID.',
198 description
=> "List of additional CPU flags separated by ';'."
199 . " Use '+FLAG' to enable, '-FLAG' to disable a flag."
200 . " Currently supported flags: 'pcid', 'spec-ctrl', 'ibpb', 'ssbd', 'virt-ssbd', 'amd-ssbd', 'amd-no-ssb', 'pdpe1gb'.",
201 format_description
=> '+FLAG[;-FLAG...]',
203 pattern
=> qr/$cpu_flag(;$cpu_flag)*/,
212 enum
=> [qw(i6300esb ib700)],
213 description
=> "Watchdog type to emulate.",
214 default => 'i6300esb',
219 enum
=> [qw(reset shutdown poweroff pause debug none)],
220 description
=> "The action to perform if after activation the guest fails to poll the watchdog in time.",
224 PVE
::JSONSchema
::register_format
('pve-qm-watchdog', $watchdog_fmt);
228 description
=> "Enable/disable Qemu GuestAgent.",
233 fstrim_cloned_disks
=> {
234 description
=> "Run fstrim after cloning/moving a disk.",
243 description
=> "Select the VGA type.",
248 enum
=> [qw(cirrus qxl qxl2 qxl3 qxl4 none serial0 serial1 serial2 serial3 std virtio vmware)],
251 description
=> "Sets the VGA memory (in MiB). Has no effect with serial display.",
263 description
=> "The size of the file in MB.",
267 pattern
=> '[a-zA-Z0-9\-]+',
269 format_description
=> 'string',
270 description
=> "The name of the file. Will be prefixed with 'pve-shm-'. Default is the VMID. Will be deleted when the VM is stopped.",
278 description
=> "Specifies whether a VM will be started during system bootup.",
284 description
=> "Automatic restart after crash (currently ignored).",
289 type
=> 'string', format
=> 'pve-hotplug-features',
290 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'.",
291 default => 'network,disk,usb',
296 description
=> "Allow reboot. If set to '0' the VM exit on reboot.",
302 description
=> "Lock/unlock the VM.",
303 enum
=> [qw(backup clone create migrate rollback snapshot snapshot-delete suspending suspended)],
308 description
=> "Limit of CPU usage.",
309 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.",
317 description
=> "CPU weight for a VM.",
318 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.",
326 description
=> "Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.",
333 description
=> "Amount of target RAM for the VM in MB. Using zero disables the ballon driver.",
339 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.",
347 description
=> "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.".
348 "It should not be necessary to set it.",
349 enum
=> PVE
::Tools
::kvmkeymaplist
(),
354 type
=> 'string', format
=> 'dns-name',
355 description
=> "Set a name for the VM. Only used on the configuration web interface.",
360 description
=> "SCSI controller model",
361 enum
=> [qw(lsi lsi53c810 virtio-scsi-pci virtio-scsi-single megasas pvscsi)],
367 description
=> "Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.",
372 enum
=> [qw(other wxp w2k w2k3 w2k8 wvista win7 win8 win10 l24 l26 solaris)],
373 description
=> "Specify guest operating system.",
374 verbose_description
=> <<EODESC,
375 Specify guest operating system. This is used to enable special
376 optimization/features for specific operating systems:
379 other;; unspecified OS
380 wxp;; Microsoft Windows XP
381 w2k;; Microsoft Windows 2000
382 w2k3;; Microsoft Windows 2003
383 w2k8;; Microsoft Windows 2008
384 wvista;; Microsoft Windows Vista
385 win7;; Microsoft Windows 7
386 win8;; Microsoft Windows 8/2012/2012r2
387 win10;; Microsoft Windows 10/2016
388 l24;; Linux 2.4 Kernel
389 l26;; Linux 2.6/3.X Kernel
390 solaris;; Solaris/OpenSolaris/OpenIndiania kernel
396 description
=> "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).",
397 pattern
=> '[acdn]{1,4}',
402 type
=> 'string', format
=> 'pve-qm-bootdisk',
403 description
=> "Enable booting from specified disk.",
404 pattern
=> '(ide|sata|scsi|virtio)\d+',
409 description
=> "The number of CPUs. Please use option -sockets instead.",
416 description
=> "The number of CPU sockets.",
423 description
=> "The number of cores per socket.",
430 description
=> "Enable/disable NUMA.",
436 description
=> "Enable/disable hugepages memory.",
437 enum
=> [qw(any 2 1024)],
442 description
=> "Number of hotplugged vcpus.",
449 description
=> "Enable/disable ACPI.",
454 description
=> "Enable/disable Qemu GuestAgent and its properties.",
456 format
=> $agent_fmt,
461 description
=> "Enable/disable KVM hardware virtualization.",
467 description
=> "Enable/disable time drift fix.",
473 description
=> "Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.",
478 description
=> "Freeze CPU at startup (use 'c' monitor command to start execution).",
482 type
=> 'string', format
=> $vga_fmt,
483 description
=> "Configure the VGA hardware.",
484 verbose_description
=> "Configure the VGA Hardware. If you want to use ".
485 "high resolution modes (>= 1280x1024x16) you may need to increase " .
486 "the vga memory option. Since QEMU 2.9 the default VGA display type " .
487 "is 'std' for all OS types besides some Windows versions (XP and " .
488 "older) which use 'cirrus'. The 'qxl' option enables the SPICE " .
489 "display server. For win* OS you can select how many independent " .
490 "displays you want, Linux guests can add displays them self.\n".
491 "You can also run without any graphic card, using a serial device as terminal.",
495 type
=> 'string', format
=> 'pve-qm-watchdog',
496 description
=> "Create a virtual hardware watchdog device.",
497 verbose_description
=> "Create a virtual hardware watchdog device. Once enabled" .
498 " (by a guest action), the watchdog must be periodically polled " .
499 "by an agent inside the guest or else the watchdog will reset " .
500 "the guest (or execute the respective action specified)",
505 typetext
=> "(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)",
506 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'.",
507 pattern
=> '(now|\d{4}-\d{1,2}-\d{1,2}(T\d{1,2}:\d{1,2}:\d{1,2})?)',
510 startup
=> get_standard_option
('pve-startup-order'),
514 description
=> "Enable/disable Template.",
520 description
=> "Arbitrary arguments passed to kvm.",
521 verbose_description
=> <<EODESCR,
522 Arbitrary arguments passed to kvm, for example:
524 args: -no-reboot -no-hpet
526 NOTE: this option is for experts only.
533 description
=> "Enable/disable the USB tablet device.",
534 verbose_description
=> "Enable/disable the USB tablet device. This device is " .
535 "usually needed to allow absolute mouse positioning with VNC. " .
536 "Else the mouse runs out of sync with normal VNC clients. " .
537 "If you're running lots of console-only guests on one host, " .
538 "you may consider disabling this to save some context switches. " .
539 "This is turned off by default if you use spice (-vga=qxl).",
544 description
=> "Set maximum speed (in MB/s) for migrations. Value 0 is no limit.",
548 migrate_downtime
=> {
551 description
=> "Set maximum tolerated downtime (in seconds) for migrations.",
557 type
=> 'string', format
=> 'pve-qm-ide',
558 typetext
=> '<volume>',
559 description
=> "This is an alias for option -ide2",
563 description
=> "Emulated CPU type.",
567 parent
=> get_standard_option
('pve-snapshot-name', {
569 description
=> "Parent snapshot name. This is used internally, and should not be modified.",
573 description
=> "Timestamp for snapshots.",
579 type
=> 'string', format
=> 'pve-volume-id',
580 description
=> "Reference to a volume which stores the VM state. This is used internally for snapshots.",
582 vmstatestorage
=> get_standard_option
('pve-storage-id', {
583 description
=> "Default storage for VM state volumes/files.",
586 runningmachine
=> get_standard_option
('pve-qemu-machine', {
587 description
=> "Specifies the Qemu machine type of the running vm. This is used internally for snapshots.",
589 machine
=> get_standard_option
('pve-qemu-machine'),
591 description
=> "Virtual processor architecture. Defaults to the host.",
594 enum
=> [qw(x86_64 aarch64)],
597 description
=> "Specify SMBIOS type 1 fields.",
598 type
=> 'string', format
=> 'pve-qm-smbios1',
605 description
=> "Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.",
611 enum
=> [ qw(seabios ovmf) ],
612 description
=> "Select BIOS implementation.",
613 default => 'seabios',
617 pattern
=> '(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])',
618 format_description
=> 'UUID',
619 description
=> "Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.",
620 verbose_description
=> "The VM generation ID (vmgenid) device exposes a".
621 " 128-bit integer value identifier to the guest OS. This allows to".
622 " notify the guest operating system when the virtual machine is".
623 " executed with a different configuration (e.g. snapshot execution".
624 " or creation from a template). The guest operating system notices".
625 " the change, and is then able to react as appropriate by marking".
626 " its copies of distributed databases as dirty, re-initializing its".
627 " random number generator, etc.\n".
628 "Note that auto-creation only works when done throug API/CLI create".
629 " or update methods, but not when manually editing the config file.",
630 default => "1 (autogenerated)",
635 format
=> 'pve-volume-id',
637 description
=> "Script that will be executed during various steps in the vms lifetime.",
641 format
=> $ivshmem_fmt,
642 description
=> "Inter-VM shared memory. Useful for direct communication between VMs, or to the host.",
651 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.',
652 format
=> 'pve-volume-id',
653 format_description
=> 'volume',
658 description
=> 'Specify a custom file containing all network data passed to the VM via cloud-init.',
659 format
=> 'pve-volume-id',
660 format_description
=> 'volume',
665 description
=> 'Specify a custom file containing all user data passed to the VM via cloud-init.',
666 format
=> 'pve-volume-id',
667 format_description
=> 'volume',
670 PVE
::JSONSchema
::register_format
('pve-qm-cicustom', $cicustom_fmt);
672 my $confdesc_cloudinit = {
676 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.',
677 enum
=> ['configdrive2', 'nocloud'],
682 description
=> "cloud-init: User name to change ssh keys and password for instead of the image's configured default user.",
687 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.',
692 description
=> 'cloud-init: Specify custom files to replace the automatically generated ones at start.',
693 format
=> 'pve-qm-cicustom',
698 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.",
702 type
=> 'string', format
=> 'address-list',
703 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.",
708 format
=> 'urlencoded',
709 description
=> "cloud-init: Setup public SSH keys (one key per line, OpenSSH format).",
713 # what about other qemu settings ?
715 #machine => 'string',
728 ##soundhw => 'string',
730 while (my ($k, $v) = each %$confdesc) {
731 PVE
::JSONSchema
::register_standard_option
("pve-qm-$k", $v);
734 my $MAX_IDE_DISKS = 4;
735 my $MAX_SCSI_DISKS = 14;
736 my $MAX_VIRTIO_DISKS = 16;
737 my $MAX_SATA_DISKS = 6;
738 my $MAX_USB_DEVICES = 5;
740 my $MAX_UNUSED_DISKS = 256;
741 my $MAX_HOSTPCI_DEVICES = 4;
742 my $MAX_SERIAL_PORTS = 4;
743 my $MAX_PARALLEL_PORTS = 3;
749 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
750 description
=> "CPUs accessing this NUMA node.",
751 format_description
=> "id[-id];...",
755 description
=> "Amount of memory this NUMA node provides.",
760 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
761 description
=> "Host NUMA nodes to use.",
762 format_description
=> "id[-id];...",
767 enum
=> [qw(preferred bind interleave)],
768 description
=> "NUMA allocation policy.",
772 PVE
::JSONSchema
::register_format
('pve-qm-numanode', $numa_fmt);
775 type
=> 'string', format
=> $numa_fmt,
776 description
=> "NUMA topology.",
778 PVE
::JSONSchema
::register_standard_option
("pve-qm-numanode", $numadesc);
780 for (my $i = 0; $i < $MAX_NUMA; $i++) {
781 $confdesc->{"numa$i"} = $numadesc;
784 my $nic_model_list = ['rtl8139', 'ne2k_pci', 'e1000', 'pcnet', 'virtio',
785 'ne2k_isa', 'i82551', 'i82557b', 'i82559er', 'vmxnet3',
786 'e1000-82540em', 'e1000-82544gc', 'e1000-82545em'];
787 my $nic_model_list_txt = join(' ', sort @$nic_model_list);
789 my $net_fmt_bridge_descr = <<__EOD__;
790 Bridge to attach the network device to. The Proxmox VE standard bridge
793 If you do not specify a bridge, we create a kvm user (NATed) network
794 device, which provides DHCP and DNS services. The following addresses
801 The DHCP server assign addresses to the guest starting from 10.0.2.15.
805 macaddr
=> get_standard_option
('mac-addr', {
806 description
=> "MAC address. That address must be unique withing your network. This is automatically generated if not specified.",
810 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'.",
811 enum
=> $nic_model_list,
814 (map { $_ => { keyAlias
=> 'model', alias
=> 'macaddr' }} @$nic_model_list),
817 description
=> $net_fmt_bridge_descr,
818 format_description
=> 'bridge',
823 minimum
=> 0, maximum
=> 16,
824 description
=> 'Number of packet queues to be used on the device.',
830 description
=> "Rate limit in mbps (megabytes per second) as floating point number.",
835 minimum
=> 1, maximum
=> 4094,
836 description
=> 'VLAN tag to apply to packets on this interface.',
841 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
842 description
=> 'VLAN trunks to pass through this interface.',
843 format_description
=> 'vlanid[;vlanid...]',
848 description
=> 'Whether this interface should be protected by the firewall.',
853 description
=> 'Whether this interface should be disconnected (like pulling the plug).',
860 type
=> 'string', format
=> $net_fmt,
861 description
=> "Specify network devices.",
864 PVE
::JSONSchema
::register_standard_option
("pve-qm-net", $netdesc);
869 format
=> 'pve-ipv4-config',
870 format_description
=> 'IPv4Format/CIDR',
871 description
=> 'IPv4 address in CIDR format.',
878 format_description
=> 'GatewayIPv4',
879 description
=> 'Default gateway for IPv4 traffic.',
885 format
=> 'pve-ipv6-config',
886 format_description
=> 'IPv6Format/CIDR',
887 description
=> 'IPv6 address in CIDR format.',
894 format_description
=> 'GatewayIPv6',
895 description
=> 'Default gateway for IPv6 traffic.',
900 PVE
::JSONSchema
::register_format
('pve-qm-ipconfig', $ipconfig_fmt);
903 type
=> 'string', format
=> 'pve-qm-ipconfig',
904 description
=> <<'EODESCR',
905 cloud-init: Specify IP addresses and gateways for the corresponding interface.
907 IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
909 The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
910 For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
912 If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
915 PVE
::JSONSchema
::register_standard_option
("pve-qm-ipconfig", $netdesc);
917 for (my $i = 0; $i < $MAX_NETS; $i++) {
918 $confdesc->{"net$i"} = $netdesc;
919 $confdesc_cloudinit->{"ipconfig$i"} = $ipconfigdesc;
922 foreach my $key (keys %$confdesc_cloudinit) {
923 $confdesc->{$key} = $confdesc_cloudinit->{$key};
926 PVE
::JSONSchema
::register_format
('pve-volume-id-or-qm-path', \
&verify_volume_id_or_qm_path
);
927 sub verify_volume_id_or_qm_path
{
928 my ($volid, $noerr) = @_;
930 if ($volid eq 'none' || $volid eq 'cdrom' || $volid =~ m
|^/|) {
934 # if its neither 'none' nor 'cdrom' nor a path, check if its a volume-id
935 $volid = eval { PVE
::JSONSchema
::check_format
('pve-volume-id', $volid, '') };
937 return undef if $noerr;
945 my %drivedesc_base = (
946 volume
=> { alias
=> 'file' },
949 format
=> 'pve-volume-id-or-qm-path',
951 format_description
=> 'volume',
952 description
=> "The drive's backing volume.",
956 enum
=> [qw(cdrom disk)],
957 description
=> "The drive's media type.",
963 description
=> "Force the drive's physical geometry to have a specific cylinder count.",
968 description
=> "Force the drive's physical geometry to have a specific head count.",
973 description
=> "Force the drive's physical geometry to have a specific sector count.",
978 enum
=> [qw(none lba auto)],
979 description
=> "Force disk geometry bios translation mode.",
984 description
=> "Controls qemu's snapshot mode feature."
985 . " If activated, changes made to the disk are temporary and will"
986 . " be discarded when the VM is shutdown.",
991 enum
=> [qw(none writethrough writeback unsafe directsync)],
992 description
=> "The drive's cache mode",
995 format
=> get_standard_option
('pve-qm-image-format'),
998 format
=> 'disk-size',
999 format_description
=> 'DiskSize',
1000 description
=> "Disk size. This is purely informational and has no effect.",
1005 description
=> "Whether the drive should be included when making backups.",
1010 description
=> 'Whether the drive should considered for replication jobs.',
1016 enum
=> [qw(ignore report stop)],
1017 description
=> 'Read error action.',
1022 enum
=> [qw(enospc ignore report stop)],
1023 description
=> 'Write error action.',
1028 enum
=> [qw(native threads)],
1029 description
=> 'AIO type to use.',
1034 enum
=> [qw(ignore on)],
1035 description
=> 'Controls whether to pass discard/trim requests to the underlying storage.',
1040 description
=> 'Controls whether to detect and try to optimize writes of zeroes.',
1045 format
=> 'urlencoded',
1046 format_description
=> 'serial',
1047 maxLength
=> 20*3, # *3 since it's %xx url enoded
1048 description
=> "The drive's reported serial number, url-encoded, up to 20 bytes long.",
1053 description
=> 'Mark this locally-managed volume as available on all nodes',
1054 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!",
1060 my %iothread_fmt = ( iothread
=> {
1062 description
=> "Whether to use iothreads for this drive",
1069 format
=> 'urlencoded',
1070 format_description
=> 'model',
1071 maxLength
=> 40*3, # *3 since it's %xx url enoded
1072 description
=> "The drive's reported model name, url-encoded, up to 40 bytes long.",
1080 description
=> "Number of queues.",
1086 my %scsiblock_fmt = (
1089 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",
1098 description
=> "Whether to expose this drive as an SSD, rather than a rotational hard disk.",
1106 pattern
=> qr/^(0x)[0-9a-fA-F]{16}/,
1107 format_description
=> 'wwn',
1108 description
=> "The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.",
1113 my $add_throttle_desc = sub {
1114 my ($key, $type, $what, $unit, $longunit, $minimum) = @_;
1117 format_description
=> $unit,
1118 description
=> "Maximum $what in $longunit.",
1121 $d->{minimum
} = $minimum if defined($minimum);
1122 $drivedesc_base{$key} = $d;
1124 # throughput: (leaky bucket)
1125 $add_throttle_desc->('bps', 'integer', 'r/w speed', 'bps', 'bytes per second');
1126 $add_throttle_desc->('bps_rd', 'integer', 'read speed', 'bps', 'bytes per second');
1127 $add_throttle_desc->('bps_wr', 'integer', 'write speed', 'bps', 'bytes per second');
1128 $add_throttle_desc->('mbps', 'number', 'r/w speed', 'mbps', 'megabytes per second');
1129 $add_throttle_desc->('mbps_rd', 'number', 'read speed', 'mbps', 'megabytes per second');
1130 $add_throttle_desc->('mbps_wr', 'number', 'write speed', 'mbps', 'megabytes per second');
1131 $add_throttle_desc->('iops', 'integer', 'r/w I/O', 'iops', 'operations per second');
1132 $add_throttle_desc->('iops_rd', 'integer', 'read I/O', 'iops', 'operations per second');
1133 $add_throttle_desc->('iops_wr', 'integer', 'write I/O', 'iops', 'operations per second');
1135 # pools: (pool of IO before throttling starts taking effect)
1136 $add_throttle_desc->('mbps_max', 'number', 'unthrottled r/w pool', 'mbps', 'megabytes per second');
1137 $add_throttle_desc->('mbps_rd_max', 'number', 'unthrottled read pool', 'mbps', 'megabytes per second');
1138 $add_throttle_desc->('mbps_wr_max', 'number', 'unthrottled write pool', 'mbps', 'megabytes per second');
1139 $add_throttle_desc->('iops_max', 'integer', 'unthrottled r/w I/O pool', 'iops', 'operations per second');
1140 $add_throttle_desc->('iops_rd_max', 'integer', 'unthrottled read I/O pool', 'iops', 'operations per second');
1141 $add_throttle_desc->('iops_wr_max', 'integer', 'unthrottled write I/O pool', 'iops', 'operations per second');
1144 $add_throttle_desc->('bps_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1145 $add_throttle_desc->('bps_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1146 $add_throttle_desc->('bps_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1147 $add_throttle_desc->('iops_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1148 $add_throttle_desc->('iops_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1149 $add_throttle_desc->('iops_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1152 $drivedesc_base{'bps_rd_length'} = { alias
=> 'bps_rd_max_length' };
1153 $drivedesc_base{'bps_wr_length'} = { alias
=> 'bps_wr_max_length' };
1154 $drivedesc_base{'iops_rd_length'} = { alias
=> 'iops_rd_max_length' };
1155 $drivedesc_base{'iops_wr_length'} = { alias
=> 'iops_wr_max_length' };
1163 PVE
::JSONSchema
::register_format
("pve-qm-ide", $ide_fmt);
1167 type
=> 'string', format
=> $ide_fmt,
1168 description
=> "Use volume as IDE hard disk or CD-ROM (n is 0 to " .($MAX_IDE_DISKS -1) . ").",
1170 PVE
::JSONSchema
::register_standard_option
("pve-qm-ide", $idedesc);
1182 type
=> 'string', format
=> $scsi_fmt,
1183 description
=> "Use volume as SCSI hard disk or CD-ROM (n is 0 to " . ($MAX_SCSI_DISKS - 1) . ").",
1185 PVE
::JSONSchema
::register_standard_option
("pve-qm-scsi", $scsidesc);
1194 type
=> 'string', format
=> $sata_fmt,
1195 description
=> "Use volume as SATA hard disk or CD-ROM (n is 0 to " . ($MAX_SATA_DISKS - 1). ").",
1197 PVE
::JSONSchema
::register_standard_option
("pve-qm-sata", $satadesc);
1205 type
=> 'string', format
=> $virtio_fmt,
1206 description
=> "Use volume as VIRTIO hard disk (n is 0 to " . ($MAX_VIRTIO_DISKS - 1) . ").",
1208 PVE
::JSONSchema
::register_standard_option
("pve-qm-virtio", $virtiodesc);
1210 my $alldrive_fmt = {
1221 volume
=> { alias
=> 'file' },
1224 format
=> 'pve-volume-id-or-qm-path',
1226 format_description
=> 'volume',
1227 description
=> "The drive's backing volume.",
1229 format
=> get_standard_option
('pve-qm-image-format'),
1232 format
=> 'disk-size',
1233 format_description
=> 'DiskSize',
1234 description
=> "Disk size. This is purely informational and has no effect.",
1239 my $efidisk_desc = {
1241 type
=> 'string', format
=> $efidisk_fmt,
1242 description
=> "Configure a Disk for storing EFI vars",
1245 PVE
::JSONSchema
::register_standard_option
("pve-qm-efidisk", $efidisk_desc);
1250 type
=> 'string', format
=> 'pve-qm-usb-device',
1251 format_description
=> 'HOSTUSBDEVICE|spice',
1252 description
=> <<EODESCR,
1253 The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:
1255 'bus-port(.port)*' (decimal numbers) or
1256 'vendor_id:product_id' (hexadeciaml numbers) or
1259 You can use the 'lsusb -t' command to list existing usb devices.
1261 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1263 The value 'spice' can be used to add a usb redirection devices for spice.
1269 description
=> "Specifies whether if given host option is a USB3 device or port (this does currently not work reliably with spice redirection and is then ignored).",
1276 type
=> 'string', format
=> $usb_fmt,
1277 description
=> "Configure an USB device (n is 0 to 4).",
1279 PVE
::JSONSchema
::register_standard_option
("pve-qm-usb", $usbdesc);
1281 my $PCIRE = qr/[a-f0-9]{2}:[a-f0-9]{2}(?:\.[a-f0-9])?/;
1286 pattern
=> qr/$PCIRE(;$PCIRE)*/,
1287 format_description
=> 'HOSTPCIID[;HOSTPCIID2...]',
1288 description
=> <<EODESCR,
1289 Host PCI device pass through. The PCI ID of a host's PCI device or a list
1290 of PCI virtual functions of the host. HOSTPCIID syntax is:
1292 'bus:dev.func' (hexadecimal numbers)
1294 You can us the 'lspci' command to list existing PCI devices.
1299 description
=> "Specify whether or not the device's ROM will be visible in the guest's memory map.",
1305 pattern
=> '[^,;]+',
1306 format_description
=> 'string',
1307 description
=> "Custom pci device rom filename (must be located in /usr/share/kvm/).",
1312 description
=> "Choose the PCI-express bus (needs the 'q35' machine model).",
1318 description
=> "Enable vfio-vga device support.",
1324 format_description
=> 'string',
1325 pattern
=> '[^/\.:]+',
1327 description
=> <<EODESCR
1328 The type of mediated device to use.
1329 An instance of this type will be created on startup of the VM and
1330 will be cleaned up when the VM stops.
1334 PVE
::JSONSchema
::register_format
('pve-qm-hostpci', $hostpci_fmt);
1338 type
=> 'string', format
=> 'pve-qm-hostpci',
1339 description
=> "Map host PCI devices into guest.",
1340 verbose_description
=> <<EODESCR,
1341 Map host PCI devices into guest.
1343 NOTE: This option allows direct access to host hardware. So it is no longer
1344 possible to migrate such machines - use with special care.
1346 CAUTION: Experimental! User reported problems with this option.
1349 PVE
::JSONSchema
::register_standard_option
("pve-qm-hostpci", $hostpcidesc);
1354 pattern
=> '(/dev/.+|socket)',
1355 description
=> "Create a serial device inside the VM (n is 0 to 3)",
1356 verbose_description
=> <<EODESCR,
1357 Create a serial device inside the VM (n is 0 to 3), and pass through a
1358 host serial device (i.e. /dev/ttyS0), or create a unix socket on the
1359 host side (use 'qm terminal' to open a terminal connection).
1361 NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
1363 CAUTION: Experimental! User reported problems with this option.
1370 pattern
=> '/dev/parport\d+|/dev/usb/lp\d+',
1371 description
=> "Map host parallel devices (n is 0 to 2).",
1372 verbose_description
=> <<EODESCR,
1373 Map host parallel devices (n is 0 to 2).
1375 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1377 CAUTION: Experimental! User reported problems with this option.
1381 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
1382 $confdesc->{"parallel$i"} = $paralleldesc;
1385 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
1386 $confdesc->{"serial$i"} = $serialdesc;
1389 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
1390 $confdesc->{"hostpci$i"} = $hostpcidesc;
1393 for (my $i = 0; $i < $MAX_IDE_DISKS; $i++) {
1394 $drivename_hash->{"ide$i"} = 1;
1395 $confdesc->{"ide$i"} = $idedesc;
1398 for (my $i = 0; $i < $MAX_SATA_DISKS; $i++) {
1399 $drivename_hash->{"sata$i"} = 1;
1400 $confdesc->{"sata$i"} = $satadesc;
1403 for (my $i = 0; $i < $MAX_SCSI_DISKS; $i++) {
1404 $drivename_hash->{"scsi$i"} = 1;
1405 $confdesc->{"scsi$i"} = $scsidesc ;
1408 for (my $i = 0; $i < $MAX_VIRTIO_DISKS; $i++) {
1409 $drivename_hash->{"virtio$i"} = 1;
1410 $confdesc->{"virtio$i"} = $virtiodesc;
1413 $drivename_hash->{efidisk0
} = 1;
1414 $confdesc->{efidisk0
} = $efidisk_desc;
1416 for (my $i = 0; $i < $MAX_USB_DEVICES; $i++) {
1417 $confdesc->{"usb$i"} = $usbdesc;
1422 type
=> 'string', format
=> 'pve-volume-id',
1423 description
=> "Reference to unused volumes. This is used internally, and should not be modified manually.",
1426 for (my $i = 0; $i < $MAX_UNUSED_DISKS; $i++) {
1427 $confdesc->{"unused$i"} = $unuseddesc;
1430 my $kvm_api_version = 0;
1433 return $kvm_api_version if $kvm_api_version;
1435 open my $fh, '<', '/dev/kvm'
1438 # 0xae00 => KVM_GET_API_VERSION
1439 $kvm_api_version = ioctl($fh, 0xae00, 0);
1441 return $kvm_api_version;
1444 my $kvm_user_version;
1446 sub kvm_user_version
{
1448 return $kvm_user_version if $kvm_user_version;
1450 $kvm_user_version = 'unknown';
1454 if ($line =~ m/^QEMU( PC)? emulator version (\d+\.\d+(\.\d+)?)(\.\d+)?[,\s]/) {
1455 $kvm_user_version = $2;
1459 eval { run_command
("kvm -version", outfunc
=> $code); };
1462 return $kvm_user_version;
1466 sub kernel_has_vhost_net
{
1467 return -c
'/dev/vhost-net';
1470 sub valid_drive_names
{
1471 # order is important - used to autoselect boot disk
1472 return ((map { "ide$_" } (0 .. ($MAX_IDE_DISKS - 1))),
1473 (map { "scsi$_" } (0 .. ($MAX_SCSI_DISKS - 1))),
1474 (map { "virtio$_" } (0 .. ($MAX_VIRTIO_DISKS - 1))),
1475 (map { "sata$_" } (0 .. ($MAX_SATA_DISKS - 1))),
1479 sub is_valid_drivename
{
1482 return defined($drivename_hash->{$dev});
1487 return defined($confdesc->{$key});
1491 return $nic_model_list;
1494 sub os_list_description
{
1498 wxp
=> 'Windows XP',
1499 w2k
=> 'Windows 2000',
1500 w2k3
=>, 'Windows 2003',
1501 w2k8
=> 'Windows 2008',
1502 wvista
=> 'Windows Vista',
1503 win7
=> 'Windows 7',
1504 win8
=> 'Windows 8/2012',
1505 win10
=> 'Windows 10/2016',
1513 sub get_cdrom_path
{
1515 return $cdrom_path if $cdrom_path;
1517 return $cdrom_path = "/dev/cdrom" if -l
"/dev/cdrom";
1518 return $cdrom_path = "/dev/cdrom1" if -l
"/dev/cdrom1";
1519 return $cdrom_path = "/dev/cdrom2" if -l
"/dev/cdrom2";
1523 my ($storecfg, $vmid, $cdrom) = @_;
1525 if ($cdrom eq 'cdrom') {
1526 return get_cdrom_path
();
1527 } elsif ($cdrom eq 'none') {
1529 } elsif ($cdrom =~ m
|^/|) {
1532 return PVE
::Storage
::path
($storecfg, $cdrom);
1536 # try to convert old style file names to volume IDs
1537 sub filename_to_volume_id
{
1538 my ($vmid, $file, $media) = @_;
1540 if (!($file eq 'none' || $file eq 'cdrom' ||
1541 $file =~ m
|^/dev/.+| || $file =~ m/^([^:]+):(.+)$/)) {
1543 return undef if $file =~ m
|/|;
1545 if ($media && $media eq 'cdrom') {
1546 $file = "local:iso/$file";
1548 $file = "local:$vmid/$file";
1555 sub verify_media_type
{
1556 my ($opt, $vtype, $media) = @_;
1561 if ($media eq 'disk') {
1563 } elsif ($media eq 'cdrom') {
1566 die "internal error";
1569 return if ($vtype eq $etype);
1571 raise_param_exc
({ $opt => "unexpected media type ($vtype != $etype)" });
1574 sub cleanup_drive_path
{
1575 my ($opt, $storecfg, $drive) = @_;
1577 # try to convert filesystem paths to volume IDs
1579 if (($drive->{file
} !~ m/^(cdrom|none)$/) &&
1580 ($drive->{file
} !~ m
|^/dev/.+|) &&
1581 ($drive->{file
} !~ m/^([^:]+):(.+)$/) &&
1582 ($drive->{file
} !~ m/^\d+$/)) {
1583 my ($vtype, $volid) = PVE
::Storage
::path_to_volume_id
($storecfg, $drive->{file
});
1584 raise_param_exc
({ $opt => "unable to associate path '$drive->{file}' to any storage"}) if !$vtype;
1585 $drive->{media
} = 'cdrom' if !$drive->{media
} && $vtype eq 'iso';
1586 verify_media_type
($opt, $vtype, $drive->{media
});
1587 $drive->{file
} = $volid;
1590 $drive->{media
} = 'cdrom' if !$drive->{media
} && $drive->{file
} =~ m/^(cdrom|none)$/;
1593 sub parse_hotplug_features
{
1598 return $res if $data eq '0';
1600 $data = $confdesc->{hotplug
}->{default} if $data eq '1';
1602 foreach my $feature (PVE
::Tools
::split_list
($data)) {
1603 if ($feature =~ m/^(network|disk|cpu|memory|usb)$/) {
1606 die "invalid hotplug feature '$feature'\n";
1612 PVE
::JSONSchema
::register_format
('pve-hotplug-features', \
&pve_verify_hotplug_features
);
1613 sub pve_verify_hotplug_features
{
1614 my ($value, $noerr) = @_;
1616 return $value if parse_hotplug_features
($value);
1618 return undef if $noerr;
1620 die "unable to parse hotplug option\n";
1623 # ideX = [volume=]volume-id[,media=d][,cyls=c,heads=h,secs=s[,trans=t]]
1624 # [,snapshot=on|off][,cache=on|off][,format=f][,backup=yes|no]
1625 # [,rerror=ignore|report|stop][,werror=enospc|ignore|report|stop]
1626 # [,aio=native|threads][,discard=ignore|on][,detect_zeroes=on|off]
1627 # [,iothread=on][,serial=serial][,model=model]
1630 my ($key, $data) = @_;
1632 my ($interface, $index);
1634 if ($key =~ m/^([^\d]+)(\d+)$/) {
1641 my $desc = $key =~ /^unused\d+$/ ?
$alldrive_fmt
1642 : $confdesc->{$key}->{format
};
1644 warn "invalid drive key: $key\n";
1647 my $res = eval { PVE
::JSONSchema
::parse_property_string
($desc, $data) };
1648 return undef if !$res;
1649 $res->{interface
} = $interface;
1650 $res->{index} = $index;
1653 foreach my $opt (qw(bps bps_rd bps_wr)) {
1654 if (my $bps = defined(delete $res->{$opt})) {
1655 if (defined($res->{"m$opt"})) {
1656 warn "both $opt and m$opt specified\n";
1660 $res->{"m$opt"} = sprintf("%.3f", $bps / (1024*1024.0));
1664 # can't use the schema's 'requires' because of the mbps* => bps* "transforming aliases"
1665 for my $requirement (
1666 [mbps_max
=> 'mbps'],
1667 [mbps_rd_max
=> 'mbps_rd'],
1668 [mbps_wr_max
=> 'mbps_wr'],
1669 [miops_max
=> 'miops'],
1670 [miops_rd_max
=> 'miops_rd'],
1671 [miops_wr_max
=> 'miops_wr'],
1672 [bps_max_length
=> 'mbps_max'],
1673 [bps_rd_max_length
=> 'mbps_rd_max'],
1674 [bps_wr_max_length
=> 'mbps_wr_max'],
1675 [iops_max_length
=> 'iops_max'],
1676 [iops_rd_max_length
=> 'iops_rd_max'],
1677 [iops_wr_max_length
=> 'iops_wr_max']) {
1678 my ($option, $requires) = @$requirement;
1679 if ($res->{$option} && !$res->{$requires}) {
1680 warn "$option requires $requires\n";
1685 return undef if $error;
1687 return undef if $res->{mbps_rd
} && $res->{mbps
};
1688 return undef if $res->{mbps_wr
} && $res->{mbps
};
1689 return undef if $res->{iops_rd
} && $res->{iops
};
1690 return undef if $res->{iops_wr
} && $res->{iops
};
1692 if ($res->{media
} && ($res->{media
} eq 'cdrom')) {
1693 return undef if $res->{snapshot
} || $res->{trans
} || $res->{format
};
1694 return undef if $res->{heads
} || $res->{secs
} || $res->{cyls
};
1695 return undef if $res->{interface
} eq 'virtio';
1698 if (my $size = $res->{size
}) {
1699 return undef if !defined($res->{size
} = PVE
::JSONSchema
::parse_size
($size));
1706 my ($vmid, $drive) = @_;
1707 my $data = { %$drive };
1708 delete $data->{$_} for qw(index interface);
1709 return PVE
::JSONSchema
::print_property_string
($data, $alldrive_fmt);
1713 my($fh, $noerr) = @_;
1716 my $SG_GET_VERSION_NUM = 0x2282;
1718 my $versionbuf = "\x00" x
8;
1719 my $ret = ioctl($fh, $SG_GET_VERSION_NUM, $versionbuf);
1721 die "scsi ioctl SG_GET_VERSION_NUM failoed - $!\n" if !$noerr;
1724 my $version = unpack("I", $versionbuf);
1725 if ($version < 30000) {
1726 die "scsi generic interface too old\n" if !$noerr;
1730 my $buf = "\x00" x
36;
1731 my $sensebuf = "\x00" x
8;
1732 my $cmd = pack("C x3 C x1", 0x12, 36);
1734 # see /usr/include/scsi/sg.h
1735 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";
1737 my $packet = pack($sg_io_hdr_t, ord('S'), -3, length($cmd),
1738 length($sensebuf), 0, length($buf), $buf,
1739 $cmd, $sensebuf, 6000);
1741 $ret = ioctl($fh, $SG_IO, $packet);
1743 die "scsi ioctl SG_IO failed - $!\n" if !$noerr;
1747 my @res = unpack($sg_io_hdr_t, $packet);
1748 if ($res[17] || $res[18]) {
1749 die "scsi ioctl SG_IO status error - $!\n" if !$noerr;
1754 (my $byte0, my $byte1, $res->{vendor
},
1755 $res->{product
}, $res->{revision
}) = unpack("C C x6 A8 A16 A4", $buf);
1757 $res->{removable
} = $byte1 & 128 ?
1 : 0;
1758 $res->{type
} = $byte0 & 31;
1766 my $fh = IO
::File-
>new("+<$path") || return undef;
1767 my $res = scsi_inquiry
($fh, 1);
1773 sub machine_type_is_q35
{
1776 return $conf->{machine
} && ($conf->{machine
} =~ m/q35/) ?
1 : 0;
1779 sub print_tabletdevice_full
{
1780 my ($conf, $arch) = @_;
1782 my $q35 = machine_type_is_q35
($conf);
1784 # we use uhci for old VMs because tablet driver was buggy in older qemu
1786 if (machine_type_is_q35
($conf) || $arch eq 'aarch64') {
1792 return "usb-tablet,id=tablet,bus=$usbbus.0,port=1";
1795 sub print_keyboarddevice_full
{
1796 my ($conf, $arch, $machine) = @_;
1798 return undef if $arch ne 'aarch64';
1800 return "usb-kbd,id=keyboard,bus=ehci.0,port=2";
1803 sub print_drivedevice_full
{
1804 my ($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type) = @_;
1809 if ($drive->{interface
} eq 'virtio') {
1810 my $pciaddr = print_pci_addr
("$drive->{interface}$drive->{index}", $bridges, $arch, $machine_type);
1811 $device = "virtio-blk-pci,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}$pciaddr";
1812 $device .= ",iothread=iothread-$drive->{interface}$drive->{index}" if $drive->{iothread
};
1813 } elsif ($drive->{interface
} eq 'scsi') {
1815 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
1816 my $unit = $drive->{index} % $maxdev;
1817 my $devicetype = 'hd';
1819 if (drive_is_cdrom
($drive)) {
1822 if ($drive->{file
} =~ m
|^/|) {
1823 $path = $drive->{file
};
1824 if (my $info = path_is_scsi
($path)) {
1825 if ($info->{type
} == 0 && $drive->{scsiblock
}) {
1826 $devicetype = 'block';
1827 } elsif ($info->{type
} == 1) { # tape
1828 $devicetype = 'generic';
1832 $path = PVE
::Storage
::path
($storecfg, $drive->{file
});
1835 if($path =~ m/^iscsi\:\/\
//){
1836 $devicetype = 'generic';
1840 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)){
1841 $device = "scsi-$devicetype,bus=$controller_prefix$controller.0,scsi-id=$unit,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1843 $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}";
1846 if ($drive->{ssd
} && ($devicetype eq 'block' || $devicetype eq 'hd')) {
1847 $device .= ",rotation_rate=1";
1849 $device .= ",wwn=$drive->{wwn}" if $drive->{wwn
};
1851 } elsif ($drive->{interface
} eq 'ide' || $drive->{interface
} eq 'sata') {
1852 my $maxdev = ($drive->{interface
} eq 'sata') ?
$MAX_SATA_DISKS : 2;
1853 my $controller = int($drive->{index} / $maxdev);
1854 my $unit = $drive->{index} % $maxdev;
1855 my $devicetype = ($drive->{media
} && $drive->{media
} eq 'cdrom') ?
"cd" : "hd";
1857 $device = "ide-$devicetype";
1858 if ($drive->{interface
} eq 'ide') {
1859 $device .= ",bus=ide.$controller,unit=$unit";
1861 $device .= ",bus=ahci$controller.$unit";
1863 $device .= ",drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1865 if ($devicetype eq 'hd') {
1866 if (my $model = $drive->{model
}) {
1867 $model = URI
::Escape
::uri_unescape
($model);
1868 $device .= ",model=$model";
1870 if ($drive->{ssd
}) {
1871 $device .= ",rotation_rate=1";
1874 $device .= ",wwn=$drive->{wwn}" if $drive->{wwn
};
1875 } elsif ($drive->{interface
} eq 'usb') {
1877 # -device ide-drive,bus=ide.1,unit=0,drive=drive-ide0-1-0,id=ide0-1-0
1879 die "unsupported interface type";
1882 $device .= ",bootindex=$drive->{bootindex}" if $drive->{bootindex
};
1884 if (my $serial = $drive->{serial
}) {
1885 $serial = URI
::Escape
::uri_unescape
($serial);
1886 $device .= ",serial=$serial";
1893 sub get_initiator_name
{
1896 my $fh = IO
::File-
>new('/etc/iscsi/initiatorname.iscsi') || return undef;
1897 while (defined(my $line = <$fh>)) {
1898 next if $line !~ m/^\s*InitiatorName\s*=\s*([\.\-:\w]+)/;
1907 sub print_drive_full
{
1908 my ($storecfg, $vmid, $drive) = @_;
1911 my $volid = $drive->{file
};
1914 if (drive_is_cdrom
($drive)) {
1915 $path = get_iso_path
($storecfg, $vmid, $volid);
1917 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
1919 $path = PVE
::Storage
::path
($storecfg, $volid);
1920 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
1921 $format = qemu_img_format
($scfg, $volname);
1929 my @qemu_drive_options = qw(heads secs cyls trans media format cache rerror werror aio discard);
1930 foreach my $o (@qemu_drive_options) {
1931 $opts .= ",$o=$drive->{$o}" if defined($drive->{$o});
1934 # snapshot only accepts on|off
1935 if (defined($drive->{snapshot
})) {
1936 my $v = $drive->{snapshot
} ?
'on' : 'off';
1937 $opts .= ",snapshot=$v";
1940 foreach my $type (['', '-total'], [_rd
=> '-read'], [_wr
=> '-write']) {
1941 my ($dir, $qmpname) = @$type;
1942 if (my $v = $drive->{"mbps$dir"}) {
1943 $opts .= ",throttling.bps$qmpname=".int($v*1024*1024);
1945 if (my $v = $drive->{"mbps${dir}_max"}) {
1946 $opts .= ",throttling.bps$qmpname-max=".int($v*1024*1024);
1948 if (my $v = $drive->{"bps${dir}_max_length"}) {
1949 $opts .= ",throttling.bps$qmpname-max-length=$v";
1951 if (my $v = $drive->{"iops${dir}"}) {
1952 $opts .= ",throttling.iops$qmpname=$v";
1954 if (my $v = $drive->{"iops${dir}_max"}) {
1955 $opts .= ",throttling.iops$qmpname-max=$v";
1957 if (my $v = $drive->{"iops${dir}_max_length"}) {
1958 $opts .= ",throttling.iops$qmpname-max-length=$v";
1962 $opts .= ",format=$format" if $format && !$drive->{format
};
1964 my $cache_direct = 0;
1966 if (my $cache = $drive->{cache
}) {
1967 $cache_direct = $cache =~ /^(?:off|none|directsync)$/;
1968 } elsif (!drive_is_cdrom
($drive)) {
1969 $opts .= ",cache=none";
1973 # aio native works only with O_DIRECT
1974 if (!$drive->{aio
}) {
1976 $opts .= ",aio=native";
1978 $opts .= ",aio=threads";
1982 if (!drive_is_cdrom
($drive)) {
1984 if (defined($drive->{detect_zeroes
}) && !$drive->{detect_zeroes
}) {
1985 $detectzeroes = 'off';
1986 } elsif ($drive->{discard
}) {
1987 $detectzeroes = $drive->{discard
} eq 'on' ?
'unmap' : 'on';
1989 # This used to be our default with discard not being specified:
1990 $detectzeroes = 'on';
1992 $opts .= ",detect-zeroes=$detectzeroes" if $detectzeroes;
1995 my $pathinfo = $path ?
"file=$path," : '';
1997 return "${pathinfo}if=none,id=drive-$drive->{interface}$drive->{index}$opts";
2000 sub print_netdevice_full
{
2001 my ($vmid, $conf, $net, $netid, $bridges, $use_old_bios_files, $arch, $machine_type) = @_;
2003 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
2005 my $device = $net->{model
};
2006 if ($net->{model
} eq 'virtio') {
2007 $device = 'virtio-net-pci';
2010 my $pciaddr = print_pci_addr
("$netid", $bridges, $arch, $machine_type);
2011 my $tmpstr = "$device,mac=$net->{macaddr},netdev=$netid$pciaddr,id=$netid";
2012 if ($net->{queues
} && $net->{queues
} > 1 && $net->{model
} eq 'virtio'){
2013 #Consider we have N queues, the number of vectors needed is 2*N + 2 (plus one config interrupt and control vq)
2014 my $vectors = $net->{queues
} * 2 + 2;
2015 $tmpstr .= ",vectors=$vectors,mq=on";
2017 $tmpstr .= ",bootindex=$net->{bootindex}" if $net->{bootindex
} ;
2019 if ($use_old_bios_files) {
2021 if ($device eq 'virtio-net-pci') {
2022 $romfile = 'pxe-virtio.rom';
2023 } elsif ($device eq 'e1000') {
2024 $romfile = 'pxe-e1000.rom';
2025 } elsif ($device eq 'ne2k') {
2026 $romfile = 'pxe-ne2k_pci.rom';
2027 } elsif ($device eq 'pcnet') {
2028 $romfile = 'pxe-pcnet.rom';
2029 } elsif ($device eq 'rtl8139') {
2030 $romfile = 'pxe-rtl8139.rom';
2032 $tmpstr .= ",romfile=$romfile" if $romfile;
2038 sub print_netdev_full
{
2039 my ($vmid, $conf, $arch, $net, $netid, $hotplug) = @_;
2042 if ($netid =~ m/^net(\d+)$/) {
2046 die "got strange net id '$i'\n" if $i >= ${MAX_NETS
};
2048 my $ifname = "tap${vmid}i$i";
2050 # kvm uses TUNSETIFF ioctl, and that limits ifname length
2051 die "interface name '$ifname' is too long (max 15 character)\n"
2052 if length($ifname) >= 16;
2054 my $vhostparam = '';
2055 if (is_native
($arch)) {
2056 $vhostparam = ',vhost=on' if kernel_has_vhost_net
() && $net->{model
} eq 'virtio';
2059 my $vmname = $conf->{name
} || "vm$vmid";
2062 my $script = $hotplug ?
"pve-bridge-hotplug" : "pve-bridge";
2064 if ($net->{bridge
}) {
2065 $netdev = "type=tap,id=$netid,ifname=${ifname},script=/var/lib/qemu-server/$script,downscript=/var/lib/qemu-server/pve-bridgedown$vhostparam";
2067 $netdev = "type=user,id=$netid,hostname=$vmname";
2070 $netdev .= ",queues=$net->{queues}" if ($net->{queues
} && $net->{model
} eq 'virtio');
2076 sub print_cpu_device
{
2077 my ($conf, $id) = @_;
2079 my $kvm = $conf->{kvm
} // 1;
2080 my $cpu = $kvm ?
"kvm64" : "qemu64";
2081 if (my $cputype = $conf->{cpu
}) {
2082 my $cpuconf = PVE
::JSONSchema
::parse_property_string
($cpu_fmt, $cputype)
2083 or die "Cannot parse cpu description: $cputype\n";
2084 $cpu = $cpuconf->{cputype
};
2087 my $cores = $conf->{cores
} || 1;
2089 my $current_core = ($id - 1) % $cores;
2090 my $current_socket = int(($id - 1 - $current_core)/$cores);
2092 return "$cpu-x86_64-cpu,id=cpu$id,socket-id=$current_socket,core-id=$current_core,thread-id=0";
2096 'cirrus' => 'cirrus-vga',
2098 'vmware' => 'vmware-svga',
2099 'virtio' => 'virtio-vga',
2102 sub print_vga_device
{
2103 my ($conf, $vga, $arch, $machine, $id, $qxlnum, $bridges) = @_;
2105 my $type = $vga_map->{$vga->{type
}};
2106 if ($arch eq 'aarch64' && defined($type) && $type eq 'virtio-vga') {
2107 $type = 'virtio-gpu';
2109 my $vgamem_mb = $vga->{memory
};
2111 $type = $id ?
'qxl' : 'qxl-vga';
2113 die "no devicetype for $vga->{type}\n" if !$type;
2117 if ($vga->{type
} eq 'virtio') {
2118 my $bytes = PVE
::Tools
::convert_size
($vgamem_mb, "mb" => "b");
2119 $memory = ",max_hostmem=$bytes";
2121 # from https://www.spice-space.org/multiple-monitors.html
2122 $memory = ",vgamem_mb=$vga->{memory}";
2123 my $ram = $vgamem_mb * 4;
2124 my $vram = $vgamem_mb * 2;
2125 $memory .= ",ram_size_mb=$ram,vram_size_mb=$vram";
2127 $memory = ",vgamem_mb=$vga->{memory}";
2129 } elsif ($qxlnum && $id) {
2130 $memory = ",ram_size=67108864,vram_size=33554432";
2133 my $q35 = machine_type_is_q35
($conf);
2134 my $vgaid = "vga" . ($id // '');
2137 if ($q35 && $vgaid eq 'vga') {
2138 # the first display uses pcie.0 bus on q35 machines
2139 $pciaddr = print_pcie_addr
($vgaid, $bridges, $arch, $machine);
2141 $pciaddr = print_pci_addr
($vgaid, $bridges, $arch, $machine);
2144 return "$type,id=${vgaid}${memory}${pciaddr}";
2147 sub drive_is_cloudinit
{
2149 return $drive->{file
} =~ m
@[:/]vm-\d
+-cloudinit
(?
:\
.$QEMU_FORMAT_RE)?
$@;
2152 sub drive_is_cdrom
{
2153 my ($drive, $exclude_cloudinit) = @_;
2155 return 0 if $exclude_cloudinit && drive_is_cloudinit
($drive);
2157 return $drive && $drive->{media
} && ($drive->{media
} eq 'cdrom');
2161 sub parse_number_sets
{
2164 foreach my $part (split(/;/, $set)) {
2165 if ($part =~ /^\s*(\d+)(?:-(\d+))?\s*$/) {
2166 die "invalid range: $part ($2 < $1)\n" if defined($2) && $2 < $1;
2167 push @$res, [ $1, $2 ];
2169 die "invalid range: $part\n";
2178 my $res = PVE
::JSONSchema
::parse_property_string
($numa_fmt, $data);
2179 $res->{cpus
} = parse_number_sets
($res->{cpus
}) if defined($res->{cpus
});
2180 $res->{hostnodes
} = parse_number_sets
($res->{hostnodes
}) if defined($res->{hostnodes
});
2187 return undef if !$value;
2189 my $res = PVE
::JSONSchema
::parse_property_string
($hostpci_fmt, $value);
2191 my @idlist = split(/;/, $res->{host
});
2192 delete $res->{host
};
2193 foreach my $id (@idlist) {
2194 if ($id =~ m/\./) { # full id 00:00.1
2195 push @{$res->{pciid
}}, {
2198 } else { # partial id 00:00
2199 $res->{pciid
} = PVE
::SysFSTools
::lspci
($id);
2205 # netX: e1000=XX:XX:XX:XX:XX:XX,bridge=vmbr0,rate=<mbps>
2209 my $res = eval { PVE
::JSONSchema
::parse_property_string
($net_fmt, $data) };
2214 if (!defined($res->{macaddr
})) {
2215 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
2216 $res->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
});
2221 # ipconfigX ip=cidr,gw=ip,ip6=cidr,gw6=ip
2222 sub parse_ipconfig
{
2225 my $res = eval { PVE
::JSONSchema
::parse_property_string
($ipconfig_fmt, $data) };
2231 if ($res->{gw
} && !$res->{ip
}) {
2232 warn 'gateway specified without specifying an IP address';
2235 if ($res->{gw6
} && !$res->{ip6
}) {
2236 warn 'IPv6 gateway specified without specifying an IPv6 address';
2239 if ($res->{gw
} && $res->{ip
} eq 'dhcp') {
2240 warn 'gateway specified together with DHCP';
2243 if ($res->{gw6
} && $res->{ip6
} !~ /^$IPV6RE/) {
2245 warn "IPv6 gateway specified together with $res->{ip6} address";
2249 if (!$res->{ip
} && !$res->{ip6
}) {
2250 return { ip
=> 'dhcp', ip6
=> 'dhcp' };
2259 return PVE
::JSONSchema
::print_property_string
($net, $net_fmt);
2262 sub add_random_macs
{
2263 my ($settings) = @_;
2265 foreach my $opt (keys %$settings) {
2266 next if $opt !~ m/^net(\d+)$/;
2267 my $net = parse_net
($settings->{$opt});
2269 $settings->{$opt} = print_net
($net);
2273 sub vm_is_volid_owner
{
2274 my ($storecfg, $vmid, $volid) = @_;
2276 if ($volid !~ m
|^/|) {
2278 eval { ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid); };
2279 if ($owner && ($owner == $vmid)) {
2287 sub split_flagged_list
{
2288 my $text = shift || '';
2289 $text =~ s/[,;]/ /g;
2291 return { map { /^(!?)(.*)$/ && ($2, $1) } ($text =~ /\S+/g) };
2294 sub join_flagged_list
{
2295 my ($how, $lst) = @_;
2296 join $how, map { $lst->{$_} . $_ } keys %$lst;
2299 sub vmconfig_delete_pending_option
{
2300 my ($conf, $key, $force) = @_;
2302 delete $conf->{pending
}->{$key};
2303 my $pending_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2304 $pending_delete_hash->{$key} = $force ?
'!' : '';
2305 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2308 sub vmconfig_undelete_pending_option
{
2309 my ($conf, $key) = @_;
2311 my $pending_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2312 delete $pending_delete_hash->{$key};
2314 if (%$pending_delete_hash) {
2315 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2317 delete $conf->{pending
}->{delete};
2321 sub vmconfig_register_unused_drive
{
2322 my ($storecfg, $vmid, $conf, $drive) = @_;
2324 if (drive_is_cloudinit
($drive)) {
2325 eval { PVE
::Storage
::vdisk_free
($storecfg, $drive->{file
}) };
2327 } elsif (!drive_is_cdrom
($drive)) {
2328 my $volid = $drive->{file
};
2329 if (vm_is_volid_owner
($storecfg, $vmid, $volid)) {
2330 PVE
::QemuConfig-
>add_unused_volume($conf, $volid, $vmid);
2335 sub vmconfig_cleanup_pending
{
2338 # remove pending changes when nothing changed
2340 foreach my $opt (keys %{$conf->{pending
}}) {
2341 if (defined($conf->{$opt}) && ($conf->{pending
}->{$opt} eq $conf->{$opt})) {
2343 delete $conf->{pending
}->{$opt};
2347 my $current_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2348 my $pending_delete_hash = {};
2349 while (my ($opt, $force) = each %$current_delete_hash) {
2350 if (defined($conf->{$opt})) {
2351 $pending_delete_hash->{$opt} = $force;
2357 if (%$pending_delete_hash) {
2358 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2360 delete $conf->{pending
}->{delete};
2366 # smbios: [manufacturer=str][,product=str][,version=str][,serial=str][,uuid=uuid][,sku=str][,family=str]
2370 pattern
=> '[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}',
2371 format_description
=> 'UUID',
2372 description
=> "Set SMBIOS1 UUID.",
2378 format_description
=> 'string',
2379 description
=> "Set SMBIOS1 version.",
2385 format_description
=> 'string',
2386 description
=> "Set SMBIOS1 serial number.",
2392 format_description
=> 'string',
2393 description
=> "Set SMBIOS1 manufacturer.",
2399 format_description
=> 'string',
2400 description
=> "Set SMBIOS1 product ID.",
2406 format_description
=> 'string',
2407 description
=> "Set SMBIOS1 SKU string.",
2413 format_description
=> 'string',
2414 description
=> "Set SMBIOS1 family string.",
2422 my $res = eval { PVE
::JSONSchema
::parse_property_string
($smbios1_fmt, $data) };
2429 return PVE
::JSONSchema
::print_property_string
($smbios1, $smbios1_fmt);
2432 PVE
::JSONSchema
::register_format
('pve-qm-smbios1', $smbios1_fmt);
2434 PVE
::JSONSchema
::register_format
('pve-qm-bootdisk', \
&verify_bootdisk
);
2435 sub verify_bootdisk
{
2436 my ($value, $noerr) = @_;
2438 return $value if is_valid_drivename
($value);
2440 return undef if $noerr;
2442 die "invalid boot disk '$value'\n";
2445 sub parse_watchdog
{
2448 return undef if !$value;
2450 my $res = eval { PVE
::JSONSchema
::parse_property_string
($watchdog_fmt, $value) };
2455 sub parse_guest_agent
{
2458 return {} if !defined($value->{agent
});
2460 my $res = eval { PVE
::JSONSchema
::parse_property_string
($agent_fmt, $value->{agent
}) };
2463 # if the agent is disabled ignore the other potentially set properties
2464 return {} if !$res->{enabled
};
2471 return {} if !$value;
2472 my $res = eval { PVE
::JSONSchema
::parse_property_string
($vga_fmt, $value) };
2477 PVE
::JSONSchema
::register_format
('pve-qm-usb-device', \
&verify_usb_device
);
2478 sub verify_usb_device
{
2479 my ($value, $noerr) = @_;
2481 return $value if parse_usb_device
($value);
2483 return undef if $noerr;
2485 die "unable to parse usb device\n";
2488 # add JSON properties for create and set function
2489 sub json_config_properties
{
2492 foreach my $opt (keys %$confdesc) {
2493 next if $opt eq 'parent' || $opt eq 'snaptime' || $opt eq 'vmstate' || $opt eq 'runningmachine';
2494 $prop->{$opt} = $confdesc->{$opt};
2500 # return copy of $confdesc_cloudinit to generate documentation
2501 sub cloudinit_config_properties
{
2503 return dclone
($confdesc_cloudinit);
2507 my ($key, $value) = @_;
2509 die "unknown setting '$key'\n" if !$confdesc->{$key};
2511 my $type = $confdesc->{$key}->{type
};
2513 if (!defined($value)) {
2514 die "got undefined value\n";
2517 if ($value =~ m/[\n\r]/) {
2518 die "property contains a line feed\n";
2521 if ($type eq 'boolean') {
2522 return 1 if ($value eq '1') || ($value =~ m/^(on|yes|true)$/i);
2523 return 0 if ($value eq '0') || ($value =~ m/^(off|no|false)$/i);
2524 die "type check ('boolean') failed - got '$value'\n";
2525 } elsif ($type eq 'integer') {
2526 return int($1) if $value =~ m/^(\d+)$/;
2527 die "type check ('integer') failed - got '$value'\n";
2528 } elsif ($type eq 'number') {
2529 return $value if $value =~ m/^(\d+)(\.\d+)?$/;
2530 die "type check ('number') failed - got '$value'\n";
2531 } elsif ($type eq 'string') {
2532 if (my $fmt = $confdesc->{$key}->{format
}) {
2533 PVE
::JSONSchema
::check_format
($fmt, $value);
2536 $value =~ s/^\"(.*)\"$/$1/;
2539 die "internal error"
2546 my $conf = PVE
::QemuConfig-
>config_file($vmid);
2547 utime undef, undef, $conf;
2551 my ($storecfg, $vmid, $keep_empty_config, $skiplock) = @_;
2553 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
2555 my $conf = PVE
::QemuConfig-
>load_config($vmid);
2557 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
2559 if ($conf->{template
}) {
2560 # check if any base image is still used by a linked clone
2561 foreach_drive
($conf, sub {
2562 my ($ds, $drive) = @_;
2564 return if drive_is_cdrom
($drive);
2566 my $volid = $drive->{file
};
2568 return if !$volid || $volid =~ m
|^/|;
2570 die "base volume '$volid' is still in use by linked cloned\n"
2571 if PVE
::Storage
::volume_is_base_and_used
($storecfg, $volid);
2576 # only remove disks owned by this VM
2577 foreach_drive
($conf, sub {
2578 my ($ds, $drive) = @_;
2580 return if drive_is_cdrom
($drive, 1);
2582 my $volid = $drive->{file
};
2584 return if !$volid || $volid =~ m
|^/|;
2586 my ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid);
2587 return if !$path || !$owner || ($owner != $vmid);
2590 PVE
::Storage
::vdisk_free
($storecfg, $volid);
2592 warn "Could not remove disk '$volid', check manually: $@" if $@;
2596 if ($keep_empty_config) {
2597 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
2602 # also remove unused disk
2604 my $dl = PVE
::Storage
::vdisk_list
($storecfg, undef, $vmid);
2607 PVE
::Storage
::foreach_volid
($dl, sub {
2608 my ($volid, $sid, $volname, $d) = @_;
2609 PVE
::Storage
::vdisk_free
($storecfg, $volid);
2618 sub parse_vm_config
{
2619 my ($filename, $raw) = @_;
2621 return undef if !defined($raw);
2624 digest
=> Digest
::SHA
::sha1_hex
($raw),
2629 $filename =~ m
|/qemu-server/(\d
+)\
.conf
$|
2630 || die "got strange filename '$filename'";
2638 my @lines = split(/\n/, $raw);
2639 foreach my $line (@lines) {
2640 next if $line =~ m/^\s*$/;
2642 if ($line =~ m/^\[PENDING\]\s*$/i) {
2643 $section = 'pending';
2644 if (defined($descr)) {
2646 $conf->{description
} = $descr;
2649 $conf = $res->{$section} = {};
2652 } elsif ($line =~ m/^\[([a-z][a-z0-9_\-]+)\]\s*$/i) {
2654 if (defined($descr)) {
2656 $conf->{description
} = $descr;
2659 $conf = $res->{snapshots
}->{$section} = {};
2663 if ($line =~ m/^\#(.*)\s*$/) {
2664 $descr = '' if !defined($descr);
2665 $descr .= PVE
::Tools
::decode_text
($1) . "\n";
2669 if ($line =~ m/^(description):\s*(.*\S)\s*$/) {
2670 $descr = '' if !defined($descr);
2671 $descr .= PVE
::Tools
::decode_text
($2);
2672 } elsif ($line =~ m/snapstate:\s*(prepare|delete)\s*$/) {
2673 $conf->{snapstate
} = $1;
2674 } elsif ($line =~ m/^(args):\s*(.*\S)\s*$/) {
2677 $conf->{$key} = $value;
2678 } elsif ($line =~ m/^delete:\s*(.*\S)\s*$/) {
2680 if ($section eq 'pending') {
2681 $conf->{delete} = $value; # we parse this later
2683 warn "vm $vmid - propertry 'delete' is only allowed in [PENDING]\n";
2685 } elsif ($line =~ m/^([a-z][a-z_]*\d*):\s*(.+?)\s*$/) {
2688 eval { $value = check_type
($key, $value); };
2690 warn "vm $vmid - unable to parse value of '$key' - $@";
2692 $key = 'ide2' if $key eq 'cdrom';
2693 my $fmt = $confdesc->{$key}->{format
};
2694 if ($fmt && $fmt =~ /^pve-qm-(?:ide|scsi|virtio|sata)$/) {
2695 my $v = parse_drive
($key, $value);
2696 if (my $volid = filename_to_volume_id
($vmid, $v->{file
}, $v->{media
})) {
2697 $v->{file
} = $volid;
2698 $value = print_drive
($vmid, $v);
2700 warn "vm $vmid - unable to parse value of '$key'\n";
2705 $conf->{$key} = $value;
2710 if (defined($descr)) {
2712 $conf->{description
} = $descr;
2714 delete $res->{snapstate
}; # just to be sure
2719 sub write_vm_config
{
2720 my ($filename, $conf) = @_;
2722 delete $conf->{snapstate
}; # just to be sure
2724 if ($conf->{cdrom
}) {
2725 die "option ide2 conflicts with cdrom\n" if $conf->{ide2
};
2726 $conf->{ide2
} = $conf->{cdrom
};
2727 delete $conf->{cdrom
};
2730 # we do not use 'smp' any longer
2731 if ($conf->{sockets
}) {
2732 delete $conf->{smp
};
2733 } elsif ($conf->{smp
}) {
2734 $conf->{sockets
} = $conf->{smp
};
2735 delete $conf->{cores
};
2736 delete $conf->{smp
};
2739 my $used_volids = {};
2741 my $cleanup_config = sub {
2742 my ($cref, $pending, $snapname) = @_;
2744 foreach my $key (keys %$cref) {
2745 next if $key eq 'digest' || $key eq 'description' || $key eq 'snapshots' ||
2746 $key eq 'snapstate' || $key eq 'pending';
2747 my $value = $cref->{$key};
2748 if ($key eq 'delete') {
2749 die "propertry 'delete' is only allowed in [PENDING]\n"
2751 # fixme: check syntax?
2754 eval { $value = check_type
($key, $value); };
2755 die "unable to parse value of '$key' - $@" if $@;
2757 $cref->{$key} = $value;
2759 if (!$snapname && is_valid_drivename
($key)) {
2760 my $drive = parse_drive
($key, $value);
2761 $used_volids->{$drive->{file
}} = 1 if $drive && $drive->{file
};
2766 &$cleanup_config($conf);
2768 &$cleanup_config($conf->{pending
}, 1);
2770 foreach my $snapname (keys %{$conf->{snapshots
}}) {
2771 die "internal error" if $snapname eq 'pending';
2772 &$cleanup_config($conf->{snapshots
}->{$snapname}, undef, $snapname);
2775 # remove 'unusedX' settings if we re-add a volume
2776 foreach my $key (keys %$conf) {
2777 my $value = $conf->{$key};
2778 if ($key =~ m/^unused/ && $used_volids->{$value}) {
2779 delete $conf->{$key};
2783 my $generate_raw_config = sub {
2784 my ($conf, $pending) = @_;
2788 # add description as comment to top of file
2789 if (defined(my $descr = $conf->{description
})) {
2791 foreach my $cl (split(/\n/, $descr)) {
2792 $raw .= '#' . PVE
::Tools
::encode_text
($cl) . "\n";
2795 $raw .= "#\n" if $pending;
2799 foreach my $key (sort keys %$conf) {
2800 next if $key eq 'digest' || $key eq 'description' || $key eq 'pending' || $key eq 'snapshots';
2801 $raw .= "$key: $conf->{$key}\n";
2806 my $raw = &$generate_raw_config($conf);
2808 if (scalar(keys %{$conf->{pending
}})){
2809 $raw .= "\n[PENDING]\n";
2810 $raw .= &$generate_raw_config($conf->{pending
}, 1);
2813 foreach my $snapname (sort keys %{$conf->{snapshots
}}) {
2814 $raw .= "\n[$snapname]\n";
2815 $raw .= &$generate_raw_config($conf->{snapshots
}->{$snapname});
2825 # we use static defaults from our JSON schema configuration
2826 foreach my $key (keys %$confdesc) {
2827 if (defined(my $default = $confdesc->{$key}->{default})) {
2828 $res->{$key} = $default;
2836 my $vmlist = PVE
::Cluster
::get_vmlist
();
2838 return $res if !$vmlist || !$vmlist->{ids
};
2839 my $ids = $vmlist->{ids
};
2841 foreach my $vmid (keys %$ids) {
2842 my $d = $ids->{$vmid};
2843 next if !$d->{node
} || $d->{node
} ne $nodename;
2844 next if !$d->{type
} || $d->{type
} ne 'qemu';
2845 $res->{$vmid}->{exists} = 1;
2850 # test if VM uses local resources (to prevent migration)
2851 sub check_local_resources
{
2852 my ($conf, $noerr) = @_;
2856 $loc_res = 1 if $conf->{hostusb
}; # old syntax
2857 $loc_res = 1 if $conf->{hostpci
}; # old syntax
2859 $loc_res = 1 if $conf->{ivshmem
};
2861 foreach my $k (keys %$conf) {
2862 next if $k =~ m/^usb/ && ($conf->{$k} eq 'spice');
2863 # sockets are safe: they will recreated be on the target side post-migrate
2864 next if $k =~ m/^serial/ && ($conf->{$k} eq 'socket');
2865 $loc_res = 1 if $k =~ m/^(usb|hostpci|serial|parallel)\d+$/;
2868 die "VM uses local resources\n" if $loc_res && !$noerr;
2873 # check if used storages are available on all nodes (use by migrate)
2874 sub check_storage_availability
{
2875 my ($storecfg, $conf, $node) = @_;
2877 foreach_drive
($conf, sub {
2878 my ($ds, $drive) = @_;
2880 my $volid = $drive->{file
};
2883 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2886 # check if storage is available on both nodes
2887 my $scfg = PVE
::Storage
::storage_check_node
($storecfg, $sid);
2888 PVE
::Storage
::storage_check_node
($storecfg, $sid, $node);
2892 # list nodes where all VM images are available (used by has_feature API)
2894 my ($conf, $storecfg) = @_;
2896 my $nodelist = PVE
::Cluster
::get_nodelist
();
2897 my $nodehash = { map { $_ => 1 } @$nodelist };
2898 my $nodename = PVE
::INotify
::nodename
();
2900 foreach_drive
($conf, sub {
2901 my ($ds, $drive) = @_;
2903 my $volid = $drive->{file
};
2906 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2908 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
2909 if ($scfg->{disable
}) {
2911 } elsif (my $avail = $scfg->{nodes
}) {
2912 foreach my $node (keys %$nodehash) {
2913 delete $nodehash->{$node} if !$avail->{$node};
2915 } elsif (!$scfg->{shared
}) {
2916 foreach my $node (keys %$nodehash) {
2917 delete $nodehash->{$node} if $node ne $nodename
2927 my ($pidfile, $pid) = @_;
2929 my $fh = IO
::File-
>new("/proc/$pid/cmdline", "r");
2933 return undef if !$line;
2934 my @param = split(/\0/, $line);
2936 my $cmd = $param[0];
2937 return if !$cmd || ($cmd !~ m
|kvm
$| && $cmd !~ m
@(?
:^|/)qemu-system-[^/]+$@);
2939 for (my $i = 0; $i < scalar (@param); $i++) {
2942 if (($p eq '-pidfile') || ($p eq '--pidfile')) {
2943 my $p = $param[$i+1];
2944 return 1 if $p && ($p eq $pidfile);
2953 my ($vmid, $nocheck, $node) = @_;
2955 my $filename = PVE
::QemuConfig-
>config_file($vmid, $node);
2957 die "unable to find configuration file for VM $vmid - no such machine\n"
2958 if !$nocheck && ! -f
$filename;
2960 my $pidfile = pidfile_name
($vmid);
2962 if (my $fd = IO
::File-
>new("<$pidfile")) {
2967 my $mtime = $st->mtime;
2968 if ($mtime > time()) {
2969 warn "file '$filename' modified in future\n";
2972 if ($line =~ m/^(\d+)$/) {
2974 if (check_cmdline
($pidfile, $pid)) {
2975 if (my $pinfo = PVE
::ProcFSTools
::check_process_running
($pid)) {
2987 my $vzlist = config_list
();
2989 my $fd = IO
::Dir-
>new($var_run_tmpdir) || return $vzlist;
2991 while (defined(my $de = $fd->read)) {
2992 next if $de !~ m/^(\d+)\.pid$/;
2994 next if !defined($vzlist->{$vmid});
2995 if (my $pid = check_running
($vmid)) {
2996 $vzlist->{$vmid}->{pid
} = $pid;
3004 my ($storecfg, $conf) = @_;
3006 my $bootdisk = $conf->{bootdisk
};
3007 return undef if !$bootdisk;
3008 return undef if !is_valid_drivename
($bootdisk);
3010 return undef if !$conf->{$bootdisk};
3012 my $drive = parse_drive
($bootdisk, $conf->{$bootdisk});
3013 return undef if !defined($drive);
3015 return undef if drive_is_cdrom
($drive);
3017 my $volid = $drive->{file
};
3018 return undef if !$volid;
3020 return $drive->{size
};
3023 our $vmstatus_return_properties = {
3024 vmid
=> get_standard_option
('pve-vmid'),
3026 description
=> "Qemu process status.",
3028 enum
=> ['stopped', 'running'],
3031 description
=> "Maximum memory in bytes.",
3034 renderer
=> 'bytes',
3037 description
=> "Root disk size in bytes.",
3040 renderer
=> 'bytes',
3043 description
=> "VM name.",
3048 description
=> "Qemu QMP agent status.",
3053 description
=> "PID of running qemu process.",
3058 description
=> "Uptime.",
3061 renderer
=> 'duration',
3064 description
=> "Maximum usable CPUs.",
3070 my $last_proc_pid_stat;
3072 # get VM status information
3073 # This must be fast and should not block ($full == false)
3074 # We only query KVM using QMP if $full == true (this can be slow)
3076 my ($opt_vmid, $full) = @_;
3080 my $storecfg = PVE
::Storage
::config
();
3082 my $list = vzlist
();
3083 my $defaults = load_defaults
();
3085 my ($uptime) = PVE
::ProcFSTools
::read_proc_uptime
(1);
3087 my $cpucount = $cpuinfo->{cpus
} || 1;
3089 foreach my $vmid (keys %$list) {
3090 next if $opt_vmid && ($vmid ne $opt_vmid);
3092 my $cfspath = PVE
::QemuConfig-
>cfs_config_path($vmid);
3093 my $conf = PVE
::Cluster
::cfs_read_file
($cfspath) || {};
3095 my $d = { vmid
=> $vmid };
3096 $d->{pid
} = $list->{$vmid}->{pid
};
3098 # fixme: better status?
3099 $d->{status
} = $list->{$vmid}->{pid
} ?
'running' : 'stopped';
3101 my $size = disksize
($storecfg, $conf);
3102 if (defined($size)) {
3103 $d->{disk
} = 0; # no info available
3104 $d->{maxdisk
} = $size;
3110 $d->{cpus
} = ($conf->{sockets
} || $defaults->{sockets
})
3111 * ($conf->{cores
} || $defaults->{cores
});
3112 $d->{cpus
} = $cpucount if $d->{cpus
} > $cpucount;
3113 $d->{cpus
} = $conf->{vcpus
} if $conf->{vcpus
};
3115 $d->{name
} = $conf->{name
} || "VM $vmid";
3116 $d->{maxmem
} = $conf->{memory
} ?
$conf->{memory
}*(1024*1024)
3117 : $defaults->{memory
}*(1024*1024);
3119 if ($conf->{balloon
}) {
3120 $d->{balloon_min
} = $conf->{balloon
}*(1024*1024);
3121 $d->{shares
} = defined($conf->{shares
}) ?
$conf->{shares
}
3122 : $defaults->{shares
};
3133 $d->{diskwrite
} = 0;
3135 $d->{template
} = PVE
::QemuConfig-
>is_template($conf);
3137 $d->{serial
} = 1 if conf_has_serial
($conf);
3142 my $netdev = PVE
::ProcFSTools
::read_proc_net_dev
();
3143 foreach my $dev (keys %$netdev) {
3144 next if $dev !~ m/^tap([1-9]\d*)i/;
3146 my $d = $res->{$vmid};
3149 $d->{netout
} += $netdev->{$dev}->{receive
};
3150 $d->{netin
} += $netdev->{$dev}->{transmit
};
3153 $d->{nics
}->{$dev}->{netout
} = $netdev->{$dev}->{receive
};
3154 $d->{nics
}->{$dev}->{netin
} = $netdev->{$dev}->{transmit
};
3159 my $ctime = gettimeofday
;
3161 foreach my $vmid (keys %$list) {
3163 my $d = $res->{$vmid};
3164 my $pid = $d->{pid
};
3167 my $pstat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
3168 next if !$pstat; # not running
3170 my $used = $pstat->{utime} + $pstat->{stime
};
3172 $d->{uptime
} = int(($uptime - $pstat->{starttime
})/$cpuinfo->{user_hz
});
3174 if ($pstat->{vsize
}) {
3175 $d->{mem
} = int(($pstat->{rss
}/$pstat->{vsize
})*$d->{maxmem
});
3178 my $old = $last_proc_pid_stat->{$pid};
3180 $last_proc_pid_stat->{$pid} = {
3188 my $dtime = ($ctime - $old->{time}) * $cpucount * $cpuinfo->{user_hz
};
3190 if ($dtime > 1000) {
3191 my $dutime = $used - $old->{used
};
3193 $d->{cpu
} = (($dutime/$dtime)* $cpucount) / $d->{cpus
};
3194 $last_proc_pid_stat->{$pid} = {
3200 $d->{cpu
} = $old->{cpu
};
3204 return $res if !$full;
3206 my $qmpclient = PVE
::QMPClient-
>new();
3208 my $ballooncb = sub {
3209 my ($vmid, $resp) = @_;
3211 my $info = $resp->{'return'};
3212 return if !$info->{max_mem
};
3214 my $d = $res->{$vmid};
3216 # use memory assigned to VM
3217 $d->{maxmem
} = $info->{max_mem
};
3218 $d->{balloon
} = $info->{actual
};
3220 if (defined($info->{total_mem
}) && defined($info->{free_mem
})) {
3221 $d->{mem
} = $info->{total_mem
} - $info->{free_mem
};
3222 $d->{freemem
} = $info->{free_mem
};
3225 $d->{ballooninfo
} = $info;
3228 my $blockstatscb = sub {
3229 my ($vmid, $resp) = @_;
3230 my $data = $resp->{'return'} || [];
3231 my $totalrdbytes = 0;
3232 my $totalwrbytes = 0;
3234 for my $blockstat (@$data) {
3235 $totalrdbytes = $totalrdbytes + $blockstat->{stats
}->{rd_bytes
};
3236 $totalwrbytes = $totalwrbytes + $blockstat->{stats
}->{wr_bytes
};
3238 $blockstat->{device
} =~ s/drive-//;
3239 $res->{$vmid}->{blockstat
}->{$blockstat->{device
}} = $blockstat->{stats
};
3241 $res->{$vmid}->{diskread
} = $totalrdbytes;
3242 $res->{$vmid}->{diskwrite
} = $totalwrbytes;
3245 my $statuscb = sub {
3246 my ($vmid, $resp) = @_;
3248 $qmpclient->queue_cmd($vmid, $blockstatscb, 'query-blockstats');
3249 # this fails if ballon driver is not loaded, so this must be
3250 # the last commnand (following command are aborted if this fails).
3251 $qmpclient->queue_cmd($vmid, $ballooncb, 'query-balloon');
3253 my $status = 'unknown';
3254 if (!defined($status = $resp->{'return'}->{status
})) {
3255 warn "unable to get VM status\n";
3259 $res->{$vmid}->{qmpstatus
} = $resp->{'return'}->{status
};
3262 foreach my $vmid (keys %$list) {
3263 next if $opt_vmid && ($vmid ne $opt_vmid);
3264 next if !$res->{$vmid}->{pid
}; # not running
3265 $qmpclient->queue_cmd($vmid, $statuscb, 'query-status');
3268 $qmpclient->queue_execute(undef, 2);
3270 foreach my $vmid (keys %$list) {
3271 next if $opt_vmid && ($vmid ne $opt_vmid);
3272 $res->{$vmid}->{qmpstatus
} = $res->{$vmid}->{status
} if !$res->{$vmid}->{qmpstatus
};
3279 my ($conf, $func, @param) = @_;
3281 foreach my $ds (valid_drive_names
()) {
3282 next if !defined($conf->{$ds});
3284 my $drive = parse_drive
($ds, $conf->{$ds});
3287 &$func($ds, $drive, @param);
3292 my ($conf, $func, @param) = @_;
3296 my $test_volid = sub {
3297 my ($volid, $is_cdrom, $replicate, $shared, $snapname) = @_;
3301 $volhash->{$volid}->{cdrom
} //= 1;
3302 $volhash->{$volid}->{cdrom
} = 0 if !$is_cdrom;
3304 $volhash->{$volid}->{replicate
} //= 0;
3305 $volhash->{$volid}->{replicate
} = 1 if $replicate;
3307 $volhash->{$volid}->{shared
} //= 0;
3308 $volhash->{$volid}->{shared
} = 1 if $shared;
3310 $volhash->{$volid}->{referenced_in_config
} //= 0;
3311 $volhash->{$volid}->{referenced_in_config
} = 1 if !defined($snapname);
3313 $volhash->{$volid}->{referenced_in_snapshot
}->{$snapname} = 1
3314 if defined($snapname);
3317 foreach_drive
($conf, sub {
3318 my ($ds, $drive) = @_;
3319 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, undef);
3322 foreach my $snapname (keys %{$conf->{snapshots
}}) {
3323 my $snap = $conf->{snapshots
}->{$snapname};
3324 $test_volid->($snap->{vmstate
}, 0, 1, $snapname);
3325 foreach_drive
($snap, sub {
3326 my ($ds, $drive) = @_;
3327 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, $snapname);
3331 foreach my $volid (keys %$volhash) {
3332 &$func($volid, $volhash->{$volid}, @param);
3336 sub conf_has_serial
{
3339 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3340 if ($conf->{"serial$i"}) {
3348 sub vga_conf_has_spice
{
3351 my $vgaconf = parse_vga
($vga);
3352 my $vgatype = $vgaconf->{type
};
3353 return 0 if !$vgatype || $vgatype !~ m/^qxl([234])?$/;
3358 my $host_arch; # FIXME: fix PVE::Tools::get_host_arch
3359 sub get_host_arch
() {
3360 $host_arch = (POSIX
::uname
())[4] if !$host_arch;
3366 return get_host_arch
() eq $arch;
3369 my $default_machines = {
3374 sub get_basic_machine_info
{
3375 my ($conf, $forcemachine) = @_;
3377 my $arch = $conf->{arch
} // get_host_arch
();
3378 my $machine = $forcemachine || $conf->{machine
} || $default_machines->{$arch};
3379 return ($arch, $machine);
3382 sub get_ovmf_files
($) {
3385 my $ovmf = $OVMF->{$arch}
3386 or die "no OVMF images known for architecture '$arch'\n";
3392 aarch64
=> '/usr/bin/qemu-system-aarch64',
3393 x86_64
=> '/usr/bin/qemu-system-x86_64',
3395 sub get_command_for_arch
($) {
3397 return '/usr/bin/kvm' if is_native
($arch);
3399 my $cmd = $Arch2Qemu->{$arch}
3400 or die "don't know how to emulate architecture '$arch'\n";
3404 sub get_cpu_options
{
3405 my ($conf, $arch, $kvm, $machine_type, $kvm_off, $kvmver, $winversion, $gpu_passthrough) = @_;
3408 my $ostype = $conf->{ostype
};
3410 my $cpu = $kvm ?
"kvm64" : "qemu64";
3411 if ($arch eq 'aarch64') {
3412 $cpu = 'cortex-a57';
3415 if (my $cputype = $conf->{cpu
}) {
3416 my $cpuconf = PVE
::JSONSchema
::parse_property_string
($cpu_fmt, $cputype)
3417 or die "Cannot parse cpu description: $cputype\n";
3418 $cpu = $cpuconf->{cputype
};
3419 $kvm_off = 1 if $cpuconf->{hidden
};
3420 $hv_vendor_id = $cpuconf->{'hv-vendor-id'};
3422 if (defined(my $flags = $cpuconf->{flags
})) {
3423 push @$cpuFlags, split(";", $flags);
3427 push @$cpuFlags , '+lahf_lm' if $cpu eq 'kvm64' && $arch eq 'x86_64';
3429 push @$cpuFlags , '-x2apic'
3430 if $conf->{ostype
} && $conf->{ostype
} eq 'solaris';
3432 push @$cpuFlags, '+sep' if $cpu eq 'kvm64' || $cpu eq 'kvm32';
3434 push @$cpuFlags, '-rdtscp' if $cpu =~ m/^Opteron/;
3436 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3) && $arch eq 'x86_64') {
3438 push @$cpuFlags , '+kvm_pv_unhalt' if $kvm;
3439 push @$cpuFlags , '+kvm_pv_eoi' if $kvm;
3442 add_hyperv_enlightenments
($cpuFlags, $winversion, $machine_type, $kvmver, $conf->{bios
}, $gpu_passthrough, $hv_vendor_id) if $kvm;
3444 push @$cpuFlags, 'enforce' if $cpu ne 'host' && $kvm && $arch eq 'x86_64';
3446 push @$cpuFlags, 'kvm=off' if $kvm_off;
3448 if (my $cpu_vendor = $cpu_vendor_list->{$cpu}) {
3449 push @$cpuFlags, "vendor=${cpu_vendor}"
3450 if $cpu_vendor ne 'default';
3451 } elsif ($arch ne 'aarch64') {
3452 die "internal error"; # should not happen
3455 $cpu .= "," . join(',', @$cpuFlags) if scalar(@$cpuFlags);
3457 return ('-cpu', $cpu);
3460 sub config_to_command
{
3461 my ($storecfg, $vmid, $conf, $defaults, $forcemachine) = @_;
3464 my $globalFlags = [];
3465 my $machineFlags = [];
3470 my $kvmver = kvm_user_version
();
3471 my $vernum = 0; # unknown
3472 my $ostype = $conf->{ostype
};
3473 my $winversion = windows_version
($ostype);
3474 my $kvm = $conf->{kvm
};
3476 my ($arch, $machine_type) = get_basic_machine_info
($conf, $forcemachine);
3477 $kvm //= 1 if is_native
($arch);
3480 die "KVM virtualisation configured, but not available. Either disable in VM configuration or enable in BIOS.\n"
3481 if !defined kvm_version
();
3484 if ($kvmver =~ m/^(\d+)\.(\d+)$/) {
3485 $vernum = $1*1000000+$2*1000;
3486 } elsif ($kvmver =~ m/^(\d+)\.(\d+)\.(\d+)$/) {
3487 $vernum = $1*1000000+$2*1000+$3;
3490 die "detected old qemu-kvm binary ($kvmver)\n" if $vernum < 15000;
3492 my $have_ovz = -f
'/proc/vz/vestat';
3494 my $q35 = machine_type_is_q35
($conf);
3495 my $hotplug_features = parse_hotplug_features
(defined($conf->{hotplug
}) ?
$conf->{hotplug
} : '1');
3496 my $use_old_bios_files = undef;
3497 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
3499 my $cpuunits = defined($conf->{cpuunits
}) ?
3500 $conf->{cpuunits
} : $defaults->{cpuunits
};
3502 push @$cmd, get_command_for_arch
($arch);
3504 push @$cmd, '-id', $vmid;
3506 my $vmname = $conf->{name
} || "vm$vmid";
3508 push @$cmd, '-name', $vmname;
3512 my $qmpsocket = qmp_socket
($vmid);
3513 push @$cmd, '-chardev', "socket,id=qmp,path=$qmpsocket,server,nowait";
3514 push @$cmd, '-mon', "chardev=qmp,mode=control";
3516 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 12)) {
3517 push @$cmd, '-chardev', "socket,id=qmp-event,path=/var/run/qmeventd.sock,reconnect=5";
3518 push @$cmd, '-mon', "chardev=qmp-event,mode=control";
3521 push @$cmd, '-pidfile' , pidfile_name
($vmid);
3523 push @$cmd, '-daemonize';
3525 if ($conf->{smbios1
}) {
3526 push @$cmd, '-smbios', "type=1,$conf->{smbios1}";
3529 if ($conf->{vmgenid
}) {
3530 push @$devices, '-device', 'vmgenid,guid='.$conf->{vmgenid
};
3533 my ($ovmf_code, $ovmf_vars) = get_ovmf_files
($arch);
3534 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3535 die "uefi base image not found\n" if ! -f
$ovmf_code;
3539 if (my $efidisk = $conf->{efidisk0
}) {
3540 my $d = PVE
::JSONSchema
::parse_property_string
($efidisk_fmt, $efidisk);
3541 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($d->{file
}, 1);
3542 $format = $d->{format
};
3544 $path = PVE
::Storage
::path
($storecfg, $d->{file
});
3545 if (!defined($format)) {
3546 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
3547 $format = qemu_img_format
($scfg, $volname);
3551 die "efidisk format must be specified\n"
3552 if !defined($format);
3555 warn "no efidisk configured! Using temporary efivars disk.\n";
3556 $path = "/tmp/$vmid-ovmf.fd";
3557 PVE
::Tools
::file_copy
($ovmf_vars, $path, -s
$ovmf_vars);
3561 push @$cmd, '-drive', "if=pflash,unit=0,format=raw,readonly,file=$ovmf_code";
3562 push @$cmd, '-drive', "if=pflash,unit=1,format=$format,id=drive-efidisk0,file=$path";
3566 # add usb controllers
3567 my @usbcontrollers = PVE
::QemuServer
::USB
::get_usb_controllers
($conf, $bridges, $arch, $machine_type, $usbdesc->{format
}, $MAX_USB_DEVICES);
3568 push @$devices, @usbcontrollers if @usbcontrollers;
3569 my $vga = parse_vga
($conf->{vga
});
3571 my $qxlnum = vga_conf_has_spice
($conf->{vga
});
3572 $vga->{type
} = 'qxl' if $qxlnum;
3574 if (!$vga->{type
}) {
3575 if ($arch eq 'aarch64') {
3576 $vga->{type
} = 'virtio';
3577 } elsif (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 9)) {
3578 $vga->{type
} = (!$winversion || $winversion >= 6) ?
'std' : 'cirrus';
3580 $vga->{type
} = ($winversion >= 6) ?
'std' : 'cirrus';
3584 # enable absolute mouse coordinates (needed by vnc)
3586 if (defined($conf->{tablet
})) {
3587 $tablet = $conf->{tablet
};
3589 $tablet = $defaults->{tablet
};
3590 $tablet = 0 if $qxlnum; # disable for spice because it is not needed
3591 $tablet = 0 if $vga->{type
} =~ m/^serial\d+$/; # disable if we use serial terminal (no vga card)
3595 push @$devices, '-device', print_tabletdevice_full
($conf, $arch) if $tablet;
3596 my $kbd = print_keyboarddevice_full
($conf, $arch);
3597 push @$devices, '-device', $kbd if defined($kbd);
3601 my $gpu_passthrough;
3604 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
3605 my $d = parse_hostpci
($conf->{"hostpci$i"});
3608 my $pcie = $d->{pcie
};
3610 die "q35 machine model is not enabled" if !$q35;
3611 # win7 wants to have the pcie devices directly on the pcie bus
3612 # instead of in the root port
3613 if ($winversion == 7) {
3614 $pciaddr = print_pcie_addr
("hostpci${i}bus0");
3616 $pciaddr = print_pcie_addr
("hostpci$i");
3619 $pciaddr = print_pci_addr
("hostpci$i", $bridges, $arch, $machine_type);
3622 my $rombar = defined($d->{rombar
}) && !$d->{rombar
} ?
',rombar=0' : '';
3623 my $romfile = $d->{romfile
};
3626 if ($d->{'x-vga'}) {
3627 $xvga = ',x-vga=on';
3629 $vga->{type
} = 'none' if !defined($conf->{vga
});
3630 $gpu_passthrough = 1;
3632 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3636 my $pcidevices = $d->{pciid
};
3637 my $multifunction = 1 if @$pcidevices > 1;
3639 if ($d->{mdev
} && scalar(@$pcidevices) == 1) {
3640 my $id = $pcidevices->[0]->{id
};
3641 my $uuid = PVE
::SysFSTools
::generate_mdev_uuid
($vmid, $i);
3642 $sysfspath = "/sys/bus/pci/devices/0000:$id/$uuid";
3643 } elsif ($d->{mdev
}) {
3644 warn "ignoring mediated device with multifunction device\n";
3648 foreach my $pcidevice (@$pcidevices) {
3650 my $id = "hostpci$i";
3651 $id .= ".$j" if $multifunction;
3652 my $addr = $pciaddr;
3653 $addr .= ".$j" if $multifunction;
3654 my $devicestr = "vfio-pci";
3656 $devicestr .= ",sysfsdev=$sysfspath";
3658 $devicestr .= ",host=$pcidevice->{id}";
3660 $devicestr .= ",id=$id$addr";
3663 $devicestr .= "$rombar$xvga";
3664 $devicestr .= ",multifunction=on" if $multifunction;
3665 $devicestr .= ",romfile=/usr/share/kvm/$romfile" if $romfile;
3668 push @$devices, '-device', $devicestr;
3674 my @usbdevices = PVE
::QemuServer
::USB
::get_usb_devices
($conf, $usbdesc->{format
}, $MAX_USB_DEVICES);
3675 push @$devices, @usbdevices if @usbdevices;
3677 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3678 if (my $path = $conf->{"serial$i"}) {
3679 if ($path eq 'socket') {
3680 my $socket = "/var/run/qemu-server/${vmid}.serial$i";
3681 push @$devices, '-chardev', "socket,id=serial$i,path=$socket,server,nowait";
3682 # On aarch64, serial0 is the UART device. Qemu only allows
3683 # connecting UART devices via the '-serial' command line, as
3684 # the device has a fixed slot on the hardware...
3685 if ($arch eq 'aarch64' && $i == 0) {
3686 push @$devices, '-serial', "chardev:serial$i";
3688 push @$devices, '-device', "isa-serial,chardev=serial$i";
3691 die "no such serial device\n" if ! -c
$path;
3692 push @$devices, '-chardev', "tty,id=serial$i,path=$path";
3693 push @$devices, '-device', "isa-serial,chardev=serial$i";
3699 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
3700 if (my $path = $conf->{"parallel$i"}) {
3701 die "no such parallel device\n" if ! -c
$path;
3702 my $devtype = $path =~ m!^/dev/usb/lp! ?
'tty' : 'parport';
3703 push @$devices, '-chardev', "$devtype,id=parallel$i,path=$path";
3704 push @$devices, '-device', "isa-parallel,chardev=parallel$i";
3710 $sockets = $conf->{smp
} if $conf->{smp
}; # old style - no longer iused
3711 $sockets = $conf->{sockets
} if $conf->{sockets
};
3713 my $cores = $conf->{cores
} || 1;
3715 my $maxcpus = $sockets * $cores;
3717 my $vcpus = $conf->{vcpus
} ?
$conf->{vcpus
} : $maxcpus;
3719 my $allowed_vcpus = $cpuinfo->{cpus
};
3721 die "MAX $allowed_vcpus vcpus allowed per VM on this node\n"
3722 if ($allowed_vcpus < $maxcpus);
3724 if($hotplug_features->{cpu
} && qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 7)) {
3726 push @$cmd, '-smp', "1,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3727 for (my $i = 2; $i <= $vcpus; $i++) {
3728 my $cpustr = print_cpu_device
($conf,$i);
3729 push @$cmd, '-device', $cpustr;
3734 push @$cmd, '-smp', "$vcpus,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3736 push @$cmd, '-nodefaults';
3738 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
3740 my $bootindex_hash = {};
3742 foreach my $o (split(//, $bootorder)) {
3743 $bootindex_hash->{$o} = $i*100;
3747 push @$cmd, '-boot', "menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg";
3749 push @$cmd, '-no-acpi' if defined($conf->{acpi
}) && $conf->{acpi
} == 0;
3751 push @$cmd, '-no-reboot' if defined($conf->{reboot
}) && $conf->{reboot
} == 0;
3753 if ($vga->{type
} && $vga->{type
} !~ m/^serial\d+$/ && $vga->{type
} ne 'none'){
3754 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_type, undef, $qxlnum, $bridges);
3755 my $socket = vnc_socket
($vmid);
3756 push @$cmd, '-vnc', "unix:$socket,x509,password";
3758 push @$cmd, '-vga', 'none' if $vga->{type
} eq 'none';
3759 push @$cmd, '-nographic';
3763 my $tdf = defined($conf->{tdf
}) ?
$conf->{tdf
} : $defaults->{tdf
};
3765 my $useLocaltime = $conf->{localtime};
3767 if ($winversion >= 5) { # windows
3768 $useLocaltime = 1 if !defined($conf->{localtime});
3770 # use time drift fix when acpi is enabled
3771 if (!(defined($conf->{acpi
}) && $conf->{acpi
} == 0)) {
3772 $tdf = 1 if !defined($conf->{tdf
});
3776 if ($winversion >= 6) {
3777 push @$globalFlags, 'kvm-pit.lost_tick_policy=discard';
3778 push @$cmd, '-no-hpet';
3781 push @$rtcFlags, 'driftfix=slew' if $tdf;
3784 push @$machineFlags, 'accel=tcg';
3787 if ($machine_type) {
3788 push @$machineFlags, "type=${machine_type}";
3791 if ($conf->{startdate
}) {
3792 push @$rtcFlags, "base=$conf->{startdate}";
3793 } elsif ($useLocaltime) {
3794 push @$rtcFlags, 'base=localtime';
3797 push @$cmd, get_cpu_options
($conf, $arch, $kvm, $machine_type, $kvm_off, $kvmver, $winversion, $gpu_passthrough);
3799 PVE
::QemuServer
::Memory
::config
($conf, $vmid, $sockets, $cores, $defaults, $hotplug_features, $cmd);
3801 push @$cmd, '-S' if $conf->{freeze
};
3803 push @$cmd, '-k', $conf->{keyboard
} if defined($conf->{keyboard
});
3806 #my $soundhw = $conf->{soundhw} || $defaults->{soundhw};
3807 #push @$cmd, '-soundhw', 'es1370';
3808 #push @$cmd, '-soundhw', $soundhw if $soundhw;
3810 if (parse_guest_agent
($conf)->{enabled
}) {
3811 my $qgasocket = qmp_socket
($vmid, 1);
3812 my $pciaddr = print_pci_addr
("qga0", $bridges, $arch, $machine_type);
3813 push @$devices, '-chardev', "socket,path=$qgasocket,server,nowait,id=qga0";
3814 push @$devices, '-device', "virtio-serial,id=qga0$pciaddr";
3815 push @$devices, '-device', 'virtserialport,chardev=qga0,name=org.qemu.guest_agent.0';
3823 for(my $i = 1; $i < $qxlnum; $i++){
3824 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_type, $i, $qxlnum, $bridges);
3827 # assume other OS works like Linux
3828 my ($ram, $vram) = ("134217728", "67108864");
3829 if ($vga->{memory
}) {
3830 $ram = PVE
::Tools
::convert_size
($qxlnum*4*$vga->{memory
}, 'mb' => 'b');
3831 $vram = PVE
::Tools
::convert_size
($qxlnum*2*$vga->{memory
}, 'mb' => 'b');
3833 push @$cmd, '-global', "qxl-vga.ram_size=$ram";
3834 push @$cmd, '-global', "qxl-vga.vram_size=$vram";
3838 my $pciaddr = print_pci_addr
("spice", $bridges, $arch, $machine_type);
3840 my $nodename = PVE
::INotify
::nodename
();
3841 my $pfamily = PVE
::Tools
::get_host_address_family
($nodename);
3842 my @nodeaddrs = PVE
::Tools
::getaddrinfo_all
('localhost', family
=> $pfamily);
3843 die "failed to get an ip address of type $pfamily for 'localhost'\n" if !@nodeaddrs;
3844 my $localhost = PVE
::Network
::addr_to_ip
($nodeaddrs[0]->{addr
});
3845 $spice_port = PVE
::Tools
::next_spice_port
($pfamily, $localhost);
3847 push @$devices, '-spice', "tls-port=${spice_port},addr=$localhost,tls-ciphers=HIGH,seamless-migration=on";
3849 push @$devices, '-device', "virtio-serial,id=spice$pciaddr";
3850 push @$devices, '-chardev', "spicevmc,id=vdagent,name=vdagent";
3851 push @$devices, '-device', "virtserialport,chardev=vdagent,name=com.redhat.spice.0";
3854 # enable balloon by default, unless explicitly disabled
3855 if (!defined($conf->{balloon
}) || $conf->{balloon
}) {
3856 $pciaddr = print_pci_addr
("balloon0", $bridges, $arch, $machine_type);
3857 push @$devices, '-device', "virtio-balloon-pci,id=balloon0$pciaddr";
3860 if ($conf->{watchdog
}) {
3861 my $wdopts = parse_watchdog
($conf->{watchdog
});
3862 $pciaddr = print_pci_addr
("watchdog", $bridges, $arch, $machine_type);
3863 my $watchdog = $wdopts->{model
} || 'i6300esb';
3864 push @$devices, '-device', "$watchdog$pciaddr";
3865 push @$devices, '-watchdog-action', $wdopts->{action
} if $wdopts->{action
};
3869 my $scsicontroller = {};
3870 my $ahcicontroller = {};
3871 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : $defaults->{scsihw
};
3873 # Add iscsi initiator name if available
3874 if (my $initiator = get_initiator_name
()) {
3875 push @$devices, '-iscsi', "initiator-name=$initiator";
3878 foreach_drive
($conf, sub {
3879 my ($ds, $drive) = @_;
3881 if (PVE
::Storage
::parse_volume_id
($drive->{file
}, 1)) {
3882 push @$vollist, $drive->{file
};
3885 # ignore efidisk here, already added in bios/fw handling code above
3886 return if $drive->{interface
} eq 'efidisk';
3888 $use_virtio = 1 if $ds =~ m/^virtio/;
3890 if (drive_is_cdrom
($drive)) {
3891 if ($bootindex_hash->{d
}) {
3892 $drive->{bootindex
} = $bootindex_hash->{d
};
3893 $bootindex_hash->{d
} += 1;
3896 if ($bootindex_hash->{c
}) {
3897 $drive->{bootindex
} = $bootindex_hash->{c
} if $conf->{bootdisk
} && ($conf->{bootdisk
} eq $ds);
3898 $bootindex_hash->{c
} += 1;
3902 if($drive->{interface
} eq 'virtio'){
3903 push @$cmd, '-object', "iothread,id=iothread-$ds" if $drive->{iothread
};
3906 if ($drive->{interface
} eq 'scsi') {
3908 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
3910 $pciaddr = print_pci_addr
("$controller_prefix$controller", $bridges, $arch, $machine_type);
3911 my $scsihw_type = $scsihw =~ m/^virtio-scsi-single/ ?
"virtio-scsi-pci" : $scsihw;
3914 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{iothread
}){
3915 $iothread .= ",iothread=iothread-$controller_prefix$controller";
3916 push @$cmd, '-object', "iothread,id=iothread-$controller_prefix$controller";
3917 } elsif ($drive->{iothread
}) {
3918 warn "iothread is only valid with virtio disk or virtio-scsi-single controller, ignoring\n";
3922 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{queues
}){
3923 $queues = ",num_queues=$drive->{queues}";
3926 push @$devices, '-device', "$scsihw_type,id=$controller_prefix$controller$pciaddr$iothread$queues" if !$scsicontroller->{$controller};
3927 $scsicontroller->{$controller}=1;
3930 if ($drive->{interface
} eq 'sata') {
3931 my $controller = int($drive->{index} / $MAX_SATA_DISKS);
3932 $pciaddr = print_pci_addr
("ahci$controller", $bridges, $arch, $machine_type);
3933 push @$devices, '-device', "ahci,id=ahci$controller,multifunction=on$pciaddr" if !$ahcicontroller->{$controller};
3934 $ahcicontroller->{$controller}=1;
3937 my $drive_cmd = print_drive_full
($storecfg, $vmid, $drive);
3938 push @$devices, '-drive',$drive_cmd;
3939 push @$devices, '-device', print_drivedevice_full
($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type);
3942 for (my $i = 0; $i < $MAX_NETS; $i++) {
3943 next if !$conf->{"net$i"};
3944 my $d = parse_net
($conf->{"net$i"});
3947 $use_virtio = 1 if $d->{model
} eq 'virtio';
3949 if ($bootindex_hash->{n
}) {
3950 $d->{bootindex
} = $bootindex_hash->{n
};
3951 $bootindex_hash->{n
} += 1;
3954 my $netdevfull = print_netdev_full
($vmid, $conf, $arch, $d, "net$i");
3955 push @$devices, '-netdev', $netdevfull;
3957 my $netdevicefull = print_netdevice_full
($vmid, $conf, $d, "net$i", $bridges, $use_old_bios_files, $arch, $machine_type);
3958 push @$devices, '-device', $netdevicefull;
3961 if ($conf->{ivshmem
}) {
3962 my $ivshmem = PVE
::JSONSchema
::parse_property_string
($ivshmem_fmt, $conf->{ivshmem
});
3966 $bus = print_pcie_addr
("ivshmem");
3968 $bus = print_pci_addr
("ivshmem", $bridges, $arch, $machine_type);
3971 my $ivshmem_name = $ivshmem->{name
} // $vmid;
3972 my $path = '/dev/shm/pve-shm-' . $ivshmem_name;
3974 push @$devices, '-device', "ivshmem-plain,memdev=ivshmem$bus,";
3975 push @$devices, '-object', "memory-backend-file,id=ivshmem,share=on,mem-path=$path,size=$ivshmem->{size}M";
3980 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
3985 $bridges->{3} = 1 if $scsihw =~ m/^virtio-scsi-single/;
3987 while (my ($k, $v) = each %$bridges) {
3988 $pciaddr = print_pci_addr
("pci.$k", undef, $arch, $machine_type);
3989 unshift @$devices, '-device', "pci-bridge,id=pci.$k,chassis_nr=$k$pciaddr" if $k > 0;
3993 push @$cmd, @$devices;
3994 push @$cmd, '-rtc', join(',', @$rtcFlags)
3995 if scalar(@$rtcFlags);
3996 push @$cmd, '-machine', join(',', @$machineFlags)
3997 if scalar(@$machineFlags);
3998 push @$cmd, '-global', join(',', @$globalFlags)
3999 if scalar(@$globalFlags);
4001 if (my $vmstate = $conf->{vmstate
}) {
4002 my $statepath = PVE
::Storage
::path
($storecfg, $vmstate);
4003 PVE
::Storage
::activate_volumes
($storecfg, [$vmstate]);
4004 push @$cmd, '-loadstate', $statepath;
4008 if ($conf->{args
}) {
4009 my $aa = PVE
::Tools
::split_args
($conf->{args
});
4013 return wantarray ?
($cmd, $vollist, $spice_port) : $cmd;
4018 return "${var_run_tmpdir}/$vmid.vnc";
4024 my $res = vm_mon_cmd
($vmid, 'query-spice');
4026 return $res->{'tls-port'} || $res->{'port'} || die "no spice port\n";
4030 my ($vmid, $qga, $name) = @_;
4031 my $sockettype = $qga ?
'qga' : 'qmp';
4032 my $ext = $name ?
'-'.$name : '';
4033 return "${var_run_tmpdir}/$vmid$ext.$sockettype";
4038 return "${var_run_tmpdir}/$vmid.pid";
4041 sub vm_devices_list
{
4044 my $res = vm_mon_cmd
($vmid, 'query-pci');
4045 my $devices_to_check = [];
4047 foreach my $pcibus (@$res) {
4048 push @$devices_to_check, @{$pcibus->{devices
}},
4051 while (@$devices_to_check) {
4053 for my $d (@$devices_to_check) {
4054 $devices->{$d->{'qdev_id'}} = 1 if $d->{'qdev_id'};
4055 next if !$d->{'pci_bridge'};
4057 $devices->{$d->{'qdev_id'}} += scalar(@{$d->{'pci_bridge'}->{devices
}});
4058 push @$to_check, @{$d->{'pci_bridge'}->{devices
}};
4060 $devices_to_check = $to_check;
4063 my $resblock = vm_mon_cmd
($vmid, 'query-block');
4064 foreach my $block (@$resblock) {
4065 if($block->{device
} =~ m/^drive-(\S+)/){
4070 my $resmice = vm_mon_cmd
($vmid, 'query-mice');
4071 foreach my $mice (@$resmice) {
4072 if ($mice->{name
} eq 'QEMU HID Tablet') {
4073 $devices->{tablet
} = 1;
4078 # for usb devices there is no query-usb
4079 # but we can iterate over the entries in
4080 # qom-list path=/machine/peripheral
4081 my $resperipheral = vm_mon_cmd
($vmid, 'qom-list', path
=> '/machine/peripheral');
4082 foreach my $per (@$resperipheral) {
4083 if ($per->{name
} =~ m/^usb\d+$/) {
4084 $devices->{$per->{name
}} = 1;
4092 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4094 my $q35 = machine_type_is_q35
($conf);
4096 my $devices_list = vm_devices_list
($vmid);
4097 return 1 if defined($devices_list->{$deviceid});
4099 qemu_add_pci_bridge
($storecfg, $conf, $vmid, $deviceid, $arch, $machine_type); # add PCI bridge if we need it for the device
4101 if ($deviceid eq 'tablet') {
4103 qemu_deviceadd
($vmid, print_tabletdevice_full
($conf, $arch));
4105 } elsif ($deviceid eq 'keyboard') {
4107 qemu_deviceadd
($vmid, print_keyboarddevice_full
($conf, $arch));
4109 } elsif ($deviceid =~ m/^usb(\d+)$/) {
4111 die "usb hotplug currently not reliable\n";
4112 # since we can't reliably hot unplug all added usb devices
4113 # and usb passthrough disables live migration
4114 # we disable usb hotplugging for now
4115 qemu_deviceadd
($vmid, PVE
::QemuServer
::USB
::print_usbdevice_full
($conf, $deviceid, $device));
4117 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4119 qemu_iothread_add
($vmid, $deviceid, $device);
4121 qemu_driveadd
($storecfg, $vmid, $device);
4122 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4124 qemu_deviceadd
($vmid, $devicefull);
4125 eval { qemu_deviceaddverify
($vmid, $deviceid); };
4127 eval { qemu_drivedel
($vmid, $deviceid); };
4132 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4135 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : "lsi";
4136 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4137 my $scsihw_type = $scsihw eq 'virtio-scsi-single' ?
"virtio-scsi-pci" : $scsihw;
4139 my $devicefull = "$scsihw_type,id=$deviceid$pciaddr";
4141 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{iothread
}) {
4142 qemu_iothread_add
($vmid, $deviceid, $device);
4143 $devicefull .= ",iothread=iothread-$deviceid";
4146 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{queues
}) {
4147 $devicefull .= ",num_queues=$device->{queues}";
4150 qemu_deviceadd
($vmid, $devicefull);
4151 qemu_deviceaddverify
($vmid, $deviceid);
4153 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4155 qemu_findorcreatescsihw
($storecfg,$conf, $vmid, $device, $arch, $machine_type);
4156 qemu_driveadd
($storecfg, $vmid, $device);
4158 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4159 eval { qemu_deviceadd
($vmid, $devicefull); };
4161 eval { qemu_drivedel
($vmid, $deviceid); };
4166 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4168 return undef if !qemu_netdevadd
($vmid, $conf, $arch, $device, $deviceid);
4170 my $machine_type = PVE
::QemuServer
::qemu_machine_pxe
($vmid, $conf);
4171 my $use_old_bios_files = undef;
4172 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
4174 my $netdevicefull = print_netdevice_full
($vmid, $conf, $device, $deviceid, undef, $use_old_bios_files, $arch, $machine_type);
4175 qemu_deviceadd
($vmid, $netdevicefull);
4177 qemu_deviceaddverify
($vmid, $deviceid);
4178 qemu_set_link_status
($vmid, $deviceid, !$device->{link_down
});
4181 eval { qemu_netdevdel
($vmid, $deviceid); };
4186 } elsif (!$q35 && $deviceid =~ m/^(pci\.)(\d+)$/) {
4189 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4190 my $devicefull = "pci-bridge,id=pci.$bridgeid,chassis_nr=$bridgeid$pciaddr";
4192 qemu_deviceadd
($vmid, $devicefull);
4193 qemu_deviceaddverify
($vmid, $deviceid);
4196 die "can't hotplug device '$deviceid'\n";
4202 # fixme: this should raise exceptions on error!
4203 sub vm_deviceunplug
{
4204 my ($vmid, $conf, $deviceid) = @_;
4206 my $devices_list = vm_devices_list
($vmid);
4207 return 1 if !defined($devices_list->{$deviceid});
4209 die "can't unplug bootdisk" if $conf->{bootdisk
} && $conf->{bootdisk
} eq $deviceid;
4211 if ($deviceid eq 'tablet' || $deviceid eq 'keyboard') {
4213 qemu_devicedel
($vmid, $deviceid);
4215 } elsif ($deviceid =~ m/^usb\d+$/) {
4217 die "usb hotplug currently not reliable\n";
4218 # when unplugging usb devices this way,
4219 # there may be remaining usb controllers/hubs
4220 # so we disable it for now
4221 qemu_devicedel
($vmid, $deviceid);
4222 qemu_devicedelverify
($vmid, $deviceid);
4224 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4226 qemu_devicedel
($vmid, $deviceid);
4227 qemu_devicedelverify
($vmid, $deviceid);
4228 qemu_drivedel
($vmid, $deviceid);
4229 qemu_iothread_del
($conf, $vmid, $deviceid);
4231 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4233 qemu_devicedel
($vmid, $deviceid);
4234 qemu_devicedelverify
($vmid, $deviceid);
4235 qemu_iothread_del
($conf, $vmid, $deviceid);
4237 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4239 qemu_devicedel
($vmid, $deviceid);
4240 qemu_drivedel
($vmid, $deviceid);
4241 qemu_deletescsihw
($conf, $vmid, $deviceid);
4243 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4245 qemu_devicedel
($vmid, $deviceid);
4246 qemu_devicedelverify
($vmid, $deviceid);
4247 qemu_netdevdel
($vmid, $deviceid);
4250 die "can't unplug device '$deviceid'\n";
4256 sub qemu_deviceadd
{
4257 my ($vmid, $devicefull) = @_;
4259 $devicefull = "driver=".$devicefull;
4260 my %options = split(/[=,]/, $devicefull);
4262 vm_mon_cmd
($vmid, "device_add" , %options);
4265 sub qemu_devicedel
{
4266 my ($vmid, $deviceid) = @_;
4268 my $ret = vm_mon_cmd
($vmid, "device_del", id
=> $deviceid);
4271 sub qemu_iothread_add
{
4272 my($vmid, $deviceid, $device) = @_;
4274 if ($device->{iothread
}) {
4275 my $iothreads = vm_iothreads_list
($vmid);
4276 qemu_objectadd
($vmid, "iothread-$deviceid", "iothread") if !$iothreads->{"iothread-$deviceid"};
4280 sub qemu_iothread_del
{
4281 my($conf, $vmid, $deviceid) = @_;
4283 my $confid = $deviceid;
4284 if ($deviceid =~ m/^(?:virtioscsi|scsihw)(\d+)$/) {
4285 $confid = 'scsi' . $1;
4287 my $device = parse_drive
($confid, $conf->{$confid});
4288 if ($device->{iothread
}) {
4289 my $iothreads = vm_iothreads_list
($vmid);
4290 qemu_objectdel
($vmid, "iothread-$deviceid") if $iothreads->{"iothread-$deviceid"};
4294 sub qemu_objectadd
{
4295 my($vmid, $objectid, $qomtype) = @_;
4297 vm_mon_cmd
($vmid, "object-add", id
=> $objectid, "qom-type" => $qomtype);
4302 sub qemu_objectdel
{
4303 my($vmid, $objectid) = @_;
4305 vm_mon_cmd
($vmid, "object-del", id
=> $objectid);
4311 my ($storecfg, $vmid, $device) = @_;
4313 my $drive = print_drive_full
($storecfg, $vmid, $device);
4314 $drive =~ s/\\/\\\\/g;
4315 my $ret = vm_human_monitor_command
($vmid, "drive_add auto \"$drive\"");
4317 # If the command succeeds qemu prints: "OK
"
4318 return 1 if $ret =~ m/OK/s;
4320 die "adding drive failed
: $ret\n";
4324 my($vmid, $deviceid) = @_;
4326 my $ret = vm_human_monitor_command($vmid, "drive_del drive-
$deviceid");
4329 return 1 if $ret eq "";
4331 # NB: device not found errors mean the drive was auto-deleted and we ignore the error
4332 return 1 if $ret =~ m/Device \'.*?\' not found/s;
4334 die "deleting drive
$deviceid failed
: $ret\n";
4337 sub qemu_deviceaddverify {
4338 my ($vmid, $deviceid) = @_;
4340 for (my $i = 0; $i <= 5; $i++) {
4341 my $devices_list = vm_devices_list($vmid);
4342 return 1 if defined($devices_list->{$deviceid});
4346 die "error on hotplug device
'$deviceid'\n";
4350 sub qemu_devicedelverify {
4351 my ($vmid, $deviceid) = @_;
4353 # need to verify that the device is correctly removed as device_del
4354 # is async and empty return is not reliable
4356 for (my $i = 0; $i <= 5; $i++) {
4357 my $devices_list = vm_devices_list($vmid);
4358 return 1 if !defined($devices_list->{$deviceid});
4362 die "error on hot-unplugging device
'$deviceid'\n";
4365 sub qemu_findorcreatescsihw {
4366 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4368 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4370 my $scsihwid="$controller_prefix$controller";
4371 my $devices_list = vm_devices_list($vmid);
4373 if(!defined($devices_list->{$scsihwid})) {
4374 vm_deviceplug($storecfg, $conf, $vmid, $scsihwid, $device, $arch, $machine_type);
4380 sub qemu_deletescsihw {
4381 my ($conf, $vmid, $opt) = @_;
4383 my $device = parse_drive($opt, $conf->{$opt});
4385 if ($conf->{scsihw} && ($conf->{scsihw} eq 'virtio-scsi-single')) {
4386 vm_deviceunplug($vmid, $conf, "virtioscsi
$device->{index}");
4390 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4392 my $devices_list = vm_devices_list($vmid);
4393 foreach my $opt (keys %{$devices_list}) {
4394 if (PVE::QemuServer::is_valid_drivename($opt)) {
4395 my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
4396 if($drive->{interface} eq 'scsi' && $drive->{index} < (($maxdev-1)*($controller+1))) {
4402 my $scsihwid="scsihw
$controller";
4404 vm_deviceunplug($vmid, $conf, $scsihwid);
4409 sub qemu_add_pci_bridge {
4410 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4416 print_pci_addr($device, $bridges, $arch, $machine_type);
4418 while (my ($k, $v) = each %$bridges) {
4421 return 1 if !defined($bridgeid) || $bridgeid < 1;
4423 my $bridge = "pci
.$bridgeid";
4424 my $devices_list = vm_devices_list($vmid);
4426 if (!defined($devices_list->{$bridge})) {
4427 vm_deviceplug($storecfg, $conf, $vmid, $bridge, $arch, $machine_type);
4433 sub qemu_set_link_status {
4434 my ($vmid, $device, $up) = @_;
4436 vm_mon_cmd($vmid, "set_link
", name => $device,
4437 up => $up ? JSON::true : JSON::false);
4440 sub qemu_netdevadd {
4441 my ($vmid, $conf, $arch, $device, $deviceid) = @_;
4443 my $netdev = print_netdev_full($vmid, $conf, $arch, $device, $deviceid, 1);
4444 my %options = split(/[=,]/, $netdev);
4446 vm_mon_cmd($vmid, "netdev_add
", %options);
4450 sub qemu_netdevdel {
4451 my ($vmid, $deviceid) = @_;
4453 vm_mon_cmd($vmid, "netdev_del
", id => $deviceid);
4456 sub qemu_usb_hotplug {
4457 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4461 # remove the old one first
4462 vm_deviceunplug($vmid, $conf, $deviceid);
4464 # check if xhci controller is necessary and available
4465 if ($device->{usb3}) {
4467 my $devicelist = vm_devices_list($vmid);
4469 if (!$devicelist->{xhci}) {
4470 my $pciaddr = print_pci_addr("xhci
", undef, $arch, $machine_type);
4471 qemu_deviceadd($vmid, "nec-usb-xhci
,id
=xhci
$pciaddr");
4474 my $d = parse_usb_device($device->{host});
4475 $d->{usb3} = $device->{usb3};
4478 vm_deviceplug($storecfg, $conf, $vmid, $deviceid, $d, $arch, $machine_type);
4481 sub qemu_cpu_hotplug {
4482 my ($vmid, $conf, $vcpus) = @_;
4484 my $machine_type = PVE::QemuServer::get_current_qemu_machine($vmid);
4487 $sockets = $conf->{smp} if $conf->{smp}; # old style - no longer iused
4488 $sockets = $conf->{sockets} if $conf->{sockets};
4489 my $cores = $conf->{cores} || 1;
4490 my $maxcpus = $sockets * $cores;
4492 $vcpus = $maxcpus if !$vcpus;
4494 die "you can
't add more vcpus than maxcpus\n"
4495 if $vcpus > $maxcpus;
4497 my $currentvcpus = $conf->{vcpus} || $maxcpus;
4499 if ($vcpus < $currentvcpus) {
4501 if (qemu_machine_feature_enabled ($machine_type, undef, 2, 7)) {
4503 for (my $i = $currentvcpus; $i > $vcpus; $i--) {
4504 qemu_devicedel($vmid, "cpu$i");
4506 my $currentrunningvcpus = undef;
4508 $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4509 last if scalar(@{$currentrunningvcpus}) == $i-1;
4510 raise_param_exc({ vcpus => "error unplugging cpu$i" }) if $retry > 5;
4514 #update conf after each succesfull cpu unplug
4515 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4516 PVE::QemuConfig->write_config($vmid, $conf);
4519 die "cpu hot-unplugging requires qemu version 2.7 or higher\n";
4525 my $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4526 die "vcpus in running vm does not match its configuration\n"
4527 if scalar(@{$currentrunningvcpus}) != $currentvcpus;
4529 if (qemu_machine_feature_enabled ($machine_type, undef, 2, 7)) {
4531 for (my $i = $currentvcpus+1; $i <= $vcpus; $i++) {
4532 my $cpustr = print_cpu_device($conf, $i);
4533 qemu_deviceadd($vmid, $cpustr);
4536 my $currentrunningvcpus = undef;
4538 $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4539 last if scalar(@{$currentrunningvcpus}) == $i;
4540 raise_param_exc({ vcpus => "error hotplugging cpu$i" }) if $retry > 10;
4544 #update conf after each succesfull cpu hotplug
4545 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4546 PVE::QemuConfig->write_config($vmid, $conf);
4550 for (my $i = $currentvcpus; $i < $vcpus; $i++) {
4551 vm_mon_cmd($vmid, "cpu-add", id => int($i));
4556 sub qemu_block_set_io_throttle {
4557 my ($vmid, $deviceid,
4558 $bps, $bps_rd, $bps_wr, $iops, $iops_rd, $iops_wr,
4559 $bps_max, $bps_rd_max, $bps_wr_max, $iops_max, $iops_rd_max, $iops_wr_max,
4560 $bps_max_length, $bps_rd_max_length, $bps_wr_max_length,
4561 $iops_max_length, $iops_rd_max_length, $iops_wr_max_length) = @_;
4563 return if !check_running($vmid) ;
4565 vm_mon_cmd($vmid, "block_set_io_throttle", device => $deviceid,
4567 bps_rd => int($bps_rd),
4568 bps_wr => int($bps_wr),
4570 iops_rd => int($iops_rd),
4571 iops_wr => int($iops_wr),
4572 bps_max => int($bps_max),
4573 bps_rd_max => int($bps_rd_max),
4574 bps_wr_max => int($bps_wr_max),
4575 iops_max => int($iops_max),
4576 iops_rd_max => int($iops_rd_max),
4577 iops_wr_max => int($iops_wr_max),
4578 bps_max_length => int($bps_max_length),
4579 bps_rd_max_length => int($bps_rd_max_length),
4580 bps_wr_max_length => int($bps_wr_max_length),
4581 iops_max_length => int($iops_max_length),
4582 iops_rd_max_length => int($iops_rd_max_length),
4583 iops_wr_max_length => int($iops_wr_max_length),
4588 # old code, only used to shutdown old VM after update
4590 my ($fh, $timeout) = @_;
4592 my $sel = new IO::Select;
4599 while (scalar (@ready = $sel->can_read($timeout))) {
4601 if ($count = $fh->sysread($buf, 8192)) {
4602 if ($buf =~ /^(.*)\(qemu\) $/s) {
4609 if (!defined($count)) {
4616 die "monitor read timeout\n" if !scalar(@ready);
4621 sub qemu_block_resize {
4622 my ($vmid, $deviceid, $storecfg, $volid, $size) = @_;
4624 my $running = check_running($vmid);
4626 $size = 0 if !PVE::Storage::volume_resize($storecfg, $volid, $size, $running);
4628 return if !$running;
4630 vm_mon_cmd($vmid, "block_resize", device => $deviceid, size => int($size));
4634 sub qemu_volume_snapshot {
4635 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4637 my $running = check_running($vmid);
4639 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4640 vm_mon_cmd($vmid, 'blockdev-snapshot-internal-sync
', device => $deviceid, name => $snap);
4642 PVE::Storage::volume_snapshot($storecfg, $volid, $snap);
4646 sub qemu_volume_snapshot_delete {
4647 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4649 my $running = check_running($vmid);
4654 my $conf = PVE::QemuConfig->load_config($vmid);
4655 foreach_drive($conf, sub {
4656 my ($ds, $drive) = @_;
4657 $running = 1 if $drive->{file} eq $volid;
4661 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4662 vm_mon_cmd($vmid, 'blockdev-snapshot-delete-internal-sync
', device => $deviceid, name => $snap);
4664 PVE::Storage::volume_snapshot_delete($storecfg, $volid, $snap, $running);
4668 sub set_migration_caps {
4674 "auto-converge" => 1,
4676 "x-rdma-pin-all" => 0,
4681 my $supported_capabilities = vm_mon_cmd_nocheck($vmid, "query-migrate-capabilities");
4683 for my $supported_capability (@$supported_capabilities) {
4685 capability => $supported_capability->{capability},
4686 state => $enabled_cap->{$supported_capability->{capability}} ? JSON::true : JSON::false,
4690 vm_mon_cmd_nocheck($vmid, "migrate-set-capabilities", capabilities => $cap_ref);
4693 my $fast_plug_option = {
4701 'vmstatestorage
' => 1,
4705 # hotplug changes in [PENDING]
4706 # $selection hash can be used to only apply specified options, for
4707 # example: { cores => 1 } (only apply changed 'cores
')
4708 # $errors ref is used to return error messages
4709 sub vmconfig_hotplug_pending {
4710 my ($vmid, $conf, $storecfg, $selection, $errors) = @_;
4712 my $defaults = load_defaults();
4713 my ($arch, $machine_type) = get_basic_machine_info($conf, undef);
4715 # commit values which do not have any impact on running VM first
4716 # Note: those option cannot raise errors, we we do not care about
4717 # $selection and always apply them.
4719 my $add_error = sub {
4720 my ($opt, $msg) = @_;
4721 $errors->{$opt} = "hotplug problem - $msg";
4725 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4726 if ($fast_plug_option->{$opt}) {
4727 $conf->{$opt} = $conf->{pending}->{$opt};
4728 delete $conf->{pending}->{$opt};
4734 PVE::QemuConfig->write_config($vmid, $conf);
4735 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4738 my $hotplug_features = parse_hotplug_features(defined($conf->{hotplug}) ? $conf->{hotplug} : '1');
4740 my $pending_delete_hash = split_flagged_list($conf->{pending}->{delete});
4741 while (my ($opt, $force) = each %$pending_delete_hash) {
4742 next if $selection && !$selection->{$opt};
4744 if ($opt eq 'hotplug
') {
4745 die "skip\n" if ($conf->{hotplug} =~ /memory/);
4746 } elsif ($opt eq 'tablet
') {
4747 die "skip\n" if !$hotplug_features->{usb};
4748 if ($defaults->{tablet}) {
4749 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4750 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4751 if $arch eq 'aarch64
';
4753 vm_deviceunplug($vmid, $conf, 'tablet
');
4754 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4756 } elsif ($opt =~ m/^usb\d+/) {
4758 # since we cannot reliably hot unplug usb devices
4759 # we are disabling it
4760 die "skip\n" if !$hotplug_features->{usb} || $conf->{$opt} =~ m/spice/i;
4761 vm_deviceunplug($vmid, $conf, $opt);
4762 } elsif ($opt eq 'vcpus
') {
4763 die "skip\n" if !$hotplug_features->{cpu};
4764 qemu_cpu_hotplug($vmid, $conf, undef);
4765 } elsif ($opt eq 'balloon
') {
4766 # enable balloon device is not hotpluggable
4767 die "skip\n" if defined($conf->{balloon}) && $conf->{balloon} == 0;
4768 # here we reset the ballooning value to memory
4769 my $balloon = $conf->{memory} || $defaults->{memory};
4770 vm_mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4771 } elsif ($fast_plug_option->{$opt}) {
4773 } elsif ($opt =~ m/^net(\d+)$/) {
4774 die "skip\n" if !$hotplug_features->{network};
4775 vm_deviceunplug($vmid, $conf, $opt);
4776 } elsif (is_valid_drivename($opt)) {
4777 die "skip\n" if !$hotplug_features->{disk} || $opt =~ m/(ide|sata)(\d+)/;
4778 vm_deviceunplug($vmid, $conf, $opt);
4779 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4780 } elsif ($opt =~ m/^memory$/) {
4781 die "skip\n" if !$hotplug_features->{memory};
4782 PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt);
4783 } elsif ($opt eq 'cpuunits
') {
4784 cgroups_write("cpu", $vmid, "cpu.shares", $defaults->{cpuunits});
4785 } elsif ($opt eq 'cpulimit
') {
4786 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", -1);
4792 &$add_error($opt, $err) if $err ne "skip\n";
4794 # save new config if hotplug was successful
4795 delete $conf->{$opt};
4796 vmconfig_undelete_pending_option($conf, $opt);
4797 PVE::QemuConfig->write_config($vmid, $conf);
4798 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4802 my $apply_pending_cloudinit;
4803 $apply_pending_cloudinit = sub {
4804 my ($key, $value) = @_;
4805 $apply_pending_cloudinit = sub {}; # once is enough
4807 my @cloudinit_opts = keys %$confdesc_cloudinit;
4808 foreach my $opt (keys %{$conf->{pending}}) {
4809 next if !grep { $_ eq $opt } @cloudinit_opts;
4810 $conf->{$opt} = delete $conf->{pending}->{$opt};
4813 my $new_conf = { %$conf };
4814 $new_conf->{$key} = $value;
4815 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($new_conf, $vmid);
4818 foreach my $opt (keys %{$conf->{pending}}) {
4819 next if $selection && !$selection->{$opt};
4820 my $value = $conf->{pending}->{$opt};
4822 if ($opt eq 'hotplug
') {
4823 die "skip\n" if ($value =~ /memory/) || ($value !~ /memory/ && $conf->{hotplug} =~ /memory/);
4824 } elsif ($opt eq 'tablet
') {
4825 die "skip\n" if !$hotplug_features->{usb};
4827 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4828 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4829 if $arch eq 'aarch64
';
4830 } elsif ($value == 0) {
4831 vm_deviceunplug($vmid, $conf, 'tablet
');
4832 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4834 } elsif ($opt =~ m/^usb\d+$/) {
4836 # since we cannot reliably hot unplug usb devices
4837 # we are disabling it
4838 die "skip\n" if !$hotplug_features->{usb} || $value =~ m/spice/i;
4839 my $d = eval { PVE::JSONSchema::parse_property_string($usbdesc->{format}, $value) };
4840 die "skip\n" if !$d;
4841 qemu_usb_hotplug($storecfg, $conf, $vmid, $opt, $d, $arch, $machine_type);
4842 } elsif ($opt eq 'vcpus
') {
4843 die "skip\n" if !$hotplug_features->{cpu};
4844 qemu_cpu_hotplug($vmid, $conf, $value);
4845 } elsif ($opt eq 'balloon
') {
4846 # enable/disable balloning device is not hotpluggable
4847 my $old_balloon_enabled = !!(!defined($conf->{balloon}) || $conf->{balloon});
4848 my $new_balloon_enabled = !!(!defined($conf->{pending}->{balloon}) || $conf->{pending}->{balloon});
4849 die "skip\n" if $old_balloon_enabled != $new_balloon_enabled;
4851 # allow manual ballooning if shares is set to zero
4852 if ((defined($conf->{shares}) && ($conf->{shares} == 0))) {
4853 my $balloon = $conf->{pending}->{balloon} || $conf->{memory} || $defaults->{memory};
4854 vm_mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4856 } elsif ($opt =~ m/^net(\d+)$/) {
4857 # some changes can be done without hotplug
4858 vmconfig_update_net($storecfg, $conf, $hotplug_features->{network},
4859 $vmid, $opt, $value, $arch, $machine_type);
4860 } elsif (is_valid_drivename($opt)) {
4861 # some changes can be done without hotplug
4862 my $drive = parse_drive($opt, $value);
4863 if (drive_is_cloudinit($drive)) {
4864 &$apply_pending_cloudinit($opt, $value);
4866 vmconfig_update_disk($storecfg, $conf, $hotplug_features->{disk},
4867 $vmid, $opt, $value, 1, $arch, $machine_type);
4868 } elsif ($opt =~ m/^memory$/) { #dimms
4869 die "skip\n" if !$hotplug_features->{memory};
4870 $value = PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt, $value);
4871 } elsif ($opt eq 'cpuunits
') {
4872 cgroups_write("cpu", $vmid, "cpu.shares", $conf->{pending}->{$opt});
4873 } elsif ($opt eq 'cpulimit
') {
4874 my $cpulimit = $conf->{pending}->{$opt} == 0 ? -1 : int($conf->{pending}->{$opt} * 100000);
4875 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", $cpulimit);
4877 die "skip\n"; # skip non-hot-pluggable options
4881 &$add_error($opt, $err) if $err ne "skip\n";
4883 # save new config if hotplug was successful
4884 $conf->{$opt} = $value;
4885 delete $conf->{pending}->{$opt};
4886 PVE::QemuConfig->write_config($vmid, $conf);
4887 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4892 sub try_deallocate_drive {
4893 my ($storecfg, $vmid, $conf, $key, $drive, $rpcenv, $authuser, $force) = @_;
4895 if (($force || $key =~ /^unused/) && !drive_is_cdrom($drive, 1)) {
4896 my $volid = $drive->{file};
4897 if (vm_is_volid_owner($storecfg, $vmid, $volid)) {
4898 my $sid = PVE::Storage::parse_volume_id($volid);
4899 $rpcenv->check($authuser, "/storage/$sid", ['Datastore
.AllocateSpace
']);
4901 # check if the disk is really unused
4902 die "unable to delete '$volid' - volume is still in use (snapshot?)\n"
4903 if is_volume_in_use($storecfg, $conf, $key, $volid);
4904 PVE::Storage::vdisk_free($storecfg, $volid);
4907 # If vm is not owner of this disk remove from config
4915 sub vmconfig_delete_or_detach_drive {
4916 my ($vmid, $storecfg, $conf, $opt, $force) = @_;
4918 my $drive = parse_drive($opt, $conf->{$opt});
4920 my $rpcenv = PVE::RPCEnvironment::get();
4921 my $authuser = $rpcenv->get_user();
4924 $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM
.Config
.Disk
']);
4925 try_deallocate_drive($storecfg, $vmid, $conf, $opt, $drive, $rpcenv, $authuser, $force);
4927 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $drive);
4931 sub vmconfig_apply_pending {
4932 my ($vmid, $conf, $storecfg) = @_;
4936 my $pending_delete_hash = split_flagged_list($conf->{pending}->{delete});
4937 while (my ($opt, $force) = each %$pending_delete_hash) {
4938 die "internal error" if $opt =~ m/^unused/;
4939 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4940 if (!defined($conf->{$opt})) {
4941 vmconfig_undelete_pending_option($conf, $opt);
4942 PVE::QemuConfig->write_config($vmid, $conf);
4943 } elsif (is_valid_drivename($opt)) {
4944 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4945 vmconfig_undelete_pending_option($conf, $opt);
4946 delete $conf->{$opt};
4947 PVE::QemuConfig->write_config($vmid, $conf);
4949 vmconfig_undelete_pending_option($conf, $opt);
4950 delete $conf->{$opt};
4951 PVE::QemuConfig->write_config($vmid, $conf);
4955 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4957 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4958 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4960 if (defined($conf->{$opt}) && ($conf->{$opt} eq $conf->{pending}->{$opt})) {
4961 # skip if nothing changed
4962 } elsif (is_valid_drivename($opt)) {
4963 vmconfig_register_unused_drive($storecfg, $vmid, $conf, parse_drive($opt, $conf->{$opt}))
4964 if defined($conf->{$opt});
4965 $conf->{$opt} = $conf->{pending}->{$opt};
4967 $conf->{$opt} = $conf->{pending}->{$opt};
4970 delete $conf->{pending}->{$opt};
4971 PVE::QemuConfig->write_config($vmid, $conf);
4975 my $safe_num_ne = sub {
4978 return 0 if !defined($a) && !defined($b);
4979 return 1 if !defined($a);
4980 return 1 if !defined($b);
4985 my $safe_string_ne = sub {
4988 return 0 if !defined($a) && !defined($b);
4989 return 1 if !defined($a);
4990 return 1 if !defined($b);
4995 sub vmconfig_update_net {
4996 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $arch, $machine_type) = @_;
4998 my $newnet = parse_net($value);
5000 if ($conf->{$opt}) {
5001 my $oldnet = parse_net($conf->{$opt});
5003 if (&$safe_string_ne($oldnet->{model}, $newnet->{model}) ||
5004 &$safe_string_ne($oldnet->{macaddr}, $newnet->{macaddr}) ||
5005 &$safe_num_ne($oldnet->{queues}, $newnet->{queues}) ||
5006 !($newnet->{bridge} && $oldnet->{bridge})) { # bridge/nat mode change
5008 # for non online change, we try to hot-unplug
5009 die "skip\n" if !$hotplug;
5010 vm_deviceunplug($vmid, $conf, $opt);
5013 die "internal error" if $opt !~ m/net(\d+)/;
5014 my $iface = "tap${vmid}i$1";
5016 if (&$safe_string_ne($oldnet->{bridge}, $newnet->{bridge}) ||
5017 &$safe_num_ne($oldnet->{tag}, $newnet->{tag}) ||
5018 &$safe_string_ne($oldnet->{trunks}, $newnet->{trunks}) ||
5019 &$safe_num_ne($oldnet->{firewall}, $newnet->{firewall})) {
5020 PVE::Network::tap_unplug($iface);
5021 PVE::Network::tap_plug($iface, $newnet->{bridge}, $newnet->{tag}, $newnet->{firewall}, $newnet->{trunks}, $newnet->{rate});
5022 } elsif (&$safe_num_ne($oldnet->{rate}, $newnet->{rate})) {
5023 # Rate can be applied on its own but any change above needs to
5024 # include the rate in tap_plug since OVS resets everything.
5025 PVE::Network::tap_rate_limit($iface, $newnet->{rate});
5028 if (&$safe_string_ne($oldnet->{link_down}, $newnet->{link_down})) {
5029 qemu_set_link_status($vmid, $opt, !$newnet->{link_down});
5037 vm_deviceplug($storecfg, $conf, $vmid, $opt, $newnet, $arch, $machine_type);
5043 sub vmconfig_update_disk {
5044 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $force, $arch, $machine_type) = @_;
5046 # fixme: do we need force?
5048 my $drive = parse_drive($opt, $value);
5050 if ($conf->{$opt}) {
5052 if (my $old_drive = parse_drive($opt, $conf->{$opt})) {
5054 my $media = $drive->{media} || 'disk
';
5055 my $oldmedia = $old_drive->{media} || 'disk
';
5056 die "unable to change media type\n" if $media ne $oldmedia;
5058 if (!drive_is_cdrom($old_drive)) {
5060 if ($drive->{file} ne $old_drive->{file}) {
5062 die "skip\n" if !$hotplug;
5064 # unplug and register as unused
5065 vm_deviceunplug($vmid, $conf, $opt);
5066 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive)
5069 # update existing disk
5071 # skip non hotpluggable value
5072 if (&$safe_string_ne($drive->{discard}, $old_drive->{discard}) ||
5073 &$safe_string_ne($drive->{iothread}, $old_drive->{iothread}) ||
5074 &$safe_string_ne($drive->{queues}, $old_drive->{queues}) ||
5075 &$safe_string_ne($drive->{cache}, $old_drive->{cache})) {
5080 if (&$safe_num_ne($drive->{mbps}, $old_drive->{mbps}) ||
5081 &$safe_num_ne($drive->{mbps_rd}, $old_drive->{mbps_rd}) ||
5082 &$safe_num_ne($drive->{mbps_wr}, $old_drive->{mbps_wr}) ||
5083 &$safe_num_ne($drive->{iops}, $old_drive->{iops}) ||
5084 &$safe_num_ne($drive->{iops_rd}, $old_drive->{iops_rd}) ||
5085 &$safe_num_ne($drive->{iops_wr}, $old_drive->{iops_wr}) ||
5086 &$safe_num_ne($drive->{mbps_max}, $old_drive->{mbps_max}) ||
5087 &$safe_num_ne($drive->{mbps_rd_max}, $old_drive->{mbps_rd_max}) ||
5088 &$safe_num_ne($drive->{mbps_wr_max}, $old_drive->{mbps_wr_max}) ||
5089 &$safe_num_ne($drive->{iops_max}, $old_drive->{iops_max}) ||
5090 &$safe_num_ne($drive->{iops_rd_max}, $old_drive->{iops_rd_max}) ||
5091 &$safe_num_ne($drive->{iops_wr_max}, $old_drive->{iops_wr_max}) ||
5092 &$safe_num_ne($drive->{bps_max_length}, $old_drive->{bps_max_length}) ||
5093 &$safe_num_ne($drive->{bps_rd_max_length}, $old_drive->{bps_rd_max_length}) ||
5094 &$safe_num_ne($drive->{bps_wr_max_length}, $old_drive->{bps_wr_max_length}) ||
5095 &$safe_num_ne($drive->{iops_max_length}, $old_drive->{iops_max_length}) ||
5096 &$safe_num_ne($drive->{iops_rd_max_length}, $old_drive->{iops_rd_max_length}) ||
5097 &$safe_num_ne($drive->{iops_wr_max_length}, $old_drive->{iops_wr_max_length})) {
5099 qemu_block_set_io_throttle($vmid,"drive-$opt",
5100 ($drive->{mbps} || 0)*1024*1024,
5101 ($drive->{mbps_rd} || 0)*1024*1024,
5102 ($drive->{mbps_wr} || 0)*1024*1024,
5103 $drive->{iops} || 0,
5104 $drive->{iops_rd} || 0,
5105 $drive->{iops_wr} || 0,
5106 ($drive->{mbps_max} || 0)*1024*1024,
5107 ($drive->{mbps_rd_max} || 0)*1024*1024,
5108 ($drive->{mbps_wr_max} || 0)*1024*1024,
5109 $drive->{iops_max} || 0,
5110 $drive->{iops_rd_max} || 0,
5111 $drive->{iops_wr_max} || 0,
5112 $drive->{bps_max_length} || 1,
5113 $drive->{bps_rd_max_length} || 1,
5114 $drive->{bps_wr_max_length} || 1,
5115 $drive->{iops_max_length} || 1,
5116 $drive->{iops_rd_max_length} || 1,
5117 $drive->{iops_wr_max_length} || 1);
5126 if ($drive->{file} eq 'none
') {
5127 vm_mon_cmd($vmid, "eject",force => JSON::true,device => "drive-$opt");
5128 if (drive_is_cloudinit($old_drive)) {
5129 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive);
5132 my $path = get_iso_path($storecfg, $vmid, $drive->{file});
5133 vm_mon_cmd($vmid, "eject", force => JSON::true,device => "drive-$opt"); # force eject if locked
5134 vm_mon_cmd($vmid, "change", device => "drive-$opt",target => "$path") if $path;
5142 die "skip\n" if !$hotplug || $opt =~ m/(ide|sata)(\d+)/;
5144 PVE::Storage::activate_volumes($storecfg, [$drive->{file}]) if $drive->{file} !~ m|^/dev/.+|;
5145 vm_deviceplug($storecfg, $conf, $vmid, $opt, $drive, $arch, $machine_type);
5149 my ($storecfg, $vmid, $statefile, $skiplock, $migratedfrom, $paused,
5150 $forcemachine, $spice_ticket, $migration_network, $migration_type, $targetstorage) = @_;
5152 PVE::QemuConfig->lock_config($vmid, sub {
5153 my $conf = PVE::QemuConfig->load_config($vmid, $migratedfrom);
5155 die "you can't start a vm
if it
's a template\n" if PVE::QemuConfig->is_template($conf);
5157 my $is_suspended = PVE::QemuConfig->has_lock($conf, 'suspended
');
5159 PVE::QemuConfig->check_lock($conf)
5160 if !($skiplock || $is_suspended);
5162 die "VM $vmid already running\n" if check_running($vmid, undef, $migratedfrom);
5164 if (!$statefile && scalar(keys %{$conf->{pending}})) {
5165 vmconfig_apply_pending($vmid, $conf, $storecfg);
5166 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5169 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($conf, $vmid);
5171 my $defaults = load_defaults();
5173 # set environment variable useful inside network script
5174 $ENV{PVE_MIGRATED_FROM} = $migratedfrom if $migratedfrom;
5176 my $local_volumes = {};
5178 if ($targetstorage) {
5179 foreach_drive($conf, sub {
5180 my ($ds, $drive) = @_;
5182 return if drive_is_cdrom($drive);
5184 my $volid = $drive->{file};
5188 my ($storeid, $volname) = PVE::Storage::parse_volume_id($volid);
5190 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5191 return if $scfg->{shared};
5192 $local_volumes->{$ds} = [$volid, $storeid, $volname];
5197 foreach my $opt (sort keys %$local_volumes) {
5199 my ($volid, $storeid, $volname) = @{$local_volumes->{$opt}};
5200 my $drive = parse_drive($opt, $conf->{$opt});
5202 #if remote storage is specified, use default format
5203 if ($targetstorage && $targetstorage ne "1") {
5204 $storeid = $targetstorage;
5205 my ($defFormat, $validFormats) = PVE::Storage::storage_default_format($storecfg, $storeid);
5206 $format = $defFormat;
5208 #else we use same format than original
5209 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5210 $format = qemu_img_format($scfg, $volid);
5213 my $newvolid = PVE::Storage::vdisk_alloc($storecfg, $storeid, $vmid, $format, undef, ($drive->{size}/1024));
5214 my $newdrive = $drive;
5215 $newdrive->{format} = $format;
5216 $newdrive->{file} = $newvolid;
5217 my $drivestr = PVE::QemuServer::print_drive($vmid, $newdrive);
5218 $local_volumes->{$opt} = $drivestr;
5219 #pass drive to conf for command line
5220 $conf->{$opt} = $drivestr;
5224 PVE::GuestHelpers::exec_hookscript($conf, $vmid, 'pre-start
', 1);
5226 if ($is_suspended) {
5227 # enforce machine type on suspended vm to ensure HW compatibility
5228 $forcemachine = $conf->{runningmachine};
5229 print "Resuming suspended VM\n";
5232 my ($cmd, $vollist, $spice_port) = config_to_command($storecfg, $vmid, $conf, $defaults, $forcemachine);
5234 my $migrate_port = 0;
5237 if ($statefile eq 'tcp
') {
5238 my $localip = "localhost";
5239 my $datacenterconf = PVE::Cluster::cfs_read_file('datacenter
.cfg
');
5240 my $nodename = PVE::INotify::nodename();
5242 if (!defined($migration_type)) {
5243 if (defined($datacenterconf->{migration}->{type})) {
5244 $migration_type = $datacenterconf->{migration}->{type};
5246 $migration_type = 'secure
';
5250 if ($migration_type eq 'insecure
') {
5251 my $migrate_network_addr = PVE::Cluster::get_local_migration_ip($migration_network);
5252 if ($migrate_network_addr) {
5253 $localip = $migrate_network_addr;
5255 $localip = PVE::Cluster::remote_node_ip($nodename, 1);
5258 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5261 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5262 $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5263 $migrate_uri = "tcp:${localip}:${migrate_port}";
5264 push @$cmd, '-incoming
', $migrate_uri;
5267 } elsif ($statefile eq 'unix
') {
5268 # should be default for secure migrations as a ssh TCP forward
5269 # tunnel is not deterministic reliable ready and fails regurarly
5270 # to set up in time, so use UNIX socket forwards
5271 my $socket_addr = "/run/qemu-server/$vmid.migrate";
5272 unlink $socket_addr;
5274 $migrate_uri = "unix:$socket_addr";
5276 push @$cmd, '-incoming
', $migrate_uri;
5280 push @$cmd, '-loadstate
', $statefile;
5287 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
5288 my $d = parse_hostpci($conf->{"hostpci$i"});
5290 my $pcidevices = $d->{pciid};
5291 foreach my $pcidevice (@$pcidevices) {
5292 my $pciid = $pcidevice->{id};
5294 my $info = PVE::SysFSTools::pci_device_info("0000:$pciid");
5295 die "IOMMU not present\n" if !PVE::SysFSTools::check_iommu_support();
5296 die "no pci device info for device '$pciid'\n" if !$info;
5299 my $uuid = PVE::SysFSTools::generate_mdev_uuid($vmid, $i);
5300 PVE::SysFSTools::pci_create_mdev_device($pciid, $uuid, $d->{mdev});
5302 die "can't unbind
/bind pci group to vfio
'$pciid'\n"
5303 if !PVE::SysFSTools::pci_dev_group_bind_to_vfio($pciid);
5304 die "can
't reset pci device '$pciid'\n"
5305 if $info->{has_fl_reset} and !PVE::SysFSTools::pci_dev_reset($info);
5310 PVE::Storage::activate_volumes($storecfg, $vollist);
5312 if (-d "/sys/fs/cgroup/systemd/qemu.slice/$vmid.scope") {
5314 run_command(['/bin/systemctl
', 'stop
', "$vmid.scope"],
5315 outfunc => sub {}, errfunc => sub {});
5319 my $cpuunits = defined($conf->{cpuunits}) ? $conf->{cpuunits}
5320 : $defaults->{cpuunits};
5322 my $start_timeout = $conf->{hugepages} ? 300 : 30;
5323 my %run_params = (timeout => $statefile ? undef : $start_timeout, umask => 0077);
5326 Slice => 'qemu
.slice
',
5328 CPUShares => $cpuunits
5331 if (my $cpulimit = $conf->{cpulimit}) {
5332 $properties{CPUQuota} = int($cpulimit * 100);
5334 $properties{timeout} = 10 if $statefile; # setting up the scope shoul be quick
5336 my $run_qemu = sub {
5337 PVE::Tools::run_fork sub {
5338 PVE::Systemd::enter_systemd_scope($vmid, "Proxmox VE VM $vmid", %properties);
5339 run_command($cmd, %run_params);
5343 if ($conf->{hugepages}) {
5346 my $hugepages_topology = PVE::QemuServer::Memory::hugepages_topology($conf);
5347 my $hugepages_host_topology = PVE::QemuServer::Memory::hugepages_host_topology();
5349 PVE::QemuServer::Memory::hugepages_mount();
5350 PVE::QemuServer::Memory::hugepages_allocate($hugepages_topology, $hugepages_host_topology);
5352 eval { $run_qemu->() };
5354 PVE::QemuServer::Memory::hugepages_reset($hugepages_host_topology);
5358 PVE::QemuServer::Memory::hugepages_pre_deallocate($hugepages_topology);
5360 eval { PVE::QemuServer::Memory::hugepages_update_locked($code); };
5363 eval { $run_qemu->() };
5367 # deactivate volumes if start fails
5368 eval { PVE::Storage::deactivate_volumes($storecfg, $vollist); };
5369 die "start failed: $err";
5372 print "migration listens on $migrate_uri\n" if $migrate_uri;
5374 if ($statefile && $statefile ne 'tcp
' && $statefile ne 'unix
') {
5375 eval { vm_mon_cmd_nocheck($vmid, "cont"); };
5379 #start nbd server for storage migration
5380 if ($targetstorage) {
5381 my $nodename = PVE::INotify::nodename();
5382 my $migrate_network_addr = PVE::Cluster::get_local_migration_ip($migration_network);
5383 my $localip = $migrate_network_addr ? $migrate_network_addr : PVE::Cluster::remote_node_ip($nodename, 1);
5384 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5385 $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5387 vm_mon_cmd_nocheck($vmid, "nbd-server-start", addr => { type => 'inet
', data => { host => "${localip}", port => "${migrate_port}" } } );
5389 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5391 foreach my $opt (sort keys %$local_volumes) {
5392 my $volid = $local_volumes->{$opt};
5393 vm_mon_cmd_nocheck($vmid, "nbd-server-add", device => "drive-$opt", writable => JSON::true );
5394 my $migrate_storage_uri = "nbd:${localip}:${migrate_port}:exportname=drive-$opt";
5395 print "storage migration listens on $migrate_storage_uri volume:$volid\n";
5399 if ($migratedfrom) {
5401 set_migration_caps($vmid);
5406 print "spice listens on port $spice_port\n";
5407 if ($spice_ticket) {
5408 vm_mon_cmd_nocheck($vmid, "set_password", protocol => 'spice
', password => $spice_ticket);
5409 vm_mon_cmd_nocheck($vmid, "expire_password", protocol => 'spice
', time => "+30");
5414 vm_mon_cmd_nocheck($vmid, "balloon", value => $conf->{balloon}*1024*1024)
5415 if !$statefile && $conf->{balloon};
5417 foreach my $opt (keys %$conf) {
5418 next if $opt !~ m/^net\d+$/;
5419 my $nicconf = parse_net($conf->{$opt});
5420 qemu_set_link_status($vmid, $opt, 0) if $nicconf->{link_down};
5424 vm_mon_cmd_nocheck($vmid, 'qom-set
',
5425 path => "machine/peripheral/balloon0",
5426 property => "guest-stats-polling-interval",
5427 value => 2) if (!defined($conf->{balloon}) || $conf->{balloon});
5429 if ($is_suspended && (my $vmstate = $conf->{vmstate})) {
5430 print "Resumed VM, removing state\n";
5431 delete $conf->@{qw(lock vmstate runningmachine)};
5432 PVE
::Storage
::deactivate_volumes
($storecfg, [$vmstate]);
5433 PVE
::Storage
::vdisk_free
($storecfg, $vmstate);
5434 PVE
::QemuConfig-
>write_config($vmid, $conf);
5437 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'post-start');
5442 my ($vmid, $execute, %params) = @_;
5444 my $cmd = { execute
=> $execute, arguments
=> \
%params };
5445 vm_qmp_command
($vmid, $cmd);
5448 sub vm_mon_cmd_nocheck
{
5449 my ($vmid, $execute, %params) = @_;
5451 my $cmd = { execute
=> $execute, arguments
=> \
%params };
5452 vm_qmp_command
($vmid, $cmd, 1);
5455 sub vm_qmp_command
{
5456 my ($vmid, $cmd, $nocheck) = @_;
5461 if ($cmd->{arguments
} && $cmd->{arguments
}->{timeout
}) {
5462 $timeout = $cmd->{arguments
}->{timeout
};
5463 delete $cmd->{arguments
}->{timeout
};
5467 die "VM $vmid not running\n" if !check_running
($vmid, $nocheck);
5468 my $sname = qmp_socket
($vmid);
5469 if (-e
$sname) { # test if VM is reasonambe new and supports qmp/qga
5470 my $qmpclient = PVE
::QMPClient-
>new();
5472 $res = $qmpclient->cmd($vmid, $cmd, $timeout);
5474 die "unable to open monitor socket\n";
5478 syslog
("err", "VM $vmid qmp command failed - $err");
5485 sub vm_human_monitor_command
{
5486 my ($vmid, $cmdline) = @_;
5491 execute
=> 'human-monitor-command',
5492 arguments
=> { 'command-line' => $cmdline},
5495 return vm_qmp_command
($vmid, $cmd);
5498 sub vm_commandline
{
5499 my ($storecfg, $vmid, $snapname) = @_;
5501 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5504 my $snapshot = $conf->{snapshots
}->{$snapname};
5505 die "snapshot '$snapname' does not exist\n" if !defined($snapshot);
5507 $snapshot->{digest
} = $conf->{digest
}; # keep file digest for API
5512 my $defaults = load_defaults
();
5514 my $cmd = config_to_command
($storecfg, $vmid, $conf, $defaults);
5516 return PVE
::Tools
::cmd2string
($cmd);
5520 my ($vmid, $skiplock) = @_;
5522 PVE
::QemuConfig-
>lock_config($vmid, sub {
5524 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5526 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5528 vm_mon_cmd
($vmid, "system_reset");
5532 sub get_vm_volumes
{
5536 foreach_volid
($conf, sub {
5537 my ($volid, $attr) = @_;
5539 return if $volid =~ m
|^/|;
5541 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
5544 push @$vollist, $volid;
5550 sub vm_stop_cleanup
{
5551 my ($storecfg, $vmid, $conf, $keepActive, $apply_pending_changes) = @_;
5556 my $vollist = get_vm_volumes
($conf);
5557 PVE
::Storage
::deactivate_volumes
($storecfg, $vollist);
5560 foreach my $ext (qw(mon qmp pid vnc qga)) {
5561 unlink "/var/run/qemu-server/${vmid}.$ext";
5564 if ($conf->{ivshmem
}) {
5565 my $ivshmem = PVE
::JSONSchema
::parse_property_string
($ivshmem_fmt, $conf->{ivshmem
});
5566 # just delete it for now, VMs which have this already open do not
5567 # are affected, but new VMs will get a separated one. If this
5568 # becomes an issue we either add some sort of ref-counting or just
5569 # add a "don't delete on stop" flag to the ivshmem format.
5570 unlink '/dev/shm/pve-shm-' . ($ivshmem->{name
} // $vmid);
5573 foreach my $key (keys %$conf) {
5574 next if $key !~ m/^hostpci(\d+)$/;
5575 my $hostpciindex = $1;
5576 my $d = parse_hostpci
($conf->{$key});
5577 my $uuid = PVE
::SysFSTools
::generate_mdev_uuid
($vmid, $hostpciindex);
5579 foreach my $pci (@{$d->{pciid
}}) {
5580 my $pciid = $pci->{id
};
5581 PVE
::SysFSTools
::pci_cleanup_mdev_device
($pciid, $uuid);
5585 vmconfig_apply_pending
($vmid, $conf, $storecfg) if $apply_pending_changes;
5587 warn $@ if $@; # avoid errors - just warn
5590 # Note: use $nockeck to skip tests if VM configuration file exists.
5591 # We need that when migration VMs to other nodes (files already moved)
5592 # Note: we set $keepActive in vzdump stop mode - volumes need to stay active
5594 my ($storecfg, $vmid, $skiplock, $nocheck, $timeout, $shutdown, $force, $keepActive, $migratedfrom) = @_;
5596 $force = 1 if !defined($force) && !$shutdown;
5599 my $pid = check_running
($vmid, $nocheck, $migratedfrom);
5600 kill 15, $pid if $pid;
5601 my $conf = PVE
::QemuConfig-
>load_config($vmid, $migratedfrom);
5602 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 0);
5606 PVE
::QemuConfig-
>lock_config($vmid, sub {
5608 my $pid = check_running
($vmid, $nocheck);
5613 $conf = PVE
::QemuConfig-
>load_config($vmid);
5614 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5615 if (!defined($timeout) && $shutdown && $conf->{startup
}) {
5616 my $opts = PVE
::JSONSchema
::pve_parse_startup_order
($conf->{startup
});
5617 $timeout = $opts->{down
} if $opts->{down
};
5619 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'pre-stop');
5622 $timeout = 60 if !defined($timeout);
5626 if (defined($conf) && parse_guest_agent
($conf)->{enabled
}) {
5627 vm_qmp_command
($vmid, { execute
=> "guest-shutdown" }, $nocheck);
5629 vm_qmp_command
($vmid, { execute
=> "system_powerdown" }, $nocheck);
5632 vm_qmp_command
($vmid, { execute
=> "quit" }, $nocheck);
5639 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5644 if ($count >= $timeout) {
5646 warn "VM still running - terminating now with SIGTERM\n";
5649 die "VM quit/powerdown failed - got timeout\n";
5652 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5657 warn "VM quit/powerdown failed - terminating now with SIGTERM\n";
5660 die "VM quit/powerdown failed\n";
5668 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5673 if ($count >= $timeout) {
5674 warn "VM still running - terminating now with SIGKILL\n";
5679 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5684 my ($vmid, $skiplock, $includestate, $statestorage) = @_;
5691 PVE
::QemuConfig-
>lock_config($vmid, sub {
5693 $conf = PVE
::QemuConfig-
>load_config($vmid);
5695 my $is_backing_up = PVE
::QemuConfig-
>has_lock($conf, 'backup');
5696 PVE
::QemuConfig-
>check_lock($conf)
5697 if !($skiplock || $is_backing_up);
5699 die "cannot suspend to disk during backup\n"
5700 if $is_backing_up && $includestate;
5702 if ($includestate) {
5703 $conf->{lock} = 'suspending';
5704 my $date = strftime
("%Y-%m-%d", localtime(time()));
5705 $storecfg = PVE
::Storage
::config
();
5706 $vmstate = PVE
::QemuConfig-
>__snapshot_save_vmstate($vmid, $conf, "suspend-$date", $storecfg, $statestorage, 1);
5707 $path = PVE
::Storage
::path
($storecfg, $vmstate);
5708 PVE
::QemuConfig-
>write_config($vmid, $conf);
5710 vm_mon_cmd
($vmid, "stop");
5714 if ($includestate) {
5716 PVE
::Storage
::activate_volumes
($storecfg, [$vmstate]);
5719 vm_mon_cmd
($vmid, "savevm-start", statefile
=> $path);
5721 my $state = vm_mon_cmd_nocheck
($vmid, "query-savevm");
5722 if (!$state->{status
}) {
5723 die "savevm not active\n";
5724 } elsif ($state->{status
} eq 'active') {
5727 } elsif ($state->{status
} eq 'completed') {
5728 print "State saved, quitting\n";
5730 } elsif ($state->{status
} eq 'failed' && $state->{error
}) {
5731 die "query-savevm failed with error '$state->{error}'\n"
5733 die "query-savevm returned status '$state->{status}'\n";
5739 PVE
::QemuConfig-
>lock_config($vmid, sub {
5740 $conf = PVE
::QemuConfig-
>load_config($vmid);
5742 # cleanup, but leave suspending lock, to indicate something went wrong
5744 vm_mon_cmd
($vmid, "savevm-end");
5745 PVE
::Storage
::deactivate_volumes
($storecfg, [$vmstate]);
5746 PVE
::Storage
::vdisk_free
($storecfg, $vmstate);
5747 delete $conf->@{qw(vmstate runningmachine)};
5748 PVE
::QemuConfig-
>write_config($vmid, $conf);
5754 die "lock changed unexpectedly\n"
5755 if !PVE
::QemuConfig-
>has_lock($conf, 'suspending');
5757 vm_qmp_command
($vmid, { execute
=> "quit" });
5758 $conf->{lock} = 'suspended';
5759 PVE
::QemuConfig-
>write_config($vmid, $conf);
5765 my ($vmid, $skiplock, $nocheck) = @_;
5767 PVE
::QemuConfig-
>lock_config($vmid, sub {
5769 my $res = vm_mon_cmd
($vmid, 'query-status');
5770 my $resume_cmd = 'cont';
5772 if ($res->{status
} && $res->{status
} eq 'suspended') {
5773 $resume_cmd = 'system_wakeup';
5778 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5780 PVE
::QemuConfig-
>check_lock($conf)
5781 if !($skiplock || PVE
::QemuConfig-
>has_lock($conf, 'backup'));
5783 vm_mon_cmd
($vmid, $resume_cmd);
5786 vm_mon_cmd_nocheck
($vmid, $resume_cmd);
5792 my ($vmid, $skiplock, $key) = @_;
5794 PVE
::QemuConfig-
>lock_config($vmid, sub {
5796 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5798 # there is no qmp command, so we use the human monitor command
5799 vm_human_monitor_command
($vmid, "sendkey $key");
5804 my ($storecfg, $vmid, $skiplock) = @_;
5806 PVE
::QemuConfig-
>lock_config($vmid, sub {
5808 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5810 if (!check_running
($vmid)) {
5811 destroy_vm
($storecfg, $vmid, undef, $skiplock);
5813 die "VM $vmid is running - destroy failed\n";
5818 # vzdump restore implementaion
5820 sub tar_archive_read_firstfile
{
5821 my $archive = shift;
5823 die "ERROR: file '$archive' does not exist\n" if ! -f
$archive;
5825 # try to detect archive type first
5826 my $pid = open (my $fh, '-|', 'tar', 'tf', $archive) ||
5827 die "unable to open file '$archive'\n";
5828 my $firstfile = <$fh>;
5832 die "ERROR: archive contaions no data\n" if !$firstfile;
5838 sub tar_restore_cleanup
{
5839 my ($storecfg, $statfile) = @_;
5841 print STDERR
"starting cleanup\n";
5843 if (my $fd = IO
::File-
>new($statfile, "r")) {
5844 while (defined(my $line = <$fd>)) {
5845 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
5848 if ($volid =~ m
|^/|) {
5849 unlink $volid || die 'unlink failed\n';
5851 PVE
::Storage
::vdisk_free
($storecfg, $volid);
5853 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
5855 print STDERR
"unable to cleanup '$volid' - $@" if $@;
5857 print STDERR
"unable to parse line in statfile - $line";
5864 sub restore_archive
{
5865 my ($archive, $vmid, $user, $opts) = @_;
5867 my $format = $opts->{format
};
5870 if ($archive =~ m/\.tgz$/ || $archive =~ m/\.tar\.gz$/) {
5871 $format = 'tar' if !$format;
5873 } elsif ($archive =~ m/\.tar$/) {
5874 $format = 'tar' if !$format;
5875 } elsif ($archive =~ m/.tar.lzo$/) {
5876 $format = 'tar' if !$format;
5878 } elsif ($archive =~ m/\.vma$/) {
5879 $format = 'vma' if !$format;
5880 } elsif ($archive =~ m/\.vma\.gz$/) {
5881 $format = 'vma' if !$format;
5883 } elsif ($archive =~ m/\.vma\.lzo$/) {
5884 $format = 'vma' if !$format;
5887 $format = 'vma' if !$format; # default
5890 # try to detect archive format
5891 if ($format eq 'tar') {
5892 return restore_tar_archive
($archive, $vmid, $user, $opts);
5894 return restore_vma_archive
($archive, $vmid, $user, $opts, $comp);
5898 sub restore_update_config_line
{
5899 my ($outfd, $cookie, $vmid, $map, $line, $unique) = @_;
5901 return if $line =~ m/^\#qmdump\#/;
5902 return if $line =~ m/^\#vzdump\#/;
5903 return if $line =~ m/^lock:/;
5904 return if $line =~ m/^unused\d+:/;
5905 return if $line =~ m/^parent:/;
5906 return if $line =~ m/^template:/; # restored VM is never a template
5908 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
5909 if (($line =~ m/^(vlan(\d+)):\s*(\S+)\s*$/)) {
5910 # try to convert old 1.X settings
5911 my ($id, $ind, $ethcfg) = ($1, $2, $3);
5912 foreach my $devconfig (PVE
::Tools
::split_list
($ethcfg)) {
5913 my ($model, $macaddr) = split(/\=/, $devconfig);
5914 $macaddr = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if !$macaddr || $unique;
5917 bridge
=> "vmbr$ind",
5918 macaddr
=> $macaddr,
5920 my $netstr = print_net
($net);
5922 print $outfd "net$cookie->{netcount}: $netstr\n";
5923 $cookie->{netcount
}++;
5925 } elsif (($line =~ m/^(net\d+):\s*(\S+)\s*$/) && $unique) {
5926 my ($id, $netstr) = ($1, $2);
5927 my $net = parse_net
($netstr);
5928 $net->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if $net->{macaddr
};
5929 $netstr = print_net
($net);
5930 print $outfd "$id: $netstr\n";
5931 } elsif ($line =~ m/^((ide|scsi|virtio|sata|efidisk)\d+):\s*(\S+)\s*$/) {
5934 my $di = parse_drive
($virtdev, $value);
5935 if (defined($di->{backup
}) && !$di->{backup
}) {
5936 print $outfd "#$line";
5937 } elsif ($map->{$virtdev}) {
5938 delete $di->{format
}; # format can change on restore
5939 $di->{file
} = $map->{$virtdev};
5940 $value = print_drive
($vmid, $di);
5941 print $outfd "$virtdev: $value\n";
5945 } elsif (($line =~ m/^vmgenid: (.*)/)) {
5947 if ($vmgenid ne '0') {
5948 # always generate a new vmgenid if there was a valid one setup
5949 $vmgenid = generate_uuid
();
5951 print $outfd "vmgenid: $vmgenid\n";
5952 } elsif (($line =~ m/^(smbios1: )(.*)/) && $unique) {
5953 my ($uuid, $uuid_str);
5954 UUID
::generate
($uuid);
5955 UUID
::unparse
($uuid, $uuid_str);
5956 my $smbios1 = parse_smbios1
($2);
5957 $smbios1->{uuid
} = $uuid_str;
5958 print $outfd $1.print_smbios1
($smbios1)."\n";
5965 my ($cfg, $vmid) = @_;
5967 my $info = PVE
::Storage
::vdisk_list
($cfg, undef, $vmid);
5969 my $volid_hash = {};
5970 foreach my $storeid (keys %$info) {
5971 foreach my $item (@{$info->{$storeid}}) {
5972 next if !($item->{volid
} && $item->{size
});
5973 $item->{path
} = PVE
::Storage
::path
($cfg, $item->{volid
});
5974 $volid_hash->{$item->{volid
}} = $item;
5981 sub is_volume_in_use
{
5982 my ($storecfg, $conf, $skip_drive, $volid) = @_;
5984 my $path = PVE
::Storage
::path
($storecfg, $volid);
5986 my $scan_config = sub {
5987 my ($cref, $snapname) = @_;
5989 foreach my $key (keys %$cref) {
5990 my $value = $cref->{$key};
5991 if (is_valid_drivename
($key)) {
5992 next if $skip_drive && $key eq $skip_drive;
5993 my $drive = parse_drive
($key, $value);
5994 next if !$drive || !$drive->{file
} || drive_is_cdrom
($drive);
5995 return 1 if $volid eq $drive->{file
};
5996 if ($drive->{file
} =~ m!^/!) {
5997 return 1 if $drive->{file
} eq $path;
5999 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
}, 1);
6001 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid, 1);
6003 return 1 if $path eq PVE
::Storage
::path
($storecfg, $drive->{file
}, $snapname);
6011 return 1 if &$scan_config($conf);
6015 foreach my $snapname (keys %{$conf->{snapshots
}}) {
6016 return 1 if &$scan_config($conf->{snapshots
}->{$snapname}, $snapname);
6022 sub update_disksize
{
6023 my ($vmid, $conf, $volid_hash) = @_;
6026 my $prefix = "VM $vmid:";
6028 # used and unused disks
6029 my $referenced = {};
6031 # Note: it is allowed to define multiple storages with same path (alias), so
6032 # we need to check both 'volid' and real 'path' (two different volid can point
6033 # to the same path).
6035 my $referencedpath = {};
6038 foreach my $opt (keys %$conf) {
6039 if (is_valid_drivename
($opt)) {
6040 my $drive = parse_drive
($opt, $conf->{$opt});
6041 my $volid = $drive->{file
};
6044 $referenced->{$volid} = 1;
6045 if ($volid_hash->{$volid} &&
6046 (my $path = $volid_hash->{$volid}->{path
})) {
6047 $referencedpath->{$path} = 1;
6050 next if drive_is_cdrom
($drive);
6051 next if !$volid_hash->{$volid};
6053 $drive->{size
} = $volid_hash->{$volid}->{size
};
6054 my $new = print_drive
($vmid, $drive);
6055 if ($new ne $conf->{$opt}) {
6057 $conf->{$opt} = $new;
6058 print "$prefix update disk '$opt' information.\n";
6063 # remove 'unusedX' entry if volume is used
6064 foreach my $opt (keys %$conf) {
6065 next if $opt !~ m/^unused\d+$/;
6066 my $volid = $conf->{$opt};
6067 my $path = $volid_hash->{$volid}->{path
} if $volid_hash->{$volid};
6068 if ($referenced->{$volid} || ($path && $referencedpath->{$path})) {
6069 print "$prefix remove entry '$opt', its volume '$volid' is in use.\n";
6071 delete $conf->{$opt};
6074 $referenced->{$volid} = 1;
6075 $referencedpath->{$path} = 1 if $path;
6078 foreach my $volid (sort keys %$volid_hash) {
6079 next if $volid =~ m/vm-$vmid-state-/;
6080 next if $referenced->{$volid};
6081 my $path = $volid_hash->{$volid}->{path
};
6082 next if !$path; # just to be sure
6083 next if $referencedpath->{$path};
6085 my $key = PVE
::QemuConfig-
>add_unused_volume($conf, $volid);
6086 print "$prefix add unreferenced volume '$volid' as '$key' to config.\n";
6087 $referencedpath->{$path} = 1; # avoid to add more than once (aliases)
6094 my ($vmid, $nolock, $dryrun) = @_;
6096 my $cfg = PVE
::Storage
::config
();
6098 # FIXME: Remove once our RBD plugin can handle CT and VM on a single storage
6099 # see: https://pve.proxmox.com/pipermail/pve-devel/2018-July/032900.html
6100 foreach my $stor (keys %{$cfg->{ids
}}) {
6101 delete($cfg->{ids
}->{$stor}) if ! $cfg->{ids
}->{$stor}->{content
}->{images
};
6104 print "rescan volumes...\n";
6105 my $volid_hash = scan_volids
($cfg, $vmid);
6107 my $updatefn = sub {
6110 my $conf = PVE
::QemuConfig-
>load_config($vmid);
6112 PVE
::QemuConfig-
>check_lock($conf);
6115 foreach my $volid (keys %$volid_hash) {
6116 my $info = $volid_hash->{$volid};
6117 $vm_volids->{$volid} = $info if $info->{vmid
} && $info->{vmid
} == $vmid;
6120 my $changes = update_disksize
($vmid, $conf, $vm_volids);
6122 PVE
::QemuConfig-
>write_config($vmid, $conf) if $changes && !$dryrun;
6125 if (defined($vmid)) {
6129 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6132 my $vmlist = config_list
();
6133 foreach my $vmid (keys %$vmlist) {
6137 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6143 sub restore_vma_archive
{
6144 my ($archive, $vmid, $user, $opts, $comp) = @_;
6146 my $readfrom = $archive;
6148 my $cfg = PVE
::Storage
::config
();
6150 my $bwlimit = $opts->{bwlimit
};
6152 my $dbg_cmdstring = '';
6153 my $add_pipe = sub {
6155 push @$commands, $cmd;
6156 $dbg_cmdstring .= ' | ' if length($dbg_cmdstring);
6157 $dbg_cmdstring .= PVE
::Tools
::cmd2string
($cmd);
6162 if ($archive eq '-') {
6165 # If we use a backup from a PVE defined storage we also consider that
6166 # storage's rate limit:
6167 my (undef, $volid) = PVE
::Storage
::path_to_volume_id
($cfg, $archive);
6168 if (defined($volid)) {
6169 my ($sid, undef) = PVE
::Storage
::parse_volume_id
($volid);
6170 my $readlimit = PVE
::Storage
::get_bandwidth_limit
('restore', [$sid], $bwlimit);
6172 print STDERR
"applying read rate limit: $readlimit\n";
6173 my $cstream = ['cstream', '-t', $readlimit*1024, '--', $readfrom];
6174 $add_pipe->($cstream);
6181 if ($comp eq 'gzip') {
6182 $cmd = ['zcat', $readfrom];
6183 } elsif ($comp eq 'lzop') {
6184 $cmd = ['lzop', '-d', '-c', $readfrom];
6186 die "unknown compression method '$comp'\n";
6191 my $tmpdir = "/var/tmp/vzdumptmp$$";
6194 # disable interrupts (always do cleanups)
6198 local $SIG{HUP
} = sub { warn "got interrupt - ignored\n"; };
6200 my $mapfifo = "/var/tmp/vzdumptmp$$.fifo";
6201 POSIX
::mkfifo
($mapfifo, 0600);
6204 my $openfifo = sub {
6205 open($fifofh, '>', $mapfifo) || die $!;
6208 $add_pipe->(['vma', 'extract', '-v', '-r', $mapfifo, $readfrom, $tmpdir]);
6215 my $rpcenv = PVE
::RPCEnvironment
::get
();
6217 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6218 my $tmpfn = "$conffile.$$.tmp";
6220 # Note: $oldconf is undef if VM does not exists
6221 my $cfs_path = PVE
::QemuConfig-
>cfs_config_path($vmid);
6222 my $oldconf = PVE
::Cluster
::cfs_read_file
($cfs_path);
6226 my $print_devmap = sub {
6227 my $virtdev_hash = {};
6229 my $cfgfn = "$tmpdir/qemu-server.conf";
6231 # we can read the config - that is already extracted
6232 my $fh = IO
::File-
>new($cfgfn, "r") ||
6233 "unable to read qemu-server.conf - $!\n";
6235 my $fwcfgfn = "$tmpdir/qemu-server.fw";
6237 my $pve_firewall_dir = '/etc/pve/firewall';
6238 mkdir $pve_firewall_dir; # make sure the dir exists
6239 PVE
::Tools
::file_copy
($fwcfgfn, "${pve_firewall_dir}/$vmid.fw");
6242 while (defined(my $line = <$fh>)) {
6243 if ($line =~ m/^\#qmdump\#map:(\S+):(\S+):(\S*):(\S*):$/) {
6244 my ($virtdev, $devname, $storeid, $format) = ($1, $2, $3, $4);
6245 die "archive does not contain data for drive '$virtdev'\n"
6246 if !$devinfo->{$devname};
6247 if (defined($opts->{storage
})) {
6248 $storeid = $opts->{storage
} || 'local';
6249 } elsif (!$storeid) {
6252 $format = 'raw' if !$format;
6253 $devinfo->{$devname}->{devname
} = $devname;
6254 $devinfo->{$devname}->{virtdev
} = $virtdev;
6255 $devinfo->{$devname}->{format
} = $format;
6256 $devinfo->{$devname}->{storeid
} = $storeid;
6258 # check permission on storage
6259 my $pool = $opts->{pool
}; # todo: do we need that?
6260 if ($user ne 'root@pam') {
6261 $rpcenv->check($user, "/storage/$storeid", ['Datastore.AllocateSpace']);
6264 $storage_limits{$storeid} = $bwlimit;
6266 $virtdev_hash->{$virtdev} = $devinfo->{$devname};
6270 foreach my $key (keys %storage_limits) {
6271 my $limit = PVE
::Storage
::get_bandwidth_limit
('restore', [$key], $bwlimit);
6273 print STDERR
"rate limit for storage $key: $limit KiB/s\n";
6274 $storage_limits{$key} = $limit * 1024;
6277 foreach my $devname (keys %$devinfo) {
6278 die "found no device mapping information for device '$devname'\n"
6279 if !$devinfo->{$devname}->{virtdev
};
6282 # create empty/temp config
6284 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
6285 foreach_drive
($oldconf, sub {
6286 my ($ds, $drive) = @_;
6288 return if drive_is_cdrom
($drive);
6290 my $volid = $drive->{file
};
6292 return if !$volid || $volid =~ m
|^/|;
6294 my ($path, $owner) = PVE
::Storage
::path
($cfg, $volid);
6295 return if !$path || !$owner || ($owner != $vmid);
6297 # Note: only delete disk we want to restore
6298 # other volumes will become unused
6299 if ($virtdev_hash->{$ds}) {
6300 eval { PVE
::Storage
::vdisk_free
($cfg, $volid); };
6307 # delete vmstate files
6308 # since after the restore we have no snapshots anymore
6309 foreach my $snapname (keys %{$oldconf->{snapshots
}}) {
6310 my $snap = $oldconf->{snapshots
}->{$snapname};
6311 if ($snap->{vmstate
}) {
6312 eval { PVE
::Storage
::vdisk_free
($cfg, $snap->{vmstate
}); };
6321 foreach my $virtdev (sort keys %$virtdev_hash) {
6322 my $d = $virtdev_hash->{$virtdev};
6323 my $alloc_size = int(($d->{size
} + 1024 - 1)/1024);
6324 my $storeid = $d->{storeid
};
6325 my $scfg = PVE
::Storage
::storage_config
($cfg, $storeid);
6328 if (my $limit = $storage_limits{$storeid}) {
6329 $map_opts .= "throttling.bps=$limit:throttling.group=$storeid:";
6332 # test if requested format is supported
6333 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($cfg, $storeid);
6334 my $supported = grep { $_ eq $d->{format
} } @$validFormats;
6335 $d->{format
} = $defFormat if !$supported;
6337 my $volid = PVE
::Storage
::vdisk_alloc
($cfg, $storeid, $vmid,
6338 $d->{format
}, undef, $alloc_size);
6339 print STDERR
"new volume ID is '$volid'\n";
6340 $d->{volid
} = $volid;
6341 my $path = PVE
::Storage
::path
($cfg, $volid);
6343 PVE
::Storage
::activate_volumes
($cfg,[$volid]);
6345 my $write_zeros = 1;
6346 if (PVE
::Storage
::volume_has_feature
($cfg, 'sparseinit', $volid)) {
6350 print $fifofh "${map_opts}format=$d->{format}:${write_zeros}:$d->{devname}=$path\n";
6352 print "map '$d->{devname}' to '$path' (write zeros = ${write_zeros})\n";
6353 $map->{$virtdev} = $volid;
6356 $fh->seek(0, 0) || die "seek failed - $!\n";
6358 my $outfd = new IO
::File
($tmpfn, "w") ||
6359 die "unable to write config for VM $vmid\n";
6361 my $cookie = { netcount
=> 0 };
6362 while (defined(my $line = <$fh>)) {
6363 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6376 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6377 local $SIG{ALRM
} = sub { die "got timeout\n"; };
6379 $oldtimeout = alarm($timeout);
6386 if ($line =~ m/^DEV:\sdev_id=(\d+)\ssize:\s(\d+)\sdevname:\s(\S+)$/) {
6387 my ($dev_id, $size, $devname) = ($1, $2, $3);
6388 $devinfo->{$devname} = { size
=> $size, dev_id
=> $dev_id };
6389 } elsif ($line =~ m/^CTIME: /) {
6390 # we correctly received the vma config, so we can disable
6391 # the timeout now for disk allocation (set to 10 minutes, so
6392 # that we always timeout if something goes wrong)
6395 print $fifofh "done\n";
6396 my $tmp = $oldtimeout || 0;
6397 $oldtimeout = undef;
6403 print "restore vma archive: $dbg_cmdstring\n";
6404 run_command
($commands, input
=> $input, outfunc
=> $parser, afterfork
=> $openfifo);
6408 alarm($oldtimeout) if $oldtimeout;
6411 foreach my $devname (keys %$devinfo) {
6412 my $volid = $devinfo->{$devname}->{volid
};
6413 push @$vollist, $volid if $volid;
6416 PVE
::Storage
::deactivate_volumes
($cfg, $vollist);
6424 foreach my $devname (keys %$devinfo) {
6425 my $volid = $devinfo->{$devname}->{volid
};
6428 if ($volid =~ m
|^/|) {
6429 unlink $volid || die 'unlink failed\n';
6431 PVE
::Storage
::vdisk_free
($cfg, $volid);
6433 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
6435 print STDERR
"unable to cleanup '$volid' - $@" if $@;
6442 rename($tmpfn, $conffile) ||
6443 die "unable to commit configuration file '$conffile'\n";
6445 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6447 eval { rescan
($vmid, 1); };
6451 sub restore_tar_archive
{
6452 my ($archive, $vmid, $user, $opts) = @_;
6454 if ($archive ne '-') {
6455 my $firstfile = tar_archive_read_firstfile
($archive);
6456 die "ERROR: file '$archive' dos not lock like a QemuServer vzdump backup\n"
6457 if $firstfile ne 'qemu-server.conf';
6460 my $storecfg = PVE
::Storage
::config
();
6462 # destroy existing data - keep empty config
6463 my $vmcfgfn = PVE
::QemuConfig-
>config_file($vmid);
6464 destroy_vm
($storecfg, $vmid, 1) if -f
$vmcfgfn;
6466 my $tocmd = "/usr/lib/qemu-server/qmextract";
6468 $tocmd .= " --storage " . PVE
::Tools
::shellquote
($opts->{storage
}) if $opts->{storage
};
6469 $tocmd .= " --pool " . PVE
::Tools
::shellquote
($opts->{pool
}) if $opts->{pool
};
6470 $tocmd .= ' --prealloc' if $opts->{prealloc
};
6471 $tocmd .= ' --info' if $opts->{info
};
6473 # tar option "xf" does not autodetect compression when read from STDIN,
6474 # so we pipe to zcat
6475 my $cmd = "zcat -f|tar xf " . PVE
::Tools
::shellquote
($archive) . " " .
6476 PVE
::Tools
::shellquote
("--to-command=$tocmd");
6478 my $tmpdir = "/var/tmp/vzdumptmp$$";
6481 local $ENV{VZDUMP_TMPDIR
} = $tmpdir;
6482 local $ENV{VZDUMP_VMID
} = $vmid;
6483 local $ENV{VZDUMP_USER
} = $user;
6485 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6486 my $tmpfn = "$conffile.$$.tmp";
6488 # disable interrupts (always do cleanups)
6492 local $SIG{HUP
} = sub { print STDERR
"got interrupt - ignored\n"; };
6500 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6502 if ($archive eq '-') {
6503 print "extracting archive from STDIN\n";
6504 run_command
($cmd, input
=> "<&STDIN");
6506 print "extracting archive '$archive'\n";
6510 return if $opts->{info
};
6514 my $statfile = "$tmpdir/qmrestore.stat";
6515 if (my $fd = IO
::File-
>new($statfile, "r")) {
6516 while (defined (my $line = <$fd>)) {
6517 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
6518 $map->{$1} = $2 if $1;
6520 print STDERR
"unable to parse line in statfile - $line\n";
6526 my $confsrc = "$tmpdir/qemu-server.conf";
6528 my $srcfd = new IO
::File
($confsrc, "r") ||
6529 die "unable to open file '$confsrc'\n";
6531 my $outfd = new IO
::File
($tmpfn, "w") ||
6532 die "unable to write config for VM $vmid\n";
6534 my $cookie = { netcount
=> 0 };
6535 while (defined (my $line = <$srcfd>)) {
6536 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6548 tar_restore_cleanup
($storecfg, "$tmpdir/qmrestore.stat") if !$opts->{info
};
6555 rename $tmpfn, $conffile ||
6556 die "unable to commit configuration file '$conffile'\n";
6558 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6560 eval { rescan
($vmid, 1); };
6564 sub foreach_storage_used_by_vm
{
6565 my ($conf, $func) = @_;
6569 foreach_drive
($conf, sub {
6570 my ($ds, $drive) = @_;
6571 return if drive_is_cdrom
($drive);
6573 my $volid = $drive->{file
};
6575 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
6576 $sidhash->{$sid} = $sid if $sid;
6579 foreach my $sid (sort keys %$sidhash) {
6584 sub do_snapshots_with_qemu
{
6585 my ($storecfg, $volid) = @_;
6587 my $storage_name = PVE
::Storage
::parse_volume_id
($volid);
6589 if ($qemu_snap_storage->{$storecfg->{ids
}->{$storage_name}->{type
}}
6590 && !$storecfg->{ids
}->{$storage_name}->{krbd
}){
6594 if ($volid =~ m/\.(qcow2|qed)$/){
6601 sub qga_check_running
{
6602 my ($vmid, $nowarn) = @_;
6604 eval { vm_mon_cmd
($vmid, "guest-ping", timeout
=> 3); };
6606 warn "Qemu Guest Agent is not running - $@" if !$nowarn;
6612 sub template_create
{
6613 my ($vmid, $conf, $disk) = @_;
6615 my $storecfg = PVE
::Storage
::config
();
6617 foreach_drive
($conf, sub {
6618 my ($ds, $drive) = @_;
6620 return if drive_is_cdrom
($drive);
6621 return if $disk && $ds ne $disk;
6623 my $volid = $drive->{file
};
6624 return if !PVE
::Storage
::volume_has_feature
($storecfg, 'template', $volid);
6626 my $voliddst = PVE
::Storage
::vdisk_create_base
($storecfg, $volid);
6627 $drive->{file
} = $voliddst;
6628 $conf->{$ds} = print_drive
($vmid, $drive);
6629 PVE
::QemuConfig-
>write_config($vmid, $conf);
6633 sub convert_iscsi_path
{
6636 if ($path =~ m
|^iscsi
://([^/]+)/([^/]+)/(.+)$|) {
6641 my $initiator_name = get_initiator_name
();
6643 return "file.driver=iscsi,file.transport=tcp,file.initiator-name=$initiator_name,".
6644 "file.portal=$portal,file.target=$target,file.lun=$lun,driver=raw";
6647 die "cannot convert iscsi path '$path', unkown format\n";
6650 sub qemu_img_convert
{
6651 my ($src_volid, $dst_volid, $size, $snapname, $is_zero_initialized) = @_;
6653 my $storecfg = PVE
::Storage
::config
();
6654 my ($src_storeid, $src_volname) = PVE
::Storage
::parse_volume_id
($src_volid, 1);
6655 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid, 1);
6657 if ($src_storeid && $dst_storeid) {
6659 PVE
::Storage
::activate_volumes
($storecfg, [$src_volid], $snapname);
6661 my $src_scfg = PVE
::Storage
::storage_config
($storecfg, $src_storeid);
6662 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6664 my $src_format = qemu_img_format
($src_scfg, $src_volname);
6665 my $dst_format = qemu_img_format
($dst_scfg, $dst_volname);
6667 my $src_path = PVE
::Storage
::path
($storecfg, $src_volid, $snapname);
6668 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6670 my $src_is_iscsi = ($src_path =~ m
|^iscsi
://|);
6671 my $dst_is_iscsi = ($dst_path =~ m
|^iscsi
://|);
6674 push @$cmd, '/usr/bin/qemu-img', 'convert', '-p', '-n';
6675 push @$cmd, '-l', "snapshot.name=$snapname" if($snapname && $src_format eq "qcow2");
6676 push @$cmd, '-t', 'none' if $dst_scfg->{type
} eq 'zfspool';
6677 push @$cmd, '-T', 'none' if $src_scfg->{type
} eq 'zfspool';
6679 if ($src_is_iscsi) {
6680 push @$cmd, '--image-opts';
6681 $src_path = convert_iscsi_path
($src_path);
6683 push @$cmd, '-f', $src_format;
6686 if ($dst_is_iscsi) {
6687 push @$cmd, '--target-image-opts';
6688 $dst_path = convert_iscsi_path
($dst_path);
6690 push @$cmd, '-O', $dst_format;
6693 push @$cmd, $src_path;
6695 if (!$dst_is_iscsi && $is_zero_initialized) {
6696 push @$cmd, "zeroinit:$dst_path";
6698 push @$cmd, $dst_path;
6703 if($line =~ m/\((\S+)\/100\
%\)/){
6705 my $transferred = int($size * $percent / 100);
6706 my $remaining = $size - $transferred;
6708 print "transferred: $transferred bytes remaining: $remaining bytes total: $size bytes progression: $percent %\n";
6713 eval { run_command
($cmd, timeout
=> undef, outfunc
=> $parser); };
6715 die "copy failed: $err" if $err;
6719 sub qemu_img_format
{
6720 my ($scfg, $volname) = @_;
6722 if ($scfg->{path
} && $volname =~ m/\.($QEMU_FORMAT_RE)$/) {
6729 sub qemu_drive_mirror
{
6730 my ($vmid, $drive, $dst_volid, $vmiddst, $is_zero_initialized, $jobs, $skipcomplete, $qga) = @_;
6732 $jobs = {} if !$jobs;
6736 $jobs->{"drive-$drive"} = {};
6738 if ($dst_volid =~ /^nbd:/) {
6739 $qemu_target = $dst_volid;
6742 my $storecfg = PVE
::Storage
::config
();
6743 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid);
6745 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6747 $format = qemu_img_format
($dst_scfg, $dst_volname);
6749 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6751 $qemu_target = $is_zero_initialized ?
"zeroinit:$dst_path" : $dst_path;
6754 my $opts = { timeout
=> 10, device
=> "drive-$drive", mode
=> "existing", sync
=> "full", target
=> $qemu_target };
6755 $opts->{format
} = $format if $format;
6757 print "drive mirror is starting for drive-$drive\n";
6759 eval { vm_mon_cmd
($vmid, "drive-mirror", %$opts); }; #if a job already run for this device,it's throw an error
6762 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6763 die "mirroring error: $err";
6766 qemu_drive_mirror_monitor
($vmid, $vmiddst, $jobs, $skipcomplete, $qga);
6769 sub qemu_drive_mirror_monitor
{
6770 my ($vmid, $vmiddst, $jobs, $skipcomplete, $qga) = @_;
6773 my $err_complete = 0;
6776 die "storage migration timed out\n" if $err_complete > 300;
6778 my $stats = vm_mon_cmd
($vmid, "query-block-jobs");
6780 my $running_mirror_jobs = {};
6781 foreach my $stat (@$stats) {
6782 next if $stat->{type
} ne 'mirror';
6783 $running_mirror_jobs->{$stat->{device
}} = $stat;
6786 my $readycounter = 0;
6788 foreach my $job (keys %$jobs) {
6790 if(defined($jobs->{$job}->{complete
}) && !defined($running_mirror_jobs->{$job})) {
6791 print "$job : finished\n";
6792 delete $jobs->{$job};
6796 die "$job: mirroring has been cancelled\n" if !defined($running_mirror_jobs->{$job});
6798 my $busy = $running_mirror_jobs->{$job}->{busy
};
6799 my $ready = $running_mirror_jobs->{$job}->{ready
};
6800 if (my $total = $running_mirror_jobs->{$job}->{len
}) {
6801 my $transferred = $running_mirror_jobs->{$job}->{offset
} || 0;
6802 my $remaining = $total - $transferred;
6803 my $percent = sprintf "%.2f", ($transferred * 100 / $total);
6805 print "$job: transferred: $transferred bytes remaining: $remaining bytes total: $total bytes progression: $percent % busy: $busy ready: $ready \n";
6808 $readycounter++ if $running_mirror_jobs->{$job}->{ready
};
6811 last if scalar(keys %$jobs) == 0;
6813 if ($readycounter == scalar(keys %$jobs)) {
6814 print "all mirroring jobs are ready \n";
6815 last if $skipcomplete; #do the complete later
6817 if ($vmiddst && $vmiddst != $vmid) {
6818 my $agent_running = $qga && qga_check_running
($vmid);
6819 if ($agent_running) {
6820 print "freeze filesystem\n";
6821 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "guest-fsfreeze-freeze"); };
6823 print "suspend vm\n";
6824 eval { PVE
::QemuServer
::vm_suspend
($vmid, 1); };
6827 # if we clone a disk for a new target vm, we don't switch the disk
6828 PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs);
6830 if ($agent_running) {
6831 print "unfreeze filesystem\n";
6832 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "guest-fsfreeze-thaw"); };
6834 print "resume vm\n";
6835 eval { PVE
::QemuServer
::vm_resume
($vmid, 1, 1); };
6841 foreach my $job (keys %$jobs) {
6842 # try to switch the disk if source and destination are on the same guest
6843 print "$job: Completing block job...\n";
6845 eval { vm_mon_cmd
($vmid, "block-job-complete", device
=> $job) };
6846 if ($@ =~ m/cannot be completed/) {
6847 print "$job: Block job cannot be completed, try again.\n";
6850 print "$job: Completed successfully.\n";
6851 $jobs->{$job}->{complete
} = 1;
6862 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6863 die "mirroring error: $err";
6868 sub qemu_blockjobs_cancel
{
6869 my ($vmid, $jobs) = @_;
6871 foreach my $job (keys %$jobs) {
6872 print "$job: Cancelling block job\n";
6873 eval { vm_mon_cmd
($vmid, "block-job-cancel", device
=> $job); };
6874 $jobs->{$job}->{cancel
} = 1;
6878 my $stats = vm_mon_cmd
($vmid, "query-block-jobs");
6880 my $running_jobs = {};
6881 foreach my $stat (@$stats) {
6882 $running_jobs->{$stat->{device
}} = $stat;
6885 foreach my $job (keys %$jobs) {
6887 if (defined($jobs->{$job}->{cancel
}) && !defined($running_jobs->{$job})) {
6888 print "$job: Done.\n";
6889 delete $jobs->{$job};
6893 last if scalar(keys %$jobs) == 0;
6900 my ($storecfg, $vmid, $running, $drivename, $drive, $snapname,
6901 $newvmid, $storage, $format, $full, $newvollist, $jobs, $skipcomplete, $qga) = @_;
6906 print "create linked clone of drive $drivename ($drive->{file})\n";
6907 $newvolid = PVE
::Storage
::vdisk_clone
($storecfg, $drive->{file
}, $newvmid, $snapname);
6908 push @$newvollist, $newvolid;
6911 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
});
6912 $storeid = $storage if $storage;
6914 my $dst_format = resolve_dst_disk_format
($storecfg, $storeid, $volname, $format);
6915 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $drive->{file
}, 3);
6917 print "create full clone of drive $drivename ($drive->{file})\n";
6919 if (drive_is_cloudinit
($drive)) {
6920 $name = "vm-$newvmid-cloudinit";
6922 # cloudinit only supports raw and qcow2 atm:
6923 if ($dst_format eq 'qcow2') {
6925 } elsif ($dst_format ne 'raw') {
6926 die "clone: unhandled format for cloudinit image\n";
6929 $newvolid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $newvmid, $dst_format, $name, ($size/1024));
6930 push @$newvollist, $newvolid;
6932 PVE
::Storage
::activate_volumes
($storecfg, [$newvolid]);
6934 my $sparseinit = PVE
::Storage
::volume_has_feature
($storecfg, 'sparseinit', $newvolid);
6935 if (!$running || $snapname) {
6936 qemu_img_convert
($drive->{file
}, $newvolid, $size, $snapname, $sparseinit);
6939 my $kvmver = get_running_qemu_version
($vmid);
6940 if (!qemu_machine_feature_enabled
(undef, $kvmver, 2, 7)) {
6941 die "drive-mirror with iothread requires qemu version 2.7 or higher\n"
6942 if $drive->{iothread
};
6945 qemu_drive_mirror
($vmid, $drivename, $newvolid, $newvmid, $sparseinit, $jobs, $skipcomplete, $qga);
6949 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $newvolid, 3);
6952 $disk->{format
} = undef;
6953 $disk->{file
} = $newvolid;
6954 $disk->{size
} = $size;
6959 # this only works if VM is running
6960 sub get_current_qemu_machine
{
6963 my $cmd = { execute
=> 'query-machines', arguments
=> {} };
6964 my $res = vm_qmp_command
($vmid, $cmd);
6966 my ($current, $default);
6967 foreach my $e (@$res) {
6968 $default = $e->{name
} if $e->{'is-default'};
6969 $current = $e->{name
} if $e->{'is-current'};
6972 # fallback to the default machine if current is not supported by qemu
6973 return $current || $default || 'pc';
6976 sub get_running_qemu_version
{
6978 my $cmd = { execute
=> 'query-version', arguments
=> {} };
6979 my $res = vm_qmp_command
($vmid, $cmd);
6980 return "$res->{qemu}->{major}.$res->{qemu}->{minor}";
6983 sub qemu_machine_feature_enabled
{
6984 my ($machine, $kvmver, $version_major, $version_minor) = @_;
6989 if ($machine && $machine =~ m/^((?:pc(-i440fx|-q35)?|virt)-(\d+)\.(\d+))/) {
6991 $current_major = $3;
6992 $current_minor = $4;
6994 } elsif ($kvmver =~ m/^(\d+)\.(\d+)/) {
6996 $current_major = $1;
6997 $current_minor = $2;
7000 return 1 if $current_major > $version_major ||
7001 ($current_major == $version_major &&
7002 $current_minor >= $version_minor);
7005 sub qemu_machine_pxe
{
7006 my ($vmid, $conf, $machine) = @_;
7008 $machine = PVE
::QemuServer
::get_current_qemu_machine
($vmid) if !$machine;
7010 if ($conf->{machine
} && $conf->{machine
} =~ m/\.pxe$/) {
7017 sub qemu_use_old_bios_files
{
7018 my ($machine_type) = @_;
7020 return if !$machine_type;
7022 my $use_old_bios_files = undef;
7024 if ($machine_type =~ m/^(\S+)\.pxe$/) {
7026 $use_old_bios_files = 1;
7028 my $kvmver = kvm_user_version
();
7029 # Note: kvm version < 2.4 use non-efi pxe files, and have problems when we
7030 # load new efi bios files on migration. So this hack is required to allow
7031 # live migration from qemu-2.2 to qemu-2.4, which is sometimes used when
7032 # updrading from proxmox-ve-3.X to proxmox-ve 4.0
7033 $use_old_bios_files = !qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 4);
7036 return ($use_old_bios_files, $machine_type);
7039 sub create_efidisk
($$$$$) {
7040 my ($storecfg, $storeid, $vmid, $fmt, $arch) = @_;
7042 my (undef, $ovmf_vars) = get_ovmf_files
($arch);
7043 die "EFI vars default image not found\n" if ! -f
$ovmf_vars;
7045 my $vars_size = PVE
::Tools
::convert_size
(-s
$ovmf_vars, 'b' => 'kb');
7046 my $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $vmid, $fmt, undef, $vars_size);
7047 PVE
::Storage
::activate_volumes
($storecfg, [$volid]);
7049 my $path = PVE
::Storage
::path
($storecfg, $volid);
7051 run_command
(['/usr/bin/qemu-img', 'convert', '-n', '-f', 'raw', '-O', $fmt, $ovmf_vars, $path]);
7053 die "Copying EFI vars image failed: $@" if $@;
7055 return ($volid, $vars_size);
7058 sub vm_iothreads_list
{
7061 my $res = vm_mon_cmd
($vmid, 'query-iothreads');
7064 foreach my $iothread (@$res) {
7065 $iothreads->{ $iothread->{id
} } = $iothread->{"thread-id"};
7072 my ($conf, $drive) = @_;
7076 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)) {
7078 } elsif ($conf->{scsihw
} && ($conf->{scsihw
} eq 'virtio-scsi-single')) {
7084 my $controller = int($drive->{index} / $maxdev);
7085 my $controller_prefix = ($conf->{scsihw
} && $conf->{scsihw
} eq 'virtio-scsi-single') ?
"virtioscsi" : "scsihw";
7087 return ($maxdev, $controller, $controller_prefix);
7090 sub add_hyperv_enlightenments
{
7091 my ($cpuFlags, $winversion, $machine_type, $kvmver, $bios, $gpu_passthrough, $hv_vendor_id) = @_;
7093 return if $winversion < 6;
7094 return if $bios && $bios eq 'ovmf' && $winversion < 8;
7096 if ($gpu_passthrough || defined($hv_vendor_id)) {
7097 $hv_vendor_id //= 'proxmox';
7098 push @$cpuFlags , "hv_vendor_id=$hv_vendor_id";
7101 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
7102 push @$cpuFlags , 'hv_spinlocks=0x1fff';
7103 push @$cpuFlags , 'hv_vapic';
7104 push @$cpuFlags , 'hv_time';
7106 push @$cpuFlags , 'hv_spinlocks=0xffff';
7109 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 6)) {
7110 push @$cpuFlags , 'hv_reset';
7111 push @$cpuFlags , 'hv_vpindex';
7112 push @$cpuFlags , 'hv_runtime';
7115 if ($winversion >= 7) {
7116 push @$cpuFlags , 'hv_relaxed';
7118 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 12)) {
7119 push @$cpuFlags , 'hv_synic';
7120 push @$cpuFlags , 'hv_stimer';
7125 sub windows_version
{
7128 return 0 if !$ostype;
7132 if($ostype eq 'wxp' || $ostype eq 'w2k3' || $ostype eq 'w2k') {
7134 } elsif($ostype eq 'w2k8' || $ostype eq 'wvista') {
7136 } elsif ($ostype =~ m/^win(\d+)$/) {
7143 sub resolve_dst_disk_format
{
7144 my ($storecfg, $storeid, $src_volname, $format) = @_;
7145 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($storecfg, $storeid);
7148 # if no target format is specified, use the source disk format as hint
7150 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
7151 $format = qemu_img_format
($scfg, $src_volname);
7157 # test if requested format is supported - else use default
7158 my $supported = grep { $_ eq $format } @$validFormats;
7159 $format = $defFormat if !$supported;
7163 sub resolve_first_disk
{
7165 my @disks = PVE
::QemuServer
::valid_drive_names
();
7167 foreach my $ds (reverse @disks) {
7168 next if !$conf->{$ds};
7169 my $disk = PVE
::QemuServer
::parse_drive
($ds, $conf->{$ds});
7170 next if PVE
::QemuServer
::drive_is_cdrom
($disk);
7177 my ($uuid, $uuid_str);
7178 UUID
::generate
($uuid);
7179 UUID
::unparse
($uuid, $uuid_str);
7183 sub generate_smbios1_uuid
{
7184 return "uuid=".generate_uuid
();
7190 vm_mon_cmd
($vmid, 'nbd-server-stop');
7193 # bash completion helper
7195 sub complete_backup_archives
{
7196 my ($cmdname, $pname, $cvalue) = @_;
7198 my $cfg = PVE
::Storage
::config
();
7202 if ($cvalue =~ m/^([^:]+):/) {
7206 my $data = PVE
::Storage
::template_list
($cfg, $storeid, 'backup');
7209 foreach my $id (keys %$data) {
7210 foreach my $item (@{$data->{$id}}) {
7211 next if $item->{format
} !~ m/^vma\.(gz|lzo)$/;
7212 push @$res, $item->{volid
} if defined($item->{volid
});
7219 my $complete_vmid_full = sub {
7222 my $idlist = vmstatus
();
7226 foreach my $id (keys %$idlist) {
7227 my $d = $idlist->{$id};
7228 if (defined($running)) {
7229 next if $d->{template
};
7230 next if $running && $d->{status
} ne 'running';
7231 next if !$running && $d->{status
} eq 'running';
7240 return &$complete_vmid_full();
7243 sub complete_vmid_stopped
{
7244 return &$complete_vmid_full(0);
7247 sub complete_vmid_running
{
7248 return &$complete_vmid_full(1);
7251 sub complete_storage
{
7253 my $cfg = PVE
::Storage
::config
();
7254 my $ids = $cfg->{ids
};
7257 foreach my $sid (keys %$ids) {
7258 next if !PVE
::Storage
::storage_check_enabled
($cfg, $sid, undef, 1);
7259 next if !$ids->{$sid}->{content
}->{images
};