]> xenbits.xensource.com Git - libvirt.git/commitdiff
man: virt-admin: Mention monolithic daemon URIs
authorPeter Krempa <pkrempa@redhat.com>
Thu, 20 Jan 2022 15:20:22 +0000 (16:20 +0100)
committerPeter Krempa <pkrempa@redhat.com>
Fri, 21 Jan 2022 12:40:11 +0000 (13:40 +0100)
Hint users that they can use 'virt-admin' also for the new monolithic
daemons.

Resolves: https://bugzilla.redhat.com/show_bug.cgi?id=2038045
Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Erik Skultety <eskultet@redhat.com>
docs/manpages/virt-admin.rst

index fff65cf9a714f3c8cd1b98afbb13b6316270606b..30cfd24e7300bb4d6e92fc71e03f541d17f85dfc 100644 (file)
@@ -55,7 +55,7 @@ The ``virt-admin`` program understands the following *OPTIONS*.
 ``-c``, ``--connect`` *URI*
 
 Connect to the specified *URI*, as if by the ``connect`` command,
-instead of the default connection.
+instead of the default connection. See `NOTES`_.
 
 ``-d``, ``--debug`` *LEVEL*
 
@@ -90,7 +90,14 @@ virt-admin is coming from.
 NOTES
 =====
 
-Running ``virt-admin`` requires root privileges due to the
+The ``virt-admin`` supports both the monolithic ``libvirtd`` daemon and the
+`modular daemons <https://www.libvirt.org/daemons.html#modular-driver-daemons>`__
+whichever is in use by your system. The connection *URI* used with
+``-c/--connect`` or the `connect`_ command is based on the name of the
+controlled daemon e.g.: ``virtqemud:///system``, ``libvirtd:///system``.
+
+Running ``virt-admin`` requires root privileges when communicating with the
+system instance of a daemon (*URI* ending in ``/system``) due to the
 communications channels used to talk to the daemon.
 
 GENERIC COMMANDS
@@ -194,6 +201,8 @@ If *LIBVIRT_ADMIN_DEFAULT_URI* or *uri_default* (see below) were set,
 active connection is executed. Note that this only applies if there is no
 connection at all or there is an inactive one.
 
+See `NOTES`_ on picking the correct *URI* corresponding to a libvirt daemon.
+
 To find the currently used URI, check the *uri* command documented below.