Start using Libtool's shared library versioning scheme. See lengthy

note in VERSION file.

NOTE: the versions will ''always'' be 0:0:0 on the SVN trunk and
developer branches.  They will only have meaningful values (starting
with 0:0:0 in 1.3.4) on release branches.  Only RM's will modify these
values immediately preceeding a release.

This commit was SVN r21729.

VERSION

@@ -1,5 +1,5 @@
 # Copyright (c) 2008      Sun Microsystems, Inc.  All rights reserved.
-# Copyright (c) 2008      Cisco Systems, Inc.  All rights reserved.
+# Copyright (c) 2008-2009 Cisco Systems, Inc.  All rights reserved.
 
 # This is the VERSION file for Open MPI, describing the precise
 # version of Open MPI in this distribution.  The various components of
@@ -42,3 +42,46 @@ svn_r=-1
 # The date when this release was created
 
 date="Unreleased developer copy"
+
+# The shared library version of each of Open MPI's public libraries.
+# These versions are maintained in accordance with the "Library
+# Interface Versions" chapter from the GNU Libtool documentation.  The
+# first Open MPI release to formally use these versions was v1.3.4 --
+# they introduced version 0:0:0.  Subsequent changes in these version
+# numbers are dictated by the Open MPI release managers (not
+# individual developers).  Notes:
+
+# 1. Since these version numbers are associated with *releases*, the
+# version numbers maintained on the Open MPI SVN trunk (and developer
+# branches) is always 0:0:0 for all libraries.
+
+# 2. The version number of libmpi refers to the public MPI interfaces.
+# It does not refer to any internal interfaces.
+
+# 3. Similar to libmpi, libmpi_f77, libmpi_f90 (and possibly other
+# Fortran libraries someday -- shrudder!), the version number refers
+# to the public MPI interfaces.  Note that there have been typo fixes
+# in the parameter types to libmpi_f77 functions over time; these
+# technically did not change the interface because Fortran 77 does not
+# link by parameter type.
+
+# 4. Similar to libmpi, libmpi_cxx's version number refers to the
+# public MPI interfaces.  Note that this version number may or may not
+# be affected by changes to inlined functions in OMPI's
+# header-file-based C++ bindings implementation.
+
+# 5. The ORTE and OPAL libraries will change versions when their
+# public interfaces change (as relative to the layer(s) above them).
+# None of the ORTE and OPAL interfaces are public to MPI applications,
+# but they are "public" within the OMPI code base and select 3rd party
+# software packages.
+
+# Version numbers are described in the Libtool current:revision:age
+# format.
+
+libmpi_so_version=0:0:0
+libmpi_cxx_so_version=0:0:0
+libmpi_f77_so_version=0:0:0
+libmpi_f90_so_version=0:0:0
+libopen_rte_so_version=0:0:0
+libopen_pal_so_version=0:0:0

ompi/Makefile.am

@@ -9,7 +9,7 @@
 #                         University of Stuttgart.  All rights reserved.
 # Copyright (c) 2004-2005 The Regents of the University of California.
 #                         All rights reserved.
-# Copyright (c) 2008      Cisco Systems, Inc.  All rights reserved.
+# Copyright (c) 2008-2009 Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2008      Sun Microsystems, Inc.  All rights reserved.
 # $COPYRIGHT$
 # 
@@ -124,6 +124,7 @@ libmpi_la_DEPENDENCIES = \
 	$(EXT_ompi_FRAMEWORK_LIBS) \
 	$(top_ompi_builddir)/orte/libopen-rte.la
 libmpi_la_LDFLAGS = \
+        -version-info $(libmpi_so_version) \
 	$(OMPI_LIBMPI_EXTRA_LDFLAGS)
 
 # included subdirectory Makefile.am's and appended-to variables

ompi/mpi/cxx/Makefile.am

@@ -10,7 +10,7 @@
 #                         University of Stuttgart.  All rights reserved.
 # Copyright (c) 2004-2005 The Regents of the University of California.
 #                         All rights reserved.
-# Copyright (c) 2007-2008 Cisco Systems, Inc.  All rights reserved.
+# Copyright (c) 2007-2009 Cisco Systems, Inc.  All rights reserved.
 # $COPYRIGHT$
 # 
 # Additional copyrights may follow
@@ -45,6 +45,7 @@ libmpi_cxx_la_SOURCES += \
 endif
 
 libmpi_cxx_la_LIBADD = $(top_builddir)/ompi/libmpi.la
+libmpi_cxx_la_LDFLAGS = -version-info $(libmpi_cxx_so_version)
 
 headers = \
 	mpicxx.h \

ompi/mpi/f77/Makefile.am

@@ -49,6 +49,7 @@ AM_CPPFLAGS = -DOMPI_PROFILE_LAYER=0 -DOMPI_COMPILING_F77_WRAPPERS=1
 
 lib_LTLIBRARIES =
 libmpi_f77_la_LIBADD = $(top_builddir)/ompi/libmpi.la
+libmpi_f77_la_LDFLAGS = -version-info $(libmpi_f77_so_version)
 
 # Are we building the F77 bindings at all?
 if OMPI_WANT_F77_BINDINGS

ompi/mpi/f90/Makefile.am

@@ -10,7 +10,7 @@
 #                         University of Stuttgart.  All rights reserved.
 # Copyright (c) 2004-2005 The Regents of the University of California.
 #                         All rights reserved.
-# Copyright (c) 2006-2008 Cisco Systems, Inc.  All rights reserved.
+# Copyright (c) 2006-2009 Cisco Systems, Inc.  All rights reserved.
 # Copyright (c) 2007      Los Alamos National Security, LLC.  All rights
 #                         reserved. 
 # $COPYRIGHT$
@@ -250,7 +250,9 @@ nodist_libmpi_f90_la_SOURCES += $(small_sources) $(medium_sources) $(large_sourc
 endif
 
 # see note in config/ompi_setup_f90.m4
-libmpi_f90_la_LDFLAGS = $(OMPI_F90_EXTRA_SHARED_LIBRARY_FLAGS)
+libmpi_f90_la_LDFLAGS = \
+        -version-info $(libmpi_f90_so_version) \
+        $(OMPI_F90_EXTRA_SHARED_LIBRARY_FLAGS)
 
 #
 # Clean up all F90 module files and all generated files

opal/Makefile.am

@@ -9,6 +9,7 @@
 #                         University of Stuttgart.  All rights reserved.
 # Copyright (c) 2004-2005 The Regents of the University of California.
 #                         All rights reserved.
+# Copyright (c) 2009      Cisco Systems, Inc.  All rights reserved.
 # $COPYRIGHT$
 # 
 # Additional copyrights may follow
@@ -56,8 +57,8 @@ libopen_pal_la_LIBADD = \
         mca/base/libmca_base.la \
         util/libopalutil.la \
 	$(MCA_opal_FRAMEWORK_LIBS)
-
 libopen_pal_la_DEPENDENCIES = $(libopen_pal_la_LIBADD)
+libopen_pal_la_LDFLAGS = -version-info $(libopen_pal_so_version)
 
 # included subdirectory Makefile.am's and appended-to variables
 headers =

orte/Makefile.am

@@ -9,6 +9,7 @@
 #                         University of Stuttgart.  All rights reserved.
 # Copyright (c) 2004-2005 The Regents of the University of California.
 #                         All rights reserved.
+# Copyright (c) 2009      Cisco Systems, Inc.  All rights reserved.
 # $COPYRIGHT$
 # 
 # Additional copyrights may follow
@@ -38,7 +39,7 @@ libopen_rte_la_LIBADD = \
 	$(MCA_orte_FRAMEWORK_LIBS) \
 	$(top_ompi_builddir)/opal/libopen-pal.la
 libopen_rte_la_DEPENDENCIES = $(libopen_rte_la_LIBADD)
-
+libopen_rte_la_LDFLAGS = -version-info $(libopen_rte_so_version)
 
 # included subdirectory Makefile.am's and appended-to variables
 headers =