home *** CD-ROM | disk | FTP | other *** search
/ Dream 57 / Amiga_Dream_57.iso / Linux / Net / drall.txt < prev    next >
Text File  |  1998-10-19  |  10KB  |  323 lines
  1. Drall
  2. Copyright (C) 1997-1998 Henrik Edlund <henrik@edlund.org>
  3.  
  4. This program is free software; you can redistribute it and/or modify
  5. it under the terms of the GNU General Public License as published by
  6. the Free Software Foundation; either version 2 of the License, or
  7. (at your option) any later version.
  8.  
  9. This program is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12. GNU General Public License for more details.
  13.  
  14. You should have received a copy of the GNU General Public License
  15. along with this program; if not, write to the Free Software
  16. Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
  17.  
  18. * TABLE OF CONTENTS
  19.  
  20.   o INTRODUCTION
  21.   o REQUIREMENTS
  22.   o INSTALLATION
  23.   o CONFIGURATION
  24.   o USAGE
  25.   o BUGS
  26.   o TODO
  27.   o AUTHORS
  28.   o HISTORY
  29.  
  30. * INTRODUCTION
  31.  
  32.   Drall is a script which allows users to access their directories and 
  33.   files remotely without the need of using insecure ftp and telnet. It
  34.   enables the user to treat the remote file system as if it was on their
  35.   local hard disk trough a normal web browser. The interface resembles the
  36.   well known Norton Commander (of DOS fame) and Midnight Commander (of
  37.   UNIX fame). Drall relies on the server's HTTP authentication and SSL for 
  38.   security. Dual-frame interface makes it easy to overlook file system and
  39.   the modular design means you only use the features you need. Written in
  40.   Perl for easy customization and expansion.
  41.  
  42. * REQUIREMENTS
  43.  
  44.   o Server side
  45.  
  46.     - Required
  47.  
  48.       . Web server supporting the Common Gateway Interface (CGI).
  49.       . Perl 5 or later.
  50.  
  51.     - Recommended
  52.  
  53.       . Web server supporting Secure Socket Layer (SSL) for secure data 
  54.         transfers.
  55.       . Web server supporting HTTP Authentication for user/password
  56.         verification.
  57.  
  58.   o Client side
  59.  
  60.     - Required
  61.  
  62.       . Web browser supporting HTML 2 or later.
  63.       . Web browser supporting multipart/form-data encoding type for forms.
  64.       . Web browser supporting frames (in upcoming versions this will not 
  65.         be required).
  66.  
  67.     - Recommended
  68.  
  69.       . Web browser supporting HTML 4 or later.
  70.       . Web browser supporting Secure Socket Layer (SSL) for secure data 
  71.         transfers.
  72.       . Web browser supporting HTTP Authentication for user/password
  73.         verification.
  74.  
  75.  
  76. * INSTALLATION
  77.  
  78.   (Under Construction)
  79.  
  80. * CONFIGURATION
  81.  
  82.   o Multiconfiguration
  83.  
  84.     Enabled by setting the config_multi variable in the configuration
  85.     section of the script and adding the parameter of ';config=name' to 
  86.     the drall.pl URL. More details in the script configuration section.
  87.  
  88.   (Under Construction)
  89.  
  90. * USAGE
  91.  
  92.   (Under Construction)
  93.  
  94. * BUGS
  95.  
  96.   o Not a real bug, but on certain calls we must do a double un-escaping. 
  97.     The cause of this must be found and the double un-escaping removed.
  98.  
  99. * TODO
  100.  
  101.   o Fix the known bugs.
  102.   o Add dynamic (configurable) directory sorting.
  103.   o Add date column.
  104.   o Add plug-in support.
  105.   o Add edit function.
  106.   o Add copy function.
  107.   o Add rename function.
  108.   o Remove "frames" requirement.
  109.  
  110. * AUTHORS
  111.  
  112.   This section is formatted like the Linux CREDITS file.
  113.   The fields are: name (N), e-mail (E), web-address (W), PGP KeyID and 
  114.   fingerprint, description (D) and snail-mail address (S).
  115.  
  116.   N: Henrik Edlund
  117.   E: henrik@edlund.org
  118.   W: http://www.edlund.org/
  119.   P: 0x467BB8B5   4917 77B7 8717 52BC 6E25  7410 CC60 7C02 467B B8B5
  120.   D: Design
  121.   D: Programming
  122.   D: Coordination
  123.  
  124.   N: Tom Rathborne
  125.   E: tomr@uunet.ca
  126.   W: http://www.net/~tomr/
  127.   D: Ideas
  128.   D: Code contributions
  129.   D: Code review
  130.   D: Beta testing
  131.  
  132.   N: Richard Roth
  133.   E: rich@on-the-net.com
  134.   W: http://www.east.on-the-net.com
  135.   P: 0x5F05C1AF   DE D2 C3 42 7F F3 BF 76  5B 8C 08 47 CB 9F 6B BD
  136.   D: Ideas
  137.   D: Code contributions
  138.   D: Beta testing
  139.   D: Moral support
  140.  
  141.   N: Tammy Nelson
  142.   E: tammy@tammy.org
  143.   W: http://www.tammy.org/
  144.   D: Inspiration
  145.   D: Ideas
  146.   D: Beta testing
  147.  
  148. * HISTORY
  149.  
  150.   o 0.7.0  20 October 1998
  151.  
  152.     - Added move function. Will not work across file system boundaries.
  153.     - Fixed the internal variable usage for directory exchange.
  154.     - Added Ms. Tammy Nelson to the authors section in the README.
  155.  
  156.   o 0.6.2 (3rd packaging)  9 September 1998
  157.  
  158.     - Rewrote all dates to a better format in the README.
  159.  
  160.   o 0.6.2 (2nd packaging)  12 August 1998
  161.  
  162.     - The only_true_web_server_retrieval variable had been left on its
  163.       non-default value of 0. Reset it to 1.
  164.  
  165.   o 0.6.2  11 August 1998
  166.  
  167.     - Beta release 14.
  168.     - Provides a preliminary fix for a symbolic link security bug. The 
  169.       script will now disregard any symbolic link that contains ".." and
  170.       check others to see that they really are below the base directory.
  171.       Note that this is a quick fix and will be rewritten when time is
  172.       available. Symbolic links are still vulnerable in this release,
  173.       somewhat less than earlier though.
  174.     - Changed the default rights mode for files and directories to safer 
  175.       values.
  176.     - Optimized the get_directory function by handling file by file and
  177.       not filling an array with all files first of all. Thanks goes to Tom
  178.       Rathborne <tomr@uunet.ca> for providing a patch for this.
  179.     - Minor bugfixes.
  180.     - Minor additions.
  181.  
  182.   o 0.6.1 (2nd packaging)  10 August 1998
  183.  
  184.     - The only_true_web_server_retrieval variable had been left on its
  185.       non-default value of 0. Reset it to 1.
  186.  
  187.   o 0.6.1  10 August 1998
  188.  
  189.     - Beta release 13.
  190.     - Fixed a bug in the get_directory subfunction. The script would
  191.       report the wrong size of your files. A typo. Thanks goes to Tom
  192.       Rathborne <tomr@uunet.ca> for reporting this.
  193.  
  194.   o 0.6.0  9 August 1998
  195.  
  196.     - Beta release 12.
  197.     - Rewrote internal representation of the file system.
  198.     - Added support for recursive deleting.
  199.     - Added ability to enable or disable each function and the recursive
  200.       deleting in the configuration.
  201.     - Renamed config variable "base_directory" to "base_dir".
  202.     - Further spelling corrected.
  203.     - Minor bugfixes.
  204.  
  205.   o 0.5.4 (6th packaging)  7 August 1998
  206.  
  207.     - Had missed to rewrite some dates in the README.
  208.  
  209.   o 0.5.4 (5th packaging)  4 August 1998
  210.  
  211.     - Updated REQUIREMENTS in README.
  212.  
  213.   o 0.5.4 (4th packaging)  3 August 1998
  214.  
  215.     - Updated address to Free Software Foundation in README. Was already
  216.       done in COPYING and drall.pl.
  217.  
  218.   o 0.5.4 (3rd packaging)  2 August 1998
  219.  
  220.     - Added entry to HISTORY about the renaming of the application.
  221.  
  222.   o 0.5.4 (2nd packaging)  2 August 1998
  223.  
  224.     - Rewrote all dates to another format in the README.
  225.  
  226.   o 0.5.4  29 July 1998
  227.  
  228.     - Beta release 11.
  229.     - Further spelling corrected.
  230.     - Application renamed to Drall.
  231.  
  232.   o 0.5.3  20 July 1998
  233.  
  234.     - Beta release 10.
  235.     - Made sure all "webserver" became "web server" and all "webbrowser"
  236.       became "web browser" in all source and documentation.
  237.     - Renamed config variable "only_true_webserver_retrieval" to 
  238.       "only_true_web_server_retrieval".
  239.  
  240.   o 0.5.2  24 June 1998
  241.  
  242.     - Beta release 9.
  243.     - Refixed the bug in the multipart parser. The previous fix was 
  244.       faulty.
  245.  
  246.   o 0.5.1 (2nd packaging)  24 June 1998
  247.  
  248.     - New file tree. All documentation available directly in README file.
  249.     - Fixed typo in the example external config "1234.drall.pl".
  250.     - Distribution now also available as compressed and zip'd archive
  251.       instead of only gzip'd.
  252.  
  253.   o 0.5.1  17 June 1998
  254.  
  255.     - Beta release 8.
  256.     - Fixed a bug in the multipart parser which added an empty line first 
  257.       in all uploaded files.
  258.  
  259.   o 0.5.0 (5th packaging)  15 June 1998
  260.  
  261.     - Removed the cgiwrap.c program from the distribution because it could 
  262.       be exploited and therefor is a security risk. There already exist 
  263.       other CGI wrappers that are secure. Have a look at them.
  264.  
  265.   o 0.5.0 (4th packaging)  15 June 1998
  266.  
  267.     - Fixed a major security error in the instruction in cgiwrap.c on how 
  268.       to set up the CGI wrapper.
  269.  
  270.   o 0.5.0 (3rd packaging)  15 June 1998
  271.  
  272.     - Added a CGI wrapper program called cgiwrap.c to the distribution.
  273.  
  274.   o 0.5.0 (2nd packaging)  14 June 1998
  275.  
  276.     - The only_true_web_server_retrieval variable had been left on its 
  277.       non-default value of 0. Reset it to 1.
  278.  
  279.   o 0.5.0  14 June 1998
  280.  
  281.     - Beta release 7.
  282.     - Fixed multipart parsing function to be generic.
  283.     - Configuration now stored in an associative array.
  284.     - Added multiconfiguration support.
  285.  
  286.   o 0.4.0  2 June 1998
  287.  
  288.     - Beta release 6.
  289.     - Added overwrite option during upload.
  290.     - Minor bugfixes.
  291.  
  292.   o 0.3.0  17 May 1998
  293.  
  294.     - Beta release 5.
  295.     - Added static directory sorting.
  296.     - Small bugfixes in the retrieval of environment variables.
  297.  
  298.   o 0.2.0  13 March 1998
  299.  
  300.     - Beta release 4.
  301.     - Added language support.
  302.     - Minor other changes.
  303.  
  304.   o 0.1.2  9 February 1998
  305.  
  306.     - Beta release 3.
  307.     - Added audio/midi MIME-type.
  308.  
  309.   o 0.1.1  16 January 1998
  310.    
  311.     - Beta release 2.
  312.     - Fixes the problem with non-alphanumerical characters in file and 
  313.       directory names by introducing URI escaping.
  314.     - Introduces the need to do a double un-escaping on certain calls,
  315.       which should not be needed, and this problem must be solved to a
  316.       later release.
  317.  
  318.   o 0.1.0  14 January 1998
  319.     - Beta release 1.
  320.  
  321.   o 0.0.0  22 November 1997
  322.     - Project started.
  323.