Wsh 1.3.2

Wsh (web shell) - remote unix/win shell, that works via HTTP.
This package contains two perl scripts for server and client
hosts: wsh-c.pl - client, wsh-s.pl - server. wsh-c.pl is
for console usage and wsh-s.pl runs as CGI script on the
target host.

FEATURES

+ command line history support (*)
+ file upload/download
+ protect server part script usage with secret key in
  HTTP message
+ data flow Xor encoding
+ can work trough HTTP proxy server (to hide client ip
  or bypass firewall)

  (*) - next packages are required:
  1) readline-4.2a.tar.gz or later from
     http://www.gnu.org/directory/readline.html
  2) ReadLine-Gnu-1.12.tar.gz or later from
     http://search.cpan.org/search?dist=Term-ReadLine-Gnu


HOW IT WORKS

+----------+        +------------+        +-------------------+
| CLIENT   |<-HTTP->| http proxy |<-HTTP->| WEB SERVER        |
| wsh-c.pl |        | (optional) |        | /cgi-bin/wsh-s.pl |
+----------+        +------------+        +-------------------+
Host "A"            Host "B"              Host "C"

wsh-c.pl provides shell-like prompt, encapsulating user
commands into HTTP post requests and sending them to the
wsh-s.pl script on target web server directly or via HTTP
proxy server. wsh-s.pl extracts and executes commands from
HTTP post requests and returns STDOUT and STDERR output as
HTTP response message. By default both scripts encode HTTP
data with Xor.

CONFIGURATION

1. Check path to perl in wsh-c.pl and config.pl files;
2. Run config.pl
3. Edit wsh-c.conf file if you want to use HTTP proxy;
4. Put wsh-s.pl under target host cgi-bin directory and
   check path to perl in wsh-s.pl;

USAGE

sh# ./wsh-c.pl targethost.com/cgi-bin/wsh-s.pl <Key>
<Key> is the default KEY, if you do not change it in
config.pl		

wsh commands:
  exit          as is
  history       show commands history
  !<number>     execute command with history <number>
  wshget <file> get <file> from remote host to local directory
  wshput <file> put <file> from local directory to remote host
  lect <lecter:> change to lecter on Win32 (ex: "lect d:")

AUTHOR

Alex Dyatlov <alex@gray-world.net>
http://gray-world.net
Bug reports and new feature requests are welcome

THANKS

Simon Castro <scastro@entreelibre.com> - for WIN environment
				 	 support addon
