File: MPI_Errhandler_c2f.3

package info (click to toggle)
lam 6.5.6-6
  • links: PTS
  • area: main
  • in suites: woody
  • size: 15,464 kB
  • ctags: 11,670
  • sloc: ansic: 101,210; cpp: 12,146; sh: 10,821; makefile: 4,050; fortran: 218
file content (75 lines) | stat: -rw-r--r-- 1,519 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
.TH MPI_Errhandler_c2f 3 "11/19/2001" "LAM/MPI 6.5.6" "LAM/MPI"
.SH NAME
MPI_Errhandler_c2f \-  Convert an error handler from its C representation to its Fortran representation 
.SH SYNOPSIS
.nf
#include <mpi.h>
MPI_Fint
MPI_Errhandler_c2f(MPI_Errhandler err)
.fi
.SH INPUT PARAMETER
.PD 0
.TP
.B err 
- C error handler
.PD 1

.SH RETURN VALUE
.PD 0
.TP
.B f_handle 
- Fortran error handler
.PD 1

.SH DESCRIPTION

This is a non-standard MPI routine.  It is mainly here because ROMIO
needs it.

.SH NOTES FOR FORTRAN

All MPI routines in Fortran (except for 
.I MPI_WTIME
and 
.I MPI_WTICK
)
have an additional argument 
.I ierr
at the end of the argument list.
.I ierr
is an integer and has the same meaning as the return value of
the routine in C.  In Fortran, MPI routines are subroutines, and are
invoked with the 
.I call
statement.

All MPI objects (e.g., 
.I MPI_Datatype
, 
.I MPI_Comm
) are of type
.I INTEGER
in Fortran.

.SH ERRORS

This function does not return the normal 
.I MPI_SUCCESS
integer value
upon success.  Instead, it returns a handle to the converted object.
If an error occurs, the appropriate NULL handle will be returned.

.SH SEE ALSO
MPI_Errhandler_c2f(3)
.br

.SH MORE INFORMATION

For more information, please see the official MPI Forum web site,
which contains the text of both the MPI-1 and MPI-2 standards.  These
documents contain detailed information about each MPI function (most
of which is not duplicated in these man pages).

.I http://www.mpi-forum.org/
.SH LOCATION
handles.c