From c4f2aaa45b908972a5d0f817e4a3fdf4474b5765 Mon Sep 17 00:00:00 2001 From: Lennart Poettering Date: Wed, 15 Nov 2017 11:22:25 +0100 Subject: [PATCH] man: document the interaction of "systemctl restart" and the FD store See: #7126 --- man/systemctl.xml | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/man/systemctl.xml b/man/systemctl.xml index bb3fc1763c..fb6bb0d702 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -777,9 +777,17 @@ Sun 2017-02-26 20:57:49 EST 2h 3min left Sun 2017-02-26 11:56:36 EST 6h ago restart PATTERN… - Stop and then start one or more units specified on the - command line. If the units are not running yet, they will - be started. + Stop and then start one or more units specified on the command line. If the units are not running + yet, they will be started. + + Note that restarting a unit with this command does not necessarily flush out all of the unit's + resources before it is started again. For example, the per-service file descriptor storage facility (see + FileDescriptoreStoreMax= in + systemd.service5) will + remain intact as long as the unit has a job pending, and is only cleared when the unit is fully stopped and + no jobs are pending anymore. If it is intended that the file descriptor store is flushed out, too, during a + restart operation an explicit systemctl stop command followed by systemctl + start should be issued.