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: Insanely Witty Stupidity has its own ls command (implemented using PHP). It can be used to poke around Insanely Witty Stupidity's root folder. For more information, rtfm.

html revised 2024-12-20 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.