Skip to content

Commit 37b36a4

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]> (cherry picked from commit fc8ebbb)
1 parent b033dec commit 37b36a4

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$
@@ -232,6 +232,15 @@ parameter; see MPI_Comm_spawn(3)'s description of the
232232
.I argv
233233
parameter for more details.
234234
.sp
235+
MPI-3.1 implies (but does not directly state) that the argument
236+
\fIarray_of_commands\fP must be an array of strings of length
237+
\fIcount\fP. Unlike the \fIarray_of_argv\fP parameter,
238+
\fIarray_of_commands\fP does not need to be terminated with a NULL
239+
pointer in C or a blank string in Fortran. Older versions of Open MPI
240+
required that \fIarray_of_commands\fP be terminated with a blank
241+
string in Fortran; that is no longer required in this version of Open
242+
MPI.
243+
.sp
235244
Calling MPI_Comm_spawn(3) many times would create many sets of
236245
children with different MPI_COMM_WORLDs, whereas
237246
MPI_Comm_spawn_multiple creates children with a single MPI_COMM_WORLD,

0 commit comments

Comments
 (0)