1NNTPGET(1) InterNetNews Documentation NNTPGET(1)
2
3
4
6 nntpget - Get Usenet articles from a remote NNTP server
7
9 nntpget [-ov] [-d dist] [-f file] [-n newsgroups] [-t timestring] [-u
10 file] host
11
13 nntpget connects to the NNTP server at the specified host and retrieves
14 articles from it. The Message-IDs of the desired articles are read
15 from standard input. The articles are sent to standard output.
16
17 Instead of reading Message-IDs from standard output, the -d, -f, -n, -t
18 and -u options make use of the "NEWNEWS" command, which may not be
19 available on the remote server. Only one of the -f, -t or -u option
20 may be given at the same time; -d and -n can be specified only if one
21 of the other three options is in use.
22
23 If authentication credentials are present for the remote server in the
24 passwd.nntp file in pathetc, then nntpget will use them to
25 authenticate.
26
28 -d dist
29 This option may be used to specify a distribution list when using
30 the -f, -t or -u options. The default is no distribution list.
31
32 -f file
33 The list of article Message-IDs is normally read from standard
34 input. If this option is used, then a "NEWNEWS" command is used to
35 retrieve all articles newer than the modification date of the
36 specified file.
37
38 -n newsgroups
39 If either the -f, -t or -u options are used, then this option may
40 be used to limit the responses to only the newsgroups (if any)
41 whose names match the list. The default is "*", that is to say all
42 newsgroups are wanted.
43
44 The newsgroups list can contain several patterns and wildmat
45 characters. For instance "misc.*,!*.test" is a valid list that
46 will be given to the "NEWNEWS" command.
47
48 -o This option may be used only if the command is executed on the host
49 where the innd server is running. If this option is used, nntpget
50 connects to the specified remote host to retrieve articles. Any
51 article not present in the local history database is then fetched
52 from the remote site and offered to the local server.
53
54 Articles are not written to standard output. Only processed
55 Message-IDs are, if the -v option is also used.
56
57 -t timestring
58 If this option is used, then the specified timestring is used as
59 the time and date parameter to the "NEWNEWS" command. Only the
60 articles arrived in the remote server since that timestamp are
61 retrieved.
62
63 The timestring is specified as "yyyymmdd hhmmss GMT" where "yyyy"
64 is the year, "mm" the month, "dd" the day of the month, "hh" the
65 hours in the 24-hour clock, "mm" the minutes, and "ss" the seconds.
66 The token "GMT" specifies that the date and time are given in
67 Coordinated Universal Time.
68
69 -u file
70 This option is like -f except that if the transfer succeeds, the
71 file will be updated with a statistics line, modifying its
72 timestamp so that it can be used in later invocations.
73
74 -v If this option is used with -o, then the Message-ID of each article
75 will be sent to standard output as it is processed.
76
78 Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews. Rewritten
79 into POD by Julien Elie.
80
82 innd(8), passwd.nntp(5).
83
84
85
86INN 2.6.5 2022-01-23 NNTPGET(1)