home *** CD-ROM | disk | FTP | other *** search
/ YPA: Your Privacy Assured / YPA.ISO / other_goodies / utilities / iu-14-as225.lha / INetUtils-1.4 / docs / NNTPpost.man < prev    next >
Text File  |  1993-10-24  |  4KB  |  99 lines
  1. NNTPpost                                                                NNTPpost
  2.  
  3.  
  4. NAME
  5.  
  6.         NNTPpost - post a news article using NNTP
  7.  
  8.  
  9. SYNOPSIS
  10.  
  11.         NNTPpost [-f username] [-r realname] [-R referencesfile]
  12.                  [-x filetobedeleted] articlefile | <articlefile
  13.  
  14.  
  15. DESCRIPTION
  16.  
  17.         NNTPpost attempts to open a TCP/IP socket to the host defined
  18.         by the NNTPSERVER environment variable at its NNTP port. That
  19.         port is normally 119 (refer to RFC-977 for details on NNTP).
  20.  
  21.         If the connection succeeds, NNTPpost will submit "articlefile"
  22.         as a news article. If an error occurs, NNTPpost will display
  23.         the error, as well as log the error to the INet logfile (by
  24.         default, "INet:Logfile", but this may be changed by using the
  25.         LOGFILE environment variable).
  26.  
  27.         "articlefile" may be specified on the command line, or as the
  28.         standard input.
  29.  
  30.         If NNTP Authentication is required, the environment variables
  31.         NNTPuserid and NNTPpassword must be present. When they are,
  32.         and the NNTP server requests authentication, NNTPpost will
  33.         perform the requisite transactions.
  34.  
  35.         Options:
  36.  
  37.             -f username : The username to be used in building a From
  38.                           header in the article. Note that if a From
  39.                           header already exists in the article, then
  40.                           NNTPpost will not create another one.
  41.  
  42.             -r realname : The realname to be used in building a From
  43.                           header in the article.
  44.  
  45.             -R reffile  : This causes a file named "reffile" to be
  46.                           inserted in the article as part of the headers.
  47.                           This is typically used for such items as the
  48.                           References header and for user-specified
  49.                           headers.
  50.  
  51.             -x delfile  : This causes a file named "delfile" to be
  52.                           deleted after the article is posted. There
  53.                           may be up to 32 -x arguments. The files are
  54.                           only deleted if the post succeeds.
  55.  
  56.         Note that NNTP requires three headers: Newsgroups, From, and
  57.         Subject. NNTPpost will generate a From header if it does not
  58.         exist in "articlefile". NNTPpost will also generate a Date and
  59.         a Message-ID header if they are not present in "articlefile".
  60.         Thus, the following four lines represent a minimal article:
  61.  
  62.         Newsgroups: local.test
  63.         Subject: Test of NNTPpost
  64.  
  65.         Just a tiny test.
  66.  
  67.         The NNTP server will generate other headers, required and otherwise.
  68.  
  69.  
  70. DIAGNOSTICS
  71.  
  72.         Upon success, NNTPpost has a return status of zero, and no
  73.         messages are printed.
  74.  
  75.         Upon failure of any kind, NNTPpost prints a message to standard
  76.         output, and has an exit status of 30. NNTPpost also prints the
  77.         error message in LOGFILE (normally INet:Logfile).
  78.  
  79.  
  80. NOTES
  81.  
  82.         NNTPpost *does* *not* *queue*. If the server isn't available
  83.         when NNTPpost tries to send the article, then the article
  84.         doesn't go.
  85.  
  86.         NNTPpost duplicates the arguments used by the AmigaUUCP Postnews.
  87.         It can be dropped-in as a replacement for that.
  88.  
  89.         NNTPpost has been tested with AmigaUUCP, GRn, and BBX.
  90.  
  91.         If NNTPpost must generate a From header, it requires that USERNAME,
  92.         HOSTNAME (or NODENAME) and DOMAINNAME be defined either as environment
  93.         variables, or in UULib:Config.
  94.  
  95.  
  96. BUGS/TODO
  97.  
  98.         None known.
  99.