From: wessels <>
Date: Mon, 14 Sep 1998 08:33:54 +0000 (+0000)
Subject: update comments
X-Git-Tag: SQUID_3_0_PRE1~2739
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=5a3f6538df5bb5ef9c1348ec5338b6091916586a;p=thirdparty%2Fsquid.git

update comments
---

diff --git a/src/cf.data.pre b/src/cf.data.pre
index dc2c1c3169..ce7197a100 100644
--- a/src/cf.data.pre
+++ b/src/cf.data.pre
@@ -1,6 +1,6 @@
 
 #
-# $Id: cf.data.pre,v 1.107 1998/09/09 20:05:47 wessels Exp $
+# $Id: cf.data.pre,v 1.108 1998/09/14 02:33:54 wessels Exp $
 #
 #
 # SQUID Internet Object Cache  http://squid.nlanr.net/Squid/
@@ -158,8 +158,9 @@ DOC_START
 
 	The default behaviour is to not bind to any specific address.
 
-	NOTE, udp_incoming_address and udp_outgoing_address can not have
-	the same value since they both use port 3130.
+	NOTE, udp_incoming_address and udp_outgoing_address can not
+	have the same value (unless it is 0.0.0.0) since they both use
+	port 3130.
 
 tcp_incoming_address 0.0.0.0
 tcp_outgoing_address 0.0.0.0
@@ -1511,9 +1512,14 @@ TYPE: string
 DEFAULT: nogroup
 LOC: Config.effectiveGroup
 DOC_START
+
 	If the cache is run as root, it will change its effective/real
-	UID/GID to the UID/GID specified below.  The default is not to
-	change UID/GID.
+	UID/GID to the UID/GID specified below.  The default is to
+	change to UID to nobody and GID to nogroup.
+
+	If Squid is not started as root, the default is to keep the
+	current UID/GID.  Note that if Squid is not started as root then
+	you cannot set http_port to a value lower than 1024.
 
 cache_effective_user nobody
 cache_effective_group nogroup
@@ -1703,13 +1709,19 @@ TYPE: int
 DEFAULT: 10
 LOC: Config.Log.rotateNumber
 DOC_START
-	Specifies the number of logfile rotations to make upon
-	receiving a USR1 signal.  The default is 10, which will rotate
+	Specifies the number of logfile rotations to make when you
+	type 'squid -k rotate'.  The default is 10, which will rotate
 	with extensions 0 through 9.  Setting logfile_rotate to 0 will
 	disable the rotation, but the logfiles are still closed and
 	re-opened.  This will enable you to rename the logfiles
-	yourself just before sending a USR1 signal to the Squid
-	process.
+	yourself just before sending the rotate signal.
+
+	Note, the 'squid -k rotate' command normally sends a USR1
+	signal to the running squid process.  In certain situations
+	(e.g. on Linux with Async I/O), USR1 is used for other
+	purposes, so -k rotate uses another signal.  It is best to get
+	in the habit of using 'squid -k rotate' instead of 'kill -USR1
+	<pid>'.
 
 logfile_rotate 10
 DOC_END