home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 13 / amigaformatcd13.iso / -in_the_mag- / internet / amitcp-4.0 / help / ftpd.guide (.txt) < prev    next >
Amigaguide Document  |  1997-03-11  |  11KB  |  251 lines

  1. @database ftpd.guide
  2. @Master ftpd.texinfo
  3. @Width 72
  4. This is the AmigaGuide
  5.  file ftpd.guide, produced by Makeinfo-1.55 from 
  6. the input file ftpd.texinfo.
  7. @Node Main "ftpd.guide"
  8. @Next "COPYRIGHTS"
  9.                               ftpd v1.2
  10.      
  11.                    a ftpd for AmiTCP 3.0b2 or higher
  12.      
  13.                         ported by Magnus Lilja
  14.  @{" COPYRIGHTS " Link "COPYRIGHTS"}                  Copyrights.
  15.  @{" Distribution " Link "Distribution"}                Distribution and status notes.
  16.  @{" Overview " Link "Overview"}                    Why another ftp-daemon for AmiTCP?
  17.  @{" Installation " Link "Installation"}                How to install this thing
  18.  @{" Options " Link "Options"}                     Program options.
  19.  @{" Bugreports " Link "Bugreports"}                  How to reach the author.
  20.  @{" History " Link "History"}                     Version history and 'to do'-list.
  21.  @{" Thanks " Link "Thanks"}                      Thanks goes to..
  22. @EndNode
  23. @Node "COPYRIGHTS" "ftpd.guide/COPYRIGHTS"
  24. @Next "Distribution"
  25. @Prev "Main"
  26. @Toc "Main"
  27. Copyrights
  28. ==========
  29.    This ftpd is ported to AmiTCP using a source that is
  30.      Copyright (c) 1985, 1988, 1990 Regents of the University of California.
  31.      All rights reserved.
  32.      
  33.      Redistribution and use in source and binary forms, with or without
  34.      modification, are permitted provided that the following conditions
  35.      are met:
  36.      1. Redistributions of source code must retain the above copyright
  37.         notice, this list of conditions and the following disclaimer.
  38.      2. Redistributions in binary form must reproduce the above copyright
  39.         notice, this list of conditions and the following disclaimer in the
  40.         documentation and/or other materials provided with the distribution.
  41.      3. All advertising materials mentioning features or use of this software
  42.         must display the following acknowledgement:
  43.          This product includes software developed by the University of
  44.          California, Berkeley and its contributors.
  45.      4. Neither the name of the University nor the names of its contributors
  46.         may be used to endorse or promote products derived from this software
  47.         without specific prior written permission.
  48.      
  49.      THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
  50.      ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  51.      IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  52.      ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
  53.      FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  54.      DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  55.      OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  56.      HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  57.      LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  58.      OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  59.      SUCH DAMAGE.
  60.    AmiTCP version of ftpd is
  61.    Copyright (C) 1994 by Magnus Lilja (lilja@lysator.liu.se)
  62. @EndNode
  63. @Node "Distribution" "ftpd.guide/Distribution"
  64. @Next "Overview"
  65. @Prev "COPYRIGHTS"
  66. @Toc "Main"
  67. Distribution
  68. ============
  69.    This ftpd is Freeware, you may copy and spread it freely as long as
  70. you don't make a profit of it. That means you should only charge for
  71. the actual costs, like disk + p&p.
  72.    The AmiTCP-group has permission to include this package in
  73. AmiTCP-releases.
  74.    The source is not available at the moment, though you can find the
  75. original bsd-source at many ftp-sites. I found it on:
  76.    unix.hensa.ac.uk:/pub/uunet/systems/unix/bsd-sources/libexec/ftpd
  77.    If you would like to support the author you may send postcards,
  78. money, harddisks :), etc to:
  79.      Magnus Lilja
  80.      Alsattersgatan 9C:17
  81.      S-582 51 LINKOPING
  82.      SWEDEN
  83.    or send an email to: lilja@lysator.liu.se
  84. @EndNode
  85. @Node "Overview" "ftpd.guide/Overview"
  86. @Next "Installation"
  87. @Prev "Distribution"
  88. @Toc "Main"
  89. Overview
  90. ========
  91.    Why a new port of ftpd?
  92.    I wasn't happy with the old one, there was no logging option (at
  93. least I didn't find it) and a couple of other things, so I started
  94. porting this one instead.
  95.    This ftpd offers:
  96.    * Log every connection that is made to ftpd (to AmiTCP-log).
  97.    * Log all file-transfers in AmiTCP:log/xferlog
  98.    * Supports all ftp-commands (not everyone has been tested though).
  99.    * You can have a file with usernames that are not allowed to use the
  100.      ftpd.
  101.    * Totally protect some directories from reading/writing even if you
  102.      don't have MuFS installed on them.
  103.    * Options to turn on/off debugging, logging and transferlogging.
  104.    * Supports timeout (ftpd exits if the user has been idle for more
  105.      that <timeout> seconds).
  106.    ftpd needs:
  107.    * AmiTCP 3.0beta2 or higher.
  108.    * and optionally, for better security, MultiUser v39 or higher.
  109.    The protection is not 100%, but hopefully it's enough for your
  110. needs. Note that all ftp-commands are implemented, like removedir
  111. makedir rename etc. An anonymous ftp-user cannot use makedir/removedir
  112. or rename/delete a file.
  113. @EndNode
  114. @Node "Installation" "ftpd.guide/Installation"
  115. @Next "Options"
  116. @Prev "Overview"
  117. @Toc "Main"
  118. Installation
  119. ============
  120.    Installation is very simple:
  121.   1. Copy ftpd to AmiTCP:Serv/
  122.   2. Edit inetd.conf to look something like this:
  123.      ftp       stream      tcp nowait root AmiTCP:Serv/ftpd ftpd -x -b30
  124.      Look in @{"Options" Link "Options"} for information about the different options.
  125.   3. Make sure that every user that should be able to use the ftpd has
  126.      an entry in both AmiTCP:db/passwd and your Multiuser-passwd file.
  127.      The passwords must be the same. This is annoying, I know that, but
  128.      hopefully AmiTCP and MuFS will use the same passwd-crypt algorithm
  129.      in the future.  Important: You cannot just copy the passwd-files
  130.      since MuFS and AmiTCP uses different password-encryption routines
  131.      (at least AmiTCP 3.0b2 and MuFS <1.7). This will hopefully change
  132.      in the future.  Make sure that the user 'ftp' is present in both
  133.      files if you want to allow anonymous ftp logins.
  134.   4. If you want a transfer-log then make sure that everyone can write
  135.      to it (AmiTCP:log/xferlog).
  136.   5. If you want a wtmp-file, like on UNIX, then create the file
  137.      AmiTCP:log/wtmp.
  138.   6. Edit ftpusers and put it in AmiTCP:db/. No user that is listed in
  139.      this file can use the ftpd.
  140.   7. Edit ftpdir and copy it in AmiTCP:db/. Anonymous ftp-users will
  141.      only be able to access directories that are present in this file.
  142.      If you don't create a ftpdir-file anonymous users can access every
  143.      dir on your system.
  144.   8. Make sure that inetd has read the new inetd.conf by sending a
  145.      CTRL-F to it, with 'break x F', where x is the processnumber of
  146.      inetd.
  147.   9. ftpd looks for a list command named 'ls' in your path. The ls
  148.      command should at least support the following flags:
  149.           '-l'    produce long listing.
  150.           '-A'    show all files
  151.      The original AmiTCP:bin/ls handle these options.
  152.    Now you are ready to use the new ftpd!
  153. @EndNode
  154. @Node "Options" "ftpd.guide/Options"
  155. @Next "Bugreports"
  156. @Prev "Installation"
  157. @Toc "Main"
  158. Options
  159. =======
  160.    It's possible to send arguments to ftpd via inetd.conf:
  161. ftp       stream      tcp nowait root dh1:tcp/bsdftpd/ftpd ftpd -x -b30
  162.    These are the options that are recognized by ftpd:
  163.      -d,-v  Turns on debug-mode. A lot of info will show up in AmiTCP-log.
  164.      
  165.      -l     Turns on logging, ftpd will show things like 'user lilja logged
  166.             in from xxxx' in the AmiTCP-log.
  167.      
  168.      -x     Activates file-transfer logging, the log-file is
  169.             AmiTCP:log/xferlog.
  170.      
  171.      -bnnn  Specifies how large buffer ftpd should use when sending/receiving files.
  172.             The buffer will be nnn*512 bytes long. Default is nnn=10. This
  173.             was added in order to speed up file-transfers.
  174.      
  175.      -tnn   Timeout in seconds. ftpd will exit when the user has been idle for
  176.             nn seconds.
  177.      
  178.      -Tnn   Maximum timeout, the timeout setting must be below nn seconds.
  179.      
  180.      -u     Set umask (has no affect on Amiga version yet).
  181.      
  182.      -G     Allow uploads by anonymous users (the default is not to allow anonymous users to upload stuff).
  183. @EndNode
  184. @Node "Bugreports" "ftpd.guide/Bugreports"
  185. @Next "History"
  186. @Prev "Options"
  187. @Toc "Main"
  188. Bugreports
  189. ==========
  190.    If you have any thoughts or suggestions concerning this port of ftpd
  191. then don't hesitate to write me an email, bug-reports are also welcome
  192.    Please send detailed bug-reports, that makes it easier for me to
  193. track the problem.
  194. (email: lilja@lysator.liu.se)
  195. @EndNode
  196. @Node "History" "ftpd.guide/History"
  197. @Next "Thanks"
  198. @Prev "Bugreports"
  199. @Toc "Main"
  200. History
  201. =======
  202.    - Changed internal function of timeouts.
  203. v1.1 released 1994-06-16
  204.    - Implemented timeouts. The ftpd will now exit when the user has
  205.      been idle for <timeout> seconds. You can change the timeout-value
  206.      with the -t option. Default is 900 seconds.
  207.    - 'cd .' 'cd ..' now works.
  208. v1.04 released 1994-06-10
  209.    - Major bug-fix. ftpd could trash your memory-list when you
  210.      put-files with it. Finally I have found the bug and corrected it.
  211. v1.03 released 1994-06-09
  212.    - MAJOR CHANGE: The ftppart file is obsolete. Use the file ftpdir in
  213.      order to define which directories that anonymous ftpusers should
  214.      be _allowed_ access to.
  215.    - Anonymous users cannot remove/rename files/dirs.
  216.    - If you want to allow anonymous uploads you have to use the new 'G'
  217.      option when starting ftpd.
  218.    - SYST now returns AmigaOS, instead of 'UNKNOWN Type: L8'.
  219. v1.02 released 1994-05-29
  220.    - Updated ftpd to use the new startup-code from AmiTCP-3.0b2.
  221.    - Major bug fixed. If you PUT a file and there wasn't enough space
  222.      left on disk ftpd would cause a GURU. This was because I didn't do
  223.      a pr->pr_WindowPtr=-1 when the ftpd was started.
  224.    - The buffer option now also turns on buffers when the ftpd is
  225.      receiving files.
  226.    - mget and ls with wildcards works now. The problem was that in the
  227.      DIR structure the dd_fd field wasn't a filedescription as it
  228.      should be. Shame on you SAS/C!
  229.    - ftpd no longer needs MultiUser but if you want better security
  230.      then I recommend muFS.
  231. v1.0 released 1994-04-30
  232.    - Initial release.
  233. To do:
  234.    Wildcards doesn't work with ls ('ls ami*').
  235. @EndNode
  236. @Node "Thanks" "ftpd.guide/Thanks"
  237. @Prev "History"
  238. @Toc "Main"
  239. Thanks
  240. ======
  241.    Many thanks to:
  242.        AmiTCP-Group            For a great package, and for the help you provided!
  243.      
  244.        SAS/C                   Good compiler, although I want fcntl() and ioctl()
  245.                                functions :)
  246.      
  247.        Andreas Johansson       for help with debugging.
  248.      
  249.        Patrik Lantto           for the port of GNU-ls.
  250. @EndNode
  251.