--- web/cgi-bin/docs.cgi 2000/10/25 23:56:27 1.1 +++ web/cgi-bin/docs.cgi 2004/03/21 23:59:32 1.7 @@ -1,94 +1,126 @@ #!/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 ($menu) = "../nwww/menu.inc" ; +my ($header) = "../nwww/header.inc"; +my ($footer) = "../nwww/footer.inc"; +my ($style) = "../nwww/style.inc"; - my ($query) = new CGI; -my ($doci) = ($query->param('doc') =~ /^\s*(.*?\.txt)\s*$/); -my ($doc) = "../documentation/$doci"; -print "content-type: text/html\n\n"; +# 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*$/); -print <<"END"; - +print "Content-type: text/html\n\n"; - +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/documentation/".$doc; + +my($docname) = $doc =~ /\/([^\/]+)$/; + +print <<"END"; + + - The i-scream Project Documentation Viewer - - - + i-scream plain text documentation viewer +END + +&print_html($style); + +print <<"END"; - + - - - - - -
+
+ +
END -&print_file($left); +&print_html($header); print <<"END"; +
+

i-scream documentation viewer

-
+

$docname

END -&print_file($title); - -print "
\n";
 &print_file($doc);
-print "
\n"; +print ""; -&print_file($bottom); +&print_html($footer); -print <<"END"; +print ""; -
+&print_html($menu); - +print <<"END"; + + END exit 0; +# Print a file, whilst escaping HTML: - sub print_file ($) { - my ($filename) = @_; - print `cat $filename`; -} +my ($urls) = '(' . join ('|', qw{ + http + telnet + gopher + file + wais + ftp + } ) + . ')'; -sub print_file_old ($) { - my ($filename) = @_; - open(FILE, $filename) or die "Cannot open $filename: $!\n"; - while (my ($line) = ) { - print $line; +my ($ltrs) = '\w'; +my ($gunk) = '/#~:.?+=&%@!\-'; +my ($punc) = '.:?\-'; +my ($any) = "${ltrs}${gunk}${punc}"; +my ($filename) = @_; +if(open(FILE, $filename)) { + print "
\n";
+    # Use $_ implicitly throughout.
+    while () {
+        # Must do the next line first!
+        s/&/&/g;
+        s//>/g;
+        s/"/"/g;
+        s/\b($urls:[$any]+?)(?=[$punc]*[^$any]|$)/$1<\/a>/igox;
+        print;
     }
+    print "
"; } +else { + print "Failed to open $docname."; +} +} +# Print a file without escaping HTML: - +sub print_html ($) { +my ($filename) = @_; +print `cat $filename 2>&1`; +}