1 package PVE
::QemuServer
;
22 use Storable
qw(dclone);
23 use PVE
::Exception
qw(raise raise_param_exc);
25 use PVE
::Tools
qw(run_command lock_file lock_file_full file_read_firstline dir_glob_foreach $IPV6RE);
26 use PVE
::JSONSchema
qw(get_standard_option);
27 use PVE
::Cluster
qw(cfs_register_file cfs_read_file cfs_write_file cfs_lock_file);
32 use PVE
::RPCEnvironment
;
33 use PVE
::QemuServer
::PCI
qw(print_pci_addr print_pcie_addr);
34 use PVE
::QemuServer
::Memory
;
35 use PVE
::QemuServer
::USB
qw(parse_usb_device);
36 use PVE
::QemuServer
::Cloudinit
;
38 use Time
::HiRes
qw(gettimeofday);
39 use File
::Copy
qw(copy);
42 my $EDK2_FW_BASE = '/usr/share/pve-edk2-firmware/';
45 "$EDK2_FW_BASE/OVMF_CODE.fd",
46 "$EDK2_FW_BASE/OVMF_VARS.fd"
49 "$EDK2_FW_BASE/AAVMF_CODE.fd",
50 "$EDK2_FW_BASE/AAVMF_VARS.fd"
54 my $qemu_snap_storage = {rbd
=> 1, sheepdog
=> 1};
56 my $cpuinfo = PVE
::ProcFSTools
::read_cpuinfo
();
58 my $QEMU_FORMAT_RE = qr/raw|cow|qcow|qcow2|qed|vmdk|cloop/;
60 # Note about locking: we use flock on the config file protect
61 # against concurent actions.
62 # Aditionaly, we have a 'lock' setting in the config file. This
63 # can be set to 'migrate', 'backup', 'snapshot' or 'rollback'. Most actions are not
64 # allowed when such lock is set. But you can ignore this kind of
65 # lock with the --skiplock flag.
67 cfs_register_file
('/qemu-server/',
71 PVE
::JSONSchema
::register_standard_option
('pve-qm-stateuri', {
72 description
=> "Some command save/restore state from this location.",
78 PVE
::JSONSchema
::register_standard_option
('pve-snapshot-name', {
79 description
=> "The name of the snapshot.",
80 type
=> 'string', format
=> 'pve-configid',
84 PVE
::JSONSchema
::register_standard_option
('pve-qm-image-format', {
86 enum
=> [qw(raw cow qcow qed qcow2 vmdk cloop)],
87 description
=> "The drive's backing file's data format.",
91 PVE
::JSONSchema
::register_standard_option
('pve-qemu-machine', {
92 description
=> "Specifies the Qemu machine type.",
94 pattern
=> '(pc|pc(-i440fx)?-\d+\.\d+(\.pxe)?|q35|pc-q35-\d+\.\d+(\.pxe)?|virt(?:-\d+\.\d+)?)',
99 #no warnings 'redefine';
102 my ($controller, $vmid, $option, $value) = @_;
104 my $path = "/sys/fs/cgroup/$controller/qemu.slice/$vmid.scope/$option";
105 PVE
::ProcFSTools
::write_proc_entry
($path, $value);
109 my $nodename = PVE
::INotify
::nodename
();
111 mkdir "/etc/pve/nodes/$nodename";
112 my $confdir = "/etc/pve/nodes/$nodename/qemu-server";
115 my $var_run_tmpdir = "/var/run/qemu-server";
116 mkdir $var_run_tmpdir;
118 my $lock_dir = "/var/lock/qemu-server";
121 my $pcisysfs = "/sys/bus/pci";
123 my $cpu_vendor_list = {
125 486 => 'GenuineIntel',
126 pentium
=> 'GenuineIntel',
127 pentium2
=> 'GenuineIntel',
128 pentium3
=> 'GenuineIntel',
129 coreduo
=> 'GenuineIntel',
130 core2duo
=> 'GenuineIntel',
131 Conroe
=> 'GenuineIntel',
132 Penryn
=> 'GenuineIntel',
133 Nehalem
=> 'GenuineIntel',
134 'Nehalem-IBRS' => 'GenuineIntel',
135 Westmere
=> 'GenuineIntel',
136 'Westmere-IBRS' => 'GenuineIntel',
137 SandyBridge
=> 'GenuineIntel',
138 'SandyBridge-IBRS' => 'GenuineIntel',
139 IvyBridge
=> 'GenuineIntel',
140 'IvyBridge-IBRS' => 'GenuineIntel',
141 Haswell
=> 'GenuineIntel',
142 'Haswell-IBRS' => 'GenuineIntel',
143 'Haswell-noTSX' => 'GenuineIntel',
144 'Haswell-noTSX-IBRS' => 'GenuineIntel',
145 Broadwell
=> 'GenuineIntel',
146 'Broadwell-IBRS' => 'GenuineIntel',
147 'Broadwell-noTSX' => 'GenuineIntel',
148 'Broadwell-noTSX-IBRS' => 'GenuineIntel',
149 'Skylake-Client' => 'GenuineIntel',
150 'Skylake-Client-IBRS' => 'GenuineIntel',
151 'Skylake-Server' => 'GenuineIntel',
152 'Skylake-Server-IBRS' => 'GenuineIntel',
155 athlon
=> 'AuthenticAMD',
156 phenom
=> 'AuthenticAMD',
157 Opteron_G1
=> 'AuthenticAMD',
158 Opteron_G2
=> 'AuthenticAMD',
159 Opteron_G3
=> 'AuthenticAMD',
160 Opteron_G4
=> 'AuthenticAMD',
161 Opteron_G5
=> 'AuthenticAMD',
162 EPYC
=> 'AuthenticAMD',
163 'EPYC-IBPB' => 'AuthenticAMD',
165 # generic types, use vendor from host node
174 my $cpu_flag = qr/[+-](pcid|spec-ctrl|ibpb|ssbd|virt-ssbd|amd-ssbd|amd-no-ssb|pdpe1gb)/;
178 description
=> "Emulated CPU type.",
180 enum
=> [ sort { "\L$a" cmp "\L$b" } keys %$cpu_vendor_list ],
185 description
=> "Do not identify as a KVM virtual machine.",
191 description
=> "List of additional CPU flags separated by ';'."
192 . " Use '+FLAG' to enable, '-FLAG' to disable a flag."
193 . " Currently supported flags: 'pcid', 'spec-ctrl', 'ibpb', 'ssbd', 'virt-ssbd', 'amd-ssbd', 'amd-no-ssb', 'pdpe1gb'.",
194 format_description
=> '+FLAG[;-FLAG...]',
196 pattern
=> qr/$cpu_flag(;$cpu_flag)*/,
205 enum
=> [qw(i6300esb ib700)],
206 description
=> "Watchdog type to emulate.",
207 default => 'i6300esb',
212 enum
=> [qw(reset shutdown poweroff pause debug none)],
213 description
=> "The action to perform if after activation the guest fails to poll the watchdog in time.",
217 PVE
::JSONSchema
::register_format
('pve-qm-watchdog', $watchdog_fmt);
221 description
=> "Enable/disable Qemu GuestAgent.",
226 fstrim_cloned_disks
=> {
227 description
=> "Run fstrim after cloning/moving a disk.",
236 description
=> "Select the VGA type.",
241 enum
=> [qw(cirrus qxl qxl2 qxl3 qxl4 serial0 serial1 serial2 serial3 std virtio vmware)],
244 description
=> "Sets the VGA memory (in MiB). Has no effect with serial display.",
256 description
=> "Specifies whether a VM will be started during system bootup.",
262 description
=> "Automatic restart after crash (currently ignored).",
267 type
=> 'string', format
=> 'pve-hotplug-features',
268 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'.",
269 default => 'network,disk,usb',
274 description
=> "Allow reboot. If set to '0' the VM exit on reboot.",
280 description
=> "Lock/unlock the VM.",
281 enum
=> [qw(migrate backup snapshot rollback)],
286 description
=> "Limit of CPU usage.",
287 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.",
295 description
=> "CPU weight for a VM.",
296 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.",
304 description
=> "Amount of RAM for the VM in MB. This is the maximum available memory when you use the balloon device.",
311 description
=> "Amount of target RAM for the VM in MB. Using zero disables the ballon driver.",
317 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.",
325 description
=> "Keybord layout for vnc server. Default is read from the '/etc/pve/datacenter.cfg' configuration file.".
326 "It should not be necessary to set it.",
327 enum
=> PVE
::Tools
::kvmkeymaplist
(),
332 type
=> 'string', format
=> 'dns-name',
333 description
=> "Set a name for the VM. Only used on the configuration web interface.",
338 description
=> "SCSI controller model",
339 enum
=> [qw(lsi lsi53c810 virtio-scsi-pci virtio-scsi-single megasas pvscsi)],
345 description
=> "Description for the VM. Only used on the configuration web interface. This is saved as comment inside the configuration file.",
350 enum
=> [qw(other wxp w2k w2k3 w2k8 wvista win7 win8 win10 l24 l26 solaris)],
351 description
=> "Specify guest operating system.",
352 verbose_description
=> <<EODESC,
353 Specify guest operating system. This is used to enable special
354 optimization/features for specific operating systems:
357 other;; unspecified OS
358 wxp;; Microsoft Windows XP
359 w2k;; Microsoft Windows 2000
360 w2k3;; Microsoft Windows 2003
361 w2k8;; Microsoft Windows 2008
362 wvista;; Microsoft Windows Vista
363 win7;; Microsoft Windows 7
364 win8;; Microsoft Windows 8/2012/2012r2
365 win10;; Microsoft Windows 10/2016
366 l24;; Linux 2.4 Kernel
367 l26;; Linux 2.6/3.X Kernel
368 solaris;; Solaris/OpenSolaris/OpenIndiania kernel
374 description
=> "Boot on floppy (a), hard disk (c), CD-ROM (d), or network (n).",
375 pattern
=> '[acdn]{1,4}',
380 type
=> 'string', format
=> 'pve-qm-bootdisk',
381 description
=> "Enable booting from specified disk.",
382 pattern
=> '(ide|sata|scsi|virtio)\d+',
387 description
=> "The number of CPUs. Please use option -sockets instead.",
394 description
=> "The number of CPU sockets.",
401 description
=> "The number of cores per socket.",
408 description
=> "Enable/disable NUMA.",
414 description
=> "Enable/disable hugepages memory.",
415 enum
=> [qw(any 2 1024)],
420 description
=> "Number of hotplugged vcpus.",
427 description
=> "Enable/disable ACPI.",
432 description
=> "Enable/disable Qemu GuestAgent and its properties.",
434 format
=> $agent_fmt,
439 description
=> "Enable/disable KVM hardware virtualization.",
445 description
=> "Enable/disable time drift fix.",
451 description
=> "Set the real time clock to local time. This is enabled by default if ostype indicates a Microsoft OS.",
456 description
=> "Freeze CPU at startup (use 'c' monitor command to start execution).",
460 type
=> 'string', format
=> $vga_fmt,
461 description
=> "Configure the VGA hardware.",
462 verbose_description
=> "Configure the VGA Hardware. If you want to use ".
463 "high resolution modes (>= 1280x1024x16) you may need to increase " .
464 "the vga memory option. Since QEMU 2.9 the default VGA display type " .
465 "is 'std' for all OS types besides some Windows versions (XP and " .
466 "older) which use 'cirrus'. The 'qxl' option enables the SPICE " .
467 "display server. For win* OS you can select how many independent " .
468 "displays you want, Linux guests can add displays them self.\n".
469 "You can also run without any graphic card, using a serial device as terminal.",
473 type
=> 'string', format
=> 'pve-qm-watchdog',
474 description
=> "Create a virtual hardware watchdog device.",
475 verbose_description
=> "Create a virtual hardware watchdog device. Once enabled" .
476 " (by a guest action), the watchdog must be periodically polled " .
477 "by an agent inside the guest or else the watchdog will reset " .
478 "the guest (or execute the respective action specified)",
483 typetext
=> "(now | YYYY-MM-DD | YYYY-MM-DDTHH:MM:SS)",
484 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'.",
485 pattern
=> '(now|\d{4}-\d{1,2}-\d{1,2}(T\d{1,2}:\d{1,2}:\d{1,2})?)',
488 startup
=> get_standard_option
('pve-startup-order'),
492 description
=> "Enable/disable Template.",
498 description
=> "Arbitrary arguments passed to kvm.",
499 verbose_description
=> <<EODESCR,
500 Arbitrary arguments passed to kvm, for example:
502 args: -no-reboot -no-hpet
504 NOTE: this option is for experts only.
511 description
=> "Enable/disable the USB tablet device.",
512 verbose_description
=> "Enable/disable the USB tablet device. This device is " .
513 "usually needed to allow absolute mouse positioning with VNC. " .
514 "Else the mouse runs out of sync with normal VNC clients. " .
515 "If you're running lots of console-only guests on one host, " .
516 "you may consider disabling this to save some context switches. " .
517 "This is turned off by default if you use spice (-vga=qxl).",
522 description
=> "Set maximum speed (in MB/s) for migrations. Value 0 is no limit.",
526 migrate_downtime
=> {
529 description
=> "Set maximum tolerated downtime (in seconds) for migrations.",
535 type
=> 'string', format
=> 'pve-qm-ide',
536 typetext
=> '<volume>',
537 description
=> "This is an alias for option -ide2",
541 description
=> "Emulated CPU type.",
545 parent
=> get_standard_option
('pve-snapshot-name', {
547 description
=> "Parent snapshot name. This is used internally, and should not be modified.",
551 description
=> "Timestamp for snapshots.",
557 type
=> 'string', format
=> 'pve-volume-id',
558 description
=> "Reference to a volume which stores the VM state. This is used internally for snapshots.",
560 vmstatestorage
=> get_standard_option
('pve-storage-id', {
561 description
=> "Default storage for VM state volumes/files.",
564 runningmachine
=> get_standard_option
('pve-qemu-machine', {
565 description
=> "Specifies the Qemu machine type of the running vm. This is used internally for snapshots.",
567 machine
=> get_standard_option
('pve-qemu-machine'),
569 description
=> "Virtual processor architecture. Defaults to the host.",
572 enum
=> [qw(x86_64 aarch64)],
575 description
=> "Specify SMBIOS type 1 fields.",
576 type
=> 'string', format
=> 'pve-qm-smbios1',
583 description
=> "Sets the protection flag of the VM. This will disable the remove VM and remove disk operations.",
589 enum
=> [ qw(seabios ovmf) ],
590 description
=> "Select BIOS implementation.",
591 default => 'seabios',
595 pattern
=> '(?:[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}|[01])',
596 format_description
=> 'UUID',
597 description
=> "Set VM Generation ID. Use '1' to autogenerate on create or update, pass '0' to disable explicitly.",
598 verbose_description
=> "The VM generation ID (vmgenid) device exposes a".
599 " 128-bit integer value identifier to the guest OS. This allows to".
600 " notify the guest operating system when the virtual machine is".
601 " executed with a different configuration (e.g. snapshot execution".
602 " or creation from a template). The guest operating system notices".
603 " the change, and is then able to react as appropriate by marking".
604 " its copies of distributed databases as dirty, re-initializing its".
605 " random number generator, etc.\n".
606 "Note that auto-creation only works when done throug API/CLI create".
607 " or update methods, but not when manually editing the config file.",
608 default => "1 (autogenerated)",
613 my $confdesc_cloudinit = {
617 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.',
618 enum
=> ['configdrive2', 'nocloud'],
623 description
=> "cloud-init: User name to change ssh keys and password for instead of the image's configured default user.",
628 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.',
633 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.",
637 type
=> 'string', format
=> 'address-list',
638 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.",
643 format
=> 'urlencoded',
644 description
=> "cloud-init: Setup public SSH keys (one key per line, OpenSSH format).",
648 # what about other qemu settings ?
650 #machine => 'string',
663 ##soundhw => 'string',
665 while (my ($k, $v) = each %$confdesc) {
666 PVE
::JSONSchema
::register_standard_option
("pve-qm-$k", $v);
669 my $MAX_IDE_DISKS = 4;
670 my $MAX_SCSI_DISKS = 14;
671 my $MAX_VIRTIO_DISKS = 16;
672 my $MAX_SATA_DISKS = 6;
673 my $MAX_USB_DEVICES = 5;
675 my $MAX_UNUSED_DISKS = 256;
676 my $MAX_HOSTPCI_DEVICES = 4;
677 my $MAX_SERIAL_PORTS = 4;
678 my $MAX_PARALLEL_PORTS = 3;
684 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
685 description
=> "CPUs accessing this NUMA node.",
686 format_description
=> "id[-id];...",
690 description
=> "Amount of memory this NUMA node provides.",
695 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
696 description
=> "Host NUMA nodes to use.",
697 format_description
=> "id[-id];...",
702 enum
=> [qw(preferred bind interleave)],
703 description
=> "NUMA allocation policy.",
707 PVE
::JSONSchema
::register_format
('pve-qm-numanode', $numa_fmt);
710 type
=> 'string', format
=> $numa_fmt,
711 description
=> "NUMA topology.",
713 PVE
::JSONSchema
::register_standard_option
("pve-qm-numanode", $numadesc);
715 for (my $i = 0; $i < $MAX_NUMA; $i++) {
716 $confdesc->{"numa$i"} = $numadesc;
719 my $nic_model_list = ['rtl8139', 'ne2k_pci', 'e1000', 'pcnet', 'virtio',
720 'ne2k_isa', 'i82551', 'i82557b', 'i82559er', 'vmxnet3',
721 'e1000-82540em', 'e1000-82544gc', 'e1000-82545em'];
722 my $nic_model_list_txt = join(' ', sort @$nic_model_list);
724 my $net_fmt_bridge_descr = <<__EOD__;
725 Bridge to attach the network device to. The Proxmox VE standard bridge
728 If you do not specify a bridge, we create a kvm user (NATed) network
729 device, which provides DHCP and DNS services. The following addresses
736 The DHCP server assign addresses to the guest starting from 10.0.2.15.
742 pattern
=> qr/[0-9a-f]{2}(?::[0-9a-f]{2}){5}/i,
743 description
=> "MAC address. That address must be unique withing your network. This is automatically generated if not specified.",
744 format_description
=> "XX:XX:XX:XX:XX:XX",
749 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'.",
750 enum
=> $nic_model_list,
753 (map { $_ => { keyAlias
=> 'model', alias
=> 'macaddr' }} @$nic_model_list),
756 description
=> $net_fmt_bridge_descr,
757 format_description
=> 'bridge',
762 minimum
=> 0, maximum
=> 16,
763 description
=> 'Number of packet queues to be used on the device.',
769 description
=> "Rate limit in mbps (megabytes per second) as floating point number.",
774 minimum
=> 1, maximum
=> 4094,
775 description
=> 'VLAN tag to apply to packets on this interface.',
780 pattern
=> qr/\d+(?:-\d+)?(?:;\d+(?:-\d+)?)*/,
781 description
=> 'VLAN trunks to pass through this interface.',
782 format_description
=> 'vlanid[;vlanid...]',
787 description
=> 'Whether this interface should be protected by the firewall.',
792 description
=> 'Whether this interface should be disconnected (like pulling the plug).',
799 type
=> 'string', format
=> $net_fmt,
800 description
=> "Specify network devices.",
803 PVE
::JSONSchema
::register_standard_option
("pve-qm-net", $netdesc);
808 format
=> 'pve-ipv4-config',
809 format_description
=> 'IPv4Format/CIDR',
810 description
=> 'IPv4 address in CIDR format.',
817 format_description
=> 'GatewayIPv4',
818 description
=> 'Default gateway for IPv4 traffic.',
824 format
=> 'pve-ipv6-config',
825 format_description
=> 'IPv6Format/CIDR',
826 description
=> 'IPv6 address in CIDR format.',
833 format_description
=> 'GatewayIPv6',
834 description
=> 'Default gateway for IPv6 traffic.',
839 PVE
::JSONSchema
::register_format
('pve-qm-ipconfig', $ipconfig_fmt);
842 type
=> 'string', format
=> 'pve-qm-ipconfig',
843 description
=> <<'EODESCR',
844 cloud-init: Specify IP addresses and gateways for the corresponding interface.
846 IP addresses use CIDR notation, gateways are optional but need an IP of the same type specified.
848 The special string 'dhcp' can be used for IP addresses to use DHCP, in which case no explicit gateway should be provided.
849 For IPv6 the special string 'auto' can be used to use stateless autoconfiguration.
851 If cloud-init is enabled and neither an IPv4 nor an IPv6 address is specified, it defaults to using dhcp on IPv4.
854 PVE
::JSONSchema
::register_standard_option
("pve-qm-ipconfig", $netdesc);
856 for (my $i = 0; $i < $MAX_NETS; $i++) {
857 $confdesc->{"net$i"} = $netdesc;
858 $confdesc_cloudinit->{"ipconfig$i"} = $ipconfigdesc;
861 foreach my $key (keys %$confdesc_cloudinit) {
862 $confdesc->{$key} = $confdesc_cloudinit->{$key};
865 PVE
::JSONSchema
::register_format
('pve-volume-id-or-qm-path', \
&verify_volume_id_or_qm_path
);
866 sub verify_volume_id_or_qm_path
{
867 my ($volid, $noerr) = @_;
869 if ($volid eq 'none' || $volid eq 'cdrom' || $volid =~ m
|^/|) {
873 # if its neither 'none' nor 'cdrom' nor a path, check if its a volume-id
874 $volid = eval { PVE
::JSONSchema
::check_format
('pve-volume-id', $volid, '') };
876 return undef if $noerr;
884 my %drivedesc_base = (
885 volume
=> { alias
=> 'file' },
888 format
=> 'pve-volume-id-or-qm-path',
890 format_description
=> 'volume',
891 description
=> "The drive's backing volume.",
895 enum
=> [qw(cdrom disk)],
896 description
=> "The drive's media type.",
902 description
=> "Force the drive's physical geometry to have a specific cylinder count.",
907 description
=> "Force the drive's physical geometry to have a specific head count.",
912 description
=> "Force the drive's physical geometry to have a specific sector count.",
917 enum
=> [qw(none lba auto)],
918 description
=> "Force disk geometry bios translation mode.",
923 description
=> "Controls qemu's snapshot mode feature."
924 . " If activated, changes made to the disk are temporary and will"
925 . " be discarded when the VM is shutdown.",
930 enum
=> [qw(none writethrough writeback unsafe directsync)],
931 description
=> "The drive's cache mode",
934 format
=> get_standard_option
('pve-qm-image-format'),
937 format
=> 'disk-size',
938 format_description
=> 'DiskSize',
939 description
=> "Disk size. This is purely informational and has no effect.",
944 description
=> "Whether the drive should be included when making backups.",
949 description
=> 'Whether the drive should considered for replication jobs.',
955 enum
=> [qw(ignore report stop)],
956 description
=> 'Read error action.',
961 enum
=> [qw(enospc ignore report stop)],
962 description
=> 'Write error action.',
967 enum
=> [qw(native threads)],
968 description
=> 'AIO type to use.',
973 enum
=> [qw(ignore on)],
974 description
=> 'Controls whether to pass discard/trim requests to the underlying storage.',
979 description
=> 'Controls whether to detect and try to optimize writes of zeroes.',
984 format
=> 'urlencoded',
985 format_description
=> 'serial',
986 maxLength
=> 20*3, # *3 since it's %xx url enoded
987 description
=> "The drive's reported serial number, url-encoded, up to 20 bytes long.",
992 description
=> 'Mark this locally-managed volume as available on all nodes',
993 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!",
999 my %iothread_fmt = ( iothread
=> {
1001 description
=> "Whether to use iothreads for this drive",
1008 format
=> 'urlencoded',
1009 format_description
=> 'model',
1010 maxLength
=> 40*3, # *3 since it's %xx url enoded
1011 description
=> "The drive's reported model name, url-encoded, up to 40 bytes long.",
1019 description
=> "Number of queues.",
1025 my %scsiblock_fmt = (
1028 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",
1037 description
=> "Whether to expose this drive as an SSD, rather than a rotational hard disk.",
1042 my $add_throttle_desc = sub {
1043 my ($key, $type, $what, $unit, $longunit, $minimum) = @_;
1046 format_description
=> $unit,
1047 description
=> "Maximum $what in $longunit.",
1050 $d->{minimum
} = $minimum if defined($minimum);
1051 $drivedesc_base{$key} = $d;
1053 # throughput: (leaky bucket)
1054 $add_throttle_desc->('bps', 'integer', 'r/w speed', 'bps', 'bytes per second');
1055 $add_throttle_desc->('bps_rd', 'integer', 'read speed', 'bps', 'bytes per second');
1056 $add_throttle_desc->('bps_wr', 'integer', 'write speed', 'bps', 'bytes per second');
1057 $add_throttle_desc->('mbps', 'number', 'r/w speed', 'mbps', 'megabytes per second');
1058 $add_throttle_desc->('mbps_rd', 'number', 'read speed', 'mbps', 'megabytes per second');
1059 $add_throttle_desc->('mbps_wr', 'number', 'write speed', 'mbps', 'megabytes per second');
1060 $add_throttle_desc->('iops', 'integer', 'r/w I/O', 'iops', 'operations per second');
1061 $add_throttle_desc->('iops_rd', 'integer', 'read I/O', 'iops', 'operations per second');
1062 $add_throttle_desc->('iops_wr', 'integer', 'write I/O', 'iops', 'operations per second');
1064 # pools: (pool of IO before throttling starts taking effect)
1065 $add_throttle_desc->('mbps_max', 'number', 'unthrottled r/w pool', 'mbps', 'megabytes per second');
1066 $add_throttle_desc->('mbps_rd_max', 'number', 'unthrottled read pool', 'mbps', 'megabytes per second');
1067 $add_throttle_desc->('mbps_wr_max', 'number', 'unthrottled write pool', 'mbps', 'megabytes per second');
1068 $add_throttle_desc->('iops_max', 'integer', 'unthrottled r/w I/O pool', 'iops', 'operations per second');
1069 $add_throttle_desc->('iops_rd_max', 'integer', 'unthrottled read I/O pool', 'iops', 'operations per second');
1070 $add_throttle_desc->('iops_wr_max', 'integer', 'unthrottled write I/O pool', 'iops', 'operations per second');
1073 $add_throttle_desc->('bps_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1074 $add_throttle_desc->('bps_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1075 $add_throttle_desc->('bps_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1076 $add_throttle_desc->('iops_max_length', 'integer', 'length of I/O bursts', 'seconds', 'seconds', 1);
1077 $add_throttle_desc->('iops_rd_max_length', 'integer', 'length of read I/O bursts', 'seconds', 'seconds', 1);
1078 $add_throttle_desc->('iops_wr_max_length', 'integer', 'length of write I/O bursts', 'seconds', 'seconds', 1);
1081 $drivedesc_base{'bps_rd_length'} = { alias
=> 'bps_rd_max_length' };
1082 $drivedesc_base{'bps_wr_length'} = { alias
=> 'bps_wr_max_length' };
1083 $drivedesc_base{'iops_rd_length'} = { alias
=> 'iops_rd_max_length' };
1084 $drivedesc_base{'iops_wr_length'} = { alias
=> 'iops_wr_max_length' };
1091 PVE
::JSONSchema
::register_format
("pve-qm-ide", $ide_fmt);
1095 type
=> 'string', format
=> $ide_fmt,
1096 description
=> "Use volume as IDE hard disk or CD-ROM (n is 0 to " .($MAX_IDE_DISKS -1) . ").",
1098 PVE
::JSONSchema
::register_standard_option
("pve-qm-ide", $idedesc);
1109 type
=> 'string', format
=> $scsi_fmt,
1110 description
=> "Use volume as SCSI hard disk or CD-ROM (n is 0 to " . ($MAX_SCSI_DISKS - 1) . ").",
1112 PVE
::JSONSchema
::register_standard_option
("pve-qm-scsi", $scsidesc);
1120 type
=> 'string', format
=> $sata_fmt,
1121 description
=> "Use volume as SATA hard disk or CD-ROM (n is 0 to " . ($MAX_SATA_DISKS - 1). ").",
1123 PVE
::JSONSchema
::register_standard_option
("pve-qm-sata", $satadesc);
1131 type
=> 'string', format
=> $virtio_fmt,
1132 description
=> "Use volume as VIRTIO hard disk (n is 0 to " . ($MAX_VIRTIO_DISKS - 1) . ").",
1134 PVE
::JSONSchema
::register_standard_option
("pve-qm-virtio", $virtiodesc);
1136 my $alldrive_fmt = {
1146 volume
=> { alias
=> 'file' },
1149 format
=> 'pve-volume-id-or-qm-path',
1151 format_description
=> 'volume',
1152 description
=> "The drive's backing volume.",
1154 format
=> get_standard_option
('pve-qm-image-format'),
1157 format
=> 'disk-size',
1158 format_description
=> 'DiskSize',
1159 description
=> "Disk size. This is purely informational and has no effect.",
1164 my $efidisk_desc = {
1166 type
=> 'string', format
=> $efidisk_fmt,
1167 description
=> "Configure a Disk for storing EFI vars",
1170 PVE
::JSONSchema
::register_standard_option
("pve-qm-efidisk", $efidisk_desc);
1175 type
=> 'string', format
=> 'pve-qm-usb-device',
1176 format_description
=> 'HOSTUSBDEVICE|spice',
1177 description
=> <<EODESCR,
1178 The Host USB device or port or the value 'spice'. HOSTUSBDEVICE syntax is:
1180 'bus-port(.port)*' (decimal numbers) or
1181 'vendor_id:product_id' (hexadeciaml numbers) or
1184 You can use the 'lsusb -t' command to list existing usb devices.
1186 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1188 The value 'spice' can be used to add a usb redirection devices for spice.
1194 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).",
1201 type
=> 'string', format
=> $usb_fmt,
1202 description
=> "Configure an USB device (n is 0 to 4).",
1204 PVE
::JSONSchema
::register_standard_option
("pve-qm-usb", $usbdesc);
1206 # NOTE: the match-groups of this regex are used in parse_hostpci
1207 my $PCIRE = qr/([a-f0-9]{2}:[a-f0-9]{2})(?:\.([a-f0-9]))?/;
1212 pattern
=> qr/$PCIRE(;$PCIRE)*/,
1213 format_description
=> 'HOSTPCIID[;HOSTPCIID2...]',
1214 description
=> <<EODESCR,
1215 Host PCI device pass through. The PCI ID of a host's PCI device or a list
1216 of PCI virtual functions of the host. HOSTPCIID syntax is:
1218 'bus:dev.func' (hexadecimal numbers)
1220 You can us the 'lspci' command to list existing PCI devices.
1225 description
=> "Specify whether or not the device's ROM will be visible in the guest's memory map.",
1231 pattern
=> '[^,;]+',
1232 format_description
=> 'string',
1233 description
=> "Custom pci device rom filename (must be located in /usr/share/kvm/).",
1238 description
=> "Choose the PCI-express bus (needs the 'q35' machine model).",
1244 description
=> "Enable vfio-vga device support.",
1249 PVE
::JSONSchema
::register_format
('pve-qm-hostpci', $hostpci_fmt);
1253 type
=> 'string', format
=> 'pve-qm-hostpci',
1254 description
=> "Map host PCI devices into guest.",
1255 verbose_description
=> <<EODESCR,
1256 Map host PCI devices into guest.
1258 NOTE: This option allows direct access to host hardware. So it is no longer
1259 possible to migrate such machines - use with special care.
1261 CAUTION: Experimental! User reported problems with this option.
1264 PVE
::JSONSchema
::register_standard_option
("pve-qm-hostpci", $hostpcidesc);
1269 pattern
=> '(/dev/.+|socket)',
1270 description
=> "Create a serial device inside the VM (n is 0 to 3)",
1271 verbose_description
=> <<EODESCR,
1272 Create a serial device inside the VM (n is 0 to 3), and pass through a
1273 host serial device (i.e. /dev/ttyS0), or create a unix socket on the
1274 host side (use 'qm terminal' to open a terminal connection).
1276 NOTE: If you pass through a host serial device, it is no longer possible to migrate such machines - use with special care.
1278 CAUTION: Experimental! User reported problems with this option.
1285 pattern
=> '/dev/parport\d+|/dev/usb/lp\d+',
1286 description
=> "Map host parallel devices (n is 0 to 2).",
1287 verbose_description
=> <<EODESCR,
1288 Map host parallel devices (n is 0 to 2).
1290 NOTE: This option allows direct access to host hardware. So it is no longer possible to migrate such machines - use with special care.
1292 CAUTION: Experimental! User reported problems with this option.
1296 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
1297 $confdesc->{"parallel$i"} = $paralleldesc;
1300 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
1301 $confdesc->{"serial$i"} = $serialdesc;
1304 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
1305 $confdesc->{"hostpci$i"} = $hostpcidesc;
1308 for (my $i = 0; $i < $MAX_IDE_DISKS; $i++) {
1309 $drivename_hash->{"ide$i"} = 1;
1310 $confdesc->{"ide$i"} = $idedesc;
1313 for (my $i = 0; $i < $MAX_SATA_DISKS; $i++) {
1314 $drivename_hash->{"sata$i"} = 1;
1315 $confdesc->{"sata$i"} = $satadesc;
1318 for (my $i = 0; $i < $MAX_SCSI_DISKS; $i++) {
1319 $drivename_hash->{"scsi$i"} = 1;
1320 $confdesc->{"scsi$i"} = $scsidesc ;
1323 for (my $i = 0; $i < $MAX_VIRTIO_DISKS; $i++) {
1324 $drivename_hash->{"virtio$i"} = 1;
1325 $confdesc->{"virtio$i"} = $virtiodesc;
1328 $drivename_hash->{efidisk0
} = 1;
1329 $confdesc->{efidisk0
} = $efidisk_desc;
1331 for (my $i = 0; $i < $MAX_USB_DEVICES; $i++) {
1332 $confdesc->{"usb$i"} = $usbdesc;
1337 type
=> 'string', format
=> 'pve-volume-id',
1338 description
=> "Reference to unused volumes. This is used internally, and should not be modified manually.",
1341 for (my $i = 0; $i < $MAX_UNUSED_DISKS; $i++) {
1342 $confdesc->{"unused$i"} = $unuseddesc;
1345 my $kvm_api_version = 0;
1348 return $kvm_api_version if $kvm_api_version;
1350 open my $fh, '<', '/dev/kvm'
1353 # 0xae00 => KVM_GET_API_VERSION
1354 $kvm_api_version = ioctl($fh, 0xae00, 0);
1356 return $kvm_api_version;
1359 my $kvm_user_version;
1361 sub kvm_user_version
{
1363 return $kvm_user_version if $kvm_user_version;
1365 $kvm_user_version = 'unknown';
1369 if ($line =~ m/^QEMU( PC)? emulator version (\d+\.\d+(\.\d+)?)(\.\d+)?[,\s]/) {
1370 $kvm_user_version = $2;
1374 eval { run_command
("kvm -version", outfunc
=> $code); };
1377 return $kvm_user_version;
1381 my $kernel_has_vhost_net = -c
'/dev/vhost-net';
1383 sub valid_drive_names
{
1384 # order is important - used to autoselect boot disk
1385 return ((map { "ide$_" } (0 .. ($MAX_IDE_DISKS - 1))),
1386 (map { "scsi$_" } (0 .. ($MAX_SCSI_DISKS - 1))),
1387 (map { "virtio$_" } (0 .. ($MAX_VIRTIO_DISKS - 1))),
1388 (map { "sata$_" } (0 .. ($MAX_SATA_DISKS - 1))),
1392 sub is_valid_drivename
{
1395 return defined($drivename_hash->{$dev});
1400 return defined($confdesc->{$key});
1404 return $nic_model_list;
1407 sub os_list_description
{
1411 wxp
=> 'Windows XP',
1412 w2k
=> 'Windows 2000',
1413 w2k3
=>, 'Windows 2003',
1414 w2k8
=> 'Windows 2008',
1415 wvista
=> 'Windows Vista',
1416 win7
=> 'Windows 7',
1417 win8
=> 'Windows 8/2012',
1418 win10
=> 'Windows 10/2016',
1426 sub get_cdrom_path
{
1428 return $cdrom_path if $cdrom_path;
1430 return $cdrom_path = "/dev/cdrom" if -l
"/dev/cdrom";
1431 return $cdrom_path = "/dev/cdrom1" if -l
"/dev/cdrom1";
1432 return $cdrom_path = "/dev/cdrom2" if -l
"/dev/cdrom2";
1436 my ($storecfg, $vmid, $cdrom) = @_;
1438 if ($cdrom eq 'cdrom') {
1439 return get_cdrom_path
();
1440 } elsif ($cdrom eq 'none') {
1442 } elsif ($cdrom =~ m
|^/|) {
1445 return PVE
::Storage
::path
($storecfg, $cdrom);
1449 # try to convert old style file names to volume IDs
1450 sub filename_to_volume_id
{
1451 my ($vmid, $file, $media) = @_;
1453 if (!($file eq 'none' || $file eq 'cdrom' ||
1454 $file =~ m
|^/dev/.+| || $file =~ m/^([^:]+):(.+)$/)) {
1456 return undef if $file =~ m
|/|;
1458 if ($media && $media eq 'cdrom') {
1459 $file = "local:iso/$file";
1461 $file = "local:$vmid/$file";
1468 sub verify_media_type
{
1469 my ($opt, $vtype, $media) = @_;
1474 if ($media eq 'disk') {
1476 } elsif ($media eq 'cdrom') {
1479 die "internal error";
1482 return if ($vtype eq $etype);
1484 raise_param_exc
({ $opt => "unexpected media type ($vtype != $etype)" });
1487 sub cleanup_drive_path
{
1488 my ($opt, $storecfg, $drive) = @_;
1490 # try to convert filesystem paths to volume IDs
1492 if (($drive->{file
} !~ m/^(cdrom|none)$/) &&
1493 ($drive->{file
} !~ m
|^/dev/.+|) &&
1494 ($drive->{file
} !~ m/^([^:]+):(.+)$/) &&
1495 ($drive->{file
} !~ m/^\d+$/)) {
1496 my ($vtype, $volid) = PVE
::Storage
::path_to_volume_id
($storecfg, $drive->{file
});
1497 raise_param_exc
({ $opt => "unable to associate path '$drive->{file}' to any storage"}) if !$vtype;
1498 $drive->{media
} = 'cdrom' if !$drive->{media
} && $vtype eq 'iso';
1499 verify_media_type
($opt, $vtype, $drive->{media
});
1500 $drive->{file
} = $volid;
1503 $drive->{media
} = 'cdrom' if !$drive->{media
} && $drive->{file
} =~ m/^(cdrom|none)$/;
1506 sub parse_hotplug_features
{
1511 return $res if $data eq '0';
1513 $data = $confdesc->{hotplug
}->{default} if $data eq '1';
1515 foreach my $feature (PVE
::Tools
::split_list
($data)) {
1516 if ($feature =~ m/^(network|disk|cpu|memory|usb)$/) {
1519 die "invalid hotplug feature '$feature'\n";
1525 PVE
::JSONSchema
::register_format
('pve-hotplug-features', \
&pve_verify_hotplug_features
);
1526 sub pve_verify_hotplug_features
{
1527 my ($value, $noerr) = @_;
1529 return $value if parse_hotplug_features
($value);
1531 return undef if $noerr;
1533 die "unable to parse hotplug option\n";
1536 # ideX = [volume=]volume-id[,media=d][,cyls=c,heads=h,secs=s[,trans=t]]
1537 # [,snapshot=on|off][,cache=on|off][,format=f][,backup=yes|no]
1538 # [,rerror=ignore|report|stop][,werror=enospc|ignore|report|stop]
1539 # [,aio=native|threads][,discard=ignore|on][,detect_zeroes=on|off]
1540 # [,iothread=on][,serial=serial][,model=model]
1543 my ($key, $data) = @_;
1545 my ($interface, $index);
1547 if ($key =~ m/^([^\d]+)(\d+)$/) {
1554 my $desc = $key =~ /^unused\d+$/ ?
$alldrive_fmt
1555 : $confdesc->{$key}->{format
};
1557 warn "invalid drive key: $key\n";
1560 my $res = eval { PVE
::JSONSchema
::parse_property_string
($desc, $data) };
1561 return undef if !$res;
1562 $res->{interface
} = $interface;
1563 $res->{index} = $index;
1566 foreach my $opt (qw(bps bps_rd bps_wr)) {
1567 if (my $bps = defined(delete $res->{$opt})) {
1568 if (defined($res->{"m$opt"})) {
1569 warn "both $opt and m$opt specified\n";
1573 $res->{"m$opt"} = sprintf("%.3f", $bps / (1024*1024.0));
1577 # can't use the schema's 'requires' because of the mbps* => bps* "transforming aliases"
1578 for my $requirement (
1579 [mbps_max
=> 'mbps'],
1580 [mbps_rd_max
=> 'mbps_rd'],
1581 [mbps_wr_max
=> 'mbps_wr'],
1582 [miops_max
=> 'miops'],
1583 [miops_rd_max
=> 'miops_rd'],
1584 [miops_wr_max
=> 'miops_wr'],
1585 [bps_max_length
=> 'mbps_max'],
1586 [bps_rd_max_length
=> 'mbps_rd_max'],
1587 [bps_wr_max_length
=> 'mbps_wr_max'],
1588 [iops_max_length
=> 'iops_max'],
1589 [iops_rd_max_length
=> 'iops_rd_max'],
1590 [iops_wr_max_length
=> 'iops_wr_max']) {
1591 my ($option, $requires) = @$requirement;
1592 if ($res->{$option} && !$res->{$requires}) {
1593 warn "$option requires $requires\n";
1598 return undef if $error;
1600 return undef if $res->{mbps_rd
} && $res->{mbps
};
1601 return undef if $res->{mbps_wr
} && $res->{mbps
};
1602 return undef if $res->{iops_rd
} && $res->{iops
};
1603 return undef if $res->{iops_wr
} && $res->{iops
};
1605 if ($res->{media
} && ($res->{media
} eq 'cdrom')) {
1606 return undef if $res->{snapshot
} || $res->{trans
} || $res->{format
};
1607 return undef if $res->{heads
} || $res->{secs
} || $res->{cyls
};
1608 return undef if $res->{interface
} eq 'virtio';
1611 if (my $size = $res->{size
}) {
1612 return undef if !defined($res->{size
} = PVE
::JSONSchema
::parse_size
($size));
1619 my ($vmid, $drive) = @_;
1620 my $data = { %$drive };
1621 delete $data->{$_} for qw(index interface);
1622 return PVE
::JSONSchema
::print_property_string
($data, $alldrive_fmt);
1626 my($fh, $noerr) = @_;
1629 my $SG_GET_VERSION_NUM = 0x2282;
1631 my $versionbuf = "\x00" x
8;
1632 my $ret = ioctl($fh, $SG_GET_VERSION_NUM, $versionbuf);
1634 die "scsi ioctl SG_GET_VERSION_NUM failoed - $!\n" if !$noerr;
1637 my $version = unpack("I", $versionbuf);
1638 if ($version < 30000) {
1639 die "scsi generic interface too old\n" if !$noerr;
1643 my $buf = "\x00" x
36;
1644 my $sensebuf = "\x00" x
8;
1645 my $cmd = pack("C x3 C x1", 0x12, 36);
1647 # see /usr/include/scsi/sg.h
1648 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";
1650 my $packet = pack($sg_io_hdr_t, ord('S'), -3, length($cmd),
1651 length($sensebuf), 0, length($buf), $buf,
1652 $cmd, $sensebuf, 6000);
1654 $ret = ioctl($fh, $SG_IO, $packet);
1656 die "scsi ioctl SG_IO failed - $!\n" if !$noerr;
1660 my @res = unpack($sg_io_hdr_t, $packet);
1661 if ($res[17] || $res[18]) {
1662 die "scsi ioctl SG_IO status error - $!\n" if !$noerr;
1667 (my $byte0, my $byte1, $res->{vendor
},
1668 $res->{product
}, $res->{revision
}) = unpack("C C x6 A8 A16 A4", $buf);
1670 $res->{removable
} = $byte1 & 128 ?
1 : 0;
1671 $res->{type
} = $byte0 & 31;
1679 my $fh = IO
::File-
>new("+<$path") || return undef;
1680 my $res = scsi_inquiry
($fh, 1);
1686 sub machine_type_is_q35
{
1689 return $conf->{machine
} && ($conf->{machine
} =~ m/q35/) ?
1 : 0;
1692 sub print_tabletdevice_full
{
1693 my ($conf, $arch) = @_;
1695 my $q35 = machine_type_is_q35
($conf);
1697 # we use uhci for old VMs because tablet driver was buggy in older qemu
1699 if (machine_type_is_q35
($conf) || $arch eq 'aarch64') {
1705 return "usb-tablet,id=tablet,bus=$usbbus.0,port=1";
1708 sub print_keyboarddevice_full
{
1709 my ($conf, $arch, $machine) = @_;
1711 return undef if $arch ne 'aarch64';
1713 return "usb-kbd,id=keyboard,bus=ehci.0,port=2";
1716 sub print_drivedevice_full
{
1717 my ($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type) = @_;
1722 if ($drive->{interface
} eq 'virtio') {
1723 my $pciaddr = print_pci_addr
("$drive->{interface}$drive->{index}", $bridges, $arch, $machine_type);
1724 $device = "virtio-blk-pci,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}$pciaddr";
1725 $device .= ",iothread=iothread-$drive->{interface}$drive->{index}" if $drive->{iothread
};
1726 } elsif ($drive->{interface
} eq 'scsi') {
1728 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
1729 my $unit = $drive->{index} % $maxdev;
1730 my $devicetype = 'hd';
1732 if (drive_is_cdrom
($drive)) {
1735 if ($drive->{file
} =~ m
|^/|) {
1736 $path = $drive->{file
};
1737 if (my $info = path_is_scsi
($path)) {
1738 if ($info->{type
} == 0 && $drive->{scsiblock
}) {
1739 $devicetype = 'block';
1740 } elsif ($info->{type
} == 1) { # tape
1741 $devicetype = 'generic';
1745 $path = PVE
::Storage
::path
($storecfg, $drive->{file
});
1748 if($path =~ m/^iscsi\:\/\
//){
1749 $devicetype = 'generic';
1753 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)){
1754 $device = "scsi-$devicetype,bus=$controller_prefix$controller.0,scsi-id=$unit,drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1756 $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}";
1759 if ($drive->{ssd
} && ($devicetype eq 'block' || $devicetype eq 'hd')) {
1760 $device .= ",rotation_rate=1";
1763 } elsif ($drive->{interface
} eq 'ide' || $drive->{interface
} eq 'sata') {
1764 my $maxdev = ($drive->{interface
} eq 'sata') ?
$MAX_SATA_DISKS : 2;
1765 my $controller = int($drive->{index} / $maxdev);
1766 my $unit = $drive->{index} % $maxdev;
1767 my $devicetype = ($drive->{media
} && $drive->{media
} eq 'cdrom') ?
"cd" : "hd";
1769 $device = "ide-$devicetype";
1770 if ($drive->{interface
} eq 'ide') {
1771 $device .= ",bus=ide.$controller,unit=$unit";
1773 $device .= ",bus=ahci$controller.$unit";
1775 $device .= ",drive=drive-$drive->{interface}$drive->{index},id=$drive->{interface}$drive->{index}";
1777 if ($devicetype eq 'hd') {
1778 if (my $model = $drive->{model
}) {
1779 $model = URI
::Escape
::uri_unescape
($model);
1780 $device .= ",model=$model";
1782 if ($drive->{ssd
}) {
1783 $device .= ",rotation_rate=1";
1786 } elsif ($drive->{interface
} eq 'usb') {
1788 # -device ide-drive,bus=ide.1,unit=0,drive=drive-ide0-1-0,id=ide0-1-0
1790 die "unsupported interface type";
1793 $device .= ",bootindex=$drive->{bootindex}" if $drive->{bootindex
};
1795 if (my $serial = $drive->{serial
}) {
1796 $serial = URI
::Escape
::uri_unescape
($serial);
1797 $device .= ",serial=$serial";
1804 sub get_initiator_name
{
1807 my $fh = IO
::File-
>new('/etc/iscsi/initiatorname.iscsi') || return undef;
1808 while (defined(my $line = <$fh>)) {
1809 next if $line !~ m/^\s*InitiatorName\s*=\s*([\.\-:\w]+)/;
1818 sub print_drive_full
{
1819 my ($storecfg, $vmid, $drive) = @_;
1822 my $volid = $drive->{file
};
1825 if (drive_is_cdrom
($drive)) {
1826 $path = get_iso_path
($storecfg, $vmid, $volid);
1828 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
1830 $path = PVE
::Storage
::path
($storecfg, $volid);
1831 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
1832 $format = qemu_img_format
($scfg, $volname);
1840 my @qemu_drive_options = qw(heads secs cyls trans media format cache rerror werror aio discard);
1841 foreach my $o (@qemu_drive_options) {
1842 $opts .= ",$o=$drive->{$o}" if defined($drive->{$o});
1845 # snapshot only accepts on|off
1846 if (defined($drive->{snapshot
})) {
1847 my $v = $drive->{snapshot
} ?
'on' : 'off';
1848 $opts .= ",snapshot=$v";
1851 foreach my $type (['', '-total'], [_rd
=> '-read'], [_wr
=> '-write']) {
1852 my ($dir, $qmpname) = @$type;
1853 if (my $v = $drive->{"mbps$dir"}) {
1854 $opts .= ",throttling.bps$qmpname=".int($v*1024*1024);
1856 if (my $v = $drive->{"mbps${dir}_max"}) {
1857 $opts .= ",throttling.bps$qmpname-max=".int($v*1024*1024);
1859 if (my $v = $drive->{"bps${dir}_max_length"}) {
1860 $opts .= ",throttling.bps$qmpname-max-length=$v";
1862 if (my $v = $drive->{"iops${dir}"}) {
1863 $opts .= ",throttling.iops$qmpname=$v";
1865 if (my $v = $drive->{"iops${dir}_max"}) {
1866 $opts .= ",throttling.iops$qmpname-max=$v";
1868 if (my $v = $drive->{"iops${dir}_max_length"}) {
1869 $opts .= ",throttling.iops$qmpname-max-length=$v";
1873 $opts .= ",format=$format" if $format && !$drive->{format
};
1875 my $cache_direct = 0;
1877 if (my $cache = $drive->{cache
}) {
1878 $cache_direct = $cache =~ /^(?:off|none|directsync)$/;
1879 } elsif (!drive_is_cdrom
($drive)) {
1880 $opts .= ",cache=none";
1884 # aio native works only with O_DIRECT
1885 if (!$drive->{aio
}) {
1887 $opts .= ",aio=native";
1889 $opts .= ",aio=threads";
1893 if (!drive_is_cdrom
($drive)) {
1895 if (defined($drive->{detect_zeroes
}) && !$drive->{detect_zeroes
}) {
1896 $detectzeroes = 'off';
1897 } elsif ($drive->{discard
}) {
1898 $detectzeroes = $drive->{discard
} eq 'on' ?
'unmap' : 'on';
1900 # This used to be our default with discard not being specified:
1901 $detectzeroes = 'on';
1903 $opts .= ",detect-zeroes=$detectzeroes" if $detectzeroes;
1906 my $pathinfo = $path ?
"file=$path," : '';
1908 return "${pathinfo}if=none,id=drive-$drive->{interface}$drive->{index}$opts";
1911 sub print_netdevice_full
{
1912 my ($vmid, $conf, $net, $netid, $bridges, $use_old_bios_files, $arch, $machine_type) = @_;
1914 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
1916 my $device = $net->{model
};
1917 if ($net->{model
} eq 'virtio') {
1918 $device = 'virtio-net-pci';
1921 my $pciaddr = print_pci_addr
("$netid", $bridges, $arch, $machine_type);
1922 my $tmpstr = "$device,mac=$net->{macaddr},netdev=$netid$pciaddr,id=$netid";
1923 if ($net->{queues
} && $net->{queues
} > 1 && $net->{model
} eq 'virtio'){
1924 #Consider we have N queues, the number of vectors needed is 2*N + 2 (plus one config interrupt and control vq)
1925 my $vectors = $net->{queues
} * 2 + 2;
1926 $tmpstr .= ",vectors=$vectors,mq=on";
1928 $tmpstr .= ",bootindex=$net->{bootindex}" if $net->{bootindex
} ;
1930 if ($use_old_bios_files) {
1932 if ($device eq 'virtio-net-pci') {
1933 $romfile = 'pxe-virtio.rom';
1934 } elsif ($device eq 'e1000') {
1935 $romfile = 'pxe-e1000.rom';
1936 } elsif ($device eq 'ne2k') {
1937 $romfile = 'pxe-ne2k_pci.rom';
1938 } elsif ($device eq 'pcnet') {
1939 $romfile = 'pxe-pcnet.rom';
1940 } elsif ($device eq 'rtl8139') {
1941 $romfile = 'pxe-rtl8139.rom';
1943 $tmpstr .= ",romfile=$romfile" if $romfile;
1949 sub print_netdev_full
{
1950 my ($vmid, $conf, $arch, $net, $netid, $hotplug) = @_;
1953 if ($netid =~ m/^net(\d+)$/) {
1957 die "got strange net id '$i'\n" if $i >= ${MAX_NETS
};
1959 my $ifname = "tap${vmid}i$i";
1961 # kvm uses TUNSETIFF ioctl, and that limits ifname length
1962 die "interface name '$ifname' is too long (max 15 character)\n"
1963 if length($ifname) >= 16;
1965 my $vhostparam = '';
1966 if (is_native
($arch)) {
1967 $vhostparam = ',vhost=on' if $kernel_has_vhost_net && $net->{model
} eq 'virtio';
1970 my $vmname = $conf->{name
} || "vm$vmid";
1973 my $script = $hotplug ?
"pve-bridge-hotplug" : "pve-bridge";
1975 if ($net->{bridge
}) {
1976 $netdev = "type=tap,id=$netid,ifname=${ifname},script=/var/lib/qemu-server/$script,downscript=/var/lib/qemu-server/pve-bridgedown$vhostparam";
1978 $netdev = "type=user,id=$netid,hostname=$vmname";
1981 $netdev .= ",queues=$net->{queues}" if ($net->{queues
} && $net->{model
} eq 'virtio');
1987 sub print_cpu_device
{
1988 my ($conf, $id) = @_;
1990 my $kvm = $conf->{kvm
} // 1;
1991 my $cpu = $kvm ?
"kvm64" : "qemu64";
1992 if (my $cputype = $conf->{cpu
}) {
1993 my $cpuconf = PVE
::JSONSchema
::parse_property_string
($cpu_fmt, $cputype)
1994 or die "Cannot parse cpu description: $cputype\n";
1995 $cpu = $cpuconf->{cputype
};
1998 my $cores = $conf->{cores
} || 1;
2000 my $current_core = ($id - 1) % $cores;
2001 my $current_socket = int(($id - 1 - $current_core)/$cores);
2003 return "$cpu-x86_64-cpu,id=cpu$id,socket-id=$current_socket,core-id=$current_core,thread-id=0";
2007 'cirrus' => 'cirrus-vga',
2009 'vmware' => 'vmware-svga',
2010 'virtio' => 'virtio-vga',
2013 sub print_vga_device
{
2014 my ($conf, $vga, $arch, $machine, $id, $qxlnum, $bridges) = @_;
2016 my $type = $vga_map->{$vga->{type
}};
2017 if ($type eq 'virtio-vga' && $arch eq 'aarch64') {
2018 $type = 'virtio-gpu';
2020 my $vgamem_mb = $vga->{memory
};
2022 $type = $id ?
'qxl' : 'qxl-vga';
2024 die "no devicetype for $vga->{type}\n" if !$type;
2028 if ($vga->{type
} eq 'virtio') {
2029 my $bytes = PVE
::Tools
::convert_size
($vgamem_mb, "mb" => "b");
2030 $memory = ",max_hostmem=$bytes";
2032 # from https://www.spice-space.org/multiple-monitors.html
2033 $memory = ",vgamem_mb=$vga->{memory}";
2034 my $ram = $vgamem_mb * 4;
2035 my $vram = $vgamem_mb * 2;
2036 $memory .= ",ram_size_mb=$ram,vram_size_mb=$vram";
2038 $memory = ",vgamem_mb=$vga->{memory}";
2040 } elsif ($qxlnum && $id) {
2041 $memory = ",ram_size=67108864,vram_size=33554432";
2044 my $q35 = machine_type_is_q35
($conf);
2045 my $vgaid = "vga" . ($id // '');
2048 if ($q35 && $vgaid eq 'vga') {
2049 # the first display uses pcie.0 bus on q35 machines
2050 $pciaddr = print_pcie_addr
($vgaid, $bridges, $arch, $machine);
2052 $pciaddr = print_pci_addr
($vgaid, $bridges, $arch, $machine);
2055 return "$type,id=${vgaid}${memory}${pciaddr}";
2058 sub drive_is_cloudinit
{
2060 return $drive->{file
} =~ m
@[:/]vm-\d
+-cloudinit
(?
:\
.$QEMU_FORMAT_RE)?
$@;
2063 sub drive_is_cdrom
{
2064 my ($drive, $exclude_cloudinit) = @_;
2066 return 0 if $exclude_cloudinit && drive_is_cloudinit
($drive);
2068 return $drive && $drive->{media
} && ($drive->{media
} eq 'cdrom');
2072 sub parse_number_sets
{
2075 foreach my $part (split(/;/, $set)) {
2076 if ($part =~ /^\s*(\d+)(?:-(\d+))?\s*$/) {
2077 die "invalid range: $part ($2 < $1)\n" if defined($2) && $2 < $1;
2078 push @$res, [ $1, $2 ];
2080 die "invalid range: $part\n";
2089 my $res = PVE
::JSONSchema
::parse_property_string
($numa_fmt, $data);
2090 $res->{cpus
} = parse_number_sets
($res->{cpus
}) if defined($res->{cpus
});
2091 $res->{hostnodes
} = parse_number_sets
($res->{hostnodes
}) if defined($res->{hostnodes
});
2098 return undef if !$value;
2100 my $res = PVE
::JSONSchema
::parse_property_string
($hostpci_fmt, $value);
2102 my @idlist = split(/;/, $res->{host
});
2103 delete $res->{host
};
2104 foreach my $id (@idlist) {
2105 if ($id =~ /^$PCIRE$/) {
2107 push @{$res->{pciid
}}, { id
=> $1, function
=> $2 };
2109 my $pcidevices = lspci
($1);
2110 $res->{pciid
} = $pcidevices->{$1};
2113 # should have been caught by parse_property_string already
2114 die "failed to parse PCI id: $id\n";
2120 # netX: e1000=XX:XX:XX:XX:XX:XX,bridge=vmbr0,rate=<mbps>
2124 my $res = eval { PVE
::JSONSchema
::parse_property_string
($net_fmt, $data) };
2129 if (!defined($res->{macaddr
})) {
2130 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
2131 $res->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
});
2136 # ipconfigX ip=cidr,gw=ip,ip6=cidr,gw6=ip
2137 sub parse_ipconfig
{
2140 my $res = eval { PVE
::JSONSchema
::parse_property_string
($ipconfig_fmt, $data) };
2146 if ($res->{gw
} && !$res->{ip
}) {
2147 warn 'gateway specified without specifying an IP address';
2150 if ($res->{gw6
} && !$res->{ip6
}) {
2151 warn 'IPv6 gateway specified without specifying an IPv6 address';
2154 if ($res->{gw
} && $res->{ip
} eq 'dhcp') {
2155 warn 'gateway specified together with DHCP';
2158 if ($res->{gw6
} && $res->{ip6
} !~ /^$IPV6RE/) {
2160 warn "IPv6 gateway specified together with $res->{ip6} address";
2164 if (!$res->{ip
} && !$res->{ip6
}) {
2165 return { ip
=> 'dhcp', ip6
=> 'dhcp' };
2174 return PVE
::JSONSchema
::print_property_string
($net, $net_fmt);
2177 sub add_random_macs
{
2178 my ($settings) = @_;
2180 foreach my $opt (keys %$settings) {
2181 next if $opt !~ m/^net(\d+)$/;
2182 my $net = parse_net
($settings->{$opt});
2184 $settings->{$opt} = print_net
($net);
2188 sub vm_is_volid_owner
{
2189 my ($storecfg, $vmid, $volid) = @_;
2191 if ($volid !~ m
|^/|) {
2193 eval { ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid); };
2194 if ($owner && ($owner == $vmid)) {
2202 sub split_flagged_list
{
2203 my $text = shift || '';
2204 $text =~ s/[,;]/ /g;
2206 return { map { /^(!?)(.*)$/ && ($2, $1) } ($text =~ /\S+/g) };
2209 sub join_flagged_list
{
2210 my ($how, $lst) = @_;
2211 join $how, map { $lst->{$_} . $_ } keys %$lst;
2214 sub vmconfig_delete_pending_option
{
2215 my ($conf, $key, $force) = @_;
2217 delete $conf->{pending
}->{$key};
2218 my $pending_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2219 $pending_delete_hash->{$key} = $force ?
'!' : '';
2220 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2223 sub vmconfig_undelete_pending_option
{
2224 my ($conf, $key) = @_;
2226 my $pending_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2227 delete $pending_delete_hash->{$key};
2229 if (%$pending_delete_hash) {
2230 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2232 delete $conf->{pending
}->{delete};
2236 sub vmconfig_register_unused_drive
{
2237 my ($storecfg, $vmid, $conf, $drive) = @_;
2239 if (drive_is_cloudinit
($drive)) {
2240 eval { PVE
::Storage
::vdisk_free
($storecfg, $drive->{file
}) };
2242 } elsif (!drive_is_cdrom
($drive)) {
2243 my $volid = $drive->{file
};
2244 if (vm_is_volid_owner
($storecfg, $vmid, $volid)) {
2245 PVE
::QemuConfig-
>add_unused_volume($conf, $volid, $vmid);
2250 sub vmconfig_cleanup_pending
{
2253 # remove pending changes when nothing changed
2255 foreach my $opt (keys %{$conf->{pending
}}) {
2256 if (defined($conf->{$opt}) && ($conf->{pending
}->{$opt} eq $conf->{$opt})) {
2258 delete $conf->{pending
}->{$opt};
2262 my $current_delete_hash = split_flagged_list
($conf->{pending
}->{delete});
2263 my $pending_delete_hash = {};
2264 while (my ($opt, $force) = each %$current_delete_hash) {
2265 if (defined($conf->{$opt})) {
2266 $pending_delete_hash->{$opt} = $force;
2272 if (%$pending_delete_hash) {
2273 $conf->{pending
}->{delete} = join_flagged_list
(',', $pending_delete_hash);
2275 delete $conf->{pending
}->{delete};
2281 # smbios: [manufacturer=str][,product=str][,version=str][,serial=str][,uuid=uuid][,sku=str][,family=str]
2285 pattern
=> '[a-fA-F0-9]{8}(?:-[a-fA-F0-9]{4}){3}-[a-fA-F0-9]{12}',
2286 format_description
=> 'UUID',
2287 description
=> "Set SMBIOS1 UUID.",
2293 format_description
=> 'string',
2294 description
=> "Set SMBIOS1 version.",
2300 format_description
=> 'string',
2301 description
=> "Set SMBIOS1 serial number.",
2307 format_description
=> 'string',
2308 description
=> "Set SMBIOS1 manufacturer.",
2314 format_description
=> 'string',
2315 description
=> "Set SMBIOS1 product ID.",
2321 format_description
=> 'string',
2322 description
=> "Set SMBIOS1 SKU string.",
2328 format_description
=> 'string',
2329 description
=> "Set SMBIOS1 family string.",
2337 my $res = eval { PVE
::JSONSchema
::parse_property_string
($smbios1_fmt, $data) };
2344 return PVE
::JSONSchema
::print_property_string
($smbios1, $smbios1_fmt);
2347 PVE
::JSONSchema
::register_format
('pve-qm-smbios1', $smbios1_fmt);
2349 PVE
::JSONSchema
::register_format
('pve-qm-bootdisk', \
&verify_bootdisk
);
2350 sub verify_bootdisk
{
2351 my ($value, $noerr) = @_;
2353 return $value if is_valid_drivename
($value);
2355 return undef if $noerr;
2357 die "invalid boot disk '$value'\n";
2360 sub parse_watchdog
{
2363 return undef if !$value;
2365 my $res = eval { PVE
::JSONSchema
::parse_property_string
($watchdog_fmt, $value) };
2370 sub parse_guest_agent
{
2373 return {} if !defined($value->{agent
});
2375 my $res = eval { PVE
::JSONSchema
::parse_property_string
($agent_fmt, $value->{agent
}) };
2378 # if the agent is disabled ignore the other potentially set properties
2379 return {} if !$res->{enabled
};
2386 return {} if !$value;
2387 my $res = eval { PVE
::JSONSchema
::parse_property_string
($vga_fmt, $value) };
2392 PVE
::JSONSchema
::register_format
('pve-qm-usb-device', \
&verify_usb_device
);
2393 sub verify_usb_device
{
2394 my ($value, $noerr) = @_;
2396 return $value if parse_usb_device
($value);
2398 return undef if $noerr;
2400 die "unable to parse usb device\n";
2403 # add JSON properties for create and set function
2404 sub json_config_properties
{
2407 foreach my $opt (keys %$confdesc) {
2408 next if $opt eq 'parent' || $opt eq 'snaptime' || $opt eq 'vmstate' || $opt eq 'runningmachine';
2409 $prop->{$opt} = $confdesc->{$opt};
2415 # return copy of $confdesc_cloudinit to generate documentation
2416 sub cloudinit_config_properties
{
2418 return dclone
($confdesc_cloudinit);
2422 my ($key, $value) = @_;
2424 die "unknown setting '$key'\n" if !$confdesc->{$key};
2426 my $type = $confdesc->{$key}->{type
};
2428 if (!defined($value)) {
2429 die "got undefined value\n";
2432 if ($value =~ m/[\n\r]/) {
2433 die "property contains a line feed\n";
2436 if ($type eq 'boolean') {
2437 return 1 if ($value eq '1') || ($value =~ m/^(on|yes|true)$/i);
2438 return 0 if ($value eq '0') || ($value =~ m/^(off|no|false)$/i);
2439 die "type check ('boolean') failed - got '$value'\n";
2440 } elsif ($type eq 'integer') {
2441 return int($1) if $value =~ m/^(\d+)$/;
2442 die "type check ('integer') failed - got '$value'\n";
2443 } elsif ($type eq 'number') {
2444 return $value if $value =~ m/^(\d+)(\.\d+)?$/;
2445 die "type check ('number') failed - got '$value'\n";
2446 } elsif ($type eq 'string') {
2447 if (my $fmt = $confdesc->{$key}->{format
}) {
2448 PVE
::JSONSchema
::check_format
($fmt, $value);
2451 $value =~ s/^\"(.*)\"$/$1/;
2454 die "internal error"
2458 sub check_iommu_support
{
2459 #fixme : need to check IOMMU support
2460 #http://www.linux-kvm.org/page/How_to_assign_devices_with_VT-d_in_KVM
2470 my $conf = PVE
::QemuConfig-
>config_file($vmid);
2471 utime undef, undef, $conf;
2475 my ($storecfg, $vmid, $keep_empty_config, $skiplock) = @_;
2477 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
2479 my $conf = PVE
::QemuConfig-
>load_config($vmid);
2481 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
2483 if ($conf->{template
}) {
2484 # check if any base image is still used by a linked clone
2485 foreach_drive
($conf, sub {
2486 my ($ds, $drive) = @_;
2488 return if drive_is_cdrom
($drive);
2490 my $volid = $drive->{file
};
2492 return if !$volid || $volid =~ m
|^/|;
2494 die "base volume '$volid' is still in use by linked cloned\n"
2495 if PVE
::Storage
::volume_is_base_and_used
($storecfg, $volid);
2500 # only remove disks owned by this VM
2501 foreach_drive
($conf, sub {
2502 my ($ds, $drive) = @_;
2504 return if drive_is_cdrom
($drive, 1);
2506 my $volid = $drive->{file
};
2508 return if !$volid || $volid =~ m
|^/|;
2510 my ($path, $owner) = PVE
::Storage
::path
($storecfg, $volid);
2511 return if !$path || !$owner || ($owner != $vmid);
2514 PVE
::Storage
::vdisk_free
($storecfg, $volid);
2516 warn "Could not remove disk '$volid', check manually: $@" if $@;
2520 if ($keep_empty_config) {
2521 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
2526 # also remove unused disk
2528 my $dl = PVE
::Storage
::vdisk_list
($storecfg, undef, $vmid);
2531 PVE
::Storage
::foreach_volid
($dl, sub {
2532 my ($volid, $sid, $volname, $d) = @_;
2533 PVE
::Storage
::vdisk_free
($storecfg, $volid);
2542 sub parse_vm_config
{
2543 my ($filename, $raw) = @_;
2545 return undef if !defined($raw);
2548 digest
=> Digest
::SHA
::sha1_hex
($raw),
2553 $filename =~ m
|/qemu-server/(\d
+)\
.conf
$|
2554 || die "got strange filename '$filename'";
2562 my @lines = split(/\n/, $raw);
2563 foreach my $line (@lines) {
2564 next if $line =~ m/^\s*$/;
2566 if ($line =~ m/^\[PENDING\]\s*$/i) {
2567 $section = 'pending';
2568 if (defined($descr)) {
2570 $conf->{description
} = $descr;
2573 $conf = $res->{$section} = {};
2576 } elsif ($line =~ m/^\[([a-z][a-z0-9_\-]+)\]\s*$/i) {
2578 if (defined($descr)) {
2580 $conf->{description
} = $descr;
2583 $conf = $res->{snapshots
}->{$section} = {};
2587 if ($line =~ m/^\#(.*)\s*$/) {
2588 $descr = '' if !defined($descr);
2589 $descr .= PVE
::Tools
::decode_text
($1) . "\n";
2593 if ($line =~ m/^(description):\s*(.*\S)\s*$/) {
2594 $descr = '' if !defined($descr);
2595 $descr .= PVE
::Tools
::decode_text
($2);
2596 } elsif ($line =~ m/snapstate:\s*(prepare|delete)\s*$/) {
2597 $conf->{snapstate
} = $1;
2598 } elsif ($line =~ m/^(args):\s*(.*\S)\s*$/) {
2601 $conf->{$key} = $value;
2602 } elsif ($line =~ m/^delete:\s*(.*\S)\s*$/) {
2604 if ($section eq 'pending') {
2605 $conf->{delete} = $value; # we parse this later
2607 warn "vm $vmid - propertry 'delete' is only allowed in [PENDING]\n";
2609 } elsif ($line =~ m/^([a-z][a-z_]*\d*):\s*(.+?)\s*$/) {
2612 eval { $value = check_type
($key, $value); };
2614 warn "vm $vmid - unable to parse value of '$key' - $@";
2616 $key = 'ide2' if $key eq 'cdrom';
2617 my $fmt = $confdesc->{$key}->{format
};
2618 if ($fmt && $fmt =~ /^pve-qm-(?:ide|scsi|virtio|sata)$/) {
2619 my $v = parse_drive
($key, $value);
2620 if (my $volid = filename_to_volume_id
($vmid, $v->{file
}, $v->{media
})) {
2621 $v->{file
} = $volid;
2622 $value = print_drive
($vmid, $v);
2624 warn "vm $vmid - unable to parse value of '$key'\n";
2629 $conf->{$key} = $value;
2634 if (defined($descr)) {
2636 $conf->{description
} = $descr;
2638 delete $res->{snapstate
}; # just to be sure
2643 sub write_vm_config
{
2644 my ($filename, $conf) = @_;
2646 delete $conf->{snapstate
}; # just to be sure
2648 if ($conf->{cdrom
}) {
2649 die "option ide2 conflicts with cdrom\n" if $conf->{ide2
};
2650 $conf->{ide2
} = $conf->{cdrom
};
2651 delete $conf->{cdrom
};
2654 # we do not use 'smp' any longer
2655 if ($conf->{sockets
}) {
2656 delete $conf->{smp
};
2657 } elsif ($conf->{smp
}) {
2658 $conf->{sockets
} = $conf->{smp
};
2659 delete $conf->{cores
};
2660 delete $conf->{smp
};
2663 my $used_volids = {};
2665 my $cleanup_config = sub {
2666 my ($cref, $pending, $snapname) = @_;
2668 foreach my $key (keys %$cref) {
2669 next if $key eq 'digest' || $key eq 'description' || $key eq 'snapshots' ||
2670 $key eq 'snapstate' || $key eq 'pending';
2671 my $value = $cref->{$key};
2672 if ($key eq 'delete') {
2673 die "propertry 'delete' is only allowed in [PENDING]\n"
2675 # fixme: check syntax?
2678 eval { $value = check_type
($key, $value); };
2679 die "unable to parse value of '$key' - $@" if $@;
2681 $cref->{$key} = $value;
2683 if (!$snapname && is_valid_drivename
($key)) {
2684 my $drive = parse_drive
($key, $value);
2685 $used_volids->{$drive->{file
}} = 1 if $drive && $drive->{file
};
2690 &$cleanup_config($conf);
2692 &$cleanup_config($conf->{pending
}, 1);
2694 foreach my $snapname (keys %{$conf->{snapshots
}}) {
2695 die "internal error" if $snapname eq 'pending';
2696 &$cleanup_config($conf->{snapshots
}->{$snapname}, undef, $snapname);
2699 # remove 'unusedX' settings if we re-add a volume
2700 foreach my $key (keys %$conf) {
2701 my $value = $conf->{$key};
2702 if ($key =~ m/^unused/ && $used_volids->{$value}) {
2703 delete $conf->{$key};
2707 my $generate_raw_config = sub {
2708 my ($conf, $pending) = @_;
2712 # add description as comment to top of file
2713 if (defined(my $descr = $conf->{description
})) {
2715 foreach my $cl (split(/\n/, $descr)) {
2716 $raw .= '#' . PVE
::Tools
::encode_text
($cl) . "\n";
2719 $raw .= "#\n" if $pending;
2723 foreach my $key (sort keys %$conf) {
2724 next if $key eq 'digest' || $key eq 'description' || $key eq 'pending' || $key eq 'snapshots';
2725 $raw .= "$key: $conf->{$key}\n";
2730 my $raw = &$generate_raw_config($conf);
2732 if (scalar(keys %{$conf->{pending
}})){
2733 $raw .= "\n[PENDING]\n";
2734 $raw .= &$generate_raw_config($conf->{pending
}, 1);
2737 foreach my $snapname (sort keys %{$conf->{snapshots
}}) {
2738 $raw .= "\n[$snapname]\n";
2739 $raw .= &$generate_raw_config($conf->{snapshots
}->{$snapname});
2749 # we use static defaults from our JSON schema configuration
2750 foreach my $key (keys %$confdesc) {
2751 if (defined(my $default = $confdesc->{$key}->{default})) {
2752 $res->{$key} = $default;
2760 my $vmlist = PVE
::Cluster
::get_vmlist
();
2762 return $res if !$vmlist || !$vmlist->{ids
};
2763 my $ids = $vmlist->{ids
};
2765 foreach my $vmid (keys %$ids) {
2766 my $d = $ids->{$vmid};
2767 next if !$d->{node
} || $d->{node
} ne $nodename;
2768 next if !$d->{type
} || $d->{type
} ne 'qemu';
2769 $res->{$vmid}->{exists} = 1;
2774 # test if VM uses local resources (to prevent migration)
2775 sub check_local_resources
{
2776 my ($conf, $noerr) = @_;
2780 $loc_res = 1 if $conf->{hostusb
}; # old syntax
2781 $loc_res = 1 if $conf->{hostpci
}; # old syntax
2783 foreach my $k (keys %$conf) {
2784 next if $k =~ m/^usb/ && ($conf->{$k} eq 'spice');
2785 # sockets are safe: they will recreated be on the target side post-migrate
2786 next if $k =~ m/^serial/ && ($conf->{$k} eq 'socket');
2787 $loc_res = 1 if $k =~ m/^(usb|hostpci|serial|parallel)\d+$/;
2790 die "VM uses local resources\n" if $loc_res && !$noerr;
2795 # check if used storages are available on all nodes (use by migrate)
2796 sub check_storage_availability
{
2797 my ($storecfg, $conf, $node) = @_;
2799 foreach_drive
($conf, sub {
2800 my ($ds, $drive) = @_;
2802 my $volid = $drive->{file
};
2805 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2808 # check if storage is available on both nodes
2809 my $scfg = PVE
::Storage
::storage_check_node
($storecfg, $sid);
2810 PVE
::Storage
::storage_check_node
($storecfg, $sid, $node);
2814 # list nodes where all VM images are available (used by has_feature API)
2816 my ($conf, $storecfg) = @_;
2818 my $nodelist = PVE
::Cluster
::get_nodelist
();
2819 my $nodehash = { map { $_ => 1 } @$nodelist };
2820 my $nodename = PVE
::INotify
::nodename
();
2822 foreach_drive
($conf, sub {
2823 my ($ds, $drive) = @_;
2825 my $volid = $drive->{file
};
2828 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2830 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
2831 if ($scfg->{disable
}) {
2833 } elsif (my $avail = $scfg->{nodes
}) {
2834 foreach my $node (keys %$nodehash) {
2835 delete $nodehash->{$node} if !$avail->{$node};
2837 } elsif (!$scfg->{shared
}) {
2838 foreach my $node (keys %$nodehash) {
2839 delete $nodehash->{$node} if $node ne $nodename
2849 my ($pidfile, $pid) = @_;
2851 my $fh = IO
::File-
>new("/proc/$pid/cmdline", "r");
2855 return undef if !$line;
2856 my @param = split(/\0/, $line);
2858 my $cmd = $param[0];
2859 return if !$cmd || ($cmd !~ m
|kvm
$| && $cmd !~ m
@(?
:^|/)qemu-system-[^/]+$@);
2861 for (my $i = 0; $i < scalar (@param); $i++) {
2864 if (($p eq '-pidfile') || ($p eq '--pidfile')) {
2865 my $p = $param[$i+1];
2866 return 1 if $p && ($p eq $pidfile);
2875 my ($vmid, $nocheck, $node) = @_;
2877 my $filename = PVE
::QemuConfig-
>config_file($vmid, $node);
2879 die "unable to find configuration file for VM $vmid - no such machine\n"
2880 if !$nocheck && ! -f
$filename;
2882 my $pidfile = pidfile_name
($vmid);
2884 if (my $fd = IO
::File-
>new("<$pidfile")) {
2889 my $mtime = $st->mtime;
2890 if ($mtime > time()) {
2891 warn "file '$filename' modified in future\n";
2894 if ($line =~ m/^(\d+)$/) {
2896 if (check_cmdline
($pidfile, $pid)) {
2897 if (my $pinfo = PVE
::ProcFSTools
::check_process_running
($pid)) {
2909 my $vzlist = config_list
();
2911 my $fd = IO
::Dir-
>new($var_run_tmpdir) || return $vzlist;
2913 while (defined(my $de = $fd->read)) {
2914 next if $de !~ m/^(\d+)\.pid$/;
2916 next if !defined($vzlist->{$vmid});
2917 if (my $pid = check_running
($vmid)) {
2918 $vzlist->{$vmid}->{pid
} = $pid;
2926 my ($storecfg, $conf) = @_;
2928 my $bootdisk = $conf->{bootdisk
};
2929 return undef if !$bootdisk;
2930 return undef if !is_valid_drivename
($bootdisk);
2932 return undef if !$conf->{$bootdisk};
2934 my $drive = parse_drive
($bootdisk, $conf->{$bootdisk});
2935 return undef if !defined($drive);
2937 return undef if drive_is_cdrom
($drive);
2939 my $volid = $drive->{file
};
2940 return undef if !$volid;
2942 return $drive->{size
};
2945 our $vmstatus_return_properties = {
2946 vmid
=> get_standard_option
('pve-vmid'),
2948 description
=> "Qemu process status.",
2950 enum
=> ['stopped', 'running'],
2953 description
=> "Maximum memory in bytes.",
2956 renderer
=> 'bytes',
2959 description
=> "Root disk size in bytes.",
2962 renderer
=> 'bytes',
2965 description
=> "VM name.",
2970 description
=> "Qemu QMP agent status.",
2975 description
=> "PID of running qemu process.",
2980 description
=> "Uptime.",
2983 renderer
=> 'duration',
2986 description
=> "Maximum usable CPUs.",
2992 my $last_proc_pid_stat;
2994 # get VM status information
2995 # This must be fast and should not block ($full == false)
2996 # We only query KVM using QMP if $full == true (this can be slow)
2998 my ($opt_vmid, $full) = @_;
3002 my $storecfg = PVE
::Storage
::config
();
3004 my $list = vzlist
();
3005 my $defaults = load_defaults
();
3007 my ($uptime) = PVE
::ProcFSTools
::read_proc_uptime
(1);
3009 my $cpucount = $cpuinfo->{cpus
} || 1;
3011 foreach my $vmid (keys %$list) {
3012 next if $opt_vmid && ($vmid ne $opt_vmid);
3014 my $cfspath = PVE
::QemuConfig-
>cfs_config_path($vmid);
3015 my $conf = PVE
::Cluster
::cfs_read_file
($cfspath) || {};
3017 my $d = { vmid
=> $vmid };
3018 $d->{pid
} = $list->{$vmid}->{pid
};
3020 # fixme: better status?
3021 $d->{status
} = $list->{$vmid}->{pid
} ?
'running' : 'stopped';
3023 my $size = disksize
($storecfg, $conf);
3024 if (defined($size)) {
3025 $d->{disk
} = 0; # no info available
3026 $d->{maxdisk
} = $size;
3032 $d->{cpus
} = ($conf->{sockets
} || $defaults->{sockets
})
3033 * ($conf->{cores
} || $defaults->{cores
});
3034 $d->{cpus
} = $cpucount if $d->{cpus
} > $cpucount;
3035 $d->{cpus
} = $conf->{vcpus
} if $conf->{vcpus
};
3037 $d->{name
} = $conf->{name
} || "VM $vmid";
3038 $d->{maxmem
} = $conf->{memory
} ?
$conf->{memory
}*(1024*1024)
3039 : $defaults->{memory
}*(1024*1024);
3041 if ($conf->{balloon
}) {
3042 $d->{balloon_min
} = $conf->{balloon
}*(1024*1024);
3043 $d->{shares
} = defined($conf->{shares
}) ?
$conf->{shares
}
3044 : $defaults->{shares
};
3055 $d->{diskwrite
} = 0;
3057 $d->{template
} = PVE
::QemuConfig-
>is_template($conf);
3059 $d->{serial
} = 1 if conf_has_serial
($conf);
3064 my $netdev = PVE
::ProcFSTools
::read_proc_net_dev
();
3065 foreach my $dev (keys %$netdev) {
3066 next if $dev !~ m/^tap([1-9]\d*)i/;
3068 my $d = $res->{$vmid};
3071 $d->{netout
} += $netdev->{$dev}->{receive
};
3072 $d->{netin
} += $netdev->{$dev}->{transmit
};
3075 $d->{nics
}->{$dev}->{netout
} = $netdev->{$dev}->{receive
};
3076 $d->{nics
}->{$dev}->{netin
} = $netdev->{$dev}->{transmit
};
3081 my $ctime = gettimeofday
;
3083 foreach my $vmid (keys %$list) {
3085 my $d = $res->{$vmid};
3086 my $pid = $d->{pid
};
3089 my $pstat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
3090 next if !$pstat; # not running
3092 my $used = $pstat->{utime} + $pstat->{stime
};
3094 $d->{uptime
} = int(($uptime - $pstat->{starttime
})/$cpuinfo->{user_hz
});
3096 if ($pstat->{vsize
}) {
3097 $d->{mem
} = int(($pstat->{rss
}/$pstat->{vsize
})*$d->{maxmem
});
3100 my $old = $last_proc_pid_stat->{$pid};
3102 $last_proc_pid_stat->{$pid} = {
3110 my $dtime = ($ctime - $old->{time}) * $cpucount * $cpuinfo->{user_hz
};
3112 if ($dtime > 1000) {
3113 my $dutime = $used - $old->{used
};
3115 $d->{cpu
} = (($dutime/$dtime)* $cpucount) / $d->{cpus
};
3116 $last_proc_pid_stat->{$pid} = {
3122 $d->{cpu
} = $old->{cpu
};
3126 return $res if !$full;
3128 my $qmpclient = PVE
::QMPClient-
>new();
3130 my $ballooncb = sub {
3131 my ($vmid, $resp) = @_;
3133 my $info = $resp->{'return'};
3134 return if !$info->{max_mem
};
3136 my $d = $res->{$vmid};
3138 # use memory assigned to VM
3139 $d->{maxmem
} = $info->{max_mem
};
3140 $d->{balloon
} = $info->{actual
};
3142 if (defined($info->{total_mem
}) && defined($info->{free_mem
})) {
3143 $d->{mem
} = $info->{total_mem
} - $info->{free_mem
};
3144 $d->{freemem
} = $info->{free_mem
};
3147 $d->{ballooninfo
} = $info;
3150 my $blockstatscb = sub {
3151 my ($vmid, $resp) = @_;
3152 my $data = $resp->{'return'} || [];
3153 my $totalrdbytes = 0;
3154 my $totalwrbytes = 0;
3156 for my $blockstat (@$data) {
3157 $totalrdbytes = $totalrdbytes + $blockstat->{stats
}->{rd_bytes
};
3158 $totalwrbytes = $totalwrbytes + $blockstat->{stats
}->{wr_bytes
};
3160 $blockstat->{device
} =~ s/drive-//;
3161 $res->{$vmid}->{blockstat
}->{$blockstat->{device
}} = $blockstat->{stats
};
3163 $res->{$vmid}->{diskread
} = $totalrdbytes;
3164 $res->{$vmid}->{diskwrite
} = $totalwrbytes;
3167 my $statuscb = sub {
3168 my ($vmid, $resp) = @_;
3170 $qmpclient->queue_cmd($vmid, $blockstatscb, 'query-blockstats');
3171 # this fails if ballon driver is not loaded, so this must be
3172 # the last commnand (following command are aborted if this fails).
3173 $qmpclient->queue_cmd($vmid, $ballooncb, 'query-balloon');
3175 my $status = 'unknown';
3176 if (!defined($status = $resp->{'return'}->{status
})) {
3177 warn "unable to get VM status\n";
3181 $res->{$vmid}->{qmpstatus
} = $resp->{'return'}->{status
};
3184 foreach my $vmid (keys %$list) {
3185 next if $opt_vmid && ($vmid ne $opt_vmid);
3186 next if !$res->{$vmid}->{pid
}; # not running
3187 $qmpclient->queue_cmd($vmid, $statuscb, 'query-status');
3190 $qmpclient->queue_execute(undef, 2);
3192 foreach my $vmid (keys %$list) {
3193 next if $opt_vmid && ($vmid ne $opt_vmid);
3194 $res->{$vmid}->{qmpstatus
} = $res->{$vmid}->{status
} if !$res->{$vmid}->{qmpstatus
};
3201 my ($conf, $func, @param) = @_;
3203 foreach my $ds (valid_drive_names
()) {
3204 next if !defined($conf->{$ds});
3206 my $drive = parse_drive
($ds, $conf->{$ds});
3209 &$func($ds, $drive, @param);
3214 my ($conf, $func, @param) = @_;
3218 my $test_volid = sub {
3219 my ($volid, $is_cdrom, $replicate, $shared, $snapname) = @_;
3223 $volhash->{$volid}->{cdrom
} //= 1;
3224 $volhash->{$volid}->{cdrom
} = 0 if !$is_cdrom;
3226 $volhash->{$volid}->{replicate
} //= 0;
3227 $volhash->{$volid}->{replicate
} = 1 if $replicate;
3229 $volhash->{$volid}->{shared
} //= 0;
3230 $volhash->{$volid}->{shared
} = 1 if $shared;
3232 $volhash->{$volid}->{referenced_in_config
} //= 0;
3233 $volhash->{$volid}->{referenced_in_config
} = 1 if !defined($snapname);
3235 $volhash->{$volid}->{referenced_in_snapshot
}->{$snapname} = 1
3236 if defined($snapname);
3239 foreach_drive
($conf, sub {
3240 my ($ds, $drive) = @_;
3241 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, undef);
3244 foreach my $snapname (keys %{$conf->{snapshots
}}) {
3245 my $snap = $conf->{snapshots
}->{$snapname};
3246 $test_volid->($snap->{vmstate
}, 0, 1, $snapname);
3247 foreach_drive
($snap, sub {
3248 my ($ds, $drive) = @_;
3249 $test_volid->($drive->{file
}, drive_is_cdrom
($drive), $drive->{replicate
} // 1, $drive->{shared
}, $snapname);
3253 foreach my $volid (keys %$volhash) {
3254 &$func($volid, $volhash->{$volid}, @param);
3258 sub conf_has_serial
{
3261 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3262 if ($conf->{"serial$i"}) {
3270 sub vga_conf_has_spice
{
3273 my $vgaconf = parse_vga
($vga);
3274 my $vgatype = $vgaconf->{type
};
3275 return 0 if !$vgatype || $vgatype !~ m/^qxl([234])?$/;
3280 my $host_arch; # FIXME: fix PVE::Tools::get_host_arch
3281 sub get_host_arch
() {
3282 $host_arch = (POSIX
::uname
())[4] if !$host_arch;
3288 return get_host_arch
() eq $arch;
3291 my $default_machines = {
3296 sub get_basic_machine_info
{
3297 my ($conf, $forcemachine) = @_;
3299 my $arch = $conf->{arch
} // get_host_arch
();
3300 my $machine = $forcemachine || $conf->{machine
} || $default_machines->{$arch};
3301 return ($arch, $machine);
3304 sub get_ovmf_files
($) {
3307 my $ovmf = $OVMF->{$arch}
3308 or die "no OVMF images known for architecture '$arch'\n";
3314 aarch64
=> '/usr/bin/qemu-system-aarch64',
3315 x86_64
=> '/usr/bin/qemu-system-x86_64',
3317 sub get_command_for_arch
($) {
3319 return '/usr/bin/kvm' if is_native
($arch);
3321 my $cmd = $Arch2Qemu->{$arch}
3322 or die "don't know how to emulate architecture '$arch'\n";
3326 sub get_cpu_options
{
3327 my ($conf, $arch, $kvm, $machine_type, $kvm_off, $kvmver, $winversion, $gpu_passthrough) = @_;
3330 my $ostype = $conf->{ostype
};
3332 my $cpu = $kvm ?
"kvm64" : "qemu64";
3333 if ($arch eq 'aarch64') {
3334 $cpu = 'cortex-a57';
3336 if (my $cputype = $conf->{cpu
}) {
3337 my $cpuconf = PVE
::JSONSchema
::parse_property_string
($cpu_fmt, $cputype)
3338 or die "Cannot parse cpu description: $cputype\n";
3339 $cpu = $cpuconf->{cputype
};
3340 $kvm_off = 1 if $cpuconf->{hidden
};
3342 if (defined(my $flags = $cpuconf->{flags
})) {
3343 push @$cpuFlags, split(";", $flags);
3347 push @$cpuFlags , '+lahf_lm' if $cpu eq 'kvm64';
3349 push @$cpuFlags , '-x2apic'
3350 if $conf->{ostype
} && $conf->{ostype
} eq 'solaris';
3352 push @$cpuFlags, '+sep' if $cpu eq 'kvm64' || $cpu eq 'kvm32';
3354 push @$cpuFlags, '-rdtscp' if $cpu =~ m/^Opteron/;
3356 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
3358 push @$cpuFlags , '+kvm_pv_unhalt' if $kvm;
3359 push @$cpuFlags , '+kvm_pv_eoi' if $kvm;
3362 add_hyperv_enlightenments
($cpuFlags, $winversion, $machine_type, $kvmver, $conf->{bios
}, $gpu_passthrough) if $kvm;
3364 push @$cpuFlags, 'enforce' if $cpu ne 'host' && $kvm;
3366 push @$cpuFlags, 'kvm=off' if $kvm_off;
3368 if (my $cpu_vendor = $cpu_vendor_list->{$cpu}) {
3369 push @$cpuFlags, "vendor=${cpu_vendor}"
3370 if $cpu_vendor ne 'default';
3371 } elsif ($arch ne 'aarch64') {
3372 die "internal error"; # should not happen
3375 $cpu .= "," . join(',', @$cpuFlags) if scalar(@$cpuFlags);
3377 return ('-cpu', $cpu);
3380 sub config_to_command
{
3381 my ($storecfg, $vmid, $conf, $defaults, $forcemachine) = @_;
3384 my $globalFlags = [];
3385 my $machineFlags = [];
3390 my $kvmver = kvm_user_version
();
3391 my $vernum = 0; # unknown
3392 my $ostype = $conf->{ostype
};
3393 my $winversion = windows_version
($ostype);
3394 my $kvm = $conf->{kvm
};
3396 my ($arch, $machine_type) = get_basic_machine_info
($conf, $forcemachine);
3397 $kvm //= 1 if is_native
($arch);
3400 die "KVM virtualisation configured, but not available. Either disable in VM configuration or enable in BIOS.\n"
3401 if !defined kvm_version
();
3404 if ($kvmver =~ m/^(\d+)\.(\d+)$/) {
3405 $vernum = $1*1000000+$2*1000;
3406 } elsif ($kvmver =~ m/^(\d+)\.(\d+)\.(\d+)$/) {
3407 $vernum = $1*1000000+$2*1000+$3;
3410 die "detected old qemu-kvm binary ($kvmver)\n" if $vernum < 15000;
3412 my $have_ovz = -f
'/proc/vz/vestat';
3414 my $q35 = machine_type_is_q35
($conf);
3415 my $hotplug_features = parse_hotplug_features
(defined($conf->{hotplug
}) ?
$conf->{hotplug
} : '1');
3416 my $use_old_bios_files = undef;
3417 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
3419 my $cpuunits = defined($conf->{cpuunits
}) ?
3420 $conf->{cpuunits
} : $defaults->{cpuunits
};
3422 push @$cmd, get_command_for_arch
($arch);
3424 push @$cmd, '-id', $vmid;
3426 my $vmname = $conf->{name
} || "vm$vmid";
3428 push @$cmd, '-name', $vmname;
3432 my $qmpsocket = qmp_socket
($vmid);
3433 push @$cmd, '-chardev', "socket,id=qmp,path=$qmpsocket,server,nowait";
3434 push @$cmd, '-mon', "chardev=qmp,mode=control";
3436 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 12)) {
3437 my $eventsocket = qmp_socket
($vmid, 0, 'event');
3438 push @$cmd, '-chardev', "socket,id=qmp-event,path=$eventsocket,server,nowait";
3439 push @$cmd, '-mon', "chardev=qmp-event,mode=control";
3442 push @$cmd, '-pidfile' , pidfile_name
($vmid);
3444 push @$cmd, '-daemonize';
3446 if ($conf->{smbios1
}) {
3447 push @$cmd, '-smbios', "type=1,$conf->{smbios1}";
3450 if ($conf->{vmgenid
}) {
3451 push @$devices, '-device', 'vmgenid,guid='.$conf->{vmgenid
};
3454 my ($ovmf_code, $ovmf_vars) = get_ovmf_files
($arch);
3455 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3456 die "uefi base image not found\n" if ! -f
$ovmf_code;
3460 if (my $efidisk = $conf->{efidisk0
}) {
3461 my $d = PVE
::JSONSchema
::parse_property_string
($efidisk_fmt, $efidisk);
3462 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($d->{file
}, 1);
3463 $format = $d->{format
};
3465 $path = PVE
::Storage
::path
($storecfg, $d->{file
});
3466 if (!defined($format)) {
3467 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
3468 $format = qemu_img_format
($scfg, $volname);
3472 die "efidisk format must be specified\n"
3473 if !defined($format);
3476 warn "no efidisk configured! Using temporary efivars disk.\n";
3477 $path = "/tmp/$vmid-ovmf.fd";
3478 PVE
::Tools
::file_copy
($ovmf_vars, $path, -s
$ovmf_vars);
3482 push @$cmd, '-drive', "if=pflash,unit=0,format=raw,readonly,file=$ovmf_code";
3483 push @$cmd, '-drive', "if=pflash,unit=1,format=$format,id=drive-efidisk0,file=$path";
3487 # add usb controllers
3488 my @usbcontrollers = PVE
::QemuServer
::USB
::get_usb_controllers
($conf, $bridges, $arch, $machine_type, $usbdesc->{format
}, $MAX_USB_DEVICES);
3489 push @$devices, @usbcontrollers if @usbcontrollers;
3490 my $vga = parse_vga
($conf->{vga
});
3492 my $qxlnum = vga_conf_has_spice
($conf->{vga
});
3493 $vga->{type
} = 'qxl' if $qxlnum;
3495 if (!$vga->{type
}) {
3496 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 9)) {
3497 $vga->{type
} = (!$winversion || $winversion >= 6) ?
'std' : 'cirrus';
3499 $vga->{type
} = ($winversion >= 6) ?
'std' : 'cirrus';
3503 # enable absolute mouse coordinates (needed by vnc)
3505 if (defined($conf->{tablet
})) {
3506 $tablet = $conf->{tablet
};
3508 $tablet = $defaults->{tablet
};
3509 $tablet = 0 if $qxlnum; # disable for spice because it is not needed
3510 $tablet = 0 if $vga->{type
} =~ m/^serial\d+$/; # disable if we use serial terminal (no vga card)
3514 push @$devices, '-device', print_tabletdevice_full
($conf, $arch) if $tablet;
3515 my $kbd = print_keyboarddevice_full
($conf, $arch);
3516 push @$devices, '-device', $kbd if defined($kbd);
3520 my $gpu_passthrough;
3523 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
3524 my $d = parse_hostpci
($conf->{"hostpci$i"});
3527 my $pcie = $d->{pcie
};
3529 die "q35 machine model is not enabled" if !$q35;
3530 $pciaddr = print_pcie_addr
("hostpci$i");
3532 $pciaddr = print_pci_addr
("hostpci$i", $bridges, $arch, $machine_type);
3535 my $rombar = defined($d->{rombar
}) && !$d->{rombar
} ?
',rombar=0' : '';
3536 my $romfile = $d->{romfile
};
3539 if ($d->{'x-vga'}) {
3540 $xvga = ',x-vga=on';
3542 $vga->{type
} = 'none';
3543 $gpu_passthrough = 1;
3545 if ($conf->{bios
} && $conf->{bios
} eq 'ovmf') {
3549 my $pcidevices = $d->{pciid
};
3550 my $multifunction = 1 if @$pcidevices > 1;
3553 foreach my $pcidevice (@$pcidevices) {
3555 my $id = "hostpci$i";
3556 $id .= ".$j" if $multifunction;
3557 my $addr = $pciaddr;
3558 $addr .= ".$j" if $multifunction;
3559 my $devicestr = "vfio-pci,host=$pcidevice->{id}.$pcidevice->{function},id=$id$addr";
3562 $devicestr .= "$rombar$xvga";
3563 $devicestr .= ",multifunction=on" if $multifunction;
3564 $devicestr .= ",romfile=/usr/share/kvm/$romfile" if $romfile;
3567 push @$devices, '-device', $devicestr;
3573 my @usbdevices = PVE
::QemuServer
::USB
::get_usb_devices
($conf, $usbdesc->{format
}, $MAX_USB_DEVICES);
3574 push @$devices, @usbdevices if @usbdevices;
3576 for (my $i = 0; $i < $MAX_SERIAL_PORTS; $i++) {
3577 if (my $path = $conf->{"serial$i"}) {
3578 if ($path eq 'socket') {
3579 my $socket = "/var/run/qemu-server/${vmid}.serial$i";
3580 push @$devices, '-chardev', "socket,id=serial$i,path=$socket,server,nowait";
3581 # On aarch64, serial0 is the UART device. Qemu only allows
3582 # connecting UART devices via the '-serial' command line, as
3583 # the device has a fixed slot on the hardware...
3584 if ($arch eq 'aarch64' && $i == 0) {
3585 push @$devices, '-serial', "chardev:serial$i";
3587 push @$devices, '-device', "isa-serial,chardev=serial$i";
3590 die "no such serial device\n" if ! -c
$path;
3591 push @$devices, '-chardev', "tty,id=serial$i,path=$path";
3592 push @$devices, '-device', "isa-serial,chardev=serial$i";
3598 for (my $i = 0; $i < $MAX_PARALLEL_PORTS; $i++) {
3599 if (my $path = $conf->{"parallel$i"}) {
3600 die "no such parallel device\n" if ! -c
$path;
3601 my $devtype = $path =~ m!^/dev/usb/lp! ?
'tty' : 'parport';
3602 push @$devices, '-chardev', "$devtype,id=parallel$i,path=$path";
3603 push @$devices, '-device', "isa-parallel,chardev=parallel$i";
3609 $sockets = $conf->{smp
} if $conf->{smp
}; # old style - no longer iused
3610 $sockets = $conf->{sockets
} if $conf->{sockets
};
3612 my $cores = $conf->{cores
} || 1;
3614 my $maxcpus = $sockets * $cores;
3616 my $vcpus = $conf->{vcpus
} ?
$conf->{vcpus
} : $maxcpus;
3618 my $allowed_vcpus = $cpuinfo->{cpus
};
3620 die "MAX $allowed_vcpus vcpus allowed per VM on this node\n"
3621 if ($allowed_vcpus < $maxcpus);
3623 if($hotplug_features->{cpu
} && qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 7)) {
3625 push @$cmd, '-smp', "1,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3626 for (my $i = 2; $i <= $vcpus; $i++) {
3627 my $cpustr = print_cpu_device
($conf,$i);
3628 push @$cmd, '-device', $cpustr;
3633 push @$cmd, '-smp', "$vcpus,sockets=$sockets,cores=$cores,maxcpus=$maxcpus";
3635 push @$cmd, '-nodefaults';
3637 my $bootorder = $conf->{boot
} || $confdesc->{boot
}->{default};
3639 my $bootindex_hash = {};
3641 foreach my $o (split(//, $bootorder)) {
3642 $bootindex_hash->{$o} = $i*100;
3646 push @$cmd, '-boot', "menu=on,strict=on,reboot-timeout=1000,splash=/usr/share/qemu-server/bootsplash.jpg";
3648 push @$cmd, '-no-acpi' if defined($conf->{acpi
}) && $conf->{acpi
} == 0;
3650 push @$cmd, '-no-reboot' if defined($conf->{reboot
}) && $conf->{reboot
} == 0;
3652 if ($vga->{type
} && $vga->{type
} !~ m/^serial\d+$/ && $vga->{type
} ne 'none'){
3653 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_type, undef, $qxlnum, $bridges);
3654 my $socket = vnc_socket
($vmid);
3655 push @$cmd, '-vnc', "unix:$socket,x509,password";
3657 push @$cmd, '-vga', 'none' if $vga->{type
} eq 'none';
3658 push @$cmd, '-nographic';
3662 my $tdf = defined($conf->{tdf
}) ?
$conf->{tdf
} : $defaults->{tdf
};
3664 my $useLocaltime = $conf->{localtime};
3666 if ($winversion >= 5) { # windows
3667 $useLocaltime = 1 if !defined($conf->{localtime});
3669 # use time drift fix when acpi is enabled
3670 if (!(defined($conf->{acpi
}) && $conf->{acpi
} == 0)) {
3671 $tdf = 1 if !defined($conf->{tdf
});
3675 if ($winversion >= 6) {
3676 push @$globalFlags, 'kvm-pit.lost_tick_policy=discard';
3677 push @$cmd, '-no-hpet';
3680 push @$rtcFlags, 'driftfix=slew' if $tdf;
3683 push @$machineFlags, 'accel=tcg';
3686 if ($machine_type) {
3687 push @$machineFlags, "type=${machine_type}";
3690 if ($conf->{startdate
}) {
3691 push @$rtcFlags, "base=$conf->{startdate}";
3692 } elsif ($useLocaltime) {
3693 push @$rtcFlags, 'base=localtime';
3696 push @$cmd, get_cpu_options
($conf, $arch, $kvm, $machine_type, $kvm_off, $kvmver, $winversion, $gpu_passthrough);
3698 PVE
::QemuServer
::Memory
::config
($conf, $vmid, $sockets, $cores, $defaults, $hotplug_features, $cmd);
3700 push @$cmd, '-S' if $conf->{freeze
};
3702 push @$cmd, '-k', $conf->{keyboard
} if defined($conf->{keyboard
});
3705 #my $soundhw = $conf->{soundhw} || $defaults->{soundhw};
3706 #push @$cmd, '-soundhw', 'es1370';
3707 #push @$cmd, '-soundhw', $soundhw if $soundhw;
3709 if (parse_guest_agent
($conf)->{enabled
}) {
3710 my $qgasocket = qmp_socket
($vmid, 1);
3711 my $pciaddr = print_pci_addr
("qga0", $bridges, $arch, $machine_type);
3712 push @$devices, '-chardev', "socket,path=$qgasocket,server,nowait,id=qga0";
3713 push @$devices, '-device', "virtio-serial,id=qga0$pciaddr";
3714 push @$devices, '-device', 'virtserialport,chardev=qga0,name=org.qemu.guest_agent.0';
3722 for(my $i = 1; $i < $qxlnum; $i++){
3723 push @$devices, '-device', print_vga_device
($conf, $vga, $arch, $machine_type, $i, $qxlnum, $bridges);
3726 # assume other OS works like Linux
3727 my ($ram, $vram) = ("134217728", "67108864");
3728 if ($vga->{memory
}) {
3729 $ram = PVE
::Tools
::convert_size
($qxlnum*4*$vga->{memory
}, 'mb' => 'b');
3730 $vram = PVE
::Tools
::convert_size
($qxlnum*2*$vga->{memory
}, 'mb' => 'b');
3732 push @$cmd, '-global', "qxl-vga.ram_size=$ram";
3733 push @$cmd, '-global', "qxl-vga.vram_size=$vram";
3737 my $pciaddr = print_pci_addr
("spice", $bridges, $arch, $machine_type);
3739 my $nodename = PVE
::INotify
::nodename
();
3740 my $pfamily = PVE
::Tools
::get_host_address_family
($nodename);
3741 my @nodeaddrs = PVE
::Tools
::getaddrinfo_all
('localhost', family
=> $pfamily);
3742 die "failed to get an ip address of type $pfamily for 'localhost'\n" if !@nodeaddrs;
3743 my $localhost = PVE
::Network
::addr_to_ip
($nodeaddrs[0]->{addr
});
3744 $spice_port = PVE
::Tools
::next_spice_port
($pfamily, $localhost);
3746 push @$devices, '-spice', "tls-port=${spice_port},addr=$localhost,tls-ciphers=HIGH,seamless-migration=on";
3748 push @$devices, '-device', "virtio-serial,id=spice$pciaddr";
3749 push @$devices, '-chardev', "spicevmc,id=vdagent,name=vdagent";
3750 push @$devices, '-device', "virtserialport,chardev=vdagent,name=com.redhat.spice.0";
3753 # enable balloon by default, unless explicitly disabled
3754 if (!defined($conf->{balloon
}) || $conf->{balloon
}) {
3755 $pciaddr = print_pci_addr
("balloon0", $bridges, $arch, $machine_type);
3756 push @$devices, '-device', "virtio-balloon-pci,id=balloon0$pciaddr";
3759 if ($conf->{watchdog
}) {
3760 my $wdopts = parse_watchdog
($conf->{watchdog
});
3761 $pciaddr = print_pci_addr
("watchdog", $bridges, $arch, $machine_type);
3762 my $watchdog = $wdopts->{model
} || 'i6300esb';
3763 push @$devices, '-device', "$watchdog$pciaddr";
3764 push @$devices, '-watchdog-action', $wdopts->{action
} if $wdopts->{action
};
3768 my $scsicontroller = {};
3769 my $ahcicontroller = {};
3770 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : $defaults->{scsihw
};
3772 # Add iscsi initiator name if available
3773 if (my $initiator = get_initiator_name
()) {
3774 push @$devices, '-iscsi', "initiator-name=$initiator";
3777 foreach_drive
($conf, sub {
3778 my ($ds, $drive) = @_;
3780 if (PVE
::Storage
::parse_volume_id
($drive->{file
}, 1)) {
3781 push @$vollist, $drive->{file
};
3784 # ignore efidisk here, already added in bios/fw handling code above
3785 return if $drive->{interface
} eq 'efidisk';
3787 $use_virtio = 1 if $ds =~ m/^virtio/;
3789 if (drive_is_cdrom
($drive)) {
3790 if ($bootindex_hash->{d
}) {
3791 $drive->{bootindex
} = $bootindex_hash->{d
};
3792 $bootindex_hash->{d
} += 1;
3795 if ($bootindex_hash->{c
}) {
3796 $drive->{bootindex
} = $bootindex_hash->{c
} if $conf->{bootdisk
} && ($conf->{bootdisk
} eq $ds);
3797 $bootindex_hash->{c
} += 1;
3801 if($drive->{interface
} eq 'virtio'){
3802 push @$cmd, '-object', "iothread,id=iothread-$ds" if $drive->{iothread
};
3805 if ($drive->{interface
} eq 'scsi') {
3807 my ($maxdev, $controller, $controller_prefix) = scsihw_infos
($conf, $drive);
3809 $pciaddr = print_pci_addr
("$controller_prefix$controller", $bridges, $arch, $machine_type);
3810 my $scsihw_type = $scsihw =~ m/^virtio-scsi-single/ ?
"virtio-scsi-pci" : $scsihw;
3813 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{iothread
}){
3814 $iothread .= ",iothread=iothread-$controller_prefix$controller";
3815 push @$cmd, '-object', "iothread,id=iothread-$controller_prefix$controller";
3816 } elsif ($drive->{iothread
}) {
3817 warn "iothread is only valid with virtio disk or virtio-scsi-single controller, ignoring\n";
3821 if($conf->{scsihw
} && $conf->{scsihw
} eq "virtio-scsi-single" && $drive->{queues
}){
3822 $queues = ",num_queues=$drive->{queues}";
3825 push @$devices, '-device', "$scsihw_type,id=$controller_prefix$controller$pciaddr$iothread$queues" if !$scsicontroller->{$controller};
3826 $scsicontroller->{$controller}=1;
3829 if ($drive->{interface
} eq 'sata') {
3830 my $controller = int($drive->{index} / $MAX_SATA_DISKS);
3831 $pciaddr = print_pci_addr
("ahci$controller", $bridges, $arch, $machine_type);
3832 push @$devices, '-device', "ahci,id=ahci$controller,multifunction=on$pciaddr" if !$ahcicontroller->{$controller};
3833 $ahcicontroller->{$controller}=1;
3836 my $drive_cmd = print_drive_full
($storecfg, $vmid, $drive);
3837 push @$devices, '-drive',$drive_cmd;
3838 push @$devices, '-device', print_drivedevice_full
($storecfg, $conf, $vmid, $drive, $bridges, $arch, $machine_type);
3841 for (my $i = 0; $i < $MAX_NETS; $i++) {
3842 next if !$conf->{"net$i"};
3843 my $d = parse_net
($conf->{"net$i"});
3846 $use_virtio = 1 if $d->{model
} eq 'virtio';
3848 if ($bootindex_hash->{n
}) {
3849 $d->{bootindex
} = $bootindex_hash->{n
};
3850 $bootindex_hash->{n
} += 1;
3853 my $netdevfull = print_netdev_full
($vmid, $conf, $arch, $d, "net$i");
3854 push @$devices, '-netdev', $netdevfull;
3856 my $netdevicefull = print_netdevice_full
($vmid, $conf, $d, "net$i", $bridges, $use_old_bios_files, $arch, $machine_type);
3857 push @$devices, '-device', $netdevicefull;
3862 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
3867 $bridges->{3} = 1 if $scsihw =~ m/^virtio-scsi-single/;
3869 while (my ($k, $v) = each %$bridges) {
3870 $pciaddr = print_pci_addr
("pci.$k", undef, $arch, $machine_type);
3871 unshift @$devices, '-device', "pci-bridge,id=pci.$k,chassis_nr=$k$pciaddr" if $k > 0;
3876 if ($conf->{args
}) {
3877 my $aa = PVE
::Tools
::split_args
($conf->{args
});
3881 push @$cmd, @$devices;
3882 push @$cmd, '-rtc', join(',', @$rtcFlags)
3883 if scalar(@$rtcFlags);
3884 push @$cmd, '-machine', join(',', @$machineFlags)
3885 if scalar(@$machineFlags);
3886 push @$cmd, '-global', join(',', @$globalFlags)
3887 if scalar(@$globalFlags);
3889 return wantarray ?
($cmd, $vollist, $spice_port) : $cmd;
3894 return "${var_run_tmpdir}/$vmid.vnc";
3900 my $res = vm_mon_cmd
($vmid, 'query-spice');
3902 return $res->{'tls-port'} || $res->{'port'} || die "no spice port\n";
3906 my ($vmid, $qga, $name) = @_;
3907 my $sockettype = $qga ?
'qga' : 'qmp';
3908 my $ext = $name ?
'-'.$name : '';
3909 return "${var_run_tmpdir}/$vmid$ext.$sockettype";
3914 return "${var_run_tmpdir}/$vmid.pid";
3917 sub vm_devices_list
{
3920 my $res = vm_mon_cmd
($vmid, 'query-pci');
3921 my $devices_to_check = [];
3923 foreach my $pcibus (@$res) {
3924 push @$devices_to_check, @{$pcibus->{devices
}},
3927 while (@$devices_to_check) {
3929 for my $d (@$devices_to_check) {
3930 $devices->{$d->{'qdev_id'}} = 1 if $d->{'qdev_id'};
3931 next if !$d->{'pci_bridge'};
3933 $devices->{$d->{'qdev_id'}} += scalar(@{$d->{'pci_bridge'}->{devices
}});
3934 push @$to_check, @{$d->{'pci_bridge'}->{devices
}};
3936 $devices_to_check = $to_check;
3939 my $resblock = vm_mon_cmd
($vmid, 'query-block');
3940 foreach my $block (@$resblock) {
3941 if($block->{device
} =~ m/^drive-(\S+)/){
3946 my $resmice = vm_mon_cmd
($vmid, 'query-mice');
3947 foreach my $mice (@$resmice) {
3948 if ($mice->{name
} eq 'QEMU HID Tablet') {
3949 $devices->{tablet
} = 1;
3954 # for usb devices there is no query-usb
3955 # but we can iterate over the entries in
3956 # qom-list path=/machine/peripheral
3957 my $resperipheral = vm_mon_cmd
($vmid, 'qom-list', path
=> '/machine/peripheral');
3958 foreach my $per (@$resperipheral) {
3959 if ($per->{name
} =~ m/^usb\d+$/) {
3960 $devices->{$per->{name
}} = 1;
3968 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
3970 my $q35 = machine_type_is_q35
($conf);
3972 my $devices_list = vm_devices_list
($vmid);
3973 return 1 if defined($devices_list->{$deviceid});
3975 qemu_add_pci_bridge
($storecfg, $conf, $vmid, $deviceid, $arch, $machine_type); # add PCI bridge if we need it for the device
3977 if ($deviceid eq 'tablet') {
3979 qemu_deviceadd
($vmid, print_tabletdevice_full
($conf, $arch));
3981 } elsif ($deviceid eq 'keyboard') {
3983 qemu_deviceadd
($vmid, print_keyboarddevice_full
($conf, $arch));
3985 } elsif ($deviceid =~ m/^usb(\d+)$/) {
3987 die "usb hotplug currently not reliable\n";
3988 # since we can't reliably hot unplug all added usb devices
3989 # and usb passthrough disables live migration
3990 # we disable usb hotplugging for now
3991 qemu_deviceadd
($vmid, PVE
::QemuServer
::USB
::print_usbdevice_full
($conf, $deviceid, $device));
3993 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
3995 qemu_iothread_add
($vmid, $deviceid, $device);
3997 qemu_driveadd
($storecfg, $vmid, $device);
3998 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4000 qemu_deviceadd
($vmid, $devicefull);
4001 eval { qemu_deviceaddverify
($vmid, $deviceid); };
4003 eval { qemu_drivedel
($vmid, $deviceid); };
4008 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4011 my $scsihw = defined($conf->{scsihw
}) ?
$conf->{scsihw
} : "lsi";
4012 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4013 my $scsihw_type = $scsihw eq 'virtio-scsi-single' ?
"virtio-scsi-pci" : $scsihw;
4015 my $devicefull = "$scsihw_type,id=$deviceid$pciaddr";
4017 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{iothread
}) {
4018 qemu_iothread_add
($vmid, $deviceid, $device);
4019 $devicefull .= ",iothread=iothread-$deviceid";
4022 if($deviceid =~ m/^virtioscsi(\d+)$/ && $device->{queues
}) {
4023 $devicefull .= ",num_queues=$device->{queues}";
4026 qemu_deviceadd
($vmid, $devicefull);
4027 qemu_deviceaddverify
($vmid, $deviceid);
4029 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4031 qemu_findorcreatescsihw
($storecfg,$conf, $vmid, $device, $arch, $machine_type);
4032 qemu_driveadd
($storecfg, $vmid, $device);
4034 my $devicefull = print_drivedevice_full
($storecfg, $conf, $vmid, $device, $arch, $machine_type);
4035 eval { qemu_deviceadd
($vmid, $devicefull); };
4037 eval { qemu_drivedel
($vmid, $deviceid); };
4042 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4044 return undef if !qemu_netdevadd
($vmid, $conf, $arch, $device, $deviceid);
4046 my $machine_type = PVE
::QemuServer
::qemu_machine_pxe
($vmid, $conf);
4047 my $use_old_bios_files = undef;
4048 ($use_old_bios_files, $machine_type) = qemu_use_old_bios_files
($machine_type);
4050 my $netdevicefull = print_netdevice_full
($vmid, $conf, $device, $deviceid, undef, $use_old_bios_files, $arch, $machine_type);
4051 qemu_deviceadd
($vmid, $netdevicefull);
4052 eval { qemu_deviceaddverify
($vmid, $deviceid); };
4054 eval { qemu_netdevdel
($vmid, $deviceid); };
4059 } elsif (!$q35 && $deviceid =~ m/^(pci\.)(\d+)$/) {
4062 my $pciaddr = print_pci_addr
($deviceid, undef, $arch, $machine_type);
4063 my $devicefull = "pci-bridge,id=pci.$bridgeid,chassis_nr=$bridgeid$pciaddr";
4065 qemu_deviceadd
($vmid, $devicefull);
4066 qemu_deviceaddverify
($vmid, $deviceid);
4069 die "can't hotplug device '$deviceid'\n";
4075 # fixme: this should raise exceptions on error!
4076 sub vm_deviceunplug
{
4077 my ($vmid, $conf, $deviceid) = @_;
4079 my $devices_list = vm_devices_list
($vmid);
4080 return 1 if !defined($devices_list->{$deviceid});
4082 die "can't unplug bootdisk" if $conf->{bootdisk
} && $conf->{bootdisk
} eq $deviceid;
4084 if ($deviceid eq 'tablet' || $deviceid eq 'keyboard') {
4086 qemu_devicedel
($vmid, $deviceid);
4088 } elsif ($deviceid =~ m/^usb\d+$/) {
4090 die "usb hotplug currently not reliable\n";
4091 # when unplugging usb devices this way,
4092 # there may be remaining usb controllers/hubs
4093 # so we disable it for now
4094 qemu_devicedel
($vmid, $deviceid);
4095 qemu_devicedelverify
($vmid, $deviceid);
4097 } elsif ($deviceid =~ m/^(virtio)(\d+)$/) {
4099 qemu_devicedel
($vmid, $deviceid);
4100 qemu_devicedelverify
($vmid, $deviceid);
4101 qemu_drivedel
($vmid, $deviceid);
4102 qemu_iothread_del
($conf, $vmid, $deviceid);
4104 } elsif ($deviceid =~ m/^(virtioscsi|scsihw)(\d+)$/) {
4106 qemu_devicedel
($vmid, $deviceid);
4107 qemu_devicedelverify
($vmid, $deviceid);
4108 qemu_iothread_del
($conf, $vmid, $deviceid);
4110 } elsif ($deviceid =~ m/^(scsi)(\d+)$/) {
4112 qemu_devicedel
($vmid, $deviceid);
4113 qemu_drivedel
($vmid, $deviceid);
4114 qemu_deletescsihw
($conf, $vmid, $deviceid);
4116 } elsif ($deviceid =~ m/^(net)(\d+)$/) {
4118 qemu_devicedel
($vmid, $deviceid);
4119 qemu_devicedelverify
($vmid, $deviceid);
4120 qemu_netdevdel
($vmid, $deviceid);
4123 die "can't unplug device '$deviceid'\n";
4129 sub qemu_deviceadd
{
4130 my ($vmid, $devicefull) = @_;
4132 $devicefull = "driver=".$devicefull;
4133 my %options = split(/[=,]/, $devicefull);
4135 vm_mon_cmd
($vmid, "device_add" , %options);
4138 sub qemu_devicedel
{
4139 my ($vmid, $deviceid) = @_;
4141 my $ret = vm_mon_cmd
($vmid, "device_del", id
=> $deviceid);
4144 sub qemu_iothread_add
{
4145 my($vmid, $deviceid, $device) = @_;
4147 if ($device->{iothread
}) {
4148 my $iothreads = vm_iothreads_list
($vmid);
4149 qemu_objectadd
($vmid, "iothread-$deviceid", "iothread") if !$iothreads->{"iothread-$deviceid"};
4153 sub qemu_iothread_del
{
4154 my($conf, $vmid, $deviceid) = @_;
4156 my $device = parse_drive
($deviceid, $conf->{$deviceid});
4157 if ($device->{iothread
}) {
4158 my $iothreads = vm_iothreads_list
($vmid);
4159 qemu_objectdel
($vmid, "iothread-$deviceid") if $iothreads->{"iothread-$deviceid"};
4163 sub qemu_objectadd
{
4164 my($vmid, $objectid, $qomtype) = @_;
4166 vm_mon_cmd
($vmid, "object-add", id
=> $objectid, "qom-type" => $qomtype);
4171 sub qemu_objectdel
{
4172 my($vmid, $objectid) = @_;
4174 vm_mon_cmd
($vmid, "object-del", id
=> $objectid);
4180 my ($storecfg, $vmid, $device) = @_;
4182 my $drive = print_drive_full
($storecfg, $vmid, $device);
4183 $drive =~ s/\\/\\\\/g;
4184 my $ret = vm_human_monitor_command
($vmid, "drive_add auto \"$drive\"");
4186 # If the command succeeds qemu prints: "OK
"
4187 return 1 if $ret =~ m/OK/s;
4189 die "adding drive failed
: $ret\n";
4193 my($vmid, $deviceid) = @_;
4195 my $ret = vm_human_monitor_command($vmid, "drive_del drive-
$deviceid");
4198 return 1 if $ret eq "";
4200 # NB: device not found errors mean the drive was auto-deleted and we ignore the error
4201 return 1 if $ret =~ m/Device \'.*?\' not found/s;
4203 die "deleting drive
$deviceid failed
: $ret\n";
4206 sub qemu_deviceaddverify {
4207 my ($vmid, $deviceid) = @_;
4209 for (my $i = 0; $i <= 5; $i++) {
4210 my $devices_list = vm_devices_list($vmid);
4211 return 1 if defined($devices_list->{$deviceid});
4215 die "error on hotplug device
'$deviceid'\n";
4219 sub qemu_devicedelverify {
4220 my ($vmid, $deviceid) = @_;
4222 # need to verify that the device is correctly removed as device_del
4223 # is async and empty return is not reliable
4225 for (my $i = 0; $i <= 5; $i++) {
4226 my $devices_list = vm_devices_list($vmid);
4227 return 1 if !defined($devices_list->{$deviceid});
4231 die "error on hot-unplugging device
'$deviceid'\n";
4234 sub qemu_findorcreatescsihw {
4235 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4237 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4239 my $scsihwid="$controller_prefix$controller";
4240 my $devices_list = vm_devices_list($vmid);
4242 if(!defined($devices_list->{$scsihwid})) {
4243 vm_deviceplug($storecfg, $conf, $vmid, $scsihwid, $device, $arch, $machine_type);
4249 sub qemu_deletescsihw {
4250 my ($conf, $vmid, $opt) = @_;
4252 my $device = parse_drive($opt, $conf->{$opt});
4254 if ($conf->{scsihw} && ($conf->{scsihw} eq 'virtio-scsi-single')) {
4255 vm_deviceunplug($vmid, $conf, "virtioscsi
$device->{index}");
4259 my ($maxdev, $controller, $controller_prefix) = scsihw_infos($conf, $device);
4261 my $devices_list = vm_devices_list($vmid);
4262 foreach my $opt (keys %{$devices_list}) {
4263 if (PVE::QemuServer::is_valid_drivename($opt)) {
4264 my $drive = PVE::QemuServer::parse_drive($opt, $conf->{$opt});
4265 if($drive->{interface} eq 'scsi' && $drive->{index} < (($maxdev-1)*($controller+1))) {
4271 my $scsihwid="scsihw
$controller";
4273 vm_deviceunplug($vmid, $conf, $scsihwid);
4278 sub qemu_add_pci_bridge {
4279 my ($storecfg, $conf, $vmid, $device, $arch, $machine_type) = @_;
4285 print_pci_addr($device, $bridges, $arch, $machine_type);
4287 while (my ($k, $v) = each %$bridges) {
4290 return 1 if !defined($bridgeid) || $bridgeid < 1;
4292 my $bridge = "pci
.$bridgeid";
4293 my $devices_list = vm_devices_list($vmid);
4295 if (!defined($devices_list->{$bridge})) {
4296 vm_deviceplug($storecfg, $conf, $vmid, $bridge, $arch, $machine_type);
4302 sub qemu_set_link_status {
4303 my ($vmid, $device, $up) = @_;
4305 vm_mon_cmd($vmid, "set_link
", name => $device,
4306 up => $up ? JSON::true : JSON::false);
4309 sub qemu_netdevadd {
4310 my ($vmid, $conf, $arch, $device, $deviceid) = @_;
4312 my $netdev = print_netdev_full($vmid, $conf, $arch, $device, $deviceid, 1);
4313 my %options = split(/[=,]/, $netdev);
4315 vm_mon_cmd($vmid, "netdev_add
", %options);
4319 sub qemu_netdevdel {
4320 my ($vmid, $deviceid) = @_;
4322 vm_mon_cmd($vmid, "netdev_del
", id => $deviceid);
4325 sub qemu_usb_hotplug {
4326 my ($storecfg, $conf, $vmid, $deviceid, $device, $arch, $machine_type) = @_;
4330 # remove the old one first
4331 vm_deviceunplug($vmid, $conf, $deviceid);
4333 # check if xhci controller is necessary and available
4334 if ($device->{usb3}) {
4336 my $devicelist = vm_devices_list($vmid);
4338 if (!$devicelist->{xhci}) {
4339 my $pciaddr = print_pci_addr("xhci
", undef, $arch, $machine_type);
4340 qemu_deviceadd($vmid, "nec-usb-xhci
,id
=xhci
$pciaddr");
4343 my $d = parse_usb_device($device->{host});
4344 $d->{usb3} = $device->{usb3};
4347 vm_deviceplug($storecfg, $conf, $vmid, $deviceid, $d, $arch, $machine_type);
4350 sub qemu_cpu_hotplug {
4351 my ($vmid, $conf, $vcpus) = @_;
4353 my $machine_type = PVE::QemuServer::get_current_qemu_machine($vmid);
4356 $sockets = $conf->{smp} if $conf->{smp}; # old style - no longer iused
4357 $sockets = $conf->{sockets} if $conf->{sockets};
4358 my $cores = $conf->{cores} || 1;
4359 my $maxcpus = $sockets * $cores;
4361 $vcpus = $maxcpus if !$vcpus;
4363 die "you can
't add more vcpus than maxcpus\n"
4364 if $vcpus > $maxcpus;
4366 my $currentvcpus = $conf->{vcpus} || $maxcpus;
4368 if ($vcpus < $currentvcpus) {
4370 if (qemu_machine_feature_enabled ($machine_type, undef, 2, 7)) {
4372 for (my $i = $currentvcpus; $i > $vcpus; $i--) {
4373 qemu_devicedel($vmid, "cpu$i");
4375 my $currentrunningvcpus = undef;
4377 $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4378 last if scalar(@{$currentrunningvcpus}) == $i-1;
4379 raise_param_exc({ vcpus => "error unplugging cpu$i" }) if $retry > 5;
4383 #update conf after each succesfull cpu unplug
4384 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4385 PVE::QemuConfig->write_config($vmid, $conf);
4388 die "cpu hot-unplugging requires qemu version 2.7 or higher\n";
4394 my $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4395 die "vcpus in running vm does not match its configuration\n"
4396 if scalar(@{$currentrunningvcpus}) != $currentvcpus;
4398 if (qemu_machine_feature_enabled ($machine_type, undef, 2, 7)) {
4400 for (my $i = $currentvcpus+1; $i <= $vcpus; $i++) {
4401 my $cpustr = print_cpu_device($conf, $i);
4402 qemu_deviceadd($vmid, $cpustr);
4405 my $currentrunningvcpus = undef;
4407 $currentrunningvcpus = vm_mon_cmd($vmid, "query-cpus");
4408 last if scalar(@{$currentrunningvcpus}) == $i;
4409 raise_param_exc({ vcpus => "error hotplugging cpu$i" }) if $retry > 10;
4413 #update conf after each succesfull cpu hotplug
4414 $conf->{vcpus} = scalar(@{$currentrunningvcpus});
4415 PVE::QemuConfig->write_config($vmid, $conf);
4419 for (my $i = $currentvcpus; $i < $vcpus; $i++) {
4420 vm_mon_cmd($vmid, "cpu-add", id => int($i));
4425 sub qemu_block_set_io_throttle {
4426 my ($vmid, $deviceid,
4427 $bps, $bps_rd, $bps_wr, $iops, $iops_rd, $iops_wr,
4428 $bps_max, $bps_rd_max, $bps_wr_max, $iops_max, $iops_rd_max, $iops_wr_max,
4429 $bps_max_length, $bps_rd_max_length, $bps_wr_max_length,
4430 $iops_max_length, $iops_rd_max_length, $iops_wr_max_length) = @_;
4432 return if !check_running($vmid) ;
4434 vm_mon_cmd($vmid, "block_set_io_throttle", device => $deviceid,
4436 bps_rd => int($bps_rd),
4437 bps_wr => int($bps_wr),
4439 iops_rd => int($iops_rd),
4440 iops_wr => int($iops_wr),
4441 bps_max => int($bps_max),
4442 bps_rd_max => int($bps_rd_max),
4443 bps_wr_max => int($bps_wr_max),
4444 iops_max => int($iops_max),
4445 iops_rd_max => int($iops_rd_max),
4446 iops_wr_max => int($iops_wr_max),
4447 bps_max_length => int($bps_max_length),
4448 bps_rd_max_length => int($bps_rd_max_length),
4449 bps_wr_max_length => int($bps_wr_max_length),
4450 iops_max_length => int($iops_max_length),
4451 iops_rd_max_length => int($iops_rd_max_length),
4452 iops_wr_max_length => int($iops_wr_max_length),
4457 # old code, only used to shutdown old VM after update
4459 my ($fh, $timeout) = @_;
4461 my $sel = new IO::Select;
4468 while (scalar (@ready = $sel->can_read($timeout))) {
4470 if ($count = $fh->sysread($buf, 8192)) {
4471 if ($buf =~ /^(.*)\(qemu\) $/s) {
4478 if (!defined($count)) {
4485 die "monitor read timeout\n" if !scalar(@ready);
4490 sub qemu_block_resize {
4491 my ($vmid, $deviceid, $storecfg, $volid, $size) = @_;
4493 my $running = check_running($vmid);
4495 $size = 0 if !PVE::Storage::volume_resize($storecfg, $volid, $size, $running);
4497 return if !$running;
4499 vm_mon_cmd($vmid, "block_resize", device => $deviceid, size => int($size));
4503 sub qemu_volume_snapshot {
4504 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4506 my $running = check_running($vmid);
4508 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4509 vm_mon_cmd($vmid, 'blockdev-snapshot-internal-sync
', device => $deviceid, name => $snap);
4511 PVE::Storage::volume_snapshot($storecfg, $volid, $snap);
4515 sub qemu_volume_snapshot_delete {
4516 my ($vmid, $deviceid, $storecfg, $volid, $snap) = @_;
4518 my $running = check_running($vmid);
4523 my $conf = PVE::QemuConfig->load_config($vmid);
4524 foreach_drive($conf, sub {
4525 my ($ds, $drive) = @_;
4526 $running = 1 if $drive->{file} eq $volid;
4530 if ($running && do_snapshots_with_qemu($storecfg, $volid)){
4531 vm_mon_cmd($vmid, 'blockdev-snapshot-delete-internal-sync
', device => $deviceid, name => $snap);
4533 PVE::Storage::volume_snapshot_delete($storecfg, $volid, $snap, $running);
4537 sub set_migration_caps {
4543 "auto-converge" => 1,
4545 "x-rdma-pin-all" => 0,
4550 my $supported_capabilities = vm_mon_cmd_nocheck($vmid, "query-migrate-capabilities");
4552 for my $supported_capability (@$supported_capabilities) {
4554 capability => $supported_capability->{capability},
4555 state => $enabled_cap->{$supported_capability->{capability}} ? JSON::true : JSON::false,
4559 vm_mon_cmd_nocheck($vmid, "migrate-set-capabilities", capabilities => $cap_ref);
4562 my $fast_plug_option = {
4570 'vmstatestorage
' => 1,
4573 # hotplug changes in [PENDING]
4574 # $selection hash can be used to only apply specified options, for
4575 # example: { cores => 1 } (only apply changed 'cores
')
4576 # $errors ref is used to return error messages
4577 sub vmconfig_hotplug_pending {
4578 my ($vmid, $conf, $storecfg, $selection, $errors) = @_;
4580 my $defaults = load_defaults();
4581 my ($arch, $machine_type) = get_basic_machine_info($conf, undef);
4583 # commit values which do not have any impact on running VM first
4584 # Note: those option cannot raise errors, we we do not care about
4585 # $selection and always apply them.
4587 my $add_error = sub {
4588 my ($opt, $msg) = @_;
4589 $errors->{$opt} = "hotplug problem - $msg";
4593 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4594 if ($fast_plug_option->{$opt}) {
4595 $conf->{$opt} = $conf->{pending}->{$opt};
4596 delete $conf->{pending}->{$opt};
4602 PVE::QemuConfig->write_config($vmid, $conf);
4603 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4606 my $hotplug_features = parse_hotplug_features(defined($conf->{hotplug}) ? $conf->{hotplug} : '1');
4608 my $pending_delete_hash = split_flagged_list($conf->{pending}->{delete});
4609 while (my ($opt, $force) = each %$pending_delete_hash) {
4610 next if $selection && !$selection->{$opt};
4612 if ($opt eq 'hotplug
') {
4613 die "skip\n" if ($conf->{hotplug} =~ /memory/);
4614 } elsif ($opt eq 'tablet
') {
4615 die "skip\n" if !$hotplug_features->{usb};
4616 if ($defaults->{tablet}) {
4617 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4618 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4619 if $arch eq 'aarch64
';
4621 vm_deviceunplug($vmid, $conf, 'tablet
');
4622 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4624 } elsif ($opt =~ m/^usb\d+/) {
4626 # since we cannot reliably hot unplug usb devices
4627 # we are disabling it
4628 die "skip\n" if !$hotplug_features->{usb} || $conf->{$opt} =~ m/spice/i;
4629 vm_deviceunplug($vmid, $conf, $opt);
4630 } elsif ($opt eq 'vcpus
') {
4631 die "skip\n" if !$hotplug_features->{cpu};
4632 qemu_cpu_hotplug($vmid, $conf, undef);
4633 } elsif ($opt eq 'balloon
') {
4634 # enable balloon device is not hotpluggable
4635 die "skip\n" if defined($conf->{balloon}) && $conf->{balloon} == 0;
4636 # here we reset the ballooning value to memory
4637 my $balloon = $conf->{memory} || $defaults->{memory};
4638 vm_mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4639 } elsif ($fast_plug_option->{$opt}) {
4641 } elsif ($opt =~ m/^net(\d+)$/) {
4642 die "skip\n" if !$hotplug_features->{network};
4643 vm_deviceunplug($vmid, $conf, $opt);
4644 } elsif (is_valid_drivename($opt)) {
4645 die "skip\n" if !$hotplug_features->{disk} || $opt =~ m/(ide|sata)(\d+)/;
4646 vm_deviceunplug($vmid, $conf, $opt);
4647 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4648 } elsif ($opt =~ m/^memory$/) {
4649 die "skip\n" if !$hotplug_features->{memory};
4650 PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt);
4651 } elsif ($opt eq 'cpuunits
') {
4652 cgroups_write("cpu", $vmid, "cpu.shares", $defaults->{cpuunits});
4653 } elsif ($opt eq 'cpulimit
') {
4654 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", -1);
4660 &$add_error($opt, $err) if $err ne "skip\n";
4662 # save new config if hotplug was successful
4663 delete $conf->{$opt};
4664 vmconfig_undelete_pending_option($conf, $opt);
4665 PVE::QemuConfig->write_config($vmid, $conf);
4666 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4670 my $apply_pending_cloudinit;
4671 $apply_pending_cloudinit = sub {
4672 my ($key, $value) = @_;
4673 $apply_pending_cloudinit = sub {}; # once is enough
4675 my @cloudinit_opts = keys %$confdesc_cloudinit;
4676 foreach my $opt (keys %{$conf->{pending}}) {
4677 next if !grep { $_ eq $opt } @cloudinit_opts;
4678 $conf->{$opt} = delete $conf->{pending}->{$opt};
4681 my $new_conf = { %$conf };
4682 $new_conf->{$key} = $value;
4683 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($new_conf, $vmid);
4686 foreach my $opt (keys %{$conf->{pending}}) {
4687 next if $selection && !$selection->{$opt};
4688 my $value = $conf->{pending}->{$opt};
4690 if ($opt eq 'hotplug
') {
4691 die "skip\n" if ($value =~ /memory/) || ($value !~ /memory/ && $conf->{hotplug} =~ /memory/);
4692 } elsif ($opt eq 'tablet
') {
4693 die "skip\n" if !$hotplug_features->{usb};
4695 vm_deviceplug($storecfg, $conf, $vmid, 'tablet
', $arch, $machine_type);
4696 vm_deviceplug($storecfg, $conf, $vmid, 'keyboard
', $arch, $machine_type)
4697 if $arch eq 'aarch64
';
4698 } elsif ($value == 0) {
4699 vm_deviceunplug($vmid, $conf, 'tablet
');
4700 vm_deviceunplug($vmid, $conf, 'keyboard
') if $arch eq 'aarch64
';
4702 } elsif ($opt =~ m/^usb\d+$/) {
4704 # since we cannot reliably hot unplug usb devices
4705 # we are disabling it
4706 die "skip\n" if !$hotplug_features->{usb} || $value =~ m/spice/i;
4707 my $d = eval { PVE::JSONSchema::parse_property_string($usbdesc->{format}, $value) };
4708 die "skip\n" if !$d;
4709 qemu_usb_hotplug($storecfg, $conf, $vmid, $opt, $d, $arch, $machine_type);
4710 } elsif ($opt eq 'vcpus
') {
4711 die "skip\n" if !$hotplug_features->{cpu};
4712 qemu_cpu_hotplug($vmid, $conf, $value);
4713 } elsif ($opt eq 'balloon
') {
4714 # enable/disable balloning device is not hotpluggable
4715 my $old_balloon_enabled = !!(!defined($conf->{balloon}) || $conf->{balloon});
4716 my $new_balloon_enabled = !!(!defined($conf->{pending}->{balloon}) || $conf->{pending}->{balloon});
4717 die "skip\n" if $old_balloon_enabled != $new_balloon_enabled;
4719 # allow manual ballooning if shares is set to zero
4720 if ((defined($conf->{shares}) && ($conf->{shares} == 0))) {
4721 my $balloon = $conf->{pending}->{balloon} || $conf->{memory} || $defaults->{memory};
4722 vm_mon_cmd($vmid, "balloon", value => $balloon*1024*1024);
4724 } elsif ($opt =~ m/^net(\d+)$/) {
4725 # some changes can be done without hotplug
4726 vmconfig_update_net($storecfg, $conf, $hotplug_features->{network},
4727 $vmid, $opt, $value, $arch, $machine_type);
4728 } elsif (is_valid_drivename($opt)) {
4729 # some changes can be done without hotplug
4730 my $drive = parse_drive($opt, $value);
4731 if (drive_is_cloudinit($drive)) {
4732 &$apply_pending_cloudinit($opt, $value);
4734 vmconfig_update_disk($storecfg, $conf, $hotplug_features->{disk},
4735 $vmid, $opt, $value, 1, $arch, $machine_type);
4736 } elsif ($opt =~ m/^memory$/) { #dimms
4737 die "skip\n" if !$hotplug_features->{memory};
4738 $value = PVE::QemuServer::Memory::qemu_memory_hotplug($vmid, $conf, $defaults, $opt, $value);
4739 } elsif ($opt eq 'cpuunits
') {
4740 cgroups_write("cpu", $vmid, "cpu.shares", $conf->{pending}->{$opt});
4741 } elsif ($opt eq 'cpulimit
') {
4742 my $cpulimit = $conf->{pending}->{$opt} == 0 ? -1 : int($conf->{pending}->{$opt} * 100000);
4743 cgroups_write("cpu", $vmid, "cpu.cfs_quota_us", $cpulimit);
4745 die "skip\n"; # skip non-hot-pluggable options
4749 &$add_error($opt, $err) if $err ne "skip\n";
4751 # save new config if hotplug was successful
4752 $conf->{$opt} = $value;
4753 delete $conf->{pending}->{$opt};
4754 PVE::QemuConfig->write_config($vmid, $conf);
4755 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4760 sub try_deallocate_drive {
4761 my ($storecfg, $vmid, $conf, $key, $drive, $rpcenv, $authuser, $force) = @_;
4763 if (($force || $key =~ /^unused/) && !drive_is_cdrom($drive, 1)) {
4764 my $volid = $drive->{file};
4765 if (vm_is_volid_owner($storecfg, $vmid, $volid)) {
4766 my $sid = PVE::Storage::parse_volume_id($volid);
4767 $rpcenv->check($authuser, "/storage/$sid", ['Datastore
.AllocateSpace
']);
4769 # check if the disk is really unused
4770 die "unable to delete '$volid' - volume is still in use (snapshot?)\n"
4771 if is_volume_in_use($storecfg, $conf, $key, $volid);
4772 PVE::Storage::vdisk_free($storecfg, $volid);
4775 # If vm is not owner of this disk remove from config
4783 sub vmconfig_delete_or_detach_drive {
4784 my ($vmid, $storecfg, $conf, $opt, $force) = @_;
4786 my $drive = parse_drive($opt, $conf->{$opt});
4788 my $rpcenv = PVE::RPCEnvironment::get();
4789 my $authuser = $rpcenv->get_user();
4792 $rpcenv->check_vm_perm($authuser, $vmid, undef, ['VM
.Config
.Disk
']);
4793 try_deallocate_drive($storecfg, $vmid, $conf, $opt, $drive, $rpcenv, $authuser, $force);
4795 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $drive);
4799 sub vmconfig_apply_pending {
4800 my ($vmid, $conf, $storecfg) = @_;
4804 my $pending_delete_hash = split_flagged_list($conf->{pending}->{delete});
4805 while (my ($opt, $force) = each %$pending_delete_hash) {
4806 die "internal error" if $opt =~ m/^unused/;
4807 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4808 if (!defined($conf->{$opt})) {
4809 vmconfig_undelete_pending_option($conf, $opt);
4810 PVE::QemuConfig->write_config($vmid, $conf);
4811 } elsif (is_valid_drivename($opt)) {
4812 vmconfig_delete_or_detach_drive($vmid, $storecfg, $conf, $opt, $force);
4813 vmconfig_undelete_pending_option($conf, $opt);
4814 delete $conf->{$opt};
4815 PVE::QemuConfig->write_config($vmid, $conf);
4817 vmconfig_undelete_pending_option($conf, $opt);
4818 delete $conf->{$opt};
4819 PVE::QemuConfig->write_config($vmid, $conf);
4823 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4825 foreach my $opt (keys %{$conf->{pending}}) { # add/change
4826 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
4828 if (defined($conf->{$opt}) && ($conf->{$opt} eq $conf->{pending}->{$opt})) {
4829 # skip if nothing changed
4830 } elsif (is_valid_drivename($opt)) {
4831 vmconfig_register_unused_drive($storecfg, $vmid, $conf, parse_drive($opt, $conf->{$opt}))
4832 if defined($conf->{$opt});
4833 $conf->{$opt} = $conf->{pending}->{$opt};
4835 $conf->{$opt} = $conf->{pending}->{$opt};
4838 delete $conf->{pending}->{$opt};
4839 PVE::QemuConfig->write_config($vmid, $conf);
4843 my $safe_num_ne = sub {
4846 return 0 if !defined($a) && !defined($b);
4847 return 1 if !defined($a);
4848 return 1 if !defined($b);
4853 my $safe_string_ne = sub {
4856 return 0 if !defined($a) && !defined($b);
4857 return 1 if !defined($a);
4858 return 1 if !defined($b);
4863 sub vmconfig_update_net {
4864 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $arch, $machine_type) = @_;
4866 my $newnet = parse_net($value);
4868 if ($conf->{$opt}) {
4869 my $oldnet = parse_net($conf->{$opt});
4871 if (&$safe_string_ne($oldnet->{model}, $newnet->{model}) ||
4872 &$safe_string_ne($oldnet->{macaddr}, $newnet->{macaddr}) ||
4873 &$safe_num_ne($oldnet->{queues}, $newnet->{queues}) ||
4874 !($newnet->{bridge} && $oldnet->{bridge})) { # bridge/nat mode change
4876 # for non online change, we try to hot-unplug
4877 die "skip\n" if !$hotplug;
4878 vm_deviceunplug($vmid, $conf, $opt);
4881 die "internal error" if $opt !~ m/net(\d+)/;
4882 my $iface = "tap${vmid}i$1";
4884 if (&$safe_string_ne($oldnet->{bridge}, $newnet->{bridge}) ||
4885 &$safe_num_ne($oldnet->{tag}, $newnet->{tag}) ||
4886 &$safe_string_ne($oldnet->{trunks}, $newnet->{trunks}) ||
4887 &$safe_num_ne($oldnet->{firewall}, $newnet->{firewall})) {
4888 PVE::Network::tap_unplug($iface);
4889 PVE::Network::tap_plug($iface, $newnet->{bridge}, $newnet->{tag}, $newnet->{firewall}, $newnet->{trunks}, $newnet->{rate});
4890 } elsif (&$safe_num_ne($oldnet->{rate}, $newnet->{rate})) {
4891 # Rate can be applied on its own but any change above needs to
4892 # include the rate in tap_plug since OVS resets everything.
4893 PVE::Network::tap_rate_limit($iface, $newnet->{rate});
4896 if (&$safe_string_ne($oldnet->{link_down}, $newnet->{link_down})) {
4897 qemu_set_link_status($vmid, $opt, !$newnet->{link_down});
4905 vm_deviceplug($storecfg, $conf, $vmid, $opt, $newnet, $arch, $machine_type);
4911 sub vmconfig_update_disk {
4912 my ($storecfg, $conf, $hotplug, $vmid, $opt, $value, $force, $arch, $machine_type) = @_;
4914 # fixme: do we need force?
4916 my $drive = parse_drive($opt, $value);
4918 if ($conf->{$opt}) {
4920 if (my $old_drive = parse_drive($opt, $conf->{$opt})) {
4922 my $media = $drive->{media} || 'disk
';
4923 my $oldmedia = $old_drive->{media} || 'disk
';
4924 die "unable to change media type\n" if $media ne $oldmedia;
4926 if (!drive_is_cdrom($old_drive)) {
4928 if ($drive->{file} ne $old_drive->{file}) {
4930 die "skip\n" if !$hotplug;
4932 # unplug and register as unused
4933 vm_deviceunplug($vmid, $conf, $opt);
4934 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive)
4937 # update existing disk
4939 # skip non hotpluggable value
4940 if (&$safe_string_ne($drive->{discard}, $old_drive->{discard}) ||
4941 &$safe_string_ne($drive->{iothread}, $old_drive->{iothread}) ||
4942 &$safe_string_ne($drive->{queues}, $old_drive->{queues}) ||
4943 &$safe_string_ne($drive->{cache}, $old_drive->{cache})) {
4948 if (&$safe_num_ne($drive->{mbps}, $old_drive->{mbps}) ||
4949 &$safe_num_ne($drive->{mbps_rd}, $old_drive->{mbps_rd}) ||
4950 &$safe_num_ne($drive->{mbps_wr}, $old_drive->{mbps_wr}) ||
4951 &$safe_num_ne($drive->{iops}, $old_drive->{iops}) ||
4952 &$safe_num_ne($drive->{iops_rd}, $old_drive->{iops_rd}) ||
4953 &$safe_num_ne($drive->{iops_wr}, $old_drive->{iops_wr}) ||
4954 &$safe_num_ne($drive->{mbps_max}, $old_drive->{mbps_max}) ||
4955 &$safe_num_ne($drive->{mbps_rd_max}, $old_drive->{mbps_rd_max}) ||
4956 &$safe_num_ne($drive->{mbps_wr_max}, $old_drive->{mbps_wr_max}) ||
4957 &$safe_num_ne($drive->{iops_max}, $old_drive->{iops_max}) ||
4958 &$safe_num_ne($drive->{iops_rd_max}, $old_drive->{iops_rd_max}) ||
4959 &$safe_num_ne($drive->{iops_wr_max}, $old_drive->{iops_wr_max}) ||
4960 &$safe_num_ne($drive->{bps_max_length}, $old_drive->{bps_max_length}) ||
4961 &$safe_num_ne($drive->{bps_rd_max_length}, $old_drive->{bps_rd_max_length}) ||
4962 &$safe_num_ne($drive->{bps_wr_max_length}, $old_drive->{bps_wr_max_length}) ||
4963 &$safe_num_ne($drive->{iops_max_length}, $old_drive->{iops_max_length}) ||
4964 &$safe_num_ne($drive->{iops_rd_max_length}, $old_drive->{iops_rd_max_length}) ||
4965 &$safe_num_ne($drive->{iops_wr_max_length}, $old_drive->{iops_wr_max_length})) {
4967 qemu_block_set_io_throttle($vmid,"drive-$opt",
4968 ($drive->{mbps} || 0)*1024*1024,
4969 ($drive->{mbps_rd} || 0)*1024*1024,
4970 ($drive->{mbps_wr} || 0)*1024*1024,
4971 $drive->{iops} || 0,
4972 $drive->{iops_rd} || 0,
4973 $drive->{iops_wr} || 0,
4974 ($drive->{mbps_max} || 0)*1024*1024,
4975 ($drive->{mbps_rd_max} || 0)*1024*1024,
4976 ($drive->{mbps_wr_max} || 0)*1024*1024,
4977 $drive->{iops_max} || 0,
4978 $drive->{iops_rd_max} || 0,
4979 $drive->{iops_wr_max} || 0,
4980 $drive->{bps_max_length} || 1,
4981 $drive->{bps_rd_max_length} || 1,
4982 $drive->{bps_wr_max_length} || 1,
4983 $drive->{iops_max_length} || 1,
4984 $drive->{iops_rd_max_length} || 1,
4985 $drive->{iops_wr_max_length} || 1);
4994 if ($drive->{file} eq 'none
') {
4995 vm_mon_cmd($vmid, "eject",force => JSON::true,device => "drive-$opt");
4996 if (drive_is_cloudinit($old_drive)) {
4997 vmconfig_register_unused_drive($storecfg, $vmid, $conf, $old_drive);
5000 my $path = get_iso_path($storecfg, $vmid, $drive->{file});
5001 vm_mon_cmd($vmid, "eject", force => JSON::true,device => "drive-$opt"); # force eject if locked
5002 vm_mon_cmd($vmid, "change", device => "drive-$opt",target => "$path") if $path;
5010 die "skip\n" if !$hotplug || $opt =~ m/(ide|sata)(\d+)/;
5012 PVE::Storage::activate_volumes($storecfg, [$drive->{file}]) if $drive->{file} !~ m|^/dev/.+|;
5013 vm_deviceplug($storecfg, $conf, $vmid, $opt, $drive, $arch, $machine_type);
5017 my ($storecfg, $vmid, $statefile, $skiplock, $migratedfrom, $paused,
5018 $forcemachine, $spice_ticket, $migration_network, $migration_type, $targetstorage) = @_;
5020 PVE::QemuConfig->lock_config($vmid, sub {
5021 my $conf = PVE::QemuConfig->load_config($vmid, $migratedfrom);
5023 die "you can't start a vm
if it
's a template\n" if PVE::QemuConfig->is_template($conf);
5025 PVE::QemuConfig->check_lock($conf) if !$skiplock;
5027 die "VM $vmid already running\n" if check_running($vmid, undef, $migratedfrom);
5029 if (!$statefile && scalar(keys %{$conf->{pending}})) {
5030 vmconfig_apply_pending($vmid, $conf, $storecfg);
5031 $conf = PVE::QemuConfig->load_config($vmid); # update/reload
5034 PVE::QemuServer::Cloudinit::generate_cloudinitconfig($conf, $vmid);
5036 my $defaults = load_defaults();
5038 # set environment variable useful inside network script
5039 $ENV{PVE_MIGRATED_FROM} = $migratedfrom if $migratedfrom;
5041 my $local_volumes = {};
5043 if ($targetstorage) {
5044 foreach_drive($conf, sub {
5045 my ($ds, $drive) = @_;
5047 return if drive_is_cdrom($drive);
5049 my $volid = $drive->{file};
5053 my ($storeid, $volname) = PVE::Storage::parse_volume_id($volid);
5055 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5056 return if $scfg->{shared};
5057 $local_volumes->{$ds} = [$volid, $storeid, $volname];
5062 foreach my $opt (sort keys %$local_volumes) {
5064 my ($volid, $storeid, $volname) = @{$local_volumes->{$opt}};
5065 my $drive = parse_drive($opt, $conf->{$opt});
5067 #if remote storage is specified, use default format
5068 if ($targetstorage && $targetstorage ne "1") {
5069 $storeid = $targetstorage;
5070 my ($defFormat, $validFormats) = PVE::Storage::storage_default_format($storecfg, $storeid);
5071 $format = $defFormat;
5073 #else we use same format than original
5074 my $scfg = PVE::Storage::storage_config($storecfg, $storeid);
5075 $format = qemu_img_format($scfg, $volid);
5078 my $newvolid = PVE::Storage::vdisk_alloc($storecfg, $storeid, $vmid, $format, undef, ($drive->{size}/1024));
5079 my $newdrive = $drive;
5080 $newdrive->{format} = $format;
5081 $newdrive->{file} = $newvolid;
5082 my $drivestr = PVE::QemuServer::print_drive($vmid, $newdrive);
5083 $local_volumes->{$opt} = $drivestr;
5084 #pass drive to conf for command line
5085 $conf->{$opt} = $drivestr;
5089 my ($cmd, $vollist, $spice_port) = config_to_command($storecfg, $vmid, $conf, $defaults, $forcemachine);
5091 my $migrate_port = 0;
5094 if ($statefile eq 'tcp
') {
5095 my $localip = "localhost";
5096 my $datacenterconf = PVE::Cluster::cfs_read_file('datacenter
.cfg
');
5097 my $nodename = PVE::INotify::nodename();
5099 if (!defined($migration_type)) {
5100 if (defined($datacenterconf->{migration}->{type})) {
5101 $migration_type = $datacenterconf->{migration}->{type};
5103 $migration_type = 'secure
';
5107 if ($migration_type eq 'insecure
') {
5108 my $migrate_network_addr = PVE::Cluster::get_local_migration_ip($migration_network);
5109 if ($migrate_network_addr) {
5110 $localip = $migrate_network_addr;
5112 $localip = PVE::Cluster::remote_node_ip($nodename, 1);
5115 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5118 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5119 $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5120 $migrate_uri = "tcp:${localip}:${migrate_port}";
5121 push @$cmd, '-incoming
', $migrate_uri;
5124 } elsif ($statefile eq 'unix
') {
5125 # should be default for secure migrations as a ssh TCP forward
5126 # tunnel is not deterministic reliable ready and fails regurarly
5127 # to set up in time, so use UNIX socket forwards
5128 my $socket_addr = "/run/qemu-server/$vmid.migrate";
5129 unlink $socket_addr;
5131 $migrate_uri = "unix:$socket_addr";
5133 push @$cmd, '-incoming
', $migrate_uri;
5137 push @$cmd, '-loadstate
', $statefile;
5144 for (my $i = 0; $i < $MAX_HOSTPCI_DEVICES; $i++) {
5145 my $d = parse_hostpci($conf->{"hostpci$i"});
5147 my $pcidevices = $d->{pciid};
5148 foreach my $pcidevice (@$pcidevices) {
5149 my $pciid = $pcidevice->{id}.".".$pcidevice->{function};
5151 my $info = pci_device_info("0000:$pciid");
5152 die "IOMMU not present\n" if !check_iommu_support();
5153 die "no pci device info for device '$pciid'\n" if !$info;
5154 die "can't unbind
/bind pci group to vfio
'$pciid'\n" if !pci_dev_group_bind_to_vfio($pciid);
5155 die "can
't reset pci device '$pciid'\n" if $info->{has_fl_reset} and !pci_dev_reset($info);
5159 PVE::Storage::activate_volumes($storecfg, $vollist);
5161 if (!check_running($vmid, 1)) {
5163 run_command(['/bin/systemctl
', 'stop
', "$vmid.scope"],
5164 outfunc => sub {}, errfunc => sub {});
5168 my $cpuunits = defined($conf->{cpuunits}) ? $conf->{cpuunits}
5169 : $defaults->{cpuunits};
5171 my $start_timeout = $conf->{hugepages} ? 300 : 30;
5172 my %run_params = (timeout => $statefile ? undef : $start_timeout, umask => 0077);
5175 Slice => 'qemu
.slice
',
5177 CPUShares => $cpuunits
5180 if (my $cpulimit = $conf->{cpulimit}) {
5181 $properties{CPUQuota} = int($cpulimit * 100);
5183 $properties{timeout} = 10 if $statefile; # setting up the scope shoul be quick
5185 my $run_qemu = sub {
5186 PVE::Tools::run_fork sub {
5187 PVE::Systemd::enter_systemd_scope($vmid, "Proxmox VE VM $vmid", %properties);
5188 run_command($cmd, %run_params);
5192 if ($conf->{hugepages}) {
5195 my $hugepages_topology = PVE::QemuServer::Memory::hugepages_topology($conf);
5196 my $hugepages_host_topology = PVE::QemuServer::Memory::hugepages_host_topology();
5198 PVE::QemuServer::Memory::hugepages_mount();
5199 PVE::QemuServer::Memory::hugepages_allocate($hugepages_topology, $hugepages_host_topology);
5201 eval { $run_qemu->() };
5203 PVE::QemuServer::Memory::hugepages_reset($hugepages_host_topology);
5207 PVE::QemuServer::Memory::hugepages_pre_deallocate($hugepages_topology);
5209 eval { PVE::QemuServer::Memory::hugepages_update_locked($code); };
5212 eval { $run_qemu->() };
5216 # deactivate volumes if start fails
5217 eval { PVE::Storage::deactivate_volumes($storecfg, $vollist); };
5218 die "start failed: $err";
5221 print "migration listens on $migrate_uri\n" if $migrate_uri;
5223 if ($statefile && $statefile ne 'tcp
' && $statefile ne 'unix
') {
5224 eval { vm_mon_cmd_nocheck($vmid, "cont"); };
5228 #start nbd server for storage migration
5229 if ($targetstorage) {
5230 my $nodename = PVE::INotify::nodename();
5231 my $migrate_network_addr = PVE::Cluster::get_local_migration_ip($migration_network);
5232 my $localip = $migrate_network_addr ? $migrate_network_addr : PVE::Cluster::remote_node_ip($nodename, 1);
5233 my $pfamily = PVE::Tools::get_host_address_family($nodename);
5234 $migrate_port = PVE::Tools::next_migrate_port($pfamily);
5236 vm_mon_cmd_nocheck($vmid, "nbd-server-start", addr => { type => 'inet
', data => { host => "${localip}", port => "${migrate_port}" } } );
5238 $localip = "[$localip]" if Net::IP::ip_is_ipv6($localip);
5240 foreach my $opt (sort keys %$local_volumes) {
5241 my $volid = $local_volumes->{$opt};
5242 vm_mon_cmd_nocheck($vmid, "nbd-server-add", device => "drive-$opt", writable => JSON::true );
5243 my $migrate_storage_uri = "nbd:${localip}:${migrate_port}:exportname=drive-$opt";
5244 print "storage migration listens on $migrate_storage_uri volume:$volid\n";
5248 if ($migratedfrom) {
5250 set_migration_caps($vmid);
5255 print "spice listens on port $spice_port\n";
5256 if ($spice_ticket) {
5257 vm_mon_cmd_nocheck($vmid, "set_password", protocol => 'spice
', password => $spice_ticket);
5258 vm_mon_cmd_nocheck($vmid, "expire_password", protocol => 'spice
', time => "+30");
5263 vm_mon_cmd_nocheck($vmid, "balloon", value => $conf->{balloon}*1024*1024)
5264 if !$statefile && $conf->{balloon};
5266 foreach my $opt (keys %$conf) {
5267 next if $opt !~ m/^net\d+$/;
5268 my $nicconf = parse_net($conf->{$opt});
5269 qemu_set_link_status($vmid, $opt, 0) if $nicconf->{link_down};
5273 vm_mon_cmd_nocheck($vmid, 'qom-set
',
5274 path => "machine/peripheral/balloon0",
5275 property => "guest-stats-polling-interval",
5276 value => 2) if (!defined($conf->{balloon}) || $conf->{balloon});
5282 my ($vmid, $execute, %params) = @_;
5284 my $cmd = { execute => $execute, arguments => \%params };
5285 vm_qmp_command($vmid, $cmd);
5288 sub vm_mon_cmd_nocheck {
5289 my ($vmid, $execute, %params) = @_;
5291 my $cmd = { execute => $execute, arguments => \%params };
5292 vm_qmp_command($vmid, $cmd, 1);
5295 sub vm_qmp_command {
5296 my ($vmid, $cmd, $nocheck) = @_;
5301 if ($cmd->{arguments} && $cmd->{arguments}->{timeout}) {
5302 $timeout = $cmd->{arguments}->{timeout};
5303 delete $cmd->{arguments}->{timeout};
5307 die "VM $vmid not running\n" if !check_running($vmid, $nocheck);
5308 my $sname = qmp_socket($vmid);
5309 if (-e $sname) { # test if VM is reasonambe new and supports qmp/qga
5310 my $qmpclient = PVE::QMPClient->new();
5312 $res = $qmpclient->cmd($vmid, $cmd, $timeout);
5314 die "unable to open monitor socket\n";
5318 syslog("err", "VM $vmid qmp command failed - $err");
5325 sub vm_human_monitor_command {
5326 my ($vmid, $cmdline) = @_;
5331 execute => 'human-monitor-command
',
5332 arguments => { 'command-line
' => $cmdline},
5335 return vm_qmp_command($vmid, $cmd);
5338 sub vm_commandline {
5339 my ($storecfg, $vmid) = @_;
5341 my $conf = PVE::QemuConfig->load_config($vmid);
5343 my $defaults = load_defaults();
5345 my $cmd = config_to_command($storecfg, $vmid, $conf, $defaults);
5347 return PVE::Tools::cmd2string($cmd);
5351 my ($vmid, $skiplock) = @_;
5353 PVE::QemuConfig->lock_config($vmid, sub {
5355 my $conf = PVE::QemuConfig->load_config($vmid);
5357 PVE::QemuConfig->check_lock($conf) if !$skiplock;
5359 vm_mon_cmd($vmid, "system_reset");
5363 sub get_vm_volumes {
5367 foreach_volid($conf, sub {
5368 my ($volid, $attr) = @_;
5370 return if $volid =~ m|^/|;
5372 my ($sid, $volname) = PVE::Storage::parse_volume_id($volid, 1);
5375 push @$vollist, $volid;
5381 sub vm_stop_cleanup {
5382 my ($storecfg, $vmid, $conf, $keepActive, $apply_pending_changes) = @_;
5387 my $vollist = get_vm_volumes($conf);
5388 PVE::Storage::deactivate_volumes($storecfg, $vollist);
5391 foreach my $ext (qw(mon qmp pid vnc qga)) {
5392 unlink "/var/run/qemu-server/${vmid}.$ext";
5395 vmconfig_apply_pending
($vmid, $conf, $storecfg) if $apply_pending_changes;
5397 warn $@ if $@; # avoid errors - just warn
5400 # Note: use $nockeck to skip tests if VM configuration file exists.
5401 # We need that when migration VMs to other nodes (files already moved)
5402 # Note: we set $keepActive in vzdump stop mode - volumes need to stay active
5404 my ($storecfg, $vmid, $skiplock, $nocheck, $timeout, $shutdown, $force, $keepActive, $migratedfrom) = @_;
5406 $force = 1 if !defined($force) && !$shutdown;
5409 my $pid = check_running
($vmid, $nocheck, $migratedfrom);
5410 kill 15, $pid if $pid;
5411 my $conf = PVE
::QemuConfig-
>load_config($vmid, $migratedfrom);
5412 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 0);
5416 PVE
::QemuConfig-
>lock_config($vmid, sub {
5418 my $pid = check_running
($vmid, $nocheck);
5423 $conf = PVE
::QemuConfig-
>load_config($vmid);
5424 PVE
::QemuConfig-
>check_lock($conf) if !$skiplock;
5425 if (!defined($timeout) && $shutdown && $conf->{startup
}) {
5426 my $opts = PVE
::JSONSchema
::pve_parse_startup_order
($conf->{startup
});
5427 $timeout = $opts->{down
} if $opts->{down
};
5431 $timeout = 60 if !defined($timeout);
5435 if (defined($conf) && parse_guest_agent
($conf)->{enabled
}) {
5436 vm_qmp_command
($vmid, { execute
=> "guest-shutdown" }, $nocheck);
5438 vm_qmp_command
($vmid, { execute
=> "system_powerdown" }, $nocheck);
5441 vm_qmp_command
($vmid, { execute
=> "quit" }, $nocheck);
5448 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5453 if ($count >= $timeout) {
5455 warn "VM still running - terminating now with SIGTERM\n";
5458 die "VM quit/powerdown failed - got timeout\n";
5461 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5466 warn "VM quit/powerdown failed - terminating now with SIGTERM\n";
5469 die "VM quit/powerdown failed\n";
5477 while (($count < $timeout) && check_running
($vmid, $nocheck)) {
5482 if ($count >= $timeout) {
5483 warn "VM still running - terminating now with SIGKILL\n";
5488 vm_stop_cleanup
($storecfg, $vmid, $conf, $keepActive, 1) if $conf;
5493 my ($vmid, $skiplock) = @_;
5495 PVE
::QemuConfig-
>lock_config($vmid, sub {
5497 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5499 PVE
::QemuConfig-
>check_lock($conf)
5500 if !($skiplock || PVE
::QemuConfig-
>has_lock($conf, 'backup'));
5502 vm_mon_cmd
($vmid, "stop");
5507 my ($vmid, $skiplock, $nocheck) = @_;
5509 PVE
::QemuConfig-
>lock_config($vmid, sub {
5511 my $res = vm_mon_cmd
($vmid, 'query-status');
5512 my $resume_cmd = 'cont';
5514 if ($res->{status
} && $res->{status
} eq 'suspended') {
5515 $resume_cmd = 'system_wakeup';
5520 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5522 PVE
::QemuConfig-
>check_lock($conf)
5523 if !($skiplock || PVE
::QemuConfig-
>has_lock($conf, 'backup'));
5525 vm_mon_cmd
($vmid, $resume_cmd);
5528 vm_mon_cmd_nocheck
($vmid, $resume_cmd);
5534 my ($vmid, $skiplock, $key) = @_;
5536 PVE
::QemuConfig-
>lock_config($vmid, sub {
5538 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5540 # there is no qmp command, so we use the human monitor command
5541 vm_human_monitor_command
($vmid, "sendkey $key");
5546 my ($storecfg, $vmid, $skiplock) = @_;
5548 PVE
::QemuConfig-
>lock_config($vmid, sub {
5550 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5552 if (!check_running
($vmid)) {
5553 destroy_vm
($storecfg, $vmid, undef, $skiplock);
5555 die "VM $vmid is running - destroy failed\n";
5563 my ($filename, $buf) = @_;
5565 my $fh = IO
::File-
>new($filename, "w");
5566 return undef if !$fh;
5568 my $res = print $fh $buf;
5575 sub pci_device_info
{
5580 return undef if $name !~ m/^([a-f0-9]{4}):([a-f0-9]{2}):([a-f0-9]{2})\.([a-f0-9])$/;
5581 my ($domain, $bus, $slot, $func) = ($1, $2, $3, $4);
5583 my $irq = file_read_firstline
("$pcisysfs/devices/$name/irq");
5584 return undef if !defined($irq) || $irq !~ m/^\d+$/;
5586 my $vendor = file_read_firstline
("$pcisysfs/devices/$name/vendor");
5587 return undef if !defined($vendor) || $vendor !~ s/^0x//;
5589 my $product = file_read_firstline
("$pcisysfs/devices/$name/device");
5590 return undef if !defined($product) || $product !~ s/^0x//;
5595 product
=> $product,
5601 has_fl_reset
=> -f
"$pcisysfs/devices/$name/reset" || 0,
5610 my $name = $dev->{name
};
5612 my $fn = "$pcisysfs/devices/$name/reset";
5614 return file_write
($fn, "1");
5617 sub pci_dev_bind_to_vfio
{
5620 my $name = $dev->{name
};
5622 my $vfio_basedir = "$pcisysfs/drivers/vfio-pci";
5624 if (!-d
$vfio_basedir) {
5625 system("/sbin/modprobe vfio-pci >/dev/null 2>/dev/null");
5627 die "Cannot find vfio-pci module!\n" if !-d
$vfio_basedir;
5629 my $testdir = "$vfio_basedir/$name";
5630 return 1 if -d
$testdir;
5632 my $data = "$dev->{vendor} $dev->{product}";
5633 return undef if !file_write
("$vfio_basedir/new_id", $data);
5635 my $fn = "$pcisysfs/devices/$name/driver/unbind";
5636 if (!file_write
($fn, $name)) {
5637 return undef if -f
$fn;
5640 $fn = "$vfio_basedir/bind";
5641 if (! -d
$testdir) {
5642 return undef if !file_write
($fn, $name);
5648 sub pci_dev_group_bind_to_vfio
{
5651 my $vfio_basedir = "$pcisysfs/drivers/vfio-pci";
5653 if (!-d
$vfio_basedir) {
5654 system("/sbin/modprobe vfio-pci >/dev/null 2>/dev/null");
5656 die "Cannot find vfio-pci module!\n" if !-d
$vfio_basedir;
5658 # get IOMMU group devices
5659 opendir(my $D, "$pcisysfs/devices/0000:$pciid/iommu_group/devices/") || die "Cannot open iommu_group: $!\n";
5660 my @devs = grep /^0000:/, readdir($D);
5663 foreach my $pciid (@devs) {
5664 $pciid =~ m/^([:\.\da-f]+)$/ or die "PCI ID $pciid not valid!\n";
5666 # pci bridges, switches or root ports are not supported
5667 # they have a pci_bus subdirectory so skip them
5668 next if (-e
"$pcisysfs/devices/$pciid/pci_bus");
5670 my $info = pci_device_info
($1);
5671 pci_dev_bind_to_vfio
($info) || die "Cannot bind $pciid to vfio\n";
5677 # vzdump restore implementaion
5679 sub tar_archive_read_firstfile
{
5680 my $archive = shift;
5682 die "ERROR: file '$archive' does not exist\n" if ! -f
$archive;
5684 # try to detect archive type first
5685 my $pid = open (my $fh, '-|', 'tar', 'tf', $archive) ||
5686 die "unable to open file '$archive'\n";
5687 my $firstfile = <$fh>;
5691 die "ERROR: archive contaions no data\n" if !$firstfile;
5697 sub tar_restore_cleanup
{
5698 my ($storecfg, $statfile) = @_;
5700 print STDERR
"starting cleanup\n";
5702 if (my $fd = IO
::File-
>new($statfile, "r")) {
5703 while (defined(my $line = <$fd>)) {
5704 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
5707 if ($volid =~ m
|^/|) {
5708 unlink $volid || die 'unlink failed\n';
5710 PVE
::Storage
::vdisk_free
($storecfg, $volid);
5712 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
5714 print STDERR
"unable to cleanup '$volid' - $@" if $@;
5716 print STDERR
"unable to parse line in statfile - $line";
5723 sub restore_archive
{
5724 my ($archive, $vmid, $user, $opts) = @_;
5726 my $format = $opts->{format
};
5729 if ($archive =~ m/\.tgz$/ || $archive =~ m/\.tar\.gz$/) {
5730 $format = 'tar' if !$format;
5732 } elsif ($archive =~ m/\.tar$/) {
5733 $format = 'tar' if !$format;
5734 } elsif ($archive =~ m/.tar.lzo$/) {
5735 $format = 'tar' if !$format;
5737 } elsif ($archive =~ m/\.vma$/) {
5738 $format = 'vma' if !$format;
5739 } elsif ($archive =~ m/\.vma\.gz$/) {
5740 $format = 'vma' if !$format;
5742 } elsif ($archive =~ m/\.vma\.lzo$/) {
5743 $format = 'vma' if !$format;
5746 $format = 'vma' if !$format; # default
5749 # try to detect archive format
5750 if ($format eq 'tar') {
5751 return restore_tar_archive
($archive, $vmid, $user, $opts);
5753 return restore_vma_archive
($archive, $vmid, $user, $opts, $comp);
5757 sub restore_update_config_line
{
5758 my ($outfd, $cookie, $vmid, $map, $line, $unique) = @_;
5760 return if $line =~ m/^\#qmdump\#/;
5761 return if $line =~ m/^\#vzdump\#/;
5762 return if $line =~ m/^lock:/;
5763 return if $line =~ m/^unused\d+:/;
5764 return if $line =~ m/^parent:/;
5765 return if $line =~ m/^template:/; # restored VM is never a template
5767 my $dc = PVE
::Cluster
::cfs_read_file
('datacenter.cfg');
5768 if (($line =~ m/^(vlan(\d+)):\s*(\S+)\s*$/)) {
5769 # try to convert old 1.X settings
5770 my ($id, $ind, $ethcfg) = ($1, $2, $3);
5771 foreach my $devconfig (PVE
::Tools
::split_list
($ethcfg)) {
5772 my ($model, $macaddr) = split(/\=/, $devconfig);
5773 $macaddr = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if !$macaddr || $unique;
5776 bridge
=> "vmbr$ind",
5777 macaddr
=> $macaddr,
5779 my $netstr = print_net
($net);
5781 print $outfd "net$cookie->{netcount}: $netstr\n";
5782 $cookie->{netcount
}++;
5784 } elsif (($line =~ m/^(net\d+):\s*(\S+)\s*$/) && $unique) {
5785 my ($id, $netstr) = ($1, $2);
5786 my $net = parse_net
($netstr);
5787 $net->{macaddr
} = PVE
::Tools
::random_ether_addr
($dc->{mac_prefix
}) if $net->{macaddr
};
5788 $netstr = print_net
($net);
5789 print $outfd "$id: $netstr\n";
5790 } elsif ($line =~ m/^((ide|scsi|virtio|sata|efidisk)\d+):\s*(\S+)\s*$/) {
5793 my $di = parse_drive
($virtdev, $value);
5794 if (defined($di->{backup
}) && !$di->{backup
}) {
5795 print $outfd "#$line";
5796 } elsif ($map->{$virtdev}) {
5797 delete $di->{format
}; # format can change on restore
5798 $di->{file
} = $map->{$virtdev};
5799 $value = print_drive
($vmid, $di);
5800 print $outfd "$virtdev: $value\n";
5804 } elsif (($line =~ m/^vmgenid: (.*)/)) {
5806 if ($vmgenid ne '0') {
5807 # always generate a new vmgenid if there was a valid one setup
5808 $vmgenid = generate_uuid
();
5810 print $outfd "vmgenid: $vmgenid\n";
5811 } elsif (($line =~ m/^(smbios1: )(.*)/) && $unique) {
5812 my ($uuid, $uuid_str);
5813 UUID
::generate
($uuid);
5814 UUID
::unparse
($uuid, $uuid_str);
5815 my $smbios1 = parse_smbios1
($2);
5816 $smbios1->{uuid
} = $uuid_str;
5817 print $outfd $1.print_smbios1
($smbios1)."\n";
5824 my ($cfg, $vmid) = @_;
5826 my $info = PVE
::Storage
::vdisk_list
($cfg, undef, $vmid);
5828 my $volid_hash = {};
5829 foreach my $storeid (keys %$info) {
5830 foreach my $item (@{$info->{$storeid}}) {
5831 next if !($item->{volid
} && $item->{size
});
5832 $item->{path
} = PVE
::Storage
::path
($cfg, $item->{volid
});
5833 $volid_hash->{$item->{volid
}} = $item;
5840 sub is_volume_in_use
{
5841 my ($storecfg, $conf, $skip_drive, $volid) = @_;
5843 my $path = PVE
::Storage
::path
($storecfg, $volid);
5845 my $scan_config = sub {
5846 my ($cref, $snapname) = @_;
5848 foreach my $key (keys %$cref) {
5849 my $value = $cref->{$key};
5850 if (is_valid_drivename
($key)) {
5851 next if $skip_drive && $key eq $skip_drive;
5852 my $drive = parse_drive
($key, $value);
5853 next if !$drive || !$drive->{file
} || drive_is_cdrom
($drive);
5854 return 1 if $volid eq $drive->{file
};
5855 if ($drive->{file
} =~ m!^/!) {
5856 return 1 if $drive->{file
} eq $path;
5858 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
}, 1);
5860 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid, 1);
5862 return 1 if $path eq PVE
::Storage
::path
($storecfg, $drive->{file
}, $snapname);
5870 return 1 if &$scan_config($conf);
5874 foreach my $snapname (keys %{$conf->{snapshots
}}) {
5875 return 1 if &$scan_config($conf->{snapshots
}->{$snapname}, $snapname);
5881 sub update_disksize
{
5882 my ($vmid, $conf, $volid_hash) = @_;
5885 my $prefix = "VM $vmid:";
5887 # used and unused disks
5888 my $referenced = {};
5890 # Note: it is allowed to define multiple storages with same path (alias), so
5891 # we need to check both 'volid' and real 'path' (two different volid can point
5892 # to the same path).
5894 my $referencedpath = {};
5897 foreach my $opt (keys %$conf) {
5898 if (is_valid_drivename
($opt)) {
5899 my $drive = parse_drive
($opt, $conf->{$opt});
5900 my $volid = $drive->{file
};
5903 $referenced->{$volid} = 1;
5904 if ($volid_hash->{$volid} &&
5905 (my $path = $volid_hash->{$volid}->{path
})) {
5906 $referencedpath->{$path} = 1;
5909 next if drive_is_cdrom
($drive);
5910 next if !$volid_hash->{$volid};
5912 $drive->{size
} = $volid_hash->{$volid}->{size
};
5913 my $new = print_drive
($vmid, $drive);
5914 if ($new ne $conf->{$opt}) {
5916 $conf->{$opt} = $new;
5917 print "$prefix update disk '$opt' information.\n";
5922 # remove 'unusedX' entry if volume is used
5923 foreach my $opt (keys %$conf) {
5924 next if $opt !~ m/^unused\d+$/;
5925 my $volid = $conf->{$opt};
5926 my $path = $volid_hash->{$volid}->{path
} if $volid_hash->{$volid};
5927 if ($referenced->{$volid} || ($path && $referencedpath->{$path})) {
5928 print "$prefix remove entry '$opt', its volume '$volid' is in use.\n";
5930 delete $conf->{$opt};
5933 $referenced->{$volid} = 1;
5934 $referencedpath->{$path} = 1 if $path;
5937 foreach my $volid (sort keys %$volid_hash) {
5938 next if $volid =~ m/vm-$vmid-state-/;
5939 next if $referenced->{$volid};
5940 my $path = $volid_hash->{$volid}->{path
};
5941 next if !$path; # just to be sure
5942 next if $referencedpath->{$path};
5944 my $key = PVE
::QemuConfig-
>add_unused_volume($conf, $volid);
5945 print "$prefix add unreferenced volume '$volid' as '$key' to config.\n";
5946 $referencedpath->{$path} = 1; # avoid to add more than once (aliases)
5953 my ($vmid, $nolock, $dryrun) = @_;
5955 my $cfg = PVE
::Storage
::config
();
5957 # FIXME: Remove once our RBD plugin can handle CT and VM on a single storage
5958 # see: https://pve.proxmox.com/pipermail/pve-devel/2018-July/032900.html
5959 foreach my $stor (keys %{$cfg->{ids
}}) {
5960 delete($cfg->{ids
}->{$stor}) if ! $cfg->{ids
}->{$stor}->{content
}->{images
};
5963 print "rescan volumes...\n";
5964 my $volid_hash = scan_volids
($cfg, $vmid);
5966 my $updatefn = sub {
5969 my $conf = PVE
::QemuConfig-
>load_config($vmid);
5971 PVE
::QemuConfig-
>check_lock($conf);
5974 foreach my $volid (keys %$volid_hash) {
5975 my $info = $volid_hash->{$volid};
5976 $vm_volids->{$volid} = $info if $info->{vmid
} && $info->{vmid
} == $vmid;
5979 my $changes = update_disksize
($vmid, $conf, $vm_volids);
5981 PVE
::QemuConfig-
>write_config($vmid, $conf) if $changes && !$dryrun;
5984 if (defined($vmid)) {
5988 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
5991 my $vmlist = config_list
();
5992 foreach my $vmid (keys %$vmlist) {
5996 PVE
::QemuConfig-
>lock_config($vmid, $updatefn, $vmid);
6002 sub restore_vma_archive
{
6003 my ($archive, $vmid, $user, $opts, $comp) = @_;
6005 my $readfrom = $archive;
6007 my $cfg = PVE
::Storage
::config
();
6009 my $bwlimit = $opts->{bwlimit
};
6011 my $dbg_cmdstring = '';
6012 my $add_pipe = sub {
6014 push @$commands, $cmd;
6015 $dbg_cmdstring .= ' | ' if length($dbg_cmdstring);
6016 $dbg_cmdstring .= PVE
::Tools
::cmd2string
($cmd);
6021 if ($archive eq '-') {
6024 # If we use a backup from a PVE defined storage we also consider that
6025 # storage's rate limit:
6026 my (undef, $volid) = PVE
::Storage
::path_to_volume_id
($cfg, $archive);
6027 if (defined($volid)) {
6028 my ($sid, undef) = PVE
::Storage
::parse_volume_id
($volid);
6029 my $readlimit = PVE
::Storage
::get_bandwidth_limit
('restore', [$sid], $bwlimit);
6031 print STDERR
"applying read rate limit: $readlimit\n";
6032 my $cstream = ['cstream', '-t', $readlimit*1024, '--', $readfrom];
6033 $add_pipe->($cstream);
6040 if ($comp eq 'gzip') {
6041 $cmd = ['zcat', $readfrom];
6042 } elsif ($comp eq 'lzop') {
6043 $cmd = ['lzop', '-d', '-c', $readfrom];
6045 die "unknown compression method '$comp'\n";
6050 my $tmpdir = "/var/tmp/vzdumptmp$$";
6053 # disable interrupts (always do cleanups)
6057 local $SIG{HUP
} = sub { warn "got interrupt - ignored\n"; };
6059 my $mapfifo = "/var/tmp/vzdumptmp$$.fifo";
6060 POSIX
::mkfifo
($mapfifo, 0600);
6063 my $openfifo = sub {
6064 open($fifofh, '>', $mapfifo) || die $!;
6067 $add_pipe->(['vma', 'extract', '-v', '-r', $mapfifo, $readfrom, $tmpdir]);
6074 my $rpcenv = PVE
::RPCEnvironment
::get
();
6076 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6077 my $tmpfn = "$conffile.$$.tmp";
6079 # Note: $oldconf is undef if VM does not exists
6080 my $cfs_path = PVE
::QemuConfig-
>cfs_config_path($vmid);
6081 my $oldconf = PVE
::Cluster
::cfs_read_file
($cfs_path);
6085 my $print_devmap = sub {
6086 my $virtdev_hash = {};
6088 my $cfgfn = "$tmpdir/qemu-server.conf";
6090 # we can read the config - that is already extracted
6091 my $fh = IO
::File-
>new($cfgfn, "r") ||
6092 "unable to read qemu-server.conf - $!\n";
6094 my $fwcfgfn = "$tmpdir/qemu-server.fw";
6096 my $pve_firewall_dir = '/etc/pve/firewall';
6097 mkdir $pve_firewall_dir; # make sure the dir exists
6098 PVE
::Tools
::file_copy
($fwcfgfn, "${pve_firewall_dir}/$vmid.fw");
6101 while (defined(my $line = <$fh>)) {
6102 if ($line =~ m/^\#qmdump\#map:(\S+):(\S+):(\S*):(\S*):$/) {
6103 my ($virtdev, $devname, $storeid, $format) = ($1, $2, $3, $4);
6104 die "archive does not contain data for drive '$virtdev'\n"
6105 if !$devinfo->{$devname};
6106 if (defined($opts->{storage
})) {
6107 $storeid = $opts->{storage
} || 'local';
6108 } elsif (!$storeid) {
6111 $format = 'raw' if !$format;
6112 $devinfo->{$devname}->{devname
} = $devname;
6113 $devinfo->{$devname}->{virtdev
} = $virtdev;
6114 $devinfo->{$devname}->{format
} = $format;
6115 $devinfo->{$devname}->{storeid
} = $storeid;
6117 # check permission on storage
6118 my $pool = $opts->{pool
}; # todo: do we need that?
6119 if ($user ne 'root@pam') {
6120 $rpcenv->check($user, "/storage/$storeid", ['Datastore.AllocateSpace']);
6123 $storage_limits{$storeid} = $bwlimit;
6125 $virtdev_hash->{$virtdev} = $devinfo->{$devname};
6129 foreach my $key (keys %storage_limits) {
6130 my $limit = PVE
::Storage
::get_bandwidth_limit
('restore', [$key], $bwlimit);
6132 print STDERR
"rate limit for storage $key: $limit KiB/s\n";
6133 $storage_limits{$key} = $limit * 1024;
6136 foreach my $devname (keys %$devinfo) {
6137 die "found no device mapping information for device '$devname'\n"
6138 if !$devinfo->{$devname}->{virtdev
};
6141 # create empty/temp config
6143 PVE
::Tools
::file_set_contents
($conffile, "memory: 128\n");
6144 foreach_drive
($oldconf, sub {
6145 my ($ds, $drive) = @_;
6147 return if drive_is_cdrom
($drive);
6149 my $volid = $drive->{file
};
6151 return if !$volid || $volid =~ m
|^/|;
6153 my ($path, $owner) = PVE
::Storage
::path
($cfg, $volid);
6154 return if !$path || !$owner || ($owner != $vmid);
6156 # Note: only delete disk we want to restore
6157 # other volumes will become unused
6158 if ($virtdev_hash->{$ds}) {
6159 eval { PVE
::Storage
::vdisk_free
($cfg, $volid); };
6166 # delete vmstate files
6167 # since after the restore we have no snapshots anymore
6168 foreach my $snapname (keys %{$oldconf->{snapshots
}}) {
6169 my $snap = $oldconf->{snapshots
}->{$snapname};
6170 if ($snap->{vmstate
}) {
6171 eval { PVE
::Storage
::vdisk_free
($cfg, $snap->{vmstate
}); };
6180 foreach my $virtdev (sort keys %$virtdev_hash) {
6181 my $d = $virtdev_hash->{$virtdev};
6182 my $alloc_size = int(($d->{size
} + 1024 - 1)/1024);
6183 my $storeid = $d->{storeid
};
6184 my $scfg = PVE
::Storage
::storage_config
($cfg, $storeid);
6187 if (my $limit = $storage_limits{$storeid}) {
6188 $map_opts .= "throttling.bps=$limit:throttling.group=$storeid:";
6191 # test if requested format is supported
6192 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($cfg, $storeid);
6193 my $supported = grep { $_ eq $d->{format
} } @$validFormats;
6194 $d->{format
} = $defFormat if !$supported;
6196 my $volid = PVE
::Storage
::vdisk_alloc
($cfg, $storeid, $vmid,
6197 $d->{format
}, undef, $alloc_size);
6198 print STDERR
"new volume ID is '$volid'\n";
6199 $d->{volid
} = $volid;
6200 my $path = PVE
::Storage
::path
($cfg, $volid);
6202 PVE
::Storage
::activate_volumes
($cfg,[$volid]);
6204 my $write_zeros = 1;
6205 if (PVE
::Storage
::volume_has_feature
($cfg, 'sparseinit', $volid)) {
6209 print $fifofh "${map_opts}format=$d->{format}:${write_zeros}:$d->{devname}=$path\n";
6211 print "map '$d->{devname}' to '$path' (write zeros = ${write_zeros})\n";
6212 $map->{$virtdev} = $volid;
6215 $fh->seek(0, 0) || die "seek failed - $!\n";
6217 my $outfd = new IO
::File
($tmpfn, "w") ||
6218 die "unable to write config for VM $vmid\n";
6220 my $cookie = { netcount
=> 0 };
6221 while (defined(my $line = <$fh>)) {
6222 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6235 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6236 local $SIG{ALRM
} = sub { die "got timeout\n"; };
6238 $oldtimeout = alarm($timeout);
6245 if ($line =~ m/^DEV:\sdev_id=(\d+)\ssize:\s(\d+)\sdevname:\s(\S+)$/) {
6246 my ($dev_id, $size, $devname) = ($1, $2, $3);
6247 $devinfo->{$devname} = { size
=> $size, dev_id
=> $dev_id };
6248 } elsif ($line =~ m/^CTIME: /) {
6249 # we correctly received the vma config, so we can disable
6250 # the timeout now for disk allocation (set to 10 minutes, so
6251 # that we always timeout if something goes wrong)
6254 print $fifofh "done\n";
6255 my $tmp = $oldtimeout || 0;
6256 $oldtimeout = undef;
6262 print "restore vma archive: $dbg_cmdstring\n";
6263 run_command
($commands, input
=> $input, outfunc
=> $parser, afterfork
=> $openfifo);
6267 alarm($oldtimeout) if $oldtimeout;
6270 foreach my $devname (keys %$devinfo) {
6271 my $volid = $devinfo->{$devname}->{volid
};
6272 push @$vollist, $volid if $volid;
6275 PVE
::Storage
::deactivate_volumes
($cfg, $vollist);
6283 foreach my $devname (keys %$devinfo) {
6284 my $volid = $devinfo->{$devname}->{volid
};
6287 if ($volid =~ m
|^/|) {
6288 unlink $volid || die 'unlink failed\n';
6290 PVE
::Storage
::vdisk_free
($cfg, $volid);
6292 print STDERR
"temporary volume '$volid' sucessfuly removed\n";
6294 print STDERR
"unable to cleanup '$volid' - $@" if $@;
6301 rename($tmpfn, $conffile) ||
6302 die "unable to commit configuration file '$conffile'\n";
6304 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6306 eval { rescan
($vmid, 1); };
6310 sub restore_tar_archive
{
6311 my ($archive, $vmid, $user, $opts) = @_;
6313 if ($archive ne '-') {
6314 my $firstfile = tar_archive_read_firstfile
($archive);
6315 die "ERROR: file '$archive' dos not lock like a QemuServer vzdump backup\n"
6316 if $firstfile ne 'qemu-server.conf';
6319 my $storecfg = PVE
::Storage
::config
();
6321 # destroy existing data - keep empty config
6322 my $vmcfgfn = PVE
::QemuConfig-
>config_file($vmid);
6323 destroy_vm
($storecfg, $vmid, 1) if -f
$vmcfgfn;
6325 my $tocmd = "/usr/lib/qemu-server/qmextract";
6327 $tocmd .= " --storage " . PVE
::Tools
::shellquote
($opts->{storage
}) if $opts->{storage
};
6328 $tocmd .= " --pool " . PVE
::Tools
::shellquote
($opts->{pool
}) if $opts->{pool
};
6329 $tocmd .= ' --prealloc' if $opts->{prealloc
};
6330 $tocmd .= ' --info' if $opts->{info
};
6332 # tar option "xf" does not autodetect compression when read from STDIN,
6333 # so we pipe to zcat
6334 my $cmd = "zcat -f|tar xf " . PVE
::Tools
::shellquote
($archive) . " " .
6335 PVE
::Tools
::shellquote
("--to-command=$tocmd");
6337 my $tmpdir = "/var/tmp/vzdumptmp$$";
6340 local $ENV{VZDUMP_TMPDIR
} = $tmpdir;
6341 local $ENV{VZDUMP_VMID
} = $vmid;
6342 local $ENV{VZDUMP_USER
} = $user;
6344 my $conffile = PVE
::QemuConfig-
>config_file($vmid);
6345 my $tmpfn = "$conffile.$$.tmp";
6347 # disable interrupts (always do cleanups)
6351 local $SIG{HUP
} = sub { print STDERR
"got interrupt - ignored\n"; };
6359 local $SIG{PIPE
} = sub { die "interrupted by signal\n"; };
6361 if ($archive eq '-') {
6362 print "extracting archive from STDIN\n";
6363 run_command
($cmd, input
=> "<&STDIN");
6365 print "extracting archive '$archive'\n";
6369 return if $opts->{info
};
6373 my $statfile = "$tmpdir/qmrestore.stat";
6374 if (my $fd = IO
::File-
>new($statfile, "r")) {
6375 while (defined (my $line = <$fd>)) {
6376 if ($line =~ m/vzdump:([^\s:]*):(\S+)$/) {
6377 $map->{$1} = $2 if $1;
6379 print STDERR
"unable to parse line in statfile - $line\n";
6385 my $confsrc = "$tmpdir/qemu-server.conf";
6387 my $srcfd = new IO
::File
($confsrc, "r") ||
6388 die "unable to open file '$confsrc'\n";
6390 my $outfd = new IO
::File
($tmpfn, "w") ||
6391 die "unable to write config for VM $vmid\n";
6393 my $cookie = { netcount
=> 0 };
6394 while (defined (my $line = <$srcfd>)) {
6395 restore_update_config_line
($outfd, $cookie, $vmid, $map, $line, $opts->{unique
});
6407 tar_restore_cleanup
($storecfg, "$tmpdir/qmrestore.stat") if !$opts->{info
};
6414 rename $tmpfn, $conffile ||
6415 die "unable to commit configuration file '$conffile'\n";
6417 PVE
::Cluster
::cfs_update
(); # make sure we read new file
6419 eval { rescan
($vmid, 1); };
6423 sub foreach_storage_used_by_vm
{
6424 my ($conf, $func) = @_;
6428 foreach_drive
($conf, sub {
6429 my ($ds, $drive) = @_;
6430 return if drive_is_cdrom
($drive);
6432 my $volid = $drive->{file
};
6434 my ($sid, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
6435 $sidhash->{$sid} = $sid if $sid;
6438 foreach my $sid (sort keys %$sidhash) {
6443 sub do_snapshots_with_qemu
{
6444 my ($storecfg, $volid) = @_;
6446 my $storage_name = PVE
::Storage
::parse_volume_id
($volid);
6448 if ($qemu_snap_storage->{$storecfg->{ids
}->{$storage_name}->{type
}}
6449 && !$storecfg->{ids
}->{$storage_name}->{krbd
}){
6453 if ($volid =~ m/\.(qcow2|qed)$/){
6460 sub qga_check_running
{
6461 my ($vmid, $nowarn) = @_;
6463 eval { vm_mon_cmd
($vmid, "guest-ping", timeout
=> 3); };
6465 warn "Qemu Guest Agent is not running - $@" if !$nowarn;
6471 sub template_create
{
6472 my ($vmid, $conf, $disk) = @_;
6474 my $storecfg = PVE
::Storage
::config
();
6476 foreach_drive
($conf, sub {
6477 my ($ds, $drive) = @_;
6479 return if drive_is_cdrom
($drive);
6480 return if $disk && $ds ne $disk;
6482 my $volid = $drive->{file
};
6483 return if !PVE
::Storage
::volume_has_feature
($storecfg, 'template', $volid);
6485 my $voliddst = PVE
::Storage
::vdisk_create_base
($storecfg, $volid);
6486 $drive->{file
} = $voliddst;
6487 $conf->{$ds} = print_drive
($vmid, $drive);
6488 PVE
::QemuConfig-
>write_config($vmid, $conf);
6492 sub qemu_img_convert
{
6493 my ($src_volid, $dst_volid, $size, $snapname, $is_zero_initialized) = @_;
6495 my $storecfg = PVE
::Storage
::config
();
6496 my ($src_storeid, $src_volname) = PVE
::Storage
::parse_volume_id
($src_volid, 1);
6497 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid, 1);
6499 if ($src_storeid && $dst_storeid) {
6501 PVE
::Storage
::activate_volumes
($storecfg, [$src_volid], $snapname);
6503 my $src_scfg = PVE
::Storage
::storage_config
($storecfg, $src_storeid);
6504 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6506 my $src_format = qemu_img_format
($src_scfg, $src_volname);
6507 my $dst_format = qemu_img_format
($dst_scfg, $dst_volname);
6509 my $src_path = PVE
::Storage
::path
($storecfg, $src_volid, $snapname);
6510 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6513 push @$cmd, '/usr/bin/qemu-img', 'convert', '-p', '-n';
6514 push @$cmd, '-l', "snapshot.name=$snapname" if($snapname && $src_format eq "qcow2");
6515 push @$cmd, '-t', 'none' if $dst_scfg->{type
} eq 'zfspool';
6516 push @$cmd, '-T', 'none' if $src_scfg->{type
} eq 'zfspool';
6517 push @$cmd, '-f', $src_format, '-O', $dst_format, $src_path;
6518 if ($is_zero_initialized) {
6519 push @$cmd, "zeroinit:$dst_path";
6521 push @$cmd, $dst_path;
6526 if($line =~ m/\((\S+)\/100\
%\)/){
6528 my $transferred = int($size * $percent / 100);
6529 my $remaining = $size - $transferred;
6531 print "transferred: $transferred bytes remaining: $remaining bytes total: $size bytes progression: $percent %\n";
6536 eval { run_command
($cmd, timeout
=> undef, outfunc
=> $parser); };
6538 die "copy failed: $err" if $err;
6542 sub qemu_img_format
{
6543 my ($scfg, $volname) = @_;
6545 if ($scfg->{path
} && $volname =~ m/\.($QEMU_FORMAT_RE)$/) {
6552 sub qemu_drive_mirror
{
6553 my ($vmid, $drive, $dst_volid, $vmiddst, $is_zero_initialized, $jobs, $skipcomplete, $qga) = @_;
6555 $jobs = {} if !$jobs;
6559 $jobs->{"drive-$drive"} = {};
6561 if ($dst_volid =~ /^nbd:/) {
6562 $qemu_target = $dst_volid;
6565 my $storecfg = PVE
::Storage
::config
();
6566 my ($dst_storeid, $dst_volname) = PVE
::Storage
::parse_volume_id
($dst_volid);
6568 my $dst_scfg = PVE
::Storage
::storage_config
($storecfg, $dst_storeid);
6570 $format = qemu_img_format
($dst_scfg, $dst_volname);
6572 my $dst_path = PVE
::Storage
::path
($storecfg, $dst_volid);
6574 $qemu_target = $is_zero_initialized ?
"zeroinit:$dst_path" : $dst_path;
6577 my $opts = { timeout
=> 10, device
=> "drive-$drive", mode
=> "existing", sync
=> "full", target
=> $qemu_target };
6578 $opts->{format
} = $format if $format;
6580 print "drive mirror is starting for drive-$drive\n";
6582 eval { vm_mon_cmd
($vmid, "drive-mirror", %$opts); }; #if a job already run for this device,it's throw an error
6585 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6586 die "mirroring error: $err";
6589 qemu_drive_mirror_monitor
($vmid, $vmiddst, $jobs, $skipcomplete, $qga);
6592 sub qemu_drive_mirror_monitor
{
6593 my ($vmid, $vmiddst, $jobs, $skipcomplete, $qga) = @_;
6596 my $err_complete = 0;
6599 die "storage migration timed out\n" if $err_complete > 300;
6601 my $stats = vm_mon_cmd
($vmid, "query-block-jobs");
6603 my $running_mirror_jobs = {};
6604 foreach my $stat (@$stats) {
6605 next if $stat->{type
} ne 'mirror';
6606 $running_mirror_jobs->{$stat->{device
}} = $stat;
6609 my $readycounter = 0;
6611 foreach my $job (keys %$jobs) {
6613 if(defined($jobs->{$job}->{complete
}) && !defined($running_mirror_jobs->{$job})) {
6614 print "$job : finished\n";
6615 delete $jobs->{$job};
6619 die "$job: mirroring has been cancelled\n" if !defined($running_mirror_jobs->{$job});
6621 my $busy = $running_mirror_jobs->{$job}->{busy
};
6622 my $ready = $running_mirror_jobs->{$job}->{ready
};
6623 if (my $total = $running_mirror_jobs->{$job}->{len
}) {
6624 my $transferred = $running_mirror_jobs->{$job}->{offset
} || 0;
6625 my $remaining = $total - $transferred;
6626 my $percent = sprintf "%.2f", ($transferred * 100 / $total);
6628 print "$job: transferred: $transferred bytes remaining: $remaining bytes total: $total bytes progression: $percent % busy: $busy ready: $ready \n";
6631 $readycounter++ if $running_mirror_jobs->{$job}->{ready
};
6634 last if scalar(keys %$jobs) == 0;
6636 if ($readycounter == scalar(keys %$jobs)) {
6637 print "all mirroring jobs are ready \n";
6638 last if $skipcomplete; #do the complete later
6640 if ($vmiddst && $vmiddst != $vmid) {
6641 my $agent_running = $qga && qga_check_running
($vmid);
6642 if ($agent_running) {
6643 print "freeze filesystem\n";
6644 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "guest-fsfreeze-freeze"); };
6646 print "suspend vm\n";
6647 eval { PVE
::QemuServer
::vm_suspend
($vmid, 1); };
6650 # if we clone a disk for a new target vm, we don't switch the disk
6651 PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs);
6653 if ($agent_running) {
6654 print "unfreeze filesystem\n";
6655 eval { PVE
::QemuServer
::vm_mon_cmd
($vmid, "guest-fsfreeze-thaw"); };
6657 print "resume vm\n";
6658 eval { PVE
::QemuServer
::vm_resume
($vmid, 1, 1); };
6664 foreach my $job (keys %$jobs) {
6665 # try to switch the disk if source and destination are on the same guest
6666 print "$job: Completing block job...\n";
6668 eval { vm_mon_cmd
($vmid, "block-job-complete", device
=> $job) };
6669 if ($@ =~ m/cannot be completed/) {
6670 print "$job: Block job cannot be completed, try again.\n";
6673 print "$job: Completed successfully.\n";
6674 $jobs->{$job}->{complete
} = 1;
6685 eval { PVE
::QemuServer
::qemu_blockjobs_cancel
($vmid, $jobs) };
6686 die "mirroring error: $err";
6691 sub qemu_blockjobs_cancel
{
6692 my ($vmid, $jobs) = @_;
6694 foreach my $job (keys %$jobs) {
6695 print "$job: Cancelling block job\n";
6696 eval { vm_mon_cmd
($vmid, "block-job-cancel", device
=> $job); };
6697 $jobs->{$job}->{cancel
} = 1;
6701 my $stats = vm_mon_cmd
($vmid, "query-block-jobs");
6703 my $running_jobs = {};
6704 foreach my $stat (@$stats) {
6705 $running_jobs->{$stat->{device
}} = $stat;
6708 foreach my $job (keys %$jobs) {
6710 if (defined($jobs->{$job}->{cancel
}) && !defined($running_jobs->{$job})) {
6711 print "$job: Done.\n";
6712 delete $jobs->{$job};
6716 last if scalar(keys %$jobs) == 0;
6723 my ($storecfg, $vmid, $running, $drivename, $drive, $snapname,
6724 $newvmid, $storage, $format, $full, $newvollist, $jobs, $skipcomplete, $qga) = @_;
6729 print "create linked clone of drive $drivename ($drive->{file})\n";
6730 $newvolid = PVE
::Storage
::vdisk_clone
($storecfg, $drive->{file
}, $newvmid, $snapname);
6731 push @$newvollist, $newvolid;
6734 my ($storeid, $volname) = PVE
::Storage
::parse_volume_id
($drive->{file
});
6735 $storeid = $storage if $storage;
6737 my $dst_format = resolve_dst_disk_format
($storecfg, $storeid, $volname, $format);
6738 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $drive->{file
}, 3);
6740 print "create full clone of drive $drivename ($drive->{file})\n";
6742 if (drive_is_cloudinit
($drive)) {
6743 $name = "vm-$newvmid-cloudinit";
6744 # cloudinit only supports raw and qcow2 atm:
6745 if ($dst_format eq 'qcow2') {
6747 } elsif ($dst_format ne 'raw') {
6748 die "clone: unhandled format for cloudinit image\n";
6751 $newvolid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $newvmid, $dst_format, $name, ($size/1024));
6752 push @$newvollist, $newvolid;
6754 PVE
::Storage
::activate_volumes
($storecfg, [$newvolid]);
6756 my $sparseinit = PVE
::Storage
::volume_has_feature
($storecfg, 'sparseinit', $newvolid);
6757 if (!$running || $snapname) {
6758 qemu_img_convert
($drive->{file
}, $newvolid, $size, $snapname, $sparseinit);
6761 my $kvmver = get_running_qemu_version
($vmid);
6762 if (!qemu_machine_feature_enabled
(undef, $kvmver, 2, 7)) {
6763 die "drive-mirror with iothread requires qemu version 2.7 or higher\n"
6764 if $drive->{iothread
};
6767 qemu_drive_mirror
($vmid, $drivename, $newvolid, $newvmid, $sparseinit, $jobs, $skipcomplete, $qga);
6771 my ($size) = PVE
::Storage
::volume_size_info
($storecfg, $newvolid, 3);
6774 $disk->{format
} = undef;
6775 $disk->{file
} = $newvolid;
6776 $disk->{size
} = $size;
6781 # this only works if VM is running
6782 sub get_current_qemu_machine
{
6785 my $cmd = { execute
=> 'query-machines', arguments
=> {} };
6786 my $res = vm_qmp_command
($vmid, $cmd);
6788 my ($current, $default);
6789 foreach my $e (@$res) {
6790 $default = $e->{name
} if $e->{'is-default'};
6791 $current = $e->{name
} if $e->{'is-current'};
6794 # fallback to the default machine if current is not supported by qemu
6795 return $current || $default || 'pc';
6798 sub get_running_qemu_version
{
6800 my $cmd = { execute
=> 'query-version', arguments
=> {} };
6801 my $res = vm_qmp_command
($vmid, $cmd);
6802 return "$res->{qemu}->{major}.$res->{qemu}->{minor}";
6805 sub qemu_machine_feature_enabled
{
6806 my ($machine, $kvmver, $version_major, $version_minor) = @_;
6811 if ($machine && $machine =~ m/^((?:pc(-i440fx|-q35)?|virt)-(\d+)\.(\d+))/) {
6813 $current_major = $3;
6814 $current_minor = $4;
6816 } elsif ($kvmver =~ m/^(\d+)\.(\d+)/) {
6818 $current_major = $1;
6819 $current_minor = $2;
6822 return 1 if $current_major > $version_major ||
6823 ($current_major == $version_major &&
6824 $current_minor >= $version_minor);
6827 sub qemu_machine_pxe
{
6828 my ($vmid, $conf, $machine) = @_;
6830 $machine = PVE
::QemuServer
::get_current_qemu_machine
($vmid) if !$machine;
6832 if ($conf->{machine
} && $conf->{machine
} =~ m/\.pxe$/) {
6839 sub qemu_use_old_bios_files
{
6840 my ($machine_type) = @_;
6842 return if !$machine_type;
6844 my $use_old_bios_files = undef;
6846 if ($machine_type =~ m/^(\S+)\.pxe$/) {
6848 $use_old_bios_files = 1;
6850 my $kvmver = kvm_user_version
();
6851 # Note: kvm version < 2.4 use non-efi pxe files, and have problems when we
6852 # load new efi bios files on migration. So this hack is required to allow
6853 # live migration from qemu-2.2 to qemu-2.4, which is sometimes used when
6854 # updrading from proxmox-ve-3.X to proxmox-ve 4.0
6855 $use_old_bios_files = !qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 4);
6858 return ($use_old_bios_files, $machine_type);
6861 sub create_efidisk
($$$$$) {
6862 my ($storecfg, $storeid, $vmid, $fmt, $arch) = @_;
6864 my (undef, $ovmf_vars) = get_ovmf_files
($arch);
6865 die "EFI vars default image not found\n" if ! -f
$ovmf_vars;
6867 my $vars_size = PVE
::Tools
::convert_size
(-s
$ovmf_vars, 'b' => 'kb');
6868 my $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storeid, $vmid, $fmt, undef, $vars_size);
6869 PVE
::Storage
::activate_volumes
($storecfg, [$volid]);
6871 my $path = PVE
::Storage
::path
($storecfg, $volid);
6873 run_command
(['/usr/bin/qemu-img', 'convert', '-n', '-f', 'raw', '-O', $fmt, $ovmf_vars, $path]);
6875 die "Copying EFI vars image failed: $@" if $@;
6877 return ($volid, $vars_size);
6884 dir_glob_foreach
("$pcisysfs/devices", '[a-f0-9]{4}:([a-f0-9]{2}:[a-f0-9]{2})\.([0-9])', sub {
6885 my (undef, $id, $function) = @_;
6886 my $res = { id
=> $id, function
=> $function};
6887 push @{$devices->{$id}}, $res;
6890 # Entries should be sorted by functions.
6891 foreach my $id (keys %$devices) {
6892 my $dev = $devices->{$id};
6893 $devices->{$id} = [ sort { $a->{function
} <=> $b->{function
} } @$dev ];
6899 sub vm_iothreads_list
{
6902 my $res = vm_mon_cmd
($vmid, 'query-iothreads');
6905 foreach my $iothread (@$res) {
6906 $iothreads->{ $iothread->{id
} } = $iothread->{"thread-id"};
6913 my ($conf, $drive) = @_;
6917 if (!$conf->{scsihw
} || ($conf->{scsihw
} =~ m/^lsi/)) {
6919 } elsif ($conf->{scsihw
} && ($conf->{scsihw
} eq 'virtio-scsi-single')) {
6925 my $controller = int($drive->{index} / $maxdev);
6926 my $controller_prefix = ($conf->{scsihw
} && $conf->{scsihw
} eq 'virtio-scsi-single') ?
"virtioscsi" : "scsihw";
6928 return ($maxdev, $controller, $controller_prefix);
6931 sub add_hyperv_enlightenments
{
6932 my ($cpuFlags, $winversion, $machine_type, $kvmver, $bios, $gpu_passthrough) = @_;
6934 return if $winversion < 6;
6935 return if $bios && $bios eq 'ovmf' && $winversion < 8;
6937 push @$cpuFlags , 'hv_vendor_id=proxmox' if $gpu_passthrough;
6939 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 3)) {
6940 push @$cpuFlags , 'hv_spinlocks=0x1fff';
6941 push @$cpuFlags , 'hv_vapic';
6942 push @$cpuFlags , 'hv_time';
6944 push @$cpuFlags , 'hv_spinlocks=0xffff';
6947 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 6)) {
6948 push @$cpuFlags , 'hv_reset';
6949 push @$cpuFlags , 'hv_vpindex';
6950 push @$cpuFlags , 'hv_runtime';
6953 if ($winversion >= 7) {
6954 push @$cpuFlags , 'hv_relaxed';
6956 if (qemu_machine_feature_enabled
($machine_type, $kvmver, 2, 12)) {
6957 push @$cpuFlags , 'hv_synic';
6958 push @$cpuFlags , 'hv_stimer';
6963 sub windows_version
{
6966 return 0 if !$ostype;
6970 if($ostype eq 'wxp' || $ostype eq 'w2k3' || $ostype eq 'w2k') {
6972 } elsif($ostype eq 'w2k8' || $ostype eq 'wvista') {
6974 } elsif ($ostype =~ m/^win(\d+)$/) {
6981 sub resolve_dst_disk_format
{
6982 my ($storecfg, $storeid, $src_volname, $format) = @_;
6983 my ($defFormat, $validFormats) = PVE
::Storage
::storage_default_format
($storecfg, $storeid);
6986 # if no target format is specified, use the source disk format as hint
6988 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storeid);
6989 $format = qemu_img_format
($scfg, $src_volname);
6995 # test if requested format is supported - else use default
6996 my $supported = grep { $_ eq $format } @$validFormats;
6997 $format = $defFormat if !$supported;
7001 sub resolve_first_disk
{
7003 my @disks = PVE
::QemuServer
::valid_drive_names
();
7005 foreach my $ds (reverse @disks) {
7006 next if !$conf->{$ds};
7007 my $disk = PVE
::QemuServer
::parse_drive
($ds, $conf->{$ds});
7008 next if PVE
::QemuServer
::drive_is_cdrom
($disk);
7015 my ($uuid, $uuid_str);
7016 UUID
::generate
($uuid);
7017 UUID
::unparse
($uuid, $uuid_str);
7021 sub generate_smbios1_uuid
{
7022 return "uuid=".generate_uuid
();
7028 vm_mon_cmd
($vmid, 'nbd-server-stop');
7031 # bash completion helper
7033 sub complete_backup_archives
{
7034 my ($cmdname, $pname, $cvalue) = @_;
7036 my $cfg = PVE
::Storage
::config
();
7040 if ($cvalue =~ m/^([^:]+):/) {
7044 my $data = PVE
::Storage
::template_list
($cfg, $storeid, 'backup');
7047 foreach my $id (keys %$data) {
7048 foreach my $item (@{$data->{$id}}) {
7049 next if $item->{format
} !~ m/^vma\.(gz|lzo)$/;
7050 push @$res, $item->{volid
} if defined($item->{volid
});
7057 my $complete_vmid_full = sub {
7060 my $idlist = vmstatus
();
7064 foreach my $id (keys %$idlist) {
7065 my $d = $idlist->{$id};
7066 if (defined($running)) {
7067 next if $d->{template
};
7068 next if $running && $d->{status
} ne 'running';
7069 next if !$running && $d->{status
} eq 'running';
7078 return &$complete_vmid_full();
7081 sub complete_vmid_stopped
{
7082 return &$complete_vmid_full(0);
7085 sub complete_vmid_running
{
7086 return &$complete_vmid_full(1);
7089 sub complete_storage
{
7091 my $cfg = PVE
::Storage
::config
();
7092 my $ids = $cfg->{ids
};
7095 foreach my $sid (keys %$ids) {
7096 next if !PVE
::Storage
::storage_check_enabled
($cfg, $sid, undef, 1);
7097 next if !$ids->{$sid}->{content
}->{images
};