Changeset 952 for pykota/trunk/README

Timestamp:

04/24/03 00:13:57 (21 years ago)

Author:

jalet

Message:

Preliminary support for LPRng added BUT STILL UNTESTED.

Files:

• pykota/trunk/README (modified) (9 diffs)

pykota/trunk/README

@@ -1 +1 @@
 # $Id$
 
-PyKota - Print Quota for CUPS
+PyKota - Print Quota for CUPS and LPRng
 
 (c) 2003 Jerome Alet <alet@librelogiciel.com>
@@ -25 +25 @@
 
 PyKota is a complete Print Quota system for the Common Unix Printing
-System (aka CUPS), which works by directly querying the printers
-for the number of pages they have printed.
+System (aka CUPS) or LPR Next Generation (LPRng), which works by directly 
+querying the printers for the number of pages they have printed.
 
 Actual working features :
 
+        - Supports both CUPS and LPRng backends.
+        
         - Per printer user and group quotas.
         
@@ -35 +37 @@
           user himself and to the print quota administrator.
         
-        - CUPS filter for quota accounting : pykota
+        - Filter for quota accounting : pykota
         
         - Command line print quota editor : edpykota
@@ -101 +103 @@
   of a new job and before the end of the previous job. This depends on 
   the printer speed and time between jobs, but so far I've not seen 
-  any problem with moderately used printers. This also depends on CUPS 
-  internal behavior : if CUPS doesn't begin to send a job to a printer 
-  before the previous one is completely printed, then there's no 
-  problem. 
+  any problem with moderately used printers. This also depends on the
+  printing system's internal behavior : if it doesn't begin to send a 
+  job to a printer before the previous one is completely printed, then 
+  there's no problem. 
   
   Other querying methods which won't suffer from this possible 
@@ -140 +142 @@
   You need to have the following tools installed on the CUPS Server :
   
-    - CUPS
+    - CUPS or LPRng
     - Python v2.1 or above
     - eGenix' mxDateTime Python extension
@@ -155 +157 @@
     - PostgreSQL
     
-  PygreSQL and the PostgreSQL client libraries's versions on the CUPS 
+  PygreSQL and the PostgreSQL client libraries's versions on the Print
   Server must match the PostgreSQL version used on the Quota Storage 
   Server.
@@ -163 +165 @@
   alternatives.
   
-  Of course the CUPS Server and the Quota Storage Server can be the 
+  Of course the Print Server and the Quota Storage Server can be the 
   very same machine if you've got a tiny network, or you can have 
-  multiple CUPS Servers all storing their quotas on the same Quota 
+  multiple Print Servers all storing their quotas on the same Quota 
   Storage Server if you've got a bigger network. 
   
@@ -196 +198 @@
 you if needed and you agreed to this action.
 
-Modify the PPD files for each printer on which you want to manage
-print quotas, for example /etc/cups/ppd/lp.ppd :
-
---- Add the line below exactly as-is somewhere near the top ---
-*cupsFilter:  "application/vnd.cups-postscript 0 /usr/bin/pykota"
---- Add the line above exactly as-is somewhere near the top  ---
-
-Modify the path to the pykota executable if needed, unfortunately 
-you have to supply the correct absolute path here due to CUPS 
-internals, or put the pykota executable into /usr/lib/cups/filter 
-instead of into /usr/bin. 
-
-Do this for each ppd file present in this directory if you want
-to enable quota on every printer.
-          
-WARNING : In the case you've got a non-postscript printer, chances
-          are that the *cupsFilter is already filled-in and points
-          to cupsomatic or such a print filter. In this case please
-          check if you can switch your printer to PostScript mode
-          or if there's a way to make it accept PostScript jobs.
-          If yes then ensure that your workstations uses a PostScript
-          printer driver, and replace the *cupsFilter line with the
-          one pointing to the pykota filter. This should work, but
-          is currently untested.
-          If your printer really needs the original *cupsFilter line
-          then you may not be able to use PyKota easily for now.
-
+  - CUPS Print Backend :
+  
+    Modify the PPD files for each printer on which you want to manage
+    print quotas, for example /etc/cups/ppd/lp.ppd :
+    
+    --- Add the line below exactly as-is somewhere near the top ---
+    *cupsFilter:  "application/vnd.cups-postscript 0 /usr/bin/pykota"
+    --- Add the line above exactly as-is somewhere near the top  ---
+    
+    Modify the path to the pykota executable if needed, unfortunately 
+    you have to supply the correct absolute path here due to CUPS 
+    internals, or put the pykota executable into /usr/lib/cups/filter 
+    instead of into /usr/bin. 
+    
+    Do this for each ppd file present in this directory if you want
+    to enable quota on every printer.
+              
+    WARNING : In the case you've got a non-postscript printer, chances
+              are that the *cupsFilter is already filled-in and points
+              to cupsomatic or such a print filter. In this case please
+              check if you can switch your printer to PostScript mode
+              or if there's a way to make it accept PostScript jobs.
+              If yes then ensure that your workstations uses a PostScript
+              printer driver, and replace the *cupsFilter line with the
+              one pointing to the pykota filter. This should work, but
+              is currently untested.
+              If your printer really needs the original *cupsFilter line
+              then you may not be able to use PyKota easily for now.
+
+  - LPRng Print Backend :
+  
+    Modify the /etc/printcap file to add two lines identical to these ones :
+    
+    :achk=true
+    :as=|/usr/bin/pykota
+    
+    For each printer on which you want to use print accounting.
+  
 Add printers and users to the quota system and set their quota values : 
 
@@ -261 +274 @@
            should make you reasonably safe.
            
+           also please ensure that only the printing daemon user
+           can launch the pykota command. Again this is not enforced
+           in the program.
+           
 ============================================================