root / pykota / trunk / cgi-bin / README @ 2139

# $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 or dumpykota.cgi with 
username+password authentication, the REMOTE_USER CGI environment variable
is honored, so an user can only see his own datas, but not
other users' datas. However, the special REMOTE_USER value 'root'
is allowed an unrestricted access.

If no username+password authentication takes place, then access
is completely unrestricted.

You must ensure that the user your web server runs as can read
PyKota's pykota.conf configuration file. No read access to
PyKota's pykotadmin.conf configuration file is necessary though.

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. 

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