|
|
1.1 root 1: .TH NEWS 5
2: .SH NAME
3: news \- USENET network news article, utility files
4: .SH DESCRIPTION
5: .PP
6: There are two formats of news articles:
7: .BR A " and " B.
8: .B A
9: format is the only format that version 1 netnews systems can read or write.
10: Systems running the version 2 netnews can read either format and there
11: are provisions for the version 2 netnews to write in
12: .BR A " format. " A " format"
13: looks like this:
14: .LP
15: .BI A article-ID
16: .br
17: .I newsgroups
18: .br
19: .I path
20: .br
21: .I date
22: .br
23: .I title
24: .br
25: .I Body of article
26: .br
27: .LP
28: Only version 2 netnews systems can read and write
29: .BR B " format. " B " format"
30: contains two extra pieces of information: receival date and expiration
31: date. The basic structure of a
32: .B B
33: format file consists of a series of headers and then the body. A header
34: field is defined as a line with a capital letter in the 1st column and
35: a colon somewhere on the line. Unrecognized header fields are ignored.
36: News is stored in the same format transmitted, see ``Standard for the
37: Interchange of USENET Messages'' for a full description.
38: The following fields are among those recognized:
39: .TP 15
40: Header
41: Information
42: .TP 15
43: .B From:
44: .I [email protected][.domain ...] (Full Name)
45: .TP 15
46: .B Newsgroups:
47: .I Newsgroups
48: .TP 15
49: .B Message-ID:
50: .I <Unique Identifier>
51: .TP 15
52: .B Subject:
53: .I descriptive title
54: .TP 15
55: .B Date:
56: .I Date Posted
57: .TP 15
58: .B Date-Received:
59: .I Date received on local machine
60: .TP 15
61: .B Expires:
62: .I Expiration Date
63: .TP 15
64: .B Reply-To:
65: .I Address for mail replies
66: .TP 15
67: .B References:
68: .I Article ID of article this is a follow-up to.
69: .TP 15
70: .B Control:
71: .I Text of a control message
72: .LP
73: Here is an example of an article:
74: .LP
75: .nf
76: Relay-Version: B 2.10 2/13/83 cbosgd.UUCP
77: Posting-Version: B 2.10 2/13/83 eagle.UUCP
78: Path: cbosgd!mhuxj!mhuxt!eagle!jerry
79: From: [email protected] (Jerry Schwarz)
80: Newsgroups: net.general
81: Subject: Usenet Etiquette -- Please Read
82: Message-ID: <[email protected]>
83: Date: Friday, 19-Nov-82 16:14:55 EST
84: Followup-To: net.news
85: Expires: Saturday, 1-Jan-83 00:00:00 EST
86: Date-Received: Friday, 19-Nov-82 16:59:30 EST
87: Organization: Bell Labs, Murray Hill
88:
89: The body of the article comes here, after a blank line.
90: .fi
91: .LP
92: A
93: .I sys
94: file line has four fields, each seperated by colons:
95: .LP
96: .I system-name:subscriptions:flags:transmission command
97: .PP
98: Of these fields, on the
99: .IR system-name " and " subscriptions " need"
100: to be present.
101: .PP
102: The
103: .I system name
104: is the name of the system being sent to. The
105: .I subscriptions
106: is the list of newsgroups to be transmitted to the system. The
107: .I flags
108: are a set of letters describing how the article should be transmitted.
109: The default is B.
110: Valid flags include A (send in A format), B (send in B format),
111: N (use ihave/sendme protocol),
112: U (use uux -c and the name of the stored article in a %s string).
113: .LP
114: The
115: .I transmission command
116: is executed by the shell with the article to be transmitted as the standard
117: input.
118: The default is
119: .BI "uux \- \-z \-r " sysname !rnews.
120: Some examples:
121: .LP
122: .B "xyz:net.all"
123: .br
124: .B "oldsys:net.all,fa.all,to.oldsys:A"
125: .br
126: .B "berksys:net.all,ucb.all::/usr/lib/news/sendnews \-b berksys\\:rnews"
127: .br
128: .B "arpasys:net.all,arpa.all::/usr/lib/news/sendnews \-a rnews@arpasys"
129: .br
130: .B "old2:net.all,fa.all:A:/usr/lib/sendnews \-o old2\\:rnews"
131: .br
132: .B "user:fa.sf-lovers::mail user"
133: .LP
134: Somewhere in a
135: .I sys
136: file, there must be a line for the host system. This line has no
137: .IR flags " or " commands .
138: A # as the first character in a line denotes a comment.
139: .LP
140: The history, active, and ngfile files have one line per item.
141: .SH SEE ALSO
142: inews(1),
143: postnews(1),
144: sendnews(8),
145: uurec(8),
146: readnews(1)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.