readme

本文件为Web-FTP的实现源代码 是cgi编程 使用perl为主 本软件适用于linux下

Web-FTP Version 2.2.1

Web-FTP only works on systems with fork(), i.e. not Windows or
Macintosh. Sorry.

Web-FTP is an http based ftp portal which allows you to provide
secure web-based file management through ftp using SSL or can be
used as an ftp client. Client use is particularly helpful for 
be able to ftp through an http only firewall.

Tom Stepleton started this project and I, Anthony Ball 
<[e-mail]> have picked up the torch as of early 2000. 
Any questions/comments/complaints/requests should be relayed to
me. The official web page for Web-FTP can be found at 
http://www.Web-FTP.org/. The Project is hosted by 
http://www.sourceforge.net and has online forums and a mailing
list. You may subscribe to the mailing list here:
http://lists.sourceforge.net/mailman/listinfo/web-ftp-general
There will also be a link from the home page. The preferred
way to get help and basically anything else is the mailing list.

I always appreciate feedback, either to the mailing list or 
directly to myself. A note on how things are going and what
you are using Web-FTP for is always interesting. Also, I am
in no way too proud to accept gifts :) Bribing me to add 
functionality will almost always work :) Heck, if the bribe 
is big enough I'll even start a whole new open source project.
<G>

If anyone is looking for someone to do perl projects I can always
use extra money, and am available for contracting. Pretty much any 
perl project on Unix :) 

  				Enjoy! - Ant

TODO

* Complete rewrite

BUGS

* Certain browsers have odd bugs, hard to fix them all

CHANGES IN VERSION 2.2.1

* Real portuguese, spanish, dutch, and traditional chinese, mappings from users

* Fixed bug connecting to microsoft servers

* Fixed link bug on faillogin page in hard refresh

* Fixed templates, haven't worked since subdirs were added

CHANGES IN VERSION 2.2.0

* Made many translations, the French one is the only real translation
  thanks to Luc Santeramo. Anyone wanting to improve translations edit the
  map file, test it, and send it to me. Or even make new ones.

* Added drop down language selection

* Unfixed the tagging bug from 2.1.2, cuz it caused worse problems...

* Added language support

* Moved things to webftp subdir

CHANGES IN VERSION 2.1.2

* Fixed a bug in the ls where web-ftp wasn't reading my debian ftp server
  output properly

* Fixed a bug where trying to download by tagging twice in the same dir 
  prevent certain versions of MSIE from working without a refresh

CHANGES IN VERSION 2.1.1

* Stupid little bug that made winzip not like directory entries, breaking
  recursive directory downloads for windows users... grrr

CHANGES IN VERSION 2.1.0

* Made Tag a link that inverts the selected files/directories

* Fixed bad bug in the C that prevented binary files from working right

* Added multiple/recursive downloads via tar files, very cool

CHANGES IN VERSION 2.0.1

* Fixed a bug that prevents older versions of netscape and maybe
  other browsers from being able to log in... oops 

* Made pages non-caching, Opera seems to need this to work properly

CHANGES IN VERSION 2.0.0

* No more cookies, I didn't want to support both ways, and this works just
  as well

* C program for accessing session... should allow Web-FTP fto run faster
  and eat less system resources.. yay! Experimental, let me know if there
  are problems please!

* No more problems uploading large files! Yay!

* Added support for Net::Gnift, so when I finish writing it you will
  be able to seamlessly integrate SSH transfers as well as FTP

* changed contact link yto go to a web page :)

CHANGES IN VERSION 1.5.2

* Now works with Netscape Server! Changed redirects to be full path
  and make check for https with env variable https = on
  Much thanks to Ellen Davis for testing and helping root out this
  annoying bug
		
CHANGES IN VERSION 1.5.1

* Fixed a bug with redirects popping you out of https back to http
  Fixed a bug that gave uploaded file full client path name... oops.
  Added ability to have a drop down list of sites. Added a SITE button
  to allow you to run SITE commands. Added more Upload fields to the 
  upload page.

CHANGES IN VERSION 1.5.0

* Lots of changes, done over a period of time. I expect bugs, so don't
  use this to replace anything critical, though it seems to work. I
  Will appreciate bug reports. New Features: Experimental Crypto card
  access. I am not at all sure if this will work for people other than
  The ones I wrote it in for, but if you try and it fails, I will see
  what I can do. Changes to the editor to make it more robust and warn you
  that you are not able to write to a file. And a Save As option. A chdir
  field. A window for viewing FTP server messages and errors. I may not
  get them all, but this has been needed. Ability for users to log in
  without having cookies on. 

CHANGES IN VERSION 1.3.3

* Fix a problem with the simplified permissions editor. It didn't
  work with directories. Oops

CHANGES IN VERSION 1.3.2

* Uploads were not taking you back to the MAIN screen. Made Editor 
  take focus when it opened.

CHANGES IN VERSION 1.3.1

* Excellent change. Now users may download a file in the background and
  continue to browse or even download multiple files at once. A very
  good thing. Also the HidePermButton option in the conf now turns off
  the permissions link as well... simply showing the permissions. 
  Woohoo! Thanks to Graham Barr for helping me with a Net::FTP 
  question. Also fixed a bug with the new permissions in HideOctal

CHANGES IN VERSION 1.3.0

* Crazy! Added a file viewer and simple text editor. Added javascript
  to opening screen to allow quicker logins. Added a simplified way
  of editing permissions. Added a refresh link. Fixed a bug that broke
  login on hostnames without two . in them. Fixed a bug with FTP servers
  that don't send . and .. which caused things to display wrong. Fixed
  a bug that made Web-FTP buffer the file before it was sent to the user,
  this was a major issue in downloading large files. There were some
  other things, but I think this covers the major ones. Enjoy.

CHANGES IN VERSION 1.1.3

* Fixed it so that symlinks to directories show up as directories.
  However, if you have a symlink that points to a file of size 0,
  it will show up as a directory, till I find a better way to do it.
  I consider it an acceptable sacrifice, since empty files aren't
  really useful for download, anyway.

CHANGES IN VERSION 1.1.2

* I left out a stupid " so Parent Directory didn't work... GRR

CHANGES IN VERSION 1.1.1

* Made redirects relative so https would work! (Hopefully this will
  work everywhere)

CHANGES IN VERSION 1.1.0

* BIG CHANGE! Web-FTP is now completely cgi driven. It still starts
  It's own mini-server to handle individual clients, but instead it
  uses a unix socket and the user connects to this through a cgi
  removing the need for SSL support in Web-FTP, YAY! Now any secure
  server that you set Web-FTP up on will handle the SSL piece. This
  Also solves the problem of allowing people to connect to other
  ports on your server, or through a proxy. Excellent! I expect bugs
  though :) And I am sure there is room for improvement. 
  Have fun.

* Added a Parent Directory link

* Added color Alternation to file and dir listings
 
* Added message and redirect for timeouts and errors.

* Made links to directories show up in directory window (this
  may or may not work with all ftp servers)

* Chnaged the name of SelectiveHTTPD.pm to MiniServer.pm since
  it is no longer really an httpd server.

CHANGES IN VERSION 0.94b

* Added the ability to specify a port range that Web-FTP will use
  so web-ftp may be set up on a server on a firewall if the ports
  are allowed.

CHANGES IN VERSION 0.93b

* Fixed a bug that broke files with spaces and strange characters.

CHANGES IN VERSION 0.92b

* Made Web-ftp more customizable. You can change colors, what
  fields show, and what buttons show, useful for dumbing down
  the interface or just changing the look a little. Also added
  timeout to the conf file so you can set the user timeout yourself.

CHANGES IN VERSION 0.91b

* Fixed MSIE download bug, unfortunately this disables multiple
  file download capability (not that you didn't have to click Ok
  for every file in order anyway)

* Fixed bug with some browsers (esp. MSIE) that prevented the
  redirect due to an unclosed connection through STDOUT.
  Thanks to Shawn Asmussen for helping with that one.

CHANGES IN VERSION 0.91a

* Fixed QUIT button to replace entire window when clicked, not
  just a frame.

* Got rid of some pesky warnings being thrown.

CHANGES IN VERSION 0.9alpha

* New Maintainer: Anthony Ball has picked up development of web-ftp

* New Look: Web-FTP has an entirely new interface nothing like the
previous version. Columns line up and frames (I know, I know) are 
used to improve useablility.

* New Web site... www.web-ftp.org

* Added web-ftp.conf file so users would not have to edit script.

* changed web-ftp.pl to web-ftp.cgi

* Added host input to login for connecting to remote hosts.

* Other things I may remember later