[PATCH 3/3] docs: Do not support non-socket activated modular daemons with systemd

Martin Kletzander mkletzan at redhat.com
Tue Oct 18 14:37:32 UTC 2022


Due to the setup of the modular daemon service files the reverting to non-socket
activated daemons could have never worked.  The reason is that masking the
socket files prevents starting the daemons since they require (as in Requires=
rather than Wants= in the service file) the sockets.  On top of that it creates
issues with some libvirt-guests setups and needlessly increases our support
matrix.

Nothing prevents users to modify their setup in a way that will still work
without socket activation, but supporting such setup only creates burden on our
part.

This technically reverts most of commit 59d30adacd1d except the change made to
the libvirtd manpage since the monolithic daemon still supports traditional mode
of starting even on systemd.

Signed-off-by: Martin Kletzander <mkletzan at redhat.com>
---
 docs/manpages/virtinterfaced.rst | 23 +++++++++----------
 docs/manpages/virtlxcd.rst       | 37 +++++++++----------------------
 docs/manpages/virtnetworkd.rst   | 23 +++++++++----------
 docs/manpages/virtnodedevd.rst   | 23 +++++++++----------
 docs/manpages/virtnwfilterd.rst  | 23 +++++++++----------
 docs/manpages/virtqemud.rst      | 37 +++++++++----------------------
 docs/manpages/virtsecretd.rst    | 23 +++++++++----------
 docs/manpages/virtstoraged.rst   | 23 +++++++++----------
 docs/manpages/virtvboxd.rst      | 38 ++++++++++----------------------
 docs/manpages/virtvzd.rst        | 37 +++++++++----------------------
 docs/manpages/virtxend.rst       | 37 +++++++++----------------------
 11 files changed, 122 insertions(+), 202 deletions(-)

diff --git a/docs/manpages/virtinterfaced.rst b/docs/manpages/virtinterfaced.rst
index 5777dba638b0..0d5ac8b489ad 100644
--- a/docs/manpages/virtinterfaced.rst
+++ b/docs/manpages/virtinterfaced.rst
@@ -39,26 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtinterfaced`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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
+Socket activation mode
+------------------------
+
+On hosts with systemd it is started in socket activation mode and it 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/virtinterfaced.conf`` will no longer have any effect.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
 
-::
+Traditional service mode
+------------------------
 
-   $ systemctl mask virtinterfaced.socket virtinterfaced-ro.socket \
-      virtinterfaced-admin.socket
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtlxcd.rst b/docs/manpages/virtlxcd.rst
index aebc8adb5822..704e30dfea3e 100644
--- a/docs/manpages/virtlxcd.rst
+++ b/docs/manpages/virtlxcd.rst
@@ -39,40 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtlxcd`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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/virtlxcd.conf`` will no longer have any effect.
-
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
-
-::
+Socket activation mode
+------------------------
 
-   $ systemctl mask virtlxcd.socket virtlxcd-ro.socket \
-      virtlxcd-admin.socket
+On hosts with systemd it is started in socket activation mode and it 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/virtlxcd.conf`` will no longer have any effect.
 
-If using libvirt-guests service then the ordering for that service needs to be
-adapted so that it is ordered after the service unit instead of the socket unit.
-Since dependencies and ordering cannot be changed with drop-in overrides, the
-whole libvirt-guests unit file needs to be changed.  In order to preserve such
-change copy the installed ``/usr/lib/systemd/system/libvirt-guests.service`` to
-``/etc/systemd/system/libvirt-guests.service`` and make the change there,
-specifically make sure the ``After=`` ordering mentions ``virtlxcd.service`` and
-not ``virtlxcd.socket``:
 
-::
+Traditional service mode
+------------------------
 
-   [Unit]
-   After=virtlxcd.service
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtnetworkd.rst b/docs/manpages/virtnetworkd.rst
index 6d9c5e5fa371..22bbd97dcd14 100644
--- a/docs/manpages/virtnetworkd.rst
+++ b/docs/manpages/virtnetworkd.rst
@@ -39,26 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtnetworkd`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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
+Socket activation mode
+------------------------
+
+On hosts with systemd it is started in socket activation mode and it 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/virtnetworkd.conf`` will no longer have any effect.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
 
-::
+Traditional service mode
+------------------------
 
-   $ systemctl mask virtnetworkd.socket virtnetworkd-ro.socket \
-      virtnetworkd-admin.socket
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtnodedevd.rst b/docs/manpages/virtnodedevd.rst
index ef968e486e93..8b751ec730ac 100644
--- a/docs/manpages/virtnodedevd.rst
+++ b/docs/manpages/virtnodedevd.rst
@@ -38,26 +38,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtnodedevd`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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
+Socket activation mode
+------------------------
+
+On hosts with systemd it is started in socket activation mode and it 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/virtnodedevd.conf`` will no longer have any effect.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
 
-::
+Traditional service mode
+------------------------
 
-   $ systemctl mask virtnodedevd.socket virtnodedevd-ro.socket \
-      virtnodedevd-admin.socket
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtnwfilterd.rst b/docs/manpages/virtnwfilterd.rst
index 4faa6b225d17..b09e551958d0 100644
--- a/docs/manpages/virtnwfilterd.rst
+++ b/docs/manpages/virtnwfilterd.rst
@@ -39,26 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtnwfilterd`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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
+Socket activation mode
+------------------------
+
+On hosts with systemd it is started in socket activation mode and it 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/virtnwfilterd.conf`` will no longer have any effect.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
 
-::
+Traditional service mode
+------------------------
 
-   $ systemctl mask virtnwfilterd.socket virtnwfilterd-ro.socket \
-      virtnwfilterd-admin.socket
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtqemud.rst b/docs/manpages/virtqemud.rst
index fa9a6ce3755c..cbd70e0cb74c 100644
--- a/docs/manpages/virtqemud.rst
+++ b/docs/manpages/virtqemud.rst
@@ -39,40 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtqemud`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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/virtqemud.conf`` will no longer have any effect.
-
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
-
-::
+Socket activation mode
+------------------------
 
-   $ systemctl mask virtqemud.socket virtqemud-ro.socket \
-      virtqemud-admin.socket
+On hosts with systemd it is started in socket activation mode and it 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/virtqemud.conf`` will no longer have any effect.
 
-If using libvirt-guests service then the ordering for that service needs to be
-adapted so that it is ordered after the service unit instead of the socket unit.
-Since dependencies and ordering cannot be changed with drop-in overrides, the
-whole libvirt-guests unit file needs to be changed.  In order to preserve such
-change copy the installed ``/usr/lib/systemd/system/libvirt-guests.service`` to
-``/etc/systemd/system/libvirt-guests.service`` and make the change there,
-specifically make sure the ``After=`` ordering mentions ``virtqemud.service`` and
-not ``virtqemud.socket``:
 
-::
+Traditional service mode
+------------------------
 
-   [Unit]
-   After=virtqemud.service
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtsecretd.rst b/docs/manpages/virtsecretd.rst
index fffb3a24f615..9242bbb18f4e 100644
--- a/docs/manpages/virtsecretd.rst
+++ b/docs/manpages/virtsecretd.rst
@@ -38,26 +38,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtsecretd`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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
+Socket activation mode
+------------------------
+
+On hosts with systemd it is started in socket activation mode and it 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/virtsecretd.conf`` will no longer have any effect.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
 
-::
+Traditional service mode
+------------------------
 
-   $ systemctl mask virtsecretd.socket virtsecretd-ro.socket \
-      virtsecretd-admin.socket
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtstoraged.rst b/docs/manpages/virtstoraged.rst
index 4ceae57e406a..5f6da87f2124 100644
--- a/docs/manpages/virtstoraged.rst
+++ b/docs/manpages/virtstoraged.rst
@@ -39,26 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtstoraged`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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
+Socket activation mode
+------------------------
+
+On hosts with systemd it is started in socket activation mode and it 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.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
 
-::
+Traditional service mode
+------------------------
 
-   $ systemctl mask virtstoraged.socket virtstoraged-ro.socket \
-      virtstoraged-admin.socket
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtvboxd.rst b/docs/manpages/virtvboxd.rst
index f90de3451d8d..bc4d9e22a836 100644
--- a/docs/manpages/virtvboxd.rst
+++ b/docs/manpages/virtvboxd.rst
@@ -37,40 +37,26 @@ Restarting ``virtvboxd`` does not interrupt running guests. Guests continue to
 operate and changes in their state will generally be picked up automatically
 during startup.
 
-SYSTEM SOCKET ACTIVATION
-========================
 
-The ``virtvboxd`` daemon is capable of starting in two modes.
+DAEMON STARTUP MODES
+====================
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
+The ``virtvboxd`` daemon is capable of starting in two modes.
 
-In socket activation mode, it 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/virtvboxd.conf`` will no longer have any effect.
 
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
+Socket activation mode
+------------------------
 
-::
-
-   $ systemctl mask virtvboxd.socket virtvboxd-ro.socket \
-      virtvboxd-admin.socket
+On hosts with systemd it is started in socket activation mode and it 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/virtvboxd.conf`` will no longer have any effect.
 
-If using libvirt-guests service then the ordering for that service needs to be
-adapted so that it is ordered after the service unit instead of the socket unit.
-Since dependencies and ordering cannot be changed with drop-in overrides, the
-whole libvirt-guests unit file needs to be changed.  In order to preserve such
-change copy the installed ``/usr/lib/systemd/system/libvirt-guests.service`` to
-``/etc/systemd/system/libvirt-guests.service`` and make the change there,
-specifically make sure the ``After=`` ordering mentions ``virtvboxd.service`` and
-not ``virtvboxd.socket``:
 
-::
+Traditional service mode
+------------------------
 
-   [Unit]
-   After=virtvboxd.service
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtvzd.rst b/docs/manpages/virtvzd.rst
index 970719aac1d5..6097ddab8d08 100644
--- a/docs/manpages/virtvzd.rst
+++ b/docs/manpages/virtvzd.rst
@@ -39,40 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtvzd`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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/virtvzd.conf`` will no longer have any effect.
-
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
-
-::
+Socket activation mode
+------------------------
 
-   $ systemctl mask virtvzd.socket virtvzd-ro.socket \
-      virtvzd-admin.socket
+On hosts with systemd it is started in socket activation mode and it 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/virtvzd.conf`` will no longer have any effect.
 
-If using libvirt-guests service then the ordering for that service needs to be
-adapted so that it is ordered after the service unit instead of the socket unit.
-Since dependencies and ordering cannot be changed with drop-in overrides, the
-whole libvirt-guests unit file needs to be changed.  In order to preserve such
-change copy the installed ``/usr/lib/systemd/system/libvirt-guests.service`` to
-``/etc/systemd/system/libvirt-guests.service`` and make the change there,
-specifically make sure the ``After=`` ordering mentions ``virtvzd.service`` and
-not ``virtvzd.socket``:
 
-::
+Traditional service mode
+------------------------
 
-   [Unit]
-   After=virtvzd.service
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
diff --git a/docs/manpages/virtxend.rst b/docs/manpages/virtxend.rst
index cf7685ecc0e6..415e8587ce6f 100644
--- a/docs/manpages/virtxend.rst
+++ b/docs/manpages/virtxend.rst
@@ -39,40 +39,25 @@ during startup. None the less it is recommended to avoid restarting with
 running guests whenever practical.
 
 
-SYSTEM SOCKET ACTIVATION
-========================
+DAEMON STARTUP MODES
+====================
 
 The ``virtxend`` daemon is capable of starting in two modes.
 
-In the traditional mode, it will create and listen on UNIX sockets itself.
 
-In socket activation mode, it 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/virtxend.conf`` will no longer have any effect.
-
-Socket activation mode is generally the default when running on a host
-OS that uses systemd. To revert to the traditional mode, all the socket
-unit files must be masked:
-
-::
+Socket activation mode
+------------------------
 
-   $ systemctl mask virtxend.socket virtxend-ro.socket \
-      virtxend-admin.socket
+On hosts with systemd it is started in socket activation mode and it 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/virtxend.conf`` will no longer have any effect.
 
-If using libvirt-guests service then the ordering for that service needs to be
-adapted so that it is ordered after the service unit instead of the socket unit.
-Since dependencies and ordering cannot be changed with drop-in overrides, the
-whole libvirt-guests unit file needs to be changed.  In order to preserve such
-change copy the installed ``/usr/lib/systemd/system/libvirt-guests.service`` to
-``/etc/systemd/system/libvirt-guests.service`` and make the change there,
-specifically make sure the ``After=`` ordering mentions ``virtxend.service`` and
-not ``virtxend.socket``:
 
-::
+Traditional service mode
+------------------------
 
-   [Unit]
-   After=virtxend.service
+On hosts without systemd, it will create and listen on UNIX sockets itself.
 
 
 OPTIONS
-- 
2.38.0



More information about the libvir-list mailing list