mpirun.ch_v2.args

Path MPICH-V for MPICH the MPI Implementation

#! /bin/sh
#
#  MPICH-V2
#  Copyright (C) 2002, 2003 Groupe Cluster et Grid, LRI, Universite de Paris Sud
#
#
#  This file is part of MPICH-V2.
#
#  MPICH-V2 is free software; you can redistribute it and/or modify
#  it under the terms of the GNU General Public License as published by
#  the Free Software Foundation; either version 2 of the License, or
#  (at your option) any later version.
#
#  MPICH-V2 is distributed in the hope that it will be useful,
#  but WITHOUT ANY WARRANTY; without even the implied warranty of
#  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
#  GNU General Public License for more details.
#
#  You should have received a copy of the GNU General Public License
#  along with MPICH-V2; if not, write to the Free Software
#  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#
#  $Id: mpirun.ch_v2.args,v 1.3 2004/05/17 13:40:14 collin Exp $
#
# Special args for the ch_xw device

setrshcmd="no"
case $arg in 
    --INIT)
	xwpgfile=
        xwwd=""
	leaveXWFile=0
	;;
    -chv-high-performance-network)
        ipTranslationFile="$1"
        shift
        device_knows_arg=1
        ;;
    -chv-no-auto-launch)
        noAutoLaunch="yes"
        device_knows_arg="1"
        ;;
    -chv-debug-file)
        debugFile="$1"
        shift
        device_knows_arg=1
        ;; 
    -chv-jobid)
        job_id="$1"
        shift
        device_knows_arg=1
        ;;
    -chv-norun)
        noRun="yes"
        keep_xwfile="1"
        device_knows_arg=1
        ;;
    -chv-checkpoint)
        checkpointTime="$1"
        shift
        device_knows_arg=1
        ;;
    -chv-security-ratio)
	if [ -n "$xwsmGiven" ] ; then
	    echo "Warning: setting security ratio after security margin: margin will be ignored"
	    xwSecurityMargin=
	fi
	xwSecurityRatio="$1"
	shift
	device_knows_arg=1
	xwsrGiven=1
	;;
    -chv-security-margin)
	if [ -n "$xmsrGiven" ] ; then
	    echo "Warning: setting security margin after security ratio: margin will be ignored"
	else
	    xwSecurityMargin="$1"
	    xwsmGiven=1
	fi
	shift
	device_knows_arg=1
	;;
    -chv-communication-port)
        pComm="$1";
        shift
        device_knows_args=1
        ;;
    -el-explicit-only)
	useExplicitCMonly=1;
	device_knows_arg=1
	;;
    -chv-slow-el)
	slowEl="yes"
	device_knows_arg=1
	;;
    -elr)
	if [ -n "$elnGiven" ] ; then
	    echo "Warning: setting -elr after -eln: ratio will override absolute number"
	    eventLoggerNumber=
	fi
	eventLoggerRatio="$1"
	shift
	elrGiven=1
	device_knows_arg=1
	;;
    -eln)
	if [ -n "$eventLoggerRatio" ] ; then
	    echo "Warning: setting -eln after -elr: absolute number ignored"
	else
	    eventLoggerNumber="$1"
	    elnGiven=1
	fi
	shift
	device_knows_arg=1
	;;
    -eld)
	eventLoggerDistribution="$1"
	shift
	device_knows_arg=1
	;;
    -elp)
	if [ "$1" -le 1024 ] ; then
	    echo "Warning: port $1 is reserved to privileged user, ignored"
	else
	    pel_default="$1"
	fi
	shift
	device_knows_arg=1
	;;
    -cs-explicit-only)
	useExplicitCSonly=1;
	device_knows_arg=1
	;;
    -cstmp)
	tmpCS="$1"
	device_knows_arg=1
	;;
    -csr)
	if [ -n "$csnGiven" ] ; then
	    echo "Warning: setting -csr after -csr: ratio will override absolute number"
	    checkPointServerNumber=
	fi
	checkpointServerRatio="$1"
	csrGiven=1
	shift
	device_knows_arg=1
	;;
    -csn)
	if [ -n "$csrGiven" ] ; then
	    echo "Warning: setting -csn after -csr: absolute number ignored"
	else
	    checkPointServerNumber="$1"
	    elnGiven=1
	fi
	shift
	device_knows_arg=1
	;;
    -csd)
	checkpointServerDistribution="$1"
	shift
	;;
    -csp)
	if [ "$1" -le 1024 ] ; then
	    echo "Warning: port $1 is reserved to privileged user, ignored"
	else
	    pcs_default="$1"
	fi
	shift
	device_knows_arg=1
	;;
    -leave_xw|-keep_xw)
      	leavePGFile=1
        device_knows_arg=1
	;;
    -debug)
        debug_command="$1"
        shift
        device_knows_arg=1
        ;;
    -p4pg)
      	if [ $np -gt  1 ] ; then
	    echo "-p4pg and -np are mutually exclusive; -np $np being ignored."
            np=1
	fi
	p4pgfile="$1"
	shift
      	leavePGFile=1
        device_knows_arg=1
	;;
    -p4wd)
	p4workdir="$1"
	shift
        device_knows_arg=1
	;;
    -p4ssport)
      	p4ssport="$1"
	shift
        if [ $p4ssport = "0" -a "$MPI_P4SSPORT" != "" ] ; then
	    p4ssport=$MPI_P4SSPORT
      	fi
        device_knows_arg=1
	;;
    -rsh)
        rshcmd="$1"
	setrshcmd="yes"
	shift
	;;
    -usage | --usage)
cat <<EOF
   Special Options for ch_xw device:

    -chv-security-ratio num
            Will add the percentage number of nodes as a 'security' to the
             available list. These will be used if the program needs to be 
             restarted
    -chv-security-margin num
            Will add this number of nodes as a 'security' to the available
             list. These will be used if the program needs to be restarted 
    -chv-debug-file filename
            Debug mode (internal option). The file filename will be used to
             precise the debug options for each program and auxiliary
    -chv-checkpoint time
            Precises the checkpoint frequency. By default, there is none.
             time is expressed in seconds

   Event loggers options:
    -el-explicit-only
            Uses only the explicitly declared EL-enabled nodes in machinefile
    -elr num
            Uses this number as the computing processors / event logger ratio
    -eln num
            Precises the exact number of event logger to use
    -elr num
            Precises the distribution of the event logger on the available
              nodes by default set to ratio
    -elp num
            Sets the default port for event logger communication

   Checkpoint servers options:
    -cs-explicit-only
            Uses only the explicitly declared CS-enabled nodes in machinefile
    -cstmp path
            Uses path as the tmp directory where checkpoint files are stored
    -csr num
            Uses this number as the computing processors / checkpoint servers
             ratio
    -csn num
            Precises the exact number of checkpoint servers to use
    -csr num
            Precises the distribution of the checkpointservers on the available
             nodes by default set to ratio
    -csp num
            Sets the default port for checkpoint servers communication
    -leave_xw
            Don't delete the XW procgroup file after running
    -xwfile filename
            Use the given xw file instead of creating one.
            Overrides -np and -nolocal, selects -leave_xw.
    -xwwd pathname
            Use pathname as the working directory for the program 
    -rsh cmd
            Use the named command as the command to start remote processes
EOF
esac