[Serverfilters-commit] script README,1.1,1.2

[<ton...@us...>]

Update of /cvsroot/serverfilters/script
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv9675

Modified Files:
	README 
Log Message:
Added troubleshooting text for various error messages

Index: README
===================================================================
RCS file: /cvsroot/serverfilters/script/README,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** README	29 Feb 2004 22:56:36 -0000	1.1
--- README	1 Mar 2004 14:03:09 -0000	1.2
***************
*** 19,21 ****
  TROUBLESHOOTING
  
! To be written.
--- 19,79 ----
  TROUBLESHOOTING
  
! * When I visit the options page, I get a strange error at the top of the
! page and my filters are not saved.
! 
! Read the number at the end of that error message and find the explanation
! below.
! 
! * I am getting error 4, "filtercmd - setgid: Operation not permitted"
! 
! The binary is not setuid root. Run this command, "sudo chmod 4750 filtercmd".
! 
! * I am getting error 126
! 
! You didn't change the group in the makefile. Run this command, 
! "sudo chgrp apache filtercmd", replacing apache with your web server's group.
! 
! * I am getting error 10, "Can't read imap server from configfile"
! 
! filtercmd expects to find the squirrelmail configuration file in a certain place
! (specified in the Makefile). Did the squirrelmail/config.php file move?
! 
! * I am getting error 12, "Bad credentials"
! 
! This means the IMAP connection is not working. Compile the filtercmd with
! debugging on and run test.sh to find out why. This can sometimes be fixed by 
! adding options such as /notls to the MAILBOXNAME setting in the Makefile.
! 
! * I am getting error 13, "Can't verify credentials, IMAP not supported by library"
! 
! This error message means that the c-client library was mis-compiled -- you
! will have to either compile the c-client library by hand or find a working
! version.
! 
! * I am getting error 14, "Can't look up virtual user"
! 
! Check that the domain (everything after the @ in the username) was not found in the "virtualdomains"
! file. 
! 
! * I am getting error 15, "Can't trust config file -- make sure they are all owned by root"
! 
! filtercmd requires that the configuration files it consults are all
! root-owned. This ensures that the decisions filtercmd makes about which
! files to write are not based on tampered configuration files. All of the
! parent directories are checked as well. So, check the ownership of the
! configuration files, and the parent directories of those configuration
! files:
! 
!    /etc/squirrelmail/config.php
!    /usr/share/squirrelmail/plugins/serversidefilter/config.php
!    /usr/share/squirrelmail/plugins/serversidefilter/virtualdomains
! 
! * I don't have root access.
! 
! filtercmd can work in "single user" mode. Change the permissions of the file
! to 6755 and make sure it is owned by the user and group that owns the
! filter/forward files. Other users accessing the filtering page will get
! error 4. Note that the restrictions outlined while explaining error 15 still
! apply -- so without root access you still may not be able to run
! serversidefilter.
!