VIRGL_TEST_SERVER(1)

💖 VIRGL_TEST_SERVER 💖

okay bestie, so like. this is the manual for virgl_test_server, which lives in section 1 of the manual (the "User Commands" girlies ✨). let's get into it.

---

✨ NAME ✨

virgl_test_server — a rendering server for separating OpenGL clients from host hardware 🦋

---

🌸 SYNOPSIS 🌸

virgl_test_server [options]

---

🎀 DESCRIPTION 🎀

okay so real talk. virgl_test_server hands you a rendering server that interfaces directly with the OpenGL hardware. that's the whole job. 💅

and then — the way that clients connect to it?? they use the mesa 3D virgl gallium software renderer. that's the vibe. that's the connection method. no cap.

so once you've got the server running, your clients can link up by running it (the client software) with specific environment variables set, which makes mesa pick the virgl driver for rendering. like so:

LIBGL_ALWAYS_SOFTWARE=1 GALLIUM_DRIVER=virpipe <client software>

copy it exactly bestie, those env vars are doing the lord's work 🙏✨

---

👑 OPTIONS 👑

• --no-fork — run the server single threaded. that's it, that's the whole thing 🧚
• --no-loop-or-fork — run the server single threaded, and then dip out as soon as the client closes the connection. bye bye 👋
• --use-gles — force a GLES context on the host 💜
• --use-glx — use the GLX interface on the host 🌈
• --use-egl-surfaceless — use the EGL surfaceless interface on the host ⭐

---

💖 AUTHORS AND CONTRIBUTORS 💖

shoutout to literally everyone who built this, the whole squad, the entire group chat, the main characters 🫶:

Dave Airlie, Gert Wollny, Erik Faye-Lund, Marc-André Lureau, Gurchetan Singh, Emil Velikov, Robert Foss, Jakob Bornecrantz, Elie Tournier, Alexandros Frantzis, David Riley, Tomeu Vizoso, Li Qiang, Stéphane Marchesin, Chia-I Wu, Po-Hsien Wang, Lepton Wu, Ramin Azarmehr, Robert Tarasov, Michal Privoznik, Alexander Kanavin, Joe M. Kniss, Karol Herbst, Ondřej Súkup, Gerd Hoffmann, Ilia Mirkin, Joe Kniss, Nathan Gauer, Zhenyu Wang

---

and that's the whole page, bestie!! 🎀 this one's from the Virgl-team, dated 29 September 2019, and it's the VIRGL_TEST_SERVER(1) page. iconic, honestly. go render something pretty 💅✨🌸