.. _topic-platform: Platforms ========= .. index:: pair: platform; code Platform codes -------------- The MPS uses a six-character platform code to express a combination of operating system, CPU architecture, and compiler toolchain. Each six-character code breaks down into three pairs of characters: ``OSARCT``. The first pair of characters names the operating system: ====== ================ ==================== ``OS`` Operating system Constant ====== ================ ==================== ``fr`` FreeBSD :c:macro:`MPS_OS_FR` ``li`` Linux :c:macro:`MPS_OS_LI` ``w3`` Windows :c:macro:`MPS_OS_W3` ``xc`` macOS :c:macro:`MPS_OS_XC` ====== ================ ==================== The second pair of characters names the processor architecture: ====== ====================== ====================== ``AR`` Processor architecture Constant ====== ====================== ====================== ``a6`` ARM64 :c:macro:`MPS_ARCH_A6` ``i3`` Intel/AMD IA-32 :c:macro:`MPS_ARCH_I3` ``i6`` Intel/AMD x86-64 :c:macro:`MPS_ARCH_I6` ====== ====================== ====================== The third pair of characters names the compiler toolchain: ====== ======================= ======================= ``CT`` Compiler toolchain Constant ====== ======================= ======================= ``gc`` GNU Compiler collection :c:macro:`MPS_BUILD_GC` ``ll`` Clang/LLVM :c:macro:`MPS_BUILD_LL` ``mv`` Microsoft Visual C/C++ :c:macro:`MPS_BUILD_MV` ====== ======================= ======================= In each case the aspect of the platform can be tested by checking whether the preprocessor constant in the third column in the table is defined, and the full platform can be tested by checking whether the corresponding ``MPS_PF_`` preprocessor constant is defined. For example, "``xci6ll``" platform corresponds to the :c:macro:`MPS_PF_XCI6LL` preprocessor constant. Not all combinations of operating system, processor architecture, and compiler are supported. .. index:: single: platform; interface .. _topic-platform-interface: Platform interface ------------------ :: #include "mpstd.h" .. c:macro:: MPS_ARCH_A6 A :term:`C` preprocessor macro that indicates, if defined, that the target processor architecture of the compilation is a member of the ARM64 family of 64-bit processors. .. c:macro:: MPS_ARCH_I3 A :term:`C` preprocessor macro that indicates, if defined, that the target processor architecture of the compilation is a member of the IA-32 Intel/AMD family of 32-bit processors. .. c:macro:: MPS_ARCH_I6 A :term:`C` preprocessor macro that indicates, if defined, that the target processor architecture of the compilation is a member of the x86-64 Intel/AMD family of 64-bit processors. .. note:: The MPS is not supported on IA-64 (Itanium). .. c:macro:: MPS_BUILD_GC A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled by the C compiler from the GNU Compiler Collection (GCC). .. c:macro:: MPS_BUILD_LL A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled by Clang, the C compiler from the LLVM (Low Level Virtual Machine) system. .. c:macro:: MPS_BUILD_MV A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled by the C compiler from Microsoft Visual Studio. .. c:macro:: MPS_OS_FR A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled on a FreeBSD operating system. .. c:macro:: MPS_OS_LI A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled on a Linux operating system. .. c:macro:: MPS_OS_W3 A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled on a Windows operating system. .. c:macro:: MPS_OS_XC A :term:`C` preprocessor macro that indicates, if defined, that the MPS was compiled on an macOS operating system. .. c:macro:: MPS_PF_ALIGN A :term:`C` preprocessor macro that expands to an integer giving the :term:`natural alignment` of the :term:`platform`. .. c:macro:: MPS_PF_FRI3GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the FreeBSD operating system, the IA-32 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_FRI3LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the FreeBSD operating system, the IA-32 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_PF_FRI6GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the FreeBSD operating system, the x86-64 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_FRI6LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the FreeBSD operating system, the x86-64 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_PF_LIA6GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Linux operating system, the ARM64 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_LIA6LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Linux operating system, the ARM64 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_PF_LII3GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Linux operating system, the IA-32 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_LII6GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Linux operating system, the x86-64 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_LII6LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Linux operating system, the x86-64 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_PF_STRING A :term:`C` preprocessor macro that names the :term:`platform` for which the MPS was built. .. c:macro:: MPS_PF_W3I3MV A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Windows operating system, the IA-32 processor architecture, and the Microsoft Visual C/C++ compiler. .. c:macro:: MPS_PF_W3I6MV A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the Windows operating system, the x86-64 processor architecture, and the Microsoft Visual C/C++ compiler. .. c:macro:: MPS_PF_XCA6LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the macOS operating system, the ARM64 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_PF_XCI3GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the macOS operating system, the IA-32 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_XCI3LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the macOS operating system, the IA-32 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_PF_XCI6GC A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the macOS operating system, the x86-64 processor architecture, and the GCC compiler. .. c:macro:: MPS_PF_XCI6LL A :term:`C` preprocessor macro that indicates, if defined, that the :term:`platform` consists of the macOS operating system, the x86-64 processor architecture, and the Clang/LLVM compiler. .. c:macro:: MPS_T_ULONGEST A :term:`C` preprocessor macro that expands to the name of the largest unsigned integral type. The exact identity of this type is :term:`platform`\-dependent. Typical identities are ``unsigned long`` and ``unsigned __int_64``. .. c:macro:: MPS_T_WORD A :term:`C` preprocessor macro that expands to the name of an unsigned integral type that is the same size as an :term:`object pointer`, so that ``sizeof(MPS_T_WORD) == sizeof(void*)``. The exact identity of this type is :term:`platform`\-dependent. Typical identities are ``unsigned long`` and ``unsigned __int_64``. .. c:macro:: MPS_WORD_SHIFT A :term:`C` preprocessor macro that expands to the logarithm to base 2 of the constant :c:macro:`MPS_WORD_WIDTH`, so that ``1 << MPS_WORD_SHIFT == MPS_WORD_WIDTH``. The value is platform-dependent. Typical values are 5 and 6. .. c:macro:: MPS_WORD_WIDTH A :term:`C` preprocessor macro that expands to the width in bits of the type :c:type:`MPS_T_WORD`, so that ``MPS_WORD_WIDTH == sizeof(MPS_T_WORD) * CHAR_BIT``. This value is platform-dependent. It is always a power of 2: typical values are 32 and 64. .. index:: single: platform; historical codes Historical platform codes ------------------------- The platform codes in the tables below were in use in older versions of the Memory Pool System, but are not currently supported. Formerly supported operating systems: ====== =========================== ============= ``OS`` Operating system Constant ====== =========================== ============= ``i5`` Irix 5 or 6 (old ABI) ``MPS_OS_I5`` ``ia`` Irix 6 (new ABI) ``MPS_OS_IA`` ``o1`` OSF/1 aka Tru64 ``MPS_OS_O1`` ``s7`` Macintosh System 7, 8, or 9 ``MPS_OS_S7`` ``so`` Solaris ``MPS_OS_SO`` ``su`` SunOS ``MPS_OS_SU`` ====== =========================== ============= Formerly supported processor architectures: ====== ====================== =============== ``AR`` Processor architecture Constant ====== ====================== =============== ``i4`` Intel/AMD IA-32 [1]_ ``MPS_ARCH_I4`` ``al`` Digital Alpha ``MPS_ARCH_AL`` ``m2`` MIPS R2000 ``MPS_ARCH_M2`` ``m4`` MIPS R4000 ``MPS_ARCH_M4`` ``m6`` Motorola 68000 ``MPS_ARCH_M6`` ``pp`` PowerPC ``MPS_ARCH_PP`` ``s8`` SPARC V8 ``MPS_ARCH_S8`` ``s9`` SPARC V9 (32-bit) ``MPS_ARCH_S9`` ====== ====================== =============== Formerly supported compiler toolchains: ====== ======================================= ================ ``CT`` Compiler toolchain Constant ====== ======================================= ================ ``ac`` Macintosh Programmer's Workshop C/C++ ``MPS_BUILD_AC`` ``cc`` The "native" C compiler [2]_ ``MPS_BUILD_CC`` ``cx`` SunPro C CXREF tool ``MPS_BUILD_CX`` ``eg`` Experimental GNU Compiler System (EGCS) ``MPS_BUILD_EG`` ``gp`` GCC with profiling ``MPS_BUILD_GP`` ``lc`` LCC ``MPS_BUILD_LC`` ``m9`` Microsoft Visual C/C++ 9.0 [3]_ ``MPS_BUILD_M9`` ``mw`` Metrowerks CodeWarrior ``MPS_BUILD_MW`` ``pc`` Pelles C ``MPS_BUILD_PC`` ``sc`` SunPro C ``MPS_BUILD_SC`` ====== ======================================= ================ .. note:: .. [1] Obsolete: the MPS used to make a distinction between the 80386 and 80486 processor architectures. .. [2] This was the MIPSpro C compiler on IRIX; and the Digital C Compiler on OSF/1. .. [3] Obsolete: the MPS used to make a distinction between version 9.0 of Microsoft Visual C/C++ and older versions. .. index:: single: platform; historical list Historical platform list ------------------------ This is the full list of platforms that have ever been supported by the Memory Pool System, with their current status. ========== ======================= Platform Status ========== ======================= ``fri3gc`` Supported ``fri3ll`` Supported ``fri4gc`` Corrected to ``fri3gc`` ``fri6gc`` Supported ``fri6ll`` Supported ``i5m2cc`` *Not supported* ``iam4cc`` *Not supported* ``lia6gc`` Supported ``lia6ll`` Supported ``lii3eg`` *Not supported* ``lii3gc`` Supported ``lii4gc`` Corrected to ``lii3gc`` ``lii6gc`` Supported ``lii6ll`` Supported ``lippgc`` *Not supported* ``o1alcc`` *Not supported* ``o1algc`` *Not supported* ``s7m6mw`` *Not supported* ``s7ppac`` *Not supported* ``s7ppmw`` *Not supported* ``sos8cx`` *Not supported* ``sos8gc`` *Not supported* ``sos8gp`` *Not supported* ``sos9sc`` *Not supported* ``sus8gc`` *Not supported* ``w3almv`` *Not supported* ``w3i3m9`` Corrected to ``w3i3mv`` ``w3i3mv`` Supported ``w3i3pc`` *Not supported* ``w3i6mv`` Supported ``w3i6pc`` *Not supported* ``w3ppmv`` *Not supported* ``xca6ll`` Supported ``xci3gc`` *Not supported* ``xci3ll`` *Not supported* ``xci6gc`` *Not supported* ``xci6ll`` Supported ``xcppgc`` *Not supported* ========== ======================= .. index:: pair: platform; limitations single: Hardened Runtime .. _topic-platform-limitations: Platform limitations -------------------- This section documents limitations that affect individual platforms. ``xca6ll`` On macOS on Apple Silicon, programs may enable `Hardened Runtime`_. This feature rejects attempts to map or protect memory so that it is simultaneously writable and executable. Therefore, when Hardened Runtime is enabled, memory managed by the MPS is not executable. .. _Hardened Runtime: https://developer.apple.com/documentation/security/hardened_runtime If your program needs to write executable code into memory managed by the MPS (for example, it uses just-in-time translation or dynamic compilation), then you must either disable Hardened Runtime, or configure the `Allow Unsigned Executable Memory Entitlement`_. .. _Allow Unsigned Executable Memory Entitlement: https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_cs_allow-unsigned-executable-memory Note that the MPS has no support for Apple's :c:macro:`MAP_JIT` flag. If your application is using the `Allow Execution of JIT-compiled Code Entitlement`_ and needs support for this flag, please :ref:`contact us `. .. _Allow Execution of JIT-compiled Code Entitlement: https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_security_cs_allow-jit