VIRTSTORAGED(8)

📦
version 12.8.0 · 8 versions
, in centos-stream 10

💅 VIRTSTORAGED(8) 💅

Ok so real talk, bestie: this is the manual page for virtstoraged, a daemon that lives in the Virtualization Support section of your man pages and is very much a whole vibe in the libvirt universe. Buckle up, we're getting into it. 🎀

✨ NAME ✨

virtstoraged — the libvirt storage pool management daemon, aka the girl who handles your storage pools so you don't have to 💅

✨ SYNOPSIS ✨

virtstoraged [OPTION]...

✨ DESCRIPTION ✨

So virtstoraged is a server side daemon component of the libvirt virtualization management system. Iconic. Fr fr.

She's one of a whole collection of modular daemons that replaced the functionality that used to be provided by the monolithic libvirtd daemon — think of it like the friend group splitting the group project so nobody has to do everything alone 🫶

This daemon runs on virtualization hosts and provides management for storage pools. That's literally her whole job and she ate.

Here's the important bit: virtstoraged only listens for requests on a local Unix domain socket. Remote access via TLS/TCP, plus backwards compatibility for legacy clients that still expect libvirtd, is provided by the virtproxyd daemon — that's a different girl's department, iykyk.

Now, restarting virtstoraged does not interrupt running guests. Guests keep operating, and changes in their state will generally be picked up automatically during startup. None the less, it is recommended to avoid restarting with running guests whenever practical — like, it's fine, but don't make it a hobby, you know? 🙈

✨ DAEMON STARTUP MODES ✨

The virtstoraged daemon is capable of starting in two modes. Two! Main character energy, honestly 👑

Socket activation mode

On hosts with systemd, it starts in socket activation mode and will rely on systemd to create and listen on the UNIX sockets and pass them as pre-opened file descriptors. In this mode, most of the socket related config options in /etc/libvirt/virtstoraged.conf will no longer have any effect. Like, they're just there. Vibing. Ignored 💀

Traditional service mode

On hosts without systemd, she'll create and listen on UNIX sockets herself. Independent queen behavior ✨

✨ OPTIONS ✨

  • -h, --help — Display command line help usage then exit. Your girl is helpful 💖
  • -d, --daemon — Run as a daemon & write PID file.
  • -f, --config FILE — Use this configuration file, overriding the default value.
  • -p, --pid-file FILE — Use this name for the PID file, overriding the default value.
  • -t, --timeout SECONDS — Exit after timeout period (in seconds), provided there are no client connections.
  • -v, --verbose — Enable output of verbose messages. She'll tell you everything 🗣️
  • --version — Display version information then exit.

✨ SIGNALS ✨

On receipt of SIGHUP, virtstoraged will reload its configuration. One little signal and she's refreshed and rejuvenated, skincare-routine style 🌸

✨ FILES ✨

When run as root 👑

  • /etc/libvirt/virtstoraged.conf

The default configuration file used by virtstoraged, unless overridden on the command line using the -f | --config option.

  • /run/libvirt/virtstoraged-sock
  • /run/libvirt/virtstoraged-sock-ro
  • /run/libvirt/virtstoraged-admin-sock

The sockets virtstoraged will use.

  • The TLS Server private key virtstoraged will use.
  • /run/virtstoraged.pid

The PID file to use, unless overridden by the -p | --pid-file option.

When run as non-root 🦋

  • $XDG_CONFIG_HOME/libvirt/virtstoraged.conf

The default configuration file used by virtstoraged, unless overridden on the command line using the `-f|--config option.

  • $XDG_RUNTIME_DIR/libvirt/virtstoraged-sock
  • $XDG_RUNTIME_DIR/libvirt/virtstoraged-admin-sock

The sockets virtstoraged will use.

  • $XDG_RUNTIME_DIR/libvirt/virtstoraged.pid

The PID file to use, unless overridden by the `-p|--pid-file option.

If $XDG_CONFIG_HOME is not set in your environment, virtstoraged will use $HOME/.config

If $XDG_RUNTIME_DIR is not set in your environment, virtstoraged will use $HOME/.cache

✨ EXAMPLES ✨

To retrieve the version of virtstoraged — a little peek at her birth chart, if you will ⭐

# virtstoraged --version
virtstoraged (libvirt) 12.8.0

To start virtstoraged, instructing it to daemonize and create a PID file:

# virtstoraged -d
# ls -la /run/virtstoraged.pid
-rw-r--r-- 1 root root 6 Jul  9 02:40 /run/virtstoraged.pid

See? She's there. She's living her life. She has a PID file. Slay 💅

✨ BUGS ✨

Please report all bugs you discover. This should be done via either:

  1. the mailing list

https://libvirt.org/contact.html

  1. the bug tracker

https://libvirt.org/bugs.html

Alternatively, you may report bugs to your software distributor / vendor.

No gatekeeping — if you found a bug, say something! 😭

✨ AUTHORS ✨

Please refer to the AUTHORS file distributed with libvirt.

Copyright (C) 2006-2020 Red Hat, Inc., and the authors listed in the libvirt AUTHORS file.

✨ LICENSE ✨

virtstoraged is distributed under the terms of the GNU LGPL v2.1+. This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Like, literally none. Zero. Don't come for her if it breaks 💀

✨ SEE ALSO ✨

virsh(1), libvirtd(8), https://libvirt.org/daemons.html, https://libvirt.org/storage.html

💖 That's the whole page bestie, go configure your storage pools, you've got this 🫶

Ok that's a wrap! This was VIRTSTORAGED(8) from the Virtualization Support corner of your manual, and honestly? She understood the assignment. Mwah 💋🌟

📦 where this page comes from