home *** CD-ROM | disk | FTP | other *** search
/ How to Get Online 1996 Spring / HOW2GON.ISO / mac / FTP / TFTPd-100 / Documentation next >
Text File  |  1994-06-20  |  9KB  |  160 lines

  1. TFTPd v1.0.0 © 1994 Peter N Lewis.
  2. This program is $10 Shareware.
  3.  
  4. • Contents
  5.  
  6.       What TFTPd Does
  7.       Features
  8.       Using TFTPd
  9.       Security Considerations
  10.       Limitations
  11.       Small Print
  12.       Warranty
  13.       Fine Print
  14.       Acknowledgements
  15.       How It Works
  16.       Version History
  17.       The Author
  18.  
  19. • What TFTPd Does
  20.  
  21. TFTPd is a Macintosh TFTP (Trivial File Transport Protocol) server for Macs with MacTCP.  It requires System 7, and has minimal features.  It runs either as a background only application, and should be compatible with most TFTPd clients.
  22.  
  23. Note: TFTP is a completely seperate protocol from FTP.  This is NOT
  24. a Trivial FTP server, it is a TFTP server.  TFTP is generally used for
  25. booting routers and the like, not as a file transfer system.
  26.  
  27. • Features
  28.  
  29. Logs requests.
  30. IP-based security system.
  31. Read only.
  32. No ASCII translation.
  33. Average performance.
  34.  
  35. • Using TFTPd
  36.  
  37. Ensure that you are running System 7 and that MacTCP is installed.  Launch TFTPd.  It will disappear into the background (you can quit it using ProcessWatcher, although the Finder will neglect to ungrey the icon so it’ll still look like it’s running, but that’s a bug in the finder).  TFTPd creates a folder (called “TFTPd”) in the Preferences folder in your System Folder.  Any files inside that folder will be available to anyone with a TFTPd client.
  38.  
  39. WARNING: TFTP (the protocol) has no permission system.  So any file or folder inside the TFTPd folder in the Preferences folder will be accessible to anyone who knows it is there.
  40.  
  41. TFTPd will not allow access to any files with names containing an exclamation point (!).  The “!TFTPd Log” is an example of such a file.  TFTPd will check for files first in a folder named “!<remoteip>” (eg “!2.3.4.5”) inside the TFTPd directory, and then in the TFTPd directory, so you can restrict files to machines with spacific IP numbers.
  42.  
  43. TFTPd doesn’t support ASCII translation, so you’ll need to convert any TEXT files you put in the folder to end with <crlf> instead of just <cr>, as well as to convert them to ISO-8859-1 character sets if desired. You can use DropText and other such utilities to do this for you.
  44.  
  45. • Security Considerations
  46.  
  47. “Be afraid.  Be very afraid” - The Fly
  48.  
  49. TFTPd is fairly safe, although it will follow aliases and allow colons in incoming filenames (although not paired colons, so you can’t go up a directory).  Anything accessible thru the TFTPd folder will be accessible to anyone who knows it is there, except for files containing exclamation points.
  50.  
  51. TFTP has no directory listing mechanism, so potential crackers will have to know the file is there, so you can use a directory name as a password and be no worse off than you would be with passworded FTP.
  52.  
  53. TFTPd will check for files first in a folder named “!<remoteip>” (eg “!2.3.4.5”) inside the TFTPd directory, and then in the TFTPd directory, so you can restrict files to machines with spacific IP numbers.
  54.  
  55. All Read and Write requests are logged to a “!TFTPd Log” file in the TFTPd folder in the preferences folder.
  56.  
  57. • Limitations
  58.  
  59. TFTPd requires System 7 and MacTCP 1.1 (or later perhaps?), and probably requires the 128k ROM (or later).  TFTPd is not particularly quick, does not support uploading, does not support ASCII translation.
  60.  
  61. • Small Print
  62.  
  63. This program is Shareware, which means if you use it, and you’d like me to write more useful things or enhance this software, then you should send me $10 (US or Australian).  For individual registrations, you might as well just send cash, but I can accept checks drawn on US bank accounts without any problem.
  64.  
  65. Site Licensing:
  66. World-wide license: US$1000
  67. Foreign universities or companies site license: US$250
  68. Australian universities or companies site license: AU$250
  69. Individuals: AU or US $10.
  70.  
  71. NOTE: I have avoided writing a TFTP server for years, despite people’s requests, because I have never seen the need for it.  If you wish this software enhanced in any of the ways described in the todo section, then demonstrate this by paying the shareware fee.  I wont be developing this any further unless there is a reasonable amount of interest in it.
  72.  
  73. You may distribute TFTPd any way you wish as long as you don't charge for it (reasonable download costs such as Compu$erve are ok I guess (although who would call Compu$erve’s download costs reasonable?)).  It would probably be a good idea to keep this documentation file with the program, but I’m hardly likely to check up on you now am I!  I don’t guarantee any support, but I always answer my Email.  If I don’t answer Email its because your message didn’t get to me, or my reply bounced (so try again, and include a valid internet address if you can).
  74.  
  75. You MAY NOT DISTRIBUTE TFTPd on any disk costing more than $5 without my explicit permission.
  76.  
  77. • Warranty
  78.  
  79. This program should do what I’ve described in this document.  If it doesn’t, you can simply stop using it.  If you pay me, and within a year find that it doesn’t do what I describe here, then you can notify me and I will refund your money and cancel your license.
  80.  
  81. • Fine Print
  82.  
  83. Peter Lewis hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose.  Peter Lewis will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason, even if Peter Lewis or an agent of his has been advised of the possibility of such damages.  In no event shall Peter Lewis be liable for any damages, regardless of the form of the claim.  The person using the software bears all risk as to the quality and performance of the software.
  84.  
  85. US Governement:
  86.         Government End Users:  If you are acquiring the Software and fonts
  87. on behalf of any unit or agency of the United States Government, the
  88. following provisions apply.  The Government agrees:
  89.         (i) if the Software and fonts are supplied to the Department of
  90. Defense (DoD), the Software and fonts are classified as "Commercial
  91. Computer Software" and the Government is acquiring only "restricted rights"
  92. in the Software, its documentation and fonts as that term is defined in
  93. Clause 252.227-7013(c)(1) of the DFARS; and
  94.         (ii) if the Software and fonts are supplied to any unit or agency
  95. of the United States Government other than DoD, the Government's rights in
  96. the Software, its documentation and fonts will be as defined in Clause
  97. 52.227-19(c)(2) of the FAR or, in the case of NASA, in Clause
  98. 18-52.227-86(d) of the NASA Supplement to the FAR.
  99.  
  100. • Acknowledgements
  101.  
  102. Thanks to the nice folks at InterCon for paying my WWDC conference fee again this year, which led somewhat indirectly to me writing this program.
  103.  
  104. • How It Works
  105.  
  106. TFTPd listens to the TFTP server UDP port (69) for Read Request packets, and when it gets one it checks for the existance of the specified file, and then sends it back to the client using a very simply lock-step data/ack packet sequence as defined in the TFTP RFC.
  107.  
  108. • Version History
  109.  
  110. Todo:
  111. Remove System 7 dependency
  112. Speed
  113. Uploading
  114. ASCII translation
  115.  
  116. 1.0.0 - First release
  117. ~Site restriction
  118. ~Logging
  119.  
  120. • The Author
  121.  
  122. Programs written by me:
  123. TFTPd 1.0.0 - Macintosh TFTP server.
  124. CDIconKiller 1.0.0 - Supress custom icons on CDs (written with Quinn).
  125. MungeImage 1.1.0 - Mount DiskCopy images (written with Quinn).
  126. Anarchie 1.2.0 - Macintosh FTP and Archie client.
  127. Morpion 1.0.0 - A simple solitaire game.
  128. FTPd 2.2.0 - Macintosh FTP server.
  129. Daemon 1.0.0 - Macintosh multi-protocol daemon.
  130. Script Daemon 1.0.0 - Telnet->AppleScript gateway
  131. DeHQX 2.0.1 - BinHex decoder (use StuffIt Expander instead).
  132. Finger 1.3.7 - Macintosh Finger client/daemon.
  133. Talk 1.1.1 - Macintosh Talk client/daemon.
  134. MacTCP Watcher 1.1.0 - Display MacTCP’s state information.
  135. MacBinary II+ 1.0.2 - MacBinary II+ encoder/decoder.
  136. ObiWan 4.0.1 - Online help system.
  137. Bolo Finder 1.0.2 - Display the results from Mike Ellis' Bolo Tracker.
  138. Bolo RandomMap 1.1.0 - Generate a random map for Bolo.
  139. FetchNews 1.0.0b - Fetch News for use with NewsWatcher’s demo mode.
  140. Chat 1.1.0 - Multiuser primitive irc-like daemon.
  141.  
  142. The latest versions of my programs are available from:
  143. amug.org:pub/peterlewis
  144. nic.switch.ch:/mac/software/peterlewis
  145. redback.cs.uwa.edu.au:/others/peterlewis
  146. and French versions of some of my programs may be available from: ftp.sri.ucl.ac.be:/pub
  147.  
  148. Send postcards, comments, bug reports, wishes, and payments to:
  149.  
  150. Peter Lewis,
  151. 10 Earlston Way,
  152. Booragoon, Perth, WA, 6154,
  153. AUSTRALIA
  154.  
  155. or by electronic mail to:
  156.  
  157. Internet: peter.lewis@info.curtin.edu.au
  158. Bitnet: peter.lewis%info.curtin.edu.au@cunyvm.bitnet
  159. UUCP: uunet!munnari.oz!info.curtin.edu.au!peter.lewis
  160.