TurboIRC FileServer

TurboIRC File Server is a great tool that allows a user to view or download files from your system.You can create user accounts so to prevent users to get anything ; They will get only what they are allowed to .

Starting FileServer .

Start the file server with /fserv nick ( or /dcc nick fserv if you need to enter a timeout , e.g. /dcc nick fserv 10000 ) . TurboIRC starts the DCC Session with the user .

Configuring FileServer .

FileServ uses FSERV.INI in your TurboIRC directory . There should be a "General" section in this file , with the following preferences :

• MaxUsers : Maximum number of users online , 10 is assumed if no entry .
• Logging : It should be 1 if the sessions should be logged .
• Display : If this is on , TurboIRC will not write the text to the FileServ DCC window .
• WelcomeMessage : The message that would be printed in welcome . You can start it with ? to take the message from a file .
• SignoffMessage : The message that would be printed when the user terminates . You can start it with ? to take the message from a file .
• IPMaskDeny : A Set of IP masks that would be denied entrance to the server , like 243.* or 142.32.3.*

You can edit this section using the Preferences Dialog Box as well .

For each user account you must create a section with the user account name , e.g. [rikk] . This section can have one or more of the following fields :

• Password : The password that the user should use . If you don't have a password supplied , TurboIRC will accept the connection without password . You can create a special [Anonymous] account to manage anonymous connections .
• HomeDirectory : The user's home directory , i.e. the directory from which TurboIRC will start the session . If this is off , TurboIRC starts from C:\ .
• TimeOut : The seconds that must pass until the session with the user must be terminated , if the user is idling . If there is no value , TurboIRC will assume 60 seconds .
• DisableReason : A string describing why the user account is disabled . If you don't have a string , TurboIRC assumes that the account is enabled
• AlwaysAllow : If it is 1 , user will be allowed to login even if the server is full , or even if its IP is banned from the server .
• MaxLogins : Maximum same-time logins of the user allowed , 1 is assumed if no entry
• Ratio : The numbers that will show what is the ratio of the user . It is a part of 3 numbers , e.g. . 1 5 0 . The 1 and 5 indicates that for each one unit uploaded , the user can download 5 units . The 0 indicates that we count files per session . 1 means , we count files per user , 2 is we count bytes per session , and 3 means , we count bytes per user . For example , if it is 1 2 1 , then the user can download 2 files for each one he/she uploads , for all the sessions he/she would login .
• Quota : The maximum number of items that the user it allowed to upload or download . It is a part of 4 numbers , e.g. 5 0 2 0 . The first two describe the upload quota , the next two describe the download quota . If the second of the two numbers is 0 , we count files per session , 1 -> files per user , 2 -> bytes per session , 3 -> bytes per user . 5 0 2 0  means : the user can upload up to 5 files within this session , and he can download up to 2 files within this session . 
• Access : This is a space-separated strings that describe to which directories of your system the user will have access . First comes the directory , then a number describing the access . E.g. C:\DN\ 1 C:\DN\B\ 3 . The flags are :

1 : All Permissions are applied to subdirectories as well
2 : User can get a file from the directory
4 : User can send a file to the directory
8 : User can list the files from the directory
16 : User can execute a file from the directory
32 : User can delete a file from the directory
64 : User can make a directory inside the directory
128 : User can remove a directory from the directory
256 : User can copy a file to another directory
512 : User can move a file to another directory

Warning : Using the file server incorrectly can harm your computer . Giving more than usual access to a user enables him/her to destroy your whole file system ! Always give write/delete access to people you trust ,  and keep only read access for most of the users .

Use always a backslash when declaring directories .

For example , to allow a user to get , list and send files to a directory , you will make the restriction flag = 2+4+8 = 14 . To enable the subdirectories for that , make it 15 ( 14 + 1 ).

You can place a dirinfo.srv to a directory to be shown as a message when the user switches to that directory .

FileServer commands

Once the user logs in , TurboIRC FileServ recognizes these commands :

1. dir [mask] : gets current directory list , you can e.g. dir *.exe
2. get <file> : gets file
3. send <file> : sends file
4. cd <dir> : changes directory
5. md <dir> : makes directory
6. rd <dir> : removes directory
7. exec <file> [parameters] : executes a program .
8. dele <file> : deletes a file .
9. copy <src> <dest> : Copies a file to a directory . The user must have read access to the source directory , and write access to the target directory . If the file exists , it is not overwritten .
10. move <src> <dest> : The same like copy , but the original file is removed . The user must have read and delete permission to the source directory , and write permission to the target directory .
11. syst : Shows TurboIRC capabilities .
12. stat : Shows current FileServer statistics
13. mode 0 | 1 : Allows users to change the send mode . By default , TurboIRC will send the files using SEND , which is compatible with all clients . If the client is TurboIRC , PIRCH , vIRC or any other TSEND-compatible client , you can use MODE 1 , to switch to TSEND mode . This will make file transfers much faster .
14. help : shows help messages
15. quit or exit or bye : terminates session