#!/bin/bash # SPDX-License-Identifier: BSD-3-Clause # Copyright (c) 2026 Open-IOV contributors # gzdoom_pbuf_run.sh - in-guest GZDoom run recipe for the offscreen SDL2 # GLX-pbuffer harness. Run this inside the guest after push_gl_tools.sh has # placed the shims in /tmp. It prints the exact command line, runs GZDoom # under timeout, and leaves the output in $GZLOG. # # Environment (all overridable): # GZDOOM_BIN default /opt/gzdoom/gzdoom # WAD default /usr/share/games/doom/freedoom2.wad # GZCAP default /tmp/gzframes.bin (sdl_cap.so capture file) # GZPBUF_W/H default 640/480 (gz_pbuf.so pbuffer size) # GZLOG default /tmp/gzdoom-pbuf.log # TIMEOUT default 300 seconds # GZ_ARGS extra GZDoom args appended after the base set # GZ_DETACH default 0; set 1 to setsid/nohup the run and return # DISPLAY default :0 # GZ_EGL default 0; set 1 to use SDL's offscreen driver with a real # NVIDIA EGL/GLES context via gz_es.so (no X, no GLX; the # c1020/c1021 real-GL path). The pbuffer shims are not used. # # The base args are windowed GL: +set vid_fullscreen 0, 640x480, OpenGL # backend 0, +vid_rendermode 4 (GL mode), MAP01. The preload order matters: # sdl_cap.so first (captures SDL_GL_SwapWindow), gz_pbuf.so second (turns the # SDL GL context into a GLX pbuffer and the swap into glFinish). set -u GZDOOM_BIN="${GZDOOM_BIN:-/opt/gzdoom/gzdoom}" WAD="${WAD:-/usr/share/games/doom/freedoom2.wad}" GZCAP="${GZCAP:-/dev/shm/gzframes.bin}" GZPBUF_W="${GZPBUF_W:-640}" GZCAP_MAXF="${GZCAP_MAXF:-1800}" GZPBUF_H="${GZPBUF_H:-480}" GZLOG="${GZLOG:-/tmp/gzdoom-pbuf.log}" TIMEOUT="${TIMEOUT:-300}" GZ_ARGS="${GZ_ARGS:-}" GZ_DETACH="${GZ_DETACH:-0}" GZ_RCFILE="${GZ_RCFILE:-/tmp/gz-rc}" DISPLAY="${DISPLAY:-:0}" GZ_EGL="${GZ_EGL:-0}" SDL_VIDEODRIVER="${SDL_VIDEODRIVER:-offscreen}" if [ "$GZ_EGL" = "1" ]; then SDL_VIDEO_EGL_DRIVER="${SDL_VIDEO_EGL_DRIVER:-/usr/lib/x86_64-linux-gnu/libEGL.so.1}" LD_PRELOAD="${LD_PRELOAD:-/tmp/gz_es.so}" GZ_BACKEND="${GZ_BACKEND:-2}" SHIMS="/tmp/gz_es.so" else SDL_VIDEO_EGL_DRIVER="${SDL_VIDEO_EGL_DRIVER:-}" LD_PRELOAD="${LD_PRELOAD:-/tmp/sdl_cap.so /tmp/gz_pbuf.so}" GZ_BACKEND="${GZ_BACKEND:-0}" SHIMS="/tmp/sdl_cap.so /tmp/gz_pbuf.so" fi export DISPLAY SDL_VIDEODRIVER SDL_VIDEO_EGL_DRIVER LD_PRELOAD GZCAP GZCAP_MAXF GZPBUF_W GZPBUF_H GZ_RCFILE GZ_EGL if [ ! -x "$GZDOOM_BIN" ]; then echo "gzdoom_pbuf_run: GZDOOM_BIN not executable: $GZDOOM_BIN" >&2 exit 2 fi if [ ! -f "$WAD" ]; then echo "gzdoom_pbuf_run: WAD not found: $WAD" >&2 exit 2 fi for so in $SHIMS; do if [ ! -f "$so" ]; then echo "gzdoom_pbuf_run: shim missing: $so" >&2 exit 2 fi done CMD=( "$GZDOOM_BIN" -iwad "$WAD" +set vid_fullscreen 0 +set vid_defwidth "$GZPBUF_W" +set vid_defheight "$GZPBUF_H" +set vid_preferbackend "$GZ_BACKEND" +vid_rendermode 4 -nosound -nomusic +vid_activeinbackground 1 +vid_maxfps 60 +set gl_pipeline_depth 2 +set gl_finishbeforeswap 0 +map MAP01 ) if [ -n "$GZ_ARGS" ]; then read -r -a GZ_EXTRA <<< "$GZ_ARGS" CMD+=("${GZ_EXTRA[@]}") fi echo "gzdoom_pbuf_run: DISPLAY=$DISPLAY SDL_VIDEODRIVER=$SDL_VIDEODRIVER GZ_EGL=$GZ_EGL" echo "gzdoom_pbuf_run: LD_PRELOAD=$LD_PRELOAD" echo "gzdoom_pbuf_run: GZCAP=$GZCAP GZCAP_MAXF=$GZCAP_MAXF GZPBUF_W=$GZPBUF_W GZPBUF_H=$GZPBUF_H" echo "gzdoom_pbuf_run: LOG=$GZLOG TIMEOUT=$TIMEOUT DETACH=$GZ_DETACH" printf 'CMD:' printf ' %q' "${CMD[@]}" echo if [ "$GZ_DETACH" = "1" ]; then RCF="${GZ_RCFILE:-/tmp/gz-rc}" rm -f "$RCF" setsid nohup bash -c 'timeout -k 5 "$0" "${@:1}"; echo $? > "$GZ_RCFILE"' \ "$TIMEOUT" "${CMD[@]}" > "$GZLOG" 2>&1 < /dev/null & echo "PID=$!" echo "LOG=$GZLOG" exit 0 fi timeout -k 5 "$TIMEOUT" "${CMD[@]}" > "$GZLOG" 2>&1 rc=$? echo "RC=$rc" echo "LOG=$GZLOG" exit "$rc"