1 package PVE
::QemuServer
;
23 use Storable
qw(dclone);
25 use PVE
::Exception
qw(raise raise_param_exc);
27 use PVE
::Tools
qw(run_command lock_file lock_file_full file_read_firstline dir_glob_foreach $IPV6RE);
28 use PVE
::JSONSchema
qw(get_standard_option);
29 use PVE
::Cluster
qw(cfs_register_file cfs_read_file cfs_write_file cfs_lock_file);
34 use PVE
::RPCEnvironment
;
35 use PVE
::GuestHelpers
;
36 use PVE
::QemuServer
::PCI
qw(print_pci_addr print_pcie_addr);
37 use PVE
::QemuServer
::Memory
;
38 use PVE
::QemuServer
::USB
qw(parse_usb_device);
39 use PVE
::QemuServer
::Cloudinit
;
42 use Time
::HiRes
qw(gettimeofday);
43 use File
::Copy
qw(copy);
46 my $EDK2_FW_BASE = '/usr/share/pve-edk2-firmware/';
49 "$EDK2_FW_BASE/OVMF_CODE.fd",
50 "$EDK2_FW_BASE/OVMF_VARS.fd"
53 "$EDK2_FW_BASE/AAVMF_CODE.fd",
54 "$EDK2_FW_BASE/AAVMF_VARS.fd"
58 my $qemu_snap_storage = { rbd
=> 1 };
60 my $cpuinfo = PVE
::ProcFSTools
::read_cpuinfo
();
62 my $QEMU_FORMAT_RE = qr/raw|cow|qcow|qcow2|qed|vmdk|cloop/;
64 # Note about locking: we use flock on the config file protect
65 # against concurent actions.
66 # Aditionaly, we have a 'lock' setting in the config file. This
67 # can be set to 'migrate', 'backup', 'snapshot' or 'rollback'. Most actions are not
68 # allowed when such lock is set. But you can ignore this kind of
69 # lock with the --skiplock flag.
71 cfs_register_file
('/qemu-server/',
75 PVE
::JSONSchema
::register_standard_option
('pve-qm-stateuri', {
76 description
=> "Some command save/restore state from this location.",
82 PVE
::JSONSchema
::register_standard_option
('pve-qm-image-format', {
84 enum
=> [qw(raw cow qcow qed qcow2 vmdk cloop)],
85 description
=> "The drive's backing file's data format.",
89 PVE
::JSONSchema
::register_standard_option
('pve-qemu-machine', {
90 description
=> "Specifies the Qemu machine type.",
92 pattern
=> '(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)',
97 #no warnings 'redefine';
100 my ($controller, $vmid, $option, $value) = @_;
102 my $path = "/sys/fs/cgroup/$controller/qemu.slice/$vmid.scope/$option";
103 PVE
::ProcFSTools
::write_proc_entry
($path, $value);
107 my $nodename = PVE
::INotify
::nodename
();
109 mkdir "/etc/pve/nodes/$nodename";
110 my $confdir = "/etc/pve/nodes/$nodename/qemu-server";
113 my $var_run_tmpdir = "/var/run/qemu-server";
114 mkdir $var_run_tmpdir;
116 my $lock_dir = "/var/lock/qemu-server";
119 my $cpu_vendor_list = {
121 486 => 'GenuineIntel',
122 pentium
=> 'GenuineIntel',
123 pentium2
=> 'GenuineIntel',
124 pentium3
=> 'GenuineIntel',
125 coreduo
=> 'GenuineIntel',
126 core2duo
=> 'GenuineIntel',
127 Conroe
=> 'GenuineIntel',
128 Penryn
=> 'GenuineIntel',
129 Nehalem
=> 'GenuineIntel',
130 'Nehalem-IBRS' => 'GenuineIntel',
131 Westmere
=> 'GenuineIntel',
132 'Westmere-IBRS' => 'GenuineIntel',
133 SandyBridge
=> 'GenuineIntel',
134 'SandyBridge-IBRS' => 'GenuineIntel',
135 IvyBridge
=> 'GenuineIntel',
136 'IvyBridge-IBRS' => 'GenuineIntel',
137 Haswell
=> 'GenuineIntel',
138 'Haswell-IBRS' => 'GenuineIntel',
139 'Haswell-noTSX' => 'GenuineIntel',
140 'Haswell-noTSX-IBRS' => 'GenuineIntel',
141 Broadwell
=> 'GenuineIntel',
142 'Broadwell-IBRS' => 'GenuineIntel',
143 'Broadwell-noTSX' => 'GenuineIntel',
144 'Broadwell-noTSX-IBRS' => 'GenuineIntel',
145 'Skylake-Client' => 'GenuineIntel',
146 'Skylake-Client-IBRS' => 'GenuineIntel',
147 'Skylake-Server' => 'GenuineIntel',
148 'Skylake-Server-IBRS' => 'GenuineIntel',
151 athlon
=> 'AuthenticAMD',
152 phenom
=> 'AuthenticAMD',
153 Opteron_G1
=> 'AuthenticAMD',
154 Opteron_G2
=> 'AuthenticAMD',
155 Opteron_G3
=> 'AuthenticAMD',
156 Opteron_G4
=> 'AuthenticAMD',
157 Opteron_G5
=> 'AuthenticAMD',
158 EPYC
=> 'AuthenticAMD',
159 'EPYC-IBPB' => 'AuthenticAMD',
161 # generic types, use vendor from host node
170 my @supported_cpu_flags = (
183 my $cpu_flag = qr/[+-](@{[join('|', @supported_cpu_flags)]})/;
187 description
=> "Emulated CPU type.",
189 enum
=> [ sort { "\L$a" cmp "\L$b" } keys %$cpu_vendor_list ],
194 description
=> "Do not identify as a KVM virtual machine.",
201 pattern
=> qr/[a-zA-Z0-9]{1,12}/,
202 format_description
=> 'vendor-id',
203 description
=> 'The Hyper-V vendor ID. Some drivers or programs inside Windows guests need a specific ID.',
207 description
=> "List of additional CPU flags separated by ';'."
208 . " Use '+FLAG' to enable, '-FLAG' to disable a flag."
209 . " Currently supported flags: @{[join(', ', @supported_cpu_flags)]}.",
210 format_description
=> '+FLAG[;-FLAG...]',
212 pattern
=> qr/$cpu_flag(;$cpu_flag)*/,
221 enum
=> [qw(i6300esb ib700)],
222 description
=> "Watchdog type to emulate.",
223 default => 'i6300esb',
228 enum
=> [qw(reset shutdown poweroff pause debug none)],
229 description
=> "The action to perform if after activation the guest fails to poll the watchdog in time.",
233 PVE
::JSONSchema
::register_format
('pve-qm-watchdog', $watchdog_fmt);
237 description
=> "Enable/disable Qemu GuestAgent.",
242 fstrim_cloned_disks
=> {
243 description
=> "Run fstrim after cloning/moving a disk.",
252 description
=> "Select the VGA type.",
257 enum
=> [qw(cirrus qxl qxl2 qxl3 qxl4 none serial0 serial1 serial2 serial3 std virtio vmware)],
260 description
=> "Sets the VGA memory (in MiB). Has no effect with serial display.",
272 description
=> "The size of the file in MB.",
276 pattern
=> '[a-zA-Z0-9\-]+',
278 format_description
=> 'string',
279 description
=> "The name of the file. Will be prefixed with 'pve-shm-'. Default is the VMID. Will be deleted when the VM is stopped.",
286 enum
=> [qw(ich9-intel-hda intel-hda AC97)],
287 description
=> "Configure an audio device."
294 description
=> "Driver backend for the audio device."
302 description
=> "Specifies whether a VM will be started during system bootup.",
308 description
=> "Automatic restart after crash (currently ignored).",
313 type
=> 'string', format
=> 'pve-hotplug-features',
314 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'.",
315 default => 'network,disk,usb',
320 description
=> "Allow reboot. If set to '0' the VM exit on reboot.",
326 description
=> "Lock/unlock the VM.",
327 enum
=> [qw(backup clone create migrate rollback snapshot snapshot-delete suspending suspended)],
332 description
=> "Limit of CPU usage.",
333 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.",
341 description
=> "CPU weight for a VM.",
342 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.",
350 description
=> "Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.",
357 description
=> "Amount of target RAM for the VM in MB. Using zero disables the ballon driver.",
363 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.",
371 description
=> "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.".
372 "It should not be necessary to set it.",
373 enum
=> PVE
::Tools
::kvmkeymaplist
(),
378 type
=> 'string', format
=> 'dns-name',
379 description
=> "Set a name for the VM. Only used on the configuration web interface.",
384 description
=> "SCSI controller model",
385 enum
=> [qw(lsi lsi53c810 virtio-scsi-pci virtio-scsi-single megasas pvscsi)],
391 description
=> "Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.",
396 enum
=> [qw(other wxp w2k w2k3 w2k8 wvista win7 win8 win10 l24 l26 solaris)],
397 description
=> "Specify guest operating system.",
398 verbose_description
=> <<EODESC,
399 Specify guest operating system. This is used to enable special
400 optimization/features for specific operating systems:
403 other;; unspecified OS
404 wxp;; Microsoft Windows XP
405 w2k;; Microsoft Windows 2000
406 w2k3;; Microsoft Windows 2003
407 w2k8;; Microsoft Windows 2008
408 wvista;; Microsoft Windows Vista
409 win7;; Microsoft Windows 7
410 win8;; Microsoft Windows 8/2012/2012r2
411 win10;; Microsoft Windows 10/2016
412 l24;; Linux 2.4 Kernel
413 l26;; Linux 2.6/3.X Kernel
414 solaris;; Solaris/OpenSolaris/OpenIndiania kernel
420 description
=> "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).",
421 pattern
=> '[acdn]{1,4}',
426 type
=> 'string', format
=> 'pve-qm-bootdisk',
427 description
=> "Enable booting from specified disk.",
428 pattern
=> '(ide|sata|scsi|virtio)\d+',
433 description
=> "The number of CPUs. Please use option -sockets instead.",
440 description
=> "The number of CPU sockets.",
447 description
=> "The number of cores per socket.",
454 description
=> "Enable/disable NUMA.",
460 description
=> "Enable/disable hugepages memory.",
461 enum
=> [qw(any 2 1024)],
466 description
=> "Number of hotplugged vcpus.",
473 description
=> "Enable/disable ACPI.",
478 description
=> "Enable/disable Qemu GuestAgent and its properties.",
480 format
=> $agent_fmt,
485 description
=> "Enable/disable KVM hardware virtualization.",
491 description
=> "Enable/disable time drift fix.",
497 description
=> "Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.",
502 description
=> "Freeze CPU at startup (use 'c' monitor command to start execution).",
506 type
=> 'string', format
=> $vga_fmt,
507 description
=> "Configure the VGA hardware.",
508 verbose_description
=> "Configure the VGA Hardware. If you want to use ".
509 "high resolution modes (>= 1280x1024x16) you may need to increase " .
510 "the vga memory option. Since QEMU 2.9 the default VGA display type " .
511 "is 'std' for all OS types besides some Windows versions (XP and " .
512 "older) which use 'cirrus'. The 'qxl' option enables the SPICE " .
513 "display server. For win* OS you can select how many independent " .
514 "displays you want, Linux guests can add displays them self.\n".
515 "You can also run without any graphic card, using a serial device as terminal.",
519 type
=> 'string', format
=> 'pve-qm-watchdog',
520 description
=> "Create a virtual hardware watchdog device.",
521 verbose_description
=> "Create a virtual hardware watchdog device. Once enabled" .
522 " (by a guest action), the watchdog must be periodically polled " .
523 "by an agent inside the guest or else the watchdog will reset " .
524 "the guest (or execute the respective action specified)",
529 typetext
=> "(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)",
530 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'.",
531 pattern
=> '(now|\d{4}-\d{1,2}-\d{1,2}(T\d{1,2}:\d{1,2}:\d{1,2})?)',
534 startup
=> get_standard_option
('pve-startup-order'),
538 description
=> "Enable/disable Template.",
544 description
=> "Arbitrary arguments passed to kvm.",
545 verbose_description
=> <<EODESCR,
546 Arbitrary arguments passed to kvm, for example:
548 args: -no-reboot -no-hpet
550 NOTE: this option is for experts only.
557 description
=> "Enable/disable the USB tablet device.",
558 verbose_description
=> "Enable/disable the USB tablet device. This device is " .
559 "usually needed to allow absolute mouse positioning with VNC. " .
560 "Else the mouse runs out of sync with normal VNC clients. " .
561 "If you're running lots of console-only guests on one host, " .
562 "you may consider disabling this to save some context switches. " .
563 "This is turned off by default if you use spice (-vga=qxl).",
568 description
=> "Set maximum speed (in MB/s) for migrations. Value 0 is no limit.",
572 migrate_downtime
=> {
575 description
=> "Set maximum tolerated downtime (in seconds) for migrations.",
581 type
=> 'string', format
=> 'pve-qm-ide',
582 typetext
=> '<volume>',
583 description
=> "This is an alias for option -ide2",
587 description
=> "Emulated CPU type.",
591 parent
=> get_standard_option
('pve-snapshot-name', {
593 description
=> "Parent snapshot name. This is used internally, and should not be modified.",
597 description
=> "Timestamp for snapshots.",
603 type
=> 'string', format
=> 'pve-volume-id',
604 description
=> "Reference to a volume which stores the VM state. This is used internally for snapshots.",
606 vmstatestorage
=> get_standard_option
('pve-storage-id', {
607 description
=> "Default storage for VM state volumes/files.",
610 runningmachine
=> get_standard_option
('pve-qemu-machine', {
611 description
=> "Specifies the Qemu machine type of the running vm. This is used internally for snapshots.",
613 machine
=> get_standard_option
('pve-qemu-machine'),
615 description
=> "Virtual processor architecture. Defaults to the host.",
618 enum
=> [qw(x86_64 aarch64)],
621 description
=> "Specify SMBIOS type 1 fields.",
622 type
=> 'string', format
=> 'pve-qm-smbios1',
629 description
=> "Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.",
635 enum
=> [ qw(seabios ovmf) ],
636 description
=> "Select BIOS implementation.",
637 default => 'seabios',
641 pattern
=> '(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])',
642 format_description
=> 'UUID',
643 description
=> "Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.",
644 verbose_description
=> "The VM generation ID (vmgenid) device exposes a".
645 " 128-bit integer value identifier to the guest OS. This allows to".
646 " notify the guest operating system when the virtual machine is".
647 " executed with a different configuration (e.g. snapshot execution".
648 " or creation from a template). The guest operating system notices".
649 " the change, and is then able to react as appropriate by marking".
650 " its copies of distributed databases as dirty, re-initializing its".
651 " random number generator, etc.\n".
652 "Note that auto-creation only works when done throug API/CLI create".
653 " or update methods, but not when manually editing the config file.",
654 default => "1 (autogenerated)",
659 format
=> 'pve-volume-id',
661 description
=> "Script that will be executed during various steps in the vms lifetime.",
665 format
=> $ivshmem_fmt,
666 description
=> "Inter-VM shared memory. Useful for direct communication between VMs, or to the host.",
671 format
=> $audio_fmt,
672 description
=> "Configure a audio device, useful in combination with QXL/Spice.",
681 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.',
682 format
=> 'pve-volume-id',
683 format_description
=> 'volume',
688 description
=> 'Specify a custom file containing all network data passed to the VM via cloud-init.',
689 format
=> 'pve-volume-id',
690 format_description
=> 'volume',
695 description
=> 'Specify a custom file containing all user data passed to the VM via cloud-init.',
696 format
=> 'pve-volume-id',
697 format_description
=> 'volume',
700 PVE
::JSONSchema
::register_format
('pve-qm-cicustom', $cicustom_fmt);
702 my $confdesc_cloudinit = {
706 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.',
707 enum
=> ['configdrive2', 'nocloud'],
712 description
=> "cloud-init: User name to change ssh keys and password for instead of the image's configured default user.",
717 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.',
722 description
=> 'cloud-init: Specify custom files to replace the automatically generated ones at start.',
723 format
=> 'pve-qm-cicustom',
728 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.",
732 type
=> 'string', format
=> 'address-list',
733 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.",
738 format
=> 'urlencoded',
739 description
=> "cloud-init: Setup public SSH keys (one key per line, OpenSSH format).",
743 # what about other qemu settings ?
745 #machine => 'string',
758 ##soundhw => 'string',
760 while (my ($k, $v) = each %$confdesc) {
761 PVE
::JSONSchema
::register_standard_option
("pve-qm-$k", $v);
764 my $MAX_IDE_DISKS = 4;
765 my $MAX_SCSI_DISKS = 14;
766 my $MAX_VIRTIO_DISKS = 16;
767 my $MAX_SATA_DISKS = 6;
768 my $MAX_USB_DEVICES = 5;
770 my $MAX_UNUSED_DISKS = 256;
771 my $MAX_HOSTPCI_DEVICES = 4;
772 my $MAX_SERIAL_PORTS = 4;
773 my $MAX_PARALLEL_PORTS = 3;
779 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
780 description
=> "CPUs accessing this NUMA node.",
781 format_description
=> "id[-id];...",
785 description
=> "Amount of memory this NUMA node provides.",
790 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
791 description
=> "Host NUMA nodes to use.",
792 format_description
=> "id[-id];...",
797 enum
=> [qw(preferred bind interleave)],
798 description
=> "NUMA allocation policy.",
802 PVE
::JSONSchema
::register_format
('pve-qm-numanode', $numa_fmt);
805 type
=> 'string', format
=> $numa_fmt,
806 description
=> "NUMA topology.",
808 PVE
::JSONSchema
::register_standard_option
("pve-qm-numanode", $numadesc);
810 for (my $i = 0; $i < $MAX_NUMA; $i++) {
811 $confdesc->{"numa$i"} = $numadesc;
814 my $nic_model_list = ['rtl8139', 'ne2k_pci', 'e1000', 'pcnet', 'virtio',
815 'ne2k_isa', 'i82551', 'i82557b', 'i82559er', 'vmxnet3',
816 'e1000-82540em', 'e1000-82544gc', 'e1000-82545em'];
817 my $nic_model_list_txt = join(' ', sort @$nic_model_list);
819 my $net_fmt_bridge_descr = <<__EOD__;
820 Bridge to attach the network device to. The Proxmox VE standard bridge
823 If you do not specify a bridge, we create a kvm user (NATed) network
824 device, which provides DHCP and DNS services. The following addresses
831 The DHCP server assign addresses to the guest starting from 10.0.2.15.
835 macaddr
=> get_standard_option
('mac-addr', {
836 description
=> "MAC address. That address must be unique withing your network. This is automatically generated if not specified.",
840 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'.",
841 enum
=> $nic_model_list,
844 (map { $_ => { keyAlias
=> 'model', alias
=> 'macaddr' }} @$nic_model_list),
847 description
=> $net_fmt_bridge_descr,
848 format_description
=> 'bridge',
853 minimum
=> 0, maximum
=> 16,
854 description
=> 'Number of packet queues to be used on the device.',
860 description
=> "Rate limit in mbps (megabytes per second) as floating point number.",
865 minimum
=> 1, maximum
=> 4094,
866 description
=> 'VLAN tag to apply to packets on this interface.',
871 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
872 description
=> 'VLAN trunks to pass through this interface.',
873 format_description
=> 'vlanid[;vlanid...]',
878 description
=> 'Whether this interface should be protected by the firewall.',
883 description
=> 'Whether this interface should be disconnected (like pulling the plug).',
890 type
=> 'string', format
=> $net_fmt,
891 description
=> "Specify network devices.",
894 PVE
::JSONSchema
::register_standard_option
("pve-qm-net", $netdesc);
899 format
=> 'pve-ipv4-config',
900 format_description
=> 'IPv4Format/CIDR',
901 description
=> 'IPv4 address in CIDR format.',
908 format_description
=> 'GatewayIPv4',
909 description
=> 'Default gateway for IPv4 traffic.',
915 format
=> 'pve-ipv6-config',
916 format_description
=> 'IPv6Format/CIDR',
917 description
=> 'IPv6 address in CIDR format.',
924 format_description
=> 'GatewayIPv6',
925 description
=> 'Default gateway for IPv6 traffic.',
930 PVE
::JSONSchema
::register_format
('pve-qm-ipconfig', $ipconfig_fmt);
933 type
=> 'string', format
=> 'pve-qm-ipconfig',
934 description
=> <<'EODESCR',
935 cloud-init: Specify IP addresses and gateways for the corresponding interface.
937 IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
939 The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
940 For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
942 If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
945 PVE
::JSONSchema
::register_standard_option
("pve-qm-ipconfig", $netdesc);
947 for (my $i = 0; $i < $MAX_NETS; $i++) {
948 $confdesc->{"net$i"} = $netdesc;
949 $confdesc_cloudinit->{"ipconfig$i"} = $ipconfigdesc;
952 foreach my $key (keys %$confdesc_cloudinit) {
953 $confdesc->{$key} = $confdesc_cloudinit->{$key};
956 PVE
::JSONSchema
::register_format
('pve-volume-id-or-qm-path', \
&verify_volume_id_or_qm_path
);
957 sub verify_volume_id_or_qm_path
{
958 my ($volid, $noerr) = @_;
960 if ($volid eq 'none' || $volid eq 'cdrom' || $volid =~ m
|^/|) {
964 # if its neither 'none' nor 'cdrom' nor a path, check if its a volume-id
965 $volid = eval { PVE
::JSONSchema
::check_format
('pve-volume-id', $volid, '') };
967 return undef if $noerr;
975 my %drivedesc_base = (
976 volume
=> { alias
=> 'file' },
979 format
=> 'pve-volume-id-or-qm-path',
981 format_description
=> 'volume',
982 description
=> "The drive's backing volume.",
986 enum
=> [qw(cdrom disk)],
987 description
=> "The drive's media type.",
993 description
=> "Force the drive's physical geometry to have a specific cylinder count.",
998 description
=> "Force the drive's physical geometry to have a specific head count.",
1003 description
=> "Force the drive's physical geometry to have a specific sector count.",
1008 enum
=> [qw(none lba auto)],
1009 description
=> "Force disk geometry bios translation mode.",
1014 description
=> "Controls qemu's snapshot mode feature."
1015 . " If activated, changes made to the disk are temporary and will"
1016 . " be discarded when the VM is shutdown.",
1021 enum
=> [qw(none writethrough writeback unsafe directsync)],
1022 description
=> "The drive's cache mode",
1025 format
=> get_standard_option
('pve-qm-image-format'),
1028 format
=> 'disk-size',
1029 format_description
=> 'DiskSize',
1030 description
=> "Disk size. This is purely informational and has no effect.",
1035 description
=> "Whether the drive should be included when making backups.",
1040 description
=> 'Whether the drive should considered for replication jobs.',
1046 enum
=> [qw(ignore report stop)],
1047 description
=> 'Read error action.',
1052 enum
=> [qw(enospc ignore report stop)],
1053 description
=> 'Write error action.',
1058 enum
=> [qw(native threads)],
1059 description
=> 'AIO type to use.',
1064 enum
=> [qw(ignore on)],
1065 description
=> 'Controls whether to pass discard/trim requests to the underlying storage.',
1070 description
=> 'Controls whether to detect and try to optimize writes of zeroes.',
1075 format
=> 'urlencoded',
1076 format_description
=> 'serial',
1077 maxLength
=> 20*3, # *3 since it's %xx url enoded
1078 description
=> "The drive's reported serial number, url-encoded, up to 20 bytes long.",
1083 description
=> 'Mark this locally-managed volume as available on all nodes',
1084 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!",
1090 my %iothread_fmt = ( iothread
=> {
1092 description
=> "Whether to use iothreads for this drive",
1099 format
=> 'urlencoded',
1100 format_description
=> 'model',
1101 maxLength
=> 40*3, # *3 since it's %xx url enoded
1102 description
=> "The drive's reported model name, url-encoded, up to 40 bytes long.",
1110 description
=> "Number of queues.",
1116 my %scsiblock_fmt = (
1119 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",
1128 description
=> "Whether to expose this drive as an SSD, rather than a rotational hard disk.",
1136 pattern
=> qr/^(0x)[0-9a-fA-F]{16}/,
1137 format_description
=> 'wwn',
1138 description
=> "The drive's worldwide name, encoded as 16 bytes hex string, prefixed by '0x'.",
1143 my $add_throttle_desc = sub {
1144 my ($key, $type, $what, $unit, $longunit, $minimum) = @_;
1147 format_description
=> $unit,
1148 description
=> "Maximum $what in $longunit.",
1151 $d->{minimum
} = $minimum if defined($minimum);
1152 $drivedesc_base{$key} = $d;
1154 # throughput: (leaky bucket)
1155 $add_throttle_desc->('bps', 'integer', 'r/w speed', 'bps', 'bytes per second');
1156 $add_throttle_desc->('bps_rd', 'integer', 'read speed', 'bps', 'bytes per second');
1157 $add_throttle_desc->('bps_wr', 'integer', 'write speed', 'bps', 'bytes per second');
1158 $add_throttle_desc->('mbps', 'number', 'r/w speed', 'mbps', 'megabytes per second');
1159 $add_throttle_desc->('mbps_rd', 'number', 'read speed', 'mbps', 'megabytes per second');
1160 $add_throttle_desc->('mbps_wr', 'number', 'write speed', 'mbps', 'megabytes per second');
1161 $add_throttle_desc->('iops', 'integer', 'r/w I/O', 'iops', 'operations per second');
1162 $add_throttle_desc->('iops_rd', 'integer', 'read I/O', 'iops', 'operations per second');
1163 $add_throttle_desc->('iops_wr', 'integer', 'write I/O', 'iops', 'operations per second');
1165 # pools: (pool of IO before throttling starts taking effect)
1166 $add_throttle_desc->('mbps_max', 'number', 'unthrottled r/w pool', 'mbps', 'megabytes per second');
1167 $add_throttle_desc->('mbps_rd_max', 'number', 'unthrottled read pool', 'mbps', 'megabytes per second');
1168 $add_throttle_desc->('mbps_wr_max', 'number', 'unthrottled write pool', 'mbps', 'megabytes per second');
1169 $add_throttle_desc->('iops_max', 'integer', 'unthrottled r/w I/O pool', 'iops', 'operations per second');
1170 $add_throttle_desc->('iops_rd_max', 'integer', 'unthrottled read I/O pool', 'iops', 'operations per second');
1171 $add_throttle_desc->('iops_wr_max', 'integer', 'unthrottled write I/O pool', 'iops', 'operations per second');
1174 $add_throttle_desc->('bps_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1175 $add_throttle_desc->('bps_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1176 $add_throttle_desc->('bps_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1177 $add_throttle_desc->('iops_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1178 $add_throttle_desc->('iops_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1179 $add_throttle_desc->('iops_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1182 $drivedesc_base{'bps_rd_length'} = { alias
=> 'bps_rd_max_length' };
1183 $drivedesc_base{'bps_wr_length'} = { alias
=> 'bps_wr_max_length' };
1184 $drivedesc_base{'iops_rd_length'} = { alias
=> 'iops_rd_max_length' };
1185 $drivedesc_base{'iops_wr_length'} = { alias
=> 'iops_wr_max_length' };
1193 PVE
::JSONSchema
::register_format
("pve-qm-ide", $ide_fmt);
1197 type
=> 'string', format
=> $ide_fmt,
1198 description
=> "Use volume as IDE hard disk or CD-ROM (n is 0 to " .($MAX_IDE_DISKS -1) . ").",
1200 PVE
::JSONSchema
::register_standard_option
("pve-qm-ide", $idedesc);
1212 type
=> 'string', format
=> $scsi_fmt,
1213 description
=> "Use volume as SCSI hard disk or CD-ROM (n is 0 to " . ($MAX_SCSI_DISKS - 1) . ").",
1215 PVE
::JSONSchema
::register_standard_option
("pve-qm-scsi", $scsidesc);
1224 type
=> 'string', format
=> $sata_fmt,
1225 description
=> "Use volume as SATA hard disk or CD-ROM (n is 0 to " . ($MAX_SATA_DISKS - 1). ").",
1227 PVE
::JSONSchema
::register_standard_option
("pve-qm-sata", $satadesc);
1235 type
=> 'string', format
=> $virtio_fmt,
1236 description
=> "Use volume as VIRTIO hard disk (n is 0 to " . ($MAX_VIRTIO_DISKS - 1) . ").",
1238 PVE
::JSONSchema
::register_standard_option
("pve-qm-virtio", $virtiodesc);
1240 my $alldrive_fmt = {
1251 volume
=> { alias
=> 'file' },
1254 format
=> 'pve-volume-id-or-qm-path',
1256 format_description
=> 'volume',
1257 description
=> "The drive's backing volume.",
1259 format
=> get_standard_option
('pve-qm-image-format'),
1262 format
=> 'disk-size',
1263 format_description
=> 'DiskSize',
1264 description
=> "Disk size. This is purely informational and has no effect.",
1269 my $efidisk_desc = {
1271 type
=> 'string', format
=> $efidisk_fmt,
1272 description
=> "Configure a Disk for storing EFI vars",
1275 PVE
::JSONSchema
::register_standard_option
("pve-qm-efidisk", $efidisk_desc);
1280 type
=> 'string', format
=> 'pve-qm-usb-device',
1281 format_description
=> 'HOSTUSBDEVICE|spice',
1282 description
=> <<EODESCR,
1283 The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:
1285 'bus-port(.port)*' (decimal numbers) or
1286 'vendor_id:product_id' (hexadeciaml numbers) or
1289 You can use the 'lsusb -t' command to list existing usb devices.
1291 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1293 The value 'spice' can be used to add a usb redirection devices for spice.
1299 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).",
1306 type
=> 'string', format
=> $usb_fmt,
1307 description
=> "Configure an USB device (n is 0 to 4).",
1309 PVE
::JSONSchema
::register_standard_option
("pve-qm-usb", $usbdesc);
1311 my $PCIRE = qr/[a-f0-9]{2}:[a-f0-9]{2}(?:\.[a-f0-9])?/;
1316 pattern
=> qr/$PCIRE(;$PCIRE)*/,
1317 format_description
=> 'HOSTPCIID[;HOSTPCIID2...]',
1318 description
=> <<EODESCR,
1319 Host PCI device pass through. The PCI ID of a host's PCI device or a list
1320 of PCI virtual functions of the host. HOSTPCIID syntax is:
1322 'bus:dev.func' (hexadecimal numbers)
1324 You can us the 'lspci' command to list existing PCI devices.
1329 description
=> "Specify whether or not the device's ROM will be visible in the guest's memory map.",
1335 pattern
=> '[^,;]+',
1336 format_description
=> 'string',
1337 description
=> "Custom pci device rom filename (must be located in /usr/share/kvm/).",
1342 description
=> "Choose the PCI-express bus (needs the 'q35' machine model).",
1348 description
=> "Enable vfio-vga device support.",
1354 format_description
=> 'string',
1355 pattern
=> '[^/\.:]+',
1357 description
=> <<EODESCR
1358 The type of mediated device to use.
1359 An instance of this type will be created on startup of the VM and
1360 will be cleaned up when the VM stops.
1364 PVE
::JSONSchema
::register_format
('pve-qm-hostpci', $hostpci_fmt);
1368 type
=> 'string', format
=> 'pve-qm-hostpci',
1369 description
=> "Map host PCI devices into guest.",
1370 verbose_description
=> <<EODESCR,
1371 Map host PCI devices into guest.
1373 NOTE: This option allows direct access to host hardware. So it is no longer
1374 possible to migrate such machines - use with special care.
1376 CAUTION: Experimental! User reported problems with this option.
1379 PVE
::JSONSchema
::register_standard_option
("pve-qm-hostpci", $hostpcidesc);
1384 pattern
=> '(/dev/.+|socket)',
1385 description
=> "Create a serial device inside the VM (n is 0 to 3)",
1386 verbose_description
=> <<EODESCR,
1387 Create a serial device inside the VM (n is 0 to 3), and pass through a
1388 host serial device (i.e. /dev/ttyS0), or create a unix socket on the
1389 host side (use 'qm terminal' to open a terminal connection).
1391 NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
1393 CAUTION: Experimental! User reported problems with this option.
1400 pattern
=> '/dev/parport\d+|/dev/usb/lp\d+',
1401 description
=> "Map host parallel devices (n is 0 to 2).",
1402 verbose_description
=> <<EODESCR,
1403 Map host parallel devices (n is 0 to 2).
1405 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1407 CAUTION: Experimental! User reported problems with this option.
1411 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
1412 $confdesc->{"parallel$i"} = $paralleldesc;
1415 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
1416 $confdesc->{"serial$i"} = $serialdesc;
1419 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
1420 $confdesc->{"hostpci$i"} = $hostpcidesc;
1423 for (my $i = 0; $i < $MAX_IDE_DISKS; $i++) {
1424 $drivename_hash->{"ide$i"} = 1;
1425 $confdesc->{"ide$i"} = $idedesc;
1428 for (my $i = 0; $i < $MAX_SATA_DISKS; $i++) {
1429 $drivename_hash->{"sata$i"} = 1;
1430 $confdesc->{"sata$i"} = $satadesc;
1433 for (my $i = 0; $i < $MAX_SCSI_DISKS; $i++) {
1434 $drivename_hash->{"scsi$i"} = 1;
1435 $confdesc->{"scsi$i"} = $scsidesc ;
1438 for (my $i = 0; $i < $MAX_VIRTIO_DISKS; $i++) {
1439 $drivename_hash->{"virtio$i"} = 1;
1440 $confdesc->{"virtio$i"} = $virtiodesc;
1443 $drivename_hash->{efidisk0
} = 1;
1444 $confdesc->{efidisk0
} = $efidisk_desc;
1446 for (my $i = 0; $i < $MAX_USB_DEVICES; $i++) {
1447 $confdesc->{"usb$i"} = $usbdesc;
1452 type
=> 'string', format
=> 'pve-volume-id',
1453 description
=> "Reference to unused volumes. This is used internally, and should not be modified manually.",
1456 for (my $i = 0; $i < $MAX_UNUSED_DISKS; $i++) {
1457 $confdesc->{"unused$i"} = $unuseddesc;
1460 my $kvm_api_version = 0;
1463 return $kvm_api_version if $kvm_api_version;
1465 open my $fh, '<', '/dev/kvm'
1468 # 0xae00 => KVM_GET_API_VERSION
1469 $kvm_api_version = ioctl($fh, 0xae00, 0);
1471 return $kvm_api_version;
1474 my $kvm_user_version;
1476 sub kvm_user_version
{
1478 return $kvm_user_version if $kvm_user_version;
1480 $kvm_user_version = 'unknown';
1484 if ($line =~ m/^QEMU( PC)? emulator version (\d+\.\d+(\.\d+)?)(\.\d+)?[,\s]/) {
1485 $kvm_user_version = $2;
1489 eval { run_command
("kvm -version", outfunc
=> $code); };
1492 return $kvm_user_version;
1496 sub kernel_has_vhost_net
{
1497 return -c
'/dev/vhost-net';
1500 sub valid_drive_names
{
1501 # order is important - used to autoselect boot disk
1502 return ((map { "ide$_" } (0 .. ($MAX_IDE_DISKS - 1))),
1503 (map { "scsi$_" } (0 .. ($MAX_SCSI_DISKS - 1))),
1504 (map { "virtio$_" } (0 .. ($MAX_VIRTIO_DISKS - 1))),
1505 (map { "sata$_" } (0 .. ($MAX_SATA_DISKS - 1))),
1509 sub is_valid_drivename
{
1512 return defined($drivename_hash->{$dev});
1517 return defined($confdesc->{$key});
1521 return $nic_model_list;
1524 sub os_list_description
{
1528 wxp
=> 'Windows XP',
1529 w2k
=> 'Windows 2000',
1530 w2k3
=>, 'Windows 2003',
1531 w2k8
=> 'Windows 2008',
1532 wvista
=> 'Windows Vista',
1533 win7
=> 'Windows 7',
1534 win8
=> 'Windows 8/2012',
1535 win10
=> 'Windows 10/2016',
1543 sub get_cdrom_path
{
1545 return $cdrom_path if $cdrom_path;
1547 return $cdrom_path = "/dev/cdrom" if -l
"/dev/cdrom";
1548 return $cdrom_path = "/dev/cdrom1" if -l
"/dev/cdrom1";
1549 return $cdrom_path = "/dev/cdrom2" if -l
"/dev/cdrom2";
1553 my ($storecfg, $vmid, $cdrom) = @_;
1555 if ($cdrom eq 'cdrom') {
1556 return get_cdrom_path
();
1557 } elsif ($cdrom eq 'none') {
1559 } elsif ($cdrom =~ m
|^/|) {
1562 return PVE
::Storage
::path
($storecfg, $cdrom);
1566 # try to convert old style file names to volume IDs
1567 sub filename_to_volume_id
{
1568 my ($vmid, $file, $media) = @_;
1570 if (!($file eq 'none' || $file eq 'cdrom' ||
1571 $file =~ m
|^/dev/.+| || $file =~ m/^([^:]+):(.+)$/)) {
1573 return undef if $file =~ m
|/|;
1575 if ($media && $media eq 'cdrom') {
1576 $file = "local:iso/$file";
1578 $file = "local:$vmid/$file";
1585 sub verify_media_type
{
1586 my ($opt, $vtype, $media) = @_;
1591 if ($media eq 'disk') {
1593 } elsif ($media eq 'cdrom') {
1596 die "internal error";
1599 return if ($vtype eq $etype);
1601 raise_param_exc
({ $opt => "unexpected media type ($vtype != $etype)" });
1604 sub cleanup_drive_path
{
1605 my ($opt, $storecfg, $drive) = @_;
1607 # try to convert filesystem paths to volume IDs
1609 if (($drive->{file
} !~ m/^(cdrom|none)$/) &&
1610 ($drive->{file
} !~ m
|^/dev/.+|) &&
1611 ($drive->{file
} !~ m/^([^:]+):(.+)$/) &&
1612 ($drive->{file
} !~ m/^\d+$/)) {
1613 my ($vtype, $volid) = PVE
::Storage
::path_to_volume_id
($storecfg, $drive->{file
});
1614 raise_param_exc
({ $opt => "unable to associate path '$drive->{file}' to any storage"}) if !$vtype;
1615 $drive->{media
} = 'cdrom' if !$drive->{media
} && $vtype eq 'iso';
1616 verify_media_type
($opt, $vtype, $drive->{media
});
1617 $drive->{file
} = $volid;
1620 $drive->{media
} = 'cdrom' if !$drive->{media
} && $drive->{file
} =~ m/^(cdrom|none)$/;
1623 sub parse_hotplug_features
{
1628 return $res if $data eq '0';
1630 $data = $confdesc->{hotplug
}->{default} if $data eq '1';
1632 foreach my $feature (PVE
::Tools
::split_list
($data)) {
1633 if ($feature =~ m/^(network|disk|cpu|memory|usb)$/) {
1636 die "invalid hotplug feature '$feature'\n";
1642 PVE
::JSONSchema
::register_format
('pve-hotplug-features', \
&pve_verify_hotplug_features
);
1643 sub pve_verify_hotplug_features
{
1644 my ($value, $noerr) = @_;
1646 return $value if parse_hotplug_features
($value);
1648 return undef if $noerr;
1650 die "unable to parse hotplug option\n";
1653 # ideX = [volume=]volume-id[,media=d][,cyls=c,heads=h,secs=s[,trans=t]]
1654 # [,snapshot=on|off][,cache=on|off][,format=f][,backup=yes|no]
1655 # [,rerror=ignore|report|stop][,werror=enospc|ignore|report|stop]
1656 # [,aio=native|threads][,discard=ignore|on][,detect_zeroes=on|off]
1657 # [,iothread=on][,serial=serial][,model=model]
1660 my ($key, $data) = @_;
1662 my ($interface, $index);
1664 if ($key =~ m/^([^\d]+)(\d+)$/) {
1671 my $desc = $key =~ /^unused\d+$/ ?
$alldrive_fmt
1672 : $confdesc->{$key}->{format
};
1674 warn "invalid drive key: $key\n";
1677 my $res = eval { PVE
::JSONSchema
::parse_property_string
($desc, $data) };
1678 return undef if !$res;
1679 $res->{interface
} = $interface;
1680 $res->{index} = $index;
1683 foreach my $opt (qw(bps bps_rd bps_wr)) {
1684 if (my $bps = defined(delete $res->{$opt})) {
1685 if (defined($res->{"m$opt"})) {
1686 warn "both $opt and m$opt specified\n";
1690 $res->{"m$opt"} = sprintf("%.3f", $bps / (1024*1024.0));
1694 # can't use the schema's 'requires' because of the mbps* => bps* "transforming aliases"
1695 for my $requirement (
1696 [mbps_max
=> 'mbps'],
1697 [mbps_rd_max
=> 'mbps_rd'],
1698 [mbps_wr_max
=> 'mbps_wr'],
1699 [miops_max
=> 'miops'],
1700 [miops_rd_max
=> 'miops_rd'],
1701 [miops_wr_max
=> 'miops_wr'],
1702 [bps_max_length
=> 'mbps_max'],
1703 [bps_rd_max_length
=> 'mbps_rd_max'],
1704 [bps_wr_max_length
=> 'mbps_wr_max'],
1705 [iops_max_length
=> 'iops_max'],
1706 [iops_rd_max_length
=> 'iops_rd_max'],
1707 [iops_wr_max_length
=> 'iops_wr_max']) {
1708 my ($option, $requires) = @$requirement;
1709 if ($res->{$option} && !$res->{$requires}) {
1710 warn "$option requires $requires\n";
1715 return undef if $error;
1717 return undef if $res->{mbps_rd
} && $res->{mbps
};
1718 return undef if $res->{mbps_wr
} && $res->{mbps
};
1719 return undef if $res->{iops_rd
} && $res->{iops
};
1720 return undef if $res->{iops_wr
} && $res->{iops
};
1722 if ($res->{media
} && ($res->{media
} eq 'cdrom')) {
1723 return undef if $res->{snapshot
} || $res->{trans
} || $res->{format
};
1724 return undef if $res->{heads
} || $res->{secs
} || $res->{cyls
};
1725 return undef if $res->{interface
} eq 'virtio';
1728 if (my $size = $res->{size
}) {
1729 return undef if !defined($res->{size
} = PVE
::JSONSchema
::parse_size
($size));
1736 my ($vmid, $drive) = @_;
1737 my $data = { %$drive };
1738 delete $data->{$_} for qw(index interface);
1739 return PVE
::JSONSchema
::print_property_string
($data, $alldrive_fmt);
1743 my($fh, $noerr) = @_;
1746 my $SG_GET_VERSION_NUM = 0x2282;
1748 my $versionbuf = "\x00" x
8;
1749 my $ret = ioctl($fh, $SG_GET_VERSION_NUM, $versionbuf);
1751 die "scsi ioctl SG_GET_VERSION_NUM failoed - $!\n" if !$noerr;
1754 my $version = unpack("I", $versionbuf);
1755 if ($version < 30000) {
1756 die "scsi generic interface too old\n" if !$noerr;
1760 my $buf = "\x00" x
36;
1761 my $sensebuf = "\x00" x
8;
1762 my $cmd = pack("C x3 C x1", 0x12, 36);
1764 # see /usr/include/scsi/sg.h
1765 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";
1767 my $packet = pack($sg_io_hdr_t, ord('S'), -3, length($cmd),
1768 length($sensebuf), 0, length($buf), $buf,
1769 $cmd, $sensebuf, 6000);
1771 $ret = ioctl($fh, $SG_IO, $packet);
1773 die "scsi ioctl SG_IO failed - $!\n" if !$noerr;
1777 my @res = unpack($sg_io_hdr_t, $packet);
1778 if ($res[17] || $res[18]) {
1779 die "scsi ioctl SG_IO status error - $!\n" if !$noerr;
1784 (my $byte0, my $byte1, $res->{vendor
},
1785 $res->{product
}, $res->{revision
}) = unpack("C C x6 A8 A16 A4", $buf);
1787 $res->{removable
} = $byte1 & 128 ?
1 : 0;
1788 $res->{type
} = $byte0 & 31;
1796 my $fh = IO
::File-
>new("+<$path") || return undef;
1797 my $res = scsi_inquiry
($fh, 1);
1803 sub machine_type_is_q35
{
1806 return $conf->{machine
} && ($conf->{machine
} =~ m/q35/) ?
1 : 0;
1809 sub print_tabletdevice_full
{
1810 my ($conf, $arch) = @_;
1812 my $q35 = machine_type_is_q35
($conf);
1814 # we use uhci for old VMs because tablet driver was buggy in older qemu
1816 if (machine_type_is_q35
($conf) || $arch eq 'aarch64') {
1822 return "usb-tablet,id=tablet,bus=$usbbus.0,port=1";
1825 sub print_keyboarddevice_full
{
1826 my ($conf, $arch, $machine) = @_;
1828 return undef if $arch ne 'aarch64';
1830 return "usb-kbd,id=keyboard,bus=ehci.0,port=2";
1833 sub print_drivedevice_full
{
1834 my ($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type) = @_;
1839 if ($drive->{interface
} eq 'virtio') {
1840 my $pciaddr = print_pci_addr
("$drive->{interface}$drive->{index}", $bridges, $arch, $machine_type);
1841 $device = "virtio-blk-pci,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}$pciaddr";
1842 $device .= ",iothread=iothread-$drive->{interface}$drive->{index}" if $drive->{iothread
};
1843 } elsif ($drive->{interface
} eq 'scsi') {
1845 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
1846 my $unit = $drive->{index} % $maxdev;
1847 my $devicetype = 'hd';
1849 if (drive_is_cdrom
($drive)) {
1852 if ($drive->{file
} =~ m
|^/|) {
1853 $path = $drive->{file
};
1854 if (my $info = path_is_scsi
($path)) {
1855 if ($info->{type
} == 0 && $drive->{scsiblock
}) {
1856 $devicetype = 'block';
1857 } elsif ($info->{type
} == 1) { # tape
1858 $devicetype = 'generic';
1862 $path = PVE
::Storage
::path
($storecfg, $drive->{file
});
1865 if($path =~ m/^iscsi\:\/\
//){
1866 $devicetype = 'generic';
1870 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)){
1871 $device = "scsi-$devicetype,bus=$controller_prefix$controller.0,scsi-id=$unit,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1873 $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}";
1876 if ($drive->{ssd
} && ($devicetype eq 'block' || $devicetype eq 'hd')) {
1877 $device .= ",rotation_rate=1";
1879 $device .= ",wwn=$drive->{wwn}" if $drive->{wwn
};
1881 } elsif ($drive->{interface
} eq 'ide' || $drive->{interface
} eq 'sata') {
1882 my $maxdev = ($drive->{interface
} eq 'sata') ?
$MAX_SATA_DISKS : 2;
1883 my $controller = int($drive->{index} / $maxdev);
1884 my $unit = $drive->{index} % $maxdev;
1885 my $devicetype = ($drive->{media
} && $drive->{media
} eq 'cdrom') ?
"cd" : "hd";
1887 $device = "ide-$devicetype";
1888 if ($drive->{interface
} eq 'ide') {
1889 $device .= ",bus=ide.$controller,unit=$unit";
1891 $device .= ",bus=ahci$controller.$unit";
1893 $device .= ",drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1895 if ($devicetype eq 'hd') {
1896 if (my $model = $drive->{model
}) {
1897 $model = URI
::Escape
::uri_unescape
($model);
1898 $device .= ",model=$model";
1900 if ($drive->{ssd
}) {
1901 $device .= ",rotation_rate=1";
1904 $device .= ",wwn=$drive->{wwn}" if $drive->{wwn
};
1905 } elsif ($drive->{interface
} eq 'usb') {
1907 # -device ide-drive,bus=ide.1,unit=0,drive=drive-ide0-1-0,id=ide0-1-0
1909 die "unsupported interface type";
1912 $device .= ",bootindex=$drive->{bootindex}" if $drive->{bootindex
};
1914 if (my $serial = $drive->{serial
}) {
1915 $serial = URI
::Escape
::uri_unescape
($serial);
1916 $device .= ",serial=$serial";
1923 sub get_initiator_name
{
1926 my $fh = IO
::File-
>new('/etc/iscsi/initiatorname.iscsi') || return undef;
1927 while (defined(my $line = <$fh>)) {
1928 next if $line !~ m/^\s*InitiatorName\s*=\s*([\.\-:\w]+)/;
1937 sub print_drive_full
{
1938 my ($storecfg, $vmid, $drive) = @_;
1941 my $volid = $drive->{file
};
1944 if (drive_is_cdrom
($drive)) {
1945 $path = get_iso_path
($storecfg, $vmid, $volid);
1947 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
1949 $path = PVE
::Storage
::path
($storecfg, $volid);
1950 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
1951 $format = qemu_img_format
($scfg, $volname);
1959 my @qemu_drive_options = qw(heads secs cyls trans media format cache rerror werror aio discard);
1960 foreach my $o (@qemu_drive_options) {
1961 $opts .= ",$o=$drive->{$o}" if defined($drive->{$o});
1964 # snapshot only accepts on|off
1965 if (defined($drive->{snapshot
})) {
1966 my $v = $drive->{snapshot
} ?
'on' : 'off';
1967 $opts .= ",snapshot=$v";
1970 foreach my $type (['', '-total'], [_rd
=> '-read'], [_wr
=> '-write']) {
1971 my ($dir, $qmpname) = @$type;
1972 if (my $v = $drive->{"mbps$dir"}) {
1973 $opts .= ",throttling.bps$qmpname=".int($v*1024*1024);
1975 if (my $v = $drive->{"mbps${dir}_max"}) {
1976 $opts .= ",throttling.bps$qmpname-max=".int($v*1024*1024);
1978 if (my $v = $drive->{"bps${dir}_max_length"}) {
1979 $opts .= ",throttling.bps$qmpname-max-length=$v";
1981 if (my $v = $drive->{"iops${dir}"}) {
1982 $opts .= ",throttling.iops$qmpname=$v";
1984 if (my $v = $drive->{"iops${dir}_max"}) {
1985 $opts .= ",throttling.iops$qmpname-max=$v";
1987 if (my $v = $drive->{"iops${dir}_max_length"}) {
1988 $opts .= ",throttling.iops$qmpname-max-length=$v";
1992 $opts .= ",format=$format" if $format && !$drive->{format
};
1994 my $cache_direct = 0;
1996 if (my $cache = $drive->{cache
}) {
1997 $cache_direct = $cache =~ /^(?:off|none|directsync)$/;
1998 } elsif (!drive_is_cdrom
($drive)) {
1999 $opts .= ",cache=none";
2003 # aio native works only with O_DIRECT
2004 if (!$drive->{aio
}) {
2006 $opts .= ",aio=native";
2008 $opts .= ",aio=threads";
2012 if (!drive_is_cdrom
($drive)) {
2014 if (defined($drive->{detect_zeroes
}) && !$drive->{detect_zeroes
}) {
2015 $detectzeroes = 'off';
2016 } elsif ($drive->{discard
}) {
2017 $detectzeroes = $drive->{discard
} eq 'on' ?
'unmap' : 'on';
2019 # This used to be our default with discard not being specified:
2020 $detectzeroes = 'on';
2022 $opts .= ",detect-zeroes=$detectzeroes" if $detectzeroes;
2025 my $pathinfo = $path ?
"file=$path," : '';
2027 return "${pathinfo}if=none,id=drive-$drive->{interface}$drive->{index}$opts";
2030 sub print_netdevice_full
{
2031 my ($vmid, $conf, $net, $netid, $bridges, $use_old_bios_files, $arch, $machine_type) = @_;
2033 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
2035 my $device = $net->{model
};
2036 if ($net->{model
} eq 'virtio') {
2037 $device = 'virtio-net-pci';
2040 my $pciaddr = print_pci_addr
("$netid", $bridges, $arch, $machine_type);
2041 my $tmpstr = "$device,mac=$net->{macaddr},netdev=$netid$pciaddr,id=$netid";
2042 if ($net->{queues
} && $net->{queues
} > 1 && $net->{model
} eq 'virtio'){
2043 #Consider we have N queues, the number of vectors needed is 2*N + 2 (plus one config interrupt and control vq)
2044 my $vectors = $net->{queues
} * 2 + 2;
2045 $tmpstr .= ",vectors=$vectors,mq=on";
2047 $tmpstr .= ",bootindex=$net->{bootindex}" if $net->{bootindex
} ;
2049 if ($use_old_bios_files) {
2051 if ($device eq 'virtio-net-pci') {
2052 $romfile = 'pxe-virtio.rom';
2053 } elsif ($device eq 'e1000') {
2054 $romfile = 'pxe-e1000.rom';
2055 } elsif ($device eq 'ne2k') {
2056 $romfile = 'pxe-ne2k_pci.rom';
2057 } elsif ($device eq 'pcnet') {
2058 $romfile = 'pxe-pcnet.rom';
2059 } elsif ($device eq 'rtl8139') {
2060 $romfile = 'pxe-rtl8139.rom';
2062 $tmpstr .= ",romfile=$romfile" if $romfile;
2068 sub print_netdev_full
{
2069 my ($vmid, $conf, $arch, $net, $netid, $hotplug) = @_;
2072 if ($netid =~ m/^net(\d+)$/) {
2076 die "got strange net id '$i'\n" if $i >= ${MAX_NETS
};
2078 my $ifname = "tap${vmid}i$i";
2080 # kvm uses TUNSETIFF ioctl, and that limits ifname length
2081 die "interface name '$ifname' is too long (max 15 character)\n"
2082 if length($ifname) >= 16;
2084 my $vhostparam = '';
2085 if (is_native
($arch)) {
2086 $vhostparam = ',vhost=on' if kernel_has_vhost_net
() && $net->{model
} eq 'virtio';
2089 my $vmname = $conf->{name
} || "vm$vmid";
2092 my $script = $hotplug ?
"pve-bridge-hotplug" : "pve-bridge";
2094 if ($net->{bridge
}) {
2095 $netdev = "type=tap,id=$netid,ifname=${ifname},script=/var/lib/qemu-server/$script,downscript=/var/lib/qemu-server/pve-bridgedown$vhostparam";
2097 $netdev = "type=user,id=$netid,hostname=$vmname";
2100 $netdev .= ",queues=$net->{queues}" if ($net->{queues
} && $net->{model
} eq 'virtio');
2106 sub print_cpu_device
{
2107 my ($conf, $id) = @_;
2109 my $kvm = $conf->{kvm
} // 1;
2110 my $cpu = $kvm ?
"kvm64" : "qemu64";
2111 if (my $cputype = $conf->{cpu
}) {
2112 my $cpuconf = PVE
::JSONSchema
::parse_property_string
($cpu_fmt, $cputype)
2113 or die "Cannot parse cpu description: $cputype\n";
2114 $cpu = $cpuconf->{cputype
};
2117 my $cores = $conf->{cores
} || 1;
2119 my $current_core = ($id - 1) % $cores;
2120 my $current_socket = int(($id - 1 - $current_core)/$cores);
2122 return "$cpu-x86_64-cpu,id=cpu$id,socket-id=$current_socket,core-id=$current_core,thread-id=0";
2126 'cirrus' => 'cirrus-vga',
2128 'vmware' => 'vmware-svga',
2129 'virtio' => 'virtio-vga',
2132 sub print_vga_device
{
2133 my ($conf, $vga, $arch, $machine, $id, $qxlnum, $bridges) = @_;
2135 my $type = $vga_map->{$vga->{type
}};
2136 if ($arch eq 'aarch64' && defined($type) && $type eq 'virtio-vga') {
2137 $type = 'virtio-gpu';
2139 my $vgamem_mb = $vga->{memory
};
2141 $type = $id ?
'qxl' : 'qxl-vga';
2143 die "no devicetype for $vga->{type}\n" if !$type;
2147 if ($vga->{type
} eq 'virtio') {
2148 my $bytes = PVE
::Tools
::convert_size
($vgamem_mb, "mb" => "b");
2149 $memory = ",max_hostmem=$bytes";
2151 # from https://www.spice-space.org/multiple-monitors.html
2152 $memory = ",vgamem_mb=$vga->{memory}";
2153 my $ram = $vgamem_mb * 4;
2154 my $vram = $vgamem_mb * 2;
2155 $memory .= ",ram_size_mb=$ram,vram_size_mb=$vram";
2157 $memory = ",vgamem_mb=$vga->{memory}";
2159 } elsif ($qxlnum && $id) {
2160 $memory = ",ram_size=67108864,vram_size=33554432";
2163 my $q35 = machine_type_is_q35
($conf);
2164 my $vgaid = "vga" . ($id // '');
2167 if ($q35 && $vgaid eq 'vga') {
2168 # the first display uses pcie.0 bus on q35 machines
2169 $pciaddr = print_pcie_addr
($vgaid, $bridges, $arch, $machine);
2171 $pciaddr = print_pci_addr
($vgaid, $bridges, $arch, $machine);
2174 return "$type,id=${vgaid}${memory}${pciaddr}";
2177 sub drive_is_cloudinit
{
2179 return $drive->{file
} =~ m
@[:/]vm-\d
+-cloudinit
(?
:\
.$QEMU_FORMAT_RE)?
$@;
2182 sub drive_is_cdrom
{
2183 my ($drive, $exclude_cloudinit) = @_;
2185 return 0 if $exclude_cloudinit && drive_is_cloudinit
($drive);
2187 return $drive && $drive->{media
} && ($drive->{media
} eq 'cdrom');
2191 sub parse_number_sets
{
2194 foreach my $part (split(/;/, $set)) {
2195 if ($part =~ /^\s*(\d+)(?:-(\d+))?\s*$/) {
2196 die "invalid range: $part ($2 < $1)\n" if defined($2) && $2 < $1;
2197 push @$res, [ $1, $2 ];
2199 die "invalid range: $part\n";
2208 my $res = PVE
::JSONSchema
::parse_property_string
($numa_fmt, $data);
2209 $res->{cpus
} = parse_number_sets
($res->{cpus
}) if defined($res->{cpus
});
2210 $res->{hostnodes
} = parse_number_sets
($res->{hostnodes
}) if defined($res->{hostnodes
});
2217 return undef if !$value;
2219 my $res = PVE
::JSONSchema
::parse_property_string
($hostpci_fmt, $value);
2221 my @idlist = split(/;/, $res->{host
});
2222 delete $res->{host
};
2223 foreach my $id (@idlist) {
2224 if ($id =~ m/\./) { # full id 00:00.1
2225 push @{$res->{pciid
}}, {
2228 } else { # partial id 00:00
2229 $res->{pciid
} = PVE
::SysFSTools
::lspci
($id);
2235 # netX: e1000=XX:XX:XX:XX:XX:XX,bridge=vmbr0,rate=<mbps>
2239 my $res = eval { PVE
::JSONSchema
::parse_property_string
($net_fmt, $data) };
2244 if (!defined($res->{macaddr
})) {
2245 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
2246 $res->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
});
2251 # ipconfigX ip=cidr,gw=ip,ip6=cidr,gw6=ip
2252 sub parse_ipconfig
{
2255 my $res = eval { PVE
::JSONSchema
::parse_property_string
($ipconfig_fmt, $data) };
2261 if ($res->{gw
} && !$res->{ip
}) {
2262 warn 'gateway specified without specifying an IP address';
2265 if ($res->{gw6
} && !$res->{ip6
}) {
2266 warn 'IPv6 gateway specified without specifying an IPv6 address';
2269 if ($res->{gw
} && $res->{ip
} eq 'dhcp') {
2270 warn 'gateway specified together with DHCP';
2273 if ($res->{gw6
} && $res->{ip6
} !~ /^$IPV6RE/) {
2275 warn "IPv6 gateway specified together with $res->{ip6} address";
2279 if (!$res->{ip
} && !$res->{ip6
}) {
2280 return { ip
=> 'dhcp', ip6
=> 'dhcp' };
2289 return PVE
::JSONSchema
::print_property_string
($net, $net_fmt);
2292 sub add_random_macs
{
2293 my ($settings) = @_;
2295 foreach my $opt (keys %$settings) {
2296 next if $opt !~ m/^net(\d+)$/;
2297 my $net = parse_net
($settings->{$opt});
2299 $settings->{$opt} = print_net
($net);
2303 sub vm_is_volid_owner
{
2304 my ($storecfg, $vmid, $volid) = @_;
2306 if ($volid !~ m
|^/|) {
2308 eval { ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid); };
2309 if ($owner && ($owner == $vmid)) {
2317 sub split_flagged_list
{
2318 my $text = shift || '';
2319 $text =~ s/[,;]/ /g;
2321 return { map { /^(!?)(.*)$/ && ($2, $1) } ($text =~ /\S+/g) };
2324 sub join_flagged_list
{
2325 my ($how, $lst) = @_;
2326 join $how, map { $lst->{$_} . $_ } keys %$lst;
2329 sub vmconfig_delete_pending_option
{
2330 my ($conf, $key, $force) = @_;
2332 delete $conf->{pending
}->{$key};
2333 my $pending_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2334 $pending_delete_hash->{$key} = $force ?
'!' : '';
2335 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2338 sub vmconfig_undelete_pending_option
{
2339 my ($conf, $key) = @_;
2341 my $pending_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2342 delete $pending_delete_hash->{$key};
2344 if (%$pending_delete_hash) {
2345 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2347 delete $conf->{pending
}->{delete};
2351 sub vmconfig_register_unused_drive
{
2352 my ($storecfg, $vmid, $conf, $drive) = @_;
2354 if (drive_is_cloudinit
($drive)) {
2355 eval { PVE
::Storage
::vdisk_free
($storecfg, $drive->{file
}) };
2357 } elsif (!drive_is_cdrom
($drive)) {
2358 my $volid = $drive->{file
};
2359 if (vm_is_volid_owner
($storecfg, $vmid, $volid)) {
2360 PVE
::QemuConfig-
>add_unused_volume($conf, $volid, $vmid);
2365 sub vmconfig_cleanup_pending
{
2368 # remove pending changes when nothing changed
2370 foreach my $opt (keys %{$conf->{pending
}}) {
2371 if (defined($conf->{$opt}) && ($conf->{pending
}->{$opt} eq $conf->{$opt})) {
2373 delete $conf->{pending
}->{$opt};
2377 my $current_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2378 my $pending_delete_hash = {};
2379 while (my ($opt, $force) = each %$current_delete_hash) {
2380 if (defined($conf->{$opt})) {
2381 $pending_delete_hash->{$opt} = $force;
2387 if (%$pending_delete_hash) {
2388 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2390 delete $conf->{pending
}->{delete};
2396 # smbios: [manufacturer=str][,product=str][,version=str][,serial=str][,uuid=uuid][,sku=str][,family=str][,base64=bool]
2400 pattern
=> '[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}',
2401 format_description
=> 'UUID',
2402 description
=> "Set SMBIOS1 UUID.",
2407 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2408 format_description
=> 'Base64 encoded string',
2409 description
=> "Set SMBIOS1 version.",
2414 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2415 format_description
=> 'Base64 encoded string',
2416 description
=> "Set SMBIOS1 serial number.",
2421 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2422 format_description
=> 'Base64 encoded string',
2423 description
=> "Set SMBIOS1 manufacturer.",
2428 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2429 format_description
=> 'Base64 encoded string',
2430 description
=> "Set SMBIOS1 product ID.",
2435 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2436 format_description
=> 'Base64 encoded string',
2437 description
=> "Set SMBIOS1 SKU string.",
2442 pattern
=> '[A-Za-z0-9+\/]+={0,2}',
2443 format_description
=> 'Base64 encoded string',
2444 description
=> "Set SMBIOS1 family string.",
2449 description
=> 'Flag to indicate that the SMBIOS values are base64 encoded',
2457 my $res = eval { PVE
::JSONSchema
::parse_property_string
($smbios1_fmt, $data) };
2464 return PVE
::JSONSchema
::print_property_string
($smbios1, $smbios1_fmt);
2467 PVE
::JSONSchema
::register_format
('pve-qm-smbios1', $smbios1_fmt);
2469 PVE
::JSONSchema
::register_format
('pve-qm-bootdisk', \
&verify_bootdisk
);
2470 sub verify_bootdisk
{
2471 my ($value, $noerr) = @_;
2473 return $value if is_valid_drivename
($value);
2475 return undef if $noerr;
2477 die "invalid boot disk '$value'\n";
2480 sub parse_watchdog
{
2483 return undef if !$value;
2485 my $res = eval { PVE
::JSONSchema
::parse_property_string
($watchdog_fmt, $value) };
2490 sub parse_guest_agent
{
2493 return {} if !defined($value->{agent
});
2495 my $res = eval { PVE
::JSONSchema
::parse_property_string
($agent_fmt, $value->{agent
}) };
2498 # if the agent is disabled ignore the other potentially set properties
2499 return {} if !$res->{enabled
};
2506 return {} if !$value;
2507 my $res = eval { PVE
::JSONSchema
::parse_property_string
($vga_fmt, $value) };
2512 PVE
::JSONSchema
::register_format
('pve-qm-usb-device', \
&verify_usb_device
);
2513 sub verify_usb_device
{
2514 my ($value, $noerr) = @_;
2516 return $value if parse_usb_device
($value);
2518 return undef if $noerr;
2520 die "unable to parse usb device\n";
2523 # add JSON properties for create and set function
2524 sub json_config_properties
{
2527 foreach my $opt (keys %$confdesc) {
2528 next if $opt eq 'parent' || $opt eq 'snaptime' || $opt eq 'vmstate' || $opt eq 'runningmachine';
2529 $prop->{$opt} = $confdesc->{$opt};
2535 # return copy of $confdesc_cloudinit to generate documentation
2536 sub cloudinit_config_properties
{
2538 return dclone
($confdesc_cloudinit);
2542 my ($key, $value) = @_;
2544 die "unknown setting '$key'\n" if !$confdesc->{$key};
2546 my $type = $confdesc->{$key}->{type
};
2548 if (!defined($value)) {
2549 die "got undefined value\n";
2552 if ($value =~ m/[\n\r]/) {
2553 die "property contains a line feed\n";
2556 if ($type eq 'boolean') {
2557 return 1 if ($value eq '1') || ($value =~ m/^(on|yes|true)$/i);
2558 return 0 if ($value eq '0') || ($value =~ m/^(off|no|false)$/i);
2559 die "type check ('boolean') failed - got '$value'\n";
2560 } elsif ($type eq 'integer') {
2561 return int($1) if $value =~ m/^(\d+)$/;
2562 die "type check ('integer') failed - got '$value'\n";
2563 } elsif ($type eq 'number') {
2564 return $value if $value =~ m/^(\d+)(\.\d+)?$/;
2565 die "type check ('number') failed - got '$value'\n";
2566 } elsif ($type eq 'string') {
2567 if (my $fmt = $confdesc->{$key}->{format
}) {
2568 PVE
::JSONSchema
::check_format
($fmt, $value);
2571 $value =~ s/^\"(.*)\"$/$1/;
2574 die "internal error"
2581 my $conf = PVE
::QemuConfig-
>config_file($vmid);
2582 utime undef, undef, $conf;
2586 my ($storecfg, $vmid, $keep_empty_config, $skiplock) = @_;
2588 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
2590 my $conf = PVE
::QemuConfig-
>load_config($vmid);
2592 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
2594 if ($conf->{template
}) {
2595 # check if any base image is still used by a linked clone
2596 foreach_drive
($conf, sub {
2597 my ($ds, $drive) = @_;
2599 return if drive_is_cdrom
($drive);
2601 my $volid = $drive->{file
};
2603 return if !$volid || $volid =~ m
|^/|;
2605 die "base volume '$volid' is still in use by linked cloned\n"
2606 if PVE
::Storage
::volume_is_base_and_used
($storecfg, $volid);
2611 # only remove disks owned by this VM
2612 foreach_drive
($conf, sub {
2613 my ($ds, $drive) = @_;
2615 return if drive_is_cdrom
($drive, 1);
2617 my $volid = $drive->{file
};
2619 return if !$volid || $volid =~ m
|^/|;
2621 my ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid);
2622 return if !$path || !$owner || ($owner != $vmid);
2625 PVE
::Storage
::vdisk_free
($storecfg, $volid);
2627 warn "Could not remove disk '$volid', check manually: $@" if $@;
2631 if ($keep_empty_config) {
2632 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
2637 # also remove unused disk
2639 my $dl = PVE
::Storage
::vdisk_list
($storecfg, undef, $vmid);
2642 PVE
::Storage
::foreach_volid
($dl, sub {
2643 my ($volid, $sid, $volname, $d) = @_;
2644 PVE
::Storage
::vdisk_free
($storecfg, $volid);
2653 sub parse_vm_config
{
2654 my ($filename, $raw) = @_;
2656 return undef if !defined($raw);
2659 digest
=> Digest
::SHA
::sha1_hex
($raw),
2664 $filename =~ m
|/qemu-server/(\d
+)\
.conf
$|
2665 || die "got strange filename '$filename'";
2673 my @lines = split(/\n/, $raw);
2674 foreach my $line (@lines) {
2675 next if $line =~ m/^\s*$/;
2677 if ($line =~ m/^\[PENDING\]\s*$/i) {
2678 $section = 'pending';
2679 if (defined($descr)) {
2681 $conf->{description
} = $descr;
2684 $conf = $res->{$section} = {};
2687 } elsif ($line =~ m/^\[([a-z][a-z0-9_\-]+)\]\s*$/i) {
2689 if (defined($descr)) {
2691 $conf->{description
} = $descr;
2694 $conf = $res->{snapshots
}->{$section} = {};
2698 if ($line =~ m/^\#(.*)\s*$/) {
2699 $descr = '' if !defined($descr);
2700 $descr .= PVE
::Tools
::decode_text
($1) . "\n";
2704 if ($line =~ m/^(description):\s*(.*\S)\s*$/) {
2705 $descr = '' if !defined($descr);
2706 $descr .= PVE
::Tools
::decode_text
($2);
2707 } elsif ($line =~ m/snapstate:\s*(prepare|delete)\s*$/) {
2708 $conf->{snapstate
} = $1;
2709 } elsif ($line =~ m/^(args):\s*(.*\S)\s*$/) {
2712 $conf->{$key} = $value;
2713 } elsif ($line =~ m/^delete:\s*(.*\S)\s*$/) {
2715 if ($section eq 'pending') {
2716 $conf->{delete} = $value; # we parse this later
2718 warn "vm $vmid - propertry 'delete' is only allowed in [PENDING]\n";
2720 } elsif ($line =~ m/^([a-z][a-z_]*\d*):\s*(.+?)\s*$/) {
2723 eval { $value = check_type
($key, $value); };
2725 warn "vm $vmid - unable to parse value of '$key' - $@";
2727 $key = 'ide2' if $key eq 'cdrom';
2728 my $fmt = $confdesc->{$key}->{format
};
2729 if ($fmt && $fmt =~ /^pve-qm-(?:ide|scsi|virtio|sata)$/) {
2730 my $v = parse_drive
($key, $value);
2731 if (my $volid = filename_to_volume_id
($vmid, $v->{file
}, $v->{media
})) {
2732 $v->{file
} = $volid;
2733 $value = print_drive
($vmid, $v);
2735 warn "vm $vmid - unable to parse value of '$key'\n";
2740 $conf->{$key} = $value;
2745 if (defined($descr)) {
2747 $conf->{description
} = $descr;
2749 delete $res->{snapstate
}; # just to be sure
2754 sub write_vm_config
{
2755 my ($filename, $conf) = @_;
2757 delete $conf->{snapstate
}; # just to be sure
2759 if ($conf->{cdrom
}) {
2760 die "option ide2 conflicts with cdrom\n" if $conf->{ide2
};
2761 $conf->{ide2
} = $conf->{cdrom
};
2762 delete $conf->{cdrom
};
2765 # we do not use 'smp' any longer
2766 if ($conf->{sockets
}) {
2767 delete $conf->{smp
};
2768 } elsif ($conf->{smp
}) {
2769 $conf->{sockets
} = $conf->{smp
};
2770 delete $conf->{cores
};
2771 delete $conf->{smp
};
2774 my $used_volids = {};
2776 my $cleanup_config = sub {
2777 my ($cref, $pending, $snapname) = @_;
2779 foreach my $key (keys %$cref) {
2780 next if $key eq 'digest' || $key eq 'description' || $key eq 'snapshots' ||
2781 $key eq 'snapstate' || $key eq 'pending';
2782 my $value = $cref->{$key};
2783 if ($key eq 'delete') {
2784 die "propertry 'delete' is only allowed in [PENDING]\n"
2786 # fixme: check syntax?
2789 eval { $value = check_type
($key, $value); };
2790 die "unable to parse value of '$key' - $@" if $@;
2792 $cref->{$key} = $value;
2794 if (!$snapname && is_valid_drivename
($key)) {
2795 my $drive = parse_drive
($key, $value);
2796 $used_volids->{$drive->{file
}} = 1 if $drive && $drive->{file
};
2801 &$cleanup_config($conf);
2803 &$cleanup_config($conf->{pending
}, 1);
2805 foreach my $snapname (keys %{$conf->{snapshots
}}) {
2806 die "internal error" if $snapname eq 'pending';
2807 &$cleanup_config($conf->{snapshots
}->{$snapname}, undef, $snapname);
2810 # remove 'unusedX' settings if we re-add a volume
2811 foreach my $key (keys %$conf) {
2812 my $value = $conf->{$key};
2813 if ($key =~ m/^unused/ && $used_volids->{$value}) {
2814 delete $conf->{$key};
2818 my $generate_raw_config = sub {
2819 my ($conf, $pending) = @_;
2823 # add description as comment to top of file
2824 if (defined(my $descr = $conf->{description
})) {
2826 foreach my $cl (split(/\n/, $descr)) {
2827 $raw .= '#' . PVE
::Tools
::encode_text
($cl) . "\n";
2830 $raw .= "#\n" if $pending;
2834 foreach my $key (sort keys %$conf) {
2835 next if $key eq 'digest' || $key eq 'description' || $key eq 'pending' || $key eq 'snapshots';
2836 $raw .= "$key: $conf->{$key}\n";
2841 my $raw = &$generate_raw_config($conf);
2843 if (scalar(keys %{$conf->{pending
}})){
2844 $raw .= "\n[PENDING]\n";
2845 $raw .= &$generate_raw_config($conf->{pending
}, 1);
2848 foreach my $snapname (sort keys %{$conf->{snapshots
}}) {
2849 $raw .= "\n[$snapname]\n";
2850 $raw .= &$generate_raw_config($conf->{snapshots
}->{$snapname});
2860 # we use static defaults from our JSON schema configuration
2861 foreach my $key (keys %$confdesc) {
2862 if (defined(my $default = $confdesc->{$key}->{default})) {
2863 $res->{$key} = $default;
2871 my $vmlist = PVE
::Cluster
::get_vmlist
();
2873 return $res if !$vmlist || !$vmlist->{ids
};
2874 my $ids = $vmlist->{ids
};
2876 foreach my $vmid (keys %$ids) {
2877 my $d = $ids->{$vmid};
2878 next if !$d->{node
} || $d->{node
} ne $nodename;
2879 next if !$d->{type
} || $d->{type
} ne 'qemu';
2880 $res->{$vmid}->{exists} = 1;
2885 # test if VM uses local resources (to prevent migration)
2886 sub check_local_resources
{
2887 my ($conf, $noerr) = @_;
2891 push @loc_res, "hostusb" if $conf->{hostusb
}; # old syntax
2892 push @loc_res, "hostpci" if $conf->{hostpci
}; # old syntax
2894 push @loc_res, "ivshmem" if $conf->{ivshmem
};
2896 foreach my $k (keys %$conf) {
2897 next if $k =~ m/^usb/ && ($conf->{$k} eq 'spice');
2898 # sockets are safe: they will recreated be on the target side post-migrate
2899 next if $k =~ m/^serial/ && ($conf->{$k} eq 'socket');
2900 push @loc_res, $k if $k =~ m/^(usb|hostpci|serial|parallel)\d+$/;
2903 die "VM uses local resources\n" if scalar @loc_res && !$noerr;
2908 # check if used storages are available on all nodes (use by migrate)
2909 sub check_storage_availability
{
2910 my ($storecfg, $conf, $node) = @_;
2912 foreach_drive
($conf, sub {
2913 my ($ds, $drive) = @_;
2915 my $volid = $drive->{file
};
2918 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2921 # check if storage is available on both nodes
2922 my $scfg = PVE
::Storage
::storage_check_node
($storecfg, $sid);
2923 PVE
::Storage
::storage_check_node
($storecfg, $sid, $node);
2927 # list nodes where all VM images are available (used by has_feature API)
2929 my ($conf, $storecfg) = @_;
2931 my $nodelist = PVE
::Cluster
::get_nodelist
();
2932 my $nodehash = { map { $_ => 1 } @$nodelist };
2933 my $nodename = PVE
::INotify
::nodename
();
2935 foreach_drive
($conf, sub {
2936 my ($ds, $drive) = @_;
2938 my $volid = $drive->{file
};
2941 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2943 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
2944 if ($scfg->{disable
}) {
2946 } elsif (my $avail = $scfg->{nodes
}) {
2947 foreach my $node (keys %$nodehash) {
2948 delete $nodehash->{$node} if !$avail->{$node};
2950 } elsif (!$scfg->{shared
}) {
2951 foreach my $node (keys %$nodehash) {
2952 delete $nodehash->{$node} if $node ne $nodename
2961 sub check_local_storage_availability
{
2962 my ($conf, $storecfg) = @_;
2964 my $nodelist = PVE
::Cluster
::get_nodelist
();
2965 my $nodehash = { map { $_ => {} } @$nodelist };
2967 foreach_drive
($conf, sub {
2968 my ($ds, $drive) = @_;
2970 my $volid = $drive->{file
};
2973 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2975 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
2977 if ($scfg->{disable
}) {
2978 foreach my $node (keys %$nodehash) {
2979 $nodehash->{$node}->{unavailable_storages
}->{$storeid} = 1;
2981 } elsif (my $avail = $scfg->{nodes
}) {
2982 foreach my $node (keys %$nodehash) {
2983 if (!$avail->{$node}) {
2984 $nodehash->{$node}->{unavailable_storages
}->{$storeid} = 1;
2991 foreach my $node (values %$nodehash) {
2992 if (my $unavail = $node->{unavailable_storages
}) {
2993 $node->{unavailable_storages
} = [ sort keys %$unavail ];
3001 my ($pidfile, $pid) = @_;
3003 my $fh = IO
::File-
>new("/proc/$pid/cmdline", "r");
3007 return undef if !$line;
3008 my @param = split(/\0/, $line);
3010 my $cmd = $param[0];
3011 return if !$cmd || ($cmd !~ m
|kvm
$| && $cmd !~ m
@(?
:^|/)qemu-system-[^/]+$@);
3013 for (my $i = 0; $i < scalar (@param); $i++) {
3016 if (($p eq '-pidfile') || ($p eq '--pidfile')) {
3017 my $p = $param[$i+1];
3018 return 1 if $p && ($p eq $pidfile);
3027 my ($vmid, $nocheck, $node) = @_;
3029 my $filename = PVE
::QemuConfig-
>config_file($vmid, $node);
3031 die "unable to find configuration file for VM $vmid - no such machine\n"
3032 if !$nocheck && ! -f
$filename;
3034 my $pidfile = pidfile_name
($vmid);
3036 if (my $fd = IO
::File-
>new("<$pidfile")) {
3041 my $mtime = $st->mtime;
3042 if ($mtime > time()) {
3043 warn "file '$filename' modified in future\n";
3046 if ($line =~ m/^(\d+)$/) {
3048 if (check_cmdline
($pidfile, $pid)) {
3049 if (my $pinfo = PVE
::ProcFSTools
::check_process_running
($pid)) {
3061 my $vzlist = config_list
();
3063 my $fd = IO
::Dir-
>new($var_run_tmpdir) || return $vzlist;
3065 while (defined(my $de = $fd->read)) {
3066 next if $de !~ m/^(\d+)\.pid$/;
3068 next if !defined($vzlist->{$vmid});
3069 if (my $pid = check_running
($vmid)) {
3070 $vzlist->{$vmid}->{pid
} = $pid;
3078 my ($storecfg, $conf) = @_;
3080 my $bootdisk = $conf->{bootdisk
};
3081 return undef if !$bootdisk;
3082 return undef if !is_valid_drivename
($bootdisk);
3084 return undef if !$conf->{$bootdisk};
3086 my $drive = parse_drive
($bootdisk, $conf->{$bootdisk});
3087 return undef if !defined($drive);
3089 return undef if drive_is_cdrom
($drive);
3091 my $volid = $drive->{file
};
3092 return undef if !$volid;
3094 return $drive->{size
};
3097 our $vmstatus_return_properties = {
3098 vmid
=> get_standard_option
('pve-vmid'),
3100 description
=> "Qemu process status.",
3102 enum
=> ['stopped', 'running'],
3105 description
=> "Maximum memory in bytes.",
3108 renderer
=> 'bytes',
3111 description
=> "Root disk size in bytes.",
3114 renderer
=> 'bytes',
3117 description
=> "VM name.",
3122 description
=> "Qemu QMP agent status.",
3127 description
=> "PID of running qemu process.",
3132 description
=> "Uptime.",
3135 renderer
=> 'duration',
3138 description
=> "Maximum usable CPUs.",
3143 description
=> "The current config lock, if any.",
3149 my $last_proc_pid_stat;
3151 # get VM status information
3152 # This must be fast and should not block ($full == false)
3153 # We only query KVM using QMP if $full == true (this can be slow)
3155 my ($opt_vmid, $full) = @_;
3159 my $storecfg = PVE
::Storage
::config
();
3161 my $list = vzlist
();
3162 my $defaults = load_defaults
();
3164 my ($uptime) = PVE
::ProcFSTools
::read_proc_uptime
(1);
3166 my $cpucount = $cpuinfo->{cpus
} || 1;
3168 foreach my $vmid (keys %$list) {
3169 next if $opt_vmid && ($vmid ne $opt_vmid);
3171 my $cfspath = PVE
::QemuConfig-
>cfs_config_path($vmid);
3172 my $conf = PVE
::Cluster
::cfs_read_file
($cfspath) || {};
3174 my $d = { vmid
=> $vmid };
3175 $d->{pid
} = $list->{$vmid}->{pid
};
3177 # fixme: better status?
3178 $d->{status
} = $list->{$vmid}->{pid
} ?
'running' : 'stopped';
3180 my $size = disksize
($storecfg, $conf);
3181 if (defined($size)) {
3182 $d->{disk
} = 0; # no info available
3183 $d->{maxdisk
} = $size;
3189 $d->{cpus
} = ($conf->{sockets
} || $defaults->{sockets
})
3190 * ($conf->{cores
} || $defaults->{cores
});
3191 $d->{cpus
} = $cpucount if $d->{cpus
} > $cpucount;
3192 $d->{cpus
} = $conf->{vcpus
} if $conf->{vcpus
};
3194 $d->{name
} = $conf->{name
} || "VM $vmid";
3195 $d->{maxmem
} = $conf->{memory
} ?
$conf->{memory
}*(1024*1024)
3196 : $defaults->{memory
}*(1024*1024);
3198 if ($conf->{balloon
}) {
3199 $d->{balloon_min
} = $conf->{balloon
}*(1024*1024);
3200 $d->{shares
} = defined($conf->{shares
}) ?
$conf->{shares
}
3201 : $defaults->{shares
};
3212 $d->{diskwrite
} = 0;
3214 $d->{template
} = PVE
::QemuConfig-
>is_template($conf);
3216 $d->{serial
} = 1 if conf_has_serial
($conf);
3217 $d->{lock} = $conf->{lock} if $conf->{lock};
3222 my $netdev = PVE
::ProcFSTools
::read_proc_net_dev
();
3223 foreach my $dev (keys %$netdev) {
3224 next if $dev !~ m/^tap([1-9]\d*)i/;
3226 my $d = $res->{$vmid};
3229 $d->{netout
} += $netdev->{$dev}->{receive
};
3230 $d->{netin
} += $netdev->{$dev}->{transmit
};
3233 $d->{nics
}->{$dev}->{netout
} = $netdev->{$dev}->{receive
};
3234 $d->{nics
}->{$dev}->{netin
} = $netdev->{$dev}->{transmit
};
3239 my $ctime = gettimeofday
;
3241 foreach my $vmid (keys %$list) {
3243 my $d = $res->{$vmid};
3244 my $pid = $d->{pid
};
3247 my $pstat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
3248 next if !$pstat; # not running
3250 my $used = $pstat->{utime} + $pstat->{stime
};
3252 $d->{uptime
} = int(($uptime - $pstat->{starttime
})/$cpuinfo->{user_hz
});
3254 if ($pstat->{vsize
}) {
3255 $d->{mem
} = int(($pstat->{rss
}/$pstat->{vsize
})*$d->{maxmem
});
3258 my $old = $last_proc_pid_stat->{$pid};
3260 $last_proc_pid_stat->{$pid} = {
3268 my $dtime = ($ctime - $old->{time}) * $cpucount * $cpuinfo->{user_hz
};
3270 if ($dtime > 1000) {
3271 my $dutime = $used - $old->{used
};
3273 $d->{cpu
} = (($dutime/$dtime)* $cpucount) / $d->{cpus
};
3274 $last_proc_pid_stat->{$pid} = {
3280 $d->{cpu
} = $old->{cpu
};
3284 return $res if !$full;
3286 my $qmpclient = PVE
::QMPClient-
>new();
3288 my $ballooncb = sub {
3289 my ($vmid, $resp) = @_;
3291 my $info = $resp->{'return'};
3292 return if !$info->{max_mem
};
3294 my $d = $res->{$vmid};
3296 # use memory assigned to VM
3297 $d->{maxmem
} = $info->{max_mem
};
3298 $d->{balloon
} = $info->{actual
};
3300 if (defined($info->{total_mem
}) && defined($info->{free_mem
})) {
3301 $d->{mem
} = $info->{total_mem
} - $info->{free_mem
};
3302 $d->{freemem
} = $info->{free_mem
};
3305 $d->{ballooninfo
} = $info;
3308 my $blockstatscb = sub {
3309 my ($vmid, $resp) = @_;
3310 my $data = $resp->{'return'} || [];
3311 my $totalrdbytes = 0;
3312 my $totalwrbytes = 0;
3314 for my $blockstat (@$data) {
3315 $totalrdbytes = $totalrdbytes + $blockstat->{stats
}->{rd_bytes
};
3316 $totalwrbytes = $totalwrbytes + $blockstat->{stats
}->{wr_bytes
};
3318 $blockstat->{device
} =~ s/drive-//;
3319 $res->{$vmid}->{blockstat
}->{$blockstat->{device
}} = $blockstat->{stats
};
3321 $res->{$vmid}->{diskread
} = $totalrdbytes;
3322 $res->{$vmid}->{diskwrite
} = $totalwrbytes;
3325 my $statuscb = sub {
3326 my ($vmid, $resp) = @_;
3328 $qmpclient->queue_cmd($vmid, $blockstatscb, 'query-blockstats');
3329 # this fails if ballon driver is not loaded, so this must be
3330 # the last commnand (following command are aborted if this fails).
3331 $qmpclient->queue_cmd($vmid, $ballooncb, 'query-balloon');
3333 my $status = 'unknown';
3334 if (!defined($status = $resp->{'return'}->{status
})) {
3335 warn "unable to get VM status\n";
3339 $res->{$vmid}->{qmpstatus
} = $resp->{'return'}->{status
};
3342 foreach my $vmid (keys %$list) {
3343 next if $opt_vmid && ($vmid ne $opt_vmid);
3344 next if !$res->{$vmid}->{pid
}; # not running
3345 $qmpclient->queue_cmd($vmid, $statuscb, 'query-status');
3348 $qmpclient->queue_execute(undef, 2);
3350 foreach my $vmid (keys %$list) {
3351 next if $opt_vmid && ($vmid ne $opt_vmid);
3352 $res->{$vmid}->{qmpstatus
} = $res->{$vmid}->{status
} if !$res->{$vmid}->{qmpstatus
};
3359 my ($conf, $func, @param) = @_;
3361 foreach my $ds (valid_drive_names
()) {
3362 next if !defined($conf->{$ds});
3364 my $drive = parse_drive
($ds, $conf->{$ds});
3367 &$func($ds, $drive, @param);
3372 my ($conf, $func, @param) = @_;
3376 my $test_volid = sub {
3377 my ($volid, $is_cdrom, $replicate, $shared, $snapname, $size) = @_;
3381 $volhash->{$volid}->{cdrom
} //= 1;
3382 $volhash->{$volid}->{cdrom
} = 0 if !$is_cdrom;
3384 $volhash->{$volid}->{replicate
} //= 0;
3385 $volhash->{$volid}->{replicate
} = 1 if $replicate;
3387 $volhash->{$volid}->{shared
} //= 0;
3388 $volhash->{$volid}->{shared
} = 1 if $shared;
3390 $volhash->{$volid}->{referenced_in_config
} //= 0;
3391 $volhash->{$volid}->{referenced_in_config
} = 1 if !defined($snapname);
3393 $volhash->{$volid}->{referenced_in_snapshot
}->{$snapname} = 1
3394 if defined($snapname);
3395 $volhash->{$volid}->{size
} = $size if $size;
3398 foreach_drive
($conf, sub {
3399 my ($ds, $drive) = @_;
3400 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, undef, $drive->{size
});
3403 foreach my $snapname (keys %{$conf->{snapshots
}}) {
3404 my $snap = $conf->{snapshots
}->{$snapname};
3405 $test_volid->($snap->{vmstate
}, 0, 1, $snapname);
3406 foreach_drive
($snap, sub {
3407 my ($ds, $drive) = @_;
3408 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, $snapname);
3412 foreach my $volid (keys %$volhash) {
3413 &$func($volid, $volhash->{$volid}, @param);
3417 sub conf_has_serial
{
3420 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3421 if ($conf->{"serial$i"}) {
3429 sub conf_has_audio
{
3430 my ($conf, $id) = @_;
3433 my $audio = $conf->{"audio$id"};
3434 return undef if !defined($audio);
3436 my $audioproperties = PVE
::JSONSchema
::parse_property_string
($audio_fmt, $audio);
3437 my $audiodriver = $audioproperties->{driver
} // 'spice';
3440 dev
=> $audioproperties->{device
},
3441 dev_id
=> "audiodev$id",
3442 backend
=> $audiodriver,
3443 backend_id
=> "$audiodriver-backend${id}",
3447 sub vga_conf_has_spice
{
3450 my $vgaconf = parse_vga
($vga);
3451 my $vgatype = $vgaconf->{type
};
3452 return 0 if !$vgatype || $vgatype !~ m/^qxl([234])?$/;
3457 my $host_arch; # FIXME: fix PVE::Tools::get_host_arch
3458 sub get_host_arch
() {
3459 $host_arch = (POSIX
::uname
())[4] if !$host_arch;
3465 return get_host_arch
() eq $arch;
3468 my $default_machines = {
3473 sub get_basic_machine_info
{
3474 my ($conf, $forcemachine) = @_;
3476 my $arch = $conf->{arch
} // get_host_arch
();
3477 my $machine = $forcemachine || $conf->{machine
} || $default_machines->{$arch};
3478 return ($arch, $machine);
3481 sub get_ovmf_files
($) {
3484 my $ovmf = $OVMF->{$arch}
3485 or die "no OVMF images known for architecture '$arch'\n";
3491 aarch64
=> '/usr/bin/qemu-system-aarch64',
3492 x86_64
=> '/usr/bin/qemu-system-x86_64',
3494 sub get_command_for_arch
($) {
3496 return '/usr/bin/kvm' if is_native
($arch);
3498 my $cmd = $Arch2Qemu->{$arch}
3499 or die "don't know how to emulate architecture '$arch'\n";
3503 sub get_cpu_options
{
3504 my ($conf, $arch, $kvm, $machine_type, $kvm_off, $kvmver, $winversion, $gpu_passthrough) = @_;
3507 my $ostype = $conf->{ostype
};
3509 my $cpu = $kvm ?
"kvm64" : "qemu64";
3510 if ($arch eq 'aarch64') {
3511 $cpu = 'cortex-a57';
3514 if (my $cputype = $conf->{cpu
}) {
3515 my $cpuconf = PVE
::JSONSchema
::parse_property_string
($cpu_fmt, $cputype)
3516 or die "Cannot parse cpu description: $cputype\n";
3517 $cpu = $cpuconf->{cputype
};
3518 $kvm_off = 1 if $cpuconf->{hidden
};
3519 $hv_vendor_id = $cpuconf->{'hv-vendor-id'};
3521 if (defined(my $flags = $cpuconf->{flags
})) {
3522 push @$cpuFlags, split(";", $flags);
3526 push @$cpuFlags , '+lahf_lm' if $cpu eq 'kvm64' && $arch eq 'x86_64';
3528 push @$cpuFlags , '-x2apic'
3529 if $conf->{ostype
} && $conf->{ostype
} eq 'solaris';
3531 push @$cpuFlags, '+sep' if $cpu eq 'kvm64' || $cpu eq 'kvm32';
3533 push @$cpuFlags, '-rdtscp' if $cpu =~ m/^Opteron/;
3535 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3) && $arch eq 'x86_64') {
3537 push @$cpuFlags , '+kvm_pv_unhalt' if $kvm;
3538 push @$cpuFlags , '+kvm_pv_eoi' if $kvm;
3541 add_hyperv_enlightenments
($cpuFlags, $winversion, $machine_type, $kvmver, $conf->{bios
}, $gpu_passthrough, $hv_vendor_id) if $kvm;
3543 push @$cpuFlags, 'enforce' if $cpu ne 'host' && $kvm && $arch eq 'x86_64';
3545 push @$cpuFlags, 'kvm=off' if $kvm_off;
3547 if (my $cpu_vendor = $cpu_vendor_list->{$cpu}) {
3548 push @$cpuFlags, "vendor=${cpu_vendor}"
3549 if $cpu_vendor ne 'default';
3550 } elsif ($arch ne 'aarch64') {
3551 die "internal error"; # should not happen
3554 $cpu .= "," . join(',', @$cpuFlags) if scalar(@$cpuFlags);
3556 return ('-cpu', $cpu);
3559 sub config_to_command
{
3560 my ($storecfg, $vmid, $conf, $defaults, $forcemachine) = @_;
3563 my $globalFlags = [];
3564 my $machineFlags = [];
3569 my $kvmver = kvm_user_version
();
3570 my $vernum = 0; # unknown
3571 my $ostype = $conf->{ostype
};
3572 my $winversion = windows_version
($ostype);
3573 my $kvm = $conf->{kvm
};
3575 my ($arch, $machine_type) = get_basic_machine_info
($conf, $forcemachine);
3576 $kvm //= 1 if is_native
($arch);
3579 die "KVM virtualisation configured, but not available. Either disable in VM configuration or enable in BIOS.\n"
3580 if !defined kvm_version
();
3583 if ($kvmver =~ m/^(\d+)\.(\d+)$/) {
3584 $vernum = $1*1000000+$2*1000;
3585 } elsif ($kvmver =~ m/^(\d+)\.(\d+)\.(\d+)$/) {
3586 $vernum = $1*1000000+$2*1000+$3;
3589 die "detected old qemu-kvm binary ($kvmver)\n" if $vernum < 15000;
3591 my $have_ovz = -f
'/proc/vz/vestat';
3593 my $q35 = machine_type_is_q35
($conf);
3594 my $hotplug_features = parse_hotplug_features
(defined($conf->{hotplug
}) ?
$conf->{hotplug
} : '1');
3595 my $use_old_bios_files = undef;
3596 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
3598 my $cpuunits = defined($conf->{cpuunits
}) ?
3599 $conf->{cpuunits
} : $defaults->{cpuunits
};
3601 push @$cmd, get_command_for_arch
($arch);
3603 push @$cmd, '-id', $vmid;
3605 my $vmname = $conf->{name
} || "vm$vmid";
3607 push @$cmd, '-name', $vmname;
3611 my $qmpsocket = qmp_socket
($vmid);
3612 push @$cmd, '-chardev', "socket,id=qmp,path=$qmpsocket,server,nowait";
3613 push @$cmd, '-mon', "chardev=qmp,mode=control";
3615 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 12)) {
3616 push @$cmd, '-chardev', "socket,id=qmp-event,path=/var/run/qmeventd.sock,reconnect=5";
3617 push @$cmd, '-mon', "chardev=qmp-event,mode=control";
3620 push @$cmd, '-pidfile' , pidfile_name
($vmid);
3622 push @$cmd, '-daemonize';
3624 if ($conf->{smbios1
}) {
3625 my $smbios_conf = parse_smbios1
($conf->{smbios1
});
3626 if ($smbios_conf->{base64
}) {
3627 # Do not pass base64 flag to qemu
3628 delete $smbios_conf->{base64
};
3629 my $smbios_string = "";
3630 foreach my $key (keys %$smbios_conf) {
3632 if ($key eq "uuid") {
3633 $value = $smbios_conf->{uuid
}
3635 $value = decode_base64
($smbios_conf->{$key});
3637 # qemu accepts any binary data, only commas need escaping by double comma
3639 $smbios_string .= "," . $key . "=" . $value if $value;
3641 push @$cmd, '-smbios', "type=1" . $smbios_string;
3643 push @$cmd, '-smbios', "type=1,$conf->{smbios1}";
3647 if ($conf->{vmgenid
}) {
3648 push @$devices, '-device', 'vmgenid,guid='.$conf->{vmgenid
};
3651 my ($ovmf_code, $ovmf_vars) = get_ovmf_files
($arch);
3652 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3653 die "uefi base image not found\n" if ! -f
$ovmf_code;
3657 if (my $efidisk = $conf->{efidisk0
}) {
3658 my $d = PVE
::JSONSchema
::parse_property_string
($efidisk_fmt, $efidisk);
3659 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($d->{file
}, 1);
3660 $format = $d->{format
};
3662 $path = PVE
::Storage
::path
($storecfg, $d->{file
});
3663 if (!defined($format)) {
3664 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
3665 $format = qemu_img_format
($scfg, $volname);
3669 die "efidisk format must be specified\n"
3670 if !defined($format);
3673 warn "no efidisk configured! Using temporary efivars disk.\n";
3674 $path = "/tmp/$vmid-ovmf.fd";
3675 PVE
::Tools
::file_copy
($ovmf_vars, $path, -s
$ovmf_vars);
3679 push @$cmd, '-drive', "if=pflash,unit=0,format=raw,readonly,file=$ovmf_code";
3680 push @$cmd, '-drive', "if=pflash,unit=1,format=$format,id=drive-efidisk0,file=$path";
3685 # we use different pcie-port hardware for qemu >= 4.0 for passthrough
3686 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 4, 0)) {
3687 push @$devices, '-readconfig', '/usr/share/qemu-server/pve-q35-4.0.cfg';
3689 push @$devices, '-readconfig', '/usr/share/qemu-server/pve-q35.cfg';
3693 # add usb controllers
3694 my @usbcontrollers = PVE
::QemuServer
::USB
::get_usb_controllers
($conf, $bridges, $arch, $machine_type, $usbdesc->{format
}, $MAX_USB_DEVICES);
3695 push @$devices, @usbcontrollers if @usbcontrollers;
3696 my $vga = parse_vga
($conf->{vga
});
3698 my $qxlnum = vga_conf_has_spice
($conf->{vga
});
3699 $vga->{type
} = 'qxl' if $qxlnum;
3701 if (!$vga->{type
}) {
3702 if ($arch eq 'aarch64') {
3703 $vga->{type
} = 'virtio';
3704 } elsif (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 9)) {
3705 $vga->{type
} = (!$winversion || $winversion >= 6) ?
'std' : 'cirrus';
3707 $vga->{type
} = ($winversion >= 6) ?
'std' : 'cirrus';
3711 # enable absolute mouse coordinates (needed by vnc)
3713 if (defined($conf->{tablet
})) {
3714 $tablet = $conf->{tablet
};
3716 $tablet = $defaults->{tablet
};
3717 $tablet = 0 if $qxlnum; # disable for spice because it is not needed
3718 $tablet = 0 if $vga->{type
} =~ m/^serial\d+$/; # disable if we use serial terminal (no vga card)
3722 push @$devices, '-device', print_tabletdevice_full
($conf, $arch) if $tablet;
3723 my $kbd = print_keyboarddevice_full
($conf, $arch);
3724 push @$devices, '-device', $kbd if defined($kbd);
3728 my $gpu_passthrough;
3731 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
3732 my $d = parse_hostpci
($conf->{"hostpci$i"});
3735 my $pcie = $d->{pcie
};
3737 die "q35 machine model is not enabled" if !$q35;
3738 # win7 wants to have the pcie devices directly on the pcie bus
3739 # instead of in the root port
3740 if ($winversion == 7) {
3741 $pciaddr = print_pcie_addr
("hostpci${i}bus0");
3743 $pciaddr = print_pcie_addr
("hostpci$i");
3746 $pciaddr = print_pci_addr
("hostpci$i", $bridges, $arch, $machine_type);
3749 my $rombar = defined($d->{rombar
}) && !$d->{rombar
} ?
',rombar=0' : '';
3750 my $romfile = $d->{romfile
};
3753 if ($d->{'x-vga'}) {
3754 $xvga = ',x-vga=on';
3756 $vga->{type
} = 'none' if !defined($conf->{vga
});
3757 $gpu_passthrough = 1;
3759 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3763 my $pcidevices = $d->{pciid
};
3764 my $multifunction = 1 if @$pcidevices > 1;
3766 if ($d->{mdev
} && scalar(@$pcidevices) == 1) {
3767 my $id = $pcidevices->[0]->{id
};
3768 my $uuid = PVE
::SysFSTools
::generate_mdev_uuid
($vmid, $i);
3769 $sysfspath = "/sys/bus/pci/devices/0000:$id/$uuid";
3770 } elsif ($d->{mdev
}) {
3771 warn "ignoring mediated device with multifunction device\n";
3775 foreach my $pcidevice (@$pcidevices) {
3777 my $id = "hostpci$i";
3778 $id .= ".$j" if $multifunction;
3779 my $addr = $pciaddr;
3780 $addr .= ".$j" if $multifunction;
3781 my $devicestr = "vfio-pci";
3783 $devicestr .= ",sysfsdev=$sysfspath";
3785 $devicestr .= ",host=$pcidevice->{id}";
3787 $devicestr .= ",id=$id$addr";
3790 $devicestr .= "$rombar$xvga";
3791 $devicestr .= ",multifunction=on" if $multifunction;
3792 $devicestr .= ",romfile=/usr/share/kvm/$romfile" if $romfile;
3795 push @$devices, '-device', $devicestr;
3801 my @usbdevices = PVE
::QemuServer
::USB
::get_usb_devices
($conf, $usbdesc->{format
}, $MAX_USB_DEVICES);
3802 push @$devices, @usbdevices if @usbdevices;
3804 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3805 if (my $path = $conf->{"serial$i"}) {
3806 if ($path eq 'socket') {
3807 my $socket = "/var/run/qemu-server/${vmid}.serial$i";
3808 push @$devices, '-chardev', "socket,id=serial$i,path=$socket,server,nowait";
3809 # On aarch64, serial0 is the UART device. Qemu only allows
3810 # connecting UART devices via the '-serial' command line, as
3811 # the device has a fixed slot on the hardware...
3812 if ($arch eq 'aarch64' && $i == 0) {
3813 push @$devices, '-serial', "chardev:serial$i";
3815 push @$devices, '-device', "isa-serial,chardev=serial$i";
3818 die "no such serial device\n" if ! -c
$path;
3819 push @$devices, '-chardev', "tty,id=serial$i,path=$path";
3820 push @$devices, '-device', "isa-serial,chardev=serial$i";
3826 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
3827 if (my $path = $conf->{"parallel$i"}) {
3828 die "no such parallel device\n" if ! -c
$path;
3829 my $devtype = $path =~ m!^/dev/usb/lp! ?
'tty' : 'parport';
3830 push @$devices, '-chardev', "$devtype,id=parallel$i,path=$path";
3831 push @$devices, '-device', "isa-parallel,chardev=parallel$i";
3835 if (my $audio = conf_has_audio
($conf)) {
3837 my $audiopciaddr = print_pci_addr
("audio0", $bridges, $arch, $machine_type);
3839 my $id = $audio->{dev_id
};
3840 if ($audio->{dev
} eq 'AC97') {
3841 push @$devices, '-device', "AC97,id=${id}${audiopciaddr}";
3842 } elsif ($audio->{dev
} =~ /intel\-hda$/) {
3843 push @$devices, '-device', "$audio->{dev},id=${id}${audiopciaddr}";
3844 push @$devices, '-device', "hda-micro,id=${id}-codec0,bus=${id}.0,cad=0";
3845 push @$devices, '-device', "hda-duplex,id=${id}-codec1,bus=${id}.0,cad=1";
3847 die "unkown audio device '$audio->{dev}', implement me!";
3850 push @$devices, '-audiodev', "$audio->{backend},id=$audio->{backend_id}";
3854 $sockets = $conf->{smp
} if $conf->{smp
}; # old style - no longer iused
3855 $sockets = $conf->{sockets
} if $conf->{sockets
};
3857 my $cores = $conf->{cores
} || 1;
3859 my $maxcpus = $sockets * $cores;
3861 my $vcpus = $conf->{vcpus
} ?
$conf->{vcpus
} : $maxcpus;
3863 my $allowed_vcpus = $cpuinfo->{cpus
};
3865 die "MAX $allowed_vcpus vcpus allowed per VM on this node\n"
3866 if ($allowed_vcpus < $maxcpus);
3868 if($hotplug_features->{cpu
} && qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 7)) {
3870 push @$cmd, '-smp', "1,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3871 for (my $i = 2; $i <= $vcpus; $i++) {
3872 my $cpustr = print_cpu_device
($conf,$i);
3873 push @$cmd, '-device', $cpustr;
3878 push @$cmd, '-smp', "$vcpus,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3880 push @$cmd, '-nodefaults';
3882 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
3884 my $bootindex_hash = {};
3886 foreach my $o (split(//, $bootorder)) {
3887 $bootindex_hash->{$o} = $i*100;
3891 push @$cmd, '-boot', "menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg";
3893 push @$cmd, '-no-acpi' if defined($conf->{acpi
}) && $conf->{acpi
} == 0;
3895 push @$cmd, '-no-reboot' if defined($conf->{reboot
}) && $conf->{reboot
} == 0;
3897 if ($vga->{type
} && $vga->{type
} !~ m/^serial\d+$/ && $vga->{type
} ne 'none'){
3898 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_type, undef, $qxlnum, $bridges);
3899 my $socket = vnc_socket
($vmid);
3900 push @$cmd, '-vnc', "unix:$socket,password";
3902 push @$cmd, '-vga', 'none' if $vga->{type
} eq 'none';
3903 push @$cmd, '-nographic';
3907 my $tdf = defined($conf->{tdf
}) ?
$conf->{tdf
} : $defaults->{tdf
};
3909 my $useLocaltime = $conf->{localtime};
3911 if ($winversion >= 5) { # windows
3912 $useLocaltime = 1 if !defined($conf->{localtime});
3914 # use time drift fix when acpi is enabled
3915 if (!(defined($conf->{acpi
}) && $conf->{acpi
} == 0)) {
3916 $tdf = 1 if !defined($conf->{tdf
});
3920 if ($winversion >= 6) {
3921 push @$globalFlags, 'kvm-pit.lost_tick_policy=discard';
3922 push @$cmd, '-no-hpet';
3925 push @$rtcFlags, 'driftfix=slew' if $tdf;
3928 push @$machineFlags, 'accel=tcg';
3931 if ($machine_type) {
3932 push @$machineFlags, "type=${machine_type}";
3935 if (($conf->{startdate
}) && ($conf->{startdate
} ne 'now')) {
3936 push @$rtcFlags, "base=$conf->{startdate}";
3937 } elsif ($useLocaltime) {
3938 push @$rtcFlags, 'base=localtime';
3941 push @$cmd, get_cpu_options
($conf, $arch, $kvm, $machine_type, $kvm_off, $kvmver, $winversion, $gpu_passthrough);
3943 PVE
::QemuServer
::Memory
::config
($conf, $vmid, $sockets, $cores, $defaults, $hotplug_features, $cmd);
3945 push @$cmd, '-S' if $conf->{freeze
};
3947 push @$cmd, '-k', $conf->{keyboard
} if defined($conf->{keyboard
});
3949 if (parse_guest_agent
($conf)->{enabled
}) {
3950 my $qgasocket = qmp_socket
($vmid, 1);
3951 my $pciaddr = print_pci_addr
("qga0", $bridges, $arch, $machine_type);
3952 push @$devices, '-chardev', "socket,path=$qgasocket,server,nowait,id=qga0";
3953 push @$devices, '-device', "virtio-serial,id=qga0$pciaddr";
3954 push @$devices, '-device', 'virtserialport,chardev=qga0,name=org.qemu.guest_agent.0';
3962 for(my $i = 1; $i < $qxlnum; $i++){
3963 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_type, $i, $qxlnum, $bridges);
3966 # assume other OS works like Linux
3967 my ($ram, $vram) = ("134217728", "67108864");
3968 if ($vga->{memory
}) {
3969 $ram = PVE
::Tools
::convert_size
($qxlnum*4*$vga->{memory
}, 'mb' => 'b');
3970 $vram = PVE
::Tools
::convert_size
($qxlnum*2*$vga->{memory
}, 'mb' => 'b');
3972 push @$cmd, '-global', "qxl-vga.ram_size=$ram";
3973 push @$cmd, '-global', "qxl-vga.vram_size=$vram";
3977 my $pciaddr = print_pci_addr
("spice", $bridges, $arch, $machine_type);
3979 my $nodename = PVE
::INotify
::nodename
();
3980 my $pfamily = PVE
::Tools
::get_host_address_family
($nodename);
3981 my @nodeaddrs = PVE
::Tools
::getaddrinfo_all
('localhost', family
=> $pfamily);
3982 die "failed to get an ip address of type $pfamily for 'localhost'\n" if !@nodeaddrs;
3983 my $localhost = PVE
::Network
::addr_to_ip
($nodeaddrs[0]->{addr
});
3984 $spice_port = PVE
::Tools
::next_spice_port
($pfamily, $localhost);
3986 push @$devices, '-spice', "tls-port=${spice_port},addr=$localhost,tls-ciphers=HIGH,seamless-migration=on";
3988 push @$devices, '-device', "virtio-serial,id=spice$pciaddr";
3989 push @$devices, '-chardev', "spicevmc,id=vdagent,name=vdagent";
3990 push @$devices, '-device', "virtserialport,chardev=vdagent,name=com.redhat.spice.0";
3993 # enable balloon by default, unless explicitly disabled
3994 if (!defined($conf->{balloon
}) || $conf->{balloon
}) {
3995 $pciaddr = print_pci_addr
("balloon0", $bridges, $arch, $machine_type);
3996 push @$devices, '-device', "virtio-balloon-pci,id=balloon0$pciaddr";
3999 if ($conf->{watchdog
}) {
4000 my $wdopts = parse_watchdog
($conf->{watchdog
});
4001 $pciaddr = print_pci_addr
("watchdog", $bridges, $arch, $machine_type);
4002 my $watchdog = $wdopts->{model
} || 'i6300esb';
4003 push @$devices, '-device', "$watchdog$pciaddr";
4004 push @$devices, '-watchdog-action', $wdopts->{action
} if $wdopts->{action
};
4008 my $scsicontroller = {};
4009 my $ahcicontroller = {};
4010 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : $defaults->{scsihw
};
4012 # Add iscsi initiator name if available
4013 if (my $initiator = get_initiator_name
()) {
4014 push @$devices, '-iscsi', "initiator-name=$initiator";
4017 foreach_drive
($conf, sub {
4018 my ($ds, $drive) = @_;
4020 if (PVE
::Storage
::parse_volume_id
($drive->{file
}, 1)) {
4021 push @$vollist, $drive->{file
};
4024 # ignore efidisk here, already added in bios/fw handling code above
4025 return if $drive->{interface
} eq 'efidisk';
4027 $use_virtio = 1 if $ds =~ m/^virtio/;
4029 if (drive_is_cdrom
($drive)) {
4030 if ($bootindex_hash->{d
}) {
4031 $drive->{bootindex
} = $bootindex_hash->{d
};
4032 $bootindex_hash->{d
} += 1;
4035 if ($bootindex_hash->{c
}) {
4036 $drive->{bootindex
} = $bootindex_hash->{c
} if $conf->{bootdisk
} && ($conf->{bootdisk
} eq $ds);
4037 $bootindex_hash->{c
} += 1;
4041 if($drive->{interface
} eq 'virtio'){
4042 push @$cmd, '-object', "iothread,id=iothread-$ds" if $drive->{iothread
};
4045 if ($drive->{interface
} eq 'scsi') {
4047 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
4049 $pciaddr = print_pci_addr
("$controller_prefix$controller", $bridges, $arch, $machine_type);
4050 my $scsihw_type = $scsihw =~ m/^virtio-scsi-single/ ?
"virtio-scsi-pci" : $scsihw;
4053 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{iothread
}){
4054 $iothread .= ",iothread=iothread-$controller_prefix$controller";
4055 push @$cmd, '-object', "iothread,id=iothread-$controller_prefix$controller";
4056 } elsif ($drive->{iothread
}) {
4057 warn "iothread is only valid with virtio disk or virtio-scsi-single controller, ignoring\n";
4061 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{queues
}){
4062 $queues = ",num_queues=$drive->{queues}";
4065 push @$devices, '-device', "$scsihw_type,id=$controller_prefix$controller$pciaddr$iothread$queues" if !$scsicontroller->{$controller};
4066 $scsicontroller->{$controller}=1;
4069 if ($drive->{interface
} eq 'sata') {
4070 my $controller = int($drive->{index} / $MAX_SATA_DISKS);
4071 $pciaddr = print_pci_addr
("ahci$controller", $bridges, $arch, $machine_type);
4072 push @$devices, '-device', "ahci,id=ahci$controller,multifunction=on$pciaddr" if !$ahcicontroller->{$controller};
4073 $ahcicontroller->{$controller}=1;
4076 my $drive_cmd = print_drive_full
($storecfg, $vmid, $drive);
4077 push @$devices, '-drive',$drive_cmd;
4078 push @$devices, '-device', print_drivedevice_full
($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type);
4081 for (my $i = 0; $i < $MAX_NETS; $i++) {
4082 next if !$conf->{"net$i"};
4083 my $d = parse_net
($conf->{"net$i"});
4086 $use_virtio = 1 if $d->{model
} eq 'virtio';
4088 if ($bootindex_hash->{n
}) {
4089 $d->{bootindex
} = $bootindex_hash->{n
};
4090 $bootindex_hash->{n
} += 1;
4093 my $netdevfull = print_netdev_full
($vmid, $conf, $arch, $d, "net$i");
4094 push @$devices, '-netdev', $netdevfull;
4096 my $netdevicefull = print_netdevice_full
($vmid, $conf, $d, "net$i", $bridges, $use_old_bios_files, $arch, $machine_type);
4097 push @$devices, '-device', $netdevicefull;
4100 if ($conf->{ivshmem
}) {
4101 my $ivshmem = PVE
::JSONSchema
::parse_property_string
($ivshmem_fmt, $conf->{ivshmem
});
4105 $bus = print_pcie_addr
("ivshmem");
4107 $bus = print_pci_addr
("ivshmem", $bridges, $arch, $machine_type);
4110 my $ivshmem_name = $ivshmem->{name
} // $vmid;
4111 my $path = '/dev/shm/pve-shm-' . $ivshmem_name;
4113 push @$devices, '-device', "ivshmem-plain,memdev=ivshmem$bus,";
4114 push @$devices, '-object', "memory-backend-file,id=ivshmem,share=on,mem-path=$path,size=$ivshmem->{size}M";
4119 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
4124 $bridges->{3} = 1 if $scsihw =~ m/^virtio-scsi-single/;
4126 while (my ($k, $v) = each %$bridges) {
4127 $pciaddr = print_pci_addr
("pci.$k", undef, $arch, $machine_type);
4128 unshift @$devices, '-device', "pci-bridge,id=pci.$k,chassis_nr=$k$pciaddr" if $k > 0;
4132 push @$cmd, @$devices;
4133 push @$cmd, '-rtc', join(',', @$rtcFlags)
4134 if scalar(@$rtcFlags);
4135 push @$cmd, '-machine', join(',', @$machineFlags)
4136 if scalar(@$machineFlags);
4137 push @$cmd, '-global', join(',', @$globalFlags)
4138 if scalar(@$globalFlags);
4140 if (my $vmstate = $conf->{vmstate
}) {
4141 my $statepath = PVE
::Storage
::path
($storecfg, $vmstate);
4142 PVE
::Storage
::activate_volumes
($storecfg, [$vmstate]);
4143 push @$cmd, '-loadstate', $statepath;
4147 if ($conf->{args
}) {
4148 my $aa = PVE
::Tools
::split_args
($conf->{args
});
4152 return wantarray ?
($cmd, $vollist, $spice_port) : $cmd;
4157 return "${var_run_tmpdir}/$vmid.vnc";
4163 my $res = vm_mon_cmd
($vmid, 'query-spice');
4165 return $res->{'tls-port'} || $res->{'port'} || die "no spice port\n";
4169 my ($vmid, $qga, $name) = @_;
4170 my $sockettype = $qga ?
'qga' : 'qmp';
4171 my $ext = $name ?
'-'.$name : '';
4172 return "${var_run_tmpdir}/$vmid$ext.$sockettype";
4177 return "${var_run_tmpdir}/$vmid.pid";
4180 sub vm_devices_list
{
4183 my $res = vm_mon_cmd
($vmid, 'query-pci');
4184 my $devices_to_check = [];
4186 foreach my $pcibus (@$res) {
4187 push @$devices_to_check, @{$pcibus->{devices
}},
4190 while (@$devices_to_check) {
4192 for my $d (@$devices_to_check) {
4193 $devices->{$d->{'qdev_id'}} = 1 if $d->{'qdev_id'};
4194 next if !$d->{'pci_bridge'};
4196 $devices->{$d->{'qdev_id'}} += scalar(@{$d->{'pci_bridge'}->{devices
}});
4197 push @$to_check, @{$d->{'pci_bridge'}->{devices
}};
4199 $devices_to_check = $to_check;
4202 my $resblock = vm_mon_cmd
($vmid, 'query-block');
4203 foreach my $block (@$resblock) {
4204 if($block->{device
} =~ m/^drive-(\S+)/){
4209 my $resmice = vm_mon_cmd
($vmid, 'query-mice');
4210 foreach my $mice (@$resmice) {
4211 if ($mice->{name
} eq 'QEMU HID Tablet') {
4212 $devices->{tablet
} = 1;
4217 # for usb devices there is no query-usb
4218 # but we can iterate over the entries in
4219 # qom-list path=/machine/peripheral
4220 my $resperipheral = vm_mon_cmd
($vmid, 'qom-list', path
=> '/machine/peripheral');
4221 foreach my $per (@$resperipheral) {
4222 if ($per->{name
} =~ m/^usb\d+$/) {
4223 $devices->{$per->{name
}} = 1;
4231 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4233 my $q35 = machine_type_is_q35
($conf);
4235 my $devices_list = vm_devices_list
($vmid);
4236 return 1 if defined($devices_list->{$deviceid});
4238 qemu_add_pci_bridge
($storecfg, $conf, $vmid, $deviceid, $arch, $machine_type); # add PCI bridge if we need it for the device
4240 if ($deviceid eq 'tablet') {
4242 qemu_deviceadd
($vmid, print_tabletdevice_full
($conf, $arch));
4244 } elsif ($deviceid eq 'keyboard') {
4246 qemu_deviceadd
($vmid, print_keyboarddevice_full
($conf, $arch));
4248 } elsif ($deviceid =~ m/^usb(\d+)$/) {
4250 die "usb hotplug currently not reliable\n";
4251 # since we can't reliably hot unplug all added usb devices
4252 # and usb passthrough disables live migration
4253 # we disable usb hotplugging for now
4254 qemu_deviceadd
($vmid, PVE
::QemuServer
::USB
::print_usbdevice_full
($conf, $deviceid, $device));
4256 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4258 qemu_iothread_add
($vmid, $deviceid, $device);
4260 qemu_driveadd
($storecfg, $vmid, $device);
4261 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4263 qemu_deviceadd
($vmid, $devicefull);
4264 eval { qemu_deviceaddverify
($vmid, $deviceid); };
4266 eval { qemu_drivedel
($vmid, $deviceid); };
4271 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4274 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : "lsi";
4275 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4276 my $scsihw_type = $scsihw eq 'virtio-scsi-single' ?
"virtio-scsi-pci" : $scsihw;
4278 my $devicefull = "$scsihw_type,id=$deviceid$pciaddr";
4280 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{iothread
}) {
4281 qemu_iothread_add
($vmid, $deviceid, $device);
4282 $devicefull .= ",iothread=iothread-$deviceid";
4285 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{queues
}) {
4286 $devicefull .= ",num_queues=$device->{queues}";
4289 qemu_deviceadd
($vmid, $devicefull);
4290 qemu_deviceaddverify
($vmid, $deviceid);
4292 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4294 qemu_findorcreatescsihw
($storecfg,$conf, $vmid, $device, $arch, $machine_type);
4295 qemu_driveadd
($storecfg, $vmid, $device);
4297 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4298 eval { qemu_deviceadd
($vmid, $devicefull); };
4300 eval { qemu_drivedel
($vmid, $deviceid); };
4305 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4307 return undef if !qemu_netdevadd
($vmid, $conf, $arch, $device, $deviceid);
4309 my $machine_type = PVE
::QemuServer
::qemu_machine_pxe
($vmid, $conf);
4310 my $use_old_bios_files = undef;
4311 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
4313 my $netdevicefull = print_netdevice_full
($vmid, $conf, $device, $deviceid, undef, $use_old_bios_files, $arch, $machine_type);
4314 qemu_deviceadd
($vmid, $netdevicefull);
4316 qemu_deviceaddverify
($vmid, $deviceid);
4317 qemu_set_link_status
($vmid, $deviceid, !$device->{link_down
});
4320 eval { qemu_netdevdel
($vmid, $deviceid); };
4325 } elsif (!$q35 && $deviceid =~ m/^(pci\.)(\d+)$/) {
4328 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4329 my $devicefull = "pci-bridge,id=pci.$bridgeid,chassis_nr=$bridgeid$pciaddr";
4331 qemu_deviceadd
($vmid, $devicefull);
4332 qemu_deviceaddverify
($vmid, $deviceid);
4335 die "can't hotplug device '$deviceid'\n";
4341 # fixme: this should raise exceptions on error!
4342 sub vm_deviceunplug
{
4343 my ($vmid, $conf, $deviceid) = @_;
4345 my $devices_list = vm_devices_list
($vmid);
4346 return 1 if !defined($devices_list->{$deviceid});
4348 die "can't unplug bootdisk" if $conf->{bootdisk
} && $conf->{bootdisk
} eq $deviceid;
4350 if ($deviceid eq 'tablet' || $deviceid eq 'keyboard') {
4352 qemu_devicedel
($vmid, $deviceid);
4354 } elsif ($deviceid =~ m/^usb\d+$/) {
4356 die "usb hotplug currently not reliable\n";
4357 # when unplugging usb devices this way,
4358 # there may be remaining usb controllers/hubs
4359 # so we disable it for now
4360 qemu_devicedel
($vmid, $deviceid);
4361 qemu_devicedelverify
($vmid, $deviceid);
4363 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4365 qemu_devicedel
($vmid, $deviceid);
4366 qemu_devicedelverify
($vmid, $deviceid);
4367 qemu_drivedel
($vmid, $deviceid);
4368 qemu_iothread_del
($conf, $vmid, $deviceid);
4370 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4372 qemu_devicedel
($vmid, $deviceid);
4373 qemu_devicedelverify
($vmid, $deviceid);
4374 qemu_iothread_del
($conf, $vmid, $deviceid);
4376 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4378 qemu_devicedel
($vmid, $deviceid);
4379 qemu_drivedel
($vmid, $deviceid);
4380 qemu_deletescsihw
($conf, $vmid, $deviceid);
4382 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4384 qemu_devicedel
($vmid, $deviceid);
4385 qemu_devicedelverify
($vmid, $deviceid);
4386 qemu_netdevdel
($vmid, $deviceid);
4389 die "can't unplug device '$deviceid'\n";
4395 sub qemu_deviceadd
{
4396 my ($vmid, $devicefull) = @_;
4398 $devicefull = "driver=".$devicefull;
4399 my %options = split(/[=,]/, $devicefull);
4401 vm_mon_cmd
($vmid, "device_add" , %options);
4404 sub qemu_devicedel
{
4405 my ($vmid, $deviceid) = @_;
4407 my $ret = vm_mon_cmd
($vmid, "device_del", id
=> $deviceid);
4410 sub qemu_iothread_add
{
4411 my($vmid, $deviceid, $device) = @_;
4413 if ($device->{iothread
}) {
4414 my $iothreads = vm_iothreads_list
($vmid);
4415 qemu_objectadd
($vmid, "iothread-$deviceid", "iothread") if !$iothreads->{"iothread-$deviceid"};
4419 sub qemu_iothread_del
{
4420 my($conf, $vmid, $deviceid) = @_;
4422 my $confid = $deviceid;
4423 if ($deviceid =~ m/^(?:virtioscsi|scsihw)(\d+)$/) {
4424 $confid = 'scsi' . $1;
4426 my $device = parse_drive
($confid, $conf->{$confid});
4427 if ($device->{iothread
}) {
4428 my $iothreads = vm_iothreads_list
($vmid);
4429 qemu_objectdel
($vmid, "iothread-$deviceid") if $iothreads->{"iothread-$deviceid"};
4433 sub qemu_objectadd
{
4434 my($vmid, $objectid, $qomtype) = @_;
4436 vm_mon_cmd
($vmid, "object-add", id
=> $objectid, "qom-type" => $qomtype);
4441 sub qemu_objectdel
{
4442 my($vmid, $objectid) = @_;
4444 vm_mon_cmd
($vmid, "object-del", id
=> $objectid);
4450 my ($storecfg, $vmid, $device) = @_;
4452 my $drive = print_drive_full
($storecfg, $vmid, $device);
4453 $drive =~ s/\\/\\\\/g;
4454 my $ret = vm_human_monitor_command
($vmid, "drive_add auto \"$drive\"");
4456 # If the command succeeds qemu prints: "OK
"
4457 return 1 if $ret =~ m/OK/s;
4459 die "adding drive failed
: $ret\n";
4463 my($vmid, $deviceid) = @_;
4465 my $ret = vm_human_monitor_command($vmid, "drive_del drive-
$deviceid");
4468 return 1 if $ret eq "";
4470 # NB: device not found errors mean the drive was auto-deleted and we ignore the error
4471 return 1 if $ret =~ m/Device \'.*?\' not found/s;
4473 die "deleting drive
$deviceid failed
: $ret\n";
4476 sub qemu_deviceaddverify {
4477 my ($vmid, $deviceid) = @_;
4479 for (my $i = 0; $i <= 5; $i++) {
4480 my $devices_list = vm_devices_list($vmid);
4481 return 1 if defined($devices_list->{$deviceid});
4485 die "error on hotplug device
'$deviceid'\n";
4489 sub qemu_devicedelverify {
4490 my ($vmid, $deviceid) = @_;
4492 # need to verify that the device is correctly removed as device_del
4493 # is async and empty return is not reliable
4495 for (my $i = 0; $i <= 5; $i++) {
4496 my $devices_list = vm_devices_list($vmid);
4497 return 1 if !defined($devices_list->{$deviceid});
4501 die "error on hot-unplugging device
'$deviceid'\n";
4504 sub qemu_findorcreatescsihw {
4505 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4507 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4509 my $scsihwid="$controller_prefix$controller";
4510 my $devices_list = vm_devices_list($vmid);
4512 if(!defined($devices_list->{$scsihwid})) {
4513 vm_deviceplug($storecfg, $conf, $vmid, $scsihwid, $device, $arch, $machine_type);
4519 sub qemu_deletescsihw {
4520 my ($conf, $vmid, $opt) = @_;
4522 my $device = parse_drive($opt, $conf->{$opt});
4524 if ($conf->{scsihw} && ($conf->{scsihw} eq 'virtio-scsi-single')) {
4525 vm_deviceunplug($vmid, $conf, "virtioscsi
$device->{index}");
4529 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4531 my $devices_list = vm_devices_list($vmid);
4532 foreach my $opt (keys %{$devices_list}) {
4533 if (PVE::QemuServer::is_valid_drivename($opt)) {
4534 my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
4535 if($drive->{interface} eq 'scsi' && $drive->{index} < (($maxdev-1)*($controller+1))) {
4541 my $scsihwid="scsihw
$controller";
4543 vm_deviceunplug($vmid, $conf, $scsihwid);
4548 sub qemu_add_pci_bridge {
4549 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4555 print_pci_addr($device, $bridges, $arch, $machine_type);
4557 while (my ($k, $v) = each %$bridges) {
4560 return 1 if !defined($bridgeid) || $bridgeid < 1;
4562 my $bridge = "pci
.$bridgeid";
4563 my $devices_list = vm_devices_list($vmid);
4565 if (!defined($devices_list->{$bridge})) {
4566 vm_deviceplug($storecfg, $conf, $vmid, $bridge, $arch, $machine_type);
4572 sub qemu_set_link_status {
4573 my ($vmid, $device, $up) = @_;
4575 vm_mon_cmd($vmid, "set_link
", name => $device,
4576 up => $up ? JSON::true : JSON::false);
4579 sub qemu_netdevadd {
4580 my ($vmid, $conf, $arch, $device, $deviceid) = @_;
4582 my $netdev = print_netdev_full($vmid, $conf, $arch, $device, $deviceid, 1);
4583 my %options = split(/[=,]/, $netdev);
4585 vm_mon_cmd($vmid, "netdev_add
", %options);
4589 sub qemu_netdevdel {
4590 my ($vmid, $deviceid) = @_;
4592 vm_mon_cmd($vmid, "netdev_del
", id => $deviceid);
4595 sub qemu_usb_hotplug {
4596 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4600 # remove the old one first
4601 vm_deviceunplug($vmid, $conf, $deviceid);
4603 # check if xhci controller is necessary and available
4604 if ($device->{usb3}) {
4606 my $devicelist = vm_devices_list($vmid);
4608 if (!$devicelist->{xhci}) {
4609 my $pciaddr = print_pci_addr("xhci
", undef, $arch, $machine_type);
4610 qemu_deviceadd($vmid, "nec-usb-xhci
,id
=xhci
$pciaddr");
4613 my $d = parse_usb_device($device->{host});
4614 $d->{usb3} = $device->{usb3};
4617 vm_deviceplug($storecfg, $conf, $vmid, $deviceid, $d, $arch, $machine_type);
4620 sub qemu_cpu_hotplug {
4621 my ($vmid, $conf, $vcpus) = @_;
4623 my $machine_type = PVE::QemuServer::get_current_qemu_machine($vmid);
4626 $sockets = $conf->{smp} if $conf->{smp}; # old style - no longer iused
4627 $sockets = $conf->{sockets} if $conf->{sockets};
4628 my $cores = $conf->{cores} || 1;
4629 my $maxcpus = $sockets * $cores;
4631 $vcpus = $maxcpus if !$vcpus;
4633 die "you can
't add more vcpus than maxcpus\n"
4634 if $vcpus > $maxcpus;
4636 my $currentvcpus = $conf->{vcpus} || $maxcpus;
4638 if ($vcpus < $currentvcpus) {
4640 if (qemu_machine_feature_enabled ($machine_type, undef, 2, 7)) {
4642 for (my $i = $currentvcpus; $i > $vcpus; $i--) {
4643 qemu_devicedel($vmid, "cpu$i");
4645 my $currentrunningvcpus = undef;
4647 $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4648 last if scalar(@{$currentrunningvcpus}) == $i-1;
4649 raise_param_exc({ vcpus => "error unplugging cpu$i" }) if $retry > 5;
4653 #update conf after each succesfull cpu unplug
4654 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4655 PVE::QemuConfig->write_config($vmid, $conf);
4658 die "cpu hot-unplugging requires qemu version 2.7 or higher\n";
4664 my $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4665 die "vcpus in running vm does not match its configuration\n"
4666 if scalar(@{$currentrunningvcpus}) != $currentvcpus;
4668 if (qemu_machine_feature_enabled ($machine_type, undef, 2, 7)) {
4670 for (my $i = $currentvcpus+1; $i <= $vcpus; $i++) {
4671 my $cpustr = print_cpu_device($conf, $i);
4672 qemu_deviceadd($vmid, $cpustr);
4675 my $currentrunningvcpus = undef;
4677 $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4678 last if scalar(@{$currentrunningvcpus}) == $i;
4679 raise_param_exc({ vcpus => "error hotplugging cpu$i" }) if $retry > 10;
4683 #update conf after each succesfull cpu hotplug
4684 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4685 PVE::QemuConfig->write_config($vmid, $conf);
4689 for (my $i = $currentvcpus; $i < $vcpus; $i++) {
4690 vm_mon_cmd($vmid, "cpu-add", id => int($i));
4695 sub qemu_block_set_io_throttle {
4696 my ($vmid, $deviceid,
4697 $bps, $bps_rd, $bps_wr, $iops, $iops_rd, $iops_wr,
4698 $bps_max, $bps_rd_max, $bps_wr_max, $iops_max, $iops_rd_max, $iops_wr_max,
4699 $bps_max_length, $bps_rd_max_length, $bps_wr_max_length,
4700 $iops_max_length, $iops_rd_max_length, $iops_wr_max_length) = @_;
4702 return if !check_running($vmid) ;
4704 vm_mon_cmd($vmid, "block_set_io_throttle", device => $deviceid,
4706 bps_rd => int($bps_rd),
4707 bps_wr => int($bps_wr),
4709 iops_rd => int($iops_rd),
4710 iops_wr => int($iops_wr),
4711 bps_max => int($bps_max),
4712 bps_rd_max => int($bps_rd_max),
4713 bps_wr_max => int($bps_wr_max),
4714 iops_max => int($iops_max),
4715 iops_rd_max => int($iops_rd_max),
4716 iops_wr_max => int($iops_wr_max),
4717 bps_max_length => int($bps_max_length),
4718 bps_rd_max_length => int($bps_rd_max_length),
4719 bps_wr_max_length => int($bps_wr_max_length),
4720 iops_max_length => int($iops_max_length),
4721 iops_rd_max_length => int($iops_rd_max_length),
4722 iops_wr_max_length => int($iops_wr_max_length),
4727 # old code, only used to shutdown old VM after update
4729 my ($fh, $timeout) = @_;
4731 my $sel = new IO::Select;
4738 while (scalar (@ready = $sel->can_read($timeout))) {
4740 if ($count = $fh->sysread($buf, 8192)) {
4741 if ($buf =~ /^(.*)\(qemu\) $/s) {
4748 if (!defined($count)) {
4755 die "monitor read timeout\n" if !scalar(@ready);
4760 sub qemu_block_resize {
4761 my ($vmid, $deviceid, $storecfg, $volid, $size) = @_;
4763 my $running = check_running($vmid);
4765 $size = 0 if !PVE::Storage::volume_resize($storecfg, $volid, $size, $running);
4767 return if !$running;
4769 vm_mon_cmd($vmid, "block_resize", device => $deviceid, size => int($size));
4773 sub qemu_volume_snapshot {
4774 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4776 my $running = check_running($vmid);
4778 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4779 vm_mon_cmd($vmid, 'blockdev-snapshot-internal-sync
', device => $deviceid, name => $snap);
4781 PVE::Storage::volume_snapshot($storecfg, $volid, $snap);
4785 sub qemu_volume_snapshot_delete {
4786 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4788 my $running = check_running($vmid);
4793 my $conf = PVE::QemuConfig->load_config($vmid);
4794 foreach_drive($conf, sub {
4795 my ($ds, $drive) = @_;
4796 $running = 1 if $drive->{file} eq $volid;
4800 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4801 vm_mon_cmd($vmid, 'blockdev-snapshot-delete-internal-sync
', device => $deviceid, name => $snap);
4803 PVE::Storage::volume_snapshot_delete($storecfg, $volid, $snap, $running);
4807 sub set_migration_caps {
4813 "auto-converge" => 1,
4815 "x-rdma-pin-all" => 0,
4820 my $supported_capabilities = vm_mon_cmd_nocheck($vmid, "query-migrate-capabilities");
4822 for my $supported_capability (@$supported_capabilities) {
4824 capability => $supported_capability->{capability},
4825 state => $enabled_cap->{$supported_capability->{capability}} ? JSON::true : JSON::false,
4829 vm_mon_cmd_nocheck($vmid, "migrate-set-capabilities", capabilities => $cap_ref);
4832 my $fast_plug_option = {
4840 'vmstatestorage
' => 1,
4844 # hotplug changes in [PENDING]
4845 # $selection hash can be used to only apply specified options, for
4846 # example: { cores => 1 } (only apply changed 'cores
')
4847 # $errors ref is used to return error messages
4848 sub vmconfig_hotplug_pending {
4849 my ($vmid, $conf, $storecfg, $selection, $errors) = @_;
4851 my $defaults = load_defaults();
4852 my ($arch, $machine_type) = get_basic_machine_info($conf, undef);
4854 # commit values which do not have any impact on running VM first
4855 # Note: those option cannot raise errors, we we do not care about
4856 # $selection and always apply them.
4858 my $add_error = sub {
4859 my ($opt, $msg) = @_;
4860 $errors->{$opt} = "hotplug problem - $msg";
4864 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4865 if ($fast_plug_option->{$opt}) {
4866 $conf->{$opt} = $conf->{pending}->{$opt};
4867 delete $conf->{pending}->{$opt};
4873 PVE::QemuConfig->write_config($vmid, $conf);
4874 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4877 my $hotplug_features = parse_hotplug_features(defined($conf->{hotplug}) ? $conf->{hotplug} : '1');
4879 my $pending_delete_hash = split_flagged_list($conf->{pending}->{delete});
4880 while (my ($opt, $force) = each %$pending_delete_hash) {
4881 next if $selection && !$selection->{$opt};
4883 if ($opt eq 'hotplug
') {
4884 die "skip\n" if ($conf->{hotplug} =~ /memory/);
4885 } elsif ($opt eq 'tablet
') {
4886 die "skip\n" if !$hotplug_features->{usb};
4887 if ($defaults->{tablet}) {
4888 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4889 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4890 if $arch eq 'aarch64
';
4892 vm_deviceunplug($vmid, $conf, 'tablet
');
4893 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4895 } elsif ($opt =~ m/^usb\d+/) {
4897 # since we cannot reliably hot unplug usb devices
4898 # we are disabling it
4899 die "skip\n" if !$hotplug_features->{usb} || $conf->{$opt} =~ m/spice/i;
4900 vm_deviceunplug($vmid, $conf, $opt);
4901 } elsif ($opt eq 'vcpus
') {
4902 die "skip\n" if !$hotplug_features->{cpu};
4903 qemu_cpu_hotplug($vmid, $conf, undef);
4904 } elsif ($opt eq 'balloon
') {
4905 # enable balloon device is not hotpluggable
4906 die "skip\n" if defined($conf->{balloon}) && $conf->{balloon} == 0;
4907 # here we reset the ballooning value to memory
4908 my $balloon = $conf->{memory} || $defaults->{memory};
4909 vm_mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4910 } elsif ($fast_plug_option->{$opt}) {
4912 } elsif ($opt =~ m/^net(\d+)$/) {
4913 die "skip\n" if !$hotplug_features->{network};
4914 vm_deviceunplug($vmid, $conf, $opt);
4915 } elsif (is_valid_drivename($opt)) {
4916 die "skip\n" if !$hotplug_features->{disk} || $opt =~ m/(ide|sata)(\d+)/;
4917 vm_deviceunplug($vmid, $conf, $opt);
4918 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4919 } elsif ($opt =~ m/^memory$/) {
4920 die "skip\n" if !$hotplug_features->{memory};
4921 PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt);
4922 } elsif ($opt eq 'cpuunits
') {
4923 cgroups_write("cpu", $vmid, "cpu.shares", $defaults->{cpuunits});
4924 } elsif ($opt eq 'cpulimit
') {
4925 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", -1);
4931 &$add_error($opt, $err) if $err ne "skip\n";
4933 # save new config if hotplug was successful
4934 delete $conf->{$opt};
4935 vmconfig_undelete_pending_option($conf, $opt);
4936 PVE::QemuConfig->write_config($vmid, $conf);
4937 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4941 my $apply_pending_cloudinit;
4942 $apply_pending_cloudinit = sub {
4943 my ($key, $value) = @_;
4944 $apply_pending_cloudinit = sub {}; # once is enough
4946 my @cloudinit_opts = keys %$confdesc_cloudinit;
4947 foreach my $opt (keys %{$conf->{pending}}) {
4948 next if !grep { $_ eq $opt } @cloudinit_opts;
4949 $conf->{$opt} = delete $conf->{pending}->{$opt};
4952 my $new_conf = { %$conf };
4953 $new_conf->{$key} = $value;
4954 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($new_conf, $vmid);
4957 foreach my $opt (keys %{$conf->{pending}}) {
4958 next if $selection && !$selection->{$opt};
4959 my $value = $conf->{pending}->{$opt};
4961 if ($opt eq 'hotplug
') {
4962 die "skip\n" if ($value =~ /memory/) || ($value !~ /memory/ && $conf->{hotplug} =~ /memory/);
4963 } elsif ($opt eq 'tablet
') {
4964 die "skip\n" if !$hotplug_features->{usb};
4966 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4967 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4968 if $arch eq 'aarch64
';
4969 } elsif ($value == 0) {
4970 vm_deviceunplug($vmid, $conf, 'tablet
');
4971 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4973 } elsif ($opt =~ m/^usb\d+$/) {
4975 # since we cannot reliably hot unplug usb devices
4976 # we are disabling it
4977 die "skip\n" if !$hotplug_features->{usb} || $value =~ m/spice/i;
4978 my $d = eval { PVE::JSONSchema::parse_property_string($usbdesc->{format}, $value) };
4979 die "skip\n" if !$d;
4980 qemu_usb_hotplug($storecfg, $conf, $vmid, $opt, $d, $arch, $machine_type);
4981 } elsif ($opt eq 'vcpus
') {
4982 die "skip\n" if !$hotplug_features->{cpu};
4983 qemu_cpu_hotplug($vmid, $conf, $value);
4984 } elsif ($opt eq 'balloon
') {
4985 # enable/disable balloning device is not hotpluggable
4986 my $old_balloon_enabled = !!(!defined($conf->{balloon}) || $conf->{balloon});
4987 my $new_balloon_enabled = !!(!defined($conf->{pending}->{balloon}) || $conf->{pending}->{balloon});
4988 die "skip\n" if $old_balloon_enabled != $new_balloon_enabled;
4990 # allow manual ballooning if shares is set to zero
4991 if ((defined($conf->{shares}) && ($conf->{shares} == 0))) {
4992 my $balloon = $conf->{pending}->{balloon} || $conf->{memory} || $defaults->{memory};
4993 vm_mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4995 } elsif ($opt =~ m/^net(\d+)$/) {
4996 # some changes can be done without hotplug
4997 vmconfig_update_net($storecfg, $conf, $hotplug_features->{network},
4998 $vmid, $opt, $value, $arch, $machine_type);
4999 } elsif (is_valid_drivename($opt)) {
5000 # some changes can be done without hotplug
5001 my $drive = parse_drive($opt, $value);
5002 if (drive_is_cloudinit($drive)) {
5003 &$apply_pending_cloudinit($opt, $value);
5005 vmconfig_update_disk($storecfg, $conf, $hotplug_features->{disk},
5006 $vmid, $opt, $value, 1, $arch, $machine_type);
5007 } elsif ($opt =~ m/^memory$/) { #dimms
5008 die "skip\n" if !$hotplug_features->{memory};
5009 $value = PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt, $value);
5010 } elsif ($opt eq 'cpuunits
') {
5011 cgroups_write("cpu", $vmid, "cpu.shares", $conf->{pending}->{$opt});
5012 } elsif ($opt eq 'cpulimit
') {
5013 my $cpulimit = $conf->{pending}->{$opt} == 0 ? -1 : int($conf->{pending}->{$opt} * 100000);
5014 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", $cpulimit);
5016 die "skip\n"; # skip non-hot-pluggable options
5020 &$add_error($opt, $err) if $err ne "skip\n";
5022 # save new config if hotplug was successful
5023 $conf->{$opt} = $value;
5024 delete $conf->{pending}->{$opt};
5025 PVE::QemuConfig->write_config($vmid, $conf);
5026 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5031 sub try_deallocate_drive {
5032 my ($storecfg, $vmid, $conf, $key, $drive, $rpcenv, $authuser, $force) = @_;
5034 if (($force || $key =~ /^unused/) && !drive_is_cdrom($drive, 1)) {
5035 my $volid = $drive->{file};
5036 if (vm_is_volid_owner($storecfg, $vmid, $volid)) {
5037 my $sid = PVE::Storage::parse_volume_id($volid);
5038 $rpcenv->check($authuser, "/storage/$sid", ['Datastore
.AllocateSpace
']);
5040 # check if the disk is really unused
5041 die "unable to delete '$volid' - volume is still in use (snapshot?)\n"
5042 if is_volume_in_use($storecfg, $conf, $key, $volid);
5043 PVE::Storage::vdisk_free($storecfg, $volid);
5046 # If vm is not owner of this disk remove from config
5054 sub vmconfig_delete_or_detach_drive {
5055 my ($vmid, $storecfg, $conf, $opt, $force) = @_;
5057 my $drive = parse_drive($opt, $conf->{$opt});
5059 my $rpcenv = PVE::RPCEnvironment::get();
5060 my $authuser = $rpcenv->get_user();
5063 $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM
.Config
.Disk
']);
5064 try_deallocate_drive($storecfg, $vmid, $conf, $opt, $drive, $rpcenv, $authuser, $force);
5066 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $drive);
5070 sub vmconfig_apply_pending {
5071 my ($vmid, $conf, $storecfg) = @_;
5075 my $pending_delete_hash = split_flagged_list($conf->{pending}->{delete});
5076 while (my ($opt, $force) = each %$pending_delete_hash) {
5077 die "internal error" if $opt =~ m/^unused/;
5078 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5079 if (!defined($conf->{$opt})) {
5080 vmconfig_undelete_pending_option($conf, $opt);
5081 PVE::QemuConfig->write_config($vmid, $conf);
5082 } elsif (is_valid_drivename($opt)) {
5083 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
5084 vmconfig_undelete_pending_option($conf, $opt);
5085 delete $conf->{$opt};
5086 PVE::QemuConfig->write_config($vmid, $conf);
5088 vmconfig_undelete_pending_option($conf, $opt);
5089 delete $conf->{$opt};
5090 PVE::QemuConfig->write_config($vmid, $conf);
5094 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5096 foreach my $opt (keys %{$conf->{pending}}) { # add/change
5097 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5099 if (defined($conf->{$opt}) && ($conf->{$opt} eq $conf->{pending}->{$opt})) {
5100 # skip if nothing changed
5101 } elsif (is_valid_drivename($opt)) {
5102 vmconfig_register_unused_drive($storecfg, $vmid, $conf, parse_drive($opt, $conf->{$opt}))
5103 if defined($conf->{$opt});
5104 $conf->{$opt} = $conf->{pending}->{$opt};
5106 $conf->{$opt} = $conf->{pending}->{$opt};
5109 delete $conf->{pending}->{$opt};
5110 PVE::QemuConfig->write_config($vmid, $conf);
5114 my $safe_num_ne = sub {
5117 return 0 if !defined($a) && !defined($b);
5118 return 1 if !defined($a);
5119 return 1 if !defined($b);
5124 my $safe_string_ne = sub {
5127 return 0 if !defined($a) && !defined($b);
5128 return 1 if !defined($a);
5129 return 1 if !defined($b);
5134 sub vmconfig_update_net {
5135 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $arch, $machine_type) = @_;
5137 my $newnet = parse_net($value);
5139 if ($conf->{$opt}) {
5140 my $oldnet = parse_net($conf->{$opt});
5142 if (&$safe_string_ne($oldnet->{model}, $newnet->{model}) ||
5143 &$safe_string_ne($oldnet->{macaddr}, $newnet->{macaddr}) ||
5144 &$safe_num_ne($oldnet->{queues}, $newnet->{queues}) ||
5145 !($newnet->{bridge} && $oldnet->{bridge})) { # bridge/nat mode change
5147 # for non online change, we try to hot-unplug
5148 die "skip\n" if !$hotplug;
5149 vm_deviceunplug($vmid, $conf, $opt);
5152 die "internal error" if $opt !~ m/net(\d+)/;
5153 my $iface = "tap${vmid}i$1";
5155 if (&$safe_string_ne($oldnet->{bridge}, $newnet->{bridge}) ||
5156 &$safe_num_ne($oldnet->{tag}, $newnet->{tag}) ||
5157 &$safe_string_ne($oldnet->{trunks}, $newnet->{trunks}) ||
5158 &$safe_num_ne($oldnet->{firewall}, $newnet->{firewall})) {
5159 PVE::Network::tap_unplug($iface);
5160 PVE::Network::tap_plug($iface, $newnet->{bridge}, $newnet->{tag}, $newnet->{firewall}, $newnet->{trunks}, $newnet->{rate});
5161 } elsif (&$safe_num_ne($oldnet->{rate}, $newnet->{rate})) {
5162 # Rate can be applied on its own but any change above needs to
5163 # include the rate in tap_plug since OVS resets everything.
5164 PVE::Network::tap_rate_limit($iface, $newnet->{rate});
5167 if (&$safe_string_ne($oldnet->{link_down}, $newnet->{link_down})) {
5168 qemu_set_link_status($vmid, $opt, !$newnet->{link_down});
5176 vm_deviceplug($storecfg, $conf, $vmid, $opt, $newnet, $arch, $machine_type);
5182 sub vmconfig_update_disk {
5183 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $force, $arch, $machine_type) = @_;
5185 # fixme: do we need force?
5187 my $drive = parse_drive($opt, $value);
5189 if ($conf->{$opt}) {
5191 if (my $old_drive = parse_drive($opt, $conf->{$opt})) {
5193 my $media = $drive->{media} || 'disk
';
5194 my $oldmedia = $old_drive->{media} || 'disk
';
5195 die "unable to change media type\n" if $media ne $oldmedia;
5197 if (!drive_is_cdrom($old_drive)) {
5199 if ($drive->{file} ne $old_drive->{file}) {
5201 die "skip\n" if !$hotplug;
5203 # unplug and register as unused
5204 vm_deviceunplug($vmid, $conf, $opt);
5205 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive)
5208 # update existing disk
5210 # skip non hotpluggable value
5211 if (&$safe_string_ne($drive->{discard}, $old_drive->{discard}) ||
5212 &$safe_string_ne($drive->{iothread}, $old_drive->{iothread}) ||
5213 &$safe_string_ne($drive->{queues}, $old_drive->{queues}) ||
5214 &$safe_string_ne($drive->{cache}, $old_drive->{cache})) {
5219 if (&$safe_num_ne($drive->{mbps}, $old_drive->{mbps}) ||
5220 &$safe_num_ne($drive->{mbps_rd}, $old_drive->{mbps_rd}) ||
5221 &$safe_num_ne($drive->{mbps_wr}, $old_drive->{mbps_wr}) ||
5222 &$safe_num_ne($drive->{iops}, $old_drive->{iops}) ||
5223 &$safe_num_ne($drive->{iops_rd}, $old_drive->{iops_rd}) ||
5224 &$safe_num_ne($drive->{iops_wr}, $old_drive->{iops_wr}) ||
5225 &$safe_num_ne($drive->{mbps_max}, $old_drive->{mbps_max}) ||
5226 &$safe_num_ne($drive->{mbps_rd_max}, $old_drive->{mbps_rd_max}) ||
5227 &$safe_num_ne($drive->{mbps_wr_max}, $old_drive->{mbps_wr_max}) ||
5228 &$safe_num_ne($drive->{iops_max}, $old_drive->{iops_max}) ||
5229 &$safe_num_ne($drive->{iops_rd_max}, $old_drive->{iops_rd_max}) ||
5230 &$safe_num_ne($drive->{iops_wr_max}, $old_drive->{iops_wr_max}) ||
5231 &$safe_num_ne($drive->{bps_max_length}, $old_drive->{bps_max_length}) ||
5232 &$safe_num_ne($drive->{bps_rd_max_length}, $old_drive->{bps_rd_max_length}) ||
5233 &$safe_num_ne($drive->{bps_wr_max_length}, $old_drive->{bps_wr_max_length}) ||
5234 &$safe_num_ne($drive->{iops_max_length}, $old_drive->{iops_max_length}) ||
5235 &$safe_num_ne($drive->{iops_rd_max_length}, $old_drive->{iops_rd_max_length}) ||
5236 &$safe_num_ne($drive->{iops_wr_max_length}, $old_drive->{iops_wr_max_length})) {
5238 qemu_block_set_io_throttle($vmid,"drive-$opt",
5239 ($drive->{mbps} || 0)*1024*1024,
5240 ($drive->{mbps_rd} || 0)*1024*1024,
5241 ($drive->{mbps_wr} || 0)*1024*1024,
5242 $drive->{iops} || 0,
5243 $drive->{iops_rd} || 0,
5244 $drive->{iops_wr} || 0,
5245 ($drive->{mbps_max} || 0)*1024*1024,
5246 ($drive->{mbps_rd_max} || 0)*1024*1024,
5247 ($drive->{mbps_wr_max} || 0)*1024*1024,
5248 $drive->{iops_max} || 0,
5249 $drive->{iops_rd_max} || 0,
5250 $drive->{iops_wr_max} || 0,
5251 $drive->{bps_max_length} || 1,
5252 $drive->{bps_rd_max_length} || 1,
5253 $drive->{bps_wr_max_length} || 1,
5254 $drive->{iops_max_length} || 1,
5255 $drive->{iops_rd_max_length} || 1,
5256 $drive->{iops_wr_max_length} || 1);
5265 if ($drive->{file} eq 'none
') {
5266 vm_mon_cmd($vmid, "eject",force => JSON::true,device => "drive-$opt");
5267 if (drive_is_cloudinit($old_drive)) {
5268 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive);
5271 my $path = get_iso_path($storecfg, $vmid, $drive->{file});
5272 vm_mon_cmd($vmid, "eject", force => JSON::true,device => "drive-$opt"); # force eject if locked
5273 vm_mon_cmd($vmid, "change", device => "drive-$opt",target => "$path") if $path;
5281 die "skip\n" if !$hotplug || $opt =~ m/(ide|sata)(\d+)/;
5283 PVE::Storage::activate_volumes($storecfg, [$drive->{file}]) if $drive->{file} !~ m|^/dev/.+|;
5284 vm_deviceplug($storecfg, $conf, $vmid, $opt, $drive, $arch, $machine_type);
5288 my ($storecfg, $vmid, $statefile, $skiplock, $migratedfrom, $paused,
5289 $forcemachine, $spice_ticket, $migration_network, $migration_type, $targetstorage) = @_;
5291 PVE::QemuConfig->lock_config($vmid, sub {
5292 my $conf = PVE::QemuConfig->load_config($vmid, $migratedfrom);
5294 die "you can't start a vm
if it
's a template\n" if PVE::QemuConfig->is_template($conf);
5296 my $is_suspended = PVE::QemuConfig->has_lock($conf, 'suspended
');
5298 PVE::QemuConfig->check_lock($conf)
5299 if !($skiplock || $is_suspended);
5301 die "VM $vmid already running\n" if check_running($vmid, undef, $migratedfrom);
5303 if (!$statefile && scalar(keys %{$conf->{pending}})) {
5304 vmconfig_apply_pending($vmid, $conf, $storecfg);
5305 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5308 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($conf, $vmid);
5310 my $defaults = load_defaults();
5312 # set environment variable useful inside network script
5313 $ENV{PVE_MIGRATED_FROM} = $migratedfrom if $migratedfrom;
5315 my $local_volumes = {};
5317 if ($targetstorage) {
5318 foreach_drive($conf, sub {
5319 my ($ds, $drive) = @_;
5321 return if drive_is_cdrom($drive);
5323 my $volid = $drive->{file};
5327 my ($storeid, $volname) = PVE::Storage::parse_volume_id($volid);
5329 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5330 return if $scfg->{shared};
5331 $local_volumes->{$ds} = [$volid, $storeid, $volname];
5336 foreach my $opt (sort keys %$local_volumes) {
5338 my ($volid, $storeid, $volname) = @{$local_volumes->{$opt}};
5339 my $drive = parse_drive($opt, $conf->{$opt});
5341 #if remote storage is specified, use default format
5342 if ($targetstorage && $targetstorage ne "1") {
5343 $storeid = $targetstorage;
5344 my ($defFormat, $validFormats) = PVE::Storage::storage_default_format($storecfg, $storeid);
5345 $format = $defFormat;
5347 #else we use same format than original
5348 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5349 $format = qemu_img_format($scfg, $volid);
5352 my $newvolid = PVE::Storage::vdisk_alloc($storecfg, $storeid, $vmid, $format, undef, ($drive->{size}/1024));
5353 my $newdrive = $drive;
5354 $newdrive->{format} = $format;
5355 $newdrive->{file} = $newvolid;
5356 my $drivestr = PVE::QemuServer::print_drive($vmid, $newdrive);
5357 $local_volumes->{$opt} = $drivestr;
5358 #pass drive to conf for command line
5359 $conf->{$opt} = $drivestr;
5363 PVE::GuestHelpers::exec_hookscript($conf, $vmid, 'pre-start
', 1);
5365 if ($is_suspended) {
5366 # enforce machine type on suspended vm to ensure HW compatibility
5367 $forcemachine = $conf->{runningmachine};
5368 print "Resuming suspended VM\n";
5371 my ($cmd, $vollist, $spice_port) = config_to_command($storecfg, $vmid, $conf, $defaults, $forcemachine);
5373 my $migrate_port = 0;
5376 if ($statefile eq 'tcp
') {
5377 my $localip = "localhost";
5378 my $datacenterconf = PVE::Cluster::cfs_read_file('datacenter
.cfg
');
5379 my $nodename = PVE::INotify::nodename();
5381 if (!defined($migration_type)) {
5382 if (defined($datacenterconf->{migration}->{type})) {
5383 $migration_type = $datacenterconf->{migration}->{type};
5385 $migration_type = 'secure
';
5389 if ($migration_type eq 'insecure
') {
5390 my $migrate_network_addr = PVE::Cluster::get_local_migration_ip($migration_network);
5391 if ($migrate_network_addr) {
5392 $localip = $migrate_network_addr;
5394 $localip = PVE::Cluster::remote_node_ip($nodename, 1);
5397 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5400 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5401 $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5402 $migrate_uri = "tcp:${localip}:${migrate_port}";
5403 push @$cmd, '-incoming
', $migrate_uri;
5406 } elsif ($statefile eq 'unix
') {
5407 # should be default for secure migrations as a ssh TCP forward
5408 # tunnel is not deterministic reliable ready and fails regurarly
5409 # to set up in time, so use UNIX socket forwards
5410 my $socket_addr = "/run/qemu-server/$vmid.migrate";
5411 unlink $socket_addr;
5413 $migrate_uri = "unix:$socket_addr";
5415 push @$cmd, '-incoming
', $migrate_uri;
5419 push @$cmd, '-loadstate
', $statefile;
5426 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
5427 my $d = parse_hostpci($conf->{"hostpci$i"});
5429 my $pcidevices = $d->{pciid};
5430 foreach my $pcidevice (@$pcidevices) {
5431 my $pciid = $pcidevice->{id};
5433 my $info = PVE::SysFSTools::pci_device_info("0000:$pciid");
5434 die "IOMMU not present\n" if !PVE::SysFSTools::check_iommu_support();
5435 die "no pci device info for device '$pciid'\n" if !$info;
5438 my $uuid = PVE::SysFSTools::generate_mdev_uuid($vmid, $i);
5439 PVE::SysFSTools::pci_create_mdev_device($pciid, $uuid, $d->{mdev});
5441 die "can't unbind
/bind pci group to vfio
'$pciid'\n"
5442 if !PVE::SysFSTools::pci_dev_group_bind_to_vfio($pciid);
5443 die "can
't reset pci device '$pciid'\n"
5444 if $info->{has_fl_reset} and !PVE::SysFSTools::pci_dev_reset($info);
5449 PVE::Storage::activate_volumes($storecfg, $vollist);
5452 run_command(['/bin/systemctl
', 'stop
', "$vmid.scope"],
5453 outfunc => sub {}, errfunc => sub {});
5455 # Issues with the above 'stop
' not being fully completed are extremely rare, a very low
5456 # timeout should be more than enough here...
5457 PVE::Systemd::wait_for_unit_removed("$vmid.scope", 5);
5459 my $cpuunits = defined($conf->{cpuunits}) ? $conf->{cpuunits}
5460 : $defaults->{cpuunits};
5462 my $start_timeout = ($conf->{hugepages} || $is_suspended) ? 300 : 30;
5463 my %run_params = (timeout => $statefile ? undef : $start_timeout, umask => 0077);
5466 Slice => 'qemu
.slice
',
5468 CPUShares => $cpuunits
5471 if (my $cpulimit = $conf->{cpulimit}) {
5472 $properties{CPUQuota} = int($cpulimit * 100);
5474 $properties{timeout} = 10 if $statefile; # setting up the scope shoul be quick
5476 my $run_qemu = sub {
5477 PVE::Tools::run_fork sub {
5478 PVE::Systemd::enter_systemd_scope($vmid, "Proxmox VE VM $vmid", %properties);
5479 run_command($cmd, %run_params);
5483 if ($conf->{hugepages}) {
5486 my $hugepages_topology = PVE::QemuServer::Memory::hugepages_topology($conf);
5487 my $hugepages_host_topology = PVE::QemuServer::Memory::hugepages_host_topology();
5489 PVE::QemuServer::Memory::hugepages_mount();
5490 PVE::QemuServer::Memory::hugepages_allocate($hugepages_topology, $hugepages_host_topology);
5492 eval { $run_qemu->() };
5494 PVE::QemuServer::Memory::hugepages_reset($hugepages_host_topology);
5498 PVE::QemuServer::Memory::hugepages_pre_deallocate($hugepages_topology);
5500 eval { PVE::QemuServer::Memory::hugepages_update_locked($code); };
5503 eval { $run_qemu->() };
5507 # deactivate volumes if start fails
5508 eval { PVE::Storage::deactivate_volumes($storecfg, $vollist); };
5509 die "start failed: $err";
5512 print "migration listens on $migrate_uri\n" if $migrate_uri;
5514 if ($statefile && $statefile ne 'tcp
' && $statefile ne 'unix
') {
5515 eval { vm_mon_cmd_nocheck($vmid, "cont"); };
5519 #start nbd server for storage migration
5520 if ($targetstorage) {
5521 my $nodename = PVE::INotify::nodename();
5522 my $migrate_network_addr = PVE::Cluster::get_local_migration_ip($migration_network);
5523 my $localip = $migrate_network_addr ? $migrate_network_addr : PVE::Cluster::remote_node_ip($nodename, 1);
5524 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5525 $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5527 vm_mon_cmd_nocheck($vmid, "nbd-server-start", addr => { type => 'inet
', data => { host => "${localip}", port => "${migrate_port}" } } );
5529 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5531 foreach my $opt (sort keys %$local_volumes) {
5532 my $volid = $local_volumes->{$opt};
5533 vm_mon_cmd_nocheck($vmid, "nbd-server-add", device => "drive-$opt", writable => JSON::true );
5534 my $migrate_storage_uri = "nbd:${localip}:${migrate_port}:exportname=drive-$opt";
5535 print "storage migration listens on $migrate_storage_uri volume:$volid\n";
5539 if ($migratedfrom) {
5541 set_migration_caps($vmid);
5546 print "spice listens on port $spice_port\n";
5547 if ($spice_ticket) {
5548 vm_mon_cmd_nocheck($vmid, "set_password", protocol => 'spice
', password => $spice_ticket);
5549 vm_mon_cmd_nocheck($vmid, "expire_password", protocol => 'spice
', time => "+30");
5554 vm_mon_cmd_nocheck($vmid, "balloon", value => $conf->{balloon}*1024*1024)
5555 if !$statefile && $conf->{balloon};
5557 foreach my $opt (keys %$conf) {
5558 next if $opt !~ m/^net\d+$/;
5559 my $nicconf = parse_net($conf->{$opt});
5560 qemu_set_link_status($vmid, $opt, 0) if $nicconf->{link_down};
5564 vm_mon_cmd_nocheck($vmid, 'qom-set
',
5565 path => "machine/peripheral/balloon0",
5566 property => "guest-stats-polling-interval",
5567 value => 2) if (!defined($conf->{balloon}) || $conf->{balloon});
5569 if ($is_suspended && (my $vmstate = $conf->{vmstate})) {
5570 print "Resumed VM, removing state\n";
5571 delete $conf->@{qw(lock vmstate runningmachine)};
5572 PVE
::Storage
::deactivate_volumes
($storecfg, [$vmstate]);
5573 PVE
::Storage
::vdisk_free
($storecfg, $vmstate);
5574 PVE
::QemuConfig-
>write_config($vmid, $conf);
5577 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'post-start');
5582 my ($vmid, $execute, %params) = @_;
5584 my $cmd = { execute
=> $execute, arguments
=> \
%params };
5585 vm_qmp_command
($vmid, $cmd);
5588 sub vm_mon_cmd_nocheck
{
5589 my ($vmid, $execute, %params) = @_;
5591 my $cmd = { execute
=> $execute, arguments
=> \
%params };
5592 vm_qmp_command
($vmid, $cmd, 1);
5595 sub vm_qmp_command
{
5596 my ($vmid, $cmd, $nocheck) = @_;
5601 if ($cmd->{arguments
}) {
5602 $timeout = delete $cmd->{arguments
}->{timeout
};
5606 die "VM $vmid not running\n" if !check_running
($vmid, $nocheck);
5607 my $sname = qmp_socket
($vmid);
5608 if (-e
$sname) { # test if VM is reasonambe new and supports qmp/qga
5609 my $qmpclient = PVE
::QMPClient-
>new();
5611 $res = $qmpclient->cmd($vmid, $cmd, $timeout);
5613 die "unable to open monitor socket\n";
5617 syslog
("err", "VM $vmid qmp command failed - $err");
5624 sub vm_human_monitor_command
{
5625 my ($vmid, $cmdline) = @_;
5628 execute
=> 'human-monitor-command',
5629 arguments
=> { 'command-line' => $cmdline},
5632 return vm_qmp_command
($vmid, $cmd);
5635 sub vm_commandline
{
5636 my ($storecfg, $vmid, $snapname) = @_;
5638 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5641 my $snapshot = $conf->{snapshots
}->{$snapname};
5642 die "snapshot '$snapname' does not exist\n" if !defined($snapshot);
5644 $snapshot->{digest
} = $conf->{digest
}; # keep file digest for API
5649 my $defaults = load_defaults
();
5651 my $cmd = config_to_command
($storecfg, $vmid, $conf, $defaults);
5653 return PVE
::Tools
::cmd2string
($cmd);
5657 my ($vmid, $skiplock) = @_;
5659 PVE
::QemuConfig-
>lock_config($vmid, sub {
5661 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5663 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5665 vm_mon_cmd
($vmid, "system_reset");
5669 sub get_vm_volumes
{
5673 foreach_volid
($conf, sub {
5674 my ($volid, $attr) = @_;
5676 return if $volid =~ m
|^/|;
5678 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
5681 push @$vollist, $volid;
5687 sub vm_stop_cleanup
{
5688 my ($storecfg, $vmid, $conf, $keepActive, $apply_pending_changes) = @_;
5693 my $vollist = get_vm_volumes
($conf);
5694 PVE
::Storage
::deactivate_volumes
($storecfg, $vollist);
5697 foreach my $ext (qw(mon qmp pid vnc qga)) {
5698 unlink "/var/run/qemu-server/${vmid}.$ext";
5701 if ($conf->{ivshmem
}) {
5702 my $ivshmem = PVE
::JSONSchema
::parse_property_string
($ivshmem_fmt, $conf->{ivshmem
});
5703 # just delete it for now, VMs which have this already open do not
5704 # are affected, but new VMs will get a separated one. If this
5705 # becomes an issue we either add some sort of ref-counting or just
5706 # add a "don't delete on stop" flag to the ivshmem format.
5707 unlink '/dev/shm/pve-shm-' . ($ivshmem->{name
} // $vmid);
5710 foreach my $key (keys %$conf) {
5711 next if $key !~ m/^hostpci(\d+)$/;
5712 my $hostpciindex = $1;
5713 my $d = parse_hostpci
($conf->{$key});
5714 my $uuid = PVE
::SysFSTools
::generate_mdev_uuid
($vmid, $hostpciindex);
5716 foreach my $pci (@{$d->{pciid
}}) {
5717 my $pciid = $pci->{id
};
5718 PVE
::SysFSTools
::pci_cleanup_mdev_device
($pciid, $uuid);
5722 vmconfig_apply_pending
($vmid, $conf, $storecfg) if $apply_pending_changes;
5724 warn $@ if $@; # avoid errors - just warn
5727 # Note: use $nockeck to skip tests if VM configuration file exists.
5728 # We need that when migration VMs to other nodes (files already moved)
5729 # Note: we set $keepActive in vzdump stop mode - volumes need to stay active
5731 my ($storecfg, $vmid, $skiplock, $nocheck, $timeout, $shutdown, $force, $keepActive, $migratedfrom) = @_;
5733 $force = 1 if !defined($force) && !$shutdown;
5736 my $pid = check_running
($vmid, $nocheck, $migratedfrom);
5737 kill 15, $pid if $pid;
5738 my $conf = PVE
::QemuConfig-
>load_config($vmid, $migratedfrom);
5739 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 0);
5743 PVE
::QemuConfig-
>lock_config($vmid, sub {
5745 my $pid = check_running
($vmid, $nocheck);
5750 $conf = PVE
::QemuConfig-
>load_config($vmid);
5751 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5752 if (!defined($timeout) && $shutdown && $conf->{startup
}) {
5753 my $opts = PVE
::JSONSchema
::pve_parse_startup_order
($conf->{startup
});
5754 $timeout = $opts->{down
} if $opts->{down
};
5756 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'pre-stop');
5761 if (defined($conf) && parse_guest_agent
($conf)->{enabled
}) {
5762 vm_qmp_command
($vmid, {
5763 execute
=> "guest-shutdown",
5764 arguments
=> { timeout
=> $timeout }
5767 vm_qmp_command
($vmid, { execute
=> "system_powerdown" }, $nocheck);
5770 vm_qmp_command
($vmid, { execute
=> "quit" }, $nocheck);
5776 $timeout = 60 if !defined($timeout);
5779 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5784 if ($count >= $timeout) {
5786 warn "VM still running - terminating now with SIGTERM\n";
5789 die "VM quit/powerdown failed - got timeout\n";
5792 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5797 warn "VM quit/powerdown failed - terminating now with SIGTERM\n";
5800 die "VM quit/powerdown failed\n";
5808 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5813 if ($count >= $timeout) {
5814 warn "VM still running - terminating now with SIGKILL\n";
5819 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5824 my ($vmid, $skiplock, $includestate, $statestorage) = @_;
5831 PVE
::QemuConfig-
>lock_config($vmid, sub {
5833 $conf = PVE
::QemuConfig-
>load_config($vmid);
5835 my $is_backing_up = PVE
::QemuConfig-
>has_lock($conf, 'backup');
5836 PVE
::QemuConfig-
>check_lock($conf)
5837 if !($skiplock || $is_backing_up);
5839 die "cannot suspend to disk during backup\n"
5840 if $is_backing_up && $includestate;
5842 if ($includestate) {
5843 $conf->{lock} = 'suspending';
5844 my $date = strftime
("%Y-%m-%d", localtime(time()));
5845 $storecfg = PVE
::Storage
::config
();
5846 $vmstate = PVE
::QemuConfig-
>__snapshot_save_vmstate($vmid, $conf, "suspend-$date", $storecfg, $statestorage, 1);
5847 $path = PVE
::Storage
::path
($storecfg, $vmstate);
5848 PVE
::QemuConfig-
>write_config($vmid, $conf);
5850 vm_mon_cmd
($vmid, "stop");
5854 if ($includestate) {
5856 PVE
::Storage
::activate_volumes
($storecfg, [$vmstate]);
5859 vm_mon_cmd
($vmid, "savevm-start", statefile
=> $path);
5861 my $state = vm_mon_cmd_nocheck
($vmid, "query-savevm");
5862 if (!$state->{status
}) {
5863 die "savevm not active\n";
5864 } elsif ($state->{status
} eq 'active') {
5867 } elsif ($state->{status
} eq 'completed') {
5868 print "State saved, quitting\n";
5870 } elsif ($state->{status
} eq 'failed' && $state->{error
}) {
5871 die "query-savevm failed with error '$state->{error}'\n"
5873 die "query-savevm returned status '$state->{status}'\n";
5879 PVE
::QemuConfig-
>lock_config($vmid, sub {
5880 $conf = PVE
::QemuConfig-
>load_config($vmid);
5882 # cleanup, but leave suspending lock, to indicate something went wrong
5884 vm_mon_cmd
($vmid, "savevm-end");
5885 PVE
::Storage
::deactivate_volumes
($storecfg, [$vmstate]);
5886 PVE
::Storage
::vdisk_free
($storecfg, $vmstate);
5887 delete $conf->@{qw(vmstate runningmachine)};
5888 PVE
::QemuConfig-
>write_config($vmid, $conf);
5894 die "lock changed unexpectedly\n"
5895 if !PVE
::QemuConfig-
>has_lock($conf, 'suspending');
5897 vm_qmp_command
($vmid, { execute
=> "quit" });
5898 $conf->{lock} = 'suspended';
5899 PVE
::QemuConfig-
>write_config($vmid, $conf);
5905 my ($vmid, $skiplock, $nocheck) = @_;
5907 PVE
::QemuConfig-
>lock_config($vmid, sub {
5908 my $vm_mon_cmd = $nocheck ? \
&vm_mon_cmd_nocheck
: \
&vm_mon_cmd
;
5909 my $res = $vm_mon_cmd->($vmid, 'query-status');
5910 my $resume_cmd = 'cont';
5912 if ($res->{status
} && $res->{status
} eq 'suspended') {
5913 $resume_cmd = 'system_wakeup';
5918 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5920 PVE
::QemuConfig-
>check_lock($conf)
5921 if !($skiplock || PVE
::QemuConfig-
>has_lock($conf, 'backup'));
5924 $vm_mon_cmd->($vmid, $resume_cmd);
5929 my ($vmid, $skiplock, $key) = @_;
5931 PVE
::QemuConfig-
>lock_config($vmid, sub {
5933 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5935 # there is no qmp command, so we use the human monitor command
5936 my $res = vm_human_monitor_command
($vmid, "sendkey $key");
5937 die $res if $res ne '';
5942 my ($storecfg, $vmid, $skiplock) = @_;
5944 PVE
::QemuConfig-
>lock_config($vmid, sub {
5946 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5948 if (!check_running
($vmid)) {
5949 destroy_vm
($storecfg, $vmid, undef, $skiplock);
5951 die "VM $vmid is running - destroy failed\n";
5956 # vzdump restore implementaion
5958 sub tar_archive_read_firstfile
{
5959 my $archive = shift;
5961 die "ERROR: file '$archive' does not exist\n" if ! -f
$archive;
5963 # try to detect archive type first
5964 my $pid = open (my $fh, '-|', 'tar', 'tf', $archive) ||
5965 die "unable to open file '$archive'\n";
5966 my $firstfile = <$fh>;
5970 die "ERROR: archive contaions no data\n" if !$firstfile;
5976 sub tar_restore_cleanup
{
5977 my ($storecfg, $statfile) = @_;
5979 print STDERR
"starting cleanup\n";
5981 if (my $fd = IO
::File-
>new($statfile, "r")) {
5982 while (defined(my $line = <$fd>)) {
5983 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
5986 if ($volid =~ m
|^/|) {
5987 unlink $volid || die 'unlink failed\n';
5989 PVE
::Storage
::vdisk_free
($storecfg, $volid);
5991 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
5993 print STDERR
"unable to cleanup '$volid' - $@" if $@;
5995 print STDERR
"unable to parse line in statfile - $line";
6002 sub restore_archive
{
6003 my ($archive, $vmid, $user, $opts) = @_;
6005 my $format = $opts->{format
};
6008 if ($archive =~ m/\.tgz$/ || $archive =~ m/\.tar\.gz$/) {
6009 $format = 'tar' if !$format;
6011 } elsif ($archive =~ m/\.tar$/) {
6012 $format = 'tar' if !$format;
6013 } elsif ($archive =~ m/.tar.lzo$/) {
6014 $format = 'tar' if !$format;
6016 } elsif ($archive =~ m/\.vma$/) {
6017 $format = 'vma' if !$format;
6018 } elsif ($archive =~ m/\.vma\.gz$/) {
6019 $format = 'vma' if !$format;
6021 } elsif ($archive =~ m/\.vma\.lzo$/) {
6022 $format = 'vma' if !$format;
6025 $format = 'vma' if !$format; # default
6028 # try to detect archive format
6029 if ($format eq 'tar') {
6030 return restore_tar_archive
($archive, $vmid, $user, $opts);
6032 return restore_vma_archive
($archive, $vmid, $user, $opts, $comp);
6036 sub restore_update_config_line
{
6037 my ($outfd, $cookie, $vmid, $map, $line, $unique) = @_;
6039 return if $line =~ m/^\#qmdump\#/;
6040 return if $line =~ m/^\#vzdump\#/;
6041 return if $line =~ m/^lock:/;
6042 return if $line =~ m/^unused\d+:/;
6043 return if $line =~ m/^parent:/;
6045 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
6046 if (($line =~ m/^(vlan(\d+)):\s*(\S+)\s*$/)) {
6047 # try to convert old 1.X settings
6048 my ($id, $ind, $ethcfg) = ($1, $2, $3);
6049 foreach my $devconfig (PVE
::Tools
::split_list
($ethcfg)) {
6050 my ($model, $macaddr) = split(/\=/, $devconfig);
6051 $macaddr = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if !$macaddr || $unique;
6054 bridge
=> "vmbr$ind",
6055 macaddr
=> $macaddr,
6057 my $netstr = print_net
($net);
6059 print $outfd "net$cookie->{netcount}: $netstr\n";
6060 $cookie->{netcount
}++;
6062 } elsif (($line =~ m/^(net\d+):\s*(\S+)\s*$/) && $unique) {
6063 my ($id, $netstr) = ($1, $2);
6064 my $net = parse_net
($netstr);
6065 $net->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if $net->{macaddr
};
6066 $netstr = print_net
($net);
6067 print $outfd "$id: $netstr\n";
6068 } elsif ($line =~ m/^((ide|scsi|virtio|sata|efidisk)\d+):\s*(\S+)\s*$/) {
6071 my $di = parse_drive
($virtdev, $value);
6072 if (defined($di->{backup
}) && !$di->{backup
}) {
6073 print $outfd "#$line";
6074 } elsif ($map->{$virtdev}) {
6075 delete $di->{format
}; # format can change on restore
6076 $di->{file
} = $map->{$virtdev};
6077 $value = print_drive
($vmid, $di);
6078 print $outfd "$virtdev: $value\n";
6082 } elsif (($line =~ m/^vmgenid: (.*)/)) {
6084 if ($vmgenid ne '0') {
6085 # always generate a new vmgenid if there was a valid one setup
6086 $vmgenid = generate_uuid
();
6088 print $outfd "vmgenid: $vmgenid\n";
6089 } elsif (($line =~ m/^(smbios1: )(.*)/) && $unique) {
6090 my ($uuid, $uuid_str);
6091 UUID
::generate
($uuid);
6092 UUID
::unparse
($uuid, $uuid_str);
6093 my $smbios1 = parse_smbios1
($2);
6094 $smbios1->{uuid
} = $uuid_str;
6095 print $outfd $1.print_smbios1
($smbios1)."\n";
6102 my ($cfg, $vmid) = @_;
6104 my $info = PVE
::Storage
::vdisk_list
($cfg, undef, $vmid);
6106 my $volid_hash = {};
6107 foreach my $storeid (keys %$info) {
6108 foreach my $item (@{$info->{$storeid}}) {
6109 next if !($item->{volid
} && $item->{size
});
6110 $item->{path
} = PVE
::Storage
::path
($cfg, $item->{volid
});
6111 $volid_hash->{$item->{volid
}} = $item;
6118 sub is_volume_in_use
{
6119 my ($storecfg, $conf, $skip_drive, $volid) = @_;
6121 my $path = PVE
::Storage
::path
($storecfg, $volid);
6123 my $scan_config = sub {
6124 my ($cref, $snapname) = @_;
6126 foreach my $key (keys %$cref) {
6127 my $value = $cref->{$key};
6128 if (is_valid_drivename
($key)) {
6129 next if $skip_drive && $key eq $skip_drive;
6130 my $drive = parse_drive
($key, $value);
6131 next if !$drive || !$drive->{file
} || drive_is_cdrom
($drive);
6132 return 1 if $volid eq $drive->{file
};
6133 if ($drive->{file
} =~ m!^/!) {
6134 return 1 if $drive->{file
} eq $path;
6136 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
}, 1);
6138 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid, 1);
6140 return 1 if $path eq PVE
::Storage
::path
($storecfg, $drive->{file
}, $snapname);
6148 return 1 if &$scan_config($conf);
6152 foreach my $snapname (keys %{$conf->{snapshots
}}) {
6153 return 1 if &$scan_config($conf->{snapshots
}->{$snapname}, $snapname);
6159 sub update_disksize
{
6160 my ($vmid, $conf, $volid_hash) = @_;
6163 my $prefix = "VM $vmid:";
6165 # used and unused disks
6166 my $referenced = {};
6168 # Note: it is allowed to define multiple storages with same path (alias), so
6169 # we need to check both 'volid' and real 'path' (two different volid can point
6170 # to the same path).
6172 my $referencedpath = {};
6175 foreach my $opt (keys %$conf) {
6176 if (is_valid_drivename
($opt)) {
6177 my $drive = parse_drive
($opt, $conf->{$opt});
6178 my $volid = $drive->{file
};
6181 $referenced->{$volid} = 1;
6182 if ($volid_hash->{$volid} &&
6183 (my $path = $volid_hash->{$volid}->{path
})) {
6184 $referencedpath->{$path} = 1;
6187 next if drive_is_cdrom
($drive);
6188 next if !$volid_hash->{$volid};
6190 $drive->{size
} = $volid_hash->{$volid}->{size
};
6191 my $new = print_drive
($vmid, $drive);
6192 if ($new ne $conf->{$opt}) {
6194 $conf->{$opt} = $new;
6195 print "$prefix update disk '$opt' information.\n";
6200 # remove 'unusedX' entry if volume is used
6201 foreach my $opt (keys %$conf) {
6202 next if $opt !~ m/^unused\d+$/;
6203 my $volid = $conf->{$opt};
6204 my $path = $volid_hash->{$volid}->{path
} if $volid_hash->{$volid};
6205 if ($referenced->{$volid} || ($path && $referencedpath->{$path})) {
6206 print "$prefix remove entry '$opt', its volume '$volid' is in use.\n";
6208 delete $conf->{$opt};
6211 $referenced->{$volid} = 1;
6212 $referencedpath->{$path} = 1 if $path;
6215 foreach my $volid (sort keys %$volid_hash) {
6216 next if $volid =~ m/vm-$vmid-state-/;
6217 next if $referenced->{$volid};
6218 my $path = $volid_hash->{$volid}->{path
};
6219 next if !$path; # just to be sure
6220 next if $referencedpath->{$path};
6222 my $key = PVE
::QemuConfig-
>add_unused_volume($conf, $volid);
6223 print "$prefix add unreferenced volume '$volid' as '$key' to config.\n";
6224 $referencedpath->{$path} = 1; # avoid to add more than once (aliases)
6231 my ($vmid, $nolock, $dryrun) = @_;
6233 my $cfg = PVE
::Storage
::config
();
6235 # FIXME: Remove once our RBD plugin can handle CT and VM on a single storage
6236 # see: https://pve.proxmox.com/pipermail/pve-devel/2018-July/032900.html
6237 foreach my $stor (keys %{$cfg->{ids
}}) {
6238 delete($cfg->{ids
}->{$stor}) if ! $cfg->{ids
}->{$stor}->{content
}->{images
};
6241 print "rescan volumes...\n";
6242 my $volid_hash = scan_volids
($cfg, $vmid);
6244 my $updatefn = sub {
6247 my $conf = PVE
::QemuConfig-
>load_config($vmid);
6249 PVE
::QemuConfig-
>check_lock($conf);
6252 foreach my $volid (keys %$volid_hash) {
6253 my $info = $volid_hash->{$volid};
6254 $vm_volids->{$volid} = $info if $info->{vmid
} && $info->{vmid
} == $vmid;
6257 my $changes = update_disksize
($vmid, $conf, $vm_volids);
6259 PVE
::QemuConfig-
>write_config($vmid, $conf) if $changes && !$dryrun;
6262 if (defined($vmid)) {
6266 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6269 my $vmlist = config_list
();
6270 foreach my $vmid (keys %$vmlist) {
6274 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6280 sub restore_vma_archive
{
6281 my ($archive, $vmid, $user, $opts, $comp) = @_;
6283 my $readfrom = $archive;
6285 my $cfg = PVE
::Storage
::config
();
6287 my $bwlimit = $opts->{bwlimit
};
6289 my $dbg_cmdstring = '';
6290 my $add_pipe = sub {
6292 push @$commands, $cmd;
6293 $dbg_cmdstring .= ' | ' if length($dbg_cmdstring);
6294 $dbg_cmdstring .= PVE
::Tools
::cmd2string
($cmd);
6299 if ($archive eq '-') {
6302 # If we use a backup from a PVE defined storage we also consider that
6303 # storage's rate limit:
6304 my (undef, $volid) = PVE
::Storage
::path_to_volume_id
($cfg, $archive);
6305 if (defined($volid)) {
6306 my ($sid, undef) = PVE
::Storage
::parse_volume_id
($volid);
6307 my $readlimit = PVE
::Storage
::get_bandwidth_limit
('restore', [$sid], $bwlimit);
6309 print STDERR
"applying read rate limit: $readlimit\n";
6310 my $cstream = ['cstream', '-t', $readlimit*1024, '--', $readfrom];
6311 $add_pipe->($cstream);
6318 if ($comp eq 'gzip') {
6319 $cmd = ['zcat', $readfrom];
6320 } elsif ($comp eq 'lzop') {
6321 $cmd = ['lzop', '-d', '-c', $readfrom];
6323 die "unknown compression method '$comp'\n";
6328 my $tmpdir = "/var/tmp/vzdumptmp$$";
6331 # disable interrupts (always do cleanups)
6335 local $SIG{HUP
} = sub { warn "got interrupt - ignored\n"; };
6337 my $mapfifo = "/var/tmp/vzdumptmp$$.fifo";
6338 POSIX
::mkfifo
($mapfifo, 0600);
6341 my $openfifo = sub {
6342 open($fifofh, '>', $mapfifo) || die $!;
6345 $add_pipe->(['vma', 'extract', '-v', '-r', $mapfifo, $readfrom, $tmpdir]);
6352 my $rpcenv = PVE
::RPCEnvironment
::get
();
6354 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6355 my $tmpfn = "$conffile.$$.tmp";
6357 # Note: $oldconf is undef if VM does not exists
6358 my $cfs_path = PVE
::QemuConfig-
>cfs_config_path($vmid);
6359 my $oldconf = PVE
::Cluster
::cfs_read_file
($cfs_path);
6363 my $print_devmap = sub {
6364 my $virtdev_hash = {};
6366 my $cfgfn = "$tmpdir/qemu-server.conf";
6368 # we can read the config - that is already extracted
6369 my $fh = IO
::File-
>new($cfgfn, "r") ||
6370 "unable to read qemu-server.conf - $!\n";
6372 my $fwcfgfn = "$tmpdir/qemu-server.fw";
6374 my $pve_firewall_dir = '/etc/pve/firewall';
6375 mkdir $pve_firewall_dir; # make sure the dir exists
6376 PVE
::Tools
::file_copy
($fwcfgfn, "${pve_firewall_dir}/$vmid.fw");
6379 while (defined(my $line = <$fh>)) {
6380 if ($line =~ m/^\#qmdump\#map:(\S+):(\S+):(\S*):(\S*):$/) {
6381 my ($virtdev, $devname, $storeid, $format) = ($1, $2, $3, $4);
6382 die "archive does not contain data for drive '$virtdev'\n"
6383 if !$devinfo->{$devname};
6384 if (defined($opts->{storage
})) {
6385 $storeid = $opts->{storage
} || 'local';
6386 } elsif (!$storeid) {
6389 $format = 'raw' if !$format;
6390 $devinfo->{$devname}->{devname
} = $devname;
6391 $devinfo->{$devname}->{virtdev
} = $virtdev;
6392 $devinfo->{$devname}->{format
} = $format;
6393 $devinfo->{$devname}->{storeid
} = $storeid;
6395 # check permission on storage
6396 my $pool = $opts->{pool
}; # todo: do we need that?
6397 if ($user ne 'root@pam') {
6398 $rpcenv->check($user, "/storage/$storeid", ['Datastore.AllocateSpace']);
6401 $storage_limits{$storeid} = $bwlimit;
6403 $virtdev_hash->{$virtdev} = $devinfo->{$devname};
6404 } elsif ($line =~ m/^((?:ide|sata|scsi)\d+):\s*(.*)\s*$/) {
6406 my $drive = parse_drive
($virtdev, $2);
6407 if (drive_is_cloudinit
($drive)) {
6408 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
});
6409 my $scfg = PVE
::Storage
::storage_config
($cfg, $storeid);
6410 my $format = qemu_img_format
($scfg, $volname); # has 'raw' fallback
6414 storeid
=> $opts->{storage
} // $storeid,
6415 size
=> PVE
::QemuServer
::Cloudinit
::CLOUDINIT_DISK_SIZE
,
6416 file
=> $drive->{file
}, # to make drive_is_cloudinit check possible
6417 name
=> "vm-$vmid-cloudinit",
6420 $virtdev_hash->{$virtdev} = $d;
6425 foreach my $key (keys %storage_limits) {
6426 my $limit = PVE
::Storage
::get_bandwidth_limit
('restore', [$key], $bwlimit);
6428 print STDERR
"rate limit for storage $key: $limit KiB/s\n";
6429 $storage_limits{$key} = $limit * 1024;
6432 foreach my $devname (keys %$devinfo) {
6433 die "found no device mapping information for device '$devname'\n"
6434 if !$devinfo->{$devname}->{virtdev
};
6437 # create empty/temp config
6439 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
6440 foreach_drive
($oldconf, sub {
6441 my ($ds, $drive) = @_;
6443 return if !$drive->{is_cloudinit
} && drive_is_cdrom
($drive);
6445 my $volid = $drive->{file
};
6446 return if !$volid || $volid =~ m
|^/|;
6448 my ($path, $owner) = PVE
::Storage
::path
($cfg, $volid);
6449 return if !$path || !$owner || ($owner != $vmid);
6451 # Note: only delete disk we want to restore
6452 # other volumes will become unused
6453 if ($virtdev_hash->{$ds}) {
6454 eval { PVE
::Storage
::vdisk_free
($cfg, $volid); };
6461 # delete vmstate files, after the restore we have no snapshots anymore
6462 foreach my $snapname (keys %{$oldconf->{snapshots
}}) {
6463 my $snap = $oldconf->{snapshots
}->{$snapname};
6464 if ($snap->{vmstate
}) {
6465 eval { PVE
::Storage
::vdisk_free
($cfg, $snap->{vmstate
}); };
6474 foreach my $virtdev (sort keys %$virtdev_hash) {
6475 my $d = $virtdev_hash->{$virtdev};
6476 my $alloc_size = int(($d->{size
} + 1024 - 1)/1024);
6477 my $storeid = $d->{storeid
};
6478 my $scfg = PVE
::Storage
::storage_config
($cfg, $storeid);
6481 if (my $limit = $storage_limits{$storeid}) {
6482 $map_opts .= "throttling.bps=$limit:throttling.group=$storeid:";
6485 # test if requested format is supported
6486 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($cfg, $storeid);
6487 my $supported = grep { $_ eq $d->{format
} } @$validFormats;
6488 $d->{format
} = $defFormat if !$supported;
6491 if ($d->{is_cloudinit
}) {
6493 $name .= ".$d->{format}" if $d->{format
} ne 'raw';
6496 my $volid = PVE
::Storage
::vdisk_alloc
($cfg, $storeid, $vmid, $d->{format
}, $name, $alloc_size);
6497 print STDERR
"new volume ID is '$volid'\n";
6498 $d->{volid
} = $volid;
6500 PVE
::Storage
::activate_volumes
($cfg, [$volid]);
6502 my $write_zeros = 1;
6503 if (PVE
::Storage
::volume_has_feature
($cfg, 'sparseinit', $volid)) {
6507 if (!$d->{is_cloudinit
}) {
6508 my $path = PVE
::Storage
::path
($cfg, $volid);
6510 print $fifofh "${map_opts}format=$d->{format}:${write_zeros}:$d->{devname}=$path\n";
6512 print "map '$d->{devname}' to '$path' (write zeros = ${write_zeros})\n";
6514 $map->{$virtdev} = $volid;
6517 $fh->seek(0, 0) || die "seek failed - $!\n";
6519 my $outfd = new IO
::File
($tmpfn, "w") ||
6520 die "unable to write config for VM $vmid\n";
6522 my $cookie = { netcount
=> 0 };
6523 while (defined(my $line = <$fh>)) {
6524 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6537 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6538 local $SIG{ALRM
} = sub { die "got timeout\n"; };
6540 $oldtimeout = alarm($timeout);
6547 if ($line =~ m/^DEV:\sdev_id=(\d+)\ssize:\s(\d+)\sdevname:\s(\S+)$/) {
6548 my ($dev_id, $size, $devname) = ($1, $2, $3);
6549 $devinfo->{$devname} = { size
=> $size, dev_id
=> $dev_id };
6550 } elsif ($line =~ m/^CTIME: /) {
6551 # we correctly received the vma config, so we can disable
6552 # the timeout now for disk allocation (set to 10 minutes, so
6553 # that we always timeout if something goes wrong)
6556 print $fifofh "done\n";
6557 my $tmp = $oldtimeout || 0;
6558 $oldtimeout = undef;
6564 print "restore vma archive: $dbg_cmdstring\n";
6565 run_command
($commands, input
=> $input, outfunc
=> $parser, afterfork
=> $openfifo);
6569 alarm($oldtimeout) if $oldtimeout;
6572 foreach my $devname (keys %$devinfo) {
6573 my $volid = $devinfo->{$devname}->{volid
};
6574 push @$vollist, $volid if $volid;
6577 PVE
::Storage
::deactivate_volumes
($cfg, $vollist);
6585 foreach my $devname (keys %$devinfo) {
6586 my $volid = $devinfo->{$devname}->{volid
};
6589 if ($volid =~ m
|^/|) {
6590 unlink $volid || die 'unlink failed\n';
6592 PVE
::Storage
::vdisk_free
($cfg, $volid);
6594 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
6596 print STDERR
"unable to cleanup '$volid' - $@" if $@;
6603 rename($tmpfn, $conffile) ||
6604 die "unable to commit configuration file '$conffile'\n";
6606 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6608 eval { rescan
($vmid, 1); };
6612 sub restore_tar_archive
{
6613 my ($archive, $vmid, $user, $opts) = @_;
6615 if ($archive ne '-') {
6616 my $firstfile = tar_archive_read_firstfile
($archive);
6617 die "ERROR: file '$archive' dos not lock like a QemuServer vzdump backup\n"
6618 if $firstfile ne 'qemu-server.conf';
6621 my $storecfg = PVE
::Storage
::config
();
6623 # destroy existing data - keep empty config
6624 my $vmcfgfn = PVE
::QemuConfig-
>config_file($vmid);
6625 destroy_vm
($storecfg, $vmid, 1) if -f
$vmcfgfn;
6627 my $tocmd = "/usr/lib/qemu-server/qmextract";
6629 $tocmd .= " --storage " . PVE
::Tools
::shellquote
($opts->{storage
}) if $opts->{storage
};
6630 $tocmd .= " --pool " . PVE
::Tools
::shellquote
($opts->{pool
}) if $opts->{pool
};
6631 $tocmd .= ' --prealloc' if $opts->{prealloc
};
6632 $tocmd .= ' --info' if $opts->{info
};
6634 # tar option "xf" does not autodetect compression when read from STDIN,
6635 # so we pipe to zcat
6636 my $cmd = "zcat -f|tar xf " . PVE
::Tools
::shellquote
($archive) . " " .
6637 PVE
::Tools
::shellquote
("--to-command=$tocmd");
6639 my $tmpdir = "/var/tmp/vzdumptmp$$";
6642 local $ENV{VZDUMP_TMPDIR
} = $tmpdir;
6643 local $ENV{VZDUMP_VMID
} = $vmid;
6644 local $ENV{VZDUMP_USER
} = $user;
6646 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6647 my $tmpfn = "$conffile.$$.tmp";
6649 # disable interrupts (always do cleanups)
6653 local $SIG{HUP
} = sub { print STDERR
"got interrupt - ignored\n"; };
6661 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6663 if ($archive eq '-') {
6664 print "extracting archive from STDIN\n";
6665 run_command
($cmd, input
=> "<&STDIN");
6667 print "extracting archive '$archive'\n";
6671 return if $opts->{info
};
6675 my $statfile = "$tmpdir/qmrestore.stat";
6676 if (my $fd = IO
::File-
>new($statfile, "r")) {
6677 while (defined (my $line = <$fd>)) {
6678 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
6679 $map->{$1} = $2 if $1;
6681 print STDERR
"unable to parse line in statfile - $line\n";
6687 my $confsrc = "$tmpdir/qemu-server.conf";
6689 my $srcfd = new IO
::File
($confsrc, "r") ||
6690 die "unable to open file '$confsrc'\n";
6692 my $outfd = new IO
::File
($tmpfn, "w") ||
6693 die "unable to write config for VM $vmid\n";
6695 my $cookie = { netcount
=> 0 };
6696 while (defined (my $line = <$srcfd>)) {
6697 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6709 tar_restore_cleanup
($storecfg, "$tmpdir/qmrestore.stat") if !$opts->{info
};
6716 rename $tmpfn, $conffile ||
6717 die "unable to commit configuration file '$conffile'\n";
6719 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6721 eval { rescan
($vmid, 1); };
6725 sub foreach_storage_used_by_vm
{
6726 my ($conf, $func) = @_;
6730 foreach_drive
($conf, sub {
6731 my ($ds, $drive) = @_;
6732 return if drive_is_cdrom
($drive);
6734 my $volid = $drive->{file
};
6736 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
6737 $sidhash->{$sid} = $sid if $sid;
6740 foreach my $sid (sort keys %$sidhash) {
6745 sub do_snapshots_with_qemu
{
6746 my ($storecfg, $volid) = @_;
6748 my $storage_name = PVE
::Storage
::parse_volume_id
($volid);
6749 my $scfg = $storecfg->{ids
}->{$storage_name};
6751 if ($qemu_snap_storage->{$scfg->{type
}} && !$scfg->{krbd
}){
6755 if ($volid =~ m/\.(qcow2|qed)$/){
6762 sub qga_check_running
{
6763 my ($vmid, $nowarn) = @_;
6765 eval { vm_mon_cmd
($vmid, "guest-ping", timeout
=> 3); };
6767 warn "Qemu Guest Agent is not running - $@" if !$nowarn;
6773 sub template_create
{
6774 my ($vmid, $conf, $disk) = @_;
6776 my $storecfg = PVE
::Storage
::config
();
6778 foreach_drive
($conf, sub {
6779 my ($ds, $drive) = @_;
6781 return if drive_is_cdrom
($drive);
6782 return if $disk && $ds ne $disk;
6784 my $volid = $drive->{file
};
6785 return if !PVE
::Storage
::volume_has_feature
($storecfg, 'template', $volid);
6787 my $voliddst = PVE
::Storage
::vdisk_create_base
($storecfg, $volid);
6788 $drive->{file
} = $voliddst;
6789 $conf->{$ds} = print_drive
($vmid, $drive);
6790 PVE
::QemuConfig-
>write_config($vmid, $conf);
6794 sub convert_iscsi_path
{
6797 if ($path =~ m
|^iscsi
://([^/]+)/([^/]+)/(.+)$|) {
6802 my $initiator_name = get_initiator_name
();
6804 return "file.driver=iscsi,file.transport=tcp,file.initiator-name=$initiator_name,".
6805 "file.portal=$portal,file.target=$target,file.lun=$lun,driver=raw";
6808 die "cannot convert iscsi path '$path', unkown format\n";
6811 sub qemu_img_convert
{
6812 my ($src_volid, $dst_volid, $size, $snapname, $is_zero_initialized) = @_;
6814 my $storecfg = PVE
::Storage
::config
();
6815 my ($src_storeid, $src_volname) = PVE
::Storage
::parse_volume_id
($src_volid, 1);
6816 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid, 1);
6818 if ($src_storeid && $dst_storeid) {
6820 PVE
::Storage
::activate_volumes
($storecfg, [$src_volid], $snapname);
6822 my $src_scfg = PVE
::Storage
::storage_config
($storecfg, $src_storeid);
6823 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6825 my $src_format = qemu_img_format
($src_scfg, $src_volname);
6826 my $dst_format = qemu_img_format
($dst_scfg, $dst_volname);
6828 my $src_path = PVE
::Storage
::path
($storecfg, $src_volid, $snapname);
6829 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6831 my $src_is_iscsi = ($src_path =~ m
|^iscsi
://|);
6832 my $dst_is_iscsi = ($dst_path =~ m
|^iscsi
://|);
6835 push @$cmd, '/usr/bin/qemu-img', 'convert', '-p', '-n';
6836 push @$cmd, '-l', "snapshot.name=$snapname" if($snapname && $src_format eq "qcow2");
6837 push @$cmd, '-t', 'none' if $dst_scfg->{type
} eq 'zfspool';
6838 push @$cmd, '-T', 'none' if $src_scfg->{type
} eq 'zfspool';
6840 if ($src_is_iscsi) {
6841 push @$cmd, '--image-opts';
6842 $src_path = convert_iscsi_path
($src_path);
6844 push @$cmd, '-f', $src_format;
6847 if ($dst_is_iscsi) {
6848 push @$cmd, '--target-image-opts';
6849 $dst_path = convert_iscsi_path
($dst_path);
6851 push @$cmd, '-O', $dst_format;
6854 push @$cmd, $src_path;
6856 if (!$dst_is_iscsi && $is_zero_initialized) {
6857 push @$cmd, "zeroinit:$dst_path";
6859 push @$cmd, $dst_path;
6864 if($line =~ m/\((\S+)\/100\
%\)/){
6866 my $transferred = int($size * $percent / 100);
6867 my $remaining = $size - $transferred;
6869 print "transferred: $transferred bytes remaining: $remaining bytes total: $size bytes progression: $percent %\n";
6874 eval { run_command
($cmd, timeout
=> undef, outfunc
=> $parser); };
6876 die "copy failed: $err" if $err;
6880 sub qemu_img_format
{
6881 my ($scfg, $volname) = @_;
6883 if ($scfg->{path
} && $volname =~ m/\.($QEMU_FORMAT_RE)$/) {
6890 sub qemu_drive_mirror
{
6891 my ($vmid, $drive, $dst_volid, $vmiddst, $is_zero_initialized, $jobs, $skipcomplete, $qga, $bwlimit) = @_;
6893 $jobs = {} if !$jobs;
6897 $jobs->{"drive-$drive"} = {};
6899 if ($dst_volid =~ /^nbd:/) {
6900 $qemu_target = $dst_volid;
6903 my $storecfg = PVE
::Storage
::config
();
6904 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid);
6906 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6908 $format = qemu_img_format
($dst_scfg, $dst_volname);
6910 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6912 $qemu_target = $is_zero_initialized ?
"zeroinit:$dst_path" : $dst_path;
6915 my $opts = { timeout
=> 10, device
=> "drive-$drive", mode
=> "existing", sync
=> "full", target
=> $qemu_target };
6916 $opts->{format
} = $format if $format;
6918 if (defined($bwlimit)) {
6919 $opts->{speed
} = $bwlimit * 1024;
6920 print "drive mirror is starting for drive-$drive with bandwidth limit: ${bwlimit} KB/s\n";
6922 print "drive mirror is starting for drive-$drive\n";
6925 # if a job already runs for this device we get an error, catch it for cleanup
6926 eval { vm_mon_cmd
($vmid, "drive-mirror", %$opts); };
6928 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6930 die "mirroring error: $err\n";
6933 qemu_drive_mirror_monitor
($vmid, $vmiddst, $jobs, $skipcomplete, $qga);
6936 sub qemu_drive_mirror_monitor
{
6937 my ($vmid, $vmiddst, $jobs, $skipcomplete, $qga) = @_;
6940 my $err_complete = 0;
6943 die "storage migration timed out\n" if $err_complete > 300;
6945 my $stats = vm_mon_cmd
($vmid, "query-block-jobs");
6947 my $running_mirror_jobs = {};
6948 foreach my $stat (@$stats) {
6949 next if $stat->{type
} ne 'mirror';
6950 $running_mirror_jobs->{$stat->{device
}} = $stat;
6953 my $readycounter = 0;
6955 foreach my $job (keys %$jobs) {
6957 if(defined($jobs->{$job}->{complete
}) && !defined($running_mirror_jobs->{$job})) {
6958 print "$job : finished\n";
6959 delete $jobs->{$job};
6963 die "$job: mirroring has been cancelled\n" if !defined($running_mirror_jobs->{$job});
6965 my $busy = $running_mirror_jobs->{$job}->{busy
};
6966 my $ready = $running_mirror_jobs->{$job}->{ready
};
6967 if (my $total = $running_mirror_jobs->{$job}->{len
}) {
6968 my $transferred = $running_mirror_jobs->{$job}->{offset
} || 0;
6969 my $remaining = $total - $transferred;
6970 my $percent = sprintf "%.2f", ($transferred * 100 / $total);
6972 print "$job: transferred: $transferred bytes remaining: $remaining bytes total: $total bytes progression: $percent % busy: $busy ready: $ready \n";
6975 $readycounter++ if $running_mirror_jobs->{$job}->{ready
};
6978 last if scalar(keys %$jobs) == 0;
6980 if ($readycounter == scalar(keys %$jobs)) {
6981 print "all mirroring jobs are ready \n";
6982 last if $skipcomplete; #do the complete later
6984 if ($vmiddst && $vmiddst != $vmid) {
6985 my $agent_running = $qga && qga_check_running
($vmid);
6986 if ($agent_running) {
6987 print "freeze filesystem\n";
6988 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "guest-fsfreeze-freeze"); };
6990 print "suspend vm\n";
6991 eval { PVE
::QemuServer
::vm_suspend
($vmid, 1); };
6994 # if we clone a disk for a new target vm, we don't switch the disk
6995 PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs);
6997 if ($agent_running) {
6998 print "unfreeze filesystem\n";
6999 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "guest-fsfreeze-thaw"); };
7001 print "resume vm\n";
7002 eval { PVE
::QemuServer
::vm_resume
($vmid, 1, 1); };
7008 foreach my $job (keys %$jobs) {
7009 # try to switch the disk if source and destination are on the same guest
7010 print "$job: Completing block job...\n";
7012 eval { vm_mon_cmd
($vmid, "block-job-complete", device
=> $job) };
7013 if ($@ =~ m/cannot be completed/) {
7014 print "$job: Block job cannot be completed, try again.\n";
7017 print "$job: Completed successfully.\n";
7018 $jobs->{$job}->{complete
} = 1;
7029 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
7030 die "mirroring error: $err";
7035 sub qemu_blockjobs_cancel
{
7036 my ($vmid, $jobs) = @_;
7038 foreach my $job (keys %$jobs) {
7039 print "$job: Cancelling block job\n";
7040 eval { vm_mon_cmd
($vmid, "block-job-cancel", device
=> $job); };
7041 $jobs->{$job}->{cancel
} = 1;
7045 my $stats = vm_mon_cmd
($vmid, "query-block-jobs");
7047 my $running_jobs = {};
7048 foreach my $stat (@$stats) {
7049 $running_jobs->{$stat->{device
}} = $stat;
7052 foreach my $job (keys %$jobs) {
7054 if (defined($jobs->{$job}->{cancel
}) && !defined($running_jobs->{$job})) {
7055 print "$job: Done.\n";
7056 delete $jobs->{$job};
7060 last if scalar(keys %$jobs) == 0;
7067 my ($storecfg, $vmid, $running, $drivename, $drive, $snapname,
7068 $newvmid, $storage, $format, $full, $newvollist, $jobs, $skipcomplete, $qga, $bwlimit) = @_;
7073 print "create linked clone of drive $drivename ($drive->{file})\n";
7074 $newvolid = PVE
::Storage
::vdisk_clone
($storecfg, $drive->{file
}, $newvmid, $snapname);
7075 push @$newvollist, $newvolid;
7078 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
});
7079 $storeid = $storage if $storage;
7081 my $dst_format = resolve_dst_disk_format
($storecfg, $storeid, $volname, $format);
7082 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $drive->{file
}, 3);
7084 print "create full clone of drive $drivename ($drive->{file})\n";
7086 if (drive_is_cloudinit
($drive)) {
7087 $name = "vm-$newvmid-cloudinit";
7089 # we only get here if it's supported by QEMU_FORMAT_RE, so just accept
7090 if ($dst_format ne 'raw') {
7091 $name .= ".$dst_format";
7094 $newvolid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $newvmid, $dst_format, $name, ($size/1024));
7095 push @$newvollist, $newvolid;
7097 PVE
::Storage
::activate_volumes
($storecfg, [$newvolid]);
7099 my $sparseinit = PVE
::Storage
::volume_has_feature
($storecfg, 'sparseinit', $newvolid);
7100 if (!$running || $snapname) {
7101 # TODO: handle bwlimits
7102 qemu_img_convert
($drive->{file
}, $newvolid, $size, $snapname, $sparseinit);
7105 my $kvmver = get_running_qemu_version
($vmid);
7106 if (!qemu_machine_feature_enabled
(undef, $kvmver, 2, 7)) {
7107 die "drive-mirror with iothread requires qemu version 2.7 or higher\n"
7108 if $drive->{iothread
};
7111 qemu_drive_mirror
($vmid, $drivename, $newvolid, $newvmid, $sparseinit, $jobs, $skipcomplete, $qga, $bwlimit);
7115 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $newvolid, 3);
7118 $disk->{format
} = undef;
7119 $disk->{file
} = $newvolid;
7120 $disk->{size
} = $size;
7125 # this only works if VM is running
7126 sub get_current_qemu_machine
{
7129 my $cmd = { execute
=> 'query-machines', arguments
=> {} };
7130 my $res = vm_qmp_command
($vmid, $cmd);
7132 my ($current, $default);
7133 foreach my $e (@$res) {
7134 $default = $e->{name
} if $e->{'is-default'};
7135 $current = $e->{name
} if $e->{'is-current'};
7138 # fallback to the default machine if current is not supported by qemu
7139 return $current || $default || 'pc';
7142 sub get_running_qemu_version
{
7144 my $cmd = { execute
=> 'query-version', arguments
=> {} };
7145 my $res = vm_qmp_command
($vmid, $cmd);
7146 return "$res->{qemu}->{major}.$res->{qemu}->{minor}";
7149 sub qemu_machine_feature_enabled
{
7150 my ($machine, $kvmver, $version_major, $version_minor) = @_;
7155 if ($machine && $machine =~ m/^((?:pc(-i440fx|-q35)?|virt)-(\d+)\.(\d+))/) {
7157 $current_major = $3;
7158 $current_minor = $4;
7160 } elsif ($kvmver =~ m/^(\d+)\.(\d+)/) {
7162 $current_major = $1;
7163 $current_minor = $2;
7166 return 1 if $current_major > $version_major ||
7167 ($current_major == $version_major &&
7168 $current_minor >= $version_minor);
7171 sub qemu_machine_pxe
{
7172 my ($vmid, $conf, $machine) = @_;
7174 $machine = PVE
::QemuServer
::get_current_qemu_machine
($vmid) if !$machine;
7176 if ($conf->{machine
} && $conf->{machine
} =~ m/\.pxe$/) {
7183 sub qemu_use_old_bios_files
{
7184 my ($machine_type) = @_;
7186 return if !$machine_type;
7188 my $use_old_bios_files = undef;
7190 if ($machine_type =~ m/^(\S+)\.pxe$/) {
7192 $use_old_bios_files = 1;
7194 my $kvmver = kvm_user_version
();
7195 # Note: kvm version < 2.4 use non-efi pxe files, and have problems when we
7196 # load new efi bios files on migration. So this hack is required to allow
7197 # live migration from qemu-2.2 to qemu-2.4, which is sometimes used when
7198 # updrading from proxmox-ve-3.X to proxmox-ve 4.0
7199 $use_old_bios_files = !qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 4);
7202 return ($use_old_bios_files, $machine_type);
7205 sub create_efidisk
($$$$$) {
7206 my ($storecfg, $storeid, $vmid, $fmt, $arch) = @_;
7208 my (undef, $ovmf_vars) = get_ovmf_files
($arch);
7209 die "EFI vars default image not found\n" if ! -f
$ovmf_vars;
7211 my $vars_size = PVE
::Tools
::convert_size
(-s
$ovmf_vars, 'b' => 'kb');
7212 my $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $vmid, $fmt, undef, $vars_size);
7213 PVE
::Storage
::activate_volumes
($storecfg, [$volid]);
7215 my $path = PVE
::Storage
::path
($storecfg, $volid);
7217 run_command
(['/usr/bin/qemu-img', 'convert', '-n', '-f', 'raw', '-O', $fmt, $ovmf_vars, $path]);
7219 die "Copying EFI vars image failed: $@" if $@;
7221 return ($volid, $vars_size);
7224 sub vm_iothreads_list
{
7227 my $res = vm_mon_cmd
($vmid, 'query-iothreads');
7230 foreach my $iothread (@$res) {
7231 $iothreads->{ $iothread->{id
} } = $iothread->{"thread-id"};
7238 my ($conf, $drive) = @_;
7242 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)) {
7244 } elsif ($conf->{scsihw
} && ($conf->{scsihw
} eq 'virtio-scsi-single')) {
7250 my $controller = int($drive->{index} / $maxdev);
7251 my $controller_prefix = ($conf->{scsihw
} && $conf->{scsihw
} eq 'virtio-scsi-single') ?
"virtioscsi" : "scsihw";
7253 return ($maxdev, $controller, $controller_prefix);
7256 sub add_hyperv_enlightenments
{
7257 my ($cpuFlags, $winversion, $machine_type, $kvmver, $bios, $gpu_passthrough, $hv_vendor_id) = @_;
7259 return if $winversion < 6;
7260 return if $bios && $bios eq 'ovmf' && $winversion < 8;
7262 if ($gpu_passthrough || defined($hv_vendor_id)) {
7263 $hv_vendor_id //= 'proxmox';
7264 push @$cpuFlags , "hv_vendor_id=$hv_vendor_id";
7267 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
7268 push @$cpuFlags , 'hv_spinlocks=0x1fff';
7269 push @$cpuFlags , 'hv_vapic';
7270 push @$cpuFlags , 'hv_time';
7272 push @$cpuFlags , 'hv_spinlocks=0xffff';
7275 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 6)) {
7276 push @$cpuFlags , 'hv_reset';
7277 push @$cpuFlags , 'hv_vpindex';
7278 push @$cpuFlags , 'hv_runtime';
7281 if ($winversion >= 7) {
7282 push @$cpuFlags , 'hv_relaxed';
7284 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 12)) {
7285 push @$cpuFlags , 'hv_synic';
7286 push @$cpuFlags , 'hv_stimer';
7289 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 3, 1)) {
7290 push @$cpuFlags , 'hv_ipi';
7295 sub windows_version
{
7298 return 0 if !$ostype;
7302 if($ostype eq 'wxp' || $ostype eq 'w2k3' || $ostype eq 'w2k') {
7304 } elsif($ostype eq 'w2k8' || $ostype eq 'wvista') {
7306 } elsif ($ostype =~ m/^win(\d+)$/) {
7313 sub resolve_dst_disk_format
{
7314 my ($storecfg, $storeid, $src_volname, $format) = @_;
7315 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($storecfg, $storeid);
7318 # if no target format is specified, use the source disk format as hint
7320 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
7321 $format = qemu_img_format
($scfg, $src_volname);
7327 # test if requested format is supported - else use default
7328 my $supported = grep { $_ eq $format } @$validFormats;
7329 $format = $defFormat if !$supported;
7333 sub resolve_first_disk
{
7335 my @disks = PVE
::QemuServer
::valid_drive_names
();
7337 foreach my $ds (reverse @disks) {
7338 next if !$conf->{$ds};
7339 my $disk = PVE
::QemuServer
::parse_drive
($ds, $conf->{$ds});
7340 next if PVE
::QemuServer
::drive_is_cdrom
($disk);
7347 my ($uuid, $uuid_str);
7348 UUID
::generate
($uuid);
7349 UUID
::unparse
($uuid, $uuid_str);
7353 sub generate_smbios1_uuid
{
7354 return "uuid=".generate_uuid
();
7360 vm_mon_cmd
($vmid, 'nbd-server-stop');
7363 # bash completion helper
7365 sub complete_backup_archives
{
7366 my ($cmdname, $pname, $cvalue) = @_;
7368 my $cfg = PVE
::Storage
::config
();
7372 if ($cvalue =~ m/^([^:]+):/) {
7376 my $data = PVE
::Storage
::template_list
($cfg, $storeid, 'backup');
7379 foreach my $id (keys %$data) {
7380 foreach my $item (@{$data->{$id}}) {
7381 next if $item->{format
} !~ m/^vma\.(gz|lzo)$/;
7382 push @$res, $item->{volid
} if defined($item->{volid
});
7389 my $complete_vmid_full = sub {
7392 my $idlist = vmstatus
();
7396 foreach my $id (keys %$idlist) {
7397 my $d = $idlist->{$id};
7398 if (defined($running)) {
7399 next if $d->{template
};
7400 next if $running && $d->{status
} ne 'running';
7401 next if !$running && $d->{status
} eq 'running';
7410 return &$complete_vmid_full();
7413 sub complete_vmid_stopped
{
7414 return &$complete_vmid_full(0);
7417 sub complete_vmid_running
{
7418 return &$complete_vmid_full(1);
7421 sub complete_storage
{
7423 my $cfg = PVE
::Storage
::config
();
7424 my $ids = $cfg->{ids
};
7427 foreach my $sid (keys %$ids) {
7428 next if !PVE
::Storage
::storage_check_enabled
($cfg, $sid, undef, 1);
7429 next if !$ids->{$sid}->{content
}->{images
};