SOVERSION.rst 1.1 KB

123456789101112131415161718192021222324252627
  1. SOVERSION
  2. ---------
  3. What version number is this target.
  4. For shared libraries :prop_tgt:`VERSION` and ``SOVERSION`` can be used to
  5. specify the build version and API version respectively. When building or
  6. installing appropriate symlinks are created if the platform supports
  7. symlinks and the linker supports so-names. If only one of both is
  8. specified the missing is assumed to have the same version number.
  9. ``SOVERSION`` is ignored if :prop_tgt:`NO_SONAME` property is set.
  10. Windows Versions
  11. ^^^^^^^^^^^^^^^^
  12. For shared libraries and executables on Windows the :prop_tgt:`VERSION`
  13. attribute is parsed to extract a ``<major>.<minor>`` version number.
  14. These numbers are used as the image version of the binary.
  15. Mach-O Versions
  16. ^^^^^^^^^^^^^^^
  17. For shared libraries and executables on Mach-O systems (e.g. OS X, iOS),
  18. the ``SOVERSION`` property corresponds to *compatibility version* and
  19. :prop_tgt:`VERSION` to *current version*. See the :prop_tgt:`FRAMEWORK` target
  20. property for an example. Versions of Mach-O binaries may be checked with the
  21. ``otool -L <binary>`` command.