44 |
\section{Options} |
\section{Options} |
45 |
The general form of the \program{escript} launcher is as follows: |
The general form of the \program{escript} launcher is as follows: |
46 |
|
|
47 |
|
%%%% |
48 |
|
% If you are thinking about changing this please remember to update the man page as well |
49 |
|
%%%% |
50 |
|
|
51 |
\program{escript} |
\program{escript} |
52 |
\optional{\programopt{-n \var{nn}}} |
\optional{\programopt{-n \var{nn}}} |
53 |
\optional{\programopt{-p \var{np}}} |
\optional{\programopt{-p \var{np}}} |
61 |
\optional{\programopt{-o}} |
\optional{\programopt{-o}} |
62 |
\optional{\programopt{-c}} |
\optional{\programopt{-c}} |
63 |
\optional{\programopt{-i}} |
\optional{\programopt{-i}} |
64 |
|
\optional{\programopt{-b}} |
65 |
\optional{\var{file}} |
\optional{\var{file}} |
66 |
\optional{\var{ARGS}} |
\optional{\var{ARGS}} |
67 |
|
|
74 |
\begin{itemize} |
\begin{itemize} |
75 |
|
|
76 |
\item[\programopt{-n} \var{nn}] the number of compute nodes \var{nn} to be used. The total number of process being used is |
\item[\programopt{-n} \var{nn}] the number of compute nodes \var{nn} to be used. The total number of process being used is |
77 |
$\var{nn} \cdot \var{ns}$. This option overwrites the value of the \env{ESCRIPT_NUM_NODES} environment variable. If $\var{nn}>1$ but {\it escript} is not compiled for \MPI a warning is pronted but execution is continued with $\var{nn}=1$. The default value is 1. |
$\var{nn} \cdot \var{ns}$. This option overwrites the value of the \env{ESCRIPT_NUM_NODES} environment variable. If $\var{nn}>1$ but {\it escript} is not compiled for \MPI a warning is printed but execution is continued with $\var{nn}=1$. If \programopt{-n} is not set the |
78 |
|
number of hosts in the host file is used. The default value is 1. |
79 |
|
|
80 |
\item[\programopt{-p} \var{np}] the number of processor slots per node. This options specifies how many \MPI processes are used on each node. The total number of process being used is |
\item[\programopt{-p} \var{np}] the number of MPI processes per node. The total number of processes to be used is |
81 |
$\var{nn} \cdot \var{np}$. This option overwrites the value of the \env{ESCRIPT_NUM_PROC} environment variable. If $\var{np}>1$ but {\it escript} is not compiled for \MPI a warning is printed but execution is continued with $\var{np}=1$. The default value is 1. |
$\var{nn} \cdot \var{np}$. This option overwrites the value of the \env{ESCRIPT_NUM_PROC} environment variable. If $\var{np}>1$ but {\it escript} is not compiled for \MPI a warning is printed but execution is continued with $\var{np}=1$. The default value is 1. |
82 |
|
|
83 |
\item[\programopt{-t} \var{nt}] the number of threads used per processes. |
\item[\programopt{-t} \var{nt}] the number of threads used per processes. |
84 |
The option overwrites the value of the \env{ESCRIPT_NUM_THREADS} environment variable. |
The option overwrites the value of the \env{ESCRIPT_NUM_THREADS} environment variable. |
85 |
If $\var{nt}>1$ but {\it escript} is not compiled for \OPENMP a warning is printed but execution is continued with $\var{nt}=1$. The default value is 1. |
If $\var{nt}>1$ but {\it escript} is not compiled for \OPENMP a warning is printed but execution is continued with $\var{nt}=1$. The default value is 1. |
86 |
|
|
87 |
\item[\programopt{-f} \var{hostfile}] the name of a file with a list of host names. Some systems require to specify the addresses or names of the compute nodes where \MPI process should be spawned. The list of addresses or names of the compute nodes is listed in the file with the name \var{hostfile}. In order to avoid oversubsription the number of differnt |
\item[\programopt{-f} \var{hostfile}] the name of a file with a list of host names. Some systems require to specify the addresses or names of the compute nodes where \MPI process should be spawned. The list of addresses or names of the compute nodes is listed in the file with the name \var{hostfile}. If \programopt{-n} is set the |
88 |
hosts defined in \var{hostfile} must be greater or equal to the number of requsted compute nodes \var{nn}. The option overwrites the value of the \env{ESCRIPT_HOSTFILE} environment variable. By default value no host file is used. |
the number of different |
89 |
|
hosts defined in \var{hostfile} must be equal to the number of requsted compute nodes \var{nn}. The option overwrites the value of the \env{ESCRIPT_HOSTFILE} environment variable. By default value no host file is used. |
90 |
\item[\programopt{-c}] prints the information about the settings used to compile {\it escript} and stops execution.. |
\item[\programopt{-c}] prints the information about the settings used to compile {\it escript} and stops execution.. |
91 |
\item[\programopt{-V}] prints the version of {\it escript} and stops execution. |
\item[\programopt{-V}] prints the version of {\it escript} and stops execution. |
92 |
\item[\programopt{-h}] prints a help message and stops execution. |
\item[\programopt{-h}] prints a help message and stops execution. |
93 |
\item[\programopt{-i}] excutes the script \var{file} and switches to interactive mode after the execution is finished or an exception has occured. This option is useful for debugging a script. The option cannot be used if more then one process ($\var{nn} \cdot \var{np}>1$) is used. |
\item[\programopt{-i}] executes the script \var{file} and switches to interactive mode after the execution is finished or an exception has occured. This option is useful for debugging a script. The option cannot be used if more then one process ($\var{nn} \cdot \var{np}>1$) is used. |
94 |
|
\item[\programopt{-b}] do not invoke python. This is used to run non-python programs. |
95 |
|
|
96 |
\item[\programopt{-e}] shows additional environment variables and commands used during \program{escript} execution. This option is useful if users wish to excute scripts without using the \program{escript} command. |
\item[\programopt{-e}] shows additional environment variables and commands used during \program{escript} execution. This option is useful if users wish to excute scripts without using the \program{escript} command. |
97 |
|
|