.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "RNEWS 1" .TH RNEWS 1 "2015-09-12" "INN 2.6.3" "InterNetNews Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" rnews \- Inject individual articles and UUCP batches into INN .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBrnews\fR [\fB\-NUv\fR] [\fB\-h\fR \fIhost\fR] [\fB\-P\fR \fIport\fR] [\fB\-rS\fR \fIserver\fR] [\fIfile\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBrnews\fR injects either individual articles or UUCP-style article batches into an \s-1INN\s0 server. It submits articles via \s-1IHAVE\s0 and is suitable for injecting articles received from other sources; local postings should generally use \fIinews\fR\|(1) instead. It is also used to process spooled messages created by, for example, \fBnnrpd\fR while \fBinnd\fR is not available. .PP The message is read from \fIfile\fR if given, or standard input if no file is given. Articles are sent to the server given in the \fB\-r\fR or \fB\-S\fR command line options if given, otherwise to the server set via \&\fInnrpdposthost\fR in \fIinn.conf\fR, otherwise to the local server. .PP When sent over \s-1UUCP,\s0 Usenet articles are typically collected in a single batch to reduce the \s-1UUCP\s0 overhead. Batches can also be compressed to reduce communication time. If the input to \fBrnews\fR does not begin with the characters \f(CW\*(C`#!\*(C'\fR, it is taken to be a single news article; otherwise, the first line of the input is interpreted as a batch command. .PP If the batch command is: .PP .Vb 1 \& #! rnews .Ve .PP then the next bytes (starting with the next line) are read as a news article. After that article is processed, the next line is again treated as a batch command. .PP If the command is: .PP .Vb 1 \& #! cunbatch .Ve .PP then the rest of the input is fed to \f(CW\*(C`gzip \-d\*(C'\fR to uncompress it, and then the resulting uncompressed output is re-read as if it were the original input to \fBrnews\fR. A compressed batch should therefore start with this line and contain a batch of articles separated by \f(CW\*(C`#!\ rnews\*(C'\fR lines and then compressed with \fIcompress\fR\|(1). (Batches compressed with \fIgzip\fR\|(1) should instead use \f(CW\*(C`gunbatch\*(C'\fR as the batch command; \s-1INN\s0 just uses \fBgzip\fR rather than \fBcompress\fR because it can handle \fBcompress\fR\-style compression but is more widely available, due to old patent issues, than \fBcompress\fR.) .PP Otherwise, if the command is any other word, then \fBrnews\fR will try to execute a program with that name, looking for it in the directory \&\fIpathbin\fR/rnews.libexec. The rest of the batch will be fed to that program's standard input, and the standard output from the program will be treated as if it were the original input to \fBrnews\fR. \s-1INN\s0 comes with three such standard batch processors: .IP "\fBbunbatch\fR" 2 .IX Item "bunbatch" It invokes \fBbzip2\fR and should be used for batches compressed with \fBbzip2\fR. .IP "\fBc7unbatch\fR" 2 .IX Item "c7unbatch" It undoes an \s-1ASCII\s0 encoding to recover the original binary compressed stream and then decompresses it as explained above. .IP "\fBgunbatch\fR" 2 .IX Item "gunbatch" It invokes \fBgzip\fR and should be used for batches compressed with \fBgzip\fR. .PP By default, \fBrnews\fR will log and discard any articles that are rejected by the server or cannot be parsed by \fBrnews\fR for some reason (such as a missing header). This default can be changed when compiling \s-1INN\s0 by setting \s-1DO_RNEWS_SAVE_BAD\s0 in \fIinclude/inn/options.h\fR. There is no way to change it at runtime, unfortunately. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-h\fR \fIhost\fR" 4 .IX Item "-h host" If \fB\-h\fR is given, \fBrnews\fR will log the message \s-1ID\s0 and \fIhost\fR via syslog for each article that it offers to the server. This is used in conjunction with a \s-1UUCP\s0 feed to get a log of the messages received via that feed. This will also be done if the environment variable \s-1UU_MACHINE\s0 is set, but will only be done if \fIhost\fR is not an empty string. (You can therefore turn off logging even if \s-1UU_MACHINE\s0 will be set by passing the flag \f(CW\*(C`\-h \*(Aq\*(Aq\*(C'\fR to \fBrnews\fR.) .IP "\fB\-N\fR" 4 .IX Item "-N" Normally, if unpacking the input batch fails, it is re-spooled to \&\fIpathincoming\fR for another attempt later. If the \fB\-N\fR flag is given, no such re-spooling is done and \fBrnews\fR will instead exit with status 9 if unpacking fails. .IP "\fB\-P\fR \fIport\fR" 4 .IX Item "-P port" Use \fIport\fR as the server port to connect to rather than \fInnrpdpostport\fR (as set in \fIinn.conf\fR). Note that this value is only used if \fBrnews\fR does not connect to the local server (in other words, when \fB\-r\fR or \fB\-S\fR is given or \fInnrpdposthost\fR is set). .IP "\fB\-r\fR \fIserver\fR, \fB\-S\fR \fIserver\fR" 4 .IX Item "-r server, -S server" \&\fB\-r\fR and \fB\-S\fR are synonymous. If either is given, articles will be sent to \fIserver\fR rather than using the local server, overriding also the setting of \fInnrpdposthost\fR in \fIinn.conf\fR. .IP "\fB\-U\fR" 4 .IX Item "-U" If the server is not available, both \fBrnews\fR and \fBnnrpd\fR will spool posts to new files in the \fIpathincoming\fR directory (as specified in \&\fIinn.conf\fR). When \fBrnews\fR is invoked with the \fB\-U\fR option, it scans that directory and processes all spooled messages found there whose filenames do not begin with \f(CW\*(C`.\*(C'\fR, attempting to send them to the server again. It's a good idea to run this periodically out of cron to pick up any articles spooled due to temporary server unavailability. .SH "BUGS" .IX Header "BUGS" \&\fBrnews\fR cannot process articles that have embedded nul characters in them. (Neither can the rest of \s-1INN\s0 at present.) .SH "HISTORY" .IX Header "HISTORY" Written by Rich \f(CW$alz\fR for InterNetNews. Rewritten in \&\s-1POD\s0 by Russ Allbery . .PP \&\f(CW$Id:\fR rnews.pod 9767 2014\-12\-07 21:13:43Z iulius $ .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIbzip2\fR\|(1), \fIcompress\fR\|(1), \fIgzip\fR\|(1), \fIinn.conf\fR\|(5), \fIinnd\fR\|(8), \fInnrpd\fR\|(8).