VBOXCONTROL(8)

✨ NAME ✨

VBoxControl — x86 virtualization solution 🦋

---

💖 DESCRIPTION 💖

Hiii bestie, okay so this is the Oracle VM VirtualBox Guest Additions Command Line Management Interface — like, the little command-line bestie that comes with your Guest Additions, and it's here to let you poke at stuff from inside the guest. Version 7.0.16, and the copyright line says Copyright © 2008-2024 Oracle and/or its affiliates. Slay. 👑

Here's the usage the page hands you, verbatim, exactly as printed — yes the wrapping is chaotic, no I will not be fixing it, the facts are the facts 💀:

Oracle VM VirtualBox Guest Additions Command Line Management Interface
Version 7.0.16 Copyright © 2008-2024 Oracle and/or its affiliates

Usage:

VBoxControl [-V|--version]           print version number and exit
VBoxControl --nologo ...             suppress the logo

VBoxControl guestproperty            get <property> [--verbose]
VBoxControl guestproperty            set <property> [<value> [--flags
<flags>]] VBoxControl guestproperty            delete|unset <property>
VBoxControl guestproperty            enumerate [--patterns <patterns>]
VBoxControl guestproperty            wait <patterns>

[--timestamp <last timestamp>]
       [--timeout <timeout in ms>

VBoxControl sharedfolder             list [--automount] VBoxControl
writecoredump VBoxControl writelog [-n|--no-newline] [--] <msg>
VBoxControl takesnapshot VBoxControl savestate VBoxControl suspend
VBoxControl poweroff VBoxControl help                     [command]
VBoxControl version

---

🎀 the whole vibe, command by command 🎀

So basically the page is a list of things VBoxControl can do, and here they all are, in the same order the page puts them, no skipping, no gatekeeping:

• VBoxControl [-V|--version] — prints the version number and exits. That's the whole thing, it's giving one job and doing it flawlessly 💅
• VBoxControl --nologo ... — suppresses the logo. The ... is literally part of the line, keep it, it's part of the fit 🫶
• VBoxControl guestproperty get <property> [--verbose] — get a guest property. There's an optional --verbose in there for when you want the whole tea ☕
• VBoxControl guestproperty set <property> [<value> [--flags <flags>]] — set a guest property. The <value> is optional, and so are the --flags <flags>. Note how the usage block wraps [--flags and <flags>]] onto two lines — that's just line wrapping, the flags themselves are fine ✨
• VBoxControl guestproperty delete|unset <property> — delete a guest property, or unset it, whichever word you're feeling that day. Two spellings, same slot 🌸
• VBoxControl guestproperty enumerate [--patterns <patterns>] — enumerate guest properties, optionally filtered by --patterns <patterns> 🔍
• VBoxControl guestproperty wait <patterns> — wait on <patterns>. And then, hanging out right below it on their own lines in the usage block, are two extras: [--timestamp <last timestamp>] and [--timeout <timeout in ms> — that second one closes with a > that the page never actually prints, so I'm leaving it exactly as it appears 😭 no cap, character for character
• VBoxControl sharedfolder list [--automount] — list shared folders, with an optional --automount 🍓
• VBoxControl writecoredump — write a coredump 📦
• VBoxControl writelog [-n|--no-newline] [--] <msg> — write a log message. You've got -n / --no-newline, you've got a literal bare -- sitting in there, and then your <msg> ✍️
• VBoxControl takesnapshot — take a snapshot 📸
• VBoxControl savestate — save state 💾
• VBoxControl suspend — suspend 😴
• VBoxControl poweroff — power off 🔌
• VBoxControl help [command] — help, and you can hand it a [command] if you want help on one specific thing 🙋‍♀️
• VBoxControl version — version. Yes, alongside -V / --version. Two doors, same room 🚪

---

💜 the flag roundup 💜

Just so nothing slips through the cracks, here's every flag and value that shows up on this page, one bullet each, nothing merged, nothing invented:

• -V, --version — print version number and exit 👑
• --nologo — suppress the logo
• --verbose — for guestproperty get <property>
• --flags <flags> — for guestproperty set <property>
• --patterns <patterns> — for guestproperty enumerate
• --timestamp <last timestamp> — listed right after guestproperty wait <patterns>
• --timeout <timeout in ms> — also listed right after guestproperty wait <patterns>
• --automount — for sharedfolder list
• -n, --no-newline — for writelog
• -- — appears in writelog [-n|--no-newline] [--] <msg>, literally just there, as written

---

Heads up bestie: the usage block up there is reproduced exactly as the page prints it — weird wrapping, unclosed >, all of it. Don't "tidy" it, it's load-bearing 🫠

---

And that's the whole page, fr fr. This little icon lives in the System Administration Utilities collection, dated April 2024, filed under the manual name VBOXCONTROL(8) — and it's signed off by VBoxControl itself. Go be the main character of your guest VM 💖✨🎀🦋