Skip to content

Commit fc8ebbb

Browse files
committed
MPI_Comm_spawn_multiple.3in: update Fortran string array notes
Per 0ab6b20, note in the MPI_Comm_spawn_multiple.3in man page that the array_of_commands does not need to be terminated -- it just need to have exactly "count" entries. In the Fortran binding, at least, this is different than in prior released versions of Open MPI (it's not a backwards incompatibility, since prior versions of Open MPI required array_of_commands to be blank-string-terminated in Fortran -- this change makes Open MPI be *less* restrictive, and therefore still backwards compatible). Signed-off-by: Jeff Squyres <[email protected]>
1 parent 17a5416 commit fc8ebbb

File tree

1 file changed

+10
-1
lines changed

1 file changed

+10
-1
lines changed

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

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
.\" -*- nroff -*-
22
.\" Copyright 2013 Los Alamos National Security, LLC. All rights reserved.
3-
.\" Copyright (c) 2010 Cisco Systems, Inc. All rights reserved.
3+
.\" Copyright (c) 2010-2018 Cisco Systems, Inc. All rights reserved
44
.\" Copyright 2006-2008 Sun Microsystems, Inc.
55
.\" Copyright (c) 1996 Thinking Machines Corporation
66
.\" $COPYRIGHT$
@@ -249,6 +249,15 @@ parameter; see MPI_Comm_spawn(3)'s description of the
249249
.I argv
250250
parameter for more details.
251251
.sp
252+
MPI-3.1 implies (but does not directly state) that the argument
253+
\fIarray_of_commands\fP must be an array of strings of length
254+
\fIcount\fP. Unlike the \fIarray_of_argv\fP parameter,
255+
\fIarray_of_commands\fP does not need to be terminated with a NULL
256+
pointer in C or a blank string in Fortran. Older versions of Open MPI
257+
required that \fIarray_of_commands\fP be terminated with a blank
258+
string in Fortran; that is no longer required in this version of Open
259+
MPI.
260+
.sp
252261
Calling MPI_Comm_spawn(3) many times would create many sets of
253262
children with different MPI_COMM_WORLDs, whereas
254263
MPI_Comm_spawn_multiple creates children with a single MPI_COMM_WORLD,

0 commit comments

Comments
 (0)