.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40) .\" .\" 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 .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" 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 "INEWS 1" .TH INEWS 1 "2023-04-16" "INN 2.7.1" "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" inews \- Post a Usenet article to the local news server .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBinews\fR [\fB\-ADEhHILNOPRSvVWXY\fR] [\fB\-acdefFimnorstwx\fR \fIvalue\fR] [\fB\-p\fR \fIport\fR] [\fIfile\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBinews\fR reads a Usenet news article, perhaps with headers, from \fIfile\fR or standard input if no file is given. It adds some header fields and performs some consistency checks. If the article does not meet those checks, the article is rejected. If it passes the checks, \fBinews\fR sends the article to the local news server as specified in the \fIserver\fR parameter in \fIinn.conf\fR. .PP By default, if a file named \fI.signature\fR exists in the home directory of the posting user, it is appended to the post, preceded by a line that contains only \f(CW\*(C`\-\- \*(C'\fR. Signatures are not allowed to be more than four lines long. .PP Control messages other than cancel messages are only allowed if \fBinews\fR is being run by the news user or by a user in the news group and if the control message is recognized. If the article contains a Distribution header field with a distribution that matches one of the bad distribution patterns in \fIinn/options.h\fR (anything containing a period by default), the message will be rejected. The message will also be rejected if \&\fIcheckincludedtext\fR is true in \fIinn.conf\fR, it contains more quoted text than original text, and it is over 40 lines long. .PP If not provided, the Path header field body will be \f(CW\*(C`not\-for\-mail\*(C'\fR. If \fB\-x\fR is given, its value will be added to the beginning of the Path header field. You may for instance want to add a special \f(CW\*(C`path\-identity\*(C'\fR value related to the host running \fBinews\fR, which will appear as \f(CW\*(C`path\-identity!not\-for\-mail\*(C'\fR in the Path header field. .PP If posting fails, a copy of the failed post will be saved in a file named \&\fIdead.article\fR in the home directory of the user running \fBinews\fR. \&\fBinews\fR exits with a non-zero status if posting failed or with a zero status if posting was successful. .SH "OPTIONS" .IX Header "OPTIONS" Most of the options to \fBinews\fR take a single value and set the corresponding header field body in the message that is posted. If the value is more than one word or contains any shell metacharacters, it must be quoted to protect it from the shell. Here are all the options that set header fields and the corresponding header field body: .PP .Vb 10 \& \-a Approved \& \-c Control \& \-d Distribution \& \-e Expires \& \-F References \& \-f From \& \-m Message\-ID \& \-n Newsgroups \& \-o Organization \& \-r Reply\-To \& \-t Subject \& \-w Followup\-To \& \-x Path (prefix) .Ve .PP The \fB\-x\fR argument will be added to the beginning of the normal Path header field body; it will not replace it contrary to what other options do. This behaviour is historical, and was first implemented in the \fBinews\fR program shipped with B News (the original meaning of \fB\-x\fR was to say not to forward the article to a specified site). .IP "\fB\-A\fR, \fB\-V\fR, \fB\-W\fR" 4 .IX Item "-A, -V, -W" Accepted for compatibility with C News. These options have no affect. .IP "\fB\-i\fR, \fB\-I\fR, \fB\-L\fR, \fB\-s\fR, \fB\-v\fR, \fB\-X\fR" 4 .IX Item "-i, -I, -L, -s, -v, -X" Accepted for compatibility with \fBtinews\fR\|(1). These options have no effect. .IP "\fB\-D\fR, \fB\-N\fR" 4 .IX Item "-D, -N" Perform the consistency checks and add header fields where appropriate, but then print the article to standard output rather than sending it to the server. \fB\-N\fR is accepted as as synonym for compatibility with C News. .IP "\fB\-E\fR" 4 .IX Item "-E" If the article is empty (that is to say with no body), \fBinews\fR bails out with an error. When \fB\-E\fR is used, \fBinews\fR will just silently discard the message and exit. .Sp Note that control messages with no body are not rejected. .IP "\fB\-h\fR" 4 .IX Item "-h" Normally, this flag should always be given. It indicates that the article consists of headers, a blank line, and then the message body. If it is omitted, the input is taken to be just the body of the message, and any desired header fields have to be specified with command-line options as described above. .IP "\fB\-H\fR" 4 .IX Item "-H" Print to standard output a help message. .IP "\fB\-O\fR" 4 .IX Item "-O" By default, an Organization header field will be added if none is present in the article. To prevent adding the default (from \fIorganization\fR in \fIinn.conf\fR), use this flag. .IP "\fB\-p\fR \fIport\fR" 4 .IX Item "-p port" Connect to the specified port on the server rather than to the default (port 119). .IP "\fB\-P\fR" 4 .IX Item "-P" \&\fBinews\fR computes a sender address with the username of the user running \&\fBinews\fR and the hostname of the news server. It represents the actual poster of the article. .Sp By default, a Sender header field will be added with that value if none is present in the article or if the From header field is not already set to that value. Moreover, if a Sender header field is already present, it will be replaced with that value. .Sp To prevent adding or overwriting the Sender header field, use this flag. .IP "\fB\-R\fR" 4 .IX Item "-R" Reject all control messages. .IP "\fB\-S\fR" 4 .IX Item "-S" Do not attempt to append \fI~/.signature\fR to the message, even if it exists. .IP "\fB\-Y\fR" 4 .IX Item "-Y" By default, \fBinews\fR authenticates to the remote news server only if asked to, or if the initial \s-1NNTP\s0 banner corresponds to a state in which postings are not allowed. Using this flag leads \fBinews\fR to always authenticate, even if not asked to. .SH "NOTES" .IX Header "NOTES" If the \s-1NNTP\s0 server requests authentication, \fBinews\fR will try to read \&\fIpasswd.nntp\fR to get the username and password to use and will therefore need read access to that file. This is typically done by making that file group-readable and adding all users who should be able to use \fBinews\fR to post to that server to the appropriate group. .PP \&\fBinews\fR used to do even more than it does now, and all of the remaining checks that are not dependent on the user running \fBinews\fR should probably be removed in favor of letting the news server handle them. .PP Since \s-1INN\s0's \fBinews\fR uses \fIinn.conf\fR and some other corners of an \s-1INN\s0 installation, it's not very appropriate as a general stand-alone \fBinews\fR program for general use on a system that's not running a news server. Other, more suitable versions of \fBinews\fR are available as part of various Unix news clients or by themselves. We try to keep compatibility with the flags other implementations use (like C News, inews-xt and \fBtinews\fR\|(1)). .SH "HISTORY" .IX Header "HISTORY" Written by Rich \f(CW$alz\fR for InterNetNews. Rewritten in \&\s-1POD\s0 by Russ Allbery . .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBinn.conf\fR\|(5), \fBpasswd.nntp\fR\|(5), \fBrnews\fR\|(1).