90 строки
2.2 KiB
Plaintext
90 строки
2.2 KiB
Plaintext
|
.\" -*- nroff -*-
|
||
|
.\" Copyright 2010 Cisco Systems, Inc. All rights reserved.
|
||
|
.\" Copyright 2006-2008 Sun Microsystems, Inc.
|
||
|
.\" Copyright (c) 1996 Thinking Machines Corporation
|
||
|
.\" $COPYRIGHT$
|
||
|
.TH MPI_Win_call_errhandler 3 "#OMPI_DATE#" "#PACKAGE_VERSION#" "#PACKAGE_NAME#"
|
||
|
|
||
|
.SH NAME
|
||
|
\fBMPI_Win_call_errhandler\fP \- Passes the supplied error code to the
|
||
|
error handler assigned to a window
|
||
|
|
||
|
.SH SYNTAX
|
||
|
.ft R
|
||
|
|
||
|
.SH C Syntax
|
||
|
.nf
|
||
|
#include <mpi.h>
|
||
|
int MPI_Win_call_errhandler(MPI_Win \fIwin\fP, int \fIerrorcode\fP)
|
||
|
|
||
|
.fi
|
||
|
.SH Fortran Syntax
|
||
|
.nf
|
||
|
USE MPI
|
||
|
! or the older form: INCLUDE 'mpif.h'
|
||
|
MPI_WIN_CALL_ERRHANDLER(\fIWIN, ERRORCODE, IERROR\fP)
|
||
|
INTEGER \fIWIN, ERRORCODE, IERROR\fP
|
||
|
|
||
|
.fi
|
||
|
.SH Fortran 2008 Syntax
|
||
|
.nf
|
||
|
USE mpi_f08
|
||
|
MPI_Win_call_errhandler(\fIwin\fP, \fIerrorcode\fP, \fIierror\fP)
|
||
|
TYPE(MPI_Win), INTENT(IN) :: \fIwin\fP
|
||
|
INTEGER, INTENT(IN) :: \fIerrorcode\fP
|
||
|
INTEGER, OPTIONAL, INTENT(OUT) :: \fIierror\fP
|
||
|
|
||
|
.fi
|
||
|
.SH C++ Syntax
|
||
|
.nf
|
||
|
#include <mpi.h>
|
||
|
void MPI::Win::Call_errhandler(int \fIerrorcode\fP) const
|
||
|
|
||
|
.fi
|
||
|
.SH INPUT PARAMETERS
|
||
|
.ft R
|
||
|
.TP 1.4i
|
||
|
win
|
||
|
Window with error handler (handle).
|
||
|
.ft R
|
||
|
.TP 1.4i
|
||
|
errorcode
|
||
|
MPI error code (integer).
|
||
|
|
||
|
.SH OUTPUT PARAMETER
|
||
|
.ft R
|
||
|
.TP 1.4i
|
||
|
IERROR
|
||
|
Fortran only: Error status (integer).
|
||
|
|
||
|
.SH DESCRIPTION
|
||
|
.ft R
|
||
|
This function invokes the error handler assigned to the window
|
||
|
\fIwin\fP with the supplied error code \fIerrorcode\fP. If the error
|
||
|
handler was successfully called, the process is not aborted, and the
|
||
|
error handler returns, this function returns MPI_SUCCESS.
|
||
|
|
||
|
.SH NOTES
|
||
|
.ft R
|
||
|
Users should note that the default error handler is
|
||
|
MPI_ERRORS_ARE_FATAL. Thus, calling this function will abort the
|
||
|
window processes if the default error handler has not been changed for
|
||
|
this window.
|
||
|
|
||
|
.SH ERRORS
|
||
|
.ft R
|
||
|
Almost all MPI routines return an error value; C routines as
|
||
|
the value of the function and Fortran routines in the last argument. C++
|
||
|
functions do not return errors. If the default error handler is set to
|
||
|
MPI::ERRORS_THROW_EXCEPTIONS, then on error the C++ exception mechanism
|
||
|
will be used to throw an MPI::Exception object.
|
||
|
.sp
|
||
|
See the MPI man page for a full list of MPI error codes.
|
||
|
|
||
|
.SH SEE ALSO
|
||
|
.ft R
|
||
|
.nf
|
||
|
MPI_Win_create_errhandler
|
||
|
MPI_Win_set_errhandler
|
||
|
|