#$Id: nntpcache.servers-dist,v 1.4 2002/03/30 03:07:30 proff Exp $

# We support both # style line comments and /* */ block comments

## This file defines which nntp servers nntpcache uses. The reason for the
## Interface address is that if you're connecting to more than one server it
## probably means you have more than one gateway, which may well mean you
## have more than one IP address, so nntpcache allows you to configure
## which one of them you connect to each server as. A bind address of
## 0.0.0.0 or DEFAULT will select the system default address.

## A timeout of 0 means not to cache anything of that type from the
## specified server. Use this for servers on the same machine or on a
## fast local ethernet or when using nntpcache as a mere proxy.

## As in nntpcache.access, this file is parsed from the general to the
## specific, from the top to the bottom. The LAST MATCH IS DOMINANT
## over preceding matches.

## the trailing "." anchor on some of the hostnames in the examples is to speed
## up DNS lookups (i.e local domain lookups are not performed). This isn't
## something perculiar to nntpcache. Try it for yourself next time you telnet :)

## examples follow.
##
## nb. in the proxy examples, caching is turned off. This is just to show that
##     nntpcache can work like a regular plug-gw style proxy. however there is
##     no *need* to turn caching off
##
## nb. the "localhost:120" entries refer to innd (or another news server)
##     which has been configured to run on port 120 to handle local groups
##     without conflicting with nntpcache (on port 119). If you want to know
##     how to do this, consult README.INN for details.

##-----------------------------------------------------------------------------
## Example: firewall proxy (no caching), one NNTP server, no local groups
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#news.feed.com	DEFAULT       	0	0	0	0	0	0
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: same as above, but we force binding to an interface on the dmz side
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#news.feed.com	198.8.7.6      	0	0	0	0	0	0
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: leaf machine, slow link, one NNTP server, no local groups, authinfo
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#user:pass@news.feed.com	DEFAULT       	4h	2d	2d	30m	60d	60d
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: leaf machine, slow link, one NNTP server, no local groups, one user
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#news.feed.com	DEFAULT       	4h	2d	2d	1m	60d	60d
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: leaf machine, fast link, one NNTP server, no local groups, authinfo
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#user:pass@news.feed.com	DEFAULT       	20m	2d	2d	15m	60d	60d
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: average machine, slow link, one (remote) NNTP server, local groups
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#localhost:120	localhost     	10m	12h	12h	10m	0	0
#news.feed.com	DEFAULT       	4h	2d	2d	30m	60d	60d
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
#local.*		localhost:120
#foobox.*	localhost:120
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: average machine, three (remote) NNTP servers, local groups, authinfo
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#localhost:120	localhost     	10m	12h	12h	10m	0	0
#user:pass@news.feed.com	DEFAULT       	4h	2d	2d	30m	60d	60d
#msnews.microsoft.com  DEFAULT  24h	4d	4d	30m	60d	60d
#news.intel.com  DEFAULT	24h	4d	4d	30m	60d	60d
#%BeginGroups
## Group pattern	Host
#*		news.feed.com
#local.*		localhost:120
#foobox.*	localhost:120
#microsoft.*	msnews.microsoft.com
#intel.*		news.intel.com
##-----------------------------------------------------------------------------

##-----------------------------------------------------------------------------
## Example: central cache for large ISP with multiple POPs. In this example
##          the inn.machine is on the same ether/fddi as the nntpcache box. It
##	   may even be on the SAME machine (provided you specify a different
##	   port). The function of nntpcache in this example is to take load
##	   off the inn news-server. nntpcache uses very little (non-shared)
##	   additional memory per reader and is much more efficient than
##	   inn/nnrpd. Ideally all the POPs are running nntpcache also (see
##	   the leaf examples above.
##	   
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts
#inn.machine	DEFAULT       	10m	20m	20	10m	10d	10d
#%BeginGroups
## Group pattern	Host
#*		inn.machine
##-----------------------------------------------------------------------------

##------------------------------------------------------------------------------
## The REAL server/group configuration appears below. Make sure you
## change it to reflect your site/POPs. Reapeat! This is just an
## example! And a big one at that!
##
## Ordering of the servers list *is* important. In cases where
## nntpcache doesn't know which server to consult (e.g someone
## requested an article by <msgid>) nntpcache will consult the
## "current" server then all of the other server's in order. This means
## you should place servers most likely to have an article picked at
## random (<msgid>'s are essentially random) first. However, if the
## server is relatively expensive to talk to (RTT/distance wise) you
## might want to consider preceeding it by servers on the local
## intranet, which although possibly unlikely to have a random article
## are quick/cheap to talk to)
##				/*              timeouts                 */
## host:port	Interface	Active	Act.tim	Newsgrp	Group	Xover	Arts

## the localhost:120 entry below is for an INN news-server running on 
## localhost, port 120. We use this to serve local groups. Make sure you
## uncomment this if you are running a news server on port 120 and want
## local groups
#localhost:120	localhost	30m	24h	24h	10m	0m	0m

## Uncomment this to the name of your main NNTP news feed. We run a
## multi-homed host, and nntp.world.net won't talk to us unless the
## traffic is eminating from our 198.142.2.24 interface. Unless you are
## running multi-homed (and maybe even then) you will probably want to
## use "DEFAULT" as the interface address for your most/all of your
## servers.
#nntp.world.net  198.142.2.24 	4h	24h	2d	30m	60d	60d

## various additional servers. these are real (and mostly thanks to
## Alan Brown), but no doubt a couple of have fallen to the dark forces
## of entropy by the time you read this
#
#forums.macromedia.com         DEFAULT         24h     4d      4d      30m	60d     60d
#jazz.trumpet.comau.           DEFAULT         24h     4d      4d      30m	60d     60d
#news.activeie.com             DEFAULT         24h     4d      4d      30m	60d     60d
#news.interaktiv-media.se.      DEFAULT         24h     4d      4d      30m	60d     60d
#adesknews.autodesk.com         DEFAULT         24h     4d      4d      30m	60d     60d
#beetle.privatei.com            DEFAULT         24h     4d      4d      30m	60d     60d
#cnews.corel.com                DEFAULT         24h     4d      4d      30m	60d     60d
#cor.newman.upenn.edu.           DEFAULT         24h     4d      4d      30m	60d     60d
#forums.borland.com             DEFAULT         24h     4d      4d      30m	60d     60d
#forums.powersoft.com           DEFAULT         24h     4d      4d      30m	60d     60d
#hope.harvard.net               DEFAULT         24h     4d      4d      30m	60d     60d
#massena.com                    DEFAULT         24h     4d      4d      30m	60d     60d
#miriam.fuller.edu.              DEFAULT         24h     4d      4d      30m	60d     60d
#msnews.microsoft.com           DEFAULT         24h     4d      4d      30m	60d     60d
#news.3dfx.com                  DEFAULT         24h     4d      4d      30m	60d     60d
#news.avault.com                DEFAULT         24h     4d      4d      30m	60d     60d
#news.glbs.com                  DEFAULT         24h     4d      4d      30m	60d     60d
#news.ksc.nasa.gov.              DEFAULT         24h     4d      4d      30m	60d     60d
#news.linkexchange.com          DEFAULT         24h     4d      4d      30m	60d     60d
#news.netobjects.com            DEFAULT         24h     4d      4d      30m	60d     60d
#news.sff.net                   DEFAULT         24h     4d      4d      30m	60d     60d
#news.turbopower.com            DEFAULT         24h     4d      4d      30m	60d     60d
#newsgroups.intel.com           DEFAULT         24h     4d      4d      30m	60d     60d
#nntp.net-link.net              DEFAULT         24h     4d      4d      30m	60d     60d          
#publicnews.msn.com             DEFAULT         24h     4d      4d      30m	60d     60d
#secnews.netscape.com           DEFAULT         24h     4d      4d      30m	60d     60d
#service.symantec.com           DEFAULT         24h     4d      4d      30m	60d     60d

# this line is magic. keep it.
%BeginGroups

# Understand the ordering here! The general instance should come first!

# replace the next line with your "main" server
#*		nntp.world.net

# the next line represents our local groups running on innd on port
# 120 from the same machine. you definately want to change suburbia.*
# to the name(s) of your local groups
#suburbia.*	localhost:120

# additional groups follow

#
#trumpet.*      jazz.trumpet.comau.
#
#3dfx.*          news.3dfx.com
#
##
#alt.oui.support* beetle.privatei.com
#
##
#asp.*,audioweb.*,crescent.*,db.*,glbs.*,ntworthy*,powerbasic.*,woll2woll*           news.glbs.com
#
##
#autodesk.*      adesknews.autodesk.com
#
##
#avault.*,forum.*        news.avault.com
#
##
#borland.*       forums.borland.com
#
##
#cakewalk.*      hope.harvard.net
#
##
#corel.*         cnews.corel.com
#
##
#intel.*         newsgroups.intel.com   
#
##
#le.*            news.linkexchange.com
#
##
#linux.*         miriam.fuller.edu.
#
##
#mail.winvn      news.ksc.nasa.gov.
#
##
#microsoft.*     msnews.microsoft.com
#
## microsoft network
#msn.*           publicnews.msn.com
#
##
#net-link.*      nntp.net-link.net
#
##
#netobjects.*    news.netobjects.com
#
##
#netscape.*,people.*      secnews.netscape.com
#
##
#perl.porters-gw cor.newman.upenn.edu.
#
##
#pilot.*         massena.com
#
##
#powersoft.*,sybase.*     forums.powersoft.com
#
##
#sff.*           news.sff.net
#
##
#symantec.*      service.symantec.com
#
##
#turbopower.*    news.turbopower.com
