MPI_DUP_FN(3)

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

NAME

6       MPI_DUP_FN  -  Built-in MPI function to simple-mindedly copy communica‐
7       tor attributes.
8

SYNOPSIS

10       #include <mpi.h>
11       int MPI_DUP_FN(MPI_Comm comm, int key, void *extra,
12                      void *attrin, void *attrout, int *flag)
13

INPUT PARAMETERS

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

OUTPUT PARAMETERS

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

NOTES

29       This function is deprecated.  It has been replaced with an MPI-2  func‐
30       tion (see the "See also" section, below), which provides the same func‐
31       tionality.  This function is (or  effectively  is)  a  wrapper  to  the
32       replacement  function,  anyway.   User  programs  should  use the MPI-2
33       replacement function instead of this function.
34
35       Some functions are deprecated because their names did  not  conform  to
36       the stricter naming conventions of MPI-2; others are deprecated because
37       they have been replaced with more flexible functionality.
38
39

ADDITIONAL

45       Note that the C typedefs MPI_Copy_function and  MPI_MPI_Delete_function
46       are  also deprecated, in favor of their new names - MPI_Comm_copy_func‐
47       tion , MPI_Comm_delete_function .
48
49
50       Additionally, the MPI constants MPI_NULL_COPY_FN and MPI_NULL_DELETE_FN
51       are also deprecated in favor of their new names - MPI_COMM_NULL_COPY_FN
52       and MPI_COMM_NULL_DELETE_FN .
53
54
55

MORE INFORMATION

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

ACKNOWLEDGEMENTS

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

LOCATION

73       dupfn.c
74
75
76
77LAM/MPI 7.1.2                      2/23/2006                     MPI_DUP_FN(3)