Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
NNCHECK(1)		    General Commands Manual		    NNCHECK(1)

       nncheck - check for unread articles

       nncheck [ -Q -r -t ]  [ -f format ]

       nncheck	will report if there are some articles on the system which you
       have not	read.

       Without options,	nncheck	will simply print a message reporting the num-
       ber of unread articles with the following format:
	    There are 327 unread articles in 25	groups
       and  when  there	 are no	unread articles, the following message will be
	    No News (is	good news)

       nncheck will exit with a	value of 0 if there are	unread	articles,  and
       99 if there is no news (see the exception for the -r option.)

       It  is  important  to notice that even though unread articles have been
       reported	by nncheck, the	actual number of unread	articles may  be  much
       lower  (or even zero) when nn is	invoked	to read	the articles.  This is
       because the calculation of the number of	unread articles	is only	 based
       on recorded article number intervals.  Invoking nn to read the articles
       may reveal that the articles have previously been read in another  news
       group, have been	expired, or are	killed using the auto-kill facility.

       The  following  options are used	to modify the amount and format	of the
       output from nncheck:

       -Q     Quiet operation.	No output is produced, only  the  exit	status
	      indicate whether there is	unread news.

       -t     Print  the name of each group with unread	articles, and how many
	      unread articles there are	(not counting split digests!).

       -r     Output a single integer value specifying the  number  of	unread
	      articles,	 and exit with a 0 status (somebody told me this would
	      be useful).

       -f format
	      Output the number	of unread articles using the specified format.
	      The format is a text that	may contain the	following %-escapes:
			%-code	  resulting output
			%u	  "uuu unread articles"
			%g	  "ggg groups"
			%i	  "is" if 1 unread article, else "are"
			%U	  "uuu"
			%G	  "ggg"
	      where  uuu is the	number of unread articles, and ggg is the num-
	      ber of groups with unread	articles.
	      For example, the default output format is
		   "There %i %u	in %g"
	      which I prefer to	the following less perfect format:
		   "There are %U unread	article(s) in %G group(s)"

       ~/.newsrc       The record of read articles
       $db/MASTER      The database master index

       nn(1), nngoback(1), nngrab(1), nngrep(1), nnpost(1), nntidy(1)
       nnadmin(1M), nnusage(1M), nnmaster(1M)

       Kim F. Storm, Texas Instruments A/S, Denmark

4th Berkeley Distribution	  Release 6.6			    NNCHECK(1)


Want to link to this manual page? Use this URL:

home | help