FILE

/Users/goodell/svn/mpich2-1.2.1p1-tmp/src/pm/mpd/mpdcheck.py

DESCRIPTION

This script is a work in progress and may change frequently as we work with users and gain additional insights into how to improve it.

This script prints useful information about the host on which it runs. It is here to help us help users detect problems with configurations of

their computers.

For example, some computers are configured to think of themselves simply as 'localhost' with 127.0.0.1 as the IP address. This might present problems if a process on that computer wishes to identify itself by host and port to a process on another computer. The process on the other computer would try to contact 'localhost'.

If you are having problems running parallel jobs via mpd on one or more hosts, you might try running this script once on each of those hosts.

Any output with *** at the beginning indicates a potential problem that you may have to resolve before being able to run parallel jobs via mpd.

For help: mpdcheck -h (or --help) prints this message

In the following modes, the -v (verbose) option provides info about what mpdcheck is doing; the -l (long messages) option causes long informational messages to print in situations where problems are spotted.

The three major modes of operation for this program are:

        mpdcheck
            looks for config problems on 'this' host; prints as nec
        mpdcheck -pc
            print config info about 'this' host, e.g. contents of /etc/hosts, etc.
        mpdcheck -f some_file [-ssh]
            prints info about 'this' host and locatability info about the ones
            listed in some_file as well (note the file might be mpd.hosts);
            the -ssh option can be used in conjunction with the -f option to
            cause ssh tests to be run to each remote host
        mpdcheck -s
            runs this program as a server on one host
        mpdcheck -c server_host server_port
            runs a client on another (or same) host; connects to the specifed
            host/port where you previously started the server

FUNCTIONS

ctime(...) ctime(seconds) -> string

Convert a time in seconds since the Epoch to a string in local time. This is equivalent to asctime(localtime(seconds)). When the time tuple is not present, current time as returned by localtime() is used.

exit(...) exit([status])

Exit the interpreter by raising SystemExit(status). If the status is omitted or None, it defaults to zero (i.e., success). If the status is numeric, it will be used as the system exit status. If it is another kind of object, it will be printed and the system exit status will be one (i.e., failure).

gethostbyaddr(...) gethostbyaddr(host) -> (name, aliaslist, addresslist)

Return the true host name, a list of aliases, and a list of IP addresses,

for a host.

The host argument is a string giving a host name or IP number.

gethostbyname_ex(...) gethostbyname_ex(host) -> (name, aliaslist, addresslist)

Return the true host name, a list of aliases, and a list of IP addresses,

for a host.

The host argument is a string giving a host name or IP number.

gethostname(...) gethostname() -> string

Return the current host name.

kill(...) kill(pid, sig)

Kill a process with a signal.

select(...) select(rlist, wlist, xlist[, timeout]) -> (rlist, wlist, xlist)

Wait until one or more file descriptors are ready for some kind of I/O. The first three arguments are sequences of file descriptors to be waited for: rlist -- wait until ready for reading wlist -- wait until ready for writing xlist -- wait for an ``exceptional condition'' If only one kind of condition is required, pass [] for the other lists. A file descriptor is either a socket or file object, or a small integer gotten from a fileno() method call on one of those.

The optional 4th argument specifies a timeout in seconds; it may be

a floating point number to specify fractions of seconds.

If it is absent or None, the call will never time out.

The return value is a tuple of three lists corresponding to the first three arguments; each contains the subset of the corresponding file descriptors that are ready.

*** IMPORTANT NOTICE *** On Windows and OpenVMS, only sockets are supported; on Unix, all file descriptors.

system(...) system(command) -> exit_status

Execute the command (a string) in a subshell.

DATA

SIGKILL = 9 __author__ = 'Ralph Butler and Rusty Lusk' __credits__ = '' __date__ = 'Mon Feb 22 16:28:13 2010' __version__ = '$Revision: 1.19 $' argv = ['/usr/bin/pydoc', 'mpdcheck'] stdout = <open file '<stdout>', mode 'w' at 0x17068>

VERSION

1.19

DATE

Mon Feb 22 16:28:13 2010

AUTHOR

Ralph Butler and Rusty Lusk

CREDITS