From 9cd00c94207a9849b6a7654651194cc76cf40f7e Mon Sep 17 00:00:00 2001 From: sgunderson Date: Tue, 25 Jul 2000 23:50:58 +0000 Subject: [PATCH] Documentation re-linebreaking and updating. --- doc/CHANGES | 79 ++++++++++++++++++++++---------------------- doc/CHANGES-0.0.8 | 2 ++ doc/README.platforms | 41 +++++++++++++---------- 3 files changed, 65 insertions(+), 57 deletions(-) diff --git a/doc/CHANGES b/doc/CHANGES index 8057df5..b0f01b7 100644 --- a/doc/CHANGES +++ b/doc/CHANGES @@ -18,61 +18,60 @@ CHANGES-0.0.8. - Fixed a LOT of bugs, some segfaulting, some minor. - MAJOR performance improvements in almost all areas. One of the main contributors in this area has been Dan Kegel (see the CREDITS file). -- Some changes to compile better under Debian GNU/Linux. A .deb-file was - ready, but due to lost access of a Debian-system, this was discontinued :-( -- BetaFTPD will now try to install itself (wow! (not)) in the same directory - as the file called `ftpd', if you have that file. -- Support for non-Linux platforms! For now, only SunOS/SVR4 and FreeBSD. - SunOS just barely works, and FreeBSD lacks sendfile() support. Both are - generally untested. +- Some changes to compile better under Debian GNU/Linux. A .deb-file was ready, + but due to lost access of a Debian-system, this was discontinued :-( +- BetaFTPD will now try to install itself (wow! (not)) in the same directory as + the file called `ftpd', if you have that file. +- Support for non-Linux platforms! For now, only SunOS/SVR4 and FreeBSD. SunOS + just barely works, and FreeBSD lacks sendfile() support. Both are generally + untested. - Gave the version its own name, like Samba does :-) -- If you have mmap(), BetaFTPD will no longer generate temporary files for directory - listings, but generate them in-place in memory. +- If you have mmap(), BetaFTPD will no longer generate temporary files for + directory listings, but generate them in-place in memory. - Completely restructured the internal listing functions, to make them more - standards-compliant and smaller. (-l and -F flags now supported, but not - -R.) + standards-compliant and smaller. (-l and -F flags now supported, but not -R.) - Make an EXIT command (must be manually enabled -- NEVER use it on a - production machine, ANYONE will be able to halt your server!) to stop - the server -- useful for profiling, which requires an exit() to generate - profile data. (Be aware that gmon.out will be where the server last did - a chdir() to, though. In a debugging server, you'll know where that is - anyway...) -- strip-exec now has a warning. In addition, it gives -D__OPTIMIZE_SIZE__ - to keep glibc2 (libc6) from adding some inlines. It also kills - -fomit-frame-pointer. So now strip-exec gives a 20 kB executable instead - of 21 kB (one extra kB goes to new functionality) :-) -- Now strips out any non-ASCII chars from the commands (not any parameters), - to fix the ABOR problems. + production machine, ANYONE will be able to halt your server!) to stop the + server -- useful for profiling, which requires an exit() to generate profile + data. (Be aware that gmon.out will be where the server last did a chdir() to, + though. In a debugging server, you'll know where that is anyway...) +- strip-exec now has a warning. In addition, it gives -D__OPTIMIZE_SIZE__ to + keep glibc2 (libc6) from adding some inlines. It also kills + -fomit-frame-pointer. So now strip-exec gives a 20 kB executable instead of 21 + kB (one extra kB goes to new functionality) :-) +- Now strips out any non-ASCII chars from the commands (not any parameters), to + fix the ABOR problems. - Documentation changes. - Commented all the functions in cmds.c and ftpd.c, to make it easier to get into the code. -- Implemented the APPE, DELE, MKD, RMD, ABOR, REIN, ACCT, HELP and STAT commands. +- Implemented the APPE, DELE, MKD, RMD, ABOR, REIN, ACCT, HELP and STAT + commands. - Added makefile dependencies. - BetaFTPD can now handle non-DES crypt()s, thanks to Beau Kuiper . -- ASCII mode added, once again thanks to Beau Kuiper . -- Linux sendfile() support (only for mmap()-able machines -- I don't think - any machine has sendfile() but not mmap()). Other systems will be added - later. +- ASCII mode added, once again thanks to Beau Kuiper + . +- Linux sendfile() support (only for mmap()-able machines -- I don't think any + machine has sendfile() but not mmap()). Other systems will be added later. - Moved all documentation (except README) into a separate doc/ directory. Added CREDITS file. - The internal ls now can cache the listings (--enable-dcache to configure). - Please see the README file for some problems that still exist. This - option requires quite a bit of code (1028 bytes compiled, on my - system), and some RAM for the directory listings and support structure. - I think, however, that the increased performance is worth it. -- BetaFTPD can now use poll() if you have it. This removes the old 1024- - socket limit, as well as reducing the code size by 496 bytes (on my - system). + Please see the README file for some problems that still exist. This option + requires quite a bit of code (1028 bytes compiled, on my system), and some RAM + for the directory listings and support structure. I think, however, that the + increased performance is worth it. +- BetaFTPD can now use poll() if you have it. This removes the old 1024- socket + limit, as well as reducing the code size by 496 bytes (on my system). - Added renaming support. (Whee! Almost full RFC1123 compliance!) -- Changed all copyright strings to say `1999-2000' (well, it only got to - May 2000 before I remembered it...) instead of just `1999'. -- A new option, --enable-message, makes the server show info about README files, - as well as printing any .message or welcome.msg files that may be available. - (This is a quite standard function in other ftpds.) -- Made a simple FTP server test suite (not included, since it's really not good +- Changed all copyright strings to say `1999-2000' (well, it only got to May + 2000 before I remembered it...) instead of just `1999'. +- A new option, --enable-message, makes the server show info about README + files, as well as printing any .message or welcome.msg files that may be + available. (This is a quite standard function in other ftpds.) +- Made a simple FTP server test suite (not included, since it's really not good enough to live its own life as a standalone product), used in testing. - BetaFTPD now listens on port 21. +- Homepage moved to SourceForge (http://betaftpd.sourceforge.net/)[ Version 0.0.7: - Shadow support. (Give --enable-shadow to configure to enable it.) diff --git a/doc/CHANGES-0.0.8 b/doc/CHANGES-0.0.8 index 4820144..8ca54e3 100644 --- a/doc/CHANGES-0.0.8 +++ b/doc/CHANGES-0.0.8 @@ -209,3 +209,5 @@ Complete list of all changes from 0.0.7 to 0.0.8, encompassing 17 prerelases: per loop iteration). This also reduces the code size by a few bytes. - More improvements to upload code. Data received in an upload now goes to a static buffer (which also has been shrunk) instead of to the stack. +- A fix for poll()-less system. +- Homepage moved to SourceForge (http://betaftpd.sourceforge.net/). diff --git a/doc/README.platforms b/doc/README.platforms index 97ece80..e9f57ff 100644 --- a/doc/README.platforms +++ b/doc/README.platforms @@ -1,5 +1,5 @@ -These are platforms that BetaFTPD is known to run on (`Supported' means -that each new major version will be tested on this platform): +These are platforms that BetaFTPD is known to run on (`Supported' means that +each new major version will be tested on this platform): Linux, libc5 ------------ @@ -8,10 +8,10 @@ Slackware 3.5. Compiles, partly tested. Supported. Linux, libc6 (i*86-pc-linux-gnu) -------------------------------- Slackware 3.4 (upgraded to glibc 2.1) and Debian GNU/Linux 2.1 (glibc 2.0). -Debian is previously tested and known to work well, but since I had to -move the computer away, I can't test it anymore. It should work, though. -Tested and working on Slackware (my main system). Should work fine on most -Linux distributions. +Debian is previously tested and known to work well, but since I had to move the +computer away, I can't test it anymore. It should work, though. Tested and +working on Slackware (my main system). Should work fine on most Linux +distributions. SunOS 5.5 (sparc-sun-solaris2.5.1) ---------------------------------- @@ -22,23 +22,30 @@ FreeBSD Compiles, runs, not very much testing. A user reports that it actually works well. (No sendfile() support, though.) +Windows (cygwin) +---------------- +Well... Compiles, runs (barely), not much testing. Lacks several important +features such as mmap(), not to mention the lack of a proper user system. +Anonymous FTP not tested, only non-anonymous. Nonroot not tested, but a working +nonroot system would probably be cruical to make it work properly. To sum it +up: Get an FTP server made for Windows instead ;-) + In other words, as of today BetaFTPD works properly on Linux ONLY... If you feel an urge to change this, please do step forward and offer to port it. I've got access to both FreeBSD and SunOS-machines (thanks to very friendly people -who've given me shell access), but due to Internet time restrictions and general -lack of time, I really can't take care of all other patforms. +who've given me shell access), but due to Internet time restrictions and +general lack of time, I really can't take care of all other patforms. All others ---------- Totally unknown. If you want to help out, here are some things that will help (in descending order): -1. That you can take responsibility for adjusting each new version of - BetaFTPD to your OS. -2. If #1 isn't possible, just a note that it works (if it works!) or - patches to make the latest version work. (Note that this is now preferred - over #3 -- it wasn't so earlier.) -3. If #2 isn't possible, that I can get (permanent; I'll probably need to - check later versions...) shell access to a computer with that OS. - Optionally, you could always send me a fresh HD with that OS installed :-) - +1. That you can take responsibility for adjusting each new version of BetaFTPD + to your OS. +2. If #1 isn't possible, just a note that it works (if it works!) or patches to + make the latest version work. (Note that this is now preferred over #3 -- it + wasn't so earlier.) +3. If #2 isn't possible, that I can get (permanent; I'll probably need to check + later versions...) shell access to a computer with that OS. Optionally, you + could always send me a fresh HD with that OS installed :-) -- 2.39.2