smecontribs/smeserver-print-monitor
6
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

initial commit of file from CVS for smeserver-print-monitor on Sat Sep 7 20:55:37 AEST 2024

Browse Source
This commit is contained in:
Trevor Batley
2024-09-07 20:55:37 +10:00
parent 204cbf06cf
commit 66b2b136f2
35 changed files with 3779 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1194
root/usr/local/lprng/bin/lpinfo Normal file
View File

File diff suppressed because it is too large Load Diff

0
root/usr/local/lprng/counters/.gitignore vendored Normal file
View File

3
root/usr/local/lprng/info/locations Normal file
View File

@@ -0,0 +1,3 @@
ALL ALL
Canada ^CAN
Germany ^GER ^DE

2
root/usr/local/lprng/info/locations_subnets Normal file
View File

@@ -0,0 +1,2 @@
not-found not-found
192.168.51 Polen

131
root/usr/local/lprng/info/lpinfo.ph Normal file
View File

@@ -0,0 +1,131 @@
#lpinfo.ph file ... should be fairly static between releases.
#---- Modify stuff below as appropriate for your site ----
#Root directory where LPRng is installed ... this is used to find
#printcap/lpc/lpq/lpr below (you can manually specify where those are)
$LPRng_root_dir = "/usr/local/lprng";
#Directory in "UNIX filespace" where the lpinfo distribution is loaded
$lpinfo_root_dir = "/var/www/html/LPRng";
#This is the same location as above ... but in "web space"
$lpinfo_web_dir = "/LPRng";
#Mentioned on the command line version to show people where the Web version is
$url_address = "http://somehost.com/LPRng/";
#Email address of local support person (or bozo who wrote this! ;-)
$email_address = "admin@localhost";
#In case your site requires meta tags on all documents ...
$meta_tags = "<head>\n<META NAME=\"CONTACT\" CONTENT=\"Komarnitsky, Alek O\">\n<META NAME=\"SENSITIVITY\" CONTENT=\"UNRESTRICTED\"</head>\n";
#-------- These should be fairly boilerplate
#-------- BUT READ THE COMMENTS TO BE SURE!!!!
#Set these to fullpathname where these are found.
#NOTE: set $printcap=NIS if you are using NIS to share printcaps
$printcap = "$LPRng_root_dir/etc/printcap";
$lpc = "/usr/sbin/lpc";
$lpq = "/usr/bin/lpq";
$lpr = "/usr/bin/lpr";
#Pathname of this CGI script when accessed via the Web
$thisURL= "$lpinfo_web_dir/cgi-bin/lpinfo";
#Pathname of local documention/help/procedures - need fullpathname
$helpfile = "$LPRng_root_dir/info/lpinfo_help.html";
#Default time interval in seconds to auto update queue status is set in lpinfo
#set no_over_ride_updatetime if you don't want to allow folks to change this
$no_over_ride_updatetime = 1;
#OPTIONAL: Banner program - used to generate test page ...
#If not defined, then "regular" size print just comes out
$banner = "/usr/games/banner";
#OPTIONAL: Some misc. counters to keep track of accesses ... there are better ways to do this! ;-)
#Don't define these and they won't be used ... but if so, they MUST be writeable by httpd!!!
#Be sure to create these files and stuff a zero in 'em to start things off
#Both must be defined in order for it to display ... first is number of times
#top-level frame is run. Second is total number of times program is run period
$count_file1 = "$lpinfo_root_dir/counters/lpinfo-1";
$count_file2 = "$lpinfo_root_dir/counters/lpinfo-2";
#OPTIONAL: Pathname of directory with info on printers - this has short & long sub-directories
#that have printername files in them with short & long descriptions.
#BTW, if it can't find this directory, no description stuff will be displayed
$info_dir = "$LPRng_root_dir/info";
#OPTIONAL: pathname of file with locations (building names) in them.
#This is used to create a SELECT box that the user can click on.
#"ALL" should be the first entry in this.
#syntax is <keyword> <regular expression(s)>
#Where regular expressions can be used to generate the substring(s) to search
#for in the printer names
$locations_file = "$LPRng_root_dir/info/locations";
#OPTIONAL: pathname of file with locations (building names) in them.
#and the subnets the correspond to ... this is nifty when setup! ;-)
#Syntax is <keyword> <subnet(s)>
#keyword should match what is in the locations_file above, and subnets are
#simply a list of subnets in those particular areas/buildings/locations.
$locations_subnets_file = "$LPRng_root_dir/info/locations_subnets";
#OPTIONAL: pathname of file with Web-Servers in them and the subnets they
#correspond to ... this is REALLY nifty when setup! ;-)
#Tells the users about web servers that are networkically closer to 'em ...
#Probably more complexity than needed, but it's is neat!
#Syntax is <keyword> <subnet(s)>
#keyword should match what is in the locations_file above, and subnets are
#simply a list of subnets in those particular areas/buildings/locations.
#$webservers_subnets_file = "$LPRng_root_dir/info/webservers_subnets";
$default_web_server = "http://localhost/LPRng/";
$default_web_server_location = "Demo";
#---- Everything from here on out is for "Admin Stuff" ----
#You first need to set admin stuff so the button appears on lpinfo
$adminstuff = 1;
#Pathname of where lpinfo (admin) is found (this is just a link up)
$thisURLadmin = "/LPRng/admin/cgi-bin/lpinfo";
#Directory where periodic "lpq all" reports are issued
#Pls see the checkq program
$lpq_all_dir = "/usr/local/lprng/lpinfo";
#Location of file with misc. mis-configuration information
$misconfigured = "/usr/local/lprng/lpinfo/misconfigured";
#Filename that contains list of LPRng print servers
#Used to determine if I can show print server status
#Should be LPRng servers, since they understand lpc -P<host> lpd
$lprng_print_servers = "$LPRng_root_dir/info/lprng_print_servers";
#pathname to lprm/lpc scripts ... in a directory protected w/.htaccess
#Only httpd should be able to go into this directory
#BTW, these are only needed if you allow users to remove printjobs via lpinfo
$lprmURL = "$lpinfo_web_dir/cgi-bin/lpinfo_lprm";
$lprmURLadmin = "$lpinfo_web_dir/admin/cgi-bin/lpinfo_lprm";
$lprm_suid = "$lpinfo_root_dir/admin/cgi-bin/lpinfo_lprm_suid";
$lpc_suid = "$lpinfo_root_dir/admin/cgi-bin/lpinfo_lpc_suid";
#pathname to script that generates lpq output from an NT box
#this is because the NT LPD process truncates the IP address
#when queried via lpq, so this script does an rsh (or whatever you want)
$lpq_nt = "$lpinfo_root_dir/admin/cgi-bin/lpinfo_lpq_nt";
#Counter for number of times admin mode activated - see comments above on count_file{1,2}
$count_file0 = "$lpinfo_root_dir/counters/lpinfo-0";
#If you have Tektronix (or other printers that support direct Web Interface)
#then specify the pathname to a file that contains the regular expressions
#that identifies these ... when in admin mode, you will see a direct link to it.
$printers_with_web = "$LPRng_root_dir/info/printers_with_web";
#Just to make sure that the "require" get true returned
1;

101
root/usr/local/lprng/info/lpinfo_help.html Normal file
View File

@@ -0,0 +1,101 @@
<H2><strong><center>lpinfo Help</center></strong><hr></H2>
<b>lpinfo is a Web-Based tool that allows provides useful functionality
to both Users & Admins to monitor printer stuff.
</b>
<br>
<b><P>Information about <a href="/LPRng/LPRng_local_help.html">misc. Unix command line printing command options</a> and <a href="/LPRng/PRF_local_help.html">information about prf.</a></b>
<br>Sorry, no on-line documentation is available yet for NT stuff.
<P>Please <a href="mailto:trouble@SOMEDOMAIN">send email to trouble</a> if you have any questions or problems about UNIX printing or lpinfo itself.
<br><br><br><br>
<H2>*** Top Frame ***</H2>
<P>There are three frames that are displayed. The top one is displayed
when you start up and has the following options:
<UL>
<LI>Help Button: Click here shows this page - surprise! ;-)
<BR><BR>
<LI>Power User: Click here to see some additional functions (covered below).
<BR><BR>
<LI>Admin Mode: See comments below in Admin Section ...
<BR><BR>
<LI>Show Button: Click here to show the selected printers in the middle frame.
<BR><BR>
<LI>Select box: Click here to show printers in the selected building.
</UL>
<P>Note: the middle frame at startup has misc. lpinfo information. The numbers on the far right are the lpinfo version, and then number of times that admin mode has been activated, number of times lpinfo has been started, and total number of times lpinfo has been asked to do something (ex: queue status).
<br><br><br><br>
<H2>*** Middle Frame ***</H2>
After clicking on `Show', a list of printer names/description/aliases is
displayed here. Clicking on the printer name will generate a queue status in
the bottom frame. Clicking on the printer description will generate a more
complete (if available) listing of information about it in the bottom frame.
<br><br><br><br>
<H2>*** Bottom Frame ***</H2>
<P>When the queue status is displayed here, you will also see:
<UL>
<LI>Check queue status every 5 seconds button: When clicked, this will
continuousely re-generate that bottom frame every 5 seconds with an
updated queue status until you click on the `Stop' button.
<BR><BR>
<LI>More (Less) Queue Info button: You can click on this to display
more (or less) information about the queue status.
<BR><BR>
<LI>Print Test Page: This does what it suggests ... sends a test page
to that printer and then it will auto-display the queue status for
you until you hit the `Stop' button.
</UL>
<br><br>
<H2>*** Power User ***</H2>
<P>As mentioned above, clicking on Power User provides additional functions.
<UL>
<LI>You can specify an optional override substring, and only those printers
with that case-insensitive string will be displayed. Note that Perl regular expressions
can also be used. And if you specify something here, then the building location selection will be ignored.
<BR><BR>
<LI>There are three radio buttons that influence the output of the middle frame
when you click on the Show button. `List only' is the same as what is shown in
`Normal User' mode which simply lists the printer name/description/aliases
and this is quite fast (even with a 1,000 printers! ;-)
`queue status' will actually do an `lpq -s' of every requested printer and display
the results. This can take a little bit of time if a lot of printers are requested.
`Active/Broke queues' is similar to `queue status' ... but only displays those
printers that are either active or broke (i.e. non-green condition). This is useful for seeing `interesting stuff'
<BR><BR>
<LI>Click on the Admin Stuff button to display a list of admin functions in
the middle frame - discussed below.
<BR><BR>
<LI>Click on `Normal User' to go back to the original display
</UL>
<br><br>
<H2>*** Admin Stuff ***</H2>
<P>This is mostly stuff of interest to admins, and the following is currently there:
<UL>
<LI>Admin Mode: Clicking here will prompt you for a username/password;
and assuming you are in the lprngadm group (controlled via the .htaccess file in the LPRng httpd directory), a new window will pop up that looks the same;
except a flashing red `admin mode on' will be present. This allows you to
remove any print job from any LPRng print server.
<BR><BR>
<LI>LPRng Technical Info: Brings up the heavy duty LPRng technical info! ;-)<BR><BR>
<LI>Printing Info/Standards: Shows info on printing procedures/standards.
<BR><BR>
<LI>Check LPRng Print Servers: Checks the health of the LPRng print servers.
<BR><BR>
<LI>Show Active/Broke Queues: Will display a file that is autogenerated every hour
showing all queues that are either active or broke. Quite helpful for looking to see what may need some Sysadmin attention.
<BR><BR>
<LI>Mis-configured NT Queues: Shows a comparison of plotter.data to a dump of the NT Print Registry.
</UL>

1
root/usr/local/lprng/info/lprng_print_servers Normal file
View File

@@ -0,0 +1 @@
firewall

4
root/usr/local/lprng/info/printers_with_web Normal file
View File

@@ -0,0 +1,4 @@
-340$
-350$
-450$
-550$

2
root/usr/local/lprng/info/webservers_subnets Normal file
View File

@@ -0,0 +1,2 @@
POLEN 192.168.51
Deutschalnd 192.168.100

0
root/usr/local/lprng/lpinfo/current Normal file
View File

0
root/usr/local/lprng/lpinfo/output Normal file
View File