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:
9          nn -mxX -s/keyword all

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

     Keyword case is ignored unless -c is specified, and the key-
     word  can  be  a  regular expressions (escaped to avoid con-
     flicts with the shell).  For example,
9          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  opera-
     tion, 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.




     E-mail: jaw@ames.arc.nasa.gov