chiark / gitweb /
Commit 2.4.5-5 as unpacked
[inn-innduct.git] / doc / man / send-nntp.8
1 .TH SEND-UUCP 8
2 .SH NAME
3 send-nntp, send-ihave \- send Usenet articles to remote site
4 .SH SYNOPSIS
5 .B send-nntp
6 [
7 .B \-d
8 ]
9 .B sitename:hostname | sitename
10 [
11 .B sitename:hostname | sitename ..
12 ]
13 .PP
14 .B send-ihave
15 [
16 .B \-d
17 ]
18 .B sitename:hostname | sitename
19 [
20 .B sitename:hostname | sitename ..
21 ]
22 .SH DESCRIPTION
23 The send-* utilities are scripts that process the batch files written
24 by
25 .IR innd (8)
26 to send Usenet articles to a remote NNTP site.
27 .PP
28 The sites to be fed may be specified by giving
29 .I sitename
30 .I hostname
31 pairs on the command line.
32 .PP
33 The
34 .I sitename
35 is the label the site has in the
36 .I newsfeeds
37 file, the
38 .I hostname
39 is the real hostname of the remote site, a FQDN (Fully Qualified Domain Name).
40 Normally, the
41 .I sitename
42 and the
43 .I hostname
44 are the same, and as such don't have to be specified as sitename:hostname
45 pairs but just as a sitename.
46 .PP
47 .I send-nntp
48 starts an innxmit to send the articles to the remote site.
49 .PP
50 .I send-ihave
51 encapsulates the articles in an
52 .I ihave
53 control message and uses
54 .I inews
55 to send the articles to a
56 .I to.sitename
57 pseudo-group. Using
58 .I send-ihave
59 is discouraged, nobody uses it anymore and even the author of this manpage
60 is unsure as to how it actually works or used to work.
61 .PP
62 .I send-*
63 expect that the batchfile for a site is named
64 .IR <pathoutgoing\ in\ inn.conf>/sitename .
65 To prevent batchfile corruption,
66 .IR shlock (1)
67 is used to ``lock'' these files.
68 .SH OPTIONS
69 .TP
70 .B "\-d"
71 The ``\-d'' flag causes
72 .I nntpsend
73 to send output to stdout rather than the log file
74 .IR <pathlog\ in\ inn.conf>/<program-name>.log .
75 .SH NOTES
76 You should probably not use send-nntp, but
77 .IR innfeed ,
78 or if that is not possible,
79 .IR nntpsend .
80 .PP
81 The usual flags for a batch file for send-nntp are ``\fBTf,Wfm\fP''.
82 .SH "SEE ALSO"
83 newsfeeds(5),
84 nntpsend(8)