1
1

MPI_Comm_spawn_multiple.3in: update Fortran string array notes

Per 0ab6b201fe, 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 <jsquyres@cisco.com>
Этот коммит содержится в:
Jeff Squyres
2018-04-05 06:52:46 -07:00
родитель 17a5416464
Коммит fc8ebbb0e0

Просмотреть файл

@ -1,6 +1,6 @@
.\" -*- nroff -*- .\" -*- nroff -*-
.\" Copyright 2013 Los Alamos National Security, LLC. All rights reserved. .\" Copyright 2013 Los Alamos National Security, LLC. All rights reserved.
.\" Copyright (c) 2010 Cisco Systems, Inc. All rights reserved. .\" Copyright (c) 2010-2018 Cisco Systems, Inc. All rights reserved
.\" Copyright 2006-2008 Sun Microsystems, Inc. .\" Copyright 2006-2008 Sun Microsystems, Inc.
.\" Copyright (c) 1996 Thinking Machines Corporation .\" Copyright (c) 1996 Thinking Machines Corporation
.\" $COPYRIGHT$ .\" $COPYRIGHT$
@ -249,6 +249,15 @@ parameter; see MPI_Comm_spawn(3)'s description of the
.I argv .I argv
parameter for more details. parameter for more details.
.sp .sp
MPI-3.1 implies (but does not directly state) that the argument
\fIarray_of_commands\fP must be an array of strings of length
\fIcount\fP. Unlike the \fIarray_of_argv\fP parameter,
\fIarray_of_commands\fP does not need to be terminated with a NULL
pointer in C or a blank string in Fortran. Older versions of Open MPI
required that \fIarray_of_commands\fP be terminated with a blank
string in Fortran; that is no longer required in this version of Open
MPI.
.sp
Calling MPI_Comm_spawn(3) many times would create many sets of Calling MPI_Comm_spawn(3) many times would create many sets of
children with different MPI_COMM_WORLDs, whereas children with different MPI_COMM_WORLDs, whereas
MPI_Comm_spawn_multiple creates children with a single MPI_COMM_WORLD, MPI_Comm_spawn_multiple creates children with a single MPI_COMM_WORLD,