diff options
-rw-r--r-- | Documentation/lei-daemon-kill.pod | 29 | ||||
-rw-r--r-- | Documentation/lei-overview.pod | 8 |
2 files changed, 33 insertions, 4 deletions
diff --git a/Documentation/lei-daemon-kill.pod b/Documentation/lei-daemon-kill.pod index 7fb0fb25..48c237b8 100644 --- a/Documentation/lei-daemon-kill.pod +++ b/Documentation/lei-daemon-kill.pod @@ -8,7 +8,30 @@ lei daemon-kill [-SIGNAL | -s SIGNAL | --signal SIGNAL] =head1 DESCRIPTION -Send a signal to the lei-daemon. C<SIGNAL> defaults to C<TERM>. +Send a signal to the L<lei-daemon(8)>. C<SIGNAL> defaults to C<TERM>. + +This command should be run after updating the code of lei. + +=head1 SIGNALS + +=over 8 + +=item SIGTERM + +Send a graceful termination signal. L<lei-daemon(8)> will exit +when all currently running lei commands are done. The listen +socket will be released as soon as the signal is processed +so another L<lei-daemon(8)> process can take its place. + +=item SIGKILL + +Kills L<lei-daemon(8)> immediately. Some worker processes may +remain running after a short while after this takes effect. + +=back + +=for comment +SIGQUIT and SIGINT currently do what SIGTERM do, may change... =head1 CONTACT @@ -19,10 +42,10 @@ L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> =head1 COPYRIGHT -Copyright 2021 all contributors L<mailto:meta@public-inbox.org> +Copyright all contributors L<mailto:meta@public-inbox.org> License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt> =head1 SEE ALSO -L<lei-daemon-pid(1)> +L<lei-daemon-pid(1)>, L<lei-daemon(8)> diff --git a/Documentation/lei-overview.pod b/Documentation/lei-overview.pod index 40a7b0aa..bb2fe50f 100644 --- a/Documentation/lei-overview.pod +++ b/Documentation/lei-overview.pod @@ -131,6 +131,12 @@ C<contrib/completion/>. Contributions adding support for other shells, as well as improvements to the existing Bash completion, are welcome. +=head1 UPGRADING + +Since lei runs as a daemon, L<lei-daemon-kill(1)> is required to kill +the daemon so it can load new code. It will be restarted with the +next invocation of any lei command. + =head1 CONTACT Feedback welcome via plain-text mail to L<mailto:meta@public-inbox.org> @@ -140,6 +146,6 @@ L<http://4uok3hntl7oi7b4uf4rtfwefqeexfzil2w6kgk2jn5z2f764irre7byd.onion/meta/> =head1 COPYRIGHT -Copyright 2021 all contributors L<mailto:meta@public-inbox.org> +Copyright all contributors L<mailto:meta@public-inbox.org> License: AGPL-3.0+ L<https://www.gnu.org/licenses/agpl-3.0.txt> |