# $Id$

PyKota - Print Quota for CUPS and LPRng

(c) 2003, 2004, 2005 Jerome Alet <alet@librelogiciel.com>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.

====================================================================

This directory contains CGI scripts which you may find useful to
put on a web server along with PyKota command line tools.

Be sure to restrict access to these CGI scripts as necessary.

If you protect access to printquota.cgi with user+password
authentication, the REMOTE_USER CGI environment variable
is honored, so an user can only see his own quota report, but
not other users' quota.

To make dumpykota.cgi work, you have to ensure that your web server 
runs it as a PyKota administrator. This means that dumpykota.cgi 
when run must be able to read the pykotadmin.conf file. There are 
several ways to do so, one of them is to put the user your web 
server normally runs as into the pykota group (which must be allowed 
to read pykotadmin.conf), then restart your web server :
            
            $ adduser www-data pykota
            $ /etc/init.d/apache restart
            
This is probably not the safest way though, so you may want to            
restrict access further with an username and password, or use
Apache's suExec mechanism to directly run this particular 
script as the pykota system user. Please refer to your web
server's documentation for details.
        
The web server doesn't need to be a print server nor a PyKota 
Storage Backend server, but it must contain a correctly configured 
PyKota installation. 

====================================================================