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
22 February 2010 mpdboot(1)