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