Dico

B.2.3 The SHOW Command

The SHOW command outputs various information about the server and databases.

Command: SHOW DB

Command: SHOW DATABASES

Display the list of currently accessible databases, one per line, in the form:

database description

The list is terminated with is a dot (‘.’) on a line alone.

Possible responses:

110 n databases present

554 No databases present

Command: SHOW STRAT

Command: SHOW STRATEGIES

Display the list of currently supported search strategies, one per line, in the form:

strategy description

The list is terminated with is a dot (‘.’) on a line alone.

Possible responses:

111 n strategies available

555 No strategies available

Command: SHOW INFO database

Displays the information about the specified database. The information is a free-form text and is suitable for display to the user in the same manner as a definition. The textual body of the response is terminated with is a dot (‘.’) on a line alone.

Possible responses:

550 Invalid database, use SHOW DB for a list

112 database information follows

The textual body is retrieved from the info statement in the configuration file (see info), or, if it is not specified, from the database itself, using dico_db_info callback function (see dico_db_info). If neither source returns anything, the string ‘No information available.’ is returned.

Command: SHOW SERVER

Return a server-specific information.

Response:

114 server information follows

The information follows, terminated with a dot on a line alone.

The textual body returned by the SHOW SERVER command consists of two parts. It begins with a line containing host name of the server and, optionally an additional information about the daemon and the system it runs on. The exact look and amount of information in this line is controlled by show-sys-info configuration statement (see show-sys-info). This line is followed by the text supplied with server-info configuration statement (see server-info).