


     NNNNEEEEWWWWSSSSSSSSYYYYSSSS((((5555))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((2222 MMMMaaaarrrrcccchhhh 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SSSSSYYYYSSSS((((5555))))



     NNNNAAAAMMMMEEEE
	  newssys - USENET network news	sys (neighbours) file

     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
	  The 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s////ssssyyyyssss describes which news groups this
	  site is willing to receive and which groups it is willing to
	  transmit to each netnews neighbour.  It is public
	  information and is sent automatically	to any site that sends
	  a _s_e_n_d_s_y_s control message.  A	_s_y_s line has four fields,
	  separated by colons:

	  _s_y_s_t_e_m-
	  _n_a_m_e////_e_x_c_l_u_s_i_o_n_1,,,,_e_x_c_l_u_s_i_o_n_2...::::_s_u_b_s_c_r_i_p_t_i_o_n_s////_d_i_s_t_r_i_b_u_t_i_o_n_s::::_f_l_a_g_s::::_t_r_a_n_s_m_i_s_s_i_o_n
	  _c_o_m_m_a_n_d

	  A #### as the first character in	a line denotes a comment.
	  Empty	lines are ignored.  A logical line may be continued to
	  the next physical line by putting a \\\\	at the end of the
	  current physical line.  Spaces are permitted in _s_y_s only in
	  comments, _t_r_a_n_s_m_i_s_s_i_o_n _c_o_m_m_a_n_d when it really	is a command
	  and not a filename, and, for B news compatibility, at	the
	  start	of a continuation line (after a	\\\\ and a	newline).

	  Of the _s_y_s fields, only the _s_y_s_t_e_m-_n_a_m_e need be present.  If
	  a field and all the fields after it are omitted, the colon
	  immediately before that field	and all	the colons after it
	  may be omitted too.  The optional subfields (_e_x_c_l_u_s_i_o_ns and
	  _d_i_s_t_r_i_b_u_t_i_o_n_s) and their leading slashes may be omitted.

	  The _s_y_s_t_e_m _n_a_m_e is the name of the system being sent to, and
	  is checked against site names	in PPPPaaaatttthhhh:::: headers to avoid
	  sending an article back to a site that has seen it.  The
	  _e_x_c_l_u_s_i_o_ns are also checked against the PPPPaaaatttthhhh::::	header and
	  articles are not sent	to _s_y_s_t_e_m _n_a_m_e if they have visited
	  any of the _e_x_c_l_u_s_i_o_n_s.

	  (The special _s_y_s_t_e_m _n_a_m_e MMMMEEEE stands for the name of the
	  machine news is running on, as determined from
	  ////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s////wwwwhhhhooooaaaammmmiiii.	 The MMMMEEEE	line, or a line	whose _s_y_s_t_e_m
	  _n_a_m_e is explicitly that of the machine news is running on,
	  has a	rather different meaning from that of the other	_s_y_s
	  file lines: its _s_u_b_s_c_r_i_p_t_i_o_n_s	subfield identifies the
	  newsgroups that this site subscribes to (i.e.	is willing to
	  receive), and	its other fields and subfields are ignored.
	  There	should be one such line	in the file.)

	  _s_u_b_s_c_r_i_p_t_i_o_n_s	is a comma-separated list of _n_e_w_s_g_r_o_u_p
	  _p_a_t_t_e_r_n_s specifying the newsgroups to	be transmitted to the
	  _s_y_s_t_e_m; each newsgroup from the NNNNeeeewwwwssssggggrrrroooouuuuppppssss:::: header of	each
	  article is matched against the pattern list, and if any
	  newsgroup matches the	pattern	list, the article is
	  transmitted.	The rules for matching a newsgroup against a



     Page 1					      (printed 6/4/94)






     NNNNEEEEWWWWSSSSSSSSYYYYSSSS((((5555))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((2222 MMMMaaaarrrrcccchhhh 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SSSSSYYYYSSSS((((5555))))



	  single pattern are:

	  o+  _w_o_r_ds in a	newsgroup or a pattern are delimited by
	     periods;

	  o+  words of a	pattern	and a newsgroup	match only if they are
	     identical,	except that the	word aaaallllllll in a pattern matches
	     any newsgroup word;

	  o+  a newsgroup is matched against a pattern word by word,
	     and all words must	match for the newsgroup	to match that
	     pattern;

	  o+  if	the pattern has	fewer words than the newsgroup,	the
	     pattern is	implicitly extended to the same	number of
	     words by appending	....aaaallllllll as	many times as necessary;

	  o+  if	the newsgroup has fewer	words than the pattern,	the
	     newsgroup does not	match the pattern;

	  o+  if	_p_a_t_t_e_r_n	matches	a newsgroup, !!!!_p_a_t_t_e_r_n _m_i_smatches that
	     newsgroup.

	  A newsgroup matches a	pattern	list if, and only if, it
	  matches at least one of the patterns and:

	  o+  the newsgroup does	not mismatch any of the	patterns, or

	  o+  the longest matched pattern is longer than	the longest
	     mismatched	pattern	(length	is measured in number of
	     words, with each explicit occurrence of aaaallllllll counted as
	     slightly less than	one word, and does not include the
	     implicit extension	of patterns with ....aaaallllllll).

	  Note that order in the lists is not significant, and that
	  ties are broken in favor of not matching.  An	example:
	  ccccoooommmmpppp,,,,ccccoooommmmpppp....ssssyyyyssss....ssssuuuunnnn,,,,!!!!ccccoooommmmpppp....ssssyyyyssss matches all the ccccoooommmmpppp groups,
	  _e_x_c_e_p_t the ccccoooommmmpppp....ssssyyyyssss groups _b_u_t _i_n_c_l_u_d_i_n_g ccccoooommmmpppp....ssssyyyyssss....ssssuuuunnnn.

	  The distributions in the DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: header	are similarly
	  matched against the _d_i_s_t_r_i_b_u_t_i_o_n_s subfield, if any.  If no
	  _d_i_s_t_r_i_b_u_t_i_o_n_s	are supplied, DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: will be matched
	  against the _s_u_b_s_c_r_i_p_t_i_o_n_s instead.  (The DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn::::
	  header is ignored when receiving news; it is only
	  significant when sending.)

	  Note that some older news software reportedly	attached
	  magical significance to the distributions ``world'' and
	  ``local''; C News treats them	as ordinary distribution names
	  with no special properties (except that ``world'' is the
	  default distribution of an article if	none appears
	  explicitly).	For example, a _d_i_s_t_r_i_b_u_t_i_o_n_s list like



     Page 2					      (printed 6/4/94)






     NNNNEEEEWWWWSSSSSSSSYYYYSSSS((((5555))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((2222 MMMMaaaarrrrcccchhhh 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SSSSSYYYYSSSS((((5555))))



	  aaaallllllll,,,,!!!!llllooooccccaaaallll will _n_o_t prevent local articles from being	sent
	  unless they contain explicit DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn:::: llllooooccccaaaallll lines.
	  Note too that	the distribution ``world'' must	be permitted
	  (perhaps by the distribution ``all'')	in order to feed
	  DDDDiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn::::-less articles (the common case)	to a site.

	  The _f_l_a_g_s are	a set of letters describing how	the article
	  should be transmitted.  Valid	flags include ffff	(interpret
	  _t_r_a_n_s_m_i_s_s_i_o_n _c_o_m_m_a_n_d as a file name and write	the article's
	  file name relative to	////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss	and size in bytes on
	  the end of it), FFFF (like ffff but	omit the size),	IIII (like	FFFF but
	  write	Message-ID:s instead of	filenames), nnnn (like FFFF but
	  write	a Message-ID: after each filename), LLLL_n (only send
	  articles generated within _n hops of here; 0 is the default
	  value	for _n),	mmmm (transmit only moderated groups), uuuu
	  (transmit only unmoderated groups).  There are other
	  obsolete ones.

	  The _t_r_a_n_s_m_i_s_s_i_o_n _c_o_m_m_a_n_d is executed by the shell with the
	  article to be	transmitted as the standard input.  The
	  substring `%%%%ssss' will be replaced at most once per command
	  with the name	of a file containing the article, relative to
	  ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss (`%%%%%%%%'	is replaced by `%%%%').  The default is
	  `uuuuuuuuxxxx ---- ----zzzz ----rrrr _s_y_s_n_a_m_e!!!!rrrrnnnneeeewwwwssss' for a command; the PATH searched
	  includes ////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////rrrreeeellllaaaayyyy, so that the commands
	  described in _n_e_w_s_m_a_i_l(8) are available as alternatives to
	  _u_u_x.	If one of the _f_l_a_g_s has	caused this field to be	taken
	  as a filename, the default is
	  ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg////_s_y_s_n_a_m_e////ttttooooggggoooo; if a filename	is
	  given	but it does not	start with `/',	it is assumed to be
	  relative to the ////uuuussssrrrr////ssssppppoooooooollll////nnnneeeewwwwssss////oooouuuutttt....ggggooooiiiinnnngggg directory.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
	  A complex _s_y_s	file.

	       #### lllliiiinnnneeee iiiinnnnddddiiiiccccaaaattttiiiinnnngggg wwwwhhhhaaaatttt wwwweeee aaaarrrreeee wwwwiiiilllllllliiiinnnngggg ttttoooo	rrrreeeecccceeeeiiiivvvveeee;;;; nnnnooootttteeee llllooooccccaaaallll ggggrrrroooouuuuppppssss nnnneeeeaaaarrrr	eeeennnndddd
	       MMMMEEEE::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ccccaaaannnn,,,,oooonnnntttt,,,,ttttoooorrrr,,,,uuuutttt,,,,ttttoooo
	       #### ssssaaaammmmpppplllleeee	iiiinnnnssssiiiiggggnnnniiiiffffiiiiccccaaaannnntttt ffffeeeeeeeedddd nnnnooootttt uuuussssiiiinnnngggg bbbbaaaattttcccchhhhiiiinnnngggg ((((ffffoooorrrr ssssppppeeeecccciiiiaaaallll ssssiiiittttuuuuaaaattttiiiioooonnnnssss oooonnnnllllyyyy))))
	       hhhhuuuueeeeyyyy::::nnnneeeewwwwssss....ccccoooonnnnffffiiiigggg,,,,ttttoooo....hhhhuuuueeeeyyyy////aaaallllllll::::::::uuuuuuuuxxxx ---- ----rrrr ----ggggdddd hhhhuuuueeeeyyyy!!!!rrrrnnnneeeewwwwssss
	       #### ssssaaaammmmpppplllleeee	ooooffff mmmmaaaaiiiilllliiiinnnngggg nnnneeeewwwwssssggggrrrroooouuuuppppssss ttttoooo ssssoooommmmeeeeoooonnnneeee ((((nnnnooootttteeee ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn))))
	       ddddaaaaiiiissssyyyy::::ssssoooocccc....wwwwoooommmmeeeennnn,,,,ssssoooocccc....ccccoooouuuupppplllleeeessss////aaaallllllll::::::::mmmmaaaaiiiillll ddddaaaaiiiissssyyyy@@@@dddduuuucccckkkk
	       #### ssssaaaammmmpppplllleeee	ssssmmmmaaaallllllll ffffeeeeeeeedddd uuuussssiiiinnnngggg bbbbaaaattttcccchhhhiiiinnnngggg
	       ggggllllaaaaddddssssttttoooonnnneeee::::ccccoooommmmpppp....pppprrrroooottttooooccccoooollllssss....ttttccccpppp----iiiipppp,,,,rrrreeeecccc....aaaavvvviiiiaaaattttiiiioooonnnn////aaaallllllll::::ffff::::
	       #### ssssaaaammmmpppplllleeee	mmmmaaaajjjjoooorrrr bbbbaaaattttcccchhhheeeedddd ffffeeeeeeeedddd,,,, iiiinnnncccclllluuuuddddiiiinnnngggg aaaassssssssoooorrrrtttteeeedddd rrrreeeeggggiiiioooonnnnaaaallll	nnnneeeewwwwssssggggrrrroooouuuuppppssss,,,, wwwwiiiitttthhhh
	       #### ((((uuuunnnnnnnneeeecccceeeessssssssaaaarrrryyyy)))) eeeexxxxpppplllliiiicccciiiitttt	ffffiiiilllleeee nnnnaaaammmmeeee
	       ddddeeeewwwweeeeyyyy::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ccccaaaannnn,,,,oooonnnntttt,,,,ttttoooorrrr,,,,uuuutttt,,,,ttttoooo....ddddeeeewwwweeeeyyyy////aaaallllllll::::ffff::::ddddeeeewwwweeeeyyyy////ttttooooggggoooo
	       #### ssssaaaammmmpppplllleeee	lllloooonnnngggg----hhhhaaaauuuullll ffffeeeeeeeedddd;;;;	nnnnooootttteeee nnnnoooo	rrrreeeeggggiiiioooonnnnaaaallll ggggrrrroooouuuuppppssss,,,, eeeexxxxcccclllluuuussssiiiioooonnnn ooooffff aaaa	llllooooccccaaaallll
	       #### ddddiiiissssttttrrrriiiibbbbuuuuttttiiiioooonnnn,,,, aaaannnndddd eeeexxxxcccclllluuuussssiiiioooonnnn ooooffff	aaaannnnyyyytttthhhhiiiinnnngggg tttthhhhaaaatttt ppppaaaasssssssseeeedddd tttthhhhrrrroooouuuugggghhhh hhhhiiiimmmm uuuunnnnddddeeeerrrr
	       #### aaaannnnooootttthhhheeeerrrr nnnnaaaammmmeeee ((((nnnneeeeeeeeddddeeeedddd bbbbeeeeccccaaaauuuusssseeee hhhheeee ppppuuuuttttssss tttthhhhaaaatttt ffffoooorrrrmmmm,,,, nnnnooootttt jjjjuuuusssstttt """"ddddoooonnnnaaaalllldddd"""",,,, iiiinnnn
	       #### hhhhiiiissss PPPPaaaatttthhhh lllliiiinnnneeeessss))))
	       ddddoooonnnnaaaalllldddd////ddddoooonnnnaaaalllldddd....aaaannnnggggrrrryyyy....dddduuuucccckkkk::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ttttoooo....ddddoooonnnnaaaalllldddd////aaaallllllll,,,,!!!!uuuutttt::::ffff::::
	       #### ssssaaaammmmpppplllleeee	llllooooccccaaaallll----ppppoooossssttttiiiinnnnggggssss----oooonnnnllllyyyy ffffeeeeeeeedddd ddddiiiirrrreeeecccctttt	ttttoooo mmmmaaaajjjjoooorrrr ssssiiiitttteeee ((((ggggeeeettttssss tttthhhheeeemmmm oooouuuutttt ffffaaaasssstttt))))



     Page 3					      (printed 6/4/94)






     NNNNEEEEWWWWSSSSSSSSYYYYSSSS((((5555))))		 XXXXEEEENNNNIIIIXXXX 3333....0000 ((((2222 MMMMaaaarrrrcccchhhh 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SSSSSYYYYSSSS((((5555))))



	       ssssccccrrrrooooooooggggeeee::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,ttttoooo....ssssccccrrrrooooooooggggeeee////aaaallllllll::::LLLLffff::::
	       #### ssssaaaammmmpppplllleeee	iiiihhhhaaaavvvveeee////sssseeeennnnddddmmmmeeee lllliiiinnnnkkkk
	       #### NNNNOOOOTTTTEEEE,,,, tttthhhhiiiissss iiiissss uuuuuuuuccccpppp iiiihhhhaaaavvvveeee////sssseeeennnnddddmmmmeeee,,,, nnnnooootttt rrrreeeellllaaaatttteeeedddd ttttoooo NNNNNNNNTTTTPPPP iiiinnnn aaaannnnyyyy wwwwaaaayyyy....
	       #### SSSSeeeennnndddd iiiihhhhaaaavvvveeee tttteeeelllllllliiiinnnngggg lllloooouuuuiiiieeee wwwwhhhhaaaatttt wwwweeee hhhhaaaavvvveeee -------- bbbbaaaattttcccchhhheeeerrrr ttttuuuurrrrnnnnssss	tttthhhheeee bbbbaaaattttcccchhhh iiiinnnnttttoooo aaaa
	       #### ggggiiiiaaaannnntttt ccccoooonnnnttttrrrroooollll mmmmeeeessssssssaaaaggggeeee aaaannnndddd ppppoooossssttttssss iiiitttt ttttoooo """"ttttoooo....lllloooouuuuiiiieeee""""....
	       lllloooouuuuiiiieeee....wwwweeeehhhhaaaavvvveeee////lllloooouuuuiiiieeee::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,!!!!ttttoooo////aaaallllllll::::IIII::::
	       #### SSSSeeeennnndddd tttthhhheeee aaaaccccttttuuuuaaaallll ccccoooonnnnttttrrrroooollll mmmmeeeessssssssaaaaggggeeeessss
	       lllloooouuuuiiiieeee::::ttttoooo....lllloooouuuuiiiieeee////aaaallllllll::::ffff::::
	       #### AAAAllllssssoooo,,,, ssssiiiinnnncccceeee iiiihhhhaaaavvvveeee////sssseeeennnnddddmmmmeeee iiiissss sssslllloooowwww,,,, sssseeeennnndddd	llllooooccccaaaallll ppppoooossssttttiiiinnnnggggssss ttttoooo lllloooouuuuiiiieeee	wwwwiiiitttthhhhoooouuuutttt
	       #### wwwwaaaaiiiittttiiiinnnngggg ffffoooorrrr iiiihhhhaaaavvvveeee////sssseeeennnnddddmmmmeeee
	       lllloooouuuuiiiieeee::::ccccoooommmmpppp,,,,nnnneeeewwwwssss,,,,sssscccciiii,,,,rrrreeeecccc,,,,mmmmiiiisssscccc,,,,ssssoooocccc,,,,ttttaaaallllkkkk,,,,!!!!ttttoooo////aaaallllllll::::LLLLffff::::

	  (The ``to._s_y_s_n_a_m_e'' groups are normal	newsgroups used	for
	  testing individual news feeds	and conveying ihave/sendme
	  messages.)

     FFFFIIIILLLLEEEES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s////ssssyyyyssss

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
	  _r_e_l_a_y_n_e_w_s(8)

     HHHHIIIISSSSTTTTOOOORRRRYYYY
	  Written by Geoff Collyer and Henry Spencer for the C News
	  project.

     BBBBUUUUGGGGSSSS
	  The flags field is a bit of mess: there are too many
	  formatting flags and they aren't orthogonal.


























     Page 4					      (printed 6/4/94)



