Main
Main
Artwork
Artwork
Books
Books
Donate
Donate
Licenses
Licenses
Shorts
Shorts
Software
Software
Source
Source


NAME

ls.php

SYNOPSIS

http://insanelywittystupidity.com/pub/php/ls.php? [options] [path]
http://insanelywittystupidity.com/pub/php/ls.php?%20[options]%20[path]

DESCRIPTION

ls.php literally runs a GNU/Linux ls command on Insanely Witty Stupidity's server. And, it can be used to write the contents of a path to a web page-- redirecting stdout to a user's web browser. This allows a user to study the contents of Insanely Witty Stupidity. ls.php can be invoked like a normal GNU/Linux ls binary. But, there are some restrictions. Also, ls.php has its own options.

RESTRICTIONS

Semi-colons are not allowed in ls.php requests (making it impossible for a user to run additional commands on the server).

ls.php is also sandboxed-- meaning it is not allowed to run commands on folders above the root of insanelywittystupidity.com (which is "/iws"). This is accomplished by using Insanely Witty Stupidity's GNU/Linux cd command to travel to a path preceding a file name and storing the result of pwd. The result can be compared to Insanely Witty Stupidity's root to determine if a user is requesting data from a folder above the root of the website (and, also folders that are protected by Apache .htpasswd files).

--font_size [int]

The "--font_size" option can be used to change the font size ls.php requests from a user's browser. This can be useful if ls.php's default font size is too big (or too small).

EXAMPLE

Use ls.php to list the contents of Insanely Witty Stupidity's html folder (using "/iws" as preceding path):
http://insanelywittystupidity.com/pub/php/ls.php? /iws/html

Use ls.php to list the contents of Insanely Witty Stupidity's root (using "../.." as preceding path, html codes for URL spaces, font size 8, and a --color option (for GNU/Linux ls)):
http://insanelywittystupidity.com/pub/php/ls.php?%20--font_size%208%20--color%20../..

AUTHOR

Written by Michael Atkins.

REPORTING BUGS

Maintainer Michael Atkins' email: thedictator2@gmail.com

COPYRIGHT

Copyright (c) 2019 and 2020 Michael Atkins. Licensed under conditions of the Honest Scripting License, Version 1 <http://insanelywittystupidity.com/html/Licenses.html>.
ls.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).

SEE ALSO

GNU/Linux ls command manpage (using a man command on a GNU/Linux system)
Back

______________________________________________

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 2025-03-06 by Michael Atkins.

The maintainer of insanelywittystupidity.com does not care if people duplicate this page or any part of it-- as long as this notice remains intact.