NNGRAB(1)                                               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 gener-
       ated 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 onwards, 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



                      Release 6.6.4+RFC1522             NNGRAB(1)