Daylight v4.9
Release Date: 1 February 2008

Name

merlinping - verify the existence of a server

Unix Synopsis

merlinping [options] server

Description

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

merlinping connect to a Merlin server. If no userid is specified as part of the server specification (e.g. "crawdad:thor", "crawdad", or no server name at all), then the default userid becomes the special user "thorinfo". This is the "restricted userid," which the servers normally permit to connect with no password. If the login succeeds, a short message is sent on a round trip to the server (see dt_ping(3)) to verify that communications are working. Then the connection to the server is closed.

This function is primarily used to verify the existence of a server, 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 "server".

Options

-PROCESS_ID TRUE|FALSE
Returns the process id of the server being pinged. This is useful for administration purposes. Default is FALSE.
STANDARD THORFILTER OPTIONS:
----------------------------

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

-SECURE_PASSWORDS TRUE|FALSE

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

Return Value

These programs' return status is zero if the operation succeeded, and one if it failed. merlinping 'bigserver::josephine%$JPASS'
Tries to connect to a Merlin server on the machine "bigserver" using the default service "merlin" and the userid "josephine". The value of the environment variable "JPASS" is used as the password. Note that because the server name is quoted, JPASS is evaluated internally rather than on the command line, so the actual password never appears where it can be discovered.

Files

$DY_ROOT/bin/merlinping

Daylight License

program: merlin

Related Topics

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

Daylight Theory Manual, Daylight System Administration Manual

Bugs

None known.