vcontainer: add shared infrastructure and runner

Add core vcontainer infrastructure shared by vdkr and vpdmn:

Scripts:
- vrunner.sh: QEMU runner supporting both Docker and Podman runtimes
- vcontainer-common.sh: Shared CLI functions and command handling
- vcontainer-init-common.sh: Shared init script functions for QEMU guest
- vdkr-preinit.sh: Initramfs preinit for switch_root to squashfs overlay

Recipes:
- vcontainer-native: Installs vrunner.sh and shared scripts
- vcontainer-initramfs-create.inc: Shared initramfs build logic

Features:
- Docker/Podman-compatible commands: images, pull, load, save, run, exec
- Memory resident mode for fast command execution
- KVM acceleration when host matches target
- Interactive mode with volume mounts
- Squashfs rootfs with tmpfs overlay

Signed-off-by: Bruce Ashfield <bruce.ashfield@gmail.com>

1 files changed, 43 insertions, 0 deletions

diff --git a/recipes-containers/vcontainer/vcontainer-native.bb b/recipes-containers/vcontainer/vcontainer-native.bb
new file mode 100644
index 00000000..1d19ac1b
--- /dev/null
+++ b/recipes-containers/vcontainer/vcontainer-native.bb
@@ -0,0 +1,43 @@
+# SPDX-FileCopyrightText: Copyright (C) 2025 Bruce Ashfield
+#
+# SPDX-License-Identifier: MIT
+#
+# vcontainer-native.bb
+# ===========================================================================
+# Native recipe providing vrunner.sh for container cross-installation
+# ===========================================================================
+#
+# This recipe installs vrunner.sh into the native sysroot so that
+# container-bundle.bbclass and container-cross-install.bbclass can use it
+# to cross-install containers into target images.
+#
+# Note: This does NOT build the blobs. Blobs must be built separately via
+# multiconfig (see vdkr-initramfs-create, vpdmn-initramfs-create).
+#
+# ===========================================================================
+
+SUMMARY = "Container cross-install runner script"
+DESCRIPTION = "Provides vrunner.sh for cross-installing containers into images"
+HOMEPAGE = "https://git.yoctoproject.org/meta-virtualization/"
+LICENSE = "MIT"
+LIC_FILES_CHKSUM = "file://${COMMON_LICENSE_DIR}/MIT;md5=0835ade698e0bcf8506ecda2f7b4f302"
+
+inherit native
+
+# Runtime dependencies for vrunner.sh
+DEPENDS = "coreutils-native socat-native"
+
+SRC_URI = "\
+    file://vrunner.sh \
+    file://vcontainer-common.sh \
+"
+
+S = "${UNPACKDIR}"
+
+do_install() {
+    install -d ${D}${bindir}
+    install -m 0755 ${S}/vrunner.sh ${D}${bindir}/vrunner.sh
+    install -m 0644 ${S}/vcontainer-common.sh ${D}${bindir}/vcontainer-common.sh
+}
+
+BBCLASSEXTEND = "native"