samples/newsfeeds.in

   1 ##  $Id: newsfeeds.in 7741 2008-04-06 09:51:47Z iulius $
   2 ##
   3 ##  newsfeeds - determine where Usenet articles get sent
   4 ##
   5 ##  Format:
   6 ##      site[/exclude,exclude...]\
   7 ##              :pattern,pattern...[/distrib,distrib...]\
   8 ##              :flag,flag...\
   9 ##              :param
  10 ##
  11 ##  This file is complicated -- see newsfeeds(5) for full details.
  12
  13 ##  The ME feed entry is special magic.
  14 ##
  15 ##  "/exclude" entries for this feed entry will cause INN to reject all
  16 ##  articles that have passed through those listed sites (by matching
  17 ##  Path: entries).  There are some "pseudo-sites" in general use that can
  18 ##  be listed as exclusions to reject specific types of 3rd-party cancel
  19 ##  messages (see the "Cancel FAQ" in news.admin.net-abuse.usenet):
  20 ##
  21 ##      cyberspam       Cancels for spam, munged articles, binaries
  22 ##      spewcancel      Cancels for munged articles and runaway gateways
  23 ##      bincancel       Cancels for binary postings to non-binary groups
  24 ##      udpcancel       Cancels to force sites to enforce antispam policies
  25 ##
  26 ##  The "pattern" field for this feed entry gives the initial subscription
  27 ##  list for all other feeds specified in this file.  These patterns are
  28 ##  *prepended* to all other feed patterns.  Using this feature is
  29 ##  confusing and mildly discouraged; make sure you understand the man
  30 ##  page before using it.
  31 ##
  32 ##  "/distrib" for this feed entry specifies what distributions the server
  33 ##  will accept.  If any distributions are listed there, the server will
  34 ##  accept only articles with those distributions.  If all the
  35 ##  distributions listed are negated (starting with !), then the server
  36 ##  will only accept articles without those distributions.
  37 ##
  38 ##  For the ME line (and the ME line *only*), patterns affect *outgoing*
  39 ##  feeds and distributions affect *incoming* feeds.
  40
  41 # Empty default subscription list, reject all incoming articles with a
  42 # distribution of "local" or "collabra-internal," accept all others.
  43 ME:!*/!local,!collabra-internal::
  44
  45 # The same as the above, but would reject all posts that have
  46 # news.example.com in the path (posts passing through that site).
  47 #ME/news.example.com:!*/!local,!collabra-internal::
  48
  49 # The special feed that handles all newsgroup control messages.  Only
  50 # disable this if you want to ignore all newsgroup control messages; INN
  51 # no longer handles any control messages except cancel internally.
  52 controlchan!\
  53         :!*,control,control.*,!control.cancel\
  54         :Tc,Wnsm:@prefix@/bin/controlchan
  55
  56 ##  Uncomment if you're using innfeed.  This feed tells INN how to run
  57 ##  innfeed, and then every site you're feeding with innfeed has a
  58 ##  flag of Tm and an argument of "innfeed!" to funnel into this feed.
  59 ##  The feed pattern for innfeed should *always* be "!*"; don't ever
  60 ##  feed articles directly into innfeed.
  61 ##
  62 ##  Add "-y" as an option to startinnfeed to use the name of each feed as
  63 ##  the name of the host to feed articles to; without "-y" an innfeed.conf
  64 ##  file is needed.
  65
  66 # innfeed funnel master.
  67 #innfeed!\
  68 #       :!*\
  69 #       :Tc,Wnm*:@prefix@/bin/startinnfeed
  70
  71 ##  Only uncomment this feed if both enableoverview and useoverchan are
  72 ##  set to true in inn.conf.  By default, innd will write out overview
  73 ##  internally and doesn't need or want this feed, but useoverchan can
  74 ##  optionally be set to true and this feed uncommented to move those
  75 ##  operations out of innd's main loop.
  76
  77 # News overview.
  78 #overview!:*:Tc,WnteO:@prefix@/bin/overchan
  79
  80
  81 ##  OUTGOING NORMAL FEED EXAMPLES
  82
  83 # A real-time feed through innfeed.  Don't send articles with a distribution
  84 # of "foo", since those articles are internal.
  85 # Note that control messages will be sent even though "!control,!control.*"
  86 # is specified.  It is useful not to forget that pattern since control
  87 # messages for local.* would still be sent with "*,@local.*" only.
  88 #news.uu.net/uunet\
  89 #       :*,!junk,!control,!control.*/!foo\
  90 #       :Tm:innfeed!
  91
  92 # Create a batch file in @SPOOLDIR@/outgoing for all articles
  93 # that haven't already passed through nic.near.net.  The batch file will
  94 # be named nic.near.net, the default file name, and either nntpsend or
  95 # send-nntp can send articles from that spool file.
  96 #nic.near.net\
  97 #       :*,!junk,!control,!control.*/!foo\
  98 #       :Tf,Wnm:
  99
 100 # A UUCP feed, where we try to keep the "batching" between 4 KB and 1 KB.
 101 # You can use send-uucp(8) to process these batch files.
 102 #ihnp4\
 103 #       :*,!junk,!control,!control.*/!foo\
 104 #       :Tf,Wnb,B4096/1024:
 105
 106
 107 ##  OUTGOING SPECIAL FEED EXAMPLES
 108
 109 # Accumulate Path header statistics.  See ninpaths(8) for more details on
 110 # how to set this up.
 111 #inpaths!:*:Tc,WP:@prefix@/bin/ninpaths -p -d @LOGDIR@/path/inpaths.%d
 112
 113 # Feed all moderated source postings to an archiver.
 114 #source-archive!:!*,*sources*,!*wanted*,!*.d\
 115 #       :Tc,Wn:@prefix@/bin/archive -f -i @SPOOLDIR@/archive/INDEX
 116
 117 # News to mail gateway.  Similar to innfeed, this uses a master feed and
 118 # then individual feeds for every separate address that news is being
 119 # gated to.  This sends all posts to rec.pets.redants.* to the address
 120 # news-software@example.com.
 121 #news2mail!:!*:Tc,Ac,Wn*:@prefix@/bin/news2mail
 122 #news-software@example.com:rec.pets.redants.*:Tm:news2mail!
 123
 124 # Capture all local postings (with a distribution of "foo" and no more
 125 # than two sites in the Path) using a local program (that doesn't come with
 126 # INN).
 127 #capture\
 128 #       :*/foo\
 129 #       :Tp,H2:/usr/local/bin/capture %s