Wsh 1.2.3

Wsh (web shell) - remote unix/win shell, that works via HTTP.
This package contain 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
+ 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.

INSTALLATION

1) Replace KEY in wsh-s.pl with your own alpha-numeric key (*)
2) Put wsh-s.pl under target host cgi-bin directory
3) Configure wsh-c.conf

* - set $win = 1 if web server runs under WIN environment

USAGE

sh# ./wsh-c.pl targethost.com/cgi-bin/wsh-s.pl <secret_key>
<secret_key> is the KEY by default, if you are not change
it in wsh-s.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>
Bug reports and new feature requests are welcome

THANKS

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