.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" 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
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    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
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "NNTPGET 1"
.TH NNTPGET 1 "2022-07-10" "INN 2.7.1" "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"
nntpget \- Get Usenet articles from a remote NNTP server
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBnntpget\fR [\fB\-ov\fR] [\fB\-f\fR \fIfile\fR] [\fB\-n\fR \fInewsgroups\fR]
[\fB\-t\fR \fItimestring\fR] [\fB\-u\fR \fIfile\fR] \fIhost\fR
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
\&\fBnntpget\fR connects to the \s-1NNTP\s0 server at the specified \fIhost\fR and retrieves
articles from it.  The Message-IDs of the desired articles are read from
standard input.  The articles are sent to standard output.
.PP
Instead of reading Message-IDs from standard output, the \fB\-f\fR, \fB\-n\fR,
\&\fB\-t\fR and \fB\-u\fR options make use of the \f(CW\*(C`NEWNEWS\*(C'\fR command, which may not
be available on the remote server.  Only one of the \fB\-f\fR, \fB\-t\fR or \fB\-u\fR
option may be given at the same time; \fB\-n\fR can be specified only if one
of the other three options is in use.
.PP
If authentication credentials are present for the remote server in the
\&\fIpasswd.nntp\fR file in \fIpathetc\fR, then \fBnntpget\fR will use them to
authenticate.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-f\fR \fIfile\fR" 4
.IX Item "-f file"
The list of article Message-IDs is normally read from standard input.
If this option is used, then a \f(CW\*(C`NEWNEWS\*(C'\fR command is used to retrieve all
articles newer than the modification date of the specified \fIfile\fR.
.IP "\fB\-n\fR \fInewsgroups\fR" 4
.IX Item "-n newsgroups"
If either the \fB\-f\fR, \fB\-t\fR or \fB\-u\fR options are used, then this option may be
used to limit the responses to only the newsgroups (if any) whose names match
the list.  The default is \f(CW\*(C`*\*(C'\fR, that is to say all newsgroups are wanted.
.Sp
The \fInewsgroups\fR list can contain several patterns and wildmat characters.
For instance \f(CW\*(C`misc.*,!*.test\*(C'\fR is a valid list that will be given to the
\&\f(CW\*(C`NEWNEWS\*(C'\fR command.
.IP "\fB\-o\fR" 4
.IX Item "-o"
This option may be used only if the command is executed on the host where the
\&\fBinnd\fR server is running.  If this option is used, \fBnntpget\fR connects to
the specified remote \fIhost\fR to retrieve articles.  Any article not present
in the local \fIhistory\fR database is then fetched from the remote site and
offered to the local server.
.Sp
Articles are not written to standard output.  Only processed Message-IDs are,
if the \fB\-v\fR option is also used.
.IP "\fB\-t\fR \fItimestring\fR" 4
.IX Item "-t timestring"
If this option is used, then the specified \fItimestring\fR is used as the time
and date parameter to the \f(CW\*(C`NEWNEWS\*(C'\fR command.  Only the articles arrived
in the remote server since that timestamp are retrieved.
.Sp
The \fItimestring\fR is specified as \f(CW\*(C`yyyymmdd hhmmss GMT\*(C'\fR where \f(CW\*(C`yyyy\*(C'\fR is the
year, \f(CW\*(C`mm\*(C'\fR the month, \f(CW\*(C`dd\*(C'\fR the day of the month, \f(CW\*(C`hh\*(C'\fR the hours in the
24\-hour clock, \f(CW\*(C`mm\*(C'\fR the minutes, and \f(CW\*(C`ss\*(C'\fR the seconds.  The token \f(CW\*(C`GMT\*(C'\fR
specifies that the date and time are given in Coordinated Universal Time.
.IP "\fB\-u\fR \fIfile\fR" 4
.IX Item "-u file"
This option is like \fB\-f\fR except that if the transfer succeeds, the file
will be updated with a statistics line, modifying its timestamp so that it
can be used in later invocations.
.IP "\fB\-v\fR" 4
.IX Item "-v"
If this option is used with \fB\-o\fR, then the Message-ID of each article will
be sent to standard output as it is processed.
.SH "HISTORY"
.IX Header "HISTORY"
Written by Rich \f(CW$alz\fR <rsalz@uunet.uu.net> for InterNetNews.  Rewritten into
\&\s-1POD\s0 by Julien Elie.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBinnd\fR\|(8), \fBpasswd.nntp\fR\|(5).