Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
NNTPGET(1)		   InterNetNews Documentation		      NNTPGET(1)

NAME
     nntpget - Get Usenet articles from a remote NNTP server

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

DESCRIPTION
     nntpget connects to the NNTP server at the specified host and retrieves ar-
     ticles  from  it.	 The  Message-IDs  of the desired articles are read from
     standard input.  The articles are sent to standard output.

     Instead of reading Message-IDs from standard output, the -f, -n, -t and  -u
     options  make  use  of the "NEWNEWS" command, which may not be available on
     the remote server.  Only one of the -f, -t or -u option may be given at the
     same time; -n can be specified only if one of the other three options is in
     use.

     If authentication credentials are present for  the  remote  server  in  the
     passwd.nntp file in pathetc, then nntpget will use them to authenticate.

OPTIONS
     -f file
	 The  list  of article Message-IDs is normally read from standard input.
	 If this option is used, then a "NEWNEWS" command is  used  to	retrieve
	 all articles newer than the modification date of the specified file.

     -n newsgroups
	 If  either  the  -f, -t or -u 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 "*", that is to say all newsgroups  are
	 wanted.

	 The  newsgroups  list	can contain several patterns and wildmat charac-
	 ters.	For instance "misc.*,!*.test" is a valid list that will be given
	 to the "NEWNEWS" command.

     -o  This option may be used only if the command is  executed  on  the  host
	 where the innd server is running.  If this option is used, nntpget con-
	 nects	to  the specified remote host to retrieve articles.  Any article
	 not present in the local history database is then fetched from the  re-
	 mote site and offered to the local server.

	 Articles  are	not written to standard output.  Only processed Message-
	 IDs are, if the -v option is also used.

     -t timestring
	 If this option is used, then the specified timestring is  used  as  the
	 time  and  date  parameter to the "NEWNEWS" command.  Only the articles
	 arrived in the remote server since that timestamp are retrieved.

	 The timestring is specified as "yyyymmdd hhmmss GMT"  where  "yyyy"  is
	 the  year, "mm" the month, "dd" the day of the month, "hh" the hours in
	 the 24-hour clock, "mm" the minutes, and "ss" the seconds.   The  token
	 "GMT" specifies that the date and time are given in Coordinated Univer-
	 sal Time.

     -u file
	 This  option  is like -f 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.

     -v  If this option is used with -o, then the  Message-ID  of  each  article
	 will be sent to standard output as it is processed.

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

SEE ALSO
     innd(8), passwd.nntp(5).

INN 2.8.0			   2021-12-04			      NNTPGET(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=nntpget&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help