[pve-devel] [PATCH qemu-server v1 1/2] virtio-vga-gl: add Vulkan (venus) support

Markus Frank m.frank at proxmox.com
Mon Nov 10 12:25:27 CET 2025


The venus protocol facilitates the translation of Vulkan API calls via
the virglrenderer. To use it, the virgl-server package must be installed
on the host.

The Vulkan option is represented by an enum with values such as
'venus-512' and 'venus-1024'. This is to allow for the potential
addition of another Vulkan implementation in the future. The number
indicates the memory window in MiB for Venus.

Signed-off-by: Markus Frank <m.frank at proxmox.com>
---
 src/PVE/QemuServer.pm | 20 +++++++++++++++++++-
 1 file changed, 19 insertions(+), 1 deletion(-)

diff --git a/src/PVE/QemuServer.pm b/src/PVE/QemuServer.pm
index cf195ccc..2b358e9f 100644
--- a/src/PVE/QemuServer.pm
+++ b/src/PVE/QemuServer.pm
@@ -160,6 +160,12 @@ my $vga_fmt = {
             qw(cirrus qxl qxl2 qxl3 qxl4 none serial0 serial1 serial2 serial3 std virtio virtio-gl vmware)
         ],
     },
+    vulkan => {
+        description => 'Enable vulkan by using the venus protocol.',
+        type => 'string',
+        enum => ['venus-512', 'venus-1024', 'venus-2048', 'venus-4096', 'venus-8192'],
+        optional => 1,
+    },
     memory => {
         description => "Sets the VGA memory (in MiB). Has no effect with serial display.",
         type => 'integer',
@@ -1499,6 +1505,15 @@ sub print_vga_device {
         $pciaddr = print_pci_addr($vgaid, $bridges, $arch);
     }
 
+    my $venus = "";
+    if ($vga->{vulkan} && $vga->{vulkan} =~ /^venus-(\d+)/) {
+        my $virgl_memory_window = $1;
+        $venus = ",hostmem=${virgl_memory_window}M,venus=on,blob=on";
+
+        die "You need to use virtio-gl to enable vulkan (venus) support!\n"
+            if $vga->{type} !~ /^virtio-gl/;
+    }
+
     if ($vga->{type} eq 'virtio-gl') {
         my $base = '/usr/lib/x86_64-linux-gnu/lib';
         die "missing libraries for '$vga->{type}' detected! Please install 'libgl1' and 'libegl1'\n"
@@ -1507,9 +1522,12 @@ sub print_vga_device {
         die
             "no DRM render node detected (/dev/dri/renderD*), no GPU? - needed for '$vga->{type}' display\n"
             if !PVE::Tools::dir_glob_regex('/dev/dri/', "renderD.*");
+
+        die "missing virgl render server for vulkan (venus)! Please install 'virgl-server'.\n"
+            if $vga->{vulkan} && !-e "/usr/libexec/virgl_render_server";
     }
 
-    return "$type,id=${vgaid}${memory}${max_outputs}${pciaddr}${edidoff}";
+    return "$type,id=${vgaid}${memory}${max_outputs}${pciaddr}${edidoff}${venus}";
 }
 
 sub vm_is_volid_owner {
-- 
2.47.3





More information about the pve-devel mailing list