# DIABLO.CONFIG	- read by all diablo utilities to set diablo system-wide
#		  options.  Diablo does not auto-reparse this file on 
#		  modification, you must restart diablo.
#

# version X.Y
#
#	options file version.  The file must begin with a version command.
#	It then contains options related to that version.  The file may then
#	optionally contain another version command and options related to THAT
#	version.  Diablo will ignore options for versions greater then the
#	code scanning the options file.  This allows diablo to report parsing
#	errors in a forward & backwards compatible manner.
#
version	1.16

#########################################################################
#									#
#			DIABLO SERVER OPTIONS				#
#									#
#########################################################################

# expire reader/feeder
#
#	The default is feeder, which uses a straight FIFO expiration.  Setting
#	the expire mode to reader eats about 6x the number of open descriptors
#	but around the same number of files in the spool and allows diablo
#	use a variable group-based expire.
#
#	note: if you set the expiration mode to reader, read
#	samples/dexpire.ctl for information on how to program the expiration
#	fields, which work as percentages now.
#
#	If you are using the diablo server as a spool for the diablo reader
#	(where the reader is usually running on another machine), you want
#	to set the expire mode to reader to give yourself better control
#	over expirations.

expire	reader		

# hash	METHOD[/COMPATIBLE-METHOD]
# hash	prime		<--- original hash method
# hash	crc/prime	<--- recommended when switching from prime
# hash  crc		<--- recommended after stabilized with crc or w/ new
#			     installation
#
#	Specify the hash method.  'prime' is the original hash method.  The new
#	hash method is 'crc'.  The new crc method generates fewer collisions
#	and is recommended.
#
#	You can have diablo fallback to an older hash method if a lookup using
#	the new method fails.  This is only used when migrating from one hash
#	method to another and CAUSES DIABLO TO MAKE TWICE AS MANY HISTORY 
#	LOOKUPS!  The suggestion is that you set it to 'crc/prime' when
#	upgrading from diablo 1.13 or older.  After a week or two of operation
#	you should then set it to just 'crc' and restart diablo.
#
hash	crc

# hsize	1m/2m/4m/8m/16m	('k' or 'm' only)
#
#	Hash table size, in entries.  The default is 4 million entries (16MB).
#	The hash table is chained so you can't run out, but a smaller hash 
#	table will result in more chain links and less efficient operation.
#
#	This option can be changed on the fly, the next biweekly admin will
#	resize the hash table.  Note that the -h option to diload will override
#	this setting just as this setting will override any compiled default.
hsize	4m

# active on/off/absolute-path
# activedrop on/off
#
#	(see samples/diablo.config for detailed instructions).
#
# The setup is to allow the reader to be the master for article numbering.
#
# If I wanted the feeder to be the master article number reference rather
# then the reader, and also have the feeder drop articles for groups not
# found in the active file, I would do this:
#
#	active on
#	activedrop on
#
# Note that the feeder does not use the 'NE' field but instead uses the 'NX'
# field so as not to interfere with the reader's use of the 'NE' field.  The
# feeder and reader have to account the ending article number separately
# due to the feeder->reader article transfer delay.
#

active	off
activedrop off

# slave on/off
#
#	Turn on or off Xref: slave mode.  The default is off, which causes
#	Diablo to strip incoming Xref: headers and, if active is on, 
#	generate it's own Xref: headers.
#
#	If slave mode is on Diablo will not strip incoming Xref: headers and
#	will NOT generate it's own.
#
slave	off

# maxconnect N
# maxconnect 15
#
#	Specify the maximum number of parallel connections per connecting IP.
#	This is an overall maximum.  The maxconnect field in dnewsfeeds must
#	be less then this parameter to override it.
#
#	IF DREADERD CONNECTS TO THIS DIABLO, USE A LARGE MAXCONNECT (like 50)
#
maxconnect	100

# remember N
#
#	Specify the history retention for diablo.  If not specified here,
#	the compiled default is used.  This parameter will override the
#	compiled default for both the diablo binary and the didump -x binary.
#
#remember 15
#remember 7
#remember 3

#########################################################################
#									#
#			DIABLO READER OPTIONS				#
#									#
#########################################################################

readerforks	5
readerthreads 	40
readercache	off
#
#	Specify the number of reader processes (forks), and number of
#	threads per process.  A thread limitation exists dependant on
#	the number of descriptors your system supports, one descriptor
#	is required per thread.
#
#	A fork limitation exists in that each reader fork will open up all
#	server connections (/news/dserver.hosts), eating a base number of
#	descriptors for fork.
#
#	The default is 10 forks, 40 threads = 400 online readers.  You can
#	up these values considerably.  for example, 25 forks and 40 threads
#	would support 1000 simultanious readers.  But be careful.. the diablo
#	feeder side, by default, allows only 15 simultanious connections 
#	(see maxconnect above).  
#
#	The settings above are for 5 forks and 40 threads = 200 online readers.
#	When increasing the number of forks, be sure that the remote spools 
#	can handle the increased number of simultanious connections.
#

#
#	There are a few other options which can be used here; look at the
#	diablo.config file in the ../samples directory.
#