mpdboot(1)

NAME
mpdboot

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

DESCRIPTION

usage:
    mpdboot --totalnum=<n_to_start> [--file=<hostsfile>] [--help]

    [--rsh=<rshcmd>] [--user=<user>] [--mpd=<mpdcmd>]

    [--loccons] [--remcons] [--shell] [--verbose] [-1]
        [--ncpus=<ncpus>] [--ifhn=<ifhn>] [--chkup] [--chkuponly] [--maxbranch=<maxbranch>] or, in short form, mpdboot -n n_to_start [-f <hostsfile>] [-h] [-r <rshcmd>] [-u <user>]

    [-m <mpdcmd>]
        -s -v [-1] [-c]

--totalnum specifies the total number of mpds to start; at least one mpd will be started locally, and others on the machines specified by the file argument; by default, only one mpd per host will be started even if the hostname occurs multiple times in the hosts file -1 means remove the restriction of starting only one mpd per machine; in this case, at most the first mpd on a host will have a console --file specifies the file of machines to start the rest of the mpds on; it defaults to mpd.hosts --mpd specifies the full path name of mpd on the remote hosts if it is not in your path --rsh specifies the name of the command used to start remote mpds; it defaults to ssh; an alternative is rsh --shell says that the Bourne shell is your default for rsh' --verbose shows the ssh attempts as they occur; it does not provide confirmation that the sshs were successful --loccons says you do not want a console available on local mpd(s) --remcons says you do not want consoles available on remote mpd(s) --ncpus indicates how many cpus you want to show for the local machine; others are listed in the hosts file --ifhn indicates the interface hostname to use for the local mpd; others may be specified in the hostsfile --chkup requests that mpdboot try to verify that the hosts in the host file are up before attempting start mpds on any of them; it just checks the number of hosts specified by -n --chkuponly requests that mpdboot try to verify that the hosts in the host file are up; it then terminates; it just checks the number of hosts specified by -n --maxbranch indicates the maximum number of mpds to enter the ring under another; the default is 4

FUNCTIONS
access(...) access(path, mode) -> True if granted, False otherwise

    Use the real uid/gid to test for access to a path.
        Note that most operations will use the effective uid/gid, therefore this routine can be used in a suid/sgid environment to test if the invoking user has the

    specified access to the path.
        The mode argument can be F_OK to test existence, or the inclusive-OR of R_OK, W_OK, and X_OK.

chkupdn(hostList)

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).

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.

handle_mpd_output(fd, fd2idx, hostsAndInfo)

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

    Kill a process with a signal.

launch_one_mpd(idxToStart, currRoot, mpdArgs, hostsAndInfo)

mpdboot()

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.

usage()

DATA
SIGKILL = 9 X_OK = 1 __author__ = 'Ralph Butler and Rusty Lusk' __credits__ = '' __date__ = 'Mon Feb 22 16:28:11 2010' __version__ = '$Revision: 1.49 $' argv = ['/usr/bin/pydoc', 'mpdboot'] environ = {'_': '/usr/bin/pydoc', 'HOME': '/Users/goodell'...=00;36:*.... stdout = <open file '<stdout>', mode 'w' at 0x17068>

VERSION
1.49

DATE
Mon Feb 22 16:28:11 2010

AUTHOR
Ralph Butler and Rusty Lusk

CREDITS