@database ftpd.guide @version $VER: ftpd.guide 2.0 (12.3.2000) ©2000 Robin Cloutman @node MAIN "FTPd.guide" @{b}RC-FTPd 2.x Guide - Table of Contents@{ub} @{b}-------------------------------------@{ub} Welcome to @{i}rc-ftpd@{ui}, the best AmigaOS FTP server. Hopefully this manual will help you get the most of this program, if you have any problems understanding it, or how to do things within the program itself do not hesitate to email me and I'll try to improve it in future. Please also read the @{i}ftpd.readme@{ui} included within this archive as it often contains important information. @{" About RC-FTPd " Link ABOU} What is this program all about? @{" Requirements " Link REQU} What is needed to run RC-FTPd? @{" Editing Users " Link USER} How do I edit users? @{" Editing Groups " Link GROU} How do I edit groups? @{" Editing Welcome " Link WELC} What about the Welcome message? @{" Editing Goodbye " Link GOOD} What about the Goodbye message? @{" ARexx " Link AREX} The AREXX port (registered) @{" Contact " Link CONT} How can I contact the coder? @{" Registration " Link REGI} How do I register? @{i}This guide is a work in progress and will have a lot added...@{ui} @endnode @node ABOU "FTPd.guide/About RC-FTPd" @{b}What is this program all about?@{ub} @{b}-------------------------------@{ub} FTP stands for @{i}File Transfer Protocol@{ui}. Basically it is a way for users to access files on your hard drive, but with your permission only. ;-) This program originally came about because of the lack of decent ftp servers on the amiga, on the one hand you had difficult to configure unix convertions, and on the other you had unsupported and somewhat lacking (also norally unstable) amiga based clients (that often seem to contain a lot of unix code ;-P) I decided to write my own after hearing the thousandth complaint about the competition. This is entirely written from scratch, with no code taken from any other program on the amiga or any other platform. @endnode @node REQU "FTPd.guide/Requirements" @{b}What is needed to run RC-FTPd?@{ub} @{b}------------------------------@{ub} Hardware -------- Should be able to run on practically any Amiga computer. Software -------- Workbench 2.1 or later. MUI 3.8 or later. NList.mcc Lamp.mcc Textinput.mcc Miami (tested) or any other TCP/IP stack (untested ;-) 2 megabytes of RAM (more recommended) @endnode @node USER "FTPd.guide/Editing Users" @{b}How do I edit users?@{ub} @{b}--------------------@{ub} The first 16 columns are the groups this user has access to, doubleclick on them to toggle On/Off. Next comees the USERname and PASSword, both used during the login process. If you leave the password blank then the user is treated as being anonymous and doesn't need a password to login (although they are still asked for one). In order to Remove a user you need to clear the Username, and to use a random password you need to clear the password. You can also set the Maximum number of people allowed to use this account at one time. (the small buttons are ±1) Finally you can set the log level once they have finished logging on. @endnode @node GROU "FTPd.guide/Editing Groups" @{b}How do I edit groups?@{ub} @{b}---------------------@{ub} The first 16 columns indicate what access this path provides, whether it is Read, Write or Delete (r for read, w for write, x for read/write and uppercase for delete) Different groups can get different Read/Write/Delete/+(subdir) access to the same path. The + (with other flags they go bold) means you can access all subdirs for that path providing they don't have their own access. Display - r = R R = RD @{b}r@{ub} = R+ @{b}R@{ub} = RD+ w = W W = WD @{b}w@{ub} = W+ @{b}W@{ub} = WD+ x = RW X = RWD @{b}x@{ub} = RW+ @{b}X@{ub} = RWD+ + = S D = D @{b}D@{ub} = D+ The next two are the alias and the path. It is recommecnded that you do not end the alias with a "/" character, although this should make no real difference. If an alias has no path then it will make a list from the aliases under it. This currently means you cannot have any file aliases. @{b}Styles of ftp access@{ub} @{b}--------------------@{ub} There are 2 styles of ftp access, my preference is the un*x style, where all aliases start with /, and you also have a root dir of just "/", the benefit of this is that you can have files in your root path. (Please note that you have to have "/" as he default path on the General page) Example - / Internet:FTP /MP3 Work:Music/MP3 /Upload Internet:Upload The other style is disk style, where you don't have a root (/) alias, and none of the aliases start with that character, instead you have the aliases setup as fake disks (ie. you have them all with the ":" character in them). As this doesn't have a real root dir you *must* add every dir manually. Example - Games: Internet:FTP/Games Quake: Internet:FTP/Quake MP3: Work:Music/MP3 Upload: Internet:Upload @endnode @node WELC "FTPd.guide/Editing Welcome" @{b}What about the Welcome message?@{ub} @{b}-------------------------------@{ub} The Welcome message is displayed whenever someone logs onto the ftp. It has a few limits (like any message) in that you cannot send a blank line or a line starting with a number (the program will silently add a "." to the beginning of both). It is advisable to keep your welcome short if you are getting a large number of users as it bypasses the cps limiter. You should also try to keep the the message lines as short as possible, some clients try to display the replies in rediculous amounts of screen space and it is nice to be read (<50 chars should be ok). @endnode @node GOOD "FTPd.guide/Editing Goodbye" @{b}What about the Goodbye message?@{ub} @{b}-------------------------------@{ub} The Goodbye message is displayed whenever someone quits from the ftp. It has a few limits (like any message) in that you cannot send a blank line or a line starting with a number (the program will silently add a "." to the beginning of both). As the message is displayed only after someone QUITs you should probably keep this as short as possible (or not have one) as most clients will close down and the user will not be able to read it. You should also try to keep the the message lines as short as possible, some clients try to display the replies in rediculous amounts of screen space and it is nice to be read (<50 chars should be ok). @endnode @node AREX "FTPd.guide/ARexx" @{b}The AREXX port@{ub} @{b}--------------@{ub} The AREXX port is only available in the registered version. A quick note, there are 3 types of @{i}handle@{ui}, FTP, USER and ACCESS. The program checks that the handle you supply is valid, so you cannot cause a crash or anything by using the wrong type, however you will also not get a result. use the corrent type of handle for each command and you should have no problems. Results can be either a string <""> or a number <>. AREXX commands - @{b}VERSION@{ub} RESULT = . @{b}FTP QUERY ALL@{ub} RESULT = [ ...] @{b}FTP QUERY ALL STEM stem@{ub} stem.COUNT = stem.0 = ... stem.total = @{b}FTP QUERY @{i}handle@{ui} STEM stem@{ub} stem.IP = <"0.0.0.0"> stem.ALIAS = <"alias"> stem.PATH = <"path"> stem.USER = stem.ACCESS = stem.LOG = stem.FILE = <"filename"> stem.CPS = stem.SIZE = stem.CURRENT = @{b}FTP KICK @{i}handle@{ui}@{ub} @{b}FTP ABORT @{i}handle@{ui}@{ub} @{b}FTP LOG @{i}handle@{ui} [1-4]@{ub} RESULT = @{b}FTP MESSAGE @{i}handle@{ui} message@{ub} @{b}USER QUERY ALL@{ub} RESULT = [ ...] @{b}USER QUERY ALL STEM stem@{ub} stem.COUNT = stem.0 = ... stem.total = @{b}USER QUERY @{i}handle@{ui} STEM stem@{ub} stem.NAME = <"name"> stem.PASS = <"pass"> stem.ACCESS = stem.MAX = stem.LOG = @{b}ACCESS QUERY ALL@{ub} RESULT = [ ...] @{b}ACCESS QUERY ALL STEM stem@{ub} stem.COUNT = stem.0 = ... stem.total = @{b}ACCESS QUERY @{i}handle@{ui} STEM stem@{ub} stem.ALIAS = <"alias"> stem.PATH = <"path"> stem.READ = stem.WRITE = stem.DELETE = stem.SUBDIRS = @endnode @node REGI "FTPd.guide/Registration" @{b}What are the unregistered limits?@{ub} @{b}---------------------------------@{ub} Limit of three connections at any time. MaxCPS is always at 3k cps. AREXX interface disabled. Notify disabled. @{b}How do I register?@{ub} @{b}------------------@{ub} Registration costs £20 (UKP), unfortunately registration is by cash/cheque only. (I am trying to find somewhere for web orders...) When you register I will send you a keyfile by snail mail, this keyfile will work for all future releases of RC-FTPd (unlike some other programs) When you register please tell me your Name, Address and Email. Keyfiles will be sent by snail mail only (Because I have limited internet access, and only 1 or 2 times a week!) Your keyfile will be traceable back to you, so do not spread it unless you wish to spend time visiting your local prison... Please make all cheques (or UK postal orders) out to - Robin Cloutman 5, Meadow View Water Eaton Road Summertown Oxford ENGLAND OX2 7QS @endnode @node CONT "FTPd.guide/Contact" @{b}How can I contact the coder?@{ub} @{b}----------------------------@{ub} Either by post (see @{"Registration" link REGI}), Email: Robin Cloutman I @{b}DO NOT@{ub} have internet access right now, so contacting me is only possible once or twice a week! Sorry for this, I hope it'll change soon! ICQ: 13463163 (Rycochet) @endnode