Provided by: inn_1.7.2q-39_i386 bug

NAME

       inews - send a Usenet article to the local news server for distribution

SYNOPSIS

       inews [ -h ] [ -D ] [ -O ] [ -R ] [ -S ] [ header_flags ] [ input ]

DESCRIPTION

       Inews reads a Usenet news article (perhaps with headers) from the named
       file  or  standard input if no file is given.  It adds some headers and
       performs some consistency checks.  If the article does not  meet  these
       checks  (for  example,  too much quoting of old articles, or posting to
       non-existent newsgroups) then the article is rejected.   If  it  passes
       the  checks,  inews  sends  the  article  to  the  local news server as
       specified in the inn.conf(5) file for distribution.

OPTIONS

       -h     In the standard mode of operation, the  input  consists  of  the
              article  headers,  a  blank  line,  and  the  message body.  For
              compatibility with older software, the ‘‘-h’’ flag must be used.
              If  there  are  no headers in the message, then this flag may be
              omitted.

       -O     The default Organization header will  be  provided  if  none  is
              present  in  the  article or if the ‘‘-o’’ flag is not used.  To
              prevent adding the default, use the ‘‘-O’’ flag.

       -D     As a debugging aide, if the ‘‘-D’’ flag is used, the consistency
              checks  will  be  performed, and the article will be sent to the
              standard output, rather then sent to the server.

       -A -V -W
              For compatibility with C News, inews accepts, but  ignores,  the
              ‘‘-A’’, ‘‘-V’’ and ‘‘-W’’ flags.

       -N     The C News ‘‘-N’’ flag is treated as the ‘‘-D’’ flag.

       -S     If  a file named .signature exists in the user’s home directory,
              inews will try to append it to the end of the article.   If  the
              file  cannot  be  read,  or if it is too long (for example, more
              than four lines or one standard I/O buffer), or  if  some  other
              problem  occurs,  then  the  article  will  not  be  posted.  To
              suppress this action use the ‘‘-S’’ flag.

       -R     If the ‘‘-R’’ flag is used then inews will reject  any  attempts
              to post control messages.

       header_flags
              Several  headers  may be specified on the command line, shown in
              the synopsis above as header_flags.  Each of these flags takes a
              single  parameter;  if  the  value  is  more  than one word (for
              example, almost all Subject lines) then quotes must be  used  to
              prevent  the  shell  from splitting it into multiple words.  The
              options, and their equivalent header, are as follows:

                  a       Approved
                  c       Control
                  d       Distribution
                  e       Expires
                  f       From
                  w       Followup-To
                  n       Newsgroups
                  r       Reply-To
                  t       Subject
                  F       References
                  o       Organization
                  x       Path prefix

              If the ‘‘-x’’ flag is used, then its value will be the start  of
              the header.  Any other host will see the site in the header, and
              therefore not offer the article to that  site.   The  Path  will
              always end not-for-mail.

NOTES

       If  an  unapproved posting is made to a moderated newsgroup, inews will
       try to mail the article to the moderator for posting.   It  will  query
       the  remote  news  server  for  a  moderators  listing. If that doesn’t
       succeed, it will fallback to using  the  local  moderators(5)  file  to
       determine the mailing address.  If no address is found, it will use the
       inn.conf file to determine a ‘‘last-chance’’ host to try.

       If the NNTP server needs to authenticate the client, inews will use the
       NNTPsendpassword(3)  routine  to  authenticate  itself.  In order to do
       this, the program will need read access  to  the  passwd.nntp(5)  file.
       This  is  typically  done  by having the file group-readable and making
       inews run setgid to that group.

       Inews exits with a zero status if the article was succesfully posted or
       mailed,  or  with  a  non-zero  status  if  the  article  could  not be
       delivered.

       Since inews will spool its input if the server is  unavailable,  it  is
       usually  necessary  to  run  rnews(1) with the ‘‘-U’’ flag on a regular
       basis, usually out of cron(8).

HISTORY

       Written by Rich $alz <rsalz@uunet.uu.net> for  InterNetNews.   This  is
       revision 1.27, dated 1996/10/29.

SEE ALSO

       moderators(5), inn.conf(5).  rnews(1).

                                                                      INEWS(1)