


     NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((11113333 AAAApppprrrriiiillll 1111999999992222))))	    NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))



Name
	newsaux - spacefor, queuelen, sizeof, ctime, getdate, getabsdate, newshostname, gngp, canonhdr, newslock
	  spacefor - check available space for news
	  queuelen - get length of outbound-news uucp queues
	  sizeof - get size of file(s) for news
	  ctime, getdate, getabsdate - convert dates to and from
	  internal representation for news
	  newshostname - get host name for news
	  gngp - search text using a newsgroup pattern
	  canonhdr - extract header and canonicalize
	  newslock - do locking for news

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ssssppppaaaacccceeeeffffoooorrrr filesize location [	site ]
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////qqqquuuueeeeuuuueeeelllleeeennnn site
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ssssiiiizzzzeeeeooooffff [ ----iiii ] file ...
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ccccttttiiiimmmmeeee [ ----uuuu ]	decimaldate
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ggggeeeettttddddaaaatttteeee printabledate
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ggggeeeettttaaaabbbbssssddddaaaatttteeee absolute-printable-date
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwsssshhhhoooossssttttnnnnaaaammmmeeee
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ggggnnnnggggpppp	[ ----aaaarrrrvvvv ] ngpattern file	...
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////ccccaaaannnnoooonnnnhhhhddddrrrr [ ----ddddmmmm ] [ file ] ...
	  ////uuuussssrrrr////lllliiiibbbb////nnnneeeewwwwssssbbbbiiiinnnn////nnnneeeewwwwsssslllloooocccckkkk locktemp lockname

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
	  These	programs are minor utilities used by various parts of
	  C News.

	  _S_p_a_c_e_f_o_r determines how many files of	size _f_i_l_e_s_i_z_e can fit
	  in _l_o_c_a_t_i_o_n (iiiinnnnccccoooommmmiiiinnnngggg, aaaarrrrttttiiiicccclllleeeessss, ccccoooonnnnttttrrrroooollll, aaaarrrrcccchhhhiiiivvvveeee, or
	  oooouuuuttttbbbboooouuuunnnndddd to _s_i_t_e) without cramping things unduly.  The
	  precise locations of these places, and how low space gets
	  before it is unduly cramped, are site-specific.  _S_p_a_c_e_f_o_r
	  invokes _d_f(1)	or the equivalent system call to determine the
	  available space.

	  _Q_u_e_u_e_l_e_n reports how many news batches _u_u_c_p has queued up
	  for _s_i_t_e.

	  _S_i_z_e_o_f reports the total number of bytes in the _f_i_l_e(s).
	  (This	may seem redundant with	_l_s -_l, but the format of _l_s -_l
	  varies between systems and _s_i_z_e_o_f looks after	all that.)
	  Nonexistent files are	silently ignored.  If the ----iiii option is
	  given, _s_i_z_e_o_f	prints one line	per (existing) file, with name
	  and size, and	does not print the total.

	  _C_t_i_m_e, _g_e_t_d_a_t_e and _g_e_t_a_b_s_d_a_t_e	convert	dates in human-
	  readable form	to (_g_e_t_d_a_t_e and	_g_e_t_a_b_s_d_a_t_e) and	from (_c_t_i_m_e)
	  decimal ASCII	representations	of Unix's internal integer
	  dates.  Their	functionality resembles	that of	their
	  namesakes in the C library.  _g_e_t_a_b_s_d_a_t_e parses only absolute
	  dates, not relative dates.  Both _c_t_i_m_e and _g_e_t_d_a_t_e recognise
	  the argument nnnnoooowwww to mean the current time.  Under ----uuuu,	_c_t_i_m_e



     Page 1					      (printed 6/4/94)






     NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((11113333 AAAApppprrrriiiillll 1111999999992222))))	    NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))



	  will print GMT instead of local time.

	  _N_e_w_s_h_o_s_t_n_a_m_e reports the name	of this	system for news
	  purposes.  This may differ from the name of the particular
	  CPU it is run	on; a cluster of CPUs sharing a	filesystem
	  tree would all have the same _n_e_w_s_h_o_s_t_n_a_m_e name.  Typically
	  _n_e_w_s_h_o_s_t_n_a_m_e gets the	name from /_u_s_r/_l_i_b/_n_e_w_s/_w_h_o_a_m_i;
	  failing that,	it consults various other possible sources
	  (e.g.	the _h_o_s_t_n_a_m_e command).

	  _G_n_g_p resembles _g_r_e_p except that its search is	based on
	  newsgroup patterns (e.g. `comp', which matches `comp',
	  `comp.lang', `comp.lang.c', ...; `comp,!comp.lang.c' which
	  matches `comp' and `comp.lang' but not `comp.lang.c';	etc.).
	  _G_n_g_p prints only the line(s) that contain a substring	that
	  matches the _n_g_p_a_t_t_e_r_n.  Normally the substring must run from
	  a point in the line to its end.  If the ----aaaa flag is given,
	  the eligible substrings start	at the beginning of the	line
	  and end at white space or the	end of the line.  The ----vvvv
	  option prints	only lines that	do _n_o_t match.  The ----rrrr flag
	  reverses the inputs, with patterns coming from the file and
	  the argument taken as	the line(s).

	  _C_a_n_o_n_h_d_r takes the concatenation of its input	_f_i_l_e(s)
	  (standard input if none) as an article, and outputs the
	  header from the article with header keywords canonicalized
	  for easier processing.  Canonicalization forces all
	  alphabetics to lower case except the first letter of each
	  (hyphen-separated) word in the keyword, which	is forced to
	  upper	case.  (One exception: ``Message-ID'' is the canonical
	  form of [e.g.] ``message-id''.) Under	----dddd, _c_a_n_o_n_h_d_r will also
	  canonicalise dates in	DDDDaaaatttteeee:::: and EEEExxxxppppiiiirrrreeeessss:::: headers.  Under ----mmmm,
	  it will accept RFC 822 headers and rewrite them as RFC 1036
	  headers.

	  _N_e_w_s_l_o_c_k makes a link	named _l_o_c_k_n_a_m_e to the file _l_o_c_k_t_e_m_p,
	  and returns exit status 0 for	success, 1 if the link could
	  not be made (typically because _l_o_c_k_n_a_m_e already existed).
	  This is used for shell-file locking in C News.  It is	a
	  subset of _l_n(1) except that (a) no error messages are	ever
	  produced and (b) the link is guaranteed to fail if _l_o_c_k_n_a_m_e
	  already exists.  (Some brain-damaged versions	of _l_n
	  helpfully remove _l_o_c_k_n_a_m_e in that case, making them useless
	  for locking.)

     FFFFIIIILLLLEEEESSSS
	  /usr/spool/uucp/*	  uucp queues
	  /usr/lib/news/whoami	  news host name
	  /usr/lib/news/L.*	  lock temporaries
	  /usr/lib/news/LOCK*	  lock files

     SSSSEEEEEEEE AAAALLLLSSSSOOOO



     PPPPaaaaggggeeee 2222					      ((((pppprrrriiiinnnntttteeeedddd 6666////4444////99994444))))






     NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((11113333 AAAApppprrrriiiillll 1111999999992222))))	    NNNNEEEEWWWWSSSSAAAAUUUUXXXX((((8888))))



	  df(1), uucp(1), ls(1), ctime(3), getdate(3), hostname(1),
	  grep(1), news(5), expire(8), newsbatch(8), rnews(8),
	  newsmaint(8)

     HHHHIIIISSSSTTTTOOOORRRRYYYY
	  Written at U of Toronto by Henry Spencer and Geoff Collyer.

     BBBBUUUUGGGGSSSS
	  _S_p_a_c_e_f_o_r and _q_u_e_u_e_l_e_n	are unfortunately somewhat system-
	  specific, since _d_f output and	_u_u_c_p file layout vary between
	  different versions.  (Using system calls in _s_p_a_c_e_f_o_r doesn't
	  help,	as the system calls differ too.)

	  _Q_u_e_u_e_l_e_n probably ought to count bytes rather	than batches,
	  but that would make its system-dependency even worse.

	  The need for _s_i_z_e_o_f and _n_e_w_s_l_o_c_k is a	botch.






































     Page 3					      (printed 6/4/94)



