Table 14-1. refdbibrc
| Variable | Default | Comment |
|---|---|---|
| refdblib | (none) | The path of a directory containing shareable files like DTDs, HTML templates etc. |
| defaultdb | (none) | The default database. refdbib will use this database unless you specify the databases in the citation elements of your documents. |
| 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 init file is not readable for anyone else. The default setting causes refdbib to ask for your password interactively. |
| 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 refdbd 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 refdbs overload. |
| 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. |
| logfile | /var/log/refdbib.log | The full path of a custom log file. This is used only if logdest is set appropriately. |
| logdest | 1 | The destination of the log information. 0 = print to stderr; 1 = use the syslog facility; 2 = use a custom logfile. The latter needs a proper setting of logfile. |
| loglevel | 6 | The log level up to which messages will be sent. A low setting (0) allows only the most important messages, a high setting (7) allows all messages including debug messages. -1 means nothing will be logged. |
| outtype | db31 | The type of output generated. Use db31 for DocBook SGML bibliographies, db31x for DocBook XML bibliographies, teix for TEI XML bibliographies, and bibtex for BibTeX bibliographies. |
| outformat | (none) | The bibliographic style to be used for the output. This is the name of a style as it was previously added to the database. |
| stylespecdir | . | A path to a directory (including the trailing directory separator) that will receive the stylesheet driver files. The default setting will direct the driver files to the current working directory that most likely contains the input files. It should rarely be necessary to use a different setting. |
| startnumber | 1 | The number where the reference numbering starts at. This option is mostly useful for compiling advanced bibliographies or for C boneheads who insist that counting starts at zero. |
| toencoding | (the database encoding) | The character encoding for the bibliography output. If this is not specified, the data will use the same encoding as the database. |
| ignore_missing | f | If this is set to "f", missing references (i.e. cited but not in the database) will throw an error. If set to "t", you'll get a warning but missing references will not cause refdbib to return an error. |