archie.hlp
上传用户:sddyfurun
上传日期:2007-01-04
资源大小:525k
文件大小:7k
源码类别:

代理服务器

开发平台:

Unix_Linux

  1. 1 ARCHIE   
  2. ARCHIE is a utility to query the Archie anonymous FTP databases using
  3. Prospero.  It will check the databases for entries about the files that 
  4. are available via anonymous FTP from sites around the world.
  5. Format:             $ ARCHIE [-option] <string>
  6. This will query an ARCHIE server and ask it to look for all known sites 
  7. that have a file named `string' in their FTP area.  ARCHIE will wait and 
  8. then print out any matches.
  9. 2 Options
  10. ARCHIE is originally a Unix utility so its options make use of 
  11. the Unix `-option' and not the VMS `/qualifier' syntax.
  12. With the `-L' and `-N#' options you must enclose the option in
  13. double quotes (ie "-L" and "-N#") to prevent the server from
  14. translating them into lowercase options.
  15. 3 -ecsr
  16. These are search-modifying options:
  17.      -e   Exact string match.  (This is the default.)
  18.      -c   Search substrings paying attention to upper and lower case.
  19.      -s   Search substrings ignoring the case of the letters.
  20.      -r   Search using a regular expression.
  21.  
  22. `-c', `-s' and `-r' are mutually exclusive;  only the last one counts.  
  23. If you specify `-e' with any of them the server will first check for an 
  24. exact match, then fall back to the case-sensitive, case-insensitive, or  
  25. regular expression search.  This is so if there are matches that are 
  26. particularly obvious, it will use a minimal amount of search time.
  27. 3 -h <hostname>
  28. Instruct ARCHIE to query another ARCHIE server with the name 
  29. `hostname', instead of its default server.
  30. ARCHIE is compiled with a specific default server host.  
  31. This default can be changed by defining the symbol ARCHIE_HOST 
  32. as one of the other available hosts.  The `-h' option will 
  33. override these defaults. 
  34. (Use option -L to get the list of available hosts.)
  35. 3 -o <filename>
  36. To redirect the output of ARCHIE to a file (rather than use the
  37. standard output), give the `filename' it should store the results in.
  38. 3 -l          
  39. Output results in a form suitable for parsing by programs.
  40. 3 -m#
  41. Specifies the maximum number of hits (matches) to return. 
  42. The default is 95 hits.
  43. 3 -t
  44. Sort the results in reverse date order.
  45. 3 -L
  46. Lists the Archie servers known to the program when it was
  47. compiled, as well as the name of the default Archie server.  
  48.       (Note: You MUST put quotes around this argument 
  49.               or it will be converted to lowercase.)         
  50. 3 -N[#]
  51. Sets the `niceness' of a query.  The default niceness is 0.
  52. Using `-N' without an argument sets it to 35765 (the maximum).
  53. If you use `-N' with an argument between 0 and 35765, it will 
  54. adjust itself accordingly.  
  55.       (Note: You MUST put quotes around this argument 
  56.               or it will be converted to lowercase.)         
  57. (See also the subtopic `Niceness')
  58. 3 -V
  59. Provide some reassuring messages when a search is taking a long time.
  60. 3 -v
  61. Print the version of the client.
  62. 2 String
  63. This can be either the name of a file or a substring of a filename.
  64. If you use a substring, then you must use one of the search-modifying
  65. options `-c', `-r' or `-s'.  Otherwise ARCHIE will only respond with
  66. only those files that match exactly the substring!
  67. If the search string starts with a `-' you must precede it with 
  68. another `-'.  For example
  69.      $ archie  -s  - -old
  70. will search for all filenames that contain the string `-old'.
  71. 2 Examples
  72. 1.          $ archie emacs
  73.      This will find all anonymous FTP sites in the ARCHIE database
  74.      that have files named `emacs' somewhere in their FTP area.
  75.      (This particular query would probably return a lot of direc-
  76.      tories.)  
  77. 2.          $ archie -c emacs
  78.      This will produce a list of every file that contains the
  79.      string `emacs' anywhere in the filename.
  80. 3.   Regular expressions may also be used for searches:
  81.             $ archie -r '[xX][lL]isp'
  82.      If a string is enclosed in brackets [] ARCHIE will attempt to 
  83.      match any single character from the string.  In the above example
  84.      it will try and match either `x' or `X' plus either `l' or `L' 
  85.      followed by `isp'.  It is recommended that you enclose the whole
  86.      expression in single quotes to prevent the server misinterpreting it.
  87. 2 Niceness
  88. Niceness is the (Unix) concept of `being nice' to other users by 
  89. lowering the priority of non-urgent jobs.
  90. You should use the `-N' option whenever you do not demand immediacy,  
  91. or when you are requesting things that could generate large responses.  
  92. Here is a list of what would be considered as `nice' values that
  93. accurately reflect the priority of a request to the server.
  94.           Normal              0
  95.           Nice                500
  96.           Nicer               1000
  97.           Very Nice           5000
  98.           Extremely Nice      10000
  99.           Nicest              32765
  100. The last priority, Nicest, would be used when a job should wait until  
  101. the queue is essentially empty before running. You should pick one of
  102. these values to use, possibly modifying it slightly depending on where 
  103. you think your priority should land.  For example, 32760 would mean wait  
  104. until the queue is empty, but jump ahead of other jobs that are `Nicest'.
  105. 2 Bugs
  106. There are none; only a few unexpected features.
  107. 2 VMS Notes
  108. Please note that there are some options (e.g., -a) that aren't very
  109. useful under VMS, so are not documented in this help file.
  110. To use the ARCHIE program, define it as a symbol to point to the
  111. ARCHIE.EXE image, or the arguments won't get processed properly:
  112. $ ARCHIE :== $THE$DISK:[SOME.DIR]ARCHIE
  113. Any further enhancements for VMS for this client are welcome and
  114. encouraged.
  115. 2 Background
  116. ARCHIE runs as a client and queries an Archie anonymous FTP database 
  117. looking for the specified search string, using the Prospero protocol.  
  118. This client is based on Prospero version Beta.4.2 and is provided to 
  119. encourage non-interactive use of the Archie servers (and subsequently 
  120. better performance on both sides).  
  121. The ARCHIE service was conceived and implemented by Alan Emtage
  122. (bajan@cs.mcgill.ca), Peter Deutsch (peterd@cs.mcgill.ca), and 
  123. Bill Heelan (wheelan@cs.mcgill.ca).  The entire Internet is in 
  124. their debt.
  125. The Prospero system was created by Clifford Neuman (bcn@isi.edu); 
  126. write to info-prospero@isi.edu for more information on the protocol 
  127. and its use.
  128. This stripped client was put together by Brendan Kehoe 
  129. (brendan@cygnus.com), with modifications by Clifford Neuman 
  130. and George Ferguson (ferguson@cs.rochester.edu).
  131. This help file was written by John Armstrong (armstrong@leva.leeds.ac.uk).