home *** CD-ROM | disk | FTP | other *** search
/ Magazyn Amiga 12 / MA_Cover_12.iso / internet / ftp4all / doc / ftp4all.faq next >
Encoding:
Text File  |  1999-03-07  |  17.9 KB  |  342 lines
  1. v.7, 990307
  2.         
  3. FTP4ALL - FAQ
  4.  
  5.    Frequently Asked Questions
  6.    by the FTP4ALL development team
  7.  
  8.    Q: What is FTP4ALL ?
  9.    A: FTP4ALL is a ftp daemon for unix systems. It runs under any normal
  10.    user account and doesn't require any special rights to start. It has
  11.    its own permission and user handling, and is mainly independent from
  12.    the operating system it runs under (although it inherits any
  13.    limitations of the user account under whcih it is running).
  14.  
  15.    Q: Why should I use FTP4ALL, if there is <any ftp daemon> ?
  16.    A: First, every other ftp daemon I know needs special privileges to
  17.    run it. Then, there are system-integrated daemons which are used to
  18.    access your shell accounts with the FTP protocol. FTP4ALL is
  19.    different: you can generally run FTP4ALL from any account, without
  20.    root access, with no power hit as compared with other advanced
  21.    ftpdaemons.
  22.  
  23.    Q: Why shouldn't I use FTP4ALL ?
  24.    A: If you're looking for a wu-ftpd type of daemon, which allows for
  25.    such things as individual home directories, then FTP4ALL is not
  26.    (currently) for you. Different ftp daemons are suited to different
  27.    tasks, and you might wish to consider a daemon such as proftpd if your
  28.    requirements are for tasks such as www-hosting. Generally, FTP4ALL is
  29.    suited for any task that is not "system-integrated", by which we mean
  30.    that FTP4ALL does not lend itself to allowing access by multiple users
  31.    to system shell accounts.
  32.  
  33.    Q: Mhhh... sounds like a great deal, what does it cost ?
  34.    A: FTP4ALL is distributed under the GPL, and is free if you don't use
  35.    it commercially. Please read and understand the conditions of this
  36.    licence.
  37.  
  38.    Q: Are there any FTP4ALL related limitations ?
  39.    A: No, just the normal limitations that applies for user accounts
  40.    under your unix environment. The only possible limitations I can think
  41.    of are disk quota limitation and limitations if you want to bind a
  42.    daemon to ports below 1024.
  43.  
  44.    Q: I found/got this neat file - where can I get the latest version of
  45.    FTP4ALL ?
  46.    A: [1]http://www.ftp4all.de/ and [2]ftp://ftp.ftp4all.de/pub/ftp4all/.
  47.  
  48.    Q: Are there any beta versions ? How could I become a beta tester ?
  49.    A: All the latest beta versions are available from the ftp site. Take
  50.    a look at the [3]ftp://ftp.ftp4all.de/pub/ftp4all/beta/ directory.
  51.  
  52.    Q: Tell me about the FTP4ALL concept.
  53.    A: What you've read so far will already have given you a good
  54.    indication as to the f4a concept, and you can always find more
  55.    information on the FTP4ALL webpage. To sum it up in one sentence:
  56.    FTP4ALL provides a solid and stable ftp daemon that allows full
  57.    configuration and a means for developing powerful "addons" to
  58.    supplement the power of the daemon.
  59.  
  60.    Q: Now, how do I install FTP4ALL ?
  61.    A: First, get the latest distribution archive from our website. Then
  62.    unpack it (tar -xfvz ftpd-2.xx.tar.gz), and run the configure
  63.    (./configure) script. It asks you one question (read the next question
  64.    ahead), which you have to answer. If this is your first time
  65.    installing FTP4ALL just answer "no" to this question.
  66.    Then run make (just type make). It SHOULD compile without any error
  67.    messages and store the binaries in the binary directory (./bin/).
  68.    Inside this directory are example ftpd.conf, users and groups files.
  69.    Now you can edit the ftpd.conf file (see
  70.    [4]http://www.ftp4all.de/config.html), and then run the "ftpd" binary.
  71.  
  72.    Q: What should I do on the first login ?
  73.    A: The first thing you should to is to set a new root password using
  74.    the [5]SITE PASS command. You should also assign an owner to the root
  75.    directory by using the [6]SITE CHOWN command. Next you should assign
  76.    permissions to the root directory using the [7]SITE CHMOD command.
  77.    After verifying the result using the [8]SITE MOD command you may also
  78.    want to update the default permissions for newly created files and
  79.    directories, do so with the [9]umaskuser configuration option. And
  80.    also you may want to set up the basic directory structure, to ease
  81.    this set the umaskroot option in the configuration file before
  82.    creating directories. Next you may want to check out additional
  83.    options on the FTP4ALL homepage. Yes, it does sound a little complex,
  84.    but before long all this will become second nature to you. :)
  85.  
  86.    Q: What is the "want DES encryption (y/n) ?" thing good for ?
  87.    A: FTP4ALL has the ability to encrypt the users and groups file on
  88.    your shell account, to protect it from hackers or curious system
  89.    administrators. It is also sometimes used to hide the ftp4all daemon -
  90.    to do this, you should rename the groups and users file and then use
  91.    encryption. Do not mix DES user/group file encryption and DES password
  92.    hashin in your userfile. For further information refer to
  93.    [10]http://www.ftp4all.de/config.html#userkey.
  94.  
  95.    Q: Why can't I upload any files with long filenames ?
  96.    Q: What is this "edit variable MAXFILENAMELENGTH in src/tweak.h now"
  97.    thing ?
  98.    A: As I said before, FTP4ALL uses its own permission system. The
  99.    permissions are stored in permission files, usualy named ".perm". This
  100.    file is created by the daemon in any directory to which ftp4all has
  101.    write access. It contains a list with the names and permissions of
  102.    each file in the directory. The filename field in this file is limited
  103.    by the MAXFILENAMELENGTH variable. So, if you want to have files with
  104.    filenames of more than 32 characters (default), you should edit this
  105.    constant before typing "make".
  106.  
  107.    Q: So, how do I make these .perm files ?
  108.    A: You don't. The daemon will do it for you, whenever you use the
  109.    [11]SITE CHMOD command, or according to the defaults set in the
  110.    configuration file. You should read and understand all the information
  111.    related to the [12]configuration file for a detailed explanation of
  112.    how the permissions system works.
  113.  
  114.    Q: Is there a port of FTP4ALL for the ... operating system ?
  115.    A: Probably not. ;)
  116.    It should compile on nearly all unix systems, at least with only minor
  117.    modifications. There is currently no Windows-32bit version, but if you
  118.    are a skilled programmer and would like to create one, please contact
  119.    us. An Amiga version of ftp4all is also available; refer to our
  120.    webpage for the address.
  121.  
  122.    Q: I'd like to port FTP4ALL to the ... operating system.. May I ?
  123.    A: Great ! :) Just get in touch with us. But if you want to port it
  124.    you should work on your own (or contact us before if you need help)
  125.    and stay in the FTP4ALL "boundaries" :)
  126.    Q: I've already ported FTP4ALL to the ... operating system !
  127.    A: Even more great ! :), Please drop us a line at
  128.    [13]ftp4all@ftp4all.de and let us know details (Operating system, URL,
  129.    version, differences).
  130.  
  131.    Q: How can I contribute to the FTP4ALL project ?
  132.    A: If you are experienced in writting clean ANSI-C code for unix
  133.    operating systems and willing to contribute, please contact us as soon
  134.    as possible :) Especially people with platform-related knowledge would
  135.    help us to make FTP4ALL more compatible and easier to port.
  136.    However, any new features would also be considered for inclusion
  137.    within the FTP4ALL project so long as the c code you write is of high
  138.    quality. We don't want people who like to put everything into the
  139.    daemon (zipchecker, site give, nuke, ...).
  140.    If you cannot write C, but you want to do something else, contact us,
  141.    too, for example if you can write in another language, you can write a
  142.    configuration system or keep track of the documents, or write a better
  143.    FAQ :)
  144.  
  145.    Q: Why isn't there a zipchecker/unfoline setting/<insert script>
  146.    included in the ftp4all setup ?
  147.    A: It is at odds with the FTP4ALL concept to include everything
  148.    imaginable into the daemon. Unlike some other daemons, FTP4ALL allows
  149.    the siteop instead to implement external scripts for functionality
  150.    such as zip checking, user statistics, and so forth. A collection of
  151.    these scripts can be found at [14]http://www.ftp4all.de/addons/.
  152.  
  153.    Q: I'd like to write my own addons. How should I start ?
  154.    A: Addons can be written in any language you please. You might wish to
  155.    take a look at existing addons (see above) before beginning work on
  156.    your own scripts. Popular languages for addons include C, Perl, and
  157.    simple shellscript.
  158.  
  159.    Q: Why is so much of the FTP4ALL syntax so different from glftpd /
  160.    rftpd / gftpd / <insert daemon name here> ?
  161.    A: FTP4ALL's syntax is designed for power, simplicity and consistency,
  162.    and we feel that it provides the most logical means for controlling a
  163.    site and its users. However, if you don't like it, write your own !
  164.    Because FTP4ALL provides sophisticated scripting functionality, it is
  165.    a simple process to override any internal scripts with your own, that
  166.    work as you would like them to. For a simple example of such
  167.    "overriding", take a look at Overhead's "adduser" script at
  168.    [15]http://www.ftp4all.de/addons/adduser.
  169.  
  170.    Q: How do I set a new password and what can I use as password ?
  171.    A: You can set your password using the SITE PASSWD command (refer to
  172.    [16]http://www.ftp4all.de/sitecmds.html#passwd). As normal user you
  173.    can only set your password, as superuser and users with the "edituser"
  174.    flag you can set the password for any user, and as groupop you can set
  175.    the password for all users of your primary group. You can use any type
  176.    of password you can use as shell password - normaly an alphanumeric
  177.    string which may additionaly contain a few special characters. (do a
  178.    man passwd on your unix shell).
  179.    When changing the password using the SITE PASSWD you may experience
  180.    problems if your ftp client filters or processes such special
  181.    characters. Then try changing it using another ftp client or if you
  182.    are experienced with the FTP protocol you may want to login using
  183.    telnet and change it then.
  184.    FTP4ALL uses the DES encryption routine to hash your passwords,
  185.    meaning that a zero-string (a 56 bit string containing only zeros) is
  186.    encrypted with your password. Then if you enter your password this
  187.    encrypted string is decrypted with your password, and if the cleartext
  188.    is again a zero string your password was correct.
  189.    Plans are to implement better hash routine for FTP4ALL, which makes it
  190.    more secure and working the same way on all unix systems (MD5 or
  191.    SHA-1).
  192.  
  193.    Q: What's with these weird ratios ? limits ?
  194.    A: For historical reasons, and also for maximum configurability,
  195.    FTP4ALL represents limits as a percentage, rather than as a ratio.
  196.    That is, if you want a user to have a 1:3 ratio (they need to upload
  197.    one megabyte to download 3 megabytess) then they have to upload 33% of
  198.    whatever they want to download, so their limit is 33. If you want a
  199.    user to get twice as many megabytess downloads for whatever they
  200.    upload, their limit should be 50. If you want them to be on a 1:5
  201.    ratio, set the limit to 20. See, it's simple. You can also compute it
  202.    using a simple formula: If the ratio is a:b then the limit is (a *
  203.    100) / b. Example: Ratio 2:3 will become (2 * 100) / 3 = 66.
  204.  
  205.    Q: What's this stuff I see about templates ?
  206.    A: Templates simply provide a simple way for you to add users to your
  207.    system. Any user can be used as a template, and by doing "site user
  208.    add <newuser> <existinguser>" it is possible to create a new user that
  209.    will inherit all of the characteristics of the old user. Also, users
  210.    can be explicitly set to be template users - see
  211.    [17]http://www.ftp4all.de/sitecmds.html#user for further information.
  212.  
  213.    Q: I do a "site chmod", but it doesn't change the permissions of the
  214.    files. Likewise, "site chown" doesn't seem to have any effect.
  215.    A: First, check that you have the syntax right. Assuming that you do,
  216.    this is probably caused by problems with permissions at the shell
  217.    level. For example, you might be running your daemon as a user that
  218.    does not have sufficient permissions to write the .perm file into the
  219.    file directories. Check the permissions, chown if necessary from your
  220.    shell, and try again; all should be fixed.
  221.  
  222.    Q: I can't use FTP4ALL with my CD-ROM drive ? I think it's because of
  223.    this permission files, because it displays nobody as owner, and I
  224.    cannot access it. How to fix it ?
  225.    Q: I am dumb and cannot write .perm files to my CD-ROM !!!
  226.    A: FTP4ALL has it's own permissions, and yes it doesn't know how to
  227.    handle a directory which misses the permission file. However, there is
  228.    a special option to mount directories read only into the directory
  229.    tree, called the cdpath-option, which is set in the configuration
  230.    file.
  231.    More information: [18]http://www.ftp4all.de/config.html#cdpath.
  232.  
  233.    Q: F4A was working fine, but all of a sudden nobody can login anymore
  234.    (even though occasionally logins will succeed and everything works
  235.    fine then)
  236.    A: Check the groups-file. At least in 2.23 and 2.24 this might occur
  237.    when the groups file is empty (i.e. it has only the comment line and
  238.    states that there are 0 groups). If this is the case, try to recover
  239.    the entries (e.g. by just typing them in - see docs for format) and
  240.    try to login again. Everything should work fine again.
  241.  
  242.    Q: Everytime I change the configuration file I have to shutdown the
  243.    site to update information. Is this normal ?
  244.    A: Yes. One way to update the information is to shutdown the site
  245.    ([19]SITE SHUTDOWN recommended) and restart it. If you want to update
  246.    information while your site is running you may wish to use the SITE
  247.    RECONFIG command.
  248.    (more information [20]http://www.ftp4all.de/sitecmds.html#reconfig)
  249.  
  250.    Q: When I try to start the daemon, it just outputs one line and then
  251.    quits out, and I can't ftp in to the selected port. Any ideas ?
  252.    A: Generally (read: almost always) this is caused by an error in the
  253.    configuration file. Look for a file called "ftpd.err", and read what's
  254.    in there. In 90% of cases there will be a simple problem that is easy
  255.    to fix.
  256.  
  257.    Q: I think I've found a bug, what should I do about it ?
  258.    A: Please be sure to check all other questions in this FAQ, and the
  259.    webpage, also be sure you've installed the newest version, since the
  260.    FTP4ALL team works continuously to fix bugs. If you know about it,
  261.    chances are that we do too...
  262.    If you still think it's a bug email us as soon as possible with a
  263.    detailed description of your system, your site, your ftpd
  264.    configuration options, the programs running on the system, when the
  265.    bug appears, and most importantly, how to reproduce the bug.
  266.    Please don't harrass us to get bugs fixed- we are only human and get
  267.    no money for our work on the daemon -- but we do what we can. If you
  268.    are familar with FTP4ALL, and you have a suggestion how to fix the bug
  269.    that you're encountering, please do include any suggestions.
  270.    The second thing to do is to set the environment-variable "f4a_deb"
  271.    (no specific value) and send the ftp4all-debug and the core-file (if
  272.    one has been created) to us.
  273.  
  274.    Q: I want to be able to have lots of people log in with the same user
  275.    name and have different credits maintained for each different login
  276.    (based upon the IP of the connection). Can I do that ?
  277.    A: Not yet. FTP4ALL has not been designed for "mp3/mp3" type accounts,
  278.    and this functionality is not directly implemented at this time.
  279.    However, support of this nature is being worked on currently (possibly
  280.    through external scripts). Check back regularly at our page for
  281.    further information.
  282.  
  283.    Q: I wrote a nice addon and I want to publish it... but how ?
  284.    A: Please package the addon with a short description and email it to
  285.    the address below. We will contact you to let you know whether it has
  286.    been accepted into the addon section. It might be possible for you to
  287.    upload the file to us, but do please contact us by mail or IRC
  288.    beforehand.
  289.  
  290.    Q: Why don't you include this or that or fix that stupid bug earlier ?
  291.    A: Suggestions are allowed, and we have a internal "wish-list". But
  292.    please don't bug us to program a particular feature for you. We are
  293.    currently a team of 4 people (two programmers, two supporters), mostly
  294.    students and we are not paid for this work. And our ToDo-list is quite
  295.    full all the time.
  296.    If you can't wait for the next stable version you can always download
  297.    betas of ftp4all ([21]ftp://ftp.ftp4all.de/pub/ftp4all/beta).
  298.  
  299.    Q: I want to keep an up-to-date mirror of your FTP4ALL page. May I ?
  300.    A: If you would like to, please do so, but the discussion section
  301.    should remain on our main site (www.ftp4all.de). Once your mirror is
  302.    up, please [22]email us, so we can add it to our page.
  303.  
  304.    Q: How do I contact the FTP4ALL development team ?
  305.    A: You can reach us via email, [23]ftp4all@ftp4all.de
  306.    You can reach us via our webbbs, which is often the most effective way
  307.    to get help, often within a hour or less,
  308.    [24]http://www.ftp4all.de/cgi-bin/f4a.cgi
  309.    You can reach us via irc, efnet..: #ftp4all (contact one of the ops)
  310.  
  311.    Before contacting us for help, please read the all the important parts
  312.    of the webpage.
  313.    If you email us, you may get more than one answer, from different
  314.    developers.
  315.  
  316. References
  317.  
  318.    1. http://www.ftp4all.de/
  319.    2. ftp://ftp.ftp4all.de/pub/ftp4all/
  320.    3. ftp://ftp.ftp4all.de/pub/ftp4all/beta/
  321.    4. http://www.ftp4all.de/config.html
  322.    5. http://www.ftp4all.de/sitecmds.html#pass
  323.    6. http://www.ftp4all.de/sitecmds.html#chown
  324.    7. http://www.ftp4all.de/sitecmds.html#chmod
  325.    8. http://www.ftp4all.de/sitecmds.html#mod
  326.    9. http://www.ftp4all.de/config.html#umaskuser
  327.   10. http://www.ftp4all.de/config.html#userkey
  328.   11. http://www.ftp4all.de/sitecmds.html#chmod
  329.   12. http://www.ftp4all.de/config.html
  330.   13. mailto:ftp4all@ftp4all.de
  331.   14. http://www.ftp4all.de/addons/
  332.   15. http://www.ftp4all.de/addons/adduser
  333.   16. http://www.ftp4all.de/sitecmds.html#passwd
  334.   17. http://www.ftp4all.de/sitecmds.html#user
  335.   18. http://www.ftp4all.de/config.html#cdpath
  336.   19. http://www.ftp4all.de/sitecmds.html#shutdown
  337.   20. http://www.ftp4all.de/sitecmds.html#reconfig
  338.   21. ftp://ftp.ftp4all.de/pub/ftp4all/beta/
  339.   22. mailto:ftp4all@ftp4all.de
  340.   23. mailto:ftp4all@ftp4all.de
  341.   24. http://www.ftp4all.de/cgi-bin/f4a.cgi
  342.