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).