home *** CD-ROM | disk | FTP | other *** search
/ Media Share 9 / MEDIASHARE_09.ISO / network / archie.zip / ARCHIE.DOC next >
Text File  |  1991-11-20  |  7KB  |  265 lines
  1.  
  2.  
  3.  
  4. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      archie - query the  Archie  anonymous  FTP  databases  using
  10.      Prospero
  11.  
  12. SYNOPSIS
  13.      archie [ -cers ] [ -l ] [ -t ] [ -m# ] [ -N# ] [ -h host ] [ -L ] string
  14.  
  15. DESCRIPTION
  16.      archie queries an archie anonymous FTP database looking  for
  17.      the  specified  string  using  the  Prospero protocol.  This
  18.      client is based on Prospero version Beta.4.2 and is provided
  19.      to  encourage non-interactive use of the Archie servers (and
  20.      subsequently better performance on both sides).
  21.  
  22.      The general method of use is of the form
  23.  
  24.           % archie string
  25.  
  26.      This will go to the archie server and ask it to look for all
  27.      known  systems  that have a file named `string' in their FTP
  28.      area.  archie will wait, and print out any matches.
  29.  
  30.      For example,
  31.  
  32.           % archie emacs
  33.  
  34.      will find all anonymous FTP sites  in  the  archie  database
  35.      that  have  files  named  emacs somewhere in their FTP area.
  36.      (This particular query would probably return a lot of direc-
  37.      tories.)  If you want a list of every filename that contains
  38.      emacs anywhere in it, you'd use
  39.  
  40.           % archie -c emacs
  41.  
  42.      Regular expressions, such as
  43.  
  44.           % archie -r '[xX][lL]isp'
  45.  
  46.      may also be used for searches.  (See the manual of a reason-
  47.      ably good editor, like GNU Emacs or vi, for more information
  48.      on using regular expressions.)
  49.  
  50.  
  51. OPTIONS
  52.      The options currently available to this archie client are:
  53.  
  54.      -c          Search substrings paying attention  to  upper  &
  55.                  lower case.
  56.      -e          Exact string match.  (This is the default.)
  57.      -r          Search using a regular expression.
  58.      -s          Search  substrings  ignoring  the  case  of  the
  59.                  letters.
  60.  
  61.  
  62.  
  63. Archie (Prospero) Last change: 20 November 1991                 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  71.  
  72.  
  73.  
  74.      -l          Output results in a form suitable for parsing by
  75.                  programs.
  76.      -t          Sort the results inverted by date.
  77.      -m#         Specifies the maximum number of  hits  (matches)
  78.                  to return (default of 95).
  79.      -N#         Sets the niceness of a query; by  default,  it's
  80.                  set  to  0.  Without an argument, -N defaults to
  81.                  35765.  If you use -N with an argument between 0
  82.                  and  35765,  it'll  adjust  itself  accordingly.
  83.                  (Note: VMS users will have to put quotes  around
  84.                  this  argument,  and -L, like ``-N45''; VMS will
  85.                  otherwise convert it to lowercase.)
  86.      -h host     Tells the client  to  query  the  Archie  server
  87.                  named host.
  88.      -L          Lists the Archie servers known  to  the  program
  89.                  when it was compiled.
  90.  
  91.   Quick Hits
  92.      You'll often find yourself making fast and  furious  queries
  93.      for  multiple  things  that all look similar (e.g. `telnet',
  94.      `net', etc).  If you get into the  habit  of  using  the  -c
  95.      option  when  performing  these  kinds  of searches, they'll
  96.      often prove more  fruitful  than  if  you  relied  upon  the
  97.      default of -e.
  98.  
  99.   Notes
  100.      The three search-modifying arguments (-c, -r,  and  -s)  are
  101.      all  mutually  exclusive;  only the last one counts.  If you
  102.      specify -e with any of -c, -r, or -s, the server will  first
  103.      check  for  an  exact  match,  then  fall  back to the case-
  104.      sensitive, case-insensitive, or regular  expression  search.
  105.      This  is so if there are matches that are particularly obvi-
  106.      ous, it will take a minimal amount of time to  satisfy  your
  107.      request.
  108.  
  109.      If you list a single `-' by itself,  any  further  arguments
  110.      will  be  taken  as  part  of  the  search  string.  This is
  111.      intended to enable searching for strings that begin  with  a
  112.      `-'; for example:
  113.  
  114.           % archie -s - -old
  115.  
  116.      will search for all filenames that contain the string `-old'
  117.      in them.
  118.  
  119. RESPONSE
  120.      Archie servers are set up to respond to a number of requests
  121.      in  a  queued fashion.  That is, smaller requests get served
  122.      much more quickly than do large requests.  As a result,  the
  123.      more  often  you query the Archie server, or the larger your
  124.      requests, the longer the queue will become, resulting  in  a
  125.      longer  waiting  period  for everyone's requests.  Please be
  126.  
  127.  
  128.  
  129. Archie (Prospero) Last change: 20 November 1991                 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  137.  
  138.  
  139.  
  140.      frugal when possible, for your benefit as well  as  for  the
  141.      other users.
  142.  
  143. QUERY PRIORITY
  144.      Please use the -N option whenever you don't  demand  immedi-
  145.      acy,  or  when  you're requesting things that could generate
  146.      large responses.  Even  when  using  the  nice  option,  you
  147.      should  still  try  to  avoid  big jobs during busy periods.
  148.      Here is a list of what we consider to be  nice  values  that
  149.      accurately reflect the priority of a job to the server.
  150.  
  151.           Normal              0
  152.           Nice                500
  153.           Nicer               1000
  154.           Very Nice           5000
  155.           Extremely Nice      10000
  156.           Nicest              32765
  157.  
  158.      The last priority, Nicest, would be used when a  job  should
  159.      wait  until  the  queue is essentially empty before running.
  160.      You should pick one of these values to use, possibly modify-
  161.      ing  it  slightly depending on where you think your priority
  162.      should land.  For example, 32760 would mean wait  until  the
  163.      queue  is  empty,  but  jump  ahead  of other jobs that have
  164.      selected Nicest.
  165.  
  166.      There are certain types of  things  that  we  suggest  using
  167.      Nicest  for,  irregardless.  In particular, any searches for
  168.      which you would have a hard time justifying the use of  any-
  169.      thing but extra resources.  (We all know what those searches
  170.      would be for.)
  171.  
  172. SEE ALSO
  173.      For more information on regular expressions, see the  manual
  174.      pages on:
  175.  
  176.      regex(3), ed(1)
  177.  
  178.      Also read the file archie/whatis on archie.mcgill.ca  for  a
  179.      detailed paper on Archie as a whole.
  180.  
  181. AUTHORS
  182.      The archie service was conceived  and  implemented  by  Alan
  183.      Emtage       (bajan@cs.mcgill.ca),       Peter       Deutsch
  184.      (peterd@cs.mcgill.ca),        and        Bill         Heelan
  185.      (wheelan@cs.mcgill.ca).   The  entire  Internet  is in their
  186.      debt.
  187.  
  188.      The  Prospero  system  was  created   by   Clifford   Neuman
  189.      (bcn@isi.edu);   write  to  info-prospero@isi.edu  for  more
  190.      information on the protocol and its use.
  191.  
  192.  
  193.  
  194.  
  195. Archie (Prospero) Last change: 20 November 1991                 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. ARCHIE(1)                USER COMMANDS                  ARCHIE(1)
  203.  
  204.  
  205.  
  206.      This stripped client  was  put  together  by  Brendan  Kehoe
  207.      (brendan@cs.widener.edu),  with  modifications  by  Clifford
  208.      Neuman and George Ferguson (ferguson@cs.rochester.edu).
  209.  
  210. BUGS
  211.      There are none; only a few unexpected features.
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261. Archie (Prospero) Last change: 20 November 1991                 4
  262.  
  263.  
  264.  
  265.