home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3626 / README < prev    next >
Encoding:
Text File  |  1991-07-15  |  2.6 KB  |  72 lines
  1. # Copyright (C) Khun Yee Fung clipper@csd.uwo.ca
  2. # You can do anything to this program except selling it for profit or
  3. # pretending you wrote it.
  4. # $Id: README,v 1.1 1991/07/14 08:21:40 clipper Exp clipper $
  5.  
  6. This is a archie client written in Perl using the prospero protocol.
  7. It is standalone with no dependance on the prospero code in
  8. prospero.tar.Z on june.cs.washington.edu. I am not sure this program
  9. is useful as there is also a standalone archie program in that file
  10. archive, except that you have to compile the propero file system too.
  11. Anyhow.
  12.  
  13. To start things off, modify the file archie.depend. You should also
  14. move archie in the directory where you store you perl scripts. The
  15. library files should be in the perl library.
  16.  
  17. As I don't have a full document of the propero, some of the details in
  18. prospero might be misunderstood by me. I read the source code of the
  19. prospero file system to get information on the prospero protocol. I do
  20. have the file called protocol.txt from june.cs.washington.edu, but it
  21. is not complete. I would like to have a pointer to a fuller
  22. description, including the header information of the packets.
  23.  
  24. This program is in the alpha testing stage. Other than the fact that I
  25. am still not 100% sure of the protocol, I consider it really in beta
  26. test.  I need people to test, improve, and suggest, to make it better.
  27. It is written on a Sun 3/50.  I tried it on a MIPSRISC/os 4.51. It
  28. worked. I have also tried it on a Sequent symmetry Dynix Version
  29. something. These are the machines that I have access to.  It might not
  30. work on other machines.  If you port it to another machine type,
  31. please send me the diffs, thanks. If you find bugs on other machine
  32. types, please also tell me. I would like to knwo how portable the
  33. program is.
  34.  
  35. The program has a format facility to output the entries sent back
  36. from the archie server.
  37.  
  38. Format:
  39.       The default format string is:
  40.  
  41.       %02seq Host %host
  42.  
  43.           Location: %dir
  44.             %type %mode %size %date %name
  45.  
  46.      That is, an entry will look like this:
  47.  
  48.       Host rusmv1.rus.uni-stuttgart.de
  49.  
  50.           Location: /soft/tex/machines/atari/passautex
  51.                  File -rw-rw-r--     148864 1991 Feb 14 11:34 GMT TeXDraw-1,41-ST.lzh
  52.  
  53.    You can read the file archie.examples' for more examples.
  54.  
  55. Things to be done:
  56.  
  57. 1, A default sorting option.
  58.  
  59. 2, Clean up the code.
  60.  
  61. 3, Get a full description of the protocol and archie entry-sending behaviour.
  62.  
  63. 4, Clean up the resolver code for the people without a resolver library.
  64.  
  65. 5, I am sure I can think of other things to improve.
  66.  
  67. Please send your comments, criticisms, diffs, etc. to me at
  68. clipper@csd.uwo.ca. Yes, you can even criticise my programming style.
  69.  
  70. Khun Yee
  71. July 14
  72.