Merge pull request #8162 from Colton-K/pr/MPI_C_batch2

Converted batch 2 of MPI_C* (MPI_Comm_accept - MPI_Comm_dup_with_info)

Author: jsquyres

ompi/mpi/man/man3/MPI_Comm_accept.3in

@@ -0,0 +1,78 @@
+# Name
+
+`MPI_Comm_accept` - Establishes communication with a client.
+
+# Syntax
+
+## C Syntax
+
+```c
+#include <mpi.h>
+
+int MPI_Comm_accept(const char *port_name, MPI_Info info, int root, MPI_Comm comm, MPI_Comm *newcomm)
+```
+
+## Fortran Syntax
+
+```fortran
+USE MPI
+! or the older form: INCLUDE 'mpif.h'
+
+MPI_COMM_ACCEPT(PORT_NAME, INFO, ROOT, COMM, NEWCOMM, IERROR)
+    CHARACTER*(*)	PORT_NAME
+    INTEGER		INFO, ROOT, COMM, NEWCOMM, IERROR
+```
+
+## Fortran 2008 Syntax
+
+```fortran
+USE mpi_f08
+
+MPI_Comm_accept(port_name, info, root, comm, newcomm, ierror)
+    CHARACTER(LEN=*), INTENT(IN) :: port_name
+    TYPE(MPI_Info), INTENT(IN) :: info
+    INTEGER, INTENT(IN) :: root
+    TYPE(MPI_Comm), INTENT(IN) :: comm
+    TYPE(MPI_Comm), INTENT(OUT) :: newcomm
+    INTEGER, OPTIONAL, INTENT(OUT) :: ierror
+```
+
+
+# Input Parameters
+
+* `port_name` : Port name (string, used only on *root*).
+* `info` : Options given by root for the accept (handle, used only on root). No
+options currently supported.
+* `root` : Rank in *comm* of root node (integer).
+* `comm` : Intracommunicator over which call is collective (handle).
+
+# Output Parameters
+
+* `newcomm` : Intercommunicator with client as remote group (handle)
+* `IERROR` : Fortran only: Error status (integer).
+
+# Description
+
+`MPI_Comm_accept` establishes communication with a client. It is
+collective over the calling communicator. It returns an
+intercommunicator that allows communication with the client, after the
+client has connected with the `MPI_Comm_accept` function using the
+`MPI_Comm_connect` function.
+The `port_name` must have been established through a call to
+`MPI_Open_port` on the `root`.
+
+# Errors
+
+Almost all MPI routines return an error value; C routines as the value
+of the function and Fortran routines in the last argument.
+Before the error value is returned, the current MPI error handler is
+called. By default, this error handler aborts the MPI job, except for
+I/O function errors. The error handler may be changed with
+`MPI_Comm_set_errhandler`; the predefined error handler `MPI_ERRORS_RETURN`
+may be used to cause error values to be returned.
+See the MPI man page for a full list of MPI error codes.
+
+# See Also
+
+[`MPI_Comm_connect`(3)](MPI_Comm_connect.html)
+[`MPI_Open_port`(3)](MPI_Open_port.html)

ompi/mpi/man/man3/MPI_Comm_accept.md

@@ -0,0 +1,69 @@
+# Name
+
+`MPI_Comm_call_errhandler` - Passes the supplied error code to the
+error handler assigned to a communicator
+
+# Syntax
+
+## C Syntax
+
+```c
+#include <mpi.h>
+
+int MPI_Comm_call_errhandler(MPI_Comm comm, int errorcode)
+```
+
+## Fortran Syntax
+
+```fortran
+USE MPI
+! or the older form: INCLUDE 'mpif.h'
+
+MPI_COMM_CALL_ERRHANDLER(COMM, ERRORCODE, IERROR)
+    INTEGER	COMM, ERRORCODE, IERROR
+```
+
+## Fortran 2008 Syntax
+
+```fortran
+USE mpi_f08
+
+MPI_Comm_call_errhandler(comm, errorcode, ierror)
+    TYPE(MPI_Comm), INTENT(IN) :: comm
+    INTEGER, INTENT(IN) :: errorcode
+    INTEGER, OPTIONAL, INTENT(OUT) :: ierror
+```
+
+
+# Input Parameter
+
+* `comm` : communicator with error handler (handle).
+* `errorcode` : error code (integer).
+
+# Output Parameters
+
+* `IERROR` : Fortran only: Error status (integer).
+
+# Description
+
+This function invokes the error handler assigned to the `comm`unicator
+`comm` with the supplied error code `errorcode`. If the error handler
+was successfully called, the process is not aborted, and the error
+handler returns, this function returns `MPI_SUCCESS.`
+
+# Notes
+
+Users should note that the default error handler is
+`MPI_ERRORS_ARE_FATAL`. Thus, calling this function will abort the
+processes in `comm` if the default error handler has not been changed.
+
+# Errors
+
+Almost all MPI routines return an error value; C routines as the value
+of the function and Fortran routines in the last argument.
+See the MPI man page for a full list of MPI error codes.
+
+# See Also
+
+[`MPI_Comm_create_errhandler`(3)](MPI_Comm_create_errhandler.html)
+[`MPI_Comm_set_errhandler`(3)](MPI_Comm_set_errhandler.html)