Skip to content

Commit d8098fa

Browse files
committed
README: Add more info about "backwards compatibility"
Add more clarifying statements about our definition of "backwards compatibility" -- adding an example with static linking and another with containers. Signed-off-by: Jeff Squyres <[email protected]> (cherry picked from commit 842f8c1)
1 parent 0293d2d commit d8098fa

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

README

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ Copyright (c) 2004-2008 High Performance Computing Center Stuttgart,
88
University of Stuttgart. All rights reserved.
99
Copyright (c) 2004-2007 The Regents of the University of California.
1010
All rights reserved.
11-
Copyright (c) 2006-2016 Cisco Systems, Inc. All rights reserved.
11+
Copyright (c) 2006-2017 Cisco Systems, Inc. All rights reserved.
1212
Copyright (c) 2006-2011 Mellanox Technologies. All rights reserved.
1313
Copyright (c) 2006-2012 Oracle and/or its affiliates. All rights reserved.
1414
Copyright (c) 2007 Myricom, Inc. All rights reserved.
@@ -1412,6 +1412,20 @@ processes in a single MPI job. If the versions are not exactly the
14121412
same everywhere, Open MPI is not guaranteed to work properly in any
14131413
scenario.
14141414

1415+
Backwards compatibility tends to work best when user applications are
1416+
dynamically linked to one version of the Open MPI / OSHMEM libraries,
1417+
and can be updated at run time to link to a new version of the Open
1418+
MPI / OSHMEM libraries.
1419+
1420+
For example, if an MPI / OSHMEM application links statically against
1421+
the libraries from Open MPI vX, then attempting to launch that
1422+
application with mpirun / oshrun from Open MPI vY is not guaranteed to
1423+
work (because it is mixing vX and vY of Open MPI in a single job).
1424+
1425+
Similarly, if using a container technology that internally bundles all
1426+
the libraries from Open MPI vX, attempting to launch that container
1427+
with mpirun / oshrun from Open MPI vY is not guaranteed to work.
1428+
14151429
Software Version Number
14161430
-----------------------
14171431

0 commit comments

Comments
 (0)