MPI_TYPE_DUP_FN(3)

1MPI_TYPE_DUP_FN(3)                  LAM/MPI                 MPI_TYPE_DUP_FN(3)
2
3
4

NAME

6       MPI_TYPE_DUP_FN  -   Built-in  MPI  function  to  simple-mindedly  copy
7       datatype attributes.
8

SYNOPSIS

10       #include <mpi.h>
11       int MPI_TYPE_DUP_FN(MPI_Datatype dtype, int key,
12                          void *extra, void *attrin, void *attrout,
13                          int *flag)
14

INPUT PARAMETERS

16       dtype  - communicator (handle)
17       key    - key value (integer)
18       extra  - extra state
19       attrin - in value for attribute
20
21

OUTPUT PARAMETERS

23       attrout
24              - out value for attribute
25       flag   - 1 if attribute copied successfully, 0 otherwise (logical)
26
27

NOTES

29       This function blindly byte-copies attributes on datatypes.  It  is  the
30       default  atrribute-copying  function for datatypes.  This function will
31       always return MPI_SUCCESS , and flag will always be set to 1.
32
33       The actual copy is performed by the code
34
35       *((void **) attrout) = attrin;
36
37
38       If this simple assignment is not sufficient for  your  attributes,  you
39       will  need  to reassign the attribute-copying function on relevant key‐
40       vals on datatypes with the MPI_Type_keyval_create function.
41
42

NOTES FOR FORTRAN

44       All MPI routines in Fortran (except for MPI_WTIME and MPI_WTICK )  have
45       an  additional  argument ierr at the end of the argument list.  ierr is
46       an integer and has the same meaning as the return value of the  routine
47       in  C.   In Fortran, MPI routines are subroutines, and are invoked with
48       the call statement.
49
50       All MPI objects (e.g., MPI_Datatype , MPI_Comm ) are of type INTEGER in
51       Fortran.
52
53

MORE INFORMATION

59       For more information, please see the official MPI Forum web site, which
60       contains the text of both the MPI-1 and MPI-2 standards.   These  docu‐
61       ments  contain  detailed  information  about each MPI function (most of
62       which is not duplicated in these man pages).
63
64       http://www.mpi-forum.org/
65
66
67

ACKNOWLEDGEMENTS

69       The LAM Team would like the thank the MPICH Team for the handy  program
70       to  generate  man  pages ("doctext" from ftp://ftp.mcs.anl.gov/pub/sow‐
71       ing/sowing.tar.gz ), the initial formatting, and some initial text  for
72       most of the MPI-1 man pages.
73

LOCATION

75       dupfn.c
76
77
78
79LAM/MPI 7.1.2                      2/23/2006                MPI_TYPE_DUP_FN(3)