news2mail(8)


NAME

   news2mail - Channel script to gateway news into e-mails

SYNOPSIS

   news2mail

DESCRIPTION

   news2mail runs as a channel process underneath innd.  It is set up as
   channel feed in newsfeeds, with different mailing-lists as funnel
   entries pointing to it (see below); news2mail expects the token of an
   article followed by a sequence of list names.

   news2mail uses the configuration file pathetc/news2mail.cf to map
   mailing-list names to e-mail addresses.  news2mail causes sendmail to
   queue the messages for later delivery (to avoid DOS attacks by mass
   postings).  You must run "sendmail -q" periodically to get the queue
   processed.

CONFIGURATION FILE

   The configuration file format is simple:  comments (starting with a
   hash sign "#") and blank lines are ignored.  All other lines have two
   or three fields on them.  The first is the list name and is what innd
   uses (i.e. the site field of the entry in the newsfeeds file).  The
   second field is the actual e-mail address to send the article to.  The
   third field is optional: it sets the envelope-from address (for
   instance a list member's address; if not set, it defaults to the "news"
   user).

   In e-mail messages, the To: header will have the mailing-list address
   (i.e. the second field).  Besides, news2mail strips most article
   headers from the article before mailing.

   In newsfeeds, the channel feed should look like:

       news2mail!:!*:Ac,Tc,Wn*:<pathbin>/news2mail

   and for each mailing-list, you only have to add to newsfeeds an entry
   list like:

       list-big-red-ants/lists.ucsd.edu:!*,rec.pets.red-ants:Ap,Tm:news2mail!

   Please note the use of "Ap" and the exclusion of the list owner domain
   to protect the list from feeding back new arrivals from the list.  The
   site name used in the newfeeds entry for a mailing-list (above
   "list-big-red-ants") must be the same as the first field in an entry in
   news2mail.cf.  For instance:

       # Newsfeeds-name      List-to-address                 [List-sender-address]
       list-big-red-ants     big-red-ants@lists.ucsd.edu     news+big-red-ants@local.news.server.org

FILES

   pathbin/news2mail
       The Perl program itself used to gateway news into e-mails.

   pathetc/news2mail.cf
       The configuration file which specifies the mapping to use for
       gatewaying.

BUGS

   The news2mail program is set up as a funneled channel in newsfeeds,
   implying multiple matches should be handled as one - and multiple
   matching funneled feeds will result in a single call to the script.
   Therefore, since only one mail is sent, crossposts are not currently
   properly handled as for the envelope-from address (which then defaults
   to the "news" user).

HISTORY

   news2mail was written by Brian Kantor in 1998.  This man page was
   written by James Brister and converted to POD by Julien Elie.  The
   third optional field in news2mail.cf was added by D. Stussy in 2008.

   $Id: news2mail.pod 8199 2008-11-30 13:30:47Z iulius $

SEE ALSO

   innd(8), newsfeeds(5).





Opportunity


Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.

Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.





Free Software


Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.


Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.





Free Books


The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.


Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.





Education


Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.


Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.