VIRTUALX.SH(1)

✨ VIRTUALX.SH(1) ✨

okay so this is a page from the User Contributed Perl Documentation — yes bestie, it's giving perl manual page energy, and honestly? iconic. buckle up 💅

---

🌸 NAME 🌸

BeakerLib — the virtualX module, aka your lil helper squad for handling a virtual X server 🖥️✨

---

🦋 DESCRIPTION 🦋

no cap, this module is literally just here to give you a simple way to start and stop a virtual X server (a framebuffer, if you're fancy). that's it. that's the whole vibe check. 🎀

---

👑 FUNCTIONS 👑

🧚 Virtual X Server

these functions are the simple way how to start and stop a virtual X server — the whole glow-up, start to finish 💖

⭐ rlVirtualXStart

starts a virtual X server on a first free display. it only tries the first N displays though, so heads up — you can lowkey run out of them 😭

rlVirtualXStart name [N]

• name — a string identifying the X server 🏷️
• N — maximum number of displays to try. defaults to 3 🎯

returns 0 when the server is started successfully. slay ✅

⭐ rlVirtualXGetDisplay

gets you the DISPLAY variable for the specified virtual X server 🖥️💫

rlVirtualXGetDisplay name

• name — a string identifying the X server 🏷️

it displays the number of the display where the specified virtual X server is running to standard output. returns 0 on success 🫶

⭐ rlVirtualXStop

kills the specified X server 💀🔪 (affectionately)

rlVirtualXStop name

• name — a string identifying the X server 🏷️

returns 0 when the server is stopped successfully ✅

---

🍓 Example 🍓

here's a simple example of usage, bestie. also ngl, a lot of usefull debugging information is reported on the DEBUG level, so you can run your test with DEBUG=1 make run to get them 👀🔥

rlVirtualXStart $TEST
rlAssert0 "Virtual X server started" $?
export DISPLAY="$( rlVirtualXGetDisplay $TEST )"
# ...your test which needs X...
rlVirtualXStop $TEST
rlAssert0 "Virtual X server killed" $?

---

and these are the Requires lines for your scripts — note the different package names for different RHEL versions, this part matters fr fr 🙈

@echo "Requires: xorg-x11-server-Xvfb" >> $(METADATA) # RHEL-5
@echo "Requires: xorg-x11-Xvfb"        >> $(METADATA) # RHEL-4
@echo "Requires: XFree86-Xvfb"         >> $(METADATA) # RHEL-3

---

💜 AUTHORS 💜

• Jan Hutar <jhutar@redhat.com> 🌈
• Petr Splichal <psplicha@redhat.com> 🌈

---

so yeah, that's the whole page 💅 go forth and virtual-X responsibly, bestie 🦋

and a lil sign-off from the footer: this gorgeous document came from perl v5.32.1, dated 2026-04-07 — VIRTUALX.SH(1), periodt 🎀✨