---
name: "MPI_DUP_FN"
section: "3"
platform: "linux"
package: "lam-mpidoc"
version: "7.1.4-7.2"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/MPI_DUP_FN"
---

# MPI\_DUP\_FN(3)

Built-in MPI function to simple-mindedly copy communicator attributes.

## NAME

MPI\_DUP\_FN -  Built-in MPI function to simple-mindedly copy communicator attributes.

## SYNOPSIS

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

## INPUT PARAMETERS

- **comm**

  \- communicator (handle)

- **key**

  \- key value (integer)

- **extra**

  \- extra state

- **attrin**

  \- in value for attribute

## OUTPUT PARAMETERS

- **attrout**

  \- out value for attribute

- **flag**

  \- 1 if attribute copied successfully, 0 otherwise (logical)

## NOTES

This function is deprecated.  It has been replaced with an MPI-2 function (see the "See also" section, below), which provides the same functionality.  This function is (or effectively is) a wrapper to the replacement function, anyway.  User programs should use the MPI-2 replacement function instead of this function.

Some functions are deprecated because their names did not conform to the stricter naming conventions of MPI-2; others are deprecated because they have been replaced with more flexible functionality.

## SEE ALSO

MPI\_COMM\_DUP\_FN\

## ADDITIONAL

Note that the C typedefs  *MPI\_Copy\_function* and *MPI\_MPI\_Delete\_function* are also deprecated, in favor of their new names -  *MPI\_Comm\_copy\_function* ,  *MPI\_Comm\_delete\_function* .

Additionally, the MPI constants  *MPI\_NULL\_COPY\_FN* and *MPI\_NULL\_DELETE\_FN* are also deprecated in favor of their new names - *MPI\_COMM\_NULL\_COPY\_FN* and  *MPI\_COMM\_NULL\_DELETE\_FN* .

## 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).

*http://www.mpi-forum.org/*

## ACKNOWLEDGEMENTS

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

## LOCATION

dupfn.c