7 use Errno
qw(ELOOP ENOTDIR EROFS ECONNREFUSED EEXIST);
8 use Fcntl
qw(O_RDONLY O_WRONLY O_NOFOLLOW O_DIRECTORY :mode);
11 use IO
::Poll
qw(POLLIN POLLHUP);
15 use Time
::HiRes qw
(gettimeofday
);
17 use PVE
::AccessControl
;
20 use PVE
::Exception
qw(raise_perm_exc);
22 use PVE
::GuestHelpers
qw(check_vnet_access safe_string_ne safe_num_ne safe_boolean_ne);
24 use PVE
::JSONSchema
qw(get_standard_option);
27 use PVE
::RESTEnvironment
;
40 use PVE
::Syscall
qw(:fsmount);
44 use PVE
::LXC
::Monitor
;
49 require PVE
::Network
::SDN
::Zones
;
50 require PVE
::Network
::SDN
::Vnets
;
54 my $LXC_CONFIG_PATH = '/usr/share/lxc/config';
56 my $nodename = PVE
::INotify
::nodename
();
58 my $cpuinfo= PVE
::ProcFSTools
::read_cpuinfo
();
60 our $NEW_DISK_RE = qr/^([^:\s]+):(\d+(\.\d+)?)$/;
63 my $vmlist = PVE
::Cluster
::get_vmlist
();
65 return $res if !$vmlist || !$vmlist->{ids
};
66 my $ids = $vmlist->{ids
};
68 foreach my $vmid (keys %$ids) {
69 next if !$vmid; # skip CT0
70 my $d = $ids->{$vmid};
71 next if !$d->{node
} || $d->{node
} ne $nodename;
72 next if !$d->{type
} || $d->{type
} ne 'lxc';
73 $res->{$vmid} = { type
=> 'lxc', vmid
=> int($vmid) };
78 # container status helpers
80 sub list_active_containers
{
82 my $filename = "/proc/net/unix";
84 # similar test is used by lcxcontainers.c: list_active_containers
87 my $fh = IO
::File-
>new ($filename, "r");
90 while (defined(my $line = <$fh>)) {
91 if ($line =~ m/^[a-f0-9]+:\s+\S+\s+\S+\s+\S+\s+\S+\s+\S+\s+\d+\s+(\S+)$/) {
93 if ($path =~ m!^@/var/lib/lxc/(\d+)/command$!) {
104 # warning: this is slow
108 my $active_hash = list_active_containers
();
110 return 1 if defined($active_hash->{$vmid});
115 sub get_container_disk_usage
{
116 my ($vmid, $pid) = @_;
118 return PVE
::Tools
::df
("/proc/$pid/root/", 1);
121 my $last_proc_vmid_stat;
123 our $vmstatus_return_properties = {
124 vmid
=> get_standard_option
('pve-vmid'),
126 description
=> "LXC Container status.",
128 enum
=> ['stopped', 'running'],
131 description
=> "Maximum memory in bytes.",
137 description
=> "Maximum SWAP memory in bytes.",
143 description
=> "Root disk size in bytes.",
149 description
=> "Container name.",
154 description
=> "Uptime.",
157 renderer
=> 'duration',
160 description
=> "Maximum usable CPUs.",
165 description
=> "The current config lock, if any.",
170 description
=> "The current configured tags, if any.",
179 my $list = $opt_vmid ?
{ $opt_vmid => { type
=> 'lxc', vmid
=> int($opt_vmid) }} : config_list
();
181 my $active_hash = list_active_containers
();
183 my $cpucount = $cpuinfo->{cpus
} || 1;
185 my $cdtime = gettimeofday
;
187 my $uptime = (PVE
::ProcFSTools
::read_proc_uptime
(1))[0];
188 my $clock_ticks = POSIX
::sysconf
(&POSIX
::_SC_CLK_TCK
);
190 my $unprivileged = {};
192 foreach my $vmid (keys %$list) {
193 my $d = $list->{$vmid};
195 eval { $d->{pid
} = int(find_lxc_pid
($vmid)) if defined($active_hash->{$vmid}); };
196 warn $@ if $@; # ignore errors (consider them stopped)
198 $d->{status
} = $active_hash->{$vmid} ?
'running' : 'stopped';
200 my $cfspath = PVE
::LXC
::Config-
>cfs_config_path($vmid);
201 my $conf = PVE
::Cluster
::cfs_read_file
($cfspath) || {};
203 $unprivileged->{$vmid} = $conf->{unprivileged
};
205 $d->{name
} = $conf->{'hostname'} || "CT$vmid";
206 $d->{name
} =~ s/[\s]//g;
208 $d->{cpus
} = $conf->{cores
} || $conf->{cpulimit
};
209 $d->{cpus
} = $cpucount if !$d->{cpus
};
211 $d->{tags
} = $conf->{tags
} if defined($conf->{tags
});
214 my $res = get_container_disk_usage
($vmid, $d->{pid
});
215 $d->{disk
} = int($res->{used
});
216 $d->{maxdisk
} = int($res->{total
});
219 # use 4GB by default ??
220 if (my $rootfs = $conf->{rootfs
}) {
221 my $rootinfo = PVE
::LXC
::Config-
>parse_volume('rootfs', $rootfs);
222 $d->{maxdisk
} = $rootinfo->{size
} || (4*1024*1024*1024);
224 $d->{maxdisk
} = 4*1024*1024*1024;
230 $d->{maxmem
} = ($conf->{memory
}||512)*1024*1024;
231 $d->{maxswap
} = ($conf->{swap
}//0)*1024*1024;
242 $d->{template
} = 1 if PVE
::LXC
::Config-
>is_template($conf);
243 $d->{lock} = $conf->{lock} if $conf->{lock};
246 foreach my $vmid (keys %$list) {
247 my $d = $list->{$vmid};
250 next if !$pid; # skip stopped CTs
252 my $proc_pid_stat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
253 $d->{uptime
} = int(($uptime - $proc_pid_stat->{starttime
}) / $clock_ticks); # the method lxcfs uses
255 my $unpriv = $unprivileged->{$vmid};
257 my $cgroups = PVE
::LXC
::CGroup-
>new($vmid);
259 if (defined(my $mem = $cgroups->get_memory_stat())) {
260 $d->{mem
} = int($mem->{mem
});
261 $d->{swap
} = int($mem->{swap
});
267 if (defined(my $blkio = $cgroups->get_io_stats())) {
268 $d->{diskread
} = int($blkio->{diskread
});
269 $d->{diskwrite
} = int($blkio->{diskwrite
});
275 if (defined(my $cpu = $cgroups->get_cpu_stat())) {
276 # Total time (in milliseconds) used up by the cpu.
277 my $used_ms = $cpu->{utime} + $cpu->{stime
};
279 my $old = $last_proc_vmid_stat->{$vmid};
281 $last_proc_vmid_stat->{$vmid} = {
289 my $delta_ms = ($cdtime - $old->{time}) * $cpucount * 1000.0;
290 if ($delta_ms > 1000.0) {
291 my $delta_used_ms = $used_ms - $old->{used
};
292 $d->{cpu
} = (($delta_used_ms / $delta_ms) * $cpucount) / $d->{cpus
};
293 $last_proc_vmid_stat->{$vmid} = {
299 $d->{cpu
} = $old->{cpu
};
306 my $netdev = PVE
::ProcFSTools
::read_proc_net_dev
();
308 foreach my $dev (keys %$netdev) {
309 next if $dev !~ m/^veth([1-9]\d*)i/;
311 my $d = $list->{$vmid};
315 $d->{netout
} += $netdev->{$dev}->{receive
};
316 $d->{netin
} += $netdev->{$dev}->{transmit
};
323 sub find_lxc_console_pids
{
327 PVE
::Tools
::dir_glob_foreach
('/proc', '\d+', sub {
330 my $cmdline = PVE
::Tools
::file_read_firstline
("/proc/$pid/cmdline");
333 my @args = split(/\0/, $cmdline);
335 # search for lxc-console -n <vmid>
336 return if scalar(@args) != 3;
337 return if $args[1] ne '-n';
338 return if $args[2] !~ m/^\d+$/;
339 return if $args[0] !~ m
|^(/usr/bin
/)?lxc-console
$|;
343 push @{$res->{$vmid}}, $pid;
355 $pid = $1 if $line =~ m/^PID:\s+(\d+)$/;
357 PVE
::Tools
::run_command
(['lxc-info', '-n', $vmid, '-p'], outfunc
=> $parser);
359 die "unable to get PID for CT $vmid (not running?)\n" if !$pid;
366 sysopen(my $fd, "/proc/$pid", O_RDONLY
| O_DIRECTORY
)
367 or die "failed to open /proc/$pid pid fd\n";
374 # Find the pid and open:
375 my $pid = find_lxc_pid
($vmid);
376 my $fd = open_pid_fd
($pid);
379 my $pid2 = find_lxc_pid
($vmid);
381 return () if $pid != $pid2;
388 # Find the parent pid via proc and open it:
389 my $stat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
390 my $ppid = $stat->{ppid
} // die "failed to get parent pid\n";
392 my $fd = open_pid_fd
($ppid);
395 $stat = PVE
::ProcFSTools
::read_proc_pid_stat
($pid);
396 my $ppid2 = $stat->{ppid
} // die "failed to get parent pid for verification\n";
398 return () if $ppid != $ppid2;
402 # Note: we cannot use Net:IP, because that only allows strict
404 sub parse_ipv4_cidr
{
405 my ($cidr, $noerr) = @_;
407 if ($cidr =~ m!^($IPV4RE)(?:/(\d+))$! && ($2 > 7) && ($2 <= 32)) {
408 return { address
=> $1, netmask
=> $PVE::Network
::ipv4_reverse_mask-
>[$2] };
411 return undef if $noerr;
413 die "unable to parse ipv4 address/mask\n";
416 # With seccomp trap to userspace we now have the ability to optionally forward
417 # certain syscalls to the "host" to handle (via our pve-lxc-syscalld daemon).
419 # This means that there are cases where we need to create an extra seccomp
420 # profile for the container to load.
422 # This returns a configuration snippet added to the raw lxc config.
423 sub make_seccomp_config
{
424 my ($conf, $vmid, $conf_dir, $unprivileged, $features) = @_;
425 # User-configured profile has precedence, note that the user's entry would
426 # be written 'after' this line anyway...
427 if (PVE
::LXC
::Config-
>has_lxc_entry($conf, 'lxc.seccomp.profile')) {
428 # Warn the user if this conflicts with a feature:
429 my $warn = join(', ', grep { $features->{$_} } qw(keyctl mknod));
430 warn "explicitly configured lxc.seccomp.profile overrides the following settings: $warn\n"
431 if length($warn) > 0;
435 # Privileged containers keep using the default (which is already part of
436 # the files included via lxc.include, so we don't need to write it out,
437 # that way it stays admin-configurable via /usr/share/lxc/config/... as
439 return '' if !$unprivileged;
442 keyctl
=> ['errno 38'],
444 # Disable btrfs ioctrls since they don't work particularly well in user namespaces.
445 # Particularly, without the mount option to enable rmdir removing snapshots, user
446 # namespaces can create snapshots but neither `show` or `delete` them, which is quite
447 # horrible, so for now, just disable this entirely:
449 # BTRFS_IOCTL_MAGIC 0x94, _IOC type shift is 8,
450 # so `(req & 0xFF00) == 0x9400` is a btrfs ioctl and gets an EPERM
451 ioctl => ['errno 1 [1,0x9400,SCMP_CMP_MASKED_EQ,0xff00]'],
456 # Unprivileged containers will get keyctl() disabled by default as a
457 # workaround for systemd-networkd behavior. But we have an option to
458 # explicitly enable it:
459 if ($features->{keyctl
}) {
460 delete $rules->{keyctl
};
463 # By default, unprivileged containers cannot use `mknod` at all.
464 # Since lxc 3.2, we can use seccomp's trap to userspace feature for this,
465 # but for now this is experimental, so it has to be enabled via a feature
467 # Note that we only handle block and char devices (like lxd), the rest we
468 # leave up to the kernel. We may in the future remove this if seccomp gets
469 # a way to tell the kernel to "continue" a syscall.
470 if ($features->{mknod
}) {
471 my ($ok, $kernel) = PVE
::ProcFSTools
::check_kernel_release
(5, 3);
473 die "'mknod' feature requested, but kernel too old (found $kernel, required >= 5.3)\n";
476 $raw_conf .= "lxc.seccomp.notify.proxy = unix:/run/pve/lxc-syscalld.sock\n";
477 $raw_conf .= "lxc.seccomp.notify.cookie = $vmid\n";
480 # condition: (mode & S_IFMT) == S_IFCHR
481 'notify [1,8192,SCMP_CMP_MASKED_EQ,61440]',
482 # condition: (mode & S_IFMT) == S_IFBLK
483 'notify [1,24576,SCMP_CMP_MASKED_EQ,61440]',
485 $rules->{mknodat
} = [
486 # condition: (mode & S_IFMT) == S_IFCHR
487 'notify [2,8192,SCMP_CMP_MASKED_EQ,61440]',
488 # condition: (mode & S_IFMT) == S_IFBLK
489 'notify [2,24576,SCMP_CMP_MASKED_EQ,61440]',
493 # Now build the custom seccomp rule text...
494 my $extra_rules = join("\n", map {
496 map { "$syscall $_" } $rules->{$syscall}->@*
497 } sort keys %$rules) . "\n";
499 return $raw_conf if $extra_rules eq "\n";
501 # We still have the "most common" config readily available, so don't write
503 if ($raw_conf eq '' && $extra_rules eq "keyctl errno 38\n") {
504 # we have no extra $raw_conf and use the same we had in pve 6.1:
505 return "lxc.seccomp.profile = $LXC_CONFIG_PATH/pve-userns.seccomp\n";
508 # Write the rule file to the container's config path:
509 my $rule_file = "$conf_dir/rules.seccomp";
510 my $rule_data = file_get_contents
("$LXC_CONFIG_PATH/common.seccomp")
512 file_set_contents
($rule_file, $rule_data);
513 $raw_conf .= "lxc.seccomp.profile = $rule_file\n";
518 # Since lxc-3.0.2 we can have lxc generate a profile for the container
519 # automatically. The default should be equivalent to the old
520 # `lxc-container-default-cgns` profile.
522 # Additionally this also added `lxc.apparmor.raw` which can be used to inject
523 # additional lines into the profile. We can use that to allow mounting specific
525 sub make_apparmor_config
{
526 my ($conf, $unprivileged, $features) = @_;
528 # user-configured profile has precedence, but first we go through our own
529 # code to figure out whether we should warn the user:
531 my $raw = "lxc.apparmor.profile = generated\n";
534 if ($features->{fuse
}) {
535 # For the informational warning:
536 push @profile_uses, 'features:fuse';
539 # There's lxc.apparmor.allow_nesting now, which will add the necessary
540 # apparmor lines, create an apparmor namespace for the container, but also
541 # adds proc and sysfs mounts to /dev/.lxc/{proc,sys}. These do not have
542 # lxcfs mounted over them, because that would prevent the container from
543 # mounting new instances of them for nested containers.
544 if ($features->{nesting
}) {
545 push @profile_uses, 'features:nesting';
546 $raw .= "lxc.apparmor.allow_nesting = 1\n"
548 # In the default profile in /etc/apparmor.d we patch this in because
549 # otherwise a container can for example run `chown` on /sys, breaking
550 # access to it for non-CAP_DAC_OVERRIDE tools on the host:
551 $raw .= "lxc.apparmor.raw = deny mount -> /proc/,\n";
552 $raw .= "lxc.apparmor.raw = deny mount -> /sys/,\n";
553 # Preferably we could use the 'remount' flag but this does not sit well
554 # with apparmor_parser currently:
555 # mount options=(rw, nosuid, nodev, noexec, remount) -> /sys/,
558 if (my $mount = $features->{mount
}) {
559 push @profile_uses, 'features:mount';
560 foreach my $fs (PVE
::Tools
::split_list
($mount)) {
561 $raw .= "lxc.apparmor.raw = mount fstype=$fs,\n";
567 if (PVE
::LXC
::Config-
>has_lxc_entry($conf, 'lxc.apparmor.profile')) {
568 if (length(my $used = join(', ', @profile_uses))) {
569 warn "explicitly configured lxc.apparmor.profile overrides the following settings: $used\n";
577 sub update_lxc_config
{
578 my ($vmid, $conf) = @_;
580 my $dir = "/var/lib/lxc/$vmid";
582 if ($conf->{template
}) {
584 unlink "$dir/config";
589 my ($lxc_major, $lxc_minor) = get_lxc_version
();
593 if ($lxc_major >= 4) {
594 # Explicitly don't use relative directories, which is the default, but
595 # note that we do this mostly because they are only applied for *some*
596 # cgroups. Our pve-container@.service now starts lxc-start with `-F`,
597 # so we also don't need to worry about the new monitor cgroup to
599 $raw .= "lxc.cgroup.relative = 0\n";
601 # To make things easier, let's keep our previous cgroup layout and
602 # simply move the monitor outside:
603 $raw .= "lxc.cgroup.dir.monitor = lxc.monitor/$vmid\n";
604 # cgroup namespace separation for stronger limits:
605 $raw .= "lxc.cgroup.dir.container = lxc/$vmid\n";
606 $raw .= "lxc.cgroup.dir.container.inner = ns\n";
609 die "missing 'arch' - internal error" if !$conf->{arch
};
610 $raw .= "lxc.arch = $conf->{arch}\n";
612 my $custom_idmap = PVE
::LXC
::Config-
>has_lxc_entry($conf, 'lxc.idmap');
613 my $unprivileged = $conf->{unprivileged
} || $custom_idmap;
615 my $ostype = $conf->{ostype
} || die "missing 'ostype' - internal error";
617 File
::Path
::mkpath
($dir);
619 my $cfgpath = '/usr/share/lxc/config';
620 my $inc = "$cfgpath/$ostype.common.conf";
621 $inc ="$cfgpath/common.conf" if !-f
$inc;
622 $raw .= "lxc.include = $inc\n";
624 $inc = "$cfgpath/$ostype.userns.conf";
625 $inc = "$cfgpath/userns.conf" if !-f
$inc;
626 $raw .= "lxc.include = $inc\n";
629 my $features = PVE
::LXC
::Config-
>parse_features($conf->{features
});
631 $raw .= make_seccomp_config
($conf, $vmid, $dir, $unprivileged, $features);
632 $raw .= make_apparmor_config
($conf, $unprivileged, $features);
633 if ($features->{fuse
}) {
634 $raw .= "lxc.apparmor.raw = mount fstype=fuse,\n";
635 $raw .= "lxc.mount.entry = /dev/fuse dev/fuse none bind,create=file 0 0\n";
638 if ($unprivileged && !$features->{force_rw_sys
}) {
639 # unpriv. CT default to sys:rw, but that doesn't always plays well with
640 # systemd, e.g., systemd-networkd https://systemd.io/CONTAINER_INTERFACE/
641 $raw .= "lxc.mount.auto = sys:mixed\n";
644 PVE
::LXC
::Config-
>foreach_passthrough_device($conf, sub {
645 my ($key, $device) = @_;
647 die "Path is not defined for passthrough device $key\n"
648 if !defined($device->{path
});
650 my ($mode, $rdev) = PVE
::LXC
::Tools
::get_device_mode_and_rdev
($device->{path
});
651 my $major = PVE
::Tools
::dev_t_major
($rdev);
652 my $minor = PVE
::Tools
::dev_t_minor
($rdev);
653 my $device_type_char = S_ISBLK
($mode) ?
'b' : 'c';
654 $raw .= "lxc.cgroup2.devices.allow = $device_type_char $major:$minor rw\n";
657 # WARNING: DO NOT REMOVE this without making sure that loop device nodes
658 # cannot be exposed to the container with r/w access (cgroup perms).
659 # When this is enabled mounts will still remain in the monitor's namespace
660 # after the container unmounted them and thus will not detach from their
661 # files while the container is running!
662 $raw .= "lxc.monitor.unshare = 1\n";
664 my ($cgv1, $cgv2) = PVE
::CGroup
::get_cgroup_controllers
();
666 # Should we read them from /etc/subuid?
667 if ($unprivileged && !$custom_idmap) {
668 $raw .= "lxc.idmap = u 0 100000 65536\n";
669 $raw .= "lxc.idmap = g 0 100000 65536\n";
672 if (!PVE
::LXC
::Config-
>has_dev_console($conf)) {
673 $raw .= "lxc.console.path = none\n";
674 if ($cgv1->{devices
}) {
675 $raw .= "lxc.cgroup.devices.deny = c 5:1 rwm\n";
676 } elsif (defined($cgv2)) {
677 $raw .= "lxc.cgroup2.devices.deny = c 5:1 rwm\n";
681 my $ttycount = PVE
::LXC
::Config-
>get_tty_count($conf);
682 $raw .= "lxc.tty.max = $ttycount\n";
684 # some init scripts expect a linux terminal (turnkey).
685 $raw .= "lxc.environment = TERM=linux\n";
687 my $utsname = $conf->{hostname
} || "CT$vmid";
688 $raw .= "lxc.uts.name = $utsname\n";
690 if ($cgv1->{memory
}) {
691 my $memory = $conf->{memory
} || 512;
692 my $swap = $conf->{swap
} // 0;
694 my $lxcmem = int($memory*1024*1024);
695 $raw .= "lxc.cgroup.memory.limit_in_bytes = $lxcmem\n";
697 my $lxcswap = int(($memory + $swap)*1024*1024);
698 $raw .= "lxc.cgroup.memory.memsw.limit_in_bytes = $lxcswap\n";
699 } elsif ($cgv2->{memory
}) {
700 my $memory = $conf->{memory
} || 512;
701 my $swap = $conf->{swap
} // 0;
703 # cgroup memory usage is limited by the hard 'max' limit (OOM-killer enforced) and the soft
704 # 'high' limit (cgroup processes get throttled and put under heavy reclaim pressure).
705 my ($lxc_mem_max, $lxc_mem_high) = PVE
::LXC
::Config
::calculate_memory_constraints
($memory);
706 $raw .= "lxc.cgroup2.memory.max = $lxc_mem_max\n";
707 $raw .= "lxc.cgroup2.memory.high = $lxc_mem_high\n";
709 my $lxcswap = int($swap*1024*1024);
710 $raw .= "lxc.cgroup2.memory.swap.max = $lxcswap\n";
714 if (my $cpulimit = $conf->{cpulimit
}) {
715 $raw .= "lxc.cgroup.cpu.cfs_period_us = 100000\n";
716 my $value = int(100000*$cpulimit);
717 $raw .= "lxc.cgroup.cpu.cfs_quota_us = $value\n";
720 my $shares = PVE
::CGroup
::clamp_cpu_shares
($conf->{cpuunits
});
721 $raw .= "lxc.cgroup.cpu.shares = $shares\n";
722 } elsif ($cgv2->{cpu
}) {
724 if (my $cpulimit = $conf->{cpulimit
}) {
725 my $value = int(100000*$cpulimit);
726 $raw .= "lxc.cgroup2.cpu.max = $value 100000\n";
729 if (defined(my $shares = $conf->{cpuunits
})) {
730 $shares = PVE
::CGroup
::clamp_cpu_shares
($shares);
731 $raw .= "lxc.cgroup2.cpu.weight = $shares\n";
735 die "missing 'rootfs' configuration\n"
736 if !defined($conf->{rootfs
});
738 my $mountpoint = PVE
::LXC
::Config-
>parse_volume('rootfs', $conf->{rootfs
});
740 $raw .= "lxc.rootfs.path = $dir/rootfs\n";
742 foreach my $k (sort keys %$conf) {
743 next if $k !~ m/^net(\d+)$/;
745 my $d = PVE
::LXC
::Config-
>parse_lxc_network($conf->{$k});
746 $raw .= "lxc.net.$ind.type = veth\n";
747 $raw .= "lxc.net.$ind.veth.pair = veth${vmid}i${ind}\n";
748 $raw .= "lxc.net.$ind.hwaddr = $d->{hwaddr}\n" if defined($d->{hwaddr
});
749 $raw .= "lxc.net.$ind.name = $d->{name}\n" if defined($d->{name
});
751 my $bridge_mtu = PVE
::Network
::read_bridge_mtu
($d->{bridge
});
752 my $mtu = $d->{mtu
} || $bridge_mtu;
754 # Keep container from starting with invalid mtu configuration
755 die "$k: MTU size '$mtu' is bigger than bridge MTU '$bridge_mtu'\n"
756 if ($mtu > $bridge_mtu);
758 $raw .= "lxc.net.$ind.mtu = $mtu\n";
760 # Starting with lxc 4.0, we do not patch lxc to execute our up-scripts.
761 if ($lxc_major >= 4) {
762 $raw .= "lxc.net.$ind.script.up = /usr/share/lxc/lxcnetaddbr\n";
767 if (my $lxcconf = $conf->{lxc
}) {
768 foreach my $entry (@$lxcconf) {
769 my ($k, $v) = @$entry;
770 $had_cpuset = 1 if $k eq 'lxc.cgroup.cpuset.cpus' || $k eq 'lxc.cgroup2.cpuset.cpus';
776 my ($cpuset_cgroup, $cpuset_version) = eval { PVE
::CGroup
::cpuset_controller_path
() };
777 if (defined($cpuset_cgroup)) {
778 $cpuset = eval { PVE
::CpuSet-
>new_from_path("$cpuset_cgroup/lxc", 1) }
779 || PVE
::CpuSet-
>new_from_path($cpuset_cgroup, 1);
781 my $cores = $conf->{cores
};
782 if (!$had_cpuset && $cores && $cpuset) {
783 my @members = $cpuset->members();
784 while (scalar(@members) > $cores) {
785 my $randidx = int(rand(scalar(@members)));
786 $cpuset->delete($members[$randidx]);
787 splice(@members, $randidx, 1); # keep track of the changes
789 my $ver = $cpuset_version == 1 ?
'' : '2';
790 $raw .= "lxc.cgroup$ver.cpuset.cpus = ".$cpuset->short_string()."\n";
793 File
::Path
::mkpath
("$dir/rootfs");
795 PVE
::Tools
::file_set_contents
("$dir/config", $raw);
798 # verify and cleanup nameserver list (replace \0 with ' ')
799 sub verify_nameserver_list
{
800 my ($nameserver_list) = @_;
803 foreach my $server (PVE
::Tools
::split_list
($nameserver_list)) {
804 PVE
::LXC
::Config
::verify_ip_with_ll_iface
($server);
808 return join(' ', @list);
811 sub verify_searchdomain_list
{
812 my ($searchdomain_list) = @_;
815 foreach my $server (PVE
::Tools
::split_list
($searchdomain_list)) {
816 # todo: should we add checks for valid dns domains?
820 return join(' ', @list);
823 sub get_console_command
{
824 my ($vmid, $conf, $escapechar) = @_;
826 # '-1' as $escapechar disables keyboard escape sequence
827 # any other passed char (a-z) will result in <Ctrl+$escapechar q>
829 my $cmode = PVE
::LXC
::Config-
>get_cmode($conf);
832 if ($cmode eq 'console') {
833 push @$cmd, 'lxc-console', '-n', $vmid, '-t', 0;
834 push @$cmd, '-e', $escapechar if $escapechar;
835 } elsif ($cmode eq 'tty') {
836 push @$cmd, 'lxc-console', '-n', $vmid;
837 push @$cmd, '-e', $escapechar if $escapechar;
838 } elsif ($cmode eq 'shell') {
839 push @$cmd, 'lxc-attach', '--clear-env', '-n', $vmid;
841 die "internal error";
847 sub get_primary_ips
{
850 # return data from net0
852 return undef if !defined($conf->{net0
});
853 my $net = PVE
::LXC
::Config-
>parse_lxc_network($conf->{net0
});
855 my $ipv4 = $net->{ip
};
857 if ($ipv4 =~ /^(dhcp|manual)$/) {
863 my $ipv6 = $net->{ip6
};
865 if ($ipv6 =~ /^(auto|dhcp|manual)$/) {
872 return ($ipv4, $ipv6);
875 sub delete_mountpoint_volume
{
876 my ($storage_cfg, $vmid, $volume) = @_;
878 return if PVE
::LXC
::Config-
>classify_mountpoint($volume) ne 'volume';
880 my ($vtype, $name, $owner) = PVE
::Storage
::parse_volname
($storage_cfg, $volume);
882 if ($vmid == $owner) {
883 PVE
::Storage
::vdisk_free
($storage_cfg, $volume);
885 warn "ignore deletion of '$volume', CT $vmid isn't the owner!\n";
889 sub destroy_lxc_container
{
890 my ($storage_cfg, $vmid, $conf, $replacement_conf, $purge_unreferenced) = @_;
893 my $remove_volume = sub {
894 my ($ms, $mountpoint) = @_;
896 my $volume = $mountpoint->{volume
};
898 return if $volids->{$volume};
899 $volids->{$volume} = 1;
901 delete_mountpoint_volume
($storage_cfg, $vmid, $volume);
903 PVE
::LXC
::Config-
>foreach_volume_full($conf, {include_unused
=> 1}, $remove_volume);
905 PVE
::LXC
::Config-
>foreach_volume_full($conf->{pending
}, {include_unused
=> 1}, $remove_volume);
907 if ($purge_unreferenced) { # also remove unreferenced disk
908 my $vmdisks = PVE
::Storage
::vdisk_list
($storage_cfg, undef, $vmid, undef, 'rootdir');
909 PVE
::Storage
::foreach_volid
($vmdisks, sub {
910 my ($volid, $sid, $volname, $d) = @_;
911 eval { PVE
::Storage
::vdisk_free
($storage_cfg, $volid) };
916 delete_ifaces_ipams_ips
($conf, $vmid);
918 rmdir "/var/lib/lxc/$vmid/rootfs";
919 unlink "/var/lib/lxc/$vmid/config";
920 rmdir "/var/lib/lxc/$vmid";
921 if (defined $replacement_conf) {
922 PVE
::LXC
::Config-
>write_config($vmid, $replacement_conf);
924 PVE
::LXC
::Config-
>destroy_config($vmid);
928 sub vm_stop_cleanup
{
929 my ($storage_cfg, $vmid, $conf, $keepActive) = @_;
931 return if $keepActive;
934 my $vollist = PVE
::LXC
::Config-
>get_vm_volumes($conf);
935 PVE
::Storage
::deactivate_volumes
($storage_cfg, $vollist);
937 warn $@ if $@; # avoid errors - just warn
940 sub net_tap_plug
: prototype($$) {
941 my ($iface, $net) = @_;
943 if (defined($net->{link_down
})) {
944 PVE
::Tools
::run_command
(['/sbin/ip', 'link', 'set', 'dev', $iface, 'down']);
945 # Don't add disconnected interfaces to the bridge, otherwise e.g. applying any network
946 # change (e.g. `ifreload -a`) could (re-)activate it unintentionally.
950 my ($bridge, $tag, $trunks, $rate, $hwaddr) =
951 $net->@{'bridge', 'tag', 'trunks', 'rate', 'hwaddr'};
953 # The nftable-based implementation from the newer proxmox-firewall does not requires FW bridges
954 my $create_firewall_bridges = $net->{firewall
} && !PVE
::Firewall
::is_nftables
();
957 PVE
::Network
::SDN
::Zones
::tap_plug
($iface, $bridge, $tag, $create_firewall_bridges, $trunks, $rate);
958 PVE
::Network
::SDN
::Zones
::add_bridge_fdb
($iface, $hwaddr, $bridge);
960 PVE
::Network
::tap_plug
($iface, $bridge, $tag, $create_firewall_bridges, $trunks, $rate, { mac
=> $hwaddr });
963 PVE
::Tools
::run_command
(['/sbin/ip', 'link', 'set', 'dev', $iface, 'up']);
967 my ($vmid, $conf, $opt, $newnet, $netid, $rootdir) = @_;
969 if ($newnet->{type
} ne 'veth') {
970 # for when there are physical interfaces
971 die "cannot update interface of type $newnet->{type}";
974 my $veth = "veth${vmid}i${netid}";
975 my $eth = $newnet->{name
};
977 if (my $oldnetcfg = $conf->{$opt}) {
978 my $oldnet = PVE
::LXC
::Config-
>parse_lxc_network($oldnetcfg);
980 if (safe_string_ne
($oldnet->{hwaddr
}, $newnet->{hwaddr
}) ||
981 safe_string_ne
($oldnet->{name
}, $newnet->{name
})) {
983 PVE
::Network
::veth_delete
($veth);
985 if ($have_sdn && safe_string_ne
($oldnet->{hwaddr
}, $newnet->{hwaddr
})) {
986 eval { PVE
::Network
::SDN
::Vnets
::del_ips_from_mac
($oldnet->{bridge
}, $oldnet->{hwaddr
}, $conf->{hostname
}) };
989 PVE
::Network
::SDN
::Vnets
::add_next_free_cidr
($newnet->{bridge
}, $conf->{hostname
}, $newnet->{hwaddr
}, $vmid, undef, 1);
990 PVE
::Network
::SDN
::Vnets
::add_dhcp_mapping
($newnet->{bridge
}, $newnet->{hwaddr
}, $vmid, $conf->{hostname
});
993 delete $conf->{$opt};
994 PVE
::LXC
::Config-
>write_config($vmid, $conf);
996 hotplug_net
($vmid, $conf, $opt, $newnet, $netid);
999 my $bridge_changed = safe_string_ne
($oldnet->{bridge
}, $newnet->{bridge
});
1001 if ($bridge_changed ||
1002 safe_num_ne
($oldnet->{tag
}, $newnet->{tag
}) ||
1003 safe_num_ne
($oldnet->{firewall
}, $newnet->{firewall
}) ||
1004 safe_boolean_ne
($oldnet->{link_down
}, $newnet->{link_down
})
1006 if ($oldnet->{bridge
}) {
1007 my $oldbridge = $oldnet->{bridge
};
1009 PVE
::Network
::tap_unplug
($veth);
1010 foreach (qw(bridge tag firewall)) {
1011 delete $oldnet->{$_};
1013 $conf->{$opt} = PVE
::LXC
::Config-
>print_lxc_network($oldnet);
1014 PVE
::LXC
::Config-
>write_config($vmid, $conf);
1016 if ($have_sdn && $bridge_changed) {
1017 eval { PVE
::Network
::SDN
::Vnets
::del_ips_from_mac
($oldbridge, $oldnet->{hwaddr
}, $conf->{hostname
}) };
1022 if ($have_sdn && $bridge_changed) {
1023 PVE
::Network
::SDN
::Vnets
::add_next_free_cidr
($newnet->{bridge
}, $conf->{hostname
}, $newnet->{hwaddr
}, $vmid, undef, 1);
1025 PVE
::LXC
::net_tap_plug
($veth, $newnet);
1027 # This includes the rate:
1028 foreach (qw(bridge tag firewall rate link_down)) {
1029 $oldnet->{$_} = $newnet->{$_} if $newnet->{$_};
1031 } elsif (safe_string_ne
($oldnet->{rate
}, $newnet->{rate
})) {
1032 # Rate can be applied on its own but any change above needs to
1033 # include the rate in tap_plug since OVS resets everything.
1034 PVE
::Network
::tap_rate_limit
($veth, $newnet->{rate
});
1035 $oldnet->{rate
} = $newnet->{rate
}
1037 $conf->{$opt} = PVE
::LXC
::Config-
>print_lxc_network($oldnet);
1038 PVE
::LXC
::Config-
>write_config($vmid, $conf);
1042 PVE
::Network
::SDN
::Vnets
::add_next_free_cidr
($newnet->{bridge
}, $conf->{hostname
}, $newnet->{hwaddr
}, $vmid, undef, 1);
1043 PVE
::Network
::SDN
::Vnets
::add_dhcp_mapping
($newnet->{bridge
}, $newnet->{hwaddr
}, $vmid, $conf->{hostname
});
1046 hotplug_net
($vmid, $conf, $opt, $newnet, $netid);
1049 update_ipconfig
($vmid, $conf, $opt, $eth, $newnet, $rootdir);
1053 my ($vmid, $conf, $opt, $newnet, $netid) = @_;
1055 my $veth = "veth${vmid}i${netid}";
1056 my $vethpeer = $veth . "p";
1057 my $eth = $newnet->{name
};
1060 PVE
::Network
::SDN
::Zones
::veth_create
($veth, $vethpeer, $newnet->{bridge
}, $newnet->{hwaddr
});
1062 PVE
::Network
::veth_create
($veth, $vethpeer, $newnet->{bridge
}, $newnet->{hwaddr
});
1065 PVE
::LXC
::net_tap_plug
($veth, $newnet);
1067 # attach peer in container
1068 my $cmd = ['lxc-device', '-n', $vmid, 'add', $vethpeer, "$eth" ];
1069 PVE
::Tools
::run_command
($cmd);
1071 # link up peer in container
1072 $cmd = ['lxc-attach', '-n', $vmid, '-s', 'NETWORK', '--', '/sbin/ip', 'link', 'set', $eth ,'up' ];
1073 PVE
::Tools
::run_command
($cmd);
1075 my $done = { type
=> 'veth' };
1076 foreach (qw(bridge tag firewall hwaddr name link_down)) {
1077 $done->{$_} = $newnet->{$_} if $newnet->{$_};
1079 $conf->{$opt} = PVE
::LXC
::Config-
>print_lxc_network($done);
1081 PVE
::LXC
::Config-
>write_config($vmid, $conf);
1084 sub get_interfaces
{
1087 my $pid = eval { find_lxc_pid
($vmid); };
1091 # enters the network namespace of the container and executes 'ip a'
1092 run_command
(['nsenter', '-t', $pid, '--net', '--', 'ip', '--json', 'a'],
1093 outfunc
=> sub { $output .= shift; });
1095 my $config = JSON
::decode_json
($output);
1098 for my $interface ($config->@*) {
1099 my $obj = { name
=> $interface->{ifname
} };
1100 for my $ip ($interface->{addr_info
}->@*) {
1101 $obj->{$ip->{family
}} = $ip->{local} . "/" . $ip->{prefixlen
};
1103 $obj->{hwaddr
} = $interface->{address
};
1110 sub update_ipconfig
{
1111 my ($vmid, $conf, $opt, $eth, $newnet, $rootdir) = @_;
1113 my $lxc_setup = PVE
::LXC
::Setup-
>new($conf, $rootdir);
1115 my $optdata = PVE
::LXC
::Config-
>parse_lxc_network($conf->{$opt});
1119 my $cmdargs = shift;
1120 PVE
::Tools
::run_command
(['lxc-attach', '-n', $vmid, '-s', 'NETWORK', '--', @_], %$cmdargs);
1122 my $ipcmd = sub { &$nscmd({}, '/sbin/ip', @_) };
1124 my $change_ip_config = sub {
1125 my ($ipversion) = @_;
1127 my $family_opt = "-$ipversion";
1128 my $suffix = $ipversion == 4 ?
'' : $ipversion;
1129 my $gw= "gw$suffix";
1130 my $ip= "ip$suffix";
1132 my $newip = $newnet->{$ip};
1133 my $newgw = $newnet->{$gw};
1134 my $oldip = $optdata->{$ip};
1135 my $oldgw = $optdata->{$gw};
1137 my $change_ip = safe_string_ne
($oldip, $newip);
1138 my $change_gw = safe_string_ne
($oldgw, $newgw);
1140 return if !$change_ip && !$change_gw;
1142 # step 1: add new IP, if this fails we cancel
1143 my $is_real_ip = ($newip && $newip !~ /^(?:auto|dhcp|manual)$/);
1144 if ($change_ip && $is_real_ip) {
1145 eval { &$ipcmd($family_opt, 'addr', 'add', $newip, 'dev', $eth); };
1152 # step 2: replace gateway
1153 # If this fails we delete the added IP and cancel.
1154 # If it succeeds we save the config and delete the old IP, ignoring
1155 # errors. The config is then saved.
1156 # Note: 'ip route replace' can add
1160 if ($is_real_ip && !PVE
::Network
::is_ip_in_cidr
($newgw, $newip, $ipversion)) {
1161 &$ipcmd($family_opt, 'route', 'add', $newgw, 'dev', $eth);
1163 &$ipcmd($family_opt, 'route', 'replace', 'default', 'via', $newgw);
1167 # the route was not replaced, the old IP is still available
1168 # rollback (delete new IP) and cancel
1170 eval { &$ipcmd($family_opt, 'addr', 'del', $newip, 'dev', $eth); };
1171 warn $@ if $@; # no need to die here
1176 eval { &$ipcmd($family_opt, 'route', 'del', 'default'); };
1177 # if the route was not deleted, the guest might have deleted it manually
1181 if ($oldgw && $oldip && !PVE
::Network
::is_ip_in_cidr
($oldgw, $oldip)) {
1182 eval { &$ipcmd($family_opt, 'route', 'del', $oldgw, 'dev', $eth); };
1183 # warn if the route was deleted manually
1188 # from this point on we save the configuration
1189 # step 3: delete old IP ignoring errors
1190 if ($change_ip && $oldip && $oldip !~ /^(?:auto|dhcp)$/) {
1191 # We need to enable promote_secondaries, otherwise our newly added
1192 # address will be removed along with the old one.
1195 if ($ipversion == 4) {
1196 &$nscmd({ outfunc
=> sub { $promote = int(shift) } },
1197 'cat', "/proc/sys/net/ipv4/conf/$eth/promote_secondaries");
1198 &$nscmd({}, 'sysctl', "net.ipv4.conf.$eth.promote_secondaries=1");
1200 &$ipcmd($family_opt, 'addr', 'del', $oldip, 'dev', $eth);
1202 warn $@ if $@; # no need to die here
1204 if ($ipversion == 4) {
1205 &$nscmd({}, 'sysctl', "net.ipv4.conf.$eth.promote_secondaries=$promote");
1209 foreach my $property ($ip, $gw) {
1210 if ($newnet->{$property}) {
1211 $optdata->{$property} = $newnet->{$property};
1213 delete $optdata->{$property};
1216 $conf->{$opt} = PVE
::LXC
::Config-
>print_lxc_network($optdata);
1217 PVE
::LXC
::Config-
>write_config($vmid, $conf);
1218 $lxc_setup->setup_network($conf);
1221 &$change_ip_config(4);
1222 &$change_ip_config(6);
1226 my $open_namespace = sub {
1227 my ($vmid, $pid, $kind) = @_;
1228 sysopen my $fd, "/proc/$pid/ns/$kind", O_RDONLY
1229 or die "failed to open $kind namespace of container $vmid: $!\n";
1233 my $enter_namespace = sub {
1234 my ($vmid, $pid, $kind, $type) = @_;
1235 my $fd = $open_namespace->($vmid, $pid, $kind);
1236 PVE
::Tools
::setns
(fileno($fd), $type)
1237 or die "failed to enter $kind namespace of container $vmid: $!\n";
1241 my $get_container_namespace = sub {
1242 my ($vmid, $pid, $kind) = @_;
1245 if (!defined($pid)) {
1246 # Pin the pid while we're grabbing its stuff from /proc
1247 ($pid, $pidfd) = open_lxc_pid
($vmid)
1248 or die "failed to open pidfd of container $vmid\'s init process\n";
1251 return $open_namespace->($vmid, $pid, $kind);
1254 my $do_syncfs = sub {
1255 my ($vmid, $pid, $socket) = @_;
1257 &$enter_namespace($vmid, $pid, 'mnt', PVE
::Tools
::CLONE_NEWNS
);
1259 # Tell the parent process to start reading our /proc/mounts
1260 print {$socket} "go\n";
1263 # Receive /proc/self/mounts
1264 my $mountdata = do { local $/ = undef; <$socket> };
1280 # Now sync all mountpoints...
1281 my $mounts = PVE
::ProcFSTools
::parse_mounts
($mountdata);
1282 foreach my $mp (@$mounts) {
1283 my ($what, $dir, $fs) = @$mp;
1284 next if $nosyncfs{$fs};
1285 eval { PVE
::Tools
::sync_mountpoint
($dir); };
1290 sub sync_container_namespace
{
1292 my $pid = find_lxc_pid
($vmid);
1294 # SOCK_DGRAM is nicer for barriers but cannot be slurped
1295 socketpair my $pfd, my $cfd, AF_UNIX
, SOCK_STREAM
, PF_UNSPEC
1296 or die "failed to create socketpair: $!\n";
1299 die "fork failed: $!\n" if !defined($child);
1304 &$do_syncfs($vmid, $pid, $cfd);
1314 die "failed to enter container namespace\n" if $go ne "go\n";
1316 open my $mounts, '<', "/proc/$child/mounts"
1317 or die "failed to open container's /proc/mounts: $!\n";
1318 my $mountdata = do { local $/ = undef; <$mounts> };
1320 print {$pfd} $mountdata;
1323 while (waitpid($child, 0) != $child) {}
1324 die "failed to sync container namespace\n" if $? != 0;
1327 sub template_create
{
1328 my ($vmid, $conf) = @_;
1330 my $storecfg = PVE
::Storage
::config
();
1332 PVE
::LXC
::Config-
>foreach_volume($conf, sub {
1333 my ($ms, $mountpoint) = @_;
1335 my $volid = $mountpoint->{volume
};
1337 die "Template feature is not available for '$volid'\n"
1338 if !PVE
::Storage
::volume_has_feature
($storecfg, 'template', $volid);
1341 PVE
::LXC
::Config-
>foreach_volume($conf, sub {
1342 my ($ms, $mountpoint) = @_;
1344 my $volid = $mountpoint->{volume
};
1346 PVE
::Storage
::activate_volumes
($storecfg, [$volid]);
1348 my $template_volid = PVE
::Storage
::vdisk_create_base
($storecfg, $volid);
1349 $mountpoint->{volume
} = $template_volid;
1350 $conf->{$ms} = PVE
::LXC
::Config-
>print_ct_mountpoint($mountpoint, $ms eq "rootfs");
1353 PVE
::LXC
::Config-
>write_config($vmid, $conf);
1356 sub check_ct_modify_config_perm
{
1357 my ($rpcenv, $authuser, $vmid, $pool, $oldconf, $newconf, $delete, $unprivileged) = @_;
1359 return 1 if $authuser eq 'root@pam';
1360 my $storage_cfg = PVE
::Storage
::config
();
1363 my ($opt, $delete) = @_;
1364 if ($opt eq 'cores' || $opt eq 'cpuunits' || $opt eq 'cpulimit') {
1365 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.CPU']);
1366 } elsif ($opt eq 'rootfs' || $opt =~ /^mp\d+$/) {
1367 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Disk']);
1369 my $data = PVE
::LXC
::Config-
>parse_volume($opt, $newconf->{$opt});
1370 raise_perm_exc
("mount point type $data->{type} is only allowed for root\@pam")
1371 if $data->{type
} ne 'volume';
1372 my $volid = $data->{volume
};
1373 if ($volid =~ $NEW_DISK_RE) {
1375 $rpcenv->check($authuser, "/storage/$sid", ['Datastore.AllocateSpace']);
1377 PVE
::Storage
::check_volume_access
(
1386 } elsif ($opt eq 'memory' || $opt eq 'swap') {
1387 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Memory']);
1388 } elsif ($opt =~ m/^net\d+$/) {
1389 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Network']);
1390 check_bridge_access
($rpcenv, $authuser, $oldconf->{$opt}) if $oldconf->{$opt};
1391 check_bridge_access
($rpcenv, $authuser, $newconf->{$opt}) if $newconf->{$opt};
1392 } elsif ($opt =~ m/^dev\d+$/) {
1393 raise_perm_exc
("configuring device passthrough is only allowed for root\@pam");
1394 } elsif ($opt eq 'nameserver' || $opt eq 'searchdomain' || $opt eq 'hostname') {
1395 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Network']);
1396 } elsif ($opt eq 'features') {
1397 raise_perm_exc
("changing feature flags for privileged container is only allowed for root\@pam")
1400 my $nesting_changed = 0;
1401 my $other_changed = 0;
1403 my $features = PVE
::LXC
::Config-
>parse_features($newconf->{$opt});
1404 if (defined($oldconf) && $oldconf->{$opt}) {
1405 # existing container with features
1406 my $old_features = PVE
::LXC
::Config-
>parse_features($oldconf->{$opt});
1407 for my $feature ((keys %$old_features, keys %$features)) {
1408 my $old = $old_features->{$feature} // '';
1409 my $new = $features->{$feature} // '';
1411 if ($feature eq 'nesting') {
1412 $nesting_changed = 1;
1421 # new container or no features defined
1422 if (scalar(keys %$features) == 1 && $features->{nesting
}) {
1423 $nesting_changed = 1;
1424 } elsif (scalar(keys %$features) > 0) {
1429 my $features = PVE
::LXC
::Config-
>parse_features($oldconf->{$opt});
1430 if (scalar(keys %$features) == 1 && $features->{nesting
}) {
1431 $nesting_changed = 1;
1432 } elsif (scalar(keys %$features) > 0) {
1436 raise_perm_exc
("changing feature flags (except nesting) is only allowed for root\@pam")
1438 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Allocate'])
1439 if $nesting_changed;
1440 } elsif ($opt eq 'hookscript') {
1441 # For now this is restricted to root@pam
1442 raise_perm_exc
("changing the hookscript is only allowed for root\@pam");
1443 } elsif ($opt eq 'tags') {
1444 my $old = $oldconf->{$opt};
1445 my $new = $delete ?
'' : $newconf->{$opt};
1446 PVE
::GuestHelpers
::assert_tag_permissions
($vmid, $old, $new, $rpcenv, $authuser);
1448 $rpcenv->check_vm_perm($authuser, $vmid, $pool, ['VM.Config.Options']);
1452 foreach my $opt (keys %$newconf) {
1455 foreach my $opt (@$delete) {
1462 sub check_bridge_access
{
1463 my ($rpcenv, $authuser, $raw) = @_;
1465 return 1 if $authuser eq 'root@pam';
1467 my $net = PVE
::LXC
::Config-
>parse_lxc_network($raw);
1468 my ($bridge, $tag, $trunks) = $net->@{'bridge', 'tag', 'trunks'};
1469 check_vnet_access
($rpcenv, $authuser, $bridge, $tag, $trunks);
1475 my ($vmid, $storage_cfg, $conf, $noerr) = @_;
1477 my $rootdir = "/var/lib/lxc/$vmid/rootfs";
1478 my $volid_list = PVE
::LXC
::Config-
>get_vm_volumes($conf);
1482 PVE
::LXC
::Config-
>foreach_volume_full($conf, {'reverse' => 1}, sub {
1483 my ($ms, $mountpoint) = @_;
1485 my $volid = $mountpoint->{volume
};
1486 my $mount = $mountpoint->{mp
};
1488 return if !$volid || !$mount;
1490 my $mount_path = "$rootdir/$mount";
1491 $mount_path =~ s!/+!/!g;
1493 return if !PVE
::ProcFSTools
::is_mounted
($mount_path);
1496 PVE
::Tools
::run_command
(['umount', '-d', $mount_path]);
1508 return $res; # tell caller if (some) umounts failed for the noerr case
1512 my ($vmid, $storage_cfg, $conf, $ignore_ro) = @_;
1514 my $rootdir = "/var/lib/lxc/$vmid/rootfs";
1515 File
::Path
::make_path
($rootdir);
1517 my $volid_list = PVE
::LXC
::Config-
>get_vm_volumes($conf);
1518 PVE
::Storage
::activate_volumes
($storage_cfg, $volid_list);
1520 my (undef, $root_uid, $root_gid) = parse_id_maps
($conf);
1523 PVE
::LXC
::Config-
>foreach_volume($conf, sub {
1524 my ($ms, $mountpoint) = @_;
1526 $mountpoint->{ro
} = 0 if $ignore_ro;
1528 mountpoint_mount
($mountpoint, $rootdir, $storage_cfg, undef, $root_uid, $root_gid);
1532 warn "mounting container failed\n";
1533 umount_all
($vmid, $storage_cfg, $conf, 1);
1541 sub mountpoint_mount_path
{
1542 my ($mountpoint, $storage_cfg, $snapname) = @_;
1544 return mountpoint_mount
($mountpoint, undef, $storage_cfg, $snapname);
1552 if ($line =~ m
@^(/dev/loop\d
+):@) {
1556 my $cmd = ['losetup', '--associated', $path];
1557 PVE
::Tools
::run_command
($cmd, outfunc
=> $parser);
1561 # Run a function with a file attached to a loop device.
1562 # The loop device is always detached afterwards (or set to autoclear).
1563 # Returns the loop device.
1564 sub run_with_loopdev
{
1565 my ($func, $file, $readonly) = @_;
1566 my $device = query_loopdev
($file);
1567 # Try to reuse an existing device
1569 # We assume that whoever setup the loop device is responsible for
1577 if ($line =~ m
@^(/dev/loop\d
+)$@) {
1587 push @$losetup_cmd, '-r' if $readonly;
1588 PVE
::Tools
::run_command
($losetup_cmd, outfunc
=> $parser);
1589 die "failed to setup loop device for $file\n" if !$device;
1590 eval { &$func($device); };
1592 PVE
::Tools
::run_command
(['losetup', '-d', $device]);
1597 # In scalar mode: returns a file handle to the deepest directory node.
1598 # In list context: returns a list of:
1599 # * the deepest directory node
1600 # * the 2nd deepest directory (parent of the above)
1601 # * directory name of the last directory
1602 # So that the path $2/$3 should lead to $1 afterwards.
1603 sub walk_tree_nofollow
($$$;$$) {
1604 my ($start, $subdir, $mkdir, $root_uid, $root_gid) = @_;
1606 sysopen(my $fd, $start, O_PATH
| O_DIRECTORY
)
1607 or die "failed to open start directory $start: $!\n";
1609 return walk_tree_nofollow_fd
($start, $fd, $subdir, $mkdir, $root_uid, $root_gid);
1613 sub walk_tree_nofollow_fd
($$$$;$$) {
1614 my ($start_dirname, $start_fd, $subdir, $mkdir, $root_uid, $root_gid) = @_;
1616 # splitdir() returns '' for empty components including the leading /
1617 my @comps = grep { length($_)>0 } File
::Spec-
>splitdir($subdir);
1620 my $dir = $start_dirname;
1621 my $last_component = undef;
1623 foreach my $component (@comps) {
1624 $dir .= "/$component";
1625 my $next = PVE
::Tools
::openat
(fileno($fd), $component, O_NOFOLLOW
| O_DIRECTORY
);
1628 # failed, check for symlinks and try to create the path
1629 die "symlink encountered at: $dir\n" if $! == ELOOP
|| $! == ENOTDIR
;
1630 die "cannot open directory $dir: $!\n" if !$mkdir;
1632 # We don't check for errors on mkdirat() here and just try to
1633 # openat() again, since at least one error (EEXIST) is an
1634 # expected possibility if multiple containers start
1635 # simultaneously. If someone else injects a symlink now then
1636 # the subsequent openat() will fail due to O_NOFOLLOW anyway.
1637 PVE
::Tools
::mkdirat
(fileno($fd), $component, 0755);
1639 $next = PVE
::Tools
::openat
(fileno($fd), $component, O_NOFOLLOW
| O_DIRECTORY
);
1640 die "failed to create path: $dir: $!\n" if !$next;
1642 PVE
::Tools
::fchownat
(fileno($next), '', $root_uid, $root_gid, PVE
::Tools
::AT_EMPTY_PATH
)
1643 if defined($root_uid) && defined($root_gid);
1646 close $second if defined($last_component) && $second != $start_fd;
1647 $last_component = $component;
1652 return ($fd, defined($last_component) && $second, $last_component) if wantarray;
1653 close $second if defined($last_component) && $second != $start_fd;
1657 # To guard against symlink attack races against other currently running
1658 # containers with shared recursive bind mount hierarchies we prepare a
1659 # directory handle for the directory we're mounting over to verify the
1660 # mountpoint afterwards.
1661 sub __bindmount_prepare
{
1662 my ($hostroot, $dir) = @_;
1663 my $srcdh = walk_tree_nofollow
($hostroot, $dir, 0);
1667 # Assuming we mount to rootfs/a/b/c, verify with the directory handle to 'b'
1668 # ($parentfd) that 'b/c' (openat($parentfd, 'c')) really leads to the directory
1669 # we intended to bind mount.
1670 sub __bindmount_verify
{
1671 my ($srcdh, $parentfd, $last_dir, $ro) = @_;
1674 # Open the mount point path coming from the parent directory since the
1675 # filehandle we would have gotten as first result of walk_tree_nofollow
1676 # earlier is still a handle to the underlying directory instead of the
1678 $destdh = PVE
::Tools
::openat
(fileno($parentfd), $last_dir, PVE
::Tools
::O_PATH
| O_NOFOLLOW
| O_DIRECTORY
);
1679 die "failed to open mount point: $!\n" if !$destdh;
1682 # no separate function because 99% of the time it's the wrong thing to use.
1683 if (syscall(PVE
::Syscall
::faccessat
, fileno($destdh), $dot, &POSIX
::W_OK
, 0) != -1) {
1684 die "failed to mark bind mount read only\n";
1686 die "read-only check failed: $!\n" if $! != EROFS
;
1689 # For the rootfs we don't have a parentfd so we open the path directly.
1690 # Note that this means bindmounting any prefix of the host's
1691 # /var/lib/lxc/$vmid path into another container is considered a grave
1693 sysopen $destdh, $last_dir, O_PATH
| O_DIRECTORY
;
1694 die "failed to open mount point: $!\n" if !$destdh;
1697 my ($srcdev, $srcinode) = stat($srcdh);
1698 my ($dstdev, $dstinode) = stat($destdh);
1702 return ($srcdev == $dstdev && $srcinode == $dstinode);
1705 # Perform the actual bind mounting:
1706 sub __bindmount_do
{
1707 my ($dir, $dest, $ro, @extra_opts) = @_;
1708 PVE
::Tools
::run_command
(['mount', '-o', 'bind', @extra_opts, $dir, $dest]);
1710 eval { PVE
::Tools
::run_command
(['mount', '-o', 'bind,remount,ro', $dest]); };
1712 warn "bindmount error\n";
1713 # don't leave writable bind-mounts behind...
1714 PVE
::Tools
::run_command
(['umount', $dest]);
1721 my ($dir, $parentfd, $last_dir, $dest, $ro, @extra_opts) = @_;
1723 my $srcdh = __bindmount_prepare
('/', $dir);
1725 __bindmount_do
($dir, $dest, $ro, @extra_opts);
1727 if (!__bindmount_verify
($srcdh, $parentfd, $last_dir, $ro)) {
1728 PVE
::Tools
::run_command
(['umount', $dest]);
1729 die "detected mount path change at: $dir\n";
1733 # Cleanup $rootdir a bit (double and trailing slashes), build the mount path
1734 # from $rootdir and $mount and walk the path from $rootdir to the final
1735 # directory to check for symlinks.
1736 sub __mount_prepare_rootdir
{
1737 my ($rootdir, $mount, $root_uid, $root_gid) = @_;
1738 $rootdir =~ s!/+!/!g;
1739 $rootdir =~ s!/+$!!;
1740 my $mount_path = "$rootdir/$mount";
1741 my ($mpfd, $parentfd, $last_dir) = walk_tree_nofollow
($rootdir, $mount, 1, $root_uid, $root_gid);
1742 return ($rootdir, $mount_path, $mpfd, $parentfd, $last_dir);
1745 # use $rootdir = undef to just return the corresponding mount path
1746 sub mountpoint_mount
{
1747 my ($mountpoint, $rootdir, $storage_cfg, $snapname, $root_uid, $root_gid) = @_;
1748 return __mountpoint_mount
($mountpoint, $rootdir, $storage_cfg, $snapname, $root_uid, $root_gid, undef);
1751 sub mountpoint_stage
{
1752 my ($mountpoint, $stage_dir, $storage_cfg, $snapname, $root_uid, $root_gid) = @_;
1753 my ($path, $loop, $dev) =
1754 __mountpoint_mount
($mountpoint, $stage_dir, $storage_cfg, $snapname, $root_uid, $root_gid, 1);
1756 if (!defined($path)) {
1757 die "failed to mount subvolume: $!\n";
1760 # We clone the mount point and leave it there in order to keep them connected to eg. loop
1761 # devices in case we're hotplugging (which would allow contaienrs to unmount the new mount
1764 my $fd = PVE
::Tools
::open_tree
(&AT_FDCWD
, $stage_dir, &OPEN_TREE_CLOEXEC
| &OPEN_TREE_CLONE
)
1765 or die "open_tree() on mount point failed: $!\n";
1767 return wantarray ?
($path, $loop, $dev, $fd) : $fd;
1770 sub mountpoint_insert_staged
{
1771 my ($mount_fd, $rootdir_fd, $mp_dir, $opt, $root_uid, $root_gid) = @_;
1773 if (!defined($rootdir_fd)) {
1774 sysopen($rootdir_fd, '.', O_PATH
| O_DIRECTORY
)
1775 or die "failed to open '.': $!\n";
1778 my $dest_fd = walk_tree_nofollow_fd
('/', $rootdir_fd, $mp_dir, 1, $root_uid, $root_gid);
1780 PVE
::Tools
::move_mount
(
1785 &MOVE_MOUNT_F_EMPTY_PATH
| &MOVE_MOUNT_T_EMPTY_PATH
,
1786 ) or die "failed to move '$opt' into container hierarchy: $!\n";
1789 # Use $stage_mount, $rootdir is treated as a temporary path to "stage" the file system. The user
1790 # can then open a file descriptor to it which can be used with the `move_mount` syscall.
1791 sub __mountpoint_mount
{
1792 my ($mountpoint, $rootdir, $storage_cfg, $snapname, $root_uid, $root_gid, $stage_mount) = @_;
1794 # When staging mount points we always mount to $rootdir directly (iow. as if `mp=/`).
1795 # This is required since __mount_prepare_rootdir() will return handles to the parent directory
1796 # which we use in __bindmount_verify()!
1797 my $mount = $stage_mount ?
'/': $mountpoint->{mp
};
1799 my $volid = $mountpoint->{volume
};
1800 my $type = $mountpoint->{type
};
1801 my $quota = !$snapname && !$mountpoint->{ro
} && $mountpoint->{quota
};
1804 return if !$volid || !$mount;
1809 my ($mpfd, $parentfd, $last_dir);
1811 if (defined($rootdir)) {
1812 ($rootdir, $mount_path, $mpfd, $parentfd, $last_dir) =
1813 __mount_prepare_rootdir
($rootdir, $mount, $root_uid, $root_gid);
1816 if (defined($stage_mount)) {
1817 $mount_path = $rootdir;
1820 my ($storage, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
1822 die "unknown snapshot path for '$volid'" if !$storage && defined($snapname);
1826 if (my $mountopts = $mountpoint->{mountoptions
}) {
1827 my @opts = split(/;/, $mountpoint->{mountoptions
});
1828 push @$optlist, grep { PVE
::LXC
::Config
::is_valid_mount_option
($_) } @opts;
1831 my $acl = $mountpoint->{acl
};
1834 push @$optlist, 'acl';
1835 # NOTE: the else branch is handled below
1838 my $optstring = join(',', @$optlist);
1839 my $readonly = $mountpoint->{ro
};
1842 @extra_opts = ('-o', $optstring) if $optstring;
1846 my $scfg = PVE
::Storage
::storage_config
($storage_cfg, $storage);
1848 PVE
::Storage
::activate_volumes
($storage_cfg, [$volid], $snapname);
1849 my $path = PVE
::Storage
::map_volume
($storage_cfg, $volid, $snapname);
1851 $path = PVE
::Storage
::path
($storage_cfg, $volid, $snapname) if !defined($path);
1853 my ($vtype, undef, undef, undef, undef, $isBase, $format) =
1854 PVE
::Storage
::parse_volname
($storage_cfg, $volid);
1856 if (defined($acl) && !$acl) {
1857 # Does having this really makes sense or should we drop it with a future major release?
1858 # Kernel 6.1 removed the noacl mount option for ext4, which is used for all raw volumes.
1859 push @$optlist, 'noacl' if $format ne 'raw';
1862 $format = 'iso' if $vtype eq 'iso'; # allow to handle iso files
1864 if ($format eq 'subvol') {
1866 my (undef, $name) = PVE
::Storage
::parse_volname
($storage_cfg, $volid);
1867 if (defined($snapname)) {
1868 $name .= "\@$snapname";
1869 if ($scfg->{type
} eq 'zfspool') {
1870 PVE
::Tools
::run_command
(['mount', '-o', 'ro', @extra_opts, '-t', 'zfs', "$scfg->{pool}/$name", $mount_path]);
1872 die "cannot mount subvol snapshots for storage type '$scfg->{type}'\n";
1875 if (defined($acl) && $scfg->{type
} eq 'zfspool') {
1876 my $acltype = ($acl ?
'acltype=posixacl' : 'acltype=noacl');
1877 PVE
::Tools
::run_command
(['zfs', 'set', $acltype, "$scfg->{pool}/$name"]);
1879 bindmount
($path, $parentfd, $last_dir//$rootdir, $mount_path, $readonly, @extra_opts);
1880 warn "cannot enable quota control for bind mounted subvolumes\n" if $quota;
1883 return wantarray ?
($path, 0, undef) : $path;
1884 } elsif ($format eq 'raw' || $format eq 'iso') {
1885 # NOTE: 'mount' performs canonicalization without the '-c' switch, which for
1886 # device-mapper devices is special-cased to use the /dev/mapper symlinks.
1887 # Our autodev hook expects the /dev/dm-* device currently
1888 # and will create the /dev/mapper symlink accordingly
1889 $path = Cwd
::realpath
($path);
1890 die "failed to get device path\n" if !$path;
1891 ($path) = ($path =~ /^(.*)$/s); #untaint
1895 if ($format eq 'iso') {
1896 PVE
::Tools
::run_command
(['mount', '-o', 'ro', @extra_opts, $path, $mount_path]);
1897 } elsif ($isBase || defined($snapname)) {
1898 PVE
::Tools
::run_command
(['mount', '-o', 'ro,noload', @extra_opts, $path, $mount_path]);
1901 push @extra_opts, '-o', 'usrjquota=aquota.user,grpjquota=aquota.group,jqfmt=vfsv0';
1903 push @extra_opts, '-o', 'ro' if $readonly;
1904 PVE
::Tools
::run_command
(['mount', @extra_opts, $path, $mount_path]);
1908 my $use_loopdev = 0;
1909 if ($scfg->{content
}->{rootdir
}) {
1910 if ($scfg->{path
}) {
1911 $mounted_dev = run_with_loopdev
($domount, $path, $readonly);
1914 $mounted_dev = $path;
1918 die "storage '$storage' does not support containers\n";
1920 return wantarray ?
($path, $use_loopdev, $mounted_dev) : $path;
1922 die "unsupported image format '$format'\n";
1924 } elsif ($type eq 'device') {
1925 push @extra_opts, '-o', 'ro' if $readonly;
1926 push @extra_opts, '-o', 'usrjquota=aquota.user,grpjquota=aquota.group,jqfmt=vfsv0' if $quota;
1927 # See the NOTE above about devicemapper canonicalization
1928 my ($devpath) = (Cwd
::realpath
($volid) =~ /^(.*)$/s); # realpath() taints
1929 PVE
::Tools
::run_command
(['mount', @extra_opts, $volid, $mount_path]) if $mount_path;
1930 return wantarray ?
($volid, 0, $devpath) : $volid;
1931 } elsif ($type eq 'bind') {
1932 die "directory '$volid' does not exist\n" if ! -d
$volid;
1933 bindmount
($volid, $parentfd, $last_dir//$rootdir, $mount_path, $readonly, @extra_opts) if $mount_path;
1934 warn "cannot enable quota control for bind mounts\n" if $quota;
1935 return wantarray ?
($volid, 0, undef) : $volid;
1938 die "unsupported storage";
1941 sub mountpoint_hotplug
:prototype($$$$$) {
1942 my ($vmid, $conf, $opt, $mp, $storage_cfg) = @_;
1944 my (undef, $root_uid, $root_gid) = PVE
::LXC
::parse_id_maps
($conf);
1946 # We do the rest in a fork with an unshared mount namespace, because:
1947 # -) change our papparmor profile to that of /usr/bin/lxc-start
1948 # -) we're now going to 'stage' # the mountpoint, then grab it, then move into the
1949 # container's namespace, then mount it.
1951 PVE
::Tools
::run_fork
(sub {
1952 # Pin the container pid longer, we also need to get its monitor/parent:
1953 my ($ct_pid, $ct_pidfd) = open_lxc_pid
($vmid)
1954 or die "failed to open pidfd of container $vmid\'s init process\n";
1956 my ($monitor_pid, $monitor_pidfd) = open_ppid
($ct_pid)
1957 or die "failed to open pidfd of container $vmid\'s monitor process\n";
1959 my $ct_mnt_ns = $get_container_namespace->($vmid, $ct_pid, 'mnt');
1960 my $monitor_mnt_ns = $get_container_namespace->($vmid, $monitor_pid, 'mnt');
1962 # Grab a file descriptor to our apparmor label file so we can change into the 'lxc-start'
1963 # profile to lower our privileges to the same level we have in the start hook:
1964 sysopen(my $aa_fd, "/proc/self/attr/current", O_WRONLY
)
1965 or die "failed to open '/proc/self/attr/current' for writing: $!\n";
1966 # But switch namespaces first, to make sure the namespace switches aren't blocked by
1969 # Change into the monitor's mount namespace. We "pin" the mount into the monitor's
1970 # namespace for it to remain active there since the container will be able to unmount
1971 # hotplugged mount points and thereby potentially free up loop devices, which is a security
1973 PVE
::Tools
::setns
(fileno($monitor_mnt_ns), PVE
::Tools
::CLONE_NEWNS
);
1975 or die "failed to change root directory within the monitor's mount namespace: $!\n";
1977 my $dir = get_staging_mount_path
($opt);
1979 # Now switch our apparmor profile before mounting:
1980 my $data = 'changeprofile pve-container-mounthotplug';
1981 my $data_written = syswrite($aa_fd, $data, length($data));
1982 if (!defined($data_written) || $data_written != length($data)) {
1983 die "failed to change apparmor profile: $!\n";
1985 # Check errors on close as well:
1987 or die "failed to change apparmor profile (close() failed): $!\n";
1989 my $mount_fd = mountpoint_stage
($mp, $dir, $storage_cfg, undef, $root_uid, $root_gid);
1991 PVE
::Tools
::setns
(fileno($ct_mnt_ns), PVE
::Tools
::CLONE_NEWNS
);
1993 or die "failed to change root directory within the container's mount namespace: $!\n";
1995 mountpoint_insert_staged
($mount_fd, undef, $mp->{mp
}, $opt, $root_uid, $root_gid);
1999 # Create a directory in the mountpoint staging tempfs.
2000 sub get_staging_mount_path
($) {
2003 my $target = get_staging_tempfs
() . "/$opt";
2004 if (!mkdir($target) && $! != EEXIST
) {
2005 die "failed to create directory $target: $!\n";
2011 # Mount tmpfs for mount point staging and return the path.
2012 sub get_staging_tempfs
() {
2013 # We choose a path in /var/lib/lxc/ here because the lxc-start apparmor profile restricts most
2015 my $target = '/var/lib/lxc/.pve-staged-mounts';
2016 if (!mkdir($target)) {
2017 return $target if $! == EEXIST
;
2018 die "failed to create directory $target: $!\n";
2021 PVE
::Tools
::mount
("none", $target, 'tmpfs', 0, "size=8k,mode=755")
2022 or die "failed to mount $target as tmpfs: $!\n";
2028 my ($dev, $root_uid, $root_gid) = @_;
2036 "root_owner=$root_uid:$root_gid",
2041 # a hack to print only the relevant stuff, i.e., the one which could help on repair
2042 if ($line =~ /^(Creating filesystem|Filesystem UUID|Superblock backups|\s+\d+, \d)/) {
2048 print STDERR
"$line\n" if $line && $line !~ /^mke2fs \d\.\d/;
2054 my ($storage_cfg, $volid, $root_uid, $root_gid) = @_;
2056 if ($volid =~ m!^/dev/.+!) {
2057 # FIXME: remove in Proxmox VE 9 – this code path cannot really be reached currently, using
2058 # block devices needs manual preparations by the user
2059 mkfs
($volid, $root_uid, $root_gid);
2063 my ($storage, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2065 die "cannot format volume '$volid' with no storage\n" if !$storage;
2067 PVE
::Storage
::activate_volumes
($storage_cfg, [$volid]);
2069 my $path = PVE
::Storage
::map_volume
($storage_cfg, $volid);
2071 $path = PVE
::Storage
::path
($storage_cfg, $volid) if !defined($path);
2073 my ($vtype, undef, undef, undef, undef, $isBase, $format) =
2074 PVE
::Storage
::parse_volname
($storage_cfg, $volid);
2076 die "cannot format volume '$volid' (format == $format)\n"
2077 if $format ne 'raw';
2079 mkfs
($path, $root_uid, $root_gid);
2083 my ($storecfg, $vollist) = @_;
2085 foreach my $volid (@$vollist) {
2086 eval { PVE
::Storage
::vdisk_free
($storecfg, $volid); };
2092 my ($storecfg, $vmid, $storage, $size_kb, $root_uid, $root_gid) = @_;
2094 my $needs_chown = 0;
2097 my $scfg = PVE
::Storage
::storage_config
($storecfg, $storage);
2098 # fixme: use better naming ct-$vmid-disk-X.raw?
2102 if ($scfg->{content
}->{rootdir
} && $scfg->{path
}) {
2103 if ($size_kb > 0 && !($scfg->{type
} eq 'btrfs' && $scfg->{quotas
})) {
2104 $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storage, $vmid, 'raw', undef, $size_kb);
2107 $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storage, $vmid, 'subvol', undef, $size_kb);
2110 } elsif ($scfg->{type
} eq 'zfspool') {
2111 $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storage, $vmid, 'subvol', undef, $size_kb);
2113 } elsif ($scfg->{content
}->{rootdir
}) {
2114 $volid = PVE
::Storage
::vdisk_alloc
($storecfg, $storage, $vmid, 'raw', undef, $size_kb);
2117 die "content type 'rootdir' is not available or configured on storage '$storage'\n";
2119 format_disk
($storecfg, $volid, $root_uid, $root_gid) if $do_format;
2122 # in case formatting got interrupted:
2123 if (defined($volid)) {
2124 eval { PVE
::Storage
::vdisk_free
($storecfg, $volid); };
2130 return ($volid, $needs_chown);
2134 my ($storecfg, $vmid, $settings, $conf, $pending) = @_;
2139 my (undef, $root_uid, $root_gid) = PVE
::LXC
::parse_id_maps
($conf);
2140 my $chown_vollist = [];
2142 PVE
::LXC
::Config-
>foreach_volume($settings, sub {
2143 my ($ms, $mountpoint) = @_;
2145 my $volid = $mountpoint->{volume
};
2146 my $mp = $mountpoint->{mp
};
2148 my ($storage, $volname) = PVE
::Storage
::parse_volume_id
($volid, 1);
2150 if ($storage && ($volid =~ $NEW_DISK_RE)) {
2151 my ($storeid, $size_gb) = ($1, $2);
2153 my $size_kb = int(${size_gb
}*1024) * 1024;
2155 my $needs_chown = 0;
2156 ($volid, $needs_chown) = alloc_disk
($storecfg, $vmid, $storage, $size_kb, $root_uid, $root_gid);
2157 push @$chown_vollist, $volid if $needs_chown;
2158 push @$vollist, $volid;
2159 $mountpoint->{volume
} = $volid;
2160 $mountpoint->{size
} = $size_kb * 1024;
2162 $conf->{pending
}->{$ms} = PVE
::LXC
::Config-
>print_ct_mountpoint($mountpoint, $ms eq 'rootfs');
2164 $conf->{$ms} = PVE
::LXC
::Config-
>print_ct_mountpoint($mountpoint, $ms eq 'rootfs');
2167 # use specified/existing volid/dir/device
2168 $conf->{$ms} = PVE
::LXC
::Config-
>print_ct_mountpoint($mountpoint, $ms eq 'rootfs');
2172 PVE
::Storage
::activate_volumes
($storecfg, $chown_vollist, undef);
2173 foreach my $volid (@$chown_vollist) {
2174 my $path = PVE
::Storage
::path
($storecfg, $volid, undef);
2175 chown($root_uid, $root_gid, $path);
2177 PVE
::Storage
::deactivate_volumes
($storecfg, $chown_vollist, undef);
2179 # free allocated images on error
2181 destroy_disks
($storecfg, $vollist);
2187 sub update_disksize
{
2188 my ($vmid, $conf, $all_volumes) = @_;
2191 my $prefix = "CT $vmid:";
2193 my $update_mp = sub {
2194 my ($key, $mp, @param) = @_;
2195 my $size = $all_volumes->{$mp->{volume
}}->{size
} // 0;
2197 if (!defined($mp->{size
}) || $size != $mp->{size
}) {
2199 print "$prefix updated volume size of '$mp->{volume}' in config.\n";
2200 $mp->{size
} = $size;
2201 my $no_mp = $key eq 'rootfs'; # rootfs is handled different from other mount points
2202 $conf->{$key} = PVE
::LXC
::Config-
>print_ct_mountpoint($mp, $no_mp);
2206 PVE
::LXC
::Config-
>foreach_volume($conf, $update_mp);
2212 my ($vmid, $conf, $all_volumes) = @_;
2215 my $prefix = "CT $vmid:";
2217 # Note: it is allowed to define multiple storage entries with the same path
2218 # (alias), so we need to check both 'volid' and real 'path' (two different
2219 # volid can point to the same path).
2221 # used and unused disks
2225 foreach my $opt (keys %$conf) {
2226 next if ($opt !~ m/^unused\d+$/);
2227 my $vol = $all_volumes->{$conf->{$opt}};
2228 $refpath->{$vol->{path
}} = $vol->{volid
};
2231 foreach my $key (keys %$all_volumes) {
2232 my $vol = $all_volumes->{$key};
2233 my $in_use = PVE
::LXC
::Config-
>is_volume_in_use($conf, $vol->{volid
});
2234 my $path = $vol->{path
};
2237 $refpath->{$path} = $key;
2238 delete $orphans->{$path};
2240 if ((!$orphans->{$path}) && (!$refpath->{$path})) {
2241 $orphans->{$path} = $key;
2246 for my $key (keys %$orphans) {
2247 my $disk = $orphans->{$key};
2248 my $unused = PVE
::LXC
::Config-
>add_unused_volume($conf, $disk);
2252 print "$prefix add unreferenced volume '$disk' as '$unused' to config.\n";
2260 my ($cfg, $vmid) = @_;
2262 my $info = PVE
::Storage
::vdisk_list
($cfg, undef, $vmid, undef, 'rootdir');
2264 my $all_volumes = {};
2265 foreach my $storeid (keys %$info) {
2266 foreach my $item (@{$info->{$storeid}}) {
2267 my $volid = $item->{volid
};
2268 next if !($volid && $item->{size
});
2269 $item->{path
} = PVE
::Storage
::path
($cfg, $volid);
2270 $all_volumes->{$volid} = $item;
2274 return $all_volumes;
2278 my ($vmid, $nolock, $dryrun) = @_;
2280 my $cfg = PVE
::Storage
::config
();
2282 print "rescan volumes...\n";
2283 my $all_volumes = scan_volids
($cfg, $vmid);
2285 my $updatefn = sub {
2289 my $conf = PVE
::LXC
::Config-
>load_config($vmid);
2291 PVE
::LXC
::Config-
>check_lock($conf);
2294 foreach my $volid (keys %$all_volumes) {
2295 my $info = $all_volumes->{$volid};
2296 $vm_volids->{$volid} = $info if $info->{vmid
} == $vmid;
2299 my $upu = update_unused
($vmid, $conf, $vm_volids);
2300 my $upd = update_disksize
($vmid, $conf, $vm_volids);
2301 $changes = $upu || $upd;
2303 PVE
::LXC
::Config-
>write_config($vmid, $conf) if $changes && !$dryrun;
2306 if (defined($vmid)) {
2310 PVE
::LXC
::Config-
>lock_config($vmid, $updatefn, $vmid);
2313 my $vmlist = config_list
();
2314 foreach my $vmid (keys %$vmlist) {
2318 PVE
::LXC
::Config-
>lock_config($vmid, $updatefn, $vmid);
2325 # bash completion helper
2327 sub complete_os_templates
{
2328 my ($cmdname, $pname, $cvalue) = @_;
2330 my $cfg = PVE
::Storage
::config
();
2334 if ($cvalue =~ m/^([^:]+):/) {
2338 my $vtype = $cmdname eq 'restore' ?
'backup' : 'vztmpl';
2339 my $data = PVE
::Storage
::template_list
($cfg, $storeid, $vtype);
2342 foreach my $id (keys %$data) {
2343 foreach my $item (@{$data->{$id}}) {
2344 push @$res, $item->{volid
} if defined($item->{volid
});
2351 my $complete_ctid_full = sub {
2354 my $idlist = vmstatus
();
2356 my $active_hash = list_active_containers
();
2360 foreach my $id (keys %$idlist) {
2361 my $d = $idlist->{$id};
2362 if (defined($running)) {
2363 next if $d->{template
};
2364 next if $running && !$active_hash->{$id};
2365 next if !$running && $active_hash->{$id};
2374 return &$complete_ctid_full();
2377 sub complete_ctid_stopped
{
2378 return &$complete_ctid_full(0);
2381 sub complete_ctid_running
{
2382 return &$complete_ctid_full(1);
2392 my $lxc = $conf->{lxc
};
2393 foreach my $entry (@$lxc) {
2394 my ($key, $value) = @$entry;
2396 next if $key ne 'lxc.idmap';
2398 if ($value =~ /^([ug])\s+(\d+)\s+(\d+)\s+(\d+)\s*$/) {
2399 my ($type, $ct, $host, $length) = ($1, $2, $3, $4);
2400 push @$id_map, [$type, $ct, $host, $length];
2402 $root_uid = $host if $type eq 'u';
2403 $root_gid = $host if $type eq 'g';
2406 die "failed to parse idmap: $value\n";
2410 if (!@$id_map && $conf->{unprivileged
}) {
2411 # Should we read them from /etc/subuid?
2412 $id_map = [ ['u', '0', '100000', '65536'],
2413 ['g', '0', '100000', '65536'] ];
2414 $root_uid = $root_gid = 100000;
2417 return ($id_map, $root_uid, $root_gid);
2420 sub validate_id_maps
{
2423 # $mappings->{$type}->{$side} = [ { line => $line, start => $start, count => $count }, ... ]
2424 # $type: either "u" or "g"
2425 # $side: either "container" or "host"
2426 # $line: index of this mapping in @$id_map
2427 # $start, $count: interval of this mapping
2428 my $mappings = { u
=> {}, g
=> {} };
2429 for (my $i = 0; $i < scalar(@$id_map); $i++) {
2430 my ($type, $ct_start, $host_start, $count) = $id_map->[$i]->@*;
2431 my $sides = $mappings->{$type};
2432 push $sides->{host
}->@*, { line
=> $i, start
=> $host_start, count
=> $count };
2433 push $sides->{container
}->@*, { line
=> $i, start
=> $ct_start, count
=> $count };
2436 # find the first conflict between two consecutive mappings when sorted by their start id
2437 for my $type (qw(u g)) {
2438 for my $side (qw(container host)) {
2439 my @entries = sort { $a->{start
} <=> $b->{start
} } $mappings->{$type}->{$side}->@*;
2440 for my $idx (1..scalar(@entries) - 1) {
2441 my $previous = $entries[$idx - 1];
2442 my $current = $entries[$idx];
2443 if ($previous->{start
} + $previous->{count
} > $current->{start
}) {
2444 my $conflict = $current->{start
};
2445 my @previous_line = $id_map->[$previous->{line
}]->@*;
2446 my @current_line = $id_map->[$current->{line
}]->@*;
2447 die "invalid map entry '@current_line': $side ${type}id $conflict "
2448 ."is also mapped by entry '@previous_line'\n";
2455 sub map_ct_id_to_host
{
2456 my ($id, $id_map, $id_type) = @_;
2458 for my $mapping (@$id_map) {
2459 my ($type, $ct, $host, $length) = @$mapping;
2461 next if ($type ne $id_type);
2463 if ($id >= $ct && $id < ($ct + $length)) {
2464 return $host - $ct + $id;
2471 sub map_ct_uid_to_host
{
2472 my ($uid, $id_map) = @_;
2474 return map_ct_id_to_host
($uid, $id_map, 'u');
2477 sub map_ct_gid_to_host
{
2478 my ($gid, $id_map) = @_;
2480 return map_ct_id_to_host
($gid, $id_map, 'g');
2483 sub userns_command
{
2486 return ['lxc-usernsexec', (map { ('-m', join(':', @$_)) } @$id_map), '--'];
2491 my sub print_ct_stderr_log
{
2493 my $log = eval { file_get_contents
("/run/pve/ct-$vmid.stderr") };
2496 while ($log =~ /^\h*(lxc-start:?\s+$vmid:?\s*\S+\s*)?(.*?)\h*$/gm) {
2498 print STDERR
"$line\n";
2501 my sub print_ct_warn_log
{
2503 my $log_fn = "/run/pve/ct-$vmid.warnings";
2504 my $log = eval { file_get_contents
($log_fn) };
2507 while ($log =~ /^\h*\s*(.*?)\h*$/gm) {
2508 PVE
::RESTEnvironment
::log_warn
($1);
2510 unlink $log_fn or warn "could not unlink '$log_fn' - $!\n";
2513 my sub monitor_state_change
($$) {
2514 my ($monitor_socket, $vmid) = @_;
2515 die "no monitor socket\n" if !defined($monitor_socket);
2518 my ($type, $name, $value) = PVE
::LXC
::Monitor
::read_lxc_message
($monitor_socket);
2520 die "monitor socket: got EOF\n" if !defined($type);
2522 next if $name ne "$vmid" || $type ne 'STATE';
2524 if ($value eq PVE
::LXC
::Monitor
::STATE_STARTING
) {
2525 alarm(0); # don't timeout after seeing the starting state
2526 } elsif ($value eq PVE
::LXC
::Monitor
::STATE_ABORTING
||
2527 $value eq PVE
::LXC
::Monitor
::STATE_STOPPING
||
2528 $value eq PVE
::LXC
::Monitor
::STATE_STOPPED
) {
2530 } elsif ($value eq PVE
::LXC
::Monitor
::STATE_RUNNING
) {
2533 warn "unexpected message from monitor socket - " .
2534 "type: '$type' - value: '$value'\n";
2538 my sub monitor_start
($$) {
2539 my ($monitor_socket, $vmid) = @_;
2541 my $success = eval {
2542 PVE
::Tools
::run_with_timeout
(10, \
&monitor_state_change
, $monitor_socket, $vmid)
2545 warn "problem with monitor socket, but continuing anyway: $err\n";
2546 } elsif (!$success) {
2547 print_ct_stderr_log
($vmid);
2548 die "startup for container '$vmid' failed\n";
2553 my ($vmid, $conf, $skiplock, $debug) = @_;
2555 # apply pending changes while starting
2556 if (scalar(keys %{$conf->{pending
}})) {
2557 my $storecfg = PVE
::Storage
::config
();
2558 PVE
::LXC
::Config-
>vmconfig_apply_pending($vmid, $conf, $storecfg);
2559 PVE
::LXC
::Config-
>write_config($vmid, $conf);
2560 $conf = PVE
::LXC
::Config-
>load_config($vmid); # update/reload
2563 update_lxc_config
($vmid, $conf);
2566 my ($id_map, undef, undef) = PVE
::LXC
::parse_id_maps
($conf);
2567 PVE
::LXC
::validate_id_maps
($id_map);
2569 warn "lxc.idmap: $@" if $@;
2571 my $skiplock_flag_fn = "/run/lxc/skiplock-$vmid";
2574 open(my $fh, '>', $skiplock_flag_fn) || die "failed to open $skiplock_flag_fn for writing: $!\n";
2578 my $storage_cfg = PVE
::Storage
::config
();
2579 my $vollist = PVE
::LXC
::Config-
>get_vm_volumes($conf);
2581 PVE
::Storage
::activate_volumes
($storage_cfg, $vollist);
2583 my $monitor_socket = eval { PVE
::LXC
::Monitor
::get_monitor_socket
() };
2586 unlink "/run/pve/ct-$vmid.stderr"; # systemd does not truncate log files
2588 my $is_debug = $debug || (!defined($debug) && $conf->{debug
});
2589 my $base_unit = $is_debug ?
'pve-container-debug' : 'pve-container';
2591 my $cmd = ['systemctl', 'start', "$base_unit\@$vmid"];
2593 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'pre-start', 1);
2597 monitor_start
($monitor_socket, $vmid) if defined($monitor_socket);
2599 # if debug is requested, print the log it also when the start succeeded
2600 print_ct_stderr_log
($vmid) if $is_debug;
2602 print_ct_warn_log
($vmid); # always print warn log, if any
2605 unlink $skiplock_flag_fn;
2608 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'post-start');
2613 # Helper to stop a container completely and make sure it has stopped completely.
2614 # This is necessary because we want the post-stop hook to have completed its
2615 # unmount-all step, but post-stop happens after lxc puts the container into the
2617 # $kill - if true it will always do an immediate hard-stop
2618 # $shutdown_timeout - the timeout to wait for a gracefull shutdown
2619 # $kill_after_timeout - if true, send a hardstop if shutdown timed out
2621 my ($vmid, $kill, $shutdown_timeout, $kill_after_timeout) = @_;
2623 # Open the container's command socket.
2624 my $path = "\0/var/lib/lxc/$vmid/command";
2625 my $sock = IO
::Socket
::UNIX-
>new(
2626 Type
=> SOCK_STREAM
(),
2630 return if $! == ECONNREFUSED
; # The container is not running
2631 die "failed to open container ${vmid}'s command socket: $!\n";
2634 my $conf = PVE
::LXC
::Config-
>load_config($vmid);
2635 PVE
::GuestHelpers
::exec_hookscript
($conf, $vmid, 'pre-stop');
2637 # Stop the container:
2639 my $cmd = ['lxc-stop', '-n', $vmid];
2642 push @$cmd, '--kill'; # doesn't allow timeouts
2644 # lxc-stop uses a default timeout
2645 push @$cmd, '--nokill' if !$kill_after_timeout;
2647 if (defined($shutdown_timeout)) {
2648 push @$cmd, '--timeout', $shutdown_timeout;
2649 # Give run_command 5 extra seconds
2650 $shutdown_timeout += 5;
2654 eval { run_command
($cmd, timeout
=> $shutdown_timeout) };
2656 # Wait until the command socket is closed.
2657 # In case the lxc-stop call failed, reading from the command socket may block forever,
2658 # so poll with another timeout to avoid freezing the shutdown task.
2662 my $poll = IO
::Poll-
>new();
2663 $poll->mask($sock => POLLIN
| POLLHUP
); # watch for input and EOF events
2664 $poll->poll($shutdown_timeout); # IO::Poll timeout is in seconds
2665 return if ($poll->events($sock) & POLLHUP
);
2667 my $result = <$sock>;
2668 return if !defined $result; # monitor is gone and the ct has stopped.
2671 die "container did not stop\n";
2675 my ($vmid, $timeout, $skiplock) = @_;
2677 PVE
::LXC
::Config-
>lock_config($vmid, sub {
2678 return if !check_running
($vmid);
2680 vm_stop
($vmid, 0, $timeout, 1); # kill if timeout exceeds
2682 my $conf = PVE
::LXC
::Config-
>load_config($vmid);
2683 vm_start
($vmid, $conf);
2690 return PVE
::Tools
::run_fork
(sub {
2691 # Unshare the mount namespace
2692 die "failed to unshare mount namespace: $!\n"
2693 if !PVE
::Tools
::unshare
(PVE
::Tools
::CLONE_NEWNS
);
2694 run_command
(['mount', '--make-rslave', '/']);
2699 my $copy_volume = sub {
2700 my ($src_volid, $src, $dst_volid, $dest, $storage_cfg, $snapname, $bwlimit, $root_uid, $root_gid) = @_;
2702 my $src_mp = { volume
=> $src_volid, mp
=> '/', ro
=> 1 };
2703 $src_mp->{type
} = PVE
::LXC
::Config-
>classify_mountpoint($src_volid);
2705 my $dst_mp = { volume
=> $dst_volid, mp
=> '/', ro
=> 0 };
2706 $dst_mp->{type
} = PVE
::LXC
::Config-
>classify_mountpoint($dst_volid);
2712 mountpoint_mount
($src_mp, $src, $storage_cfg, $snapname, $root_uid, $root_gid);
2713 push @mounted, $src;
2715 mountpoint_mount
($dst_mp, $dest, $storage_cfg, undef, $root_uid, $root_gid);
2716 push @mounted, $dest;
2729 '--one-file-system',
2730 "--bwlimit=$bwlimit",
2737 # Wait for rsync's children to release dest so that
2738 # consequent file operations (umount, remove) are possible
2739 while ((system {"fuser"} "fuser", "-s", $dest) == 0) {sleep 1};
2741 foreach my $mount (reverse @mounted) {
2742 eval { run_command
(['/bin/umount', $mount], errfunc
=> sub{})};
2743 warn "Can't umount $mount\n" if $@;
2746 # If this fails they're used as mount points in a concurrent operation
2747 # (which should not happen but there's also no real need to get rid of them).
2754 # Should not be called after unsharing the mount namespace!
2756 my ($mp, $vmid, $storage, $storage_cfg, $conf, $snapname, $bwlimit) = @_;
2758 die "cannot copy volumes of type $mp->{type}\n" if $mp->{type
} ne 'volume';
2759 File
::Path
::make_path
("/var/lib/lxc/$vmid");
2760 my $dest = "/var/lib/lxc/$vmid/.copy-volume-1";
2761 my $src = "/var/lib/lxc/$vmid/.copy-volume-2";
2763 # get id's for unprivileged container
2764 my (undef, $root_uid, $root_gid) = parse_id_maps
($conf);
2766 # Allocate the disk before unsharing in order to make sure zfs subvolumes
2767 # are visible in this namespace, otherwise the host only sees the empty
2768 # (not-mounted) directory.
2771 # Make sure $mp contains a correct size.
2772 $mp->{size
} = PVE
::Storage
::volume_size_info
($storage_cfg, $mp->{volume
});
2774 ($new_volid, $needs_chown) = alloc_disk
($storage_cfg, $vmid, $storage, $mp->{size
}/1024, $root_uid, $root_gid);
2776 PVE
::Storage
::activate_volumes
($storage_cfg, [$new_volid], undef);
2777 my $path = PVE
::Storage
::path
($storage_cfg, $new_volid, undef);
2778 chown($root_uid, $root_gid, $path);
2782 $copy_volume->($mp->{volume
}, $src, $new_volid, $dest, $storage_cfg, $snapname, $bwlimit, $root_uid, $root_gid);
2786 PVE
::Storage
::vdisk_free
($storage_cfg, $new_volid)
2787 if defined($new_volid);
2794 sub get_lxc_version
() {
2796 run_command
([qw(lxc-start --version)], outfunc
=> sub {
2798 # We only parse out major & minor version numbers.
2799 if ($line =~ /^(\d+)\.(\d+)(?:\D.*)?$/) {
2800 $version = [$1, $2];
2804 die "failed to get lxc version\n" if !defined($version);
2807 return $version->@*;
2812 if (PVE
::CGroup
::cgroup_mode
() == 2) {
2813 PVE
::LXC
::Command
::freeze
($vmid, 30);
2815 PVE
::LXC
::CGroup-
>new($vmid)->freeze_thaw(1);
2821 if (PVE
::CGroup
::cgroup_mode
() == 2) {
2822 PVE
::LXC
::Command
::unfreeze
($vmid, 30);
2824 PVE
::LXC
::CGroup-
>new($vmid)->freeze_thaw(0);
2828 sub create_ifaces_ipams_ips
{
2829 my ($conf, $vmid) = @_;
2831 return if !$have_sdn;
2833 for my $opt (keys %$conf) {
2834 next if $opt !~ m/^net(\d+)$/;
2835 my $net = PVE
::LXC
::Config-
>parse_lxc_network($conf->{$opt});
2836 next if $net->{type
} ne 'veth';
2837 PVE
::Network
::SDN
::Vnets
::add_next_free_cidr
($net->{bridge
}, $conf->{hostname
}, $net->{hwaddr
}, $vmid, undef, 1);
2841 sub delete_ifaces_ipams_ips
{
2842 my ($conf, $vmid) = @_;
2844 return if !$have_sdn;
2846 for my $opt (keys %$conf) {
2847 next if $opt !~ m/^net(\d+)$/;
2848 my $net = PVE
::LXC
::Config-
>parse_lxc_network($conf->{$opt});
2849 eval { PVE
::Network
::SDN
::Vnets
::del_ips_from_mac
($net->{bridge
}, $net->{hwaddr
}, $conf->{hostname
}) };