cat.php literally runs a GNU/Linux cat command on Insanely Witty Stupidity's server. And, it can be used to write the contents of a file to a web page-- redirecting stdout to a user's web browser. This allows a user to study the contents of a file before Insanely Witty Stupidity's Apache server has a chance to filter it with a PHP binary (most likely changing the code and censoring PHP scripting code). cat.php can be invoked like a normal GNU/Linux cat binary. But, there are some restrictions. Also, cat.php has its own options.
Some special characters that are normally used programatically on a GNU system (and other Unix-like systems) are not allowed. These include curly braces (forcing a user to use spaces to cat more than one file), spaces (making it (then) impossible for a user to cat more than one file, set variables, use cat's options (which needs to be improved), etc), and semi-colons (making it impossible for a user to run additional commands on the server). Spaces surrounded by quotes *are* allowed.
cat.php is also sandboxed-- meaning it is not allowed to run commands on folders above the root of insanely
Insanely Witty Stupidity also has an ls.php script. It can be used to study the contents of Insanely Witty Stupidity's root and choose files to print with cat.php. See Insanely Witty Stupidity's ls.php manpage for more details.
The "--font_size" option can be used to change the font size cat.php requests from a user's browser. This can be useful if a user is printing ASCII art from Insanely Witty Stupidity's /pub
Use cat.php to print the contents of Insanely Witty Stupidity's index page (using "/iws" as preceding path):
Use cat.php to print the contents of bikini.txt (an ASCII art file stored in /iws
Written by Michael Atkins.
Maintainer Michael Atkins' email: email@example.com
Copyright (c) 2019 and 2020 Michael Atkins. Licensed under conditions of the Honest Scripting License, Version 1 <http://
cat.php is an honest scripting project. It was crafted by its author(s). But-- it belongs to NO ONE!! Users can copy the project, modify it, and redistribute it. There is NO WARRANTY (to the extent permitted by law).
GNU/Linux cat command manpage (using a man command on a GNU/Linux system)
Insanely Witty Stupidity's ls.php manpage
|Random Fact: Slackware (a GNU/Linux system maintained under an emphasis of function over form) is the official operating system used to host Insanely Witty Stupidity. Many packages are compiled using various Slackware systems for the purpose of developing the site. And, Insanely Witty Stupidity happily shares those precompiled packages with its users (because-- people may find them useful).|
html revised 2021-11-22 by Michael Atkins.
The maintainer of insanely