[ovs-git] [openvswitch/ovs] bfbc80: libopenvswitch: Rename to libfoo-X.Y.

GitHub noreply at github.com
Thu May 18 18:29:13 UTC 2017

  Branch: refs/heads/branch-2.7
  Home:   https://github.com/openvswitch/ovs
  Commit: bfbc8063e4e0c060c6d5bbfb28fd0769fa549d99
  Author: Joe Stringer <joe at ovn.org>
  Date:   2017-05-18 (Thu, 18 May 2017)

  Changed paths:
    M Documentation/internals/contributing/libopenvswitch-abi.rst
    M m4/openvswitch.m4

  Log Message:
  libopenvswitch: Rename to libfoo-X.Y.

The current intent for Open vSwitch is to maintain libopenvswitch ABI
stability for minor versions, for example each release within the 2.7.z
series. According to the following documentation, no changes to exported
headers should be made.


However, it is occasionally necessary to make changes to
{include/openvswitch,lib}/*.h headers to fix issues within a given
release series. The current libtool tagging mechanism in the build
system does not allow for this without creating a conflict between the
libtool 'current' version and the next minor release of OVS.

This patch modifies libopenvswitch build to include the MAJOR.MINOR
release version in the libX name, and include the libtool CURRENT and
OVS MICRO release in the libtool versioning tags to indicate library
stability. The resulting format is "libfoo-X.Y.so.CURRENT.0.Z" for OVS
release "X.Y.Z".

Developers should still attempt to avoid introducing ABI-breaking changes
within a particular OVS-X.Y release series, but if this is not possible
this patch introduced a mechanism to allow an ABI-breaking fix to be
introduced. In such a case, developers may update the libtool CURRENT
version to indicate this breakage to library users.

Signed-off-by: Joe Stringer <joe at ovn.org>
Acked-by: Ben Pfaff <blp at ovn.org>
Acked-by: Aaron Conole <aconole at redhat.com>

  Commit: 59f31240e4cc8eaa510ac01f525c6df1d5418efc
  Author: Joe Stringer <joe at ovn.org>
  Date:   2017-05-18 (Thu, 18 May 2017)

  Changed paths:
    M NEWS

  Log Message:
  NEWS: Describe libopenvswitch-X.Y change.

The previous commit renamed libopenvswitch-X to libopenvswitch-X.Y to
allow ABI breakage to be expressed through libtool numbering. Document
this change.

Signed-off-by: Joe Stringer <joe at ovn.org>
Acked-by: Aaron Conole <aconole at redhat.com>

Compare: https://github.com/openvswitch/ovs/compare/84e2a1c81ef9...59f31240e4cc

More information about the git mailing list