SIGQUIT vs SIGTERM

Traditionally, Unix daemons will reload their configuration upon
receiving SIGHUP and terminate gracefully upon receiving SIGTERM.
Unbound follows this tradition, but in addition, it treats SIGINT
(Ctrl-C when not daemonized) and SIGQUIT (Ctrl-\ when not daemonized) as
equivalent to SIGTERM. The man page documents SIGQUIT as the correct
way to terminate Unbound.

Setting aside the question of wheter intercepting SIGQUIT is a good idea
(I don't think it is, but it's probably too late to change it), this
state of affairs seems to confuse users. Consider this FreeBSD bug
report from a user who claims that Unbound terminates cleanly when it
receives SIGQUIT, but not when it receives SIGTERM:

  https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=203580

In addition, some platforms don't even have SIGQUIT (cf r1097).

I therefore propose to change the man page so that it mentions SIGTERM
instead of SIGQUIT:

Index: doc/unbound.conf.5.in

Hi Dag-Erling,

Traditionally, Unix daemons will reload their configuration upon
receiving SIGHUP and terminate gracefully upon receiving SIGTERM.
Unbound follows this tradition, but in addition, it treats SIGINT
(Ctrl-C when not daemonized) and SIGQUIT (Ctrl-\ when not
daemonized) as equivalent to SIGTERM. The man page documents
SIGQUIT as the correct way to terminate Unbound.

The initial man page was completely wrong, it seems. I did not know
the difference between SIGQUIT and SIGTERM when I wrote it.

Setting aside the question of wheter intercepting SIGQUIT is a good
idea (I don't think it is, but it's probably too late to change
it), this state of affairs seems to confuse users. Consider this
FreeBSD bug report from a user who claims that Unbound terminates
cleanly when it receives SIGQUIT, but not when it receives
SIGTERM:

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=203580

In addition, some platforms don't even have SIGQUIT (cf r1097).

I therefore propose to change the man page so that it mentions
SIGTERM instead of SIGQUIT:

Of course, I'll change the man-page with the patch.

Best regards, Wouter

Index: doc/unbound.conf.5.in

- --- doc/unbound.conf.5.in (revision 3504)