|o||words 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 all 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 .all as many times as necessary;|
|o||if the newsgroup has fewer words than the pattern, the newsgroup does not match the pattern;|
|o||if pattern matches a newsgroup, !pattern mismatches that newsgroup.|
|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 all counted as slightly less than one word, and does not include the implicit extension of patterns with .all).|
The distributions in the Distribution: header are similarly matched against the distributions subfield, if any. If no distributions are supplied, Distribution: will be matched against the subscriptions instead. (The Distribution: 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 distributions list like all,!local will not prevent local articles from being sent unless they contain explicit Distribution: local lines. Note too that the distribution world must be permitted (perhaps by the distribution all) in order to feed Distribution:-less articles (the common case) to a site.
The flags are a set of letters describing how the article should be transmitted. Valid flags include f (interpret transmission command as a file name and write the articles file name relative to /var/news and size in bytes on the end of it), F (like f but omit the size), I (like F but write Message-ID:s instead of filenames), n (like F but write a Message-ID: after each filename), Ln (only send articles generated within n hops of here; 0 is the default value for n), m (transmit only moderated groups), u (transmit only unmoderated groups). There are other obsolete ones.
The transmission command is executed by the shell with the article to be transmitted as the standard input. The substring %s will be replaced at most once per command with the name of a file containing the article, relative to /var/news ( %% is replaced by %). The default is uux - -z -r sysname!rnews for a command; the PATH searched includes /usr/local/libexec/cnews/relay, so that the commands described in newsmail(8) are available as alternatives to uux. If one of the flags has caused this field to be taken as a filename, the default is /var/news/out.going/sysname/togo ; if a filename is given but it does not start with /, it is assumed to be relative to the /var/news/out.going directory.
A complex sys file.
# line indicating what we are willing to receive; note local groups near end ME:comp,news,sci,rec,misc,soc,talk,can,ont,tor,ut,to
# sample insignificant feed not using batching (for special situations only) huey:news.config,to.huey/all::uux - -r -gd huey!rnews
# sample of mailing newsgroups to someone (note distribution) daisy:soc.women,soc.couples/all::mail daisy@duck
# sample small feed using batching gladstone:comp.protocols.tcp-ip,rec.aviation/all:f:
# sample major batched feed, including assorted regional newsgroups, with # (unnecessary) explicit file name dewey:comp,news,sci,rec,misc,soc,talk,can,ont,tor,ut,to.dewey/all:f:dewey/togo
# sample long-haul feed; note no regional groups, exclusion of a local # distribution, and exclusion of anything that passed through him under # another name (needed because he puts that form, not just "donald", in # his Path lines) donald/donald.angry.duck:comp,news,sci,rec,misc,soc,talk,to.donald/all,!ut:f:
# sample local-postings-only feed direct to major site (gets them out fast) scrooge:comp,news,sci,rec,misc,soc,talk,to.scrooge/all:Lf:
# sample ihave/sendme link # NOTE, this is uucp ihave/sendme, not related to NNTP in any way. # Send ihave telling louie what we have -- batcher turns the batch into a # giant control message and posts it to "to.louie". louie.wehave/louie:comp,news,sci,rec,misc,soc,talk,!to/all:I: # Send the actual control messages louie:to.louie/all:f:
# Also, since ihave/sendme is slow, send local postings to louie without # waiting for ihave/sendme louie:comp,news,sci,rec,misc,soc,talk,!to/all:Lf:
# for a site we feed with snntp zaphod.mps.ohio-state.edu:all:n:/var/news/out.nntp/zaphod.mps.ohio-state.edu
(The to.sysname groups are normal newsgroups used for testing individual news feeds and conveying ihave/sendme messages.)
Written by Geoff Collyer and Henry Spencer for the C News project.
The flags field is a bit of mess: there are too many formatting flags and they arent orthogonal.
|-->||NEWSSYS (5)||9 Sept 1994|