mpid_memory_register.tex

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

\startmanpage
\mantitle{MPID{\tt \char`\_}Memory{\tt \char`\_}register}{tex}{10/7/2002}
\manname{MPID{\tt \char`\_}Memory{\tt \char`\_}register}
--- Register a memory buffer  
\subhead{Synopsis}
\startvb\begin{verbatim}
int MPID_Memory_register( void *buf, int len, MPID_Comm *comm, int rank, 
                        int rdwt )

\end{verbatim}
\endvb

\subhead{Input Parameters}
\startarg{buf }{Pointer to start of memory
}
\startarg{len }{Length of buffer, in bytes
}
\startarg{comm }{Communicator
}
\startarg{rank }{rank 
}
\startarg{rdwt }{Indicate whether memory will be read ({\tt MPID{\tt \char`\_}MEM{\tt \char`\_}READ}), 
written ({\tt MPID{\tt \char`\_}MEM{\tt \char`\_}WRITE}), 
or both ({\tt MPID{\tt \char`\_}MEM{\tt \char`\_}READ} {\tt \char`\|} {\tt MPID{\tt \char`\_}MEM{\tt \char`\_}WRITE})
}
\par
\subhead{Return value}
{\tt MPI{\tt \char`\_}SUCCESS} if registration was successful, a valid MPI error code
otherwise.  This error is non-fatal; the error return is made to
allow for more detailed information on why the memory registration
failed.
\par
\subhead{Notes}
This call is made by {\tt MPI{\tt \char`\_}Send{\tt \char`\_}init}, {\tt MPI{\tt \char`\_}Ssend{\tt \char`\_}init}, {\tt MPI{\tt \char`\_}Rsend{\tt \char`\_}init},
{\tt MPI{\tt \char`\_}Bsend{\tt \char`\_}init}, and {\tt MPI{\tt \char`\_}Recv{\tt \char`\_}init} to mark memory
as used for communication; other MPI routines may also call it.
\par
This call allows devices that can optimize transfers for predefined
memory to take advantage of these calls.
\par
The {\tt comm} and {\tt rank} arguments allow this routine to pick the best way
to specify the memory based on how it will be used.  This may be important
for devices that use different methods for interprocess communication based
on the source or destination process.  The value {\tt MPI{\tt \char`\_}ANY{\tt \char`\_}SOURCE} is valid
for {\tt rank} and indicates that the memory may be used when communicating with
any process in {\tt comm}.
\par
It is possible and valid for the same memory region to be registered
several times.  It is not an error to attempt to register the same
memory; the return code should indicate success if the memory is
registered, even if this particular call was not responsible for actually
registering the memory.
\par
\subhead{Module}
Communication
\endmanpage