gls_version.h

Go to the documentation of this file.

/*! \file
  \brief  Used for matching version of libraries and headers.

  \par Copyright Information

  Copyright (c) 2018 by The DiSTI Corporation.<br>
  11301 Corporate Blvd; Suite 100<br>
  Orlando, Florida 32817<br>
  USA<br>
  <br>
  All rights reserved.<br>

  This Software contains proprietary trade secrets of DiSTI and may not be
reproduced, in whole or part, in any form, or by any means of electronic,
mechanical, or otherwise, without the written permission of DiSTI.  Said
permission may be derived through the purchase of applicable DiSTI product
licenses which detail the distribution rights of this content and any
Derivative Works based on this or other copyrighted DiSTI Software.

  NO WARRANTY. THE SOFTWARE IS PROVIDED "AS-IS," WITHOUT WARRANTY OF ANY KIND,
AND ANY USE OF THIS SOFTWARE PRODUCT IS AT YOUR OWN RISK. TO THE MAXIMUM EXTENT
PERMITTED BY APPLICABLE LAW, DISTI AND ITS SUPPLIERS DISCLAIM ALL WARRANTIES
AND CONDITIONS, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES AND CONDITIONS OF MERCHANTABILITY AND/OR FITNESS FOR A
PARTICULAR PURPOSE, TITLE, AND NON-INFRINGEMENT, WITH REGARD TO THE SOFTWARE.

  LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY APPLICABLE LAW,
IN NO EVENT SHALL DISTI OR ITS SUPPLIERS BE LIABLE FOR ANY SPECIAL, INCIDENTAL,
INDIRECT, OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION,
DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS INTERRUPTION, LOSS OF BUSINESS
INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR
INABILITY TO USE THE SOFTWARE, EVEN IF DISTI HAS BEEN ADVISED OF THE POSSIBILITY
OF SUCH DAMAGES.  DISTI'S ENTIRE LIABILITY AND YOUR EXCLUSIVE REMEDY SHALL NOT
EXCEED FIVE DOLLARS (US$5.00).

  The aforementioned terms and restrictions are governed by the laws of the
State of Florida and the United States of America.

*/

#ifndef INCLUDED_GLS_VERSION_H
#define INCLUDED_GLS_VERSION_H

/*
  GL Studio version pattern
  -----------------------------
  X.Y.B00M
  X = Major version
  Y = Minor version
  B = Build.  Increment for maintenance releases.  1 is the lowest value for a released product, i.e. there is no released Build 0.
  0 = Padding zeros.
  M = Build Minor.  Increment for in-house, pre-release builds and release candidates.  This does not have to be zero when a product ships.
*/
#include "gls_include.h"

// For atoi
#include <stdlib.h>

namespace disti
{

#define GLS_VERSION_MAJOR 7
#define GLS_VERSION_MINOR 0
#define GLS_VERSION_BUILD 0000

#define GLS_STRINGIZE(x) #x
#define GLS_STRINGIZE_VALUE(x) GLS_STRINGIZE(x)

// Build the GLS_VERSION string
#define GLS_VERSION_1(a,b) GLS_STRINGIZE(a.b)
#define GLS_VERSION GLS_VERSION_1(GLS_VERSION_MAJOR, GLS_VERSION_MINOR)
// Allows customers to upgrade within major versions without requiring an updated license.
#define GLS_LICENSE_VERSION GLS_VERSION_1(GLS_VERSION_MAJOR, 0)

// Build the GLS_BUILD_VERSION string
#define GLS_BUILD_VERSION GLS_STRINGIZE_VALUE(GLS_VERSION_BUILD)

#if defined(WIN32)

#if !defined(GLS_COMPILER_VERSION)
#  if _MSC_VER < 1400
#    pragma message("Warning (gls_version.h): Unrecognized compiler version")
#    define GLS_COMPILER_VERSION vcXX
#  else
#    if _MSC_VER < 1700
#      pragma message("Warning (gls_version.h): Unrecognized compiler version")
#      define GLS_COMPILER_VERSION vcXX
#    elif _MSC_VER < 1800
#      define GLS_COMPILER_VERSION vc110
#    elif _MSC_VER < 1900
#      define GLS_COMPILER_VERSION vc120
#    elif _MSC_VER < 1910
#      define GLS_COMPILER_VERSION vc140
#    elif _MSC_VER < 2000
#      define GLS_COMPILER_VERSION vc141
#    else
#      pragma message("Warning (gls_version.h): Unrecognized compiler version")
#      define GLS_COMPILER_VERSION vcXX
#    endif
#  endif
#endif

// 0x00FFFFFF - Reserved for _MSC_VER
// 0x01000000 - ML
// 0x02000000 - MT
// 0x04000000 - DLL
// 0x08000000 - DEBUG
#define GLS_CRT_VERSION_INT_MD  0x06000000 // MT + DLL
#define GLS_CRT_VERSION_INT_MT  0x02000000 // MT
#define GLS_CRT_VERSION_INT_ML  0x01000000 // ML
#define GLS_CRT_VERSION_INT_MDD 0x0E000000 // DEBUG + MT + DLL
#define GLS_CRT_VERSION_INT_MTD 0x0A000000 // DEBUG + MT
#define GLS_CRT_VERSION_INT_MLD 0x09000000 // DEBUG + ML

#define GLS_CRT_VERSION_INT_MD_64  0x16000000 // MT + DLL
#define GLS_CRT_VERSION_INT_MT_64  0x12000000 // MT
#define GLS_CRT_VERSION_INT_ML_64  0x11000000 // ML
#define GLS_CRT_VERSION_INT_MDD_64 0x1E000000 // DEBUG + MT + DLL
#define GLS_CRT_VERSION_INT_MTD_64 0x1A000000 // DEBUG + MT
#define GLS_CRT_VERSION_INT_MLD_64 0x19000000 // DEBUG + ML

#if !defined(GLS_CRT_VERSION)
#  if defined(_DEBUG)
#    if defined(_MT)
#      if defined(_DLL)
#        if defined(_WIN64)
#          define GLS_CRT_VERSION _64mdd
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MDD_64
#        else
#          define GLS_CRT_VERSION mdd
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MDD
#        endif
#      else
#        if defined(_WIN64)
#          define GLS_CRT_VERSION _64mtd
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MTD_64
#        else
#          define GLS_CRT_VERSION mtd
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MTD
#        endif
#      endif
#    else
#      if defined(_WIN64)
#        define GLS_CRT_VERSION _64mld
#        define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MLD_64
#      else
#        define GLS_CRT_VERSION mld
#        define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MLD
#      endif
#    endif
#  else
#    if defined(_MT)
#      if defined(_DLL)
#        if defined(_WIN64)
#          define GLS_CRT_VERSION _64md
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MD_64
#        else
#          define GLS_CRT_VERSION md
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MD
#        endif
#      else
#        if defined(_WIN64)
#          define GLS_CRT_VERSION _64mt
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MT_64
#        else
#          define GLS_CRT_VERSION mt
#          define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_MT
#        endif
#      endif
#    else
#      if defined(_WIN64)
#        define GLS_CRT_VERSION _64ml
#        define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_ML_64
#      else
#        define GLS_CRT_VERSION ml
#        define GLS_CRT_VERSION_INT GLS_CRT_VERSION_INT_ML
#      endif
#    endif
#  endif
#endif

// Build the GLS_CHECK_VERSION_ID function name
#define GLS_CHECK_VERSION_ID_2( a, b, c, d, e ) GLS_VERSION_##a##_##b##_##c##_##d##_##e // Complete check
#define GLS_CHECK_VERSION_ID_1( v1, v2, v3, c1, c2 ) GLS_CHECK_VERSION_ID_2( v1, v2, v3, c1, c2 )
#define GLS_CHECK_VERSION_ID GLS_CHECK_VERSION_ID_1( GLS_VERSION_MAJOR, GLS_VERSION_MINOR, GLS_VERSION_BUILD, GLS_COMPILER_VERSION, GLS_CRT_VERSION )

#else // UNIX

// Build the GLS_CHECK_VERSION_ID function name
#define GLS_CHECK_VERSION_ID_2( a, b, c ) GLS_VERSION_##a##_##b##_##c##_LIBRARY
#define GLS_CHECK_VERSION_ID_1( v1, v2, v3 ) GLS_CHECK_VERSION_ID_2( v1, v2, v3 )
#define GLS_CHECK_VERSION_ID GLS_CHECK_VERSION_ID_1( GLS_VERSION_MAJOR, GLS_VERSION_MINOR, GLS_VERSION_BUILD )

#endif


GLS_EXPORT void GLS_CHECK_VERSION_ID();

/** This is a type which shall remain consistant.  If an item must
  * be added, it shall be added at the end of the structure to avoid
  * compatibility issues.
  * This object is used to check dynamically loaded code with the container
  * performing the load.
  * This must be inline to work properly.
  */
class GlsBuiltVersionInfo2
{
public:
    int _glsMajor;
    int _glsMinor;
    int _glsBuild;
    int _compilerVersion;

    inline GlsBuiltVersionInfo2(
        int glsMajor = GLS_VERSION_MAJOR,
        int glsMinor = GLS_VERSION_MINOR,
        int glsBuild = GLS_VERSION_BUILD,
#if defined(_MSC_VER)
        int compilerVersion = _MSC_VER + GLS_CRT_VERSION_INT ) // Complete check
#elif defined(__GNUC__)
        int compilerVersion = __GNUC__ * 10000 + __GNUC_MINOR__ * 100 + __GNUC_PATCHLEVEL__)
#else
        int compilerVersion = 0)
#endif
    {
        _glsMajor = glsMajor;
        _glsMinor = glsMinor;
        _glsBuild = glsBuild;
        _compilerVersion = compilerVersion;
    }
};

typedef GlsBuiltVersionInfo2 GlsBuiltVersionInfo;

// Returns true if the version info matches exactly
// (They reference the same dll / so)
inline bool GlsBuiltVersionsMatchExactly(const GlsBuiltVersionInfo& a, const GlsBuiltVersionInfo& b)
{
    return a._glsMajor == b._glsMajor &&
        a._glsMinor == b._glsMinor &&
        a._glsBuild == b._glsBuild &&
        a._compilerVersion == b._compilerVersion;
}

// Returns true if the versions are binary compatible
// (May be different dll / so, but they are link compatible)
inline bool GlsBuiltVersionsAreBinaryCompatible(const GlsBuiltVersionInfo& a, const GlsBuiltVersionInfo& b)
{
    bool compiler_compatible = (a._compilerVersion == b._compilerVersion);

#if defined(__GNUC__)

    if (!compiler_compatible)
    {
        if (a._compilerVersion >= 30400 && b._compilerVersion >= 30400 )
        {
            // GCC 3.4.0 or newer 
            // The C runtime library changed with 3.4.0
            compiler_compatible = true;
        }
    }

#endif

    // If this does not match, we fallback to RSO interface
    return (compiler_compatible &&
        a._glsMajor == b._glsMajor &&
        a._glsMinor == b._glsMinor &&
        a._glsBuild/1000 == b._glsBuild/1000 );
}

} // namespace disti

#endif