.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" 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 .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . 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 .\" ======================================================================== .\" .IX Title "INNXMIT 8" .TH INNXMIT 8 2024-04-01 "INN 2.7.2" "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 innxmit \- Send Usenet articles to a remote NNTP server .SH SYNOPSIS .IX Header "SYNOPSIS" \&\fBinnxmit\fR [\fB\-acdHlprsv\fR] [\fB\-P\fR \fIportnum\fR] [\fB\-T\fR \fIseconds\fR] [\fB\-t\fR \fIseconds\fR] \fIhost\fR \fIfile\fR .SH DESCRIPTION .IX Header "DESCRIPTION" \&\fBinnxmit\fR connects to the NNTP server at the specified \fIhost\fR (validating itself via \fIpasswd.nntp\fR if authentication credentials are present for the remote server in that file) and sends it the articles specified in the batch file named \fIfile\fR. It is normally invoked by a script run out of cron(8) that uses \fBshlock\fR to lock the host name, followed by a \fBctlinnd\fR command to flush the batch file. If \fIfile\fR is not an absolute path name, it is taken relative to the directory specified by the \fIpathoutgoing\fR parameter in \fIinn.conf\fR. It is normally written by specifying the \f(CW\*(C`Wnm\*(C'\fR flags in the \fInewsfeeds\fR file. Each line in the batch file should be in one of the following formats: .PP .Vb 2 \& article Message\-ID \& article .Ve .PP The first field is either the storage API token of an article or the name of a file holding an article. If it is not an absolute pathname or a storage API token, it is taken to be a file name relative to \&\fIpatharticles\fR in \fIinn.conf\fR. If the second field is not specified, the message-ID will be obtained by scanning the article. The two fields, if present, are separated by a space. If a communication error such as a write(2) failure occurs, \fBinnxmit\fR will stop sending and rewrite the batch file to contain the current article and any other unsent articles. .PP An alternative to \fBinnxmit\fR can be \fBinnduct\fR, mentioned in the innfeed(8) man page. .SH OPTIONS .IX Header "OPTIONS" .IP \fB\-a\fR 4 .IX Item "-a" If all articles were sent successfully, \fBinnxmit\fR will remove the batch file; otherwise it will rewrite it to contain the list of unsent articles. If no articles were sent or rejected, the file is left untouched. This can cause the batch file to grow excessively large if many articles have been expired and there are communication problems. To always rewrite the batch file, use the \fB\-a\fR flag. .IP \fB\-c\fR 4 .IX Item "-c" In streaming mode, a check of each message-ID is made to avoid sending articles already on the remote server. After a certain number of articles accepted in a row, \fBinnxmit\fR will no longer send these queries, but will switch back to sending them upon receiving a reject (which may be for another reason than a duplicate, like for instance an unwanted newsgroup). .Sp The \fB\-c\fR flag will, if streaming mode is supported, result in always sending articles without checking. This results in slightly greater throughput and may be appropriate when it is known that the site could not already have the articles such as in the case of a "leaf" site. .IP \fB\-d\fR 4 .IX Item "-d" Use the \fB\-d\fR flag to print debugging information on standard error. This will show the protocol transactions between \fBinnxmit\fR and the NNTP server on the remote host. .IP \fB\-H\fR 4 .IX Item "-H" If the \fB\-H\fR flag is given, then only headers are sent to \fIhost\fR for all articles except control messages. And the Bytes header field is also included even if it does not exist in the original article. The \fB\-H\fR flag is useful for Diablo reader. .IP \fB\-l\fR 4 .IX Item "-l" The \fB\-l\fR flag is used to turn on logging of reasons the remote gives for rejecting an article. .IP "\fB\-P\fR \fIportnum\fR" 4 .IX Item "-P portnum" To specify a port number other than the default, use the \fB\-P\fR flag. .IP \fB\-p\fR 4 .IX Item "-p" If the \fB\-p\fR flag is given, then no connection is made and the batch file is purged of entries that refer to files that no longer exist. This implies the \fB\-a\fR flag. .IP \fB\-r\fR 4 .IX Item "-r" If the remote server sends an unexpected reply code, \fBinnxmit\fR will requeue the article and proceed. Use the \fB\-r\fR flag if the article should not be requeued. .IP \fB\-s\fR 4 .IX Item "-s" \&\fBinnxmit\fR will attempt to negotiate a streaming mode extension of the NNTP protocol with the server at connect time. If successful, it will use a slightly different protocol that enhances throughput. If the server does not recognize the streaming mode negotiation, \fBinnxmit\fR will revert to normal NNTP transfer mode. Use the \fB\-s\fR flag to disable the attempt to negotiate the streaming mode extension. .IP "\fB\-T\fR \fIseconds\fR" 4 .IX Item "-T seconds" To specify the total amount of time that should be allowed for article transfers, use the \fB\-T\fR flag. The default is to wait until an I/O error occurs, or all the articles have been transferred. If the \fB\-T\fR flag is used, the time is checked just before each article is started; it will not abort a transfer that is in progress. .IP "\fB\-t\fR \fIseconds\fR" 4 .IX Item "-t seconds" \&\fBinnxmit\fR normally blocks until the connection is made. To specify a timeout on how long to try to make the connection, use the \fB\-t\fR flag. .IP \fB\-v\fR 4 .IX Item "-v" Upon exit, \fBinnxmit\fR reports transfer and CPU usage statistics via syslog. If the \fB\-v\fR flag is used, they will also be printed on the standard output. .SH HISTORY .IX Header "HISTORY" Written by Rich $alz for InterNetNews. Converted to POD by Julien Elie. .SH "SEE ALSO" .IX Header "SEE ALSO" ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), passwd.nntp(5), shlock(1).