##################################################################
# filebrowser.cgi
#
# perl CGI script to browse through a file system on a webserver
# 
# features:
# - show filename, type, size, modification date, permissions
# - download files
# - upload files
# - change file permissions
# - delete files
# - rename files
# - create different users with different access policies
# - auto-extract ZIP files
# - limit browsing to a specific directory subtree
#
# Written 2004 by Jakob Magiera, jakob@magiera.net
# 
##################################################################

A Word of Caution:

Web servers that are not sufficiently protected can be 
damaged by inappropriate use of this script. 
The author can and does not assume responsibility for misuse
of this script such as modifying or deleting files or directories.

INSTALLATION:

Copy all files to a CGI directory on your webserver.
If you are using FTP, use ASCII transfer mode for everything.
Make sure the CGI process has write access to that directory 
(typically chmod 757 does it, but this may vary).
Make sure the script file (filebrowser.cgi) is executable (chmod 755).

Open the script URL, e. g. http://www.example.com/cgi-bin/filebrowser.cgi
If you get any errors of missing packages, you must install them. 
Look for them at http://search.cpan.org

When the script runs, just follow the instructions.

All user data will be stored in a file called .htfilebrowser.config.
The package Tie::Persistent will also create copies of it.
I strongly advise to protect these files from access from the web. 
The passwords are encrypted, but nonetheless the files should not be readable with a webbrowser.
If you use apache, the files are read protected because their names
start with ".ht". Also, because of their location in a CGI directory, they may be read protected, 
but you should definitely confirm that.




