![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to news.5 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSDTahoe / new / news / man|
Return to news.5 CVS log | Up to [CSRG BSD Unix] / 43BSDTahoe / new / news / man |
1.1 root 1: .if n .ds La '
2: .if n .ds Ra '
3: .if t .ds La `
4: .if t .ds Ra '
5: .if n .ds Lq "
6: .if n .ds Rq "
7: .if t .ds Lq ``
8: .if t .ds Rq ''
9: .de Ch
10: \\$3\\*(Lq\\$1\\*(Rq\\$2
11: ..
12: .TH NEWS 5 "July 5, 1986"
13: .ds ]W Version B 2.11
14: .SH NAME
15: news \- USENET network news article, utility files
16: .SH DESCRIPTION
17: .PP
18: There are two formats of news articles:
19: .BR A " and " B.
20: .B A
21: format is the only format that version 1 netnews systems can read or write.
22: Systems running the version 2 netnews can read either format and there
23: are provisions for the version 2 netnews to write in
24: .BR A " format. " A " format"
25: looks like this:
26: .LP
27: .BI A article-ID
28: .br
29: .I newsgroups
30: .br
31: .I path
32: .br
33: .I date
34: .br
35: .I title
36: .br
37: .I Body of article
38: .br
39: .LP
40: Only version 2 netnews systems can read and write
41: .BR B " format. " B " format"
42: contains two extra pieces of information: receipt date and expiration
43: date. The basic structure of a
44: .B B
45: format file consists of a series of headers and then the body. A header
46: field is defined as a line with a capital letter in the first column and
47: a colon somewhere on the line. Unrecognized header fields are ignored.
48: News is stored in the same format transmitted, see
49: .I "Standard for the Interchange of USENET Messages"
50: for a full description.
51: The following fields are among those recognized:
52: .LP
53: .B From:
54: .IB user @ "host.domain[.domain ...]" " ("
55: .IB "Full Name" )
56: .br
57: .B Newsgroups:
58: .I Newsgroups
59: .br
60: .B Message-ID:
61: .BI < "Unique Identifier" >
62: .br
63: .B Subject:
64: .I descriptive title
65: .br
66: .B Date:
67: .I Date Posted
68: .br
69: .B Expires:
70: .I Expiration Date
71: .br
72: .B Reply-To:
73: .I Address for mail replies
74: .br
75: .B References:
76: .IR "Article ID of article this is a follow-up to" .
77: .br
78: .B Control:
79: .I Text of a control message
80: .LP
81: Here is an example of an article:
82: .LP
83: .in +10n
84: .nf
85: Path: cbosgd!mhuxj!mhuxt!eagle!jerry
86: From: [email protected] (Jerry Schwarz)
87: Newsgroups: net.general
88: Subject: Usenet Etiquette -- Please Read
89: Message-ID: <[email protected]>
90: Date: Friday, 19 Nov 82 16:14:55 EST
91: Followup-To: net.news
92: Expires: Saturday, 1 Jan 83 00:00:00 EST
93: Organization: Bell Labs, Murray Hill
94: Lines: 42
95:
96: The body of the article comes here, after a blank line.
97: .fi
98: .in
99: .LP
100: The
101: .I sys
102: file line has four fields, each separated by colons:
103: .LP
104: .IB system-name : subscriptions :\c
105: .IB flags : "transmission command"
106: .PP
107: Of these fields, only the
108: .IR system-name " and " subscriptions " need"
109: to be present.
110: .PP
111: The
112: .I system name
113: is the name of the system being sent to. The
114: .I subscriptions
115: is the list of newsgroups to be transmitted to the system. The
116: .I flags
117: are a set of letters describing how the article should be transmitted.
118: The default is
119: .BR B \&.
120: Valid flags include
121: .B A
122: (send in
123: .B A
124: format),
125: .B B
126: (send in
127: .B B
128: format),
129: .B N
130: (use \*(Lqihave/sendme\*(Rq protocol),
131: .B U
132: (use \*(Lquux \-c\*(Rq and the name of the stored article in a \*(Lq%s\*(Rq
133: string).
134: .LP
135: The
136: .I transmission command
137: is executed by the shell with the article to be transmitted as the standard
138: input.
139: The default is
140: .RI "\*(Lquux \- \-z \-r " sysname !rnews\*(Rq.
141: Some examples:
142: .LP
143: .if n \{.in -2
144: . ll +3\}
145: .B "xyz:net"
146: .br
147: .B "oldsys:net,mod,to.oldsys:A"
148: .br
149: .B "berksys:net,ucb::/usr/lib/news/sendnews \-b berksys\\:rnews"
150: .br
151: .B "arpasys:net,arpa::/usr/lib/news/sendnews \-a rnews@arpasys"
152: .br
153: .B "old2:net,mod:A:/usr/lib/sendnews \-o old2\\:rnews"
154: .br
155: .B "user:net.sf-lovers::mail user"
156: .LP
157: Somewhere in the
158: .I sys
159: file, there must be a line for the host system. This line has no
160: .IR flags " or " commands .
161: A
162: .Ch #
163: as the first character in a line denotes a comment.
164: A logical line may be continued to the next physical line by
165: putting a \\ at end of the line.
166: .LP
167: The
168: .IR history ,
169: .IR active ,
170: and
171: .I ngfile
172: files have one line per item.
173: .SH SEE ALSO
174: checknews(1),
175: inews(8),
176: postnews(1),
177: readnews(1),
178: vnews(1),
179: getdate(3),
180: expire(8),
181: recnews(8),
182: sendnews(8),
183: uurec(8)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.