master: Add -m32 flag to cmake command.

1. Remove certian test from 32 bit compile case.
2.
compile_source_test.cmake: set compiler flags (Bug fix).
player.hpp: avoid double definition of setup_random (Bug fix).

Author: bradbell

CMakeLists.txt

@@ -16,7 +16,7 @@ IF( POLICY CMP0054 )
 ENDIF( POLICY CMP0054 )
 #
 # cppad_version is used by version.sh to get the version number.
-SET(cppad_version "20250114")
+SET(cppad_version "20250117")
 SET(cppad_url          "https://coin-or.github.io/CppAD" )
 SET(cppad_description  "Differentiation of C++ Algorithms" )
 IF( NOT DEFINED CMAKE_BUILD_TYPE)
@@ -176,6 +176,11 @@ command_line_arg(cppad_cxx_flags "" STRING
    "compile flags used with cppad (besides debug, release, and profile flags)"
 )
 #
+# cppad_link_flags
+command_line_arg(cppad_link_flags "" STRING
+   "additional linker flags)"
+)
+#
 # cppad_profile_flag
 command_line_arg(cppad_profile_flag NOTFOUND STRING
    "compile flag used to compile and link a profile version of a program"
@@ -473,22 +478,42 @@ FOREACH(dir_types includedirs libdirs datadir docdir)
    ENDIF( cppad_postfix )
 ENDFOREACH(dir_types includedirs libdirs datadir docdir)
 # -----------------------------------------------------------------------------
+# cppad_link_flags_has_m32
+STRING( FIND "${cppad_link_flags}" "-m32" index)
+IF( "${index}" STREQUAL "-1" )
+   SET(cppad_link_flags_has_m32 0)
+ELSE ( )
+   SET(cppad_link_flags_has_m32 1)
+ENDIF( )
+# -----------------------------------------------------------------------------
 # OpenMP_CXX_FOUND, OpenMP_CXX_FLAGS
-IF( ${CMAKE_SYSTEM_NAME} STREQUAL "Darwin" )
+IF( cppad_link_flags_has_m32 )
+   SET(OpenMP_CXX_FOUND FALSE)
+   MESSAGE(STATUS
+      "Skipping OpenMP becasue -m32 is in cppad_link_flags"
+   )
+ELSEIF( ${CMAKE_SYSTEM_NAME} STREQUAL "Darwin" )
    SET(OpenMP_CXX_FOUND FALSE)
    MESSAGE(STATUS
       "Skipping OpenMP on Darwin (Mac) systems. 2DO: fix this"
    )
-ELSE( ${CMAKE_SYSTEM_NAME} STREQUAL "Darwin" )
+ELSE( )
    FIND_PACKAGE(OpenMP)
-ENDIF( ${CMAKE_SYSTEM_NAME} STREQUAL "Darwin" )
+ENDIF( )
 # -----------------------------------------------------------------------------
-# boost_prefix
+# Boost_Found, cppad_has_boost
 # Only need components for object libraries, not include libraries.
-SET(CMAKE_REQUIRED_FLAGS "")  # 2DO: why is this necessary with clang ?
-FIND_PACKAGE(Boost COMPONENTS thread)
-SET(CMAKE_REQUIRED_FLAGS "${cppad_cxx_flags}")
-SET(cppad_has_boost 0)
+IF( cppad_link_flags_has_m32 )
+   MESSAGE(STATUS
+      "Skipping Boost becasue -m32 is in cppad_link_flags"
+   )
+   SET( Boost_FOUND 0)
+   SET(cppad_has_boost 0)
+ELSE ( )
+   SET(CMAKE_REQUIRED_FLAGS "")  # 2DO: why is this necessary with clang ?
+   FIND_PACKAGE(Boost COMPONENTS thread)
+   SET(CMAKE_REQUIRED_FLAGS "${cppad_cxx_flags}")
+ENDIF( )
 IF ( Boost_FOUND )
    SET(cppad_has_boost 1)
    #
@@ -582,7 +607,9 @@ ELSE( )
    ENDIF( )
 ENDIF( )
 print_variable(is_cppad_lib_dynamic)
-
+#
+# CMAKE_EXE_LINKER_FLAGS
+SET(CMAKE_EXE_LINKER_FLAGS "${cppad_link_flags}" )
 #
 # Initialize list of tests as empty
 SET(check_depends "")

appendix/whats_new/2025.xrst

@@ -1,10 +1,12 @@
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell  <[email protected]>
-# SPDX-FileContributor: 2003-24 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 
 {xrst_begin 2025 app}
 {xrst_spell
+   dll
+   jit
 }
 
 Release Notes for 2025
@@ -13,6 +15,23 @@ Release Notes for 2025
 mm-dd
 *****
 
+01-17
+=====
+#. The :ref:`cmake@cppad_link_flags` option was added to the cmake command.
+
+#. The detection of when ``unsigned int`` and ``size_t`` were the same,
+   by the cmake command, was incorrect in cases where
+   the compiler flags affected this result.
+
+#. Fix some errors of the form *function_name*\ ``(unsigned int)``
+   cannot be overloaded with *function_name*\ ``(size_t)`` .
+
+#. The :ref:`dll_lib.cpp@Restrictions` ,
+   on when the dll_lib.cpp example is tested were documented.
+
+#. The :ref:`example_jit@Restrictions` was added to the
+   jit example documentation.
+
 01-10
 =====
 Split the external links at the top of the user guide into:

bin/run_cmake.sh

@@ -1,7 +1,7 @@
 #! /usr/bin/env bash
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-# SPDX-FileContributor: 2003-24 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 set -e -u
 echo $0 $*
@@ -20,6 +20,7 @@ echo_eval() {
 # -----------------------------------------------------------------------------
 verbose_make='no'
 standard='c++17'
+m32='no'
 profile_speed='no'
 callgrind='no'
 clang='no'
@@ -44,6 +45,7 @@ usage: bin/run_cmake.sh: \\
    [--help] \\
    [--verbose_make] \\
    [--c++11] \\
+   [--m32] \\
    [--profile_speed] \\
    [--callgrind] \\
    [--clang ] \\
@@ -78,6 +80,10 @@ EOF
       standard='c++11'
       ;;
 
+      --m32)
+      m32='yes'
+      ;;
+
       --profile_speed)
       profile_speed='yes'
       ;;
@@ -337,9 +343,21 @@ do
    cmake_args+="  -D ${package}_prefix=$prefix"
 done
 #
+# cppad_link_flags
+if [ "$m32" == 'yes' ]
+then
+   cmake_args+=" -D cppad_link_flags=-m32"
+fi
+#
 # cppad_cxx_flags
-cppad_cxx_flags="-Wall -pedantic-errors -std=$standard -Wshadow"
-cppad_cxx_flags+=" -Wfloat-conversion -Wconversion"
+if [ "$m32" == 'yes' ]
+then
+   cppad_cxx_flags="-std=$standard -m32"
+else
+   cppad_cxx_flags="-std=$standard"
+fi
+cppad_cxx_flags+=' -Wall -pedantic-errors -Wshadow'
+cppad_cxx_flags+=' -Wfloat-conversion -Wconversion'
 if [ "$debug_which" == 'debug_all' ]
 then
    # CMAKE_CXX_FLAGS_DEBUG include -g so do not need it here

cmake/compile_source_test.cmake

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-# SPDX-FileContributor: 2003-22 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 # compile_source_test(defined_ok source variable)
 #
@@ -33,6 +33,15 @@ MACRO(compile_source_test defined_ok source variable)
       ENDIF( DEFINED ${variable} )
    ENDIF( NOT ${defined_ok} )
    #
+   SET(CMAKE_REQUIRED_DEFINITIONS "" )
+   SET(CMAKE_REQUIRED_INCLUDES    "" )
+   SET(CMAKE_REQUIRED_LIBRARIES   "" )
+   IF( cppad_cxx_flags )
+      SET(CMAKE_REQUIRED_FLAGS   "${cppad_cxx_flags} ${CMAKE_CXX_FLAGS}" )
+   ELSE( cppad_cxx_flags )
+      SET(CMAKE_REQUIRED_FLAGS   "" )
+   ENDIF( cppad_cxx_flags )
+   #
    # check that source code compiles
    CHECK_CXX_SOURCE_COMPILES("${source}" ${variable} )
    #

cppad_lib/CMakeLists.txt

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-# SPDX-FileContributor: 2003-22 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 # Build and install the cppad_lib shared library
 #
@@ -50,7 +50,10 @@ IF( "${is_cppad_lib_dynamic}" STREQUAL "0" )
 ELSEIF( "${is_cppad_lib_dynamic}" STREQUAL "1" )
    MESSAGE( STATUS "Not Windows system so building shared cppad_lib")
    ADD_LIBRARY( cppad_lib SHARED ${source_list} )
-   SET_TARGET_PROPERTIES( cppad_lib PROPERTIES SOVERSION ${soversion} )
+   SET_TARGET_PROPERTIES( cppad_lib PROPERTIES
+      SOVERSION ${soversion}
+      LINK_OPTIONS "${cppad_link_flags}"
+   )
    #
    FIND_LIBRARY(dl_LIBRARY dl)
    IF( dl_LIBRARY )

example/CMakeLists.txt

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-# SPDX-FileContributor: 2003-22 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 # Build the example directory tests
 # Inherit environment from ../CMakeList.txt
@@ -18,7 +18,6 @@ ADD_SUBDIRECTORY(compare_change)
 ADD_SUBDIRECTORY(general)
 ADD_SUBDIRECTORY(get_started)
 ADD_SUBDIRECTORY(graph)
-ADD_SUBDIRECTORY(jit)
 ADD_SUBDIRECTORY(json)
 ADD_SUBDIRECTORY(multi_thread)
 ADD_SUBDIRECTORY(optimize)
@@ -37,6 +36,12 @@ ENDIF( cppad_has_cppadcg )
 IF( cppad_has_ipopt)
    ADD_SUBDIRECTORY(ipopt_solve)
 ENDIF( cppad_has_ipopt)
+#
+# jit examples
+IF( NOT cppad_link_flags_has_m32 )
+   ADD_SUBDIRECTORY(jit)
+ENDIF( )
+
 
 
 # Add the check_example target

example/jit/jit.xrst

@@ -1,12 +1,17 @@
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-# SPDX-FileContributor: 2003-23 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 {xrst_begin example_jit}
 
 JIT Creation, Compilation, and Linking of C Source Code
 #######################################################
 
+Restrictions
+************
+These examples are not tested when the
+:ref:`cmake@cppad_link_flags` contain ``-m32`` .
+
 Contents
 ********
 {xrst_toc_table

example/multi_thread/openmp/CMakeLists.txt

@@ -1,6 +1,6 @@
 # SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 # SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-# SPDX-FileContributor: 2003-24 Bradley M. Bell
+# SPDX-FileContributor: 2003-25 Bradley M. Bell
 # ----------------------------------------------------------------------------
 # Build the example/multi_thread/openmp directory tests
 # Inherit build type from ../CMakeList.txt
@@ -38,7 +38,7 @@ TARGET_LINK_LIBRARIES(
 )
 
 # Extra flags used by linker for openmp support
-SET(CMAKE_EXE_LINKER_FLAGS ${OpenMP_CXX_FLAGS} )
+SET(CMAKE_EXE_LINKER_FLAGS "${OpenMP_CXX_FLAGS} ${cppad_link_flags}" )
 
 # check_example_multi_thread_openmp
 add_check_executable(check_example_multi_thread openmp get_started)

example/utility/dll_lib.cpp

@@ -1,10 +1,13 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 // SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-// SPDX-FileContributor: 2003-22 Bradley M. Bell
+// SPDX-FileContributor: 2003-25 Bradley M. Bell
 // ----------------------------------------------------------------------------
 
 /*
 {xrst_begin dll_lib.cpp}
+{xrst_spell
+   msvc
+}
 
 dll_lib: Example and Test
 #########################
@@ -19,6 +22,19 @@ from the default options:
    // END_OPTIONS
 }
 
+Restrictions
+************
+This example is only built and run under the following conditions:
+
+#. The :ref:`cmake-name` command determines that the C compiler is
+   gcc, clang, or msvc.
+
+#. The :ref:`cmake-name` command determines it is OK to use
+   C++17 features.
+
+#. The :ref:`cmake@cppad_link_flags` do not contain ``-m32`` .
+
+
 Source
 ******
 {xrst_literal
@@ -105,6 +121,8 @@ bool dll_lib(void)
    std::map< std::string, std::string > options;
 # ifdef _MSC_VER
    options["compile"] = "cl /EHs /EHc /c /TC /O2";
+# elif CPPAD_LINK_FLAGS_HAS_M32
+   options["compile"] = "gcc -c -fPIC -O2 -m32";
 # else
    options["compile"] = "gcc -c -fPIC -O2";
 # endif

example/utility/utility.cpp

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 // SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-// SPDX-FileContributor: 2003-22 Bradley M. Bell
+// SPDX-FileContributor: 2003-25 Bradley M. Bell
 // ----------------------------------------------------------------------------
 /*
 {xrst_begin utility.cpp}
@@ -108,7 +108,7 @@ int main(void)
 // END_SORT_THIS_LINE_MINUS_1
 //
 # if CPPAD_C_COMPILER_GNU_FLAGS || CPPAD_C_COMPILER_MSVC_FLAGS
-# if CPPAD_USE_CPLUSPLUS_2017
+# if CPPAD_USE_CPLUSPLUS_2017 && ! CPPAD_LINK_FLAGS_HAS_M32
    Run( dll_lib,                "dll_lib" );
 # endif
 # endif

include/cppad/configure.hpp.in

@@ -2,7 +2,7 @@
 # define CPPAD_CONFIGURE_HPP
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-or-later
 // SPDX-FileCopyrightText: Bradley M. Bell <[email protected]>
-// SPDX-FileContributor: 2003-24 Bradley M. Bell
+// SPDX-FileContributor: 2003-25 Bradley M. Bell
 // ----------------------------------------------------------------------------
 
 /*!
@@ -27,6 +27,13 @@
 Preprocessor Symbols Set By CMake Command
 #########################################
 
+CPPAD_LINK_FLAGS_HAS_M32
+************************
+is -m32 in the :ref:`cmake@cppad_link_flags` .
+{xrst_code hpp} */
+# define CPPAD_LINK_FLAGS_HAS_M32 @cppad_link_flags_has_m32@
+/* {xrst_code}
+
 CPPAD_COMPILER_HAS_CONVERSION_WARN
 **********************************
 is the compiler a variant of g++ and has conversion warnings