NNGRAB(1)                 UNIX System V(Release 6.4)                  NNGRAB(1)


NAME
      nngrab - news retrieval by keyword (nn)

SYNOPSIS
      nngrab [ -c ] keyword

DESCRIPTION
      nngrab invokes nn on all USENET articles whose subject (or keyword)
      field(s) contain an instance of keyword.  nngrab is a fast equivalent
      for:
            nn -mxX -s/keyword all

      For example,
            nngrab tesla
      will retrieve items concerning Nikola Tesla.

      Keyword case is ignored unless -c is specified, and the keyword can be a
      regular expressions (escaped to avoid conflicts with the shell).  For
      example,
            nngrab "n.*tesla"

      The range of search includes all newsgroups on the system, including ones
      which are unsubscribed.

FILES
      $db/subjects   subject database

SEE ALSO
      nn(1), nnspew(8), egrep(1)

NOTES
      nngrab can be much faster than the equivalent command shown above, if the
      tertiary news subject database generated by the nnspew(8) daemon exists.
      To enable the faster operation, nnspew must be executed regularly by
      cron.

      nngrab uses egrep(1) to scan the subject database, so if you are not
      running fast egrep (GNU-style) this is all for naught.

      nngrab will use a subject database generated by nnspew independent of its
      age.  Thus, if you stop running nnspew, remember to remove the subjects
      file as well.

BUGS
      Under version 6.4, search of the "Keywords:" field is not supported.
      Search on name is not possible either.

AUTHOR
      James A. Woods, NASA Ames Research Center
      E-mail: jaw@ames.arc.nasa.gov




10/89                                                                    Page 1