home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 October / usenetsourcesnewsgroupsinfomagicoctober1994disk2.iso / unix / volume7 / 2.11news / part06 < prev    next >
Text File  |  1986-11-30  |  40KB  |  1,640 lines
  1. Subject:  v07i046:  2.11 News Documentation and Conversion, Part06/08
  2. Newsgroups: mod.sources
  3. Approved: mirror!rs
  4.  
  5. Submitted by: seismo!rick (Rick Adams)
  6. Mod.sources: Volume 7, Issue 46
  7. Archive-name: 2.11news/Part06
  8.  
  9. # To extract, sh this file
  10. #
  11. #    news 2.11 documentation File 4 of 6
  12. #
  13. if test ! -d doc
  14. then
  15.     mkdir doc
  16. fi
  17. echo x - doc/install.mn 1>&2
  18. sed 's/.//' >doc/install.mn <<'*-*-END-of-install.mn-*-*'
  19. -.ds h0 "USENET Version B Installation
  20. -.ds h1
  21. -.ds h2 %
  22. -.ds f0 "\*(vr
  23. -.ds f1
  24. -.ds f2 "October 27, 1986
  25. -.de Qp                    \" quoted command as hanging char
  26. -.lp "\\f3\\$1\\f1" \\$2
  27. -..
  28. -.mt
  29. -USENET Version B Installation
  30. -.au
  31. -Matt Glickman
  32. -.ai
  33. -Computer Science Division
  34. -Department of Electrical Engineering and Computer Sciences
  35. -University of California
  36. -Berkeley, California 94720
  37. -.au
  38. -Revised by Mark Horton for version 2.10
  39. -Revised by Rick Adams for version 2.11
  40. -.hn
  41. -Introduction
  42. -.pg
  43. -This document is intended to help
  44. -a USENET site install and maintain the network news software.
  45. -Please ask questions of Rick Adams\*(dg;
  46. -.fn
  47. -\*(dg ARPANET: rick@seismo.CSS.GOV, UUCP: seismo!rick
  48. -.ef
  49. -such questions will help to point out areas that need
  50. -to be addressed here.
  51. -.pg
  52. -The overall order of things to do is:
  53. -.lp (a)
  54. -Find somebody to link up with.
  55. -You need a network connection of some kind,
  56. -for example,
  57. -ARPANET or UUCP.
  58. -If you must use UUCP and have no connections,
  59. -you must have at least a dialup and preferably a dialer,
  60. -and find someone willing to call your machine.
  61. -The USENET directory may be helpful in finding some other site geographically
  62. -near yours to hook up to.
  63. -.lp (b)
  64. -Create a
  65. -.i localize.sh
  66. -script to make local changes to the makefile and
  67. -.i defs.h
  68. -files. (Section 2 gives more details about creating
  69. -.i localize.sh \&.)
  70. -Once you're finished editing
  71. -.i localize.sh ,
  72. -create a
  73. -.i defs.h
  74. -and
  75. -.i Makefile
  76. -tailored
  77. -for your site with the command
  78. -.ce
  79. -sh localize.sh
  80. -Inspect
  81. -.i defs.h
  82. -and
  83. -.i Makefile
  84. -to ensure that all your local customizations
  85. -got into your final versions. If you saw a \*(lq?\*(rq when you ran
  86. -.i localize.sh ,
  87. -one or both of the files is certainly wrong. It's a good idea to
  88. -anchor the patterns in
  89. -.i localize.sh \&'s
  90. -.i ed (1)
  91. -scripts, especially in its
  92. -.i Makefile -editing
  93. -lines. For instance, use
  94. -.b /^UUXFLAGS/
  95. -instead of
  96. -.b /UUXFLAGS/ .
  97. -.lp (c)
  98. -Compile the software using the
  99. -.i make (1)
  100. -command.
  101. -.lp (d)
  102. -.i Su (1)
  103. -and type \*(lqmake install\*(rq.
  104. -This will copy the files out to the right place and
  105. -make directories containing most of the important files.
  106. -It will configure you in with a connection to
  107. -.cn oopsvax
  108. -via UUCP links.
  109. -This is undoubtedly wrong,
  110. -so you will have to configure links as needed.
  111. -If this is your initial installation or you are upgrading from a version older
  112. -than 2.11, do \*(lqmake update\*(rq.
  113. -This will cause various checks to be performed on important
  114. -files in
  115. -.b LIBDIR .
  116. -The results will be reported to you.
  117. -If you are not sure if you should do \*(lqmake update\*(rq, do it.
  118. -It will not hurt anything if you have already done it.
  119. -.lp (e)
  120. -After editing the configuration table,
  121. -get your contact at the other end of the link to add you to their netnews
  122. -.i sys
  123. -file.
  124. -.lp (f)
  125. -Post a message to the
  126. -.bi sysname "" \f3to.\fP
  127. -newsgroup which should be set up to go only to the site you are linked to,
  128. -as a test.
  129. -Have the other person send a message to your system using the same mechanism.
  130. -If this doesn't work,
  131. -find the problem and fix it.
  132. -(Please don't use
  133. -.ng misc.test
  134. -unless there is no alternative.
  135. -It is almost always possible to use
  136. -.ng test ,
  137. -or
  138. -.bi sysname "" \f3to.\fP
  139. -or some
  140. -.bi local \f3.test\fP
  141. -group,
  142. -instead of
  143. -.ng misc.test .)
  144. -.lp (g)
  145. -Fill out a USENET directory form (the file
  146. -.i dirform
  147. -in the
  148. -.i misc
  149. -directory).
  150. -Post a copy to the USENET newsgroup
  151. -.ng news.newsite
  152. -and mail a copy to
  153. -.i cbosgd!uucpmap .
  154. -.lp (h)
  155. -Format the document
  156. -.i "\\*(lqHow to Read the Network News\\*(rq"
  157. -(the file
  158. -.i howto.mn
  159. -in the
  160. -.i doc
  161. -directory),
  162. -the document
  163. -.i "\\*(lqHow to Use USENET Effectively\\*(rq"
  164. -(the file
  165. -.i manner.mn
  166. -in the
  167. -.i doc
  168. -directory)
  169. -and the document
  170. -.i "\\*(lqCopyright Law\\*(rq"
  171. -(the file
  172. -.i copyright.mn
  173. -in the
  174. -.i doc
  175. -directory)
  176. -and post them to your
  177. -.ng general
  178. -newsgroup with a long expiration date.
  179. -You can use
  180. -.i inews (1)
  181. -or
  182. -.i postnews (1)
  183. -to do this.
  184. -.lp (i)
  185. -It will probably be necessary to fix your uucp commands
  186. -to allow
  187. -.i rnews
  188. -and to support the
  189. -.op \-z
  190. -and
  191. -.op \-n
  192. -options (if you are lucky enought to have the source).
  193. -.hn
  194. -Installation
  195. -.hn 2
  196. -Configuration
  197. -.pg
  198. -Local configuration of the USENET
  199. -version B software requires you to edit a few files.
  200. -Most importantly,
  201. -the
  202. -.i defs.h
  203. -and
  204. -.i Makefile
  205. -files must be created from their templates
  206. -.i defs.dist
  207. -and
  208. -.i Makefile.dst .
  209. -You should create a shell script called
  210. -.i localize.sh
  211. -which copies the files and makes local changes to the copies.
  212. -Even for a completely vanilla site,
  213. -some changes will be necessary.
  214. -For example,
  215. -your script should start with
  216. -.i localize.v7
  217. -or
  218. -.i localize.usg .
  219. -You should include the name of the local organization
  220. -.b MYORG ) (
  221. -and the uid of the local news super user
  222. -.b ROOTID ). (
  223. -You should also choose how your hostname will be determined.
  224. -If you are a USG site,
  225. -define
  226. -.b UNAME
  227. -in
  228. -.i defs.h .
  229. -If you are
  230. -running 4.[23] BSD,
  231. -define
  232. -.b GHNAME
  233. -in
  234. -.i defs.h .
  235. -If you have your UUCP name in a file,
  236. -define
  237. -.b UUNAME
  238. -in
  239. -.i defs.h 
  240. -to the name of that file.
  241. -Otherwise,
  242. -news will look in the file
  243. -.i /usr/include/whoami.h
  244. -for a line of the form
  245. -.sd c
  246. -#define sysname your-sysname
  247. -.ed
  248. -.pg
  249. -If you are running System 3 or System 5,
  250. -you are a USG site.
  251. -Otherwise,
  252. -unless you are in AT&T,
  253. -you are probably a V7 site.
  254. -The previously mentioned defines are the only modifications that are
  255. -.i necessary
  256. -to install news at your site.
  257. -However,
  258. -you will probably want to change some of the ones listed below.
  259. -If your compiler does not accept \*(lq(void)\*(rq,
  260. -the simplest thing to do is add \*(lq\-Dvoid=int\*(rq to the
  261. -.b CFLAGS
  262. -line in the
  263. -.i Makefile .
  264. -.pg
  265. -A sample localize shell script can be found in
  266. -.i localize.sample .
  267. -The most important parameters are:
  268. -.hn 3
  269. -ROOTID
  270. -.pg
  271. -The numerical uid of the person who is the news super user.
  272. -This should not be set to 0.
  273. -Normally it is set to the uid of the news contact person for the site.
  274. -If it is not defined,
  275. -the uid of
  276. -.b NOTIFY
  277. -will be looked up in
  278. -.i /etc/passwd
  279. -and used instead.
  280. -.hn 3
  281. -N_UMASK
  282. -.pg
  283. -Mask for
  284. -.i umask (2)
  285. -system call.
  286. -Set it to something like 022 for a secure system.
  287. -Unsecure systems might want 002 or 000.
  288. -This mask controls the mode of news files created by the software.
  289. -Insecure modes would allow people to edit the files directly.
  290. -.hn 3
  291. -DFLTEXP
  292. -.pg
  293. -The default number of seconds after which an article will expire.
  294. -Two weeks (1,209,600 seconds) is the default choice.
  295. -If you wish to expire articles faster than two weeks,
  296. -it is recommended that you use the
  297. -.op \-e
  298. -flag to expire instead of decreasing
  299. -.b DFLTEXP .
  300. -.hn 3
  301. -HISTEXP
  302. -.pg
  303. -Articles which were posted more than
  304. -.b HISTEXP
  305. -ago are considered too old and are moved into the
  306. -.ng junk
  307. -directory.
  308. -This is because they are too old to be in the history file,
  309. -so it is impossible to tell if they really should be accepted
  310. -or are endlessly looping around the network.
  311. -(This was theoretically possible before this feature was added.)
  312. -The articles are removed after
  313. -.b DFLTEXP
  314. -seconds,
  315. -but a copy of their
  316. -.hf Message-ID
  317. -is kept in the history file for
  318. -.b HISTEXP
  319. -seconds (the default is 4 weeks).
  320. -If you are a
  321. -.i leaf
  322. -node, you do not need to have 
  323. -.b HISTEXP
  324. -longer than 
  325. -.b DFLTEXP .
  326. -However, major nodes with more than one news feed should have 
  327. -.b HISTEXP
  328. -set to the default 4 weeks if possible.
  329. -
  330. -.hn 3
  331. -DFLTSUB
  332. -.pg
  333. -The default subscription list.
  334. -If a user does not specify any list of newsgroups,
  335. -this will be used.
  336. -Popular choices are
  337. -.ng all
  338. -and
  339. -.ng general\f1,\fPall.general .
  340. -.hn 3
  341. -TMAIL
  342. -.pg
  343. -This is the version of the Berkeley
  344. -.i Mail (1)
  345. -program that has the
  346. -.op \-T
  347. -option.
  348. -If left undefined,
  349. -the
  350. -.op \-M
  351. -option to
  352. -.i readnews (1)
  353. -will be disabled.
  354. -.hn 3
  355. -ADMSUB
  356. -.pg
  357. -This newsgroup (or newsgroup list) will always be selected
  358. -unless the user specifies a newsgroup list that doesn't include
  359. -.b ADMSUB
  360. -on the command line.
  361. -That is,
  362. -as long as the user doesn't use the
  363. -.op \-n
  364. -flag to
  365. -.i readnews
  366. -on the command line,
  367. -.b ADMSUB
  368. -will always be selected.
  369. -This is usually set to
  370. -.ng general,all.announce .
  371. -(The intent of this parameter is to have certain newsgroups
  372. -which users are required to subscribe to.
  373. -A typical site might require
  374. -.op general .)
  375. -.hn 3
  376. -PAGE
  377. -.pg
  378. -The default program to which articles should be piped for paging.
  379. -This can be disabled or changed by the environment variable
  380. -.b PAGER .
  381. -If you have it,
  382. -the Berkeley
  383. -.i more (1)
  384. -command should be used,
  385. -since the
  386. -.op +
  387. -option allows the headers to be skipped.
  388. -.hn 3
  389. -NOTIFY
  390. -.pg
  391. -If defined,
  392. -this character string will be used as a user name to send mail
  393. -to in the event of certain control messages of interest.
  394. -(Currently these are
  395. -.b newgroup ,
  396. -.b rmgroup ,
  397. -.b sendsys ,
  398. -.b checkgroups ,
  399. -and
  400. -.b senduuname .)
  401. -As distributed,
  402. -mail will be sent to user
  403. -.i usenet .
  404. -It is recommended you create such a mailbox
  405. -(have it forwarded to yourself) if possible,
  406. -since this makes it easier for another site
  407. -to contact the site administrator for your site.
  408. -If you are unable to do this
  409. -.i e\f1.\fPg ., (
  410. -you are not the super user)
  411. -you should change this name to yourself.
  412. -Also,
  413. -messages about missing or extra newsgroups are mailed to this user
  414. -by the
  415. -.b checkgroups
  416. -control message.
  417. -.hn 3
  418. -DFTXMIT
  419. -.pg
  420. -This is the default command to use to transmit news
  421. -if no explicit command is given in the fourth field of the
  422. -.i sys
  423. -file.
  424. -It normally includes
  425. -.i uux (1)
  426. -with the
  427. -.op \-z
  428. -option.
  429. -You should install this modification to UUCP at once;
  430. -otherwise your users will be bombarded with annoying
  431. -.i uux
  432. -completion messages.
  433. -However,
  434. -you can turn this off to get news installed.
  435. -.hn 3
  436. -UXMIT
  437. -.pg
  438. -This is the default command used if the
  439. -.b U
  440. -flag is present in the flags portion of a
  441. -.i sys
  442. -file line.
  443. -In this case,
  444. -the second \*(lq%s\*(rq refers to the name of a file in the news spool area,
  445. -not a temporary file.
  446. -It can usually only be used
  447. -when local modifications are made to the uucp system,
  448. -such as the
  449. -.op \-c
  450. -option to
  451. -.i uux .
  452. -.hn 3
  453. -DFTEDITOR
  454. -.pg
  455. -This is the full path name of the default editor to use
  456. -during followups and replies.
  457. -It should be set to the most popular text editor on your system.
  458. -As distributed,
  459. -.i vi (1)
  460. -is used.
  461. -.hn 3
  462. -UUPROG
  463. -.pg
  464. -If this is defined,
  465. -it will be used as a command to run when the
  466. -.b senduuname
  467. -control message is sent around.
  468. -Otherwise the command
  469. -.i uuname (1)
  470. -will be run.
  471. -Normally,
  472. -this program should be placed in
  473. -.b LIBDIR .
  474. -.hn 3
  475. -MANUALLY
  476. -.pg
  477. -If this is defined,
  478. -incoming
  479. -.b rmgroup
  480. -messages will not automatically remove the group.
  481. -News will instead mail a message to
  482. -.b NOTIFY
  483. -advising that the group should be removed.
  484. -If you define
  485. -.b MANUALLY ,
  486. -you should have
  487. -.b NOTIFY
  488. -defined.
  489. -.b MANUALLY
  490. -is defined by default to protect you against
  491. -accidental or malicious removal of an important newsgroup.
  492. -.hn 3
  493. -NONEWGROUPS
  494. -.pg
  495. -If this is defined, incoming
  496. -.b newgroup
  497. -messages will not automatically create the group.
  498. -News will instead mail a message to
  499. -.b NOTIFY
  500. -advising that the group should be created.
  501. -If you define
  502. -.b NONEWGROUPS ,
  503. -you should have
  504. -.b NOTIFY
  505. -defined.
  506. -.b NONEWGROUPS
  507. -is undefined by default to make it easier to automatically maintain the
  508. -news system.
  509. -.hn 3
  510. -BATCH
  511. -.pg
  512. -If set,
  513. -this is the name of a program that will be used to unpack
  514. -batched articles (those beginning with the character \*(lq#\*(rq).
  515. -Batched articles normally are files reading
  516. -.sd c
  517. -#! rnews 1234
  518. -article containing 1234 characters
  519. -#! rnews 4321
  520. -article containing 4321 characters
  521. -\\&. . .
  522. -.ed
  523. -Batching is
  524. -.i strongly
  525. -recommended for increased efficiency on both sides.
  526. -.hn 3
  527. -SPOOLNEWS
  528. -.pg
  529. -If this is defined, all incoming news
  530. -.i inews "" (
  531. -or
  532. -.i rnews )
  533. -will be placed in the directory
  534. -.b SPOOLDIR \f2/.rnews\fP
  535. -for later processing by
  536. -.i "rnews \-U" .
  537. -This is useful when you want to appear to accept incoming news
  538. -as soon as it arrives (to get it out of the
  539. -.i uuxqt
  540. -queue for example), but want to defer the actual processing until
  541. -later. If you define this option, make sure you invoke
  542. -.i "rnews \-U"
  543. -from 
  544. -.i crontab
  545. -regularly or you may wonder where your news is going!
  546. -.hn 3
  547. -LOCALNAME
  548. -.pg
  549. -Most systems have a full name database on line somewhere,
  550. -showing for each user what their full name is.
  551. -Most often this is in the gecos field of
  552. -.i /etc/passwd .
  553. -If your system has such a database,
  554. -.b LOCALNAME
  555. -should be left undefined.
  556. -If not,
  557. -define
  558. -.b LOCALNAME ,
  559. -and articles posted will only receive full names from local user information
  560. -specified in
  561. -.i NAME
  562. -or
  563. -.bi $HOME \f2/.name\fP
  564. -by the user.
  565. -If you have a nonstandard gcos format
  566. -(not
  567. -.i finger (1)
  568. -or RJE)
  569. -it will be necessary to make local changes to
  570. -.i fullname.c
  571. -as appropriate on your system.
  572. -.hn 3
  573. -INTERNET
  574. -.pg
  575. -If this is defined, replies will use the
  576. -.hf "From"
  577. -or
  578. -.hf "Reply-To"
  579. -headers of the news article.
  580. -Otherwise,
  581. -leave it disabled and replies will use the
  582. -.hf "Path"
  583. -header.
  584. -.pg
  585. -You can define this option even if your site does not understand
  586. -internet style headers. The file
  587. -.b LIBDIR \f2/mailpaths\fP
  588. -contains a line beginning with \*(lqinternet\*(rq.
  589. -The rest of this line is a string for printf to use to route your
  590. -mail to a site that does understand internet style headers. If your site
  591. -understands internet style headers, this string would just be \*(lq%s\*(rq.
  592. -If not, it might look like \*(lqseismo!%s\*(rq if
  593. -.i seismo
  594. -was your nearest site that understands that format.
  595. -.hn 3
  596. -MYDOMAIN
  597. -.pg
  598. -When generating internet addresses,
  599. -this domain will be appended to the local site name
  600. -to form mailing address domains.
  601. -For example,
  602. -on system
  603. -.cn ucbvax
  604. -with user
  605. -.i root ,
  606. -if
  607. -.b MYDOMAIN
  608. -is set to
  609. -.cf .UUCP ,
  610. -addresses generated will read
  611. -.cf root@ucbvax.UUCP .
  612. -If
  613. -.b MYDOMAIN
  614. -is
  615. -.cf .Berkeley.EDU ,
  616. -the address would be
  617. -.cf root@ucbvax.Berkeley.EDU .
  618. -If your site is in more than one domain,
  619. -use your primary domain.
  620. -The domain always begins with a period. If your site name contains the
  621. -domain, everything after the first \*(lq.\*(rq will be stipped off to
  622. -get the news host name, so you still must define your domain name with 
  623. -.b MYDOMAIN .
  624. -.hn 3
  625. -CHEAP
  626. -.pg
  627. -Do not
  628. -.i chown (1)
  629. -spool files to
  630. -.i news .
  631. -This will cause the owner of the file to be the person that started
  632. -the
  633. -.i inews
  634. -process.
  635. -This is used for obscure accounting reasons on some systems.
  636. -.hn 3
  637. -OLD
  638. -.pg
  639. -Define this if any of your USENET neighbors run
  640. -2.9 or earlier versions of B news.
  641. -It will cause all headers written to contain two extra lines,
  642. -.hf Article-I.D.
  643. -and
  644. -.hf Posted ,
  645. -for downward compatibility.
  646. -Once all your neighbors have converted,
  647. -you can save disk space and transmission costs by turning this off.
  648. -It is strongly encouraged that they convert.
  649. -2.11 is
  650. -.i much
  651. -faster than 2.9.
  652. -The performance difference is dramatic.
  653. -.hn 3
  654. -UNAME
  655. -.pg
  656. -Define this if the
  657. -.i uname (2)
  658. -system call is available locally,
  659. -even though you are not a USG system.
  660. -USG systems always have
  661. -.i uname (2)
  662. -available and ignore this setting.
  663. -.hn 3
  664. -GHNAME
  665. -.pg
  666. -Define this if the 4.[23] BSD
  667. -.i gethostname (2)
  668. -system call is available.
  669. -If neither
  670. -.b UNAME
  671. -or
  672. -.b GHNAME
  673. -is defined,
  674. -.i inews
  675. -will determine the name of the local system by reading
  676. -.i /usr/include/whoami.h .
  677. -.hn 3
  678. -UUNAME
  679. -.pg
  680. -Define this to be the name of the file in which you store
  681. -your UUCP name. (If you store your UUCP name in a file.)
  682. -.hn 3
  683. -V7MAIL
  684. -.pg
  685. -Define this if your system uses V7 mail conventions.
  686. -The V7 mail convention is that
  687. -a mailbox contains several messages concatenated,
  688. -each message beginning with a line reading
  689. -.hf "From \f2user date\fP"
  690. -and ending in a blank line.
  691. -If this is defined,
  692. -articles saved will have these lines added
  693. -so that mail can be used to look at saved news.
  694. -.hn 3
  695. -SORTACTIVE
  696. -.pg
  697. -Define this if you want the news groups presented in the order of each person's
  698. -.i .newsrc (5)
  699. -instead of the 
  700. -.b active
  701. -file.
  702. -.hn 3
  703. -ZAPNOTES
  704. -.pg
  705. -Define this if you want old style notesfile id's in the body of the article
  706. -to be converted into
  707. -.hf Nf-ID
  708. -fields in the header and \*(lqOrphaned Responses\*(rq to be rejected.
  709. -.hn 3
  710. -DIGPAGE
  711. -.pg
  712. -If this is defined,
  713. -.i vnews (1)
  714. -will attempt to process the subarticles
  715. -of a digest instead of treating the article as one big file.
  716. -.hn 3
  717. -DOXREFS
  718. -.pg
  719. -Define this if you are using
  720. -.i rn (1).
  721. -.i Rn
  722. -uses this option to keep from showing the same article twice.
  723. -.hn 3
  724. -MULTICAST
  725. -.pg
  726. -If your transport mechanism supports multi-casting of messages,
  727. -define this.
  728. -Currently ACSNET is the only network that can handle this.
  729. -.hn 3
  730. -BSD4_2
  731. -.pg
  732. -Define this if you are running 4.2 or 4.3 BSD
  733. -.ux .
  734. -.hn 3
  735. -BSD4_1C
  736. -.pg
  737. -Define this if you are running 4.1C BSD
  738. -.ux .
  739. -.hn 3
  740. -LOCKF
  741. -.pg
  742. -Define this if your system supports the 
  743. -.i lockf ()
  744. -system call as defined in the 
  745. -.i "System V Interface Definition" .
  746. -Be warned, many System V 
  747. -.ux
  748. -systems do not comply with the 
  749. -.i SVID .
  750. -.pg
  751. -.hn 3
  752. -ALWAYSALIAS
  753. -.pg
  754. -Normally, the
  755. -.b LIBDIR \f2/aliases\fP
  756. -file is processed only for newsgroups that are not found in the 
  757. -.b LIBDIR \f2/active\fP
  758. -file. If this is defined, the 
  759. -.b LIBDIR \f2/aliases\fP
  760. -will  be checked for 
  761. -.b ALL
  762. -newsgroups. This is useful for a transition period when massive
  763. -newsgroup renaming is occurring, but should normally be undefined as
  764. -it is computationally expensive.
  765. -.hn 3
  766. -SENDMAIL
  767. -.pg
  768. -Use this program instead of
  769. -.i recmail (8)
  770. -for sending mail.
  771. -.hn 3
  772. -MMDF
  773. -.pg
  774. -Use MMDF instead of
  775. -.i recmail
  776. -for sending mail.
  777. -.hn 3
  778. -MYORG
  779. -.pg
  780. -This should be set to the name of your organization.
  781. -Please keep the name short,
  782. -because it will be printed,
  783. -along with the electronic address and full name of the author of each message.
  784. -Forty characters is probably a good upper bound on the length.
  785. -If the city and state or country of your organization are not obvious,
  786. -please try to include them.
  787. -If the organization name begins with a \*(lq/\*(rq,
  788. -it will be taken as the name of a file.
  789. -The first line in that file will be used as the organization.
  790. -This permits the same binary to be used on many different machines.
  791. -A good file name would be
  792. -.b LIBDIR \f2/organization\fP.
  793. -For example,
  794. -an organization might read
  795. -.cf "AT&T Bell Labs, Murray Hill" ,
  796. -.cf "U.C. Berkeley" ,
  797. -.cf MIT ,
  798. -or
  799. -.cf "Computer Corp. of America, Cambridge, Mass" .
  800. -.pg
  801. -.hn 3
  802. -HIDDENNET
  803. -.pg
  804. -If you want all your news to look like it came from a single machine
  805. -instead of from every machine on your local network,
  806. -define
  807. -.b HIDDENNET
  808. -to be the name of the machine you wish to pretend to be.
  809. -Make sure that you have you own machine defined as
  810. -.cn ME
  811. -in the sysfile
  812. -or you may get some unnecessary article retransmission.
  813. -.hn 3
  814. -NICENESS
  815. -.pg
  816. -If
  817. -.b NICENESS
  818. -is defined,
  819. -.i rnews
  820. -does a
  821. -.i nice (2)
  822. -to priority
  823. -.b NICENESS
  824. -before processing news.
  825. -.hn 3
  826. -FASCIST
  827. -.pg
  828. -If this is defined,
  829. -.i inews
  830. -checks to see if the posting user is allowed to
  831. -post to the given newsgroup.  If the username is not in the file
  832. -.b LIBDIR \f2/authorized\fP
  833. -then the default newsgroup pattern in the symbol
  834. -.b FASCIST
  835. -is used.
  836. -.pg
  837. -The format of the file
  838. -.i authorized
  839. -is:
  840. -.br
  841. -.si
  842. -.sd
  843. -user:allowed groups  
  844. -.ed
  845. -.ei
  846. -.br
  847. -For example:
  848. -.si
  849. -.sd
  850. -root:all.all,all
  851. -naughty_person:junk,talk.politics.misc
  852. -operator:!all.all,general,test,comp.unix.questions
  853. -.ed
  854. -.ei
  855. -.pg
  856. -An open environment could have
  857. -.b FASCIST
  858. -set to
  859. -.ng all
  860. -and then individual entries could be made in the authorized file
  861. -to prevent certain individuals from posting to such a wide
  862. -area.
  863. -.pg
  864. -Note that a distribution of
  865. -.ng all
  866. -does
  867. -.i not
  868. -mean to allow postings
  869. -only to local groups \-
  870. -.ng all
  871. -includes
  872. -.ng all.all .  
  873. -Use
  874. -.ng all\f1,!\fPall.all
  875. -to get that behavior
  876. -.hn 3
  877. -SMALL_ADDRESS_SPACE
  878. -.pg
  879. -Define this if your machine has 16 bit (or smaller) pointers.
  880. -If you are on a
  881. -.pd ,
  882. -this is automatically defined.
  883. -.hn 3
  884. -ORGDISTRIB
  885. -.pg
  886. -This can be defined to be the name of the distribution that is \*(lqlocal\*(rq
  887. -to your organization. If a control message arrives with 
  888. -.b ORGDISTRIB
  889. -as the distribution, it is believed and acted upon. This is useful
  890. -for organizations with one \*(lqmain\*(rq news machine and several
  891. -subordinate ones. All machines in that organization could define
  892. -.b NONEWGROUPS ,
  893. -.b MANUALLY
  894. -and also
  895. -.b ORGDISTRIB .
  896. -Then, when a control message arrives at the main machine, it would
  897. -be mailed to 
  898. -.b NOTIFY .
  899. -If that person determined that it was a legitimate message, they could
  900. -resubmit the message to their local machine with a distribution of
  901. -.b ORGDISTRIB .
  902. -They would not have to submit this message to the other machines, as they
  903. -would believe it because of the distribution. They would reject
  904. -the control message if it had any other distribution.
  905. -.hn 2
  906. -Makefile
  907. -.pg
  908. -There are also a few parameters in the
  909. -.i Makefile
  910. -as well.
  911. -These are:
  912. -.hn 3
  913. -OSTYPE
  914. -.pg
  915. -This is the type of
  916. -.ux
  917. -system you are using.
  918. -It should be either
  919. -.b V7
  920. -or
  921. -.b USG .
  922. -Any BSD system is V7. Any System 3 or System 5 system is USG.
  923. -This is normally set by
  924. -.i localize.sh .
  925. -.hn 3
  926. -NEWSUSR
  927. -.pg
  928. -This is the owner (user name) of
  929. -.i inews .
  930. -If you are a superuser,
  931. -you should probably create a new user id (traditionally
  932. -.i news )
  933. -and use this id.
  934. -If you are not a superuser,
  935. -you can use your own user id.
  936. -If you are able to,
  937. -you should create a mail alias
  938. -.i usenet
  939. -and have mail to this alias forwarded to you.
  940. -This will make it easier for other sites to find the right person
  941. -in the presence of changing jobs and out of date or nonexistent directory pages.
  942. -.b NEWSUSR
  943. -and
  944. -.b ROOTID
  945. -do not need to represent the same user.
  946. -.hn 3
  947. -NEWSGRP
  948. -.pg
  949. -This is the group (name) to which
  950. -.i inews
  951. -belongs.
  952. -The same considerations as
  953. -.b NEWSUSR
  954. -apply.
  955. -.hn 3
  956. -SPOOLDIR
  957. -.pg
  958. -This directory contains subdirectories in which news articles will be stored.
  959. -It is normally
  960. -.i /usr/spool/news .
  961. -.pg
  962. -For each newsgroup (\f2e.g.\fP
  963. -.ng comp.unix )
  964. -there will be a subdirectory
  965. -.i /usr/spool/news/comp/unix
  966. -containing articles,
  967. -whose file names are sequential numbers,
  968. -.i e\f1.\fPg .,
  969. -.i /usr/spool/news/comp/unix/1 ,
  970. -etc.
  971. -.pg
  972. -Each article file is in a mail-compatible format.
  973. -It begins with a number of header lines,
  974. -followed by a blank line,
  975. -followed by the body of the article.
  976. -The format has deliberately been chosen to be compatible
  977. -with the ARPANET standard for mail documented in RFC 822.
  978. -.pg
  979. -You should place news in an area of the disk with enough free space
  980. -to hold the news you intend to keep on line.
  981. -The total volume of news in the network wide groups
  982. -currently runs about 1 Mbyte per day.
  983. -If you expire news after the default 2 weeks,
  984. -you will need about 14 Mbytes of disk space
  985. -(plus some extra as a safety margin and
  986. -to allow for increased traffic in the future).
  987. -If you only receive some of the newsgroups,
  988. -or expire news after a different interval,
  989. -these figures can be adjusted accordingly.
  990. -.hn 3
  991. -BATCHDIR
  992. -.pg
  993. -This directory will contain the list of articles to send to each system.
  994. -It is normally
  995. -.i /usr/spool/batch .
  996. -.hn 3
  997. -LIBDIR
  998. -.pg
  999. -This directory will contain various system files.
  1000. -It is normally
  1001. -.i /usr/lib/news .
  1002. -.hn 3
  1003. -BINDIR
  1004. -.pg
  1005. -This is the directory in which
  1006. -.i readnews ,
  1007. -.i postnews ,
  1008. -.i vnews ,
  1009. -and
  1010. -.i checknews (1)
  1011. -are to be installed.
  1012. -This is normally
  1013. -.i /usr/bin .
  1014. -If you decide to set
  1015. -.b BINDIR
  1016. -to a local binary directory,
  1017. -you should consider that the
  1018. -.i rnews
  1019. -command must be in a directory that can be found by
  1020. -.i uuxqt ,
  1021. -which normally only searches
  1022. -.i /bin
  1023. -and
  1024. -.i /usr/bin .
  1025. -.hn 3
  1026. -UUXFLAGS
  1027. -.pg
  1028. -These are the flags with which
  1029. -.i uux
  1030. -will be called.
  1031. -.hn 3
  1032. -LNRNEWS
  1033. -.pg
  1034. -This is the program used to link
  1035. -.i rnews
  1036. -and
  1037. -.i inews .
  1038. -If you have symbolic links,
  1039. -you can replace the \*(lqln\*(rq with \*(lqln \-s\*(rq.
  1040. -.hn 3
  1041. -SCCSID
  1042. -.pg
  1043. -If this is defined, sccs ids will be included in each file. If you
  1044. -are short on address space, don't define this.
  1045. -.hn
  1046. -FILES
  1047. -.pg
  1048. -This section lists the files in
  1049. -.b LIBDIR
  1050. -and comments briefly what they do.
  1051. -.hn 2
  1052. -active
  1053. -.pg
  1054. -This is a list of active newsgroups.
  1055. -It is automatically updated as new newsgroups come in.
  1056. -The order here is the order news is initially presented by
  1057. -.i readnews ,
  1058. -so you can edit this file to put important newsgroups first.
  1059. -If you have
  1060. -.b SORTACTIVE
  1061. -defined,
  1062. -after the first time the user invokes
  1063. -.i readnews ,
  1064. -it will be presented in the order of the user's
  1065. -.i .newsrc .
  1066. -Each line of the active file contains four fields,
  1067. -separated by a space:
  1068. -the newsgroup name,
  1069. -the highest local article number
  1070. -(for the most recently received article),
  1071. -the lowest local article number that has not yet expired,
  1072. -and a single character used to determine if the user can post to that newsgroup.
  1073. -If the character is
  1074. -\&\*(lqy\*(rq
  1075. -the user is permitted to post articles to that group.
  1076. -If the character is
  1077. -\&\*(lqn\*(rq
  1078. -the user is not permitted to post articles to that group.
  1079. -If the character is
  1080. -\&\*(lqm\*(rq
  1081. -the newsgroup is moderated and may not be posted to directly. Instead,
  1082. -articles posted to that newsgroup are automatically mailed to the moderator
  1083. -of that group.
  1084. -(This field takes the place of the
  1085. -.i ngfile
  1086. -in earlier versions of news.)
  1087. -Local article numbers begin at 1 and count sequentially
  1088. -within the newsgroup as articles are received.
  1089. -They do not usually correspond to local article numbers on other sites.
  1090. -The article numbers are always stored as a five digit number
  1091. -(with leading zeros) to allow updating of the file in place.
  1092. -.pg
  1093. -The active file should contain
  1094. -.ng all
  1095. -active world wide newsgroups.
  1096. -You should use the
  1097. -.i sys
  1098. -file to keep out unwanted newsgroups.
  1099. -.hn 2
  1100. -aliases
  1101. -.pg
  1102. -This file is used to map bad newsgroup names to the correct ones.
  1103. -(For example,
  1104. -.ng rec.jokes
  1105. -is mapped into
  1106. -.ng rec.humor ).
  1107. -Each line consists of two fields separated by white space.
  1108. -If the first field is found in the newsgroup list of the incoming article,
  1109. -it is changed to the second field.
  1110. -This change takes place in the article
  1111. -before it is passed on to other systems,
  1112. -not just locally.
  1113. -.hn 2
  1114. -batch
  1115. -.pg
  1116. -This program reads a list of filenames of articles
  1117. -and outputs the articles themselves.
  1118. -It is typically used by the shell script 
  1119. -.i sendbatch .
  1120. -.hn 2
  1121. -caesar
  1122. -.pg
  1123. -This is a program to do Caesar decoding of rotated text,
  1124. -on a line by line basis.
  1125. -The standard input is copied to the standard output,
  1126. -rotating each line according to a static single letter frequency table.
  1127. -If an integer argument is given
  1128. -.i e\f1.\fPg ., (
  1129. -13),
  1130. -every line is rotated by that argument,
  1131. -without regard to letter frequencies.
  1132. -This program is invoked by the
  1133. -.qp D
  1134. -.i readnews
  1135. -command.
  1136. -It is also used by
  1137. -.i postnews
  1138. -with the \*(lq13\*(rq argument to encode selected material for posting.
  1139. -.hn 2
  1140. -checkgroups
  1141. -.pg
  1142. -.i Checkgroups
  1143. -is a shell file to aid in automatically checking
  1144. -the accuracy of your active file.
  1145. -It is executed by the
  1146. -.b checkgroups
  1147. -control message and mails a list of out of date newsgroups
  1148. -to the person defined by
  1149. -.b NOTIFY .
  1150. -It also updates the
  1151. -.i newsgroups
  1152. -file that is used by
  1153. -.i postnews
  1154. -as a helpfile for newsgroup selection.
  1155. -.hn 2
  1156. -compress
  1157. -.pg
  1158. -This program does a modified Lempel-Ziv data compression. It is used by the
  1159. -compressed batching scheme.
  1160. -It averages 50% compression on a typical batch of news.
  1161. -.hn 2
  1162. -distributions
  1163. -.pg
  1164. -This is a list of distributions that are valid for your site.
  1165. -Each line has two fields separated by the first space on the line.
  1166. -The first field is the name of the distribution
  1167. -.i e\f1.\fPg ., (
  1168. -.ng usa ,
  1169. -.ng na ,
  1170. -etc.).
  1171. -The second field is text describing the distribution.
  1172. -As distributed,
  1173. -this file is only correct for sites in the USA.
  1174. -You should examine this file and add or delete the appropriate distributions.
  1175. -.hn 2
  1176. -encode
  1177. -.pg
  1178. -This program transforms an 8-bit binary file into a file suitable for
  1179. -sending over a link that only allows 7-bit characters. It is used
  1180. -by
  1181. -.b "sendbatch -c7."
  1182. -.hn 2
  1183. -errlog
  1184. -.pg
  1185. -This file contains the \*(lqimportant\*(rq error messages found in the log file.
  1186. -These errors usually indicate that something was wrong with an article.
  1187. -This file should be watched closely.
  1188. -The
  1189. -.i log
  1190. -file contains much more verbose information
  1191. -and it is often difficult to detect errors in it.
  1192. -.hn 2
  1193. -expire
  1194. -.pg
  1195. -This program expires old articles and archives them if archiving is selected.
  1196. -It is typically run once a day from
  1197. -.i cron (8).
  1198. -.hn 2
  1199. -help
  1200. -.pg
  1201. -This contains a list of commands printed when an illegal command is typed to
  1202. -.i readnews .
  1203. -.hn 2
  1204. -history
  1205. -.pg
  1206. -A list of every article that has come in to your system.
  1207. -It is used to reject articles that come in for the second time
  1208. -(presumably via a different path).
  1209. -This file will grow but is cleaned out by the
  1210. -.i expire (8)
  1211. -command.
  1212. -.hn 2
  1213. -history.d
  1214. -.pg
  1215. -On USG systems, this directory contains 10 files (history.[0-9]) which are
  1216. -used as part of a simple hashing algorithm to speed up history searches.
  1217. -Since V7 systems have DBM, this is not used on V7 systems.
  1218. -.hn 2
  1219. -history.dir,history.pag
  1220. -.pg
  1221. -These two files are used on V7 systems as a hashed version of
  1222. -.i history ,
  1223. -containing the message id's of all articles in history.
  1224. -They are only used if
  1225. -.b \-DDBM
  1226. -and
  1227. -.b \-ldbm
  1228. -appear in
  1229. -.i Makefile .
  1230. -.hn 2
  1231. -inews
  1232. -.pg
  1233. -This is the program that actually sends and receives news.
  1234. -All other news submitting programs interface eventually with it.
  1235. -It is not intended to be used directly by a human,
  1236. -so it is no longer in
  1237. -.b BINDIR .
  1238. -.hn 2
  1239. -log
  1240. -.pg
  1241. -If present,
  1242. -a log of articles processed and error conditions is kept here.
  1243. -This file grows without limit unless cleaned out periodically.
  1244. -The
  1245. -.i trimlib
  1246. -script in
  1247. -.i misc
  1248. -can be invoked by
  1249. -.i cron (8)
  1250. -daily or weekly to keep the log short.
  1251. -.hn 2
  1252. -mailpaths
  1253. -.pg
  1254. -This file contains the mail paths to a Usenet
  1255. -.i backbone
  1256. -site and a site that can handle
  1257. -.i internet
  1258. -style mail addresses.
  1259. -Each line consists of two fields. The first field is either the
  1260. -keyword
  1261. -.i backbone
  1262. -or the keyword
  1263. -.i internet .
  1264. -The second field is a string to be used by printf to create a mail
  1265. -path.  As distributed, they are almost certainly wrong.
  1266. -You will need to modify the paths so they work from your site.
  1267. -.pg
  1268. -As an example, suppose that your site's closest
  1269. -.i backbone
  1270. -site was
  1271. -.i seismo 
  1272. -and the closest site that understood the
  1273. -.i internet
  1274. -mail syntax was
  1275. -.i decuac .
  1276. -Your
  1277. -.i mailpaths
  1278. -file would look like:
  1279. -.si
  1280. -.sd
  1281. -backbone    seismo!%s
  1282. -internet\     decuac!%s
  1283. -.ed
  1284. -.ei
  1285. -.pg
  1286. -The
  1287. -.i backbone
  1288. -path is used when posting articles to moderated groups. A mail
  1289. -alias exists on almost all backbone sites to forward mail to the proper
  1290. -moderator for the group. The mail aliases should always be up to
  1291. -date on these sites, so when a group changes moderators, only
  1292. -the backbone sites need to update any files. The mail alias is
  1293. -the newsgroups name with \*(lq.\*(rq changed to \*(lq\-\*(rq.
  1294. -Using the above example
  1295. -.i mailpaths
  1296. -file, a submission to comp.sources.unix would be mailed to
  1297. -seismo!comp-sources-unix, where it would be forwarded to the
  1298. -current moderator for that group.
  1299. -.pg
  1300. -The
  1301. -.i internet
  1302. -keyword is used when the
  1303. -.b INTERNET
  1304. -option is defined for replying to news articles. A site whose mailer
  1305. -does not understand
  1306. -.i internet
  1307. -syntax can (and should) define
  1308. -.b INTERNET
  1309. -so that mailed replies use the
  1310. -.i From:
  1311. -line of the article instead of the unreliable
  1312. -.i Path:
  1313. -line.
  1314. -.hn 2
  1315. -newsgroups
  1316. -.pg
  1317. -This file is displayed by
  1318. -.i postnews
  1319. -when a user hits
  1320. -.qp ?
  1321. -in response to its request for newsgroups.
  1322. -It is also used by
  1323. -.i vnews
  1324. -when it displays the newsgroup name.
  1325. -It is updated automatically by the
  1326. -.b checkgroups
  1327. -control message.
  1328. -.hn 2
  1329. -notify
  1330. -.pg
  1331. -This file allows a site administrator to
  1332. -declare which types of control messages they wish to notification on
  1333. -and which they
  1334. -don't.  The format is two words separated by white space.  The first word
  1335. -is the name of the control message type (like
  1336. -.b checkgroups ).
  1337. -The second word (if it exists) is the address to mail the notification to.
  1338. -If the second word does not exist then it is assumed that no mail is desired
  1339. -from this type of control message.  If the 
  1340. -.b LIBDIR \f2/notify\fP
  1341. -file doesn't contain any recognizable control message types or is empty, then
  1342. -it is assumed that no mail is desired from any type of control message.
  1343. -.pg
  1344. -The key word \*(lqall\*(rq may be used to select what address all known control
  1345. -message types should be sent to.  Since parsing of the file is sequential, the
  1346. -key word \*(lqall\*(rq could be first in the file and specific declarations
  1347. -specifying differing addresses could follow which would override any previous 
  1348. -listing.
  1349. -This example of
  1350. -.b LIBDIR \f2/notify\fP
  1351. -declares that mail will be sent to \*(lqusenet\*(rq
  1352. -for all control message types except the 
  1353. -.b sendsys
  1354. -type.  
  1355. -.b Sendsys
  1356. -messages will be sent to \*(lqsecurity\*(rq.
  1357. -.ta \w'checkgroups   'u
  1358. -.sd c
  1359. -# Comments are ok since unrecognized message types are ignored.
  1360. -all    usenet
  1361. -sendsys    security
  1362. -.ed
  1363. -This example will only send
  1364. -mail to \*(lqusenet\*(rq for the 
  1365. -.b checkgroups
  1366. -type of control message.  All others will not have any mail associated with
  1367. -them.
  1368. -.sd c
  1369. -# Comments are ok since unrecognized message types are ignored.
  1370. -checkgroups    usenet
  1371. -.ed
  1372. -(This overrides the
  1373. -.b NOTIFY
  1374. -option in
  1375. -.i defs.h ).
  1376. -Having a null file is useful if one person administers several systems
  1377. -and does not want multiple copies of control message notifications.
  1378. -.hn 2
  1379. -oactive, ohistory, ohistory.dir, ohistory.pag
  1380. -.pg
  1381. -These are copies of the corresponding
  1382. -.i active ,
  1383. -.i history ,
  1384. -.i history.dir ,
  1385. -and
  1386. -.i history.pag
  1387. -files before
  1388. -.i expire
  1389. -ran.
  1390. -They are kept in case something happens to the originals.
  1391. -.hn 2
  1392. -recmail
  1393. -.pg
  1394. -This program can serve as a link between news and your local mailer.
  1395. -If you have
  1396. -.i sendmail (8),
  1397. -don't use
  1398. -.i recmail .
  1399. -.i Sendmail
  1400. -is much more useful.
  1401. -.hn 2
  1402. -recnews
  1403. -.pg
  1404. -A program which allows you to send mail to get news posted.
  1405. -You usually need to run
  1406. -.i sendmail
  1407. -or
  1408. -.i delivermail (8)
  1409. -to be able to use this.
  1410. -.hn 2
  1411. -recording
  1412. -.pg
  1413. -A list of newsgroup classes and filenames to display recordings for.
  1414. -The recording feature is analogous to the recordings played in some areas
  1415. -when you dial directory assistance,
  1416. -trying to be annoying and make you think twice.
  1417. -Recordings on certain newsgroups are intended to remind the user
  1418. -of the rules for the newsgroup,
  1419. -or,
  1420. -in the case of a company worried about letting proprietary information out,
  1421. -reminding authors that anything they say is seen outside the company
  1422. -and so proprietary information should not be included.
  1423. -.pg
  1424. -The file contains one line per recording.
  1425. -The line contains two fields,
  1426. -separated by a space.
  1427. -The first field is the newsgroup class
  1428. -.i e\f1.\fPg ., (
  1429. -.ng talk.all ),
  1430. -the second field is the name of the file containing the recorded message.
  1431. -If the file name does not begin with a slash,
  1432. -it will be searched for in
  1433. -.b LIBDIR .
  1434. -Sample recording files can be found in the
  1435. -.i misc
  1436. -directory.
  1437. -.hn 2
  1438. -rmgroup
  1439. -.pg
  1440. -This shell file should be used to remove any groups that are no longer used.
  1441. -.hn 2
  1442. -sendbatch
  1443. -.pg
  1444. -This shell file is used to send batched articles to other systems.
  1445. -It is typically run from
  1446. -.i cron (8).
  1447. -See the manual page for more details.
  1448. -.hn 2
  1449. -sendnews
  1450. -.pg
  1451. -A program to send news internally from one computer to another.
  1452. -It is useful if you must use mail links to transmit articles.
  1453. -.hn 2
  1454. -seq
  1455. -.pg
  1456. -This file contains the current sequence number for your system.
  1457. -It is used to generate unique article id's.
  1458. -.hn 2
  1459. -sys
  1460. -.pg
  1461. -This file contains a list of all your neighbors,
  1462. -which newsgroups they get,
  1463. -and how to send news to them.
  1464. -The format is documented below.
  1465. -.hn 2
  1466. -unbatch
  1467. -.pg
  1468. -This program is used to unbatch the incoming batched news
  1469. -and feed each article to
  1470. -.i rnews .
  1471. -It's horrible and will go away in the future.
  1472. -.hn 2
  1473. -users
  1474. -.pg
  1475. -A list of users that have read news on your system.
  1476. -.hn 2
  1477. -uurec
  1478. -.pg
  1479. -A program to receive news sent by
  1480. -.i sendnews (8).
  1481. -.hn 2
  1482. -vnews.help
  1483. -.pg
  1484. -This is the helpfile used by
  1485. -.i vnews .
  1486. -.hn 1
  1487. -Setting Up Links
  1488. -.pg
  1489. -There are two basic types of links for exchanging news:
  1490. -those that use mail and those that don't.
  1491. -The ones that use mail are more indirect,
  1492. -yet more versatile, while the ones that don't are simpler.
  1493. -The default method does not use mail, so that is discussed first.
  1494. -.hn 2
  1495. -Non-mail Links
  1496. -.pg
  1497. -The basic theory behind a non-mail link is that the
  1498. -.i rnews
  1499. -program is invoked on the remote system
  1500. -with the article being transmitted as the standard input.
  1501. -This is possible on several networks,
  1502. -but the most common implementation is via the UUCP network.
  1503. -Using the
  1504. -.i uux
  1505. -command,
  1506. -the command which is forked to the shell looks like:
  1507. -.sd c
  1508. -uux \- \-r \-z remotesys!rnews < article
  1509. -.ed
  1510. -This is the default transmission method.
  1511. -In order to set up such a link,
  1512. -obviously a UUCP link with the remote system must be in effect.
  1513. -In addition,
  1514. -.i rnews
  1515. -must be available and executable by
  1516. -.i uuxqt
  1517. -on the remote machine.
  1518. -In most cases,
  1519. -this means that
  1520. -.i rnews
  1521. -must be in
  1522. -.i /usr/bin
  1523. -so
  1524. -.i uux
  1525. -can find it.
  1526. -Also,
  1527. -the list of allowed UUCP commands (in
  1528. -.i /usr/src/usr.bin/uucp/uuxqt.c
  1529. -or
  1530. -.i /usr/lib/uucp/L.cmds ,
  1531. -depending on the version of UUCP)
  1532. -should be checked to make sure
  1533. -that
  1534. -.i rnews
  1535. -is an allowed command.
  1536. -.pg
  1537. -Other networks that allow remote execution include the BERKNET,
  1538. -BLICN
  1539. -.i usend (1)), (
  1540. -many Ethernets,
  1541. -and the NSC hyperchannel
  1542. -.i nusend (1)). (
  1543. -It is important,
  1544. -however,
  1545. -that a spooling mechanism be available.
  1546. -Otherwise,
  1547. -if system
  1548. -.cn A
  1549. -tries to send an article to system
  1550. -.cn B
  1551. -via a remote execution command,
  1552. -and
  1553. -.cn B
  1554. -is down,
  1555. -the article could be lost.
  1556. -Spooling arranges that the system will try again when
  1557. -.cn B
  1558. -comes back up.
  1559. -.hn 2
  1560. -Mail Links
  1561. -.pg
  1562. -When using mail to transmit articles,
  1563. -two intermediary programs are necessary.
  1564. -These are
  1565. -.i sendnews
  1566. -and
  1567. -.i uurec (8).
  1568. -The idea is that when system
  1569. -.cn A
  1570. -wants to send an article to system
  1571. -.cn B ,
  1572. -the
  1573. -.i sys
  1574. -file on system
  1575. -.cn A
  1576. -has an entry for system
  1577. -.cn B
  1578. -such as:
  1579. -.sd c
  1580. -\fBLIBDIR\fP/sendnews \-a rnews@B
  1581. -.ed
  1582. -which runs
  1583. -.i sendnews
  1584. -on the article.
  1585. -The
  1586. -.op \-a
  1587. -option specifies that the mail should be formatted for the ARPANET.
  1588. -.i Sendnews
  1589. -packages the article and mails it to
  1590. -.cf rnews@B .
  1591. -Somehow,
  1592. -the B system is expected to make sure that all mail to user
  1593. -.cf rnews
  1594. -is fed as input to the program
  1595. -.i uurec .
  1596. -This program unpackages it and invokes
  1597. -.i rnews .
  1598. -.pg
  1599. -The best way to get mail to
  1600. -.cf rnews
  1601. -fed into
  1602. -.i uurec
  1603. -is to use
  1604. -.i sendmail
  1605. -or
  1606. -.i delivermail ,
  1607. -if you are on a system running them.
  1608. -Create an alias in
  1609. -.i /usr/lib/aliases
  1610. -as follows:
  1611. -.sd c
  1612. -rnews: "|\fBLIBDIR\fP/uurec"
  1613. -.ed
  1614. -and
  1615. -.i sendmail
  1616. -will handle it.
  1617. -If you do not have a facility for forwarding mail to a program,
  1618. -you can gimmick your mailer to watch for it
  1619. -(using
  1620. -.i popen (3S),
  1621. -this is easy)
  1622. -or,
  1623. -if you don't want to do any programming,
  1624. -you can have
  1625. -.i cron (8)
  1626. -invoke
  1627. -.i uurec
  1628. -every hour with
  1629. -.i /usr/spool/mail/rnews
  1630. -as standard input.
  1631. -This solution is messier because
  1632. -.i uurec
  1633. -must potentially deal with multiple messages,
  1634. -something that has never been tested.
  1635. *-*-END-of-install.mn-*-*
  1636. echo "This was only the first half of install.mn"
  1637. echo "The second half is in part 5 of 6"
  1638. exit
  1639.  
  1640.