home *** CD-ROM | disk | FTP | other *** search
/ Super Net 1 / SUPERNET_1.iso / PC / OTROS / UNIX / ARCHIE / CLIENTS / ARCHIE-1.4 / ARCHIE.DOC < prev    next >
Encoding:
Text File  |  1992-10-20  |  8.1 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 ] [ -a ] [ -l ] [ -t ] [ -m hits ] [ -N level ] [ -h hostname ]
  14.              [ -o filename ] [ -L ] [ -fB-V ] 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.      -ofilename  If specified, place the results of the search in
  77.                  filename.
  78.      -a          Output results as Alex filenames.
  79.      -l          Output results in a form suitable for parsing by
  80.                  programs.
  81.      -t          Sort the results inverted by date.
  82.      -mhits      Specifies the maximum number of  hits  (matches)
  83.                  to return (default of 95).
  84.      -Nlevel     Sets the niceness of a query; by  default,  it's
  85.                  set  to 0.  Without an argument, ``-N'' defaults
  86.                  to 35765.   If  you  use  -N  with  an  argument
  87.                  between 0 and 35765, it'll adjust itself accord-
  88.                  ingly.  (Note: VMS users will have to put quotes
  89.                  around  this  argument, and -L, like "-N45"; VMS
  90.                  will otherwise convert it to lowercase.)
  91.      -h hostname Tells the client  to  query  the  Archie  server
  92.                  hostname.
  93.      -L          Lists the Archie servers known  to  the  program
  94.                  when it was compiled, as well as the name of the
  95.                  default Archie server.  For an up-to-date  list,
  96.                  write  to  ``archie@archie.mcgill.ca''  (or  any
  97.                  Archie  server)  with  the  single  command   of
  98.                  servers.
  99.      -V          With the verbose option, archie will  make  some
  100.                  comments  along  the way if a search is going to
  101.                  take some time, to pacify the user.
  102.  
  103.      The three search-modifying arguments  (``-c'',  ``-r'',  and
  104.      ``-s'')  are  all  mutually  exclusive;  only  the  last one
  105.      counts.  If you specify -e with any of  ``-c'',  ``-r'',  or
  106.      ``-s'', the server will first check for an exact match, then
  107.      fall back to the case-sensitive, case-insensitive, or  regu-
  108.      lar expression search.  This is so if there are matches that
  109.      are particularly obvious, it will take a minimal  amount  of
  110.      time to satisfy your request.
  111.  
  112.      If you list a single `-' by itself,  any  further  arguments
  113.      will  be  taken  as  part  of  the  search  string.  This is
  114.      intended to enable searching for strings that begin  with  a
  115.      `-'; for example:
  116.  
  117.           % archie -s - -old
  118.  
  119.      will search for all filenames that contain the string `-old'
  120.      in them.
  121.  
  122. RESPONSE
  123.      Archie servers are set up to respond to a number of requests
  124.      in  a  queued fashion.  That is, smaller requests get served
  125.      much more quickly than do large requests.  As a result,  the
  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.      more  often  you query the Archie server, or the larger your
  141.      requests, the longer the queue will become, resulting  in  a
  142.      longer  waiting  period  for everyone's requests.  Please be
  143.      frugal when possible, for your benefit as well  as  for  the
  144.      other users.
  145.  
  146. QUERY PRIORITY
  147.      Please use the  ``-N''  option  whenever  you  don't  demand
  148.      immediacy,  or when you're requesting things that could gen-
  149.      erate large responses.  Even when using the nice option, you
  150.      should  still  try  to  avoid  big jobs during busy periods.
  151.      Here is a list of what we consider to be  nice  values  that
  152.      accurately reflect the priority of a job to the server.
  153.  
  154.           Normal              0
  155.           Nice                500
  156.           Nicer               1000
  157.           Very Nice           5000
  158.           Extremely Nice      10000
  159.           Nicest              32765
  160.  
  161.      The last priority, Nicest, would be used when a  job  should
  162.      wait  until  the  queue is essentially empty before running.
  163.      You should pick one of these values to use, possibly modify-
  164.      ing  it  slightly depending on where you think your priority
  165.      should land.  For example, 32760 would mean wait  until  the
  166.      queue  is  empty,  but  jump  ahead  of other jobs that have
  167.      selected Nicest.
  168.  
  169.      There are certain types of  things  that  we  suggest  using
  170.      Nicest  for,  irregardless.  In particular, any searches for
  171.      which you would have a hard time justifying the use of  any-
  172.      thing but extra resources.  (We all know what those searches
  173.      would be for.)
  174.  
  175. ENVIRONMENT
  176.      ARCHIE_HOST
  177.              This will change the host archie will  consult  when
  178.              making  queries.   (The default value is what's been
  179.              compiled in.)  The ``-h'' option will override this.
  180.              If  you're  running  VMS,  create  a  symbol  called
  181.              ARCHIE_HOST.
  182.  
  183. SEE ALSO
  184.      For more information on regular expressions, see the  manual
  185.      pages on:
  186.  
  187.      regex(3), ed(1)
  188.  
  189.      Also   read    the    file    archie/doc/whatis.archie    on
  190.      archie.mcgill.ca for a detailed paper on Archie as a whole.
  191.  
  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.      Read the file README.ALEX distributed with this  client  for
  207.      more information on what Alex is and how you can take advan-
  208.      tage of it.
  209. AUTHORS
  210.      The archie service was conceived  and  implemented  by  Alan
  211.      Emtage       (bajan@cs.mcgill.ca),       Peter       Deutsch
  212.      (peterd@cs.mcgill.ca),        and        Bill         Heelan
  213.      (wheelan@cs.mcgill.ca).   The  entire  Internet  is in their
  214.      debt.
  215.  
  216.      The  Prospero  system  was  created   by   Clifford   Neuman
  217.      (bcn@isi.edu);   write  to  info-prospero@isi.edu  for  more
  218.      information on the protocol and its use.
  219.  
  220.      This stripped client  was  put  together  by  Brendan  Kehoe
  221.      (brendan@cygnus.com),  with modifications by Clifford Neuman
  222.      and George Ferguson (ferguson@cs.rochester.edu).
  223.  
  224. BUGS
  225.      There are none; only a few unexpected features.
  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.