mpid_err_get_string.tex

刚才是说明 现在是安装程序在 LINUX环境下进行编程的MPICH安装文件

\startmanpage
\mantitle{MPID{\tt \char`\_}Err{\tt \char`\_}get{\tt \char`\_}string}{tex}{10/7/2002}
\manname{MPID{\tt \char`\_}Err{\tt \char`\_}get{\tt \char`\_}string}
--- Get the message string that corresponds to an error class or code 
\subhead{Synopsis}
\startvb\begin{verbatim}
int MPID_Err_get_string( int code, char *msg, int msg_len )

\end{verbatim}
\endvb

\subhead{Input Parameter}
\startarg{code }{An error class or code.  If a code, it must have been created by 
{\tt MPID{\tt \char`\_}Err{\tt \char`\_}create{\tt \char`\_}code}.
}
\startarg{msg{\tt \char`\_}len }{Length of {\tt msg}.
}
\par
\subhead{Output Parameter}
\startarg{msg }{A null-terminated text string of length (including the null) of no
more than {\tt msg{\tt \char`\_}len}.  
}
\par
\subhead{Return value}
Zero on success.  Non-zero returns indicate either (a) {\tt msg{\tt \char`\_}len} is too
small for the message or (b) the value of {\tt code} is neither a valid
error class or code.
\par
\subhead{Notes}
This routine is used to implement {\tt MPI{\tt \char`\_}ERROR{\tt \char`\_}STRING}.
\par
\subhead{Module}
Error
\par
\subhead{Question}
What values should be used for the error returns?  Should they be
valid error codes?
\par
How do we get a good value for {\tt MPI{\tt \char`\_}MAX{\tt \char`\_}ERROR{\tt \char`\_}STRING} for {\tt mpi.h}?
See {\tt errgetmsg} for one idea.
\par
\endmanpage