1NNTPGET(1)                InterNetNews Documentation                NNTPGET(1)
2
3
4

NAME

6       nntpget - Get Usenet articles from a remote NNTP server
7

SYNOPSIS

9       nntpget [-ov] [-f file] [-n newsgroups] [-t timestring] [-u file] host
10

DESCRIPTION

12       nntpget connects to the NNTP server at the specified host and retrieves
13       articles from it.  The Message-IDs of the desired articles are read
14       from standard input.  The articles are sent to standard output.
15
16       Instead of reading Message-IDs from standard output, the -f, -n, -t and
17       -u options make use of the "NEWNEWS" command, which may not be
18       available on the remote server.  Only one of the -f, -t or -u option
19       may be given at the same time; -n can be specified only if one of the
20       other three options is in use.
21
22       If authentication credentials are present for the remote server in the
23       passwd.nntp file in pathetc, then nntpget will use them to
24       authenticate.
25

OPTIONS

27       -f file
28           The list of article Message-IDs is normally read from standard
29           input.  If this option is used, then a "NEWNEWS" command is used to
30           retrieve all articles newer than the modification date of the
31           specified file.
32
33       -n newsgroups
34           If either the -f, -t or -u options are used, then this option may
35           be used to limit the responses to only the newsgroups (if any)
36           whose names match the list.  The default is "*", that is to say all
37           newsgroups are wanted.
38
39           The newsgroups list can contain several patterns and wildmat
40           characters.  For instance "misc.*,!*.test" is a valid list that
41           will be given to the "NEWNEWS" command.
42
43       -o  This option may be used only if the command is executed on the host
44           where the innd server is running.  If this option is used, nntpget
45           connects to the specified remote host to retrieve articles.  Any
46           article not present in the local history database is then fetched
47           from the remote site and offered to the local server.
48
49           Articles are not written to standard output.  Only processed
50           Message-IDs are, if the -v option is also used.
51
52       -t timestring
53           If this option is used, then the specified timestring is used as
54           the time and date parameter to the "NEWNEWS" command.  Only the
55           articles arrived in the remote server since that timestamp are
56           retrieved.
57
58           The timestring is specified as "yyyymmdd hhmmss GMT" where "yyyy"
59           is the year, "mm" the month, "dd" the day of the month, "hh" the
60           hours in the 24-hour clock, "mm" the minutes, and "ss" the seconds.
61           The token "GMT" specifies that the date and time are given in
62           Coordinated Universal Time.
63
64       -u file
65           This option is like -f except that if the transfer succeeds, the
66           file will be updated with a statistics line, modifying its
67           timestamp so that it can be used in later invocations.
68
69       -v  If this option is used with -o, then the Message-ID of each article
70           will be sent to standard output as it is processed.
71

HISTORY

73       Written by Rich $alz <rsalz@uunet.uu.net> for InterNetNews.  Rewritten
74       into POD by Julien Elie.
75

SEE ALSO

77       innd(8), passwd.nntp(5).
78
79
80
81INN 2.7.1                         2022-07-10                        NNTPGET(1)
Impressum