Daylight v4.9
Release Date: 1 February 2008


thordbping - verify the existence of a database

Unix Synopsis

thordbping [options] database


This program attempts to open a database, and reports on the success or failure of the operation.

thordbping opens a Thor database. The user's own id (not "thorinfo") is used to connect to the server, then the database is opened with the specified permission (see option -PASSWORD_LEVEL, below). If the login fails or the database can't be opened, an error message is printed. Then the database is closed and the connection to the server is closed.

The function is primarily used to verify the existence of a database, to verify that your system is configured correctly, and to verify that you have the correct passwords for the object (e.g. for use in a shell script).

The manual page for "thorfilters" describes features common to these and all "thorfilter" programs; refer to it for more information about this program and the syntax of "database".


When the object being "pinged" is a database, Indicates the permission that is to be used in the attempt to open the databases. Must be one of R, W, or E, indicating read, read/write, and executive, respectively. Default is "R".
Returns the process id of the server being pinged. This is useful for administration purposes. Default is FALSE.

The following options are common to most or all "thorfilter" programs. They are described in more detail in thorfilters(1).


TRUE means don't allow passwords on the command line (require interactive entry). Default: TRUE.
Names the default TCP/IP service or "port" of the Thor server. Default: thor.

Return Value

The program's return status is zero if the operation succeeded, and one if it failed.


thordbping mydb
Tries the Thor database "mydb" on the current host; passwords are entered interactively.
thordbping pomona93c%@crawdad
Tries the Thor database "mydb" on the host "crawdad". The database password is blank; the server password is entered interactively. Only works if the option SECURE_PASSWORDS is "FALSE".



Daylight License

program: thor

Related Topics

dayevict(1) daymessage(1) merlindbping(1) merlinping(1) merlinload(1) merlinls(1) merlinwho(1) thorchange(1) thorcrunch(1) thordbinfo(1) thordelete(1) thordestroy(1) thordiff(1) thordump(1) thorlist(1) thorload(1) thorlookup(1) thorls(1) thormake(1) thorping(1) thorwho(1) sthorman(1) thorserver(1) merlinserver(1) licensing(5)

Daylight Theory Manual, Daylight System Administration Manual


None known.