--- name: "mpdboot" section: "1" platform: "linux" package: "mpich2" version: "1.2.1.1-5" release: "Debian 6.0 (Squeeze)" platforms: ["linux"] url: "https://new.carta.tech/mpdboot" --- # mpdboot(1) ## NAME **mpdboot** ## FILE **/Users/goodell/svn/mpich2-1.2.1p1-tmp/src/pm/mpd/mpdboot.py** ## DESCRIPTION - **usage:** **mpdboot --totalnum=\ \[--file=\\] \[--help\]** - **\[--rsh=\\] \[--user=\\] \[--mpd=\\]** - **\[--loccons\] \[--remcons\] \[--shell\] \[--verbose\] \[-1\]** **\[--ncpus=\\] \[--ifhn=\\] \[--chkup\] \[--chkuponly\] \[--maxbranch=\\]** **or, in short form,** **mpdboot -n n\_to\_start \[-f \\] \[-h\] \[-r \\] \[-u \\]** - **\[-m \\]** **-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 = \', mode 'w' at 0x17068\>** ## VERSION **1.49** ## DATE **Mon Feb 22 16:28:11 2010** ## AUTHOR **Ralph Butler and Rusty Lusk** ## CREDITS