CLPQ Version 0.3 by D. Palomo van Es ------------------------------------------------- Email : dpalomo@liacs.nl Home page : http://www.wi.leidenuniv.nl/~dpalomo ------------------------------------------------- IMPORTANT - - - - - CLPQ is still in the alpha testing stage. It might have bugs, and it might not work on your machine. If it doesn't, please feel free to mail me, and I'll try to fix the problem directly or I'll implement it in a future release. Thank you for using CLPQ. Introduction - - - - - - CLPQ is a printer-queue console program. You can use it to watch the queue of the printer, given in the first line of the file delivered called 'conf'. You should adjust this to your own spool-dir. (See subsection -- Editing the 'conf'-file -- ) The features of CLPQ are: - Multiuser (only root has root-rights) - Adjustable refresh-rate [1..255] - Removal of jobs from the queue - Set an Alarm on a print job This version of the program is for a single printer. But several users can use the program at the same time. I hope a have the single printer-problem fixed soon. To run the program type after installation './clpq' from the program directory or wherever you placed the program. Editing the 'conf'-file - - - - - - - - - - - - The 'conf'-file is delivered with a standard single printer configuration, it works properly under Redhat 6.0. You might want to change it, you can fill the fields as follows: path=PATH OF YOUR PRINTERSPOOL-DIRECTORY refreshrate=REFRESH-RATE MAY VARY FROM 1 to 255 alarm=COMMAND-LINE TO BE EXECUTED FOR TERMINATING MARKED JOBS When the path and refresh-rate line are not set the program will not work properly. The alarm line is optional, if it's not set the system-beep will be used as a confirmation. You can add comment lines, this lines should start with #. It isn't possible yet to add comments after a line in which an option is set. Using CLPQ: - - - - - - There a couple of command keys which you can use under CLPQ. You can use the Up/Down arrows to scroll the selectionline through the jobs, and: 'a' or 'A' : To set the alarm on the job the selection-line highlights. 'u' or 'U' : To unset the alarm on the job the selection-line highlights. 'r' or 'R' : To remove the job the selection-line highlights. 'q' or 'Q' : To end CLPQ. 'h' or 'H' : To display the helpscreen. The command-keys are without the single quotes. You should run CLPQ in a window of at least 12x60 big. Needed: - - - - A c++ compatible compiler like GNU's g++. The ncurses libraries. Installation: - - - - - - - Edit the 'conf' file if needed (see above); type : 'make' ==> clpq will be made, conf file will be copied to your Home-dir, and clpq will be stripped. * For non-root users the conf file should be copied to their Home-dir as ".clpqconf" (without the quotes). Deliveries: - - - - - - README -- The file you're reading Makefile -- The file that MAKES it all possible clpq.h -- The header-file used by clpq.cc clpq.cc -- The source-file (in future I'll clean this file) conf -- The config-file notify.wav -- A wave file which can be used as alarm-sound for a tagged job Troubleshooting - - - - - - - - - The alarm doesn't work: * Is it a correct command-line? * Your refresh-rate could be very low and several jobs have been completed, also the ones which were marked without a refreshed check. So try to change the refresh-rate. Any other troubles you can mail me at dpalomo@cheerful.com, please set the subject line of your mail with 'CLPQ question'. I'll try to feedback you as soon as possible. Bug fixes - - - - - From Version 0.1: - Configure file is used from the $HOME directory. - When the spool is empty and a new entry is made ==> mark the new queue line. - In the makefile there's a line where you can (as root) configure clpq for other users. From Version 0.2: - Now it's possible to use it by other users than root. - Copying of the conf file is now done correctly. - Not allowing to delete jobs other than of the current user (with exception of root) - When a job is not removed, don't scroll the selection-line. - Each user has his own config-files. - conf file has been made readable and more flexible. - Alarm option has been implemented. - A help screen explaining the command-keys. TODO's: - - - - a. Allow Multiple Printers and 'switch' between their queues. b. Start a root demon which updates the temp files and makes it readable for non root users, even when the printer-spool files are unreadable. (instead of sticky bitting!) c. Create a optionscreen where you can configure the 'conf'-file. d. Several other ideas... ;-) ----------------------------------- Copyright (c) 1999, D.Palomo van Es ----------------------------------- Permission to use, copy, modify, distribute and sell this software and its documentation for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation. This software is provided "as is" without express or implied warranty. Use at own risk!