@DATABASE "ftpd-guide"
@INDEX Index
@NODE "main"

OrangeFTPd v0.8

   @{"Introduction" LINK "intro"} - Why, damnit, why ?
   @{"License" LINK "license"}      - Blah blah.
   @{"Disclaimer" LINK "disclaimer"}   - More blah blah.
   @{"Installation" LINK "install"} - Read this.
   @{"Usage" LINK "usage"}        - And this.
   @{"Security" LINK "security"}     - File permissions and stuff
   @{"FAQ" LINK "faq"}          - FAQ.
   @{"History" LINK "history"}      - What happened ?
   @{"Future" LINK "future"}       - What's gonna happen ?
   @{"Bugs" LINK "bugs" }         - Haha, just must be kidding!
   @{"Author" LINK "author"}       - Me!
   @{"Thanks" LINK "thanks"}       - Greetings.


@ENDNODE

@NODE "intro"

I have for a long time needed a good, fast, free FTPd, but until now, there
haven't been any.

@ENDNODE

@NODE "license"

This piece of software is freeware and will be released under the GPL as
soon as I get the source cleaned up.

@ENDNODE

@NODE "disclaimer"

This piece of software will delete your harddrive, destroy your monitor,
kill your cat, get you fired from your job and ruin your life. You have
been warned!

@ENDNODE

@NODE "install"

Well, copy the executable to somewhere suitable. 

@ENDNODE

@NODE "usage"

Add some users to Miami or AmiTCP or whatever you are running as your
TCP/IP stack. Then add those users to a group named ftp.

When you are done configuring your users, simply start the ftpd.

Switches:
-nogui            Disables the GUI

@ENDNODE

@NODE "security"

File security

File permissions are set by the normal AmigaDOS command "protect".
If you don't know how to use protect, here is the short version:

protect file [flags]

Where [flags] should be R, W, D or a combination of those. R for read, W for
write and D for delete. Easy :)

New files created inherits the parent directory's permissions.



General security

No weird buffer overflows exploits exists. Or at least i hope so ;)
I use no fixed-size arrays or such stupid things.

@ENDNODE

@NODE "faq"

Q: It doesn't work. Why?
A: Dunno, you tell @{"me" LINK "author"}.

Q: Where did you get that silly name from?
A: Probably one of my mushroom-trips.

@ENDNODE

@NODE "history"

v1.0 - public release.

   o Changed a lot of weird UNIX calls into dos.library calls
   o Other things I changed while I was low on sleep.

v0.9 - beta.

   o Process communication.
   o More intelligent processstopping.
   o Timeout

V0.8 - beta.

   o Compatible with the Miami SDK.
   o Fixed a bug in the SIZE command.
   o Fixed a bug where ObtainSocket would fail if 1 was returned, should
     have been -1.
   o CWD to ".." now work.
   o Opus Magellan problem fixed.

V0.7 - beta.

   o Bugfixes.
   o GUI.


V0.6 - Internal.

   o Nothing I remember(or is worth remembering).


V0.5 - First beta release.

   o Everything

@ENDNODE

@NODE "future"

Got an idea of how to improve the FTPd? Mail @{"me" LINK "author"} NOW!

   o Better response texts, customizeable.
   o Improve "LIST", implement "NLST"
   o Implement the "ABOR" command.
   o Make it runnable from inetd.
   o GUI (In progress)
   o Async I/O
   o ... (Insert your wish here)

@ENDNODE

@NODE "bugs"

If you find a bug, then please mail @{"me" LINK "author"} a full description of how to reproduce it.
Also include system info, TCP/IP stack used, version numbers, etc.

Known bugs:

   o Not all of RFC 959 is implemented.
   o "LIST" output is somewhat broken
   o Sometimes the FTP subprocess crashes when a connection is made.
     Please tell me if you know why, or can reproduce it reliably.

@ENDNODE

@NODE "author"

Mark Olsen
bigfoot@private.dk

Find me on IRCNet #AmigaDK or #Amiga as "bigfoot"

@ENDNODE

@NODE "thanks"

AC^rbs, AmiTrax, XPoint, ppl.

@ENDNODE