######################################################################
#
# eternity configuration file
#
# see http://www.dcs.ex.ac.uk/~aba/eternity/
#

######################################################################
# eternity directory

eternity_dir = "/home/fred/public_html/eternity/"

######################################################################
# these aren't really paths, but URLs for the eternity home dir
# (this should be the URL for the directory eternity_dir above)

eternity_url = "/~fred/eternity/"

# and the URL for eternity.cgi:

eternity_cgi = "/cgi-bin/eternity.cgi"


######################################################################
# external programs

perl5_exe = "/usr/local/bin/perl"	# perl5 (perl4 won't do)
pgp_exe = "/usr/local/bin/pgp"		# pgp 2.x
sha1_exe = "/usr/local/bin/sha1"	# C sources included for this

echo_exe = "echo"		# for systems with broken echos
				# eg for Solaris use /usr/ucb/echo
				# the problem is broken -n functionality

######################################################################
# email address for reporting configuration errors

admin_name = "Nobody"			# your name (optionally) goes here
admin_email = "nobody@dev.null"		# your email address goes here
					# don't use < or >, or you'll
					# screw up the mailto:

######################################################################
# where you would like to get your news from. 
#    
# you can uncomment one of these, or use the test spool below
#
#    news_spool = "/var/spool/news"                # use a local newspool
#    nntp_server = "news.foo.com"                  # use an nntp server
#
# also not implemented yet, but coming soon:
#
#    altavista_server = "www.altavista.digital.com"
#    dejanews_server = "www.dejanews.com"
#
# if only makes sense to set one method at the moment

# dummy news spool with some test articles (in eternity_dir) 
# change to nntp server or local news spool once you've got it working

news_spool = "news"                             # test articles


######################################################################
# cache policy?  on or off or encrypt
# 
# cache = off
#   pro: no dodgy materials on your disk
#   con: higher overhead to fetch from nntp server and decrypt
#
# cache = on
#   pro: lower overhead
#   con: plaintext dodgy materials on your disk
#
# cache = encrypt
#   pro: intermediate overhead, only encrypted dogy materials
#   con: overhead
#
# Cache set to encrypt means that you cache documents, but that the
# documents are encrypted with a key of the sha1 of the url prefixed with 
# 1.  The idea is that if you don't know the url, you can't decrypt it.
# If you turn "directory_service = off", you _won't_ know what the 
# urls are.
#
# note: author: "Cache: off/on/encrypt" line overides this
# setting per document, except where this would reduce the server's
# security.  The document author can ask for more paranoia, but will 
# be ignored if he asks for less than you require.

cache = on

######################################################################
# if cacheing documents, how big should the cache be (defaults to Kb,
# Mb and Kb recognized)  1 Gb would be nice :-)

cache_size = 5 Mb

######################################################################
# which directory should the cached documents go in leading slash is
# absolute, no leading slash is relative to eternity home

cache_dir = "cache"

######################################################################
# Do you want to maintain a list of URLs in the form of an index file?
#   pro: lets people see what interesting docs are available
#   con: a catalog to dodgy materials might itself by dodgy
# note: authors's "Option: exdirectory" disables this option per document

directory_service = on

######################################################################
# Newsgroups file containing list of newsgroups to search for eternity
# service files.  alt.anonymous.messages is a must, add others as you
# wish

newsgroups_file = "newsgroups"

######################################################################
# Check news for new articles during cgi-operation?
#
# Best to use a cron job to run "eternity -u", but if you can't
# you can do a kludge which updates (fetches new news)during the 
# cgi script's time.  This ain't pretty because the user is waiting.
# However your ISP may not give you access to cron.
#
# For cron use set "update = off", to turn on the cgi-bin update
# set "update = on"

cgi_update = on

######################################################################
# How often to check for new articles if we're checking new articles
# during cgi-bin fetch operation ("cgi_update = on", ie not using cron)
# (mins, secs, hours understood, must be lower case, default secs)

cgi_update_interval = 5 mins

######################################################################
# lock directory path, if you got problems locking over NFS, you could
# change it to a local FS here.  (It's your job to create the dir).

lock_dir = "locks"

######################################################################
# log file name, in case you want to put it somewhere else?  

log_file = "log"
