]> i-scream Git - www.i-scream.org.git/blobdiff - cgi-bin/docs.cgi
Add libstatgrab 0.92 release.
[www.i-scream.org.git] / cgi-bin / docs.cgi
index cb6c3d2bbe8dbb9fa83e81024156f0a96e7b5586..91e99f009a74f9c0ac06355cd8924c3256b6e413 100755 (executable)
 #!/usr/bin/perl -w
 
-#------------------------------------------------------------
-# docs.cgi
-# 
-# Web-based text file viewer.
-# Copyright Paul Mutton, 2000.
-#------------------------------------------------------------
-
 use strict;
 use CGI;
 
 $| = 1;
 
 # Settings
-my ($left) = "../left.inc" ;
-my ($title) = "../title.inc";
-my ($bottom) = "../bottom.inc";
+my ($incdir) = "../htdocs";
 
+# Include files
+my ($doctype) = "$incdir/doctype.inc";
+my ($style) = "$incdir/style.inc";
+my ($header) = "$incdir/header.inc";
+my ($footer) = "$incdir/footer.inc";
+my ($menu) = "$incdir/menu-static.inc" ;
 
 my ($query) = new CGI;
-my ($doc) = ($query->param('doc') =~ /^\s*(.*?\.txt)\s*$/);
-$doc = "../documentation/".$doc;
 
+# Note filenames may only have one dot in them, in the ".txt".
+# This prevents malicious users using "../" to view files.
+my ($doc) = ($query->param('doc') =~ /^\s*([^\.]*?\.txt)\s*$/);
+
+# This should be application/xhtml+xml
 print "Content-type: text/html\n\n";
 
-print <<"END";
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
+unless (defined $doc) {
+    print "The link to this page was broken - it must specify a .txt file.";
+    exit;
+}
+
+# Prevent hackers from supplying a malformed document string.
+# I.e. only allow normal characters, slashes and dots.
+unless ($doc =~ /^[a-zA-Z_\-0-9\.\/]+$/) {
+    print "Malformed request.";
+    exit;
+}
+$doc = "../htdocs/cms/documentation/".$doc;
 
-<!--
-    docs.cgi
-    Web-based text file viewer and formatter.
-    Created by pjm2 19/10/2000
-    Last modified 02/11/2000
--->
+my($docname) = $doc =~ /\/([^\/]+)$/;
 
-<html>
+&print_html($doctype);
 
-<head>
- <title>The i-scream Project Documentation Viewer</title>
- <meta name="description" content="The i-scream Project is a central monitoring system for Unix, Linux and NT servers.">
- <meta name="keywords" content="i-scream, project, central monitoring system, unix, linux, nt, server, alert">
- <meta name="generator" content="notepad on acid, aye.">
-</head>
+print <<"END";
+
+  <head>
+    <title>
+      i-scream plain text documentation viewer
+    </title>
+END
 
-<body bgcolor="#ffffff" link="#0000ff" alink="#3333cc" vlink="#3333cc" text="#000066">
+&print_html($style);
 
-<table border="0" cellpadding="2" cellspacing="2">
- <tr>
-  <td valign="top">
+print <<"END";
+
+  </head>
+  <body>
+    <div id="container">
+      <div id="main">
 END
 
-&print_html($left);
+&print_html($header);
 
 print <<"END";
 
-  </td>
-  <td valign="top">
+        <div id="contents">
+          <h1 class="top">
+            i-scream documentation viewer
+          </h1>
+          <h2>
+            $docname
+          </h2>
 END
 
-&print_html($title);
 &print_file($doc);
-&print_html($bottom);
 
 print <<"END";
 
-  </td>
- </tr>
-</table>
+        </div>
+END
+
+&print_html($footer);
+
+print <<"END";
+
+      </div>
+END
+
+&print_html($menu);
 
-</body>
+print <<"END";
 
+    </div>
+  </body>
 </html>
 END
 
 exit 0;
 
 # Print a file, whilst escaping HTML: -
-sub print_file ($) {
-    my ($urls) = '(' . join ('|', qw{
-                       http
-                       telnet
-                       gopher
-                       file
-                       wais
-                       ftp
-                       } )
-                   . ')';
-    
+sub print_file {
+my ($urls) = '(' . join ('|', qw{
+              http
+              telnet
+              gopher
+              file
+              wais
+              ftp
+              } )
+          . ')';
+
     my ($ltrs) = '\w';
     my ($gunk) = '/#~:.?+=&%@!\-';
     my ($punc) = '.:?\-';
     my ($any) = "${ltrs}${gunk}${punc}";
     my ($filename) = @_;
-    open(FILE, $filename) or die "Cannot open $filename: $!\n";
-    print "<pre>\n";
-    # Use $_ implicitly throughout.
-    while (<FILE>) {
-        # Must do the next line first!
-        s/&/&amp;/g;
-        s/</&lt;/g;
-        s/>/&gt;/g;
-        s/"/&quot;/g;
-        s/\b($urls:[$any]+?)(?=[$punc]*[^$any]|$)/<a href="$1">$1<\/a>/igox;
-        print;
+    if(open(FILE, $filename)) {
+        print "          <pre>\n";
+        # Use $_ implicitly throughout.
+        while (<FILE>) {
+            # Must do the next line first!
+            s/&/&amp;/g;
+            s/</&lt;/g;
+            s/>/&gt;/g;
+            s/"/&quot;/g;
+            s/\b($urls:[$any]+?)(?=[$punc]*[^$any]|$)/<a href="$1">$1<\/a>/igox;
+            print;
+        }
+        print "\n</pre>";
+    }
+    else {
+        print "Failed to open $docname.";
     }
-    print "</pre>";
 }
 
-# Print a file without escaping HTML: -
+# Print the contents of a file containing html
 sub print_html ($) {
     my ($filename) = @_;
-    print `cat $filename`;
+    open(FILE, $filename);
+    while(<FILE>) {
+        print;
+    }
+    close FILE;
 }