# this is an example configuration file for refdbd, the application server
# of RefDB, preconfigured for use with <engine> as a database engine
# to use this file as a configuration file for refdbd, create a copy
# named refdbdrc in the same directory, or create a symlink with that
# name pointing to this file
#
# RefDB is a reference database and bibliography tool, see
# http://refdb.sourceforge.net for further information

# Syntax rules of this file:
# 1. Each line contains a pair of variable name and variable value, 
#    separated by whitespace.
# 2. The hash (#) denotes the start of a comment, the rest of the line
#    will be ignored
# 3. The line ending must be Unix-style (LF) regardless of the operating
#    system

# The full path of a directory for shareable application files
refdblib <pkgdatadir>

# The name of the main database. The main database contains citation
# and bibliography styles, as well as the journal word list. There is
# no need to change this name unless you are forced to use a database
# with a given name, e.g. on rented webspace
main_db	<main_db>

# Either the IP address or the hostname of the computer that runs the
# database server. Use "localhost" if refdbd and the database server
# run on the same computer. This variable is ignored by embedded
# database engines
serverip	localhost

# The port on which the database server listens. Default values are
# 3306 (MySQL) and 5432 (PostgreSQL). This variable is ignored by
# embedded database engines
dbsport		<dbs_port>

# The database server we want to connect to. Currently mysql,
# pgsql, sqlite, and sqlite3 are supported
dbserver	<db_server>

# The directory where embedded database servers keep their files
# and where the database version file is created
dbpath		<db_path>

# The port on which refdbd listens for client connections
port	9734

# The time in seconds which has to elapse before a stalled connection
# to the client is taken down
#timeout	180

# The full path of a custom log file. This will be used if logdest is
# set accordingly
logfile /var/log/refdbd.log

# The destination of the log information. Uncomment *one* of the
# following definitions. "file" uses the file specified with the
# logfile variable
#logdest stderr
#logdest syslog
logdest file

# The priority up to which messages are logged. Uncomment *one* of the
# following definitions. "emerg" will result in the fewest, "debug" in
# the most log messages
#loglevel emerg
#loglevel alert
#loglevel crit
#loglevel err
#loglevel warning
#loglevel notice
loglevel info
#loglevel debug

# The full path of the file where the refdbd stores the current process
# ID of the parent process
pidfile		/var/run/refdbd.pid

# Allow (t) or deny (f) remote administration of refdbd through refdba
remoteadmin f

# Allow (t) or deny (f) remote access
remoteconnect f

# Keep (t) or delete(f) periodical names and synonyms when deleting
# references
keep_pnames t

# Perform an automatic keyword scan after references are added or
# updated if set to 't'. Set this to 'f' to skip the automatic keyword
# scan.
keyword_scan t

# Specify the directory that contains the libdbi drivers. This is only
# necessary if you use precompiled libdbi binaries in locations the
# binaries were not built for
# dbi_driverdir /usr/local/lib/dbd

# Specify the default encoding that newly created databases use. This
# feature is currently only supported by PostgreSQL and MySQL 4.x./5.x
# Possible values are UTF-8, ISO-8859-1, ASCII, and a variety of others
# see the libdbi documentation for the values supported by your database
# engine
db_encoding	UTF-8

# Specify the default encoding of imported RIS data.
in_encoding	UTF-8

# Set this to t if you want refdbd to uppercase citation keys when
# adding datasets. This is convenient to make sure your datasets work
# properly with SGML documents
#upper_citekey	t

# extended notes which do not carry a share attribute can be handled
# either as public or as private by default. In the first case,
# every RefDB user will be able to read them. In the latter case, only
# the note owner will be able to read his notes. In both cases the
# share attribute of an extended note, if set, will override the default
#share_default public

# end of refdbdrc
