From: Peter Krempa Date: Thu, 20 Jan 2022 15:20:22 +0000 (+0100) Subject: man: virt-admin: Mention monolithic daemon URIs X-Git-Tag: v8.1.0-rc1~339 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=61ad7001299c83b2add18c2ba6d286c04c74ec15;p=thirdparty%2Flibvirt.git 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 --- 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.