tftpd DOCUMENTATION
-------------------


INTRODUCTION
------------

This is an early documentation for tftpd the best FTP deamon for OS/2.


tftpd FILES
-----------

The tftpd ZIP contains the following files:

readme.txt    Last minute information
whatsnew.txt  Version history
tftpddoc.txt  This file
tftpd.exe     Terje's FTP Deamon
tftpacct.exe  Account Manager for tftpd

The following files will be created when running "tftpacct":

tftpd.usr     User database
tftpd.grp     Group database
tftpd.sha     Share database
tftpd.mem     User group membership database

The following files will be created when running "tftpd":

tftpduse.log  Default usage log file (AscII file)

These files should ONLY be modified with the use of "tftpacct". Both "tftpd"
and "tftpacct" will look for these files in the current directory only.


SIMPLE TEST CONFIGURATION
-------------------------

First you will have to setup at least one user, one group and one share. The
user also has to be member of a group.

Do the following:

This will make a user with the name "testusr" and the password "testpwd", and
please note what userid it get, that will be needed to add the user to a group.

  tftpacct -au testusr testpwd

This will make a group with the name "testgrp", also note the groupid given.

  tftpacct -ag testgrp

This will make a share for "x:\path" with full access for both user and group.

  tftpacct -as x:/path . rwx--rwx------- 0 0

And finally thiswill add the user with userid 0 to the group with groupid 0.
User can be member in as many groups as wanted.

  tftpacct -am 0 0

Now you should be ready to start the ftpd with the command:

  tftpd -s


tftpd - TERJE'S FTP DEAMON
--------------------------

Usage:
  tftpd {parameters}
    -c[users]                           Max concurrent users (Default = 16)
    -p[port]                            Listen to specified port (Default = 21)
    -s                                  Start deamon


tftpacct - ACCOUNT MANAGER FOR tftp
-----------------------------------

Usage:
  tftpacct [parameters]
    -l[u|g|s]                           List users/groups or shares (u, g or s)
    -lu [username]                      List specific user with statistics
    -au [username] [password]           Add a new user
    -ag [groupname]                     Add a new group
    -as [localpath] [ftppath] [access]  Add a share
          [userid] [groupid]
    -am [groupid] [userid]              Add a user to a group
    -du [userid]                        Delete a user
    -dg [groupid]                       Delete a group
    -ds [shareid]                       Delete a share
    -dm [groupid] [userid]              Remove a user from a group


Possible accesslevels are:
  r = read, w = write, x = execute, v = view only, n = no delete.


CONTACTING THE AUTHOR
---------------------

MAILING LIST
------------

Please use this list for most communication about tftpd.

To subscribe, send a mail to "steward@kalv20.ub.ntnu.no" with the words 
"subscribe merlin" in the body of the message.

To post to the list, send a mail to "merlin@ub.ntnu.no".


DIRECT CONTACT
--------------
eMail: tf@ub.ntnu.no
EFnet: [Frog]       (This is usually me when I'm awake)
       Mr_Frog      (This is online most of the time, latest version of tftpd allways on offer)
