Added known issue regarding privoxy user and group on Mavericks & Yosemite
authorIan Silvester <iansilvester@fastmail.fm>
Mon, 17 Nov 2014 01:13:58 +0000 (01:13 +0000)
committerIan Silvester <iansilvester@fastmail.fm>
Mon, 17 Nov 2014 01:13:58 +0000 (01:13 +0000)
pkg content skeleton/Applications/Privoxy/readme.rtfd/TXT.rtf

index dfe0c38..8d35d57 100644 (file)
@@ -49,12 +49,29 @@ If you see a page like the following screenshot then all is well and Privoxy is
 
 \b0\fs24 \cf0 {{\NeXTGraphic Screen shot 2012-01-30 at 1.23.15 PM.png \width25300 \height12660
 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\ql\qnatural\pardirnatural
-
-\b\fs26 \cf0 \
+\cf0 \
 \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 \cf0 \
 \
 \
+
+\b\fs26 \
+Known problems
+\b0\fs24 \
+
+\b\fs26 \
+
+\b0\fs24 The OS X 'Mavericks' & 'Yosemite' releases have a bug that causes an intermittent problem for Privoxy that a simple upgrade install will not cure. If you have a persistent problem with Privoxy not starting (in your web browser you get a "Cannot connect to proxy server" error) then the best advice is to completely uninstall Privoxy (using the guide in the readme file at /Applications/Privoxy) then reinstall from scratch. Please ensure you take a copy of your config file and filters if you have made any customisations you do not want to lose.\
+\
+For the technically minded, the bug is that the _privoxy user & group cannot be reliably read from directory services at system startup time (there are suggestions that usernames with leading underscore are no longer properly supported), causing Privoxy to fail to load. Details can be found in these discussion threads:\
+\
+https://sourceforge.net/p/ijbswa/support-requests/1601/\
+https://sourceforge.net/p/ijbswa/support-requests/1599/\
+https://sourceforge.net/p/ijbswa/bugs/882/
+\b\fs26 \
+\
+\
+\
 Configuring Privoxy
 \b0\fs24 \
 \
@@ -85,18 +102,22 @@ If you already had Privoxy installed prior to this installation, then your confi
 
 \b0\fs24 Privoxy can be started and stopped using the two scripts in /Applications/Privoxy named startPrivoxy.sh and stopPrivoxy.sh. They must be run as sudo from an account that has administrative rights. To do this, open a Terminal window then enter the following commands:\
 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\f1 cd /Applications/Privoxy\
+\f1 \cf0 cd /Applications/Privoxy\
 sudo ./startPrivoxy.sh\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\f0 \
+\f0 \cf0 \
 <or>
 \b \
 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\f1\b0 sudo ./stopPrivoxy.sh\
+\f1\b0 \cf0 sudo ./stopPrivoxy.sh\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\f0\b \
+\f0\b \cf0 \
 \
 \
 
@@ -108,11 +129,13 @@ To remove Privoxy once it has been installed, first of all reconfigure your web
 \
 To do this, open a Terminal window then enter the following commands:\
 \
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\f1 cd /Applications/Privoxy\
+\f1 \cf0 cd /Applications/Privoxy\
 sudo ./uninstall.command\
+\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\ql\qnatural\pardirnatural
 
-\f0 \
+\f0 \cf0 \
 You will be prompted for your password, since the script requires super-user privileges to run. If your account is not an administrator account, then the script won't work; you'll need to log in using an administrator account and try again. If you have already dragged the Privoxy application folder to the trash, use the 'Put Back' feature to restore it or else recreate the Privoxy folder in your Applications folder, drag the uninstall.command file from the trash to that folder and proceed as above.\
 \
 \