From: Amos Jeffries <squid3@treenet.co.nz>
Date: Thu, 25 Feb 2016 00:16:34 +0000 (+1300)
Subject: Docs: release notes about process manager changes
X-Git-Tag: SQUID_4_0_8~62
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=fbcef294f7f492bfb35832338ee0bae16fd65b30;p=thirdparty%2Fsquid.git

Docs: release notes about process manager changes
---

diff --git a/doc/release-notes/release-4.sgml b/doc/release-notes/release-4.sgml
index 0e76bac1b9..91b8ad9e0c 100644
--- a/doc/release-notes/release-4.sgml
+++ b/doc/release-notes/release-4.sgml
@@ -47,6 +47,7 @@ The Squid-4 change history can be <url url="http://www.squid-cache.org/Versions/
 	<item>Helper Binary Changes
 	<item>Secure ICAP
 	<item>Improved SMP support
+	<item>Improved process management
 </itemize>
 
 Most user-facing changes are reflected in squid.conf (see below).
@@ -147,6 +148,24 @@ Most user-facing changes are reflected in squid.conf (see below).
    enables Rock storage on more systems by default than previously.
 
 
+<sect1>Improved process management
+<p>Squid is traditionally refered to as a daemon. But is actually a combination
+   of daemon and daemon manager processes. This has caused significant problems
+   integrating it with other third-party daemon managers.
+
+<p>The Squid process which places its PID into the squid.pid file has always
+   been the process to which control signals are sent. The manager process is
+   now taking on signal handling istead of the main daemon process. Enabling
+   integratio with daemon managers such as Upstarrt or systemd which assume the
+   process they initiated is the daemon with a PID to control.
+
+<p>The squid binary now has a new <em>--foreground</em> command line option
+   which prevents the process from exiting early while background workers
+   continue their processing. When run with this option Squid will now wait
+   for the worker(s) to finish before exiting. Unlike the old <em>-N</em> option
+   <em>--foreground</em> supports SMP workers and multi-process features.
+
+
 <sect>Changes to squid.conf since Squid-3.5
 <p>
 There have been changes to Squid's configuration file since Squid-3.5.