spice-vdagentd(1)

📦
version 0.23.0 · 5 versions
, in alpine 3.24, fedora 43, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu resolute, ubuntu stonking

💖 spice-vdagentd 💖

okay bestie, so this is spice-vdagentd — the Spice guest agent daemon, straight out of the General Commands Manual. it's the system-wide half of the whole Spice guest agent situation and honestly? it's doing the most so your VM feels ✨native✨. let's get into it 🫶

✨ NAME ✨

spice-vdagentd — the Spice guest agent daemon 🎀

🌸 SYNOPSIS 🌸

spice-vdagent [OPTIONS]
yes bestie, that's literally what the manpage says, we're keeping it exactly as-is, no cap 💅

🦋 DESCRIPTION 🦋

so the Spice guest agent for Linux is lowkey a two-part girlboss situation: there's the system-wide daemon spice-vdagentd, and then there's the X11 session agent spice-vdagent — and you get one of those per X11 session. the way that they're a duo? iconic.

spice-vdagentd gets started through a Sys-V initscript or a systemd unit. that's the whole vibe. she's a daemon, she shows up at boot, she handles business. 👑

💅 FEATURES 💅

the Spice guest agent adds these features to Spice Linux guests, and ngl it's a whole glow-up:

  • Client mouse mode — no need to grab the mouse by the client, and no mouse lag. obsessed. 🐭✨
  • Automatic adjustment of the X11 session's number of virtual monitors, and their resolution, to the number of client windows and their resolution. it just knows. 🖥️🖥️🖥️
  • Support of copy and paste (text and images) between the active X11 session and the client — and bestie, this supports both the primary selection and the clipboard. the range?? unmatched. 📋🖼️
  • Support for transferring files from the client to the agent. files. moving. periodt. 📁➡️

✨ OPTIONS ✨

  • -h — print a short description of all command line options. the little "what does everything do" moment, we love her 🥰
  • -d — log debug messages. use it twice for extra info 🔍 (yes, twice. she's hungry for detail.)
  • -f — treat the uinput device as fake; no ioctls. this is useful in combination with Xspice 🫥
  • -o — the daemon will exit after processing a single session. one and done, she's out 💨
  • -s port — set the virtio serial port (default: /dev/virtio-ports/com.redhat.spice.0) 🔌
  • -u device — set the uinput device (default: /dev/uinput) 🎮
  • -x — don't daemonize. stay in the foreground with me, bestie 🫶
  • -X — disable session info usage. here's the tea: spice-vdagentd needs to know which spice-vdagent is in the currently active X11 session. spice-vdagentd uses console kit or systemd-logind (compile time option) for this; the -X option disables this, and if no session info is available only one spice-vdagent is allowed 🚫👥

🎀 FILES 🎀

the Sys-V initscript or systemd unit parses the following files:

  • /etc/sysconfig/spice-vdagentd — default cmdline options can be passed to spice-vdagentd by setting them in the SPICE_VDAGENTD_EXTRA_ARGS variable in this file 📝✨

🌈 SEE ALSO 🌈

Copyright 2010-2013 Red Hat, Inc. License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. ⚠️ fr fr, no warranty bestie, don't come for her.

and that's the whole page, bestie 🥹🫶 this was spice-vdagent 0.23.0, dated April 2013 — a whole legend from the spice-vdagentd(1) manual. mwah 💋✨

📦 where this page comes from