chiark / gitweb /
wip manpage
[inn-innduct.git] / doc / man / nntpget.1
1 .\" $Revision: 5909 $
2 .TH NNTPGET 1
3 .SH NAME
4 nntpget \- get Usenet articles from a remote NNTP server
5 .SH SYNOPSIS
6 .I nntpget
7 [
8 .BI \-d " dist"
9 ]
10 [
11 .BI \-f " file"
12 ]
13 [
14 .BI \-n " newsgroups"
15 ]
16 [
17 .BI \-t " timestring"
18 ]
19 [
20 .B \-o
21 ]
22 [
23 .BI \-u " file"
24 ]
25 [
26 .B \-v
27 ]
28 .I host
29 .SH DESCRIPTION
30 .I Nntpget
31 connects to the NNTP server at the specified
32 .I host
33 and retrieves articles from it. The Message-ID's of the desired articles
34 are read from standard input. The articles are sent to standard output.
35 .SH OPTIONS
36 .TP
37 .B \-o
38 The ``\-o'' option may be used only if the command is executed on the
39 host where the
40 .IR innd (8)
41 server is running.
42 If this option is used,
43 .I nntpget
44 connects to the specified remote
45 .I host
46 to retrieve articles.
47 Any article not present in the local
48 .I history
49 database is then fetched from the remote site and offered to the local server.
50 .TP
51 .B \-v
52 If the ``\fB\-v\fP'' option is used with the ``\fB\-o\fP'' option then the
53 Message-ID
54 of each article will be sent to standard output as it is processed.
55 .TP
56 .B \-f
57 The list of article Message-ID's is normally read from standard input.
58 If the ``\fB\-f\fP'' option is used, then a ``newnews'' command is used
59 to retrieve
60 all articles newer then the modification date of the specified
61 .IR file .
62 .TP
63 .B \-u
64 The ``\fB\-u\fP'' option is like ``\fB\-f\fP'' except that if the transfer
65 succeedes, the file will be updated with a statistics line, modifying its
66 timestamp so that it can be used in later invocations.
67 .TP
68 .B \-t
69 If the ``\-t'' option is used, then the specified
70 .I timestring
71 is used as the time and date parameter to the ``newnews'' command.
72 .TP
73 .B \-n
74 If either the ``\fB\-u\fP'' or ``\fB\-f\fP'' options are used, then 
75 the ``\fB\-n\fP'' option
76 may be used to specify a newsgroup list. The default is ``*''.
77 .TP
78 .B \-d
79 The ``\fB\-d\fP'' option may be
80 used to specify a distribution list when using the ``\fB\-u\fP''
81 or ``\fB\-f\fP'' options.
82 The default is no distribution list.
83 .SH HISTORY
84 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.
85 .de R$
86 This is revision \\$3, dated \\$4.
87 ..
88 .R$ $Id: nntpget.1 5909 2002-12-03 05:17:18Z vinocur $
89 .SH "SEE ALSO"
90 innd(8).