refdbc reads the file refdbcrc at startup and uses the variable/value pairs to initialize the application. You may override these settings by providing the appropriate command line options.
Table 13-1. refdbcrc
| Variable | Default | Comment |
|---|---|---|
| cssurl | (none) | The URL of a Cascading Style Sheet (CSS) file. This file, if specified, is used to customize the visual appearance of the HTML output of the getref command. |
| defaultdb | (none) | The default database. refdbc will try to use this database unless you select a different one with the selectdb command. |
| defaultris | (none) | The path of a RIS file with entries that should be added to all new or updated references. This is typically used to set some default value for the RP field or to specify additional keywords. |
| fields | (none) | A list of additional fields which should be displayed by default in the reference output. The list is a simple concatenation of the field names. Possible fields are N1, N2, NX, AB, AD, RP, SN, PB, CY, UR, U1 through U5, M1 through M3. Use the string "ALL" to request all available fields. |
| fromencoding | ISO-8859-1 | The default encoding of RIS input data. You can use any encoding that your local libiconv implementation supports. |
| logdest | file | Where the log output should be written to. Use either stderr, syslog, or file. For the latter to work, the logfile variable must be set appropriately |
| logfile | /var/log/refdbc.log | The full path of a custom log file. |
| loglevel | info | Set the level of log information that you would receive. Possible values, in order of increasing verbosity, are: emerg, alert, crit, err, warning, notice, info, debug |
| pager | stdout | The command line of a pager that accepts the output of refdb on stdin to allow scrolling and other nifty things. "stdout" sends the data to stdout. |
| passwd | * | The password which is used for authentication with the database server. It is potentially evil to store unencrypted passwords in disk files. At least make sure that the configuration file is not readable for anyone else. The default setting causes refdbc to ask for your password interactively. |
| pdfroot | (none) | This value will be used as the root of the paths to PDF or Postscript offprints that can be specified with the AV field in a RIS dataset. The path should not rely on shell expansion, e.g. use /home/me/literature/ instead of ~/literature/. The pdfroot allows you to shorten the paths that you enter for each dataset and to maintain a certain portability if you have to move the offprints to a different directory or want to access them remotely. The html output routine will concatenate the relative path of each dataset with the pdfroot to construct the link to the offprint. Instead of a local path name you can specify an URL starting with http:// or ftp:// if your offprints are accessible through a web server or ftp server. |
| port | 9734 | The port on which refdbd listens. Change this for all clients and the server if this value interferes with another program using this port. |
| serverip | 127.0.0.1 | The IP address or hostname of the machine where refdbd runs. Use the default (localhost) address if the clients and refdbs run on the same machine. |
| timeout | 180 | The timeout in seconds. After this time has elapsed, a stalled connection is taken down. Increase this value if you encounter frequent timeout errors due to high network traffic or refdbd overload. |
| toencoding | (none) | The default encoding of output data. You can use any encoding that your local libiconv implementation supports. If this value is not set, the encoding of the database will be used without conversion. |
| username | login name | The username which is used for authentication with the database server. This may be different from the login name of the user. |
| verbose | f | Set this to t if you prefer verbose error messages. |