mpid_err_link.tex

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

\startmanpage
\mantitle{MPID{\tt \char`\_}Err{\tt \char`\_}link}{tex}{10/7/2002}
\manname{MPID{\tt \char`\_}Err{\tt \char`\_}link}
--- Indicate an error on a communication link 
\subhead{Synopsis}
\startvb\begin{verbatim}
int MPID_Err_link( MPID_Comm *comm, int rank, MPID_Lpid lpid, 
                  int is_fatal )

\end{verbatim}
\endvb

\subhead{Input Parameters}
\startarg{comm }{Communicator on which failure was discovered.  If none, use
{\tt MPI{\tt \char`\_}COMM{\tt \char`\_}NULL
}}
\startarg{rank }{Rank in {\tt comm} of failed link.  Ignored if {\tt comm} is {\tt MPI{\tt \char`\_}COMM{\tt \char`\_}NULL}.
}
\startarg{lpid }{Local process id of failed link.  Required.
}
\startarg{is{\tt \char`\_}fatal }{True if the error is not recoverable, false otherwise.  See notes.
}
\par
\subhead{Notes}
This routine should be called by the ADI when it discovers that a
communication link to another process has failed in a non-recoverable way.
This routine is used to provide a consistent hook for supporting
fault-tolerance in an MPI implementation.
\par
The value {\tt is{\tt \char`\_}fatal} is used to indicate whether the ADI is able to recover
from this error.  If {\tt is{\tt \char`\_}fatal} is true, {\tt MPID{\tt \char`\_}Err{\tt \char`\_}link} should not return
but should invoke {\tt MPID{\tt \char`\_}Abort}.
\par
\subhead{Question}
If {\tt is{\tt \char`\_}fatal} is true, how do we pass error messages back to the
environment?  Should we pass an error code to this routine?  Should it
return instead, allowing the routine that called it to call abort?
Is the rationale for calling it that it may want to help take down
other processes (or at least notify them of failure)?
\par
\subhead{Module}
Error-handling
\endmanpage