There are several client applications, each one performing a self-contained subset of tasks. This chapter provides a short overview over common features of the clients. Please refer to the reference chapters about refdba, refdbc, and refdbib for the nitty gritty details.
The system administrator's tool to create or delete databases, set access rights, and view all kinds of statistics.
The client for adding, editing, deleting, and searching reference entries.
The tool to create bibliographies.
refdbc and refdba can be run in an interactive mode where they provide their own command line, similar to a command-line FTP client for example. They use the GNU readline library with its powerful and convenient editing and history capabilities. In a nutshell, you can edit commands on this built-in command line as you can do in your bash or in the Emacs minibuffer. You can scroll through the history of your previous commands with the arrow keys, you can use the tab key to complete command names and filenames, and you can use Ctrl-r to search the history with a regular expression. For further information you should consult the readline manual.
refdba and refdbc can also be run in batch mode. You can specify one of the built-in commands as an argument to the -C option and pipe or redirect data into stdin. This is very useful if you want to automatize tasks using shell scripts.
Note: Most platforms automatically detect that data are available at stdin. However, on some platforms (like Windows/Cygwin) you have to tell the client explicitly that you want to read data from stdin. To this end, use the -f stdin command line option. See also the individual descriptions of the commands that support reading from stdin for additional information.
refdbib does not have an interactive mode and can be run only in batch mode. The result will be written to stdout.
These are the essential steps to get up and running as a refdb user:
Ask your refdb administrator to grant access to an existing reference database or have him create one for you.
If the application server refdbd is not installed to run as a daemon, start it now: refdbd -s & (see Starting refdbd for more options).
Start the refdbc command line client to manage and retrieve references.
Add references to the database.
Retrieve references according to your search criteria.
Create bibliographies with the references in your database.
Note: There is a tutorial for first-time users available at the refdb documentation page.