Upgrade macos
This commit is contained in:
Bassem Girgis
@@ -1,11 +1,20 @@
|
||||
.TH MPI_Reduce 3 "6/5/2019" " " "MPI"
|
||||
.TH MPI_Reduce 3 "2/3/2025" " " "MPI"
|
||||
.SH NAME
|
||||
MPI_Reduce \- Reduces values on all processes to a single value
|
||||
.SH SYNOPSIS
|
||||
.nf
|
||||
int MPI_Reduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datatype,
|
||||
MPI_Op op, int root, MPI_Comm comm)
|
||||
.fi
|
||||
.nf
|
||||
int MPI_Reduce(const void *sendbuf, void *recvbuf, int count,
|
||||
MPI_Datatype datatype, MPI_Op op, int root, MPI_Comm comm)
|
||||
.fi
|
||||
|
||||
.nf
|
||||
int MPI_Reduce_c(const void *sendbuf, void *recvbuf, MPI_Count count,
|
||||
MPI_Datatype datatype, MPI_Op op, int root, MPI_Comm comm)
|
||||
.fi
|
||||
|
||||
|
||||
.SH INPUT PARAMETERS
|
||||
.PD 0
|
||||
.TP
|
||||
@@ -15,7 +24,7 @@ int MPI_Reduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datat
|
||||
.PD 0
|
||||
.TP
|
||||
.B count
|
||||
- number of elements in send buffer (integer)
|
||||
- number of elements in send buffer (non-negative integer)
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
@@ -42,12 +51,26 @@ int MPI_Reduce(const void *sendbuf, void *recvbuf, int count, MPI_Datatype datat
|
||||
.PD 0
|
||||
.TP
|
||||
.B recvbuf
|
||||
- address of receive buffer (choice,
|
||||
significant only at
|
||||
.I root
|
||||
)
|
||||
- address of receive buffer (choice)
|
||||
.PD 1
|
||||
|
||||
.SH NOTES ON COLLECTIVE OPERATIONS
|
||||
|
||||
The reduction functions (
|
||||
.I MPI_Op
|
||||
) do not return an error value. As a result,
|
||||
if the functions detect an error, all they can do is either call
|
||||
.I MPI_Abort
|
||||
or silently skip the problem. Thus, if you change the error handler from
|
||||
.I MPI_ERRORS_ARE_FATAL
|
||||
to something else, for example,
|
||||
.I MPI_ERRORS_RETURN
|
||||
,
|
||||
then no error may be indicated.
|
||||
|
||||
The reason for this is the performance problems in ensuring that
|
||||
all collective routines return the same error value.
|
||||
|
||||
.SH THREAD AND INTERRUPT SAFETY
|
||||
|
||||
This routine is thread-safe. This means that this routine may be
|
||||
@@ -80,23 +103,6 @@ All MPI objects (e.g.,
|
||||
.I INTEGER
|
||||
in Fortran.
|
||||
|
||||
.SH NOTES ON COLLECTIVE OPERATIONS
|
||||
|
||||
The reduction functions (
|
||||
.I MPI_Op
|
||||
) do not return an error value. As a result,
|
||||
if the functions detect an error, all they can do is either call
|
||||
.I MPI_Abort
|
||||
or silently skip the problem. Thus, if you change the error handler from
|
||||
.I MPI_ERRORS_ARE_FATAL
|
||||
to something else, for example,
|
||||
.I MPI_ERRORS_RETURN
|
||||
,
|
||||
then no error may be indicated.
|
||||
|
||||
The reason for this is the performance problems in ensuring that
|
||||
all collective routines return the same error value.
|
||||
|
||||
.SH ERRORS
|
||||
|
||||
All MPI routines (except
|
||||
@@ -122,7 +128,7 @@ its use is deprecated. The predefined error handler
|
||||
may be used to cause error values to be returned.
|
||||
Note that MPI does
|
||||
.B not
|
||||
guarentee that an MPI program can continue past
|
||||
guarantee that an MPI program can continue past
|
||||
an error; however, MPI implementations will attempt to continue whenever
|
||||
possible.
|
||||
|
||||
@@ -133,6 +139,12 @@ possible.
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
.B MPI_ERR_BUFFER
|
||||
- Invalid buffer pointer. Usually a null buffer where
|
||||
one is not valid.
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
.B MPI_ERR_COMM
|
||||
- Invalid communicator. A common error is to use a null
|
||||
communicator in a call (not even allowed in
|
||||
@@ -144,6 +156,20 @@ communicator in a call (not even allowed in
|
||||
.B MPI_ERR_COUNT
|
||||
- Invalid count argument. Count arguments must be
|
||||
non-negative; a count of zero is often valid.
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
.B MPI_ERR_OP
|
||||
- Invalid operation. MPI operations (objects of type
|
||||
.I MPI_Op
|
||||
)
|
||||
must either be one of the predefined operations (e.g.,
|
||||
.I MPI_SUM
|
||||
) or
|
||||
created with
|
||||
.I MPI_Op_create
|
||||
\&.
|
||||
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
@@ -156,20 +182,10 @@ in a communication call.
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
.B MPI_ERR_BUFFER
|
||||
- Invalid buffer pointer. Usually a null buffer where
|
||||
one is not valid.
|
||||
.PD 1
|
||||
.PD 0
|
||||
.TP
|
||||
.B MPI_ERR_BUFFER
|
||||
- This error class is associcated with an error code that
|
||||
indicates that two buffer arguments are
|
||||
.B aliased
|
||||
; that is, the
|
||||
describe overlapping storage (often the exact same storage). This
|
||||
is prohibited in MPI (because it is prohibited by the Fortran
|
||||
standard, and rather than have a separate case for C and Fortran, the
|
||||
MPI Forum adopted the more restrictive requirements of Fortran).
|
||||
.B MPI_ERR_OTHER
|
||||
- Other error; use
|
||||
.I MPI_Error_string
|
||||
to get more information
|
||||
about this error code.
|
||||
.PD 1
|
||||
|
||||
|
||||
Reference in New Issue
Block a user