From 61ad7001299c83b2add18c2ba6d286c04c74ec15 Mon Sep 17 00:00:00 2001 From: Peter Krempa Date: Thu, 20 Jan 2022 16:20:22 +0100 Subject: [PATCH] man: virt-admin: Mention monolithic daemon URIs 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 Reviewed-by: Erik Skultety --- docs/manpages/virt-admin.rst | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/manpages/virt-admin.rst b/docs/manpages/virt-admin.rst index fff65cf9a7..30cfd24e73 100644 --- a/docs/manpages/virt-admin.rst +++ b/docs/manpages/virt-admin.rst @@ -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 `__ +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.