![[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] / 43BSD / contrib / news / man|
Return to news.5 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / 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 "January 17, 1986"
13: .ds ]W Version B 2.10.3
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:
95: The body of the article comes here, after a blank line.
96: .fi
97: .in
98: .LP
99: The
100: .I sys
101: file line has four fields, each separated by colons:
102: .LP
103: .IB system-name : subscriptions :\c
104: .IB flags : "transmission command"
105: .PP
106: Of these fields, only the
107: .IR system-name " and " subscriptions " need"
108: to be present.
109: .PP
110: The
111: .I system name
112: is the name of the system being sent to. The
113: .I subscriptions
114: is the list of newsgroups to be transmitted to the system. The
115: .I flags
116: are a set of letters describing how the article should be transmitted.
117: The default is
118: .BR B \&.
119: Valid flags include
120: .B A
121: (send in
122: .B A
123: format),
124: .B B
125: (send in
126: .B B
127: format),
128: .B N
129: (use \*(Lqihave/sendme\*(Rq protocol),
130: .B U
131: (use \*(Lquux \-c\*(Rq and the name of the stored article in a \*(Lq%s\*(Rq
132: string).
133: .LP
134: The
135: .I transmission command
136: is executed by the shell with the article to be transmitted as the standard
137: input.
138: The default is
139: .RI "\*(Lquux \- \-z \-r " sysname !rnews\*(Rq.
140: Some examples:
141: .LP
142: .if n \{.in -2
143: . ll +3\}
144: .B "xyz:net"
145: .br
146: .B "oldsys:net,mod,to.oldsys:A"
147: .br
148: .B "berksys:net,ucb::/usr/lib/news/sendnews \-b berksys\\:rnews"
149: .br
150: .B "arpasys:net,arpa::/usr/lib/news/sendnews \-a rnews@arpasys"
151: .br
152: .B "old2:net,mod:A:/usr/lib/sendnews \-o old2\\:rnews"
153: .br
154: .B "user:net.sf-lovers::mail user"
155: .LP
156: Somewhere in the
157: .I sys
158: file, there must be a line for the host system. This line has no
159: .IR flags " or " commands .
160: A
161: .Ch #
162: as the first character in a line denotes a comment.
163: .LP
164: The
165: .IR history ,
166: .IR active ,
167: and
168: .I ngfile
169: files have one line per item.
170: .SH SEE ALSO
171: checknews(1),
172: inews(1),
173: postnews(1),
174: readnews(1),
175: vnews(1),
176: getdate(3),
177: expire(8),
178: recnews(8),
179: sendnews(8),
180: uurec(8)
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.