diff --git a/builds/cmake/CMakePresets.json b/builds/cmake/CMakePresets.json index 597abe5d..371bad98 100644 --- a/builds/cmake/CMakePresets.json +++ b/builds/cmake/CMakePresets.json @@ -2,19 +2,11 @@ "version": 5, "configurePresets": [ { - "name": "nix-base", - "description": "Factored base settings for non-windows *nix based platforms.", + "name": "base-pathing", + "description": "Factored base settings for all platforms.", "hidden": true, "installDir": "${sourceParentDir}/../../../prefix/${presetName}", "binaryDir": "${sourceParentDir}/../obj/${presetName}", - "condition": { - "type": "inList", - "string": "${hostSystemName}", - "list": [ - "Darwin", - "Linux" - ] - }, "cacheVariables": { "CMAKE_PREFIX_PATH": { "type": "PATH", @@ -31,27 +23,65 @@ } }, { - "name": "gnu-debug", + "name": "nix-base", + "description": "Factored base settings for non-windows *nix based platforms.", + "hidden": true, + "condition": { + "type": "inList", + "string": "${hostSystemName}", + "list": [ + "Darwin", + "Linux" + ] + } + }, + { + "name": "win-base", + "description": "Factored base settings for windows platforms (msvc developer environment).", + "hidden": true, + "generator": "Ninja", + "condition": { + "type": "equals", + "lhs": "${hostSystemName}", + "rhs": "Windows" + } + }, + { + "name": "config-debug", "description": "Factored debug settings.", "hidden": true, "cacheVariables": { - "CMAKE_BUILD_TYPE": "Debug", + "CMAKE_BUILD_TYPE": "Debug" + } + }, + { + "name": "config-release", + "description": "Factored release settings.", + "hidden": true, + "cacheVariables": { + "CMAKE_BUILD_TYPE": "Release" + } + }, + { + "name": "gnu-debug", + "description": "Factored gnu specific debug settings.", + "hidden": true, + "cacheVariables": { "CMAKE_C_FLAGS": "$env{CMAKE_C_FLAGS} -Og -g1 --coverage -fprofile-update=atomic", "CMAKE_CXX_FLAGS": "$env{CMAKE_CXX_FLAGS} -Og -g1 --coverage -fprofile-update=atomic" } }, { "name": "gnu-release", - "description": "Factored release settings.", + "description": "Factored gnu specific release settings.", "hidden": true, "cacheVariables": { - "CMAKE_BUILD_TYPE": "Release", "CMAKE_C_FLAGS": "$env{CMAKE_C_FLAGS} -O3", "CMAKE_CXX_FLAGS": "$env{CMAKE_CXX_FLAGS} -O3" } }, { - "name": "static", + "name": "link-static", "description": "Factored static linking settings.", "hidden": true, "cacheVariables": { @@ -62,7 +92,7 @@ } }, { - "name": "shared", + "name": "link-shared", "description": "Factored shared/dynamic linking settings.", "hidden": true, "cacheVariables": { @@ -72,13 +102,40 @@ } } }, + { + "name": "compiler-msvc", + "description": "Factored msvc compiler settings.", + "hidden": true, + "cacheVariables": { + "CMAKE_C_COMPILER": "cl", + "CMAKE_CXX_COMPILER": "cl" + } + }, + { + "name": "compiler-clangcl", + "description": "Factored clang-cl compiler settings.", + "hidden": true, + "cacheVariables": { + "CMAKE_C_COMPILER": "clang-cl", + "CMAKE_CXX_COMPILER": "clang-cl" + } + }, + { + "name": "optimization-host-native", + "description": "Factored settings for march/mtune using for local execution.", + "hidden": true, + "cacheVariables": { + "CMAKE_C_FLAGS": "$env{CMAKE_C_FLAGS} -march=native -mtune=native", + "CMAKE_CXX_FLAGS": "$env{CMAKE_CXX_FLAGS} -march=native -mtune=native" + } + }, { "name": "nix-gnu-debug-static", "displayName": "*nix/GNU/Debug/Static", "description": "Debug build with static linking.", "hidden": false, "inherits": [ - "static", + "link-static", "gnu-debug", "nix-base" ] @@ -89,7 +146,7 @@ "description": "Debug build with shared linking.", "hidden": false, "inherits": [ - "shared", + "link-shared", "gnu-debug", "nix-base" ] @@ -100,7 +157,7 @@ "description": "Release build with static linking and standard optimizations.", "hidden": false, "inherits": [ - "static", + "link-static", "gnu-release", "nix-base" ] @@ -111,67 +168,58 @@ "description": "Release build with shared linking and standard optimizations.", "hidden": false, "inherits": [ - "shared", + "link-shared", "gnu-release", "nix-base" ] }, { - "name": "win-base", - "description": "Factored base settings for windows platforms (msvc developer environment).", - "hidden": true, - "generator": "Ninja", - "installDir": "${sourceParentDir}/../../../prefix/${presetName}", - "binaryDir": "${sourceParentDir}/../obj/${presetName}", - "condition": { - "type": "equals", - "lhs": "${hostSystemName}", - "rhs": "Windows" - }, - "cacheVariables": { - "CMAKE_PREFIX_PATH": { - "type": "PATH", - "value": "${sourceParentDir}/../../../prefix/${presetName}" - }, - "CMAKE_INSTALL_PREFIX_PATH": { - "type": "PATH", - "value": "${sourceParentDir}/../../../prefix/${presetName}" - } - } - }, - { - "name": "msvc", - "description": "Factored msvc compiler settings.", - "hidden": true, - "cacheVariables": { - "CMAKE_C_COMPILER": "cl", - "CMAKE_CXX_COMPILER": "cl" - } + "name": "nix-gnu-debug-static-native", + "displayName": "*nix/GNU/Debug/Static", + "description": "Debug build with static linking for native architecture.", + "hidden": false, + "inherits": [ + "optimization-host-native", + "link-static", + "gnu-debug", + "nix-base" + ] }, { - "name": "clangcl", - "description": "Factored clang-cl compiler settings.", - "hidden": true, - "cacheVariables": { - "CMAKE_C_COMPILER": "clang-cl", - "CMAKE_CXX_COMPILER": "clang-cl" - } + "name": "nix-gnu-debug-shared-native", + "displayName": "*nix/GNU/Debug/Shared", + "description": "Debug build with shared linking for native architecture.", + "hidden": false, + "inherits": [ + "optimization-host-native", + "link-shared", + "gnu-debug", + "nix-base" + ] }, { - "name": "win-debug", - "description": "Factored windows debug settings.", - "hidden": true, - "cacheVariables": { - "CMAKE_BUILD_TYPE": "Debug" - } + "name": "nix-gnu-release-static-native", + "displayName": "*nix/GNU/Release/Static", + "description": "Release build with static linking and standard optimizations for native architecture.", + "hidden": false, + "inherits": [ + "optimization-host-native", + "link-static", + "gnu-release", + "nix-base" + ] }, { - "name": "win-release", - "description": "Factored windows release settings.", - "hidden": true, - "cacheVariables": { - "CMAKE_BUILD_TYPE": "Release" - } + "name": "nix-gnu-release-shared-native", + "displayName": "*nix/GNU/Release/Shared", + "description": "Release build with shared linking and standard optimizations for native architecture.", + "hidden": false, + "inherits": [ + "optimization-host-native", + "link-shared", + "gnu-release", + "nix-base" + ] }, { "name": "win-msvc-debug-static", @@ -179,9 +227,9 @@ "description": "Debug build with msvc and static linking.", "hidden": false, "inherits": [ - "static", - "win-debug", - "msvc", + "link-static", + "config-debug", + "compiler-msvc", "win-base" ] }, @@ -191,9 +239,9 @@ "description": "Release build with msvc and static linking.", "hidden": false, "inherits": [ - "static", - "win-release", - "msvc", + "link-static", + "config-release", + "compiler-msvc", "win-base" ] }, @@ -203,9 +251,9 @@ "description": "Debug build with msvc and shared linking.", "hidden": false, "inherits": [ - "shared", - "win-debug", - "msvc", + "link-shared", + "config-debug", + "compiler-msvc", "win-base" ] }, @@ -215,9 +263,9 @@ "description": "Release build with msvc and shared linking.", "hidden": false, "inherits": [ - "shared", - "win-release", - "msvc", + "link-shared", + "config-release", + "compiler-msvc", "win-base" ] }, @@ -227,9 +275,9 @@ "description": "Debug build with clang-cl and static linking.", "hidden": false, "inherits": [ - "static", - "win-debug", - "clangcl", + "link-static", + "config-debug", + "compiler-clangcl", "win-base" ] }, @@ -239,9 +287,9 @@ "description": "Release build with clang-cl and static linking.", "hidden": false, "inherits": [ - "static", - "win-release", - "clangcl", + "link-static", + "config-release", + "compiler-clangcl", "win-base" ] }, @@ -251,9 +299,9 @@ "description": "Debug build with clang-cl and shared linking.", "hidden": false, "inherits": [ - "shared", - "win-debug", - "clangcl", + "link-shared", + "config-debug", + "compiler-clangcl", "win-base" ] }, @@ -263,9 +311,9 @@ "description": "Release build with clang-cl and shared linking.", "hidden": false, "inherits": [ - "shared", - "win-release", - "clangcl", + "link-shared", + "config-release", + "compiler-clangcl", "win-base" ] } @@ -303,6 +351,30 @@ "inherits": [ "nix-target-list" ], "configurePreset": "nix-gnu-release-shared" }, + { + "name": "nix-gnu-debug-static-native", + "displayName": "*nix/GNU/Debug/Static", + "inherits": [ "nix-target-list" ], + "configurePreset": "nix-gnu-debug-static-native" + }, + { + "name": "nix-gnu-debug-shared-native", + "displayName": "*nix/GNU/Debug/Shared", + "inherits": [ "nix-target-list" ], + "configurePreset": "nix-gnu-debug-shared-native" + }, + { + "name": "nix-gnu-release-static-native", + "displayName": "*nix/GNU/Release/Static", + "inherits": [ "nix-target-list" ], + "configurePreset": "nix-gnu-release-static-native" + }, + { + "name": "nix-gnu-release-shared-native", + "displayName": "*nix/GNU/Release/Shared", + "inherits": [ "nix-target-list" ], + "configurePreset": "nix-gnu-release-shared-native" + }, { "name": "win-msvc-debug-static", "displayName": "Windows/MSVC/Debug/Static", diff --git a/builds/cmake/install-presets.sh b/builds/cmake/install-presets.sh index db01a8b9..0ac113b2 100755 --- a/builds/cmake/install-presets.sh +++ b/builds/cmake/install-presets.sh @@ -24,27 +24,10 @@ # --build-parallel= Number of jobs to run simultaneously. # Default: supported platforms use nproc/sysctl # --build-use-local-src Use existing sources in relevant paths. -# --hardware-optimized Inform compiler to apply applicable optimizations for the host hardware. # --noninteractive Disable any prompt using default. # --verbose Display verbose script output. # --help, -h Display usage, overriding script execution. # -# Hardware configuration options for arm64: -# --hardware-aes Use ARM AES and PMULL Extensions. -# --hardware-sha2 Use ARM SHA1/SHA256 Extensions (implies AES). -# --hardware-sha3 Use ARM SHA3 Extensions for SHA512 (implies SHA1/SHA256 and AES). -# -# Hardware configuration options for x64: -# --hardware-avx2 Use Intel AVX2 intrinsics (implies AES-NI). -# --hardware-avx512 Use Intel AVX512 intrinsics (implies AVX2 and AES-NI). -# --hardware-avx512ifma Use Intel AVX512 IFMA intrinsics (implies AVX512, SHA Extensions and AES-NI). -# --hardware-avxifma Use Intel AVX IFMA intrinsics (implies AVX2, SHA Extensions and AES-NI). -# --hardware-shani Use Intel SHA Extensions (implies AES-NI). -# --hardware-sha512 Use Intel SHA512 Extensions (implies AVX2). -# --hardware-sse41 Use SSE4.1 hardware instructions. -# --hardware-aesni Use Intel AES-NI and PCLMULQDQ intrinsics. -# --hardware-vaes Use Intel VAES and VPCLMULQDQ intrinsics (implies AES-NI and AVX2). -# # Recognized pass-through options: # -Denable-shani= Add Intel SHA Extensions (implies AES-NI) via compilation options. # Default: OFF @@ -128,18 +111,6 @@ main() for OPTION in "$@"; do case ${OPTION} in (--build-libsecp256k1) BUILD_libsecp256k1="yes";; - (--hardware-aes) HARDWARE_AES="yes";; - (--hardware-sha2) HARDWARE_SHA2="yes";; - (--hardware-sha3) HARDWARE_SHA3="yes";; - (--hardware-avx2) HARDWARE_AVX2="yes";; - (--hardware-avx512) HARDWARE_AVX512="yes";; - (--hardware-avx512ifma) HARDWARE_AVX512IFMA="yes";; - (--hardware-avxifma) HARDWARE_AVXIFMA="yes";; - (--hardware-shani) HARDWARE_SHANI="yes";; - (--hardware-sha512) HARDWARE_SHA512="yes";; - (--hardware-sse41) HARDWARE_SSE41="yes";; - (--hardware-aesni) HARDWARE_AESNI="yes";; - (--hardware-vaes) HARDWARE_VAES="yes";; (--build-preset=*) BUILD_PRESET="${OPTION#*=}";; (--build-src-dir=*) BUILD_SRC_DIR="${OPTION#*=}";; (--build-limit=*) BUILD_LIMIT="${OPTION#*=}";; @@ -149,7 +120,6 @@ main() (--build-skip-test-run) BUILD_SKIP_TEST_RUN="yes";; (--build-parallel=*) PARALLEL="${OPTION#*=}";; (--build-use-local-src) BUILD_USE_LOCAL_SRC="yes";; - (--hardware-optimized) HARDWARE_OPTIMIZED="yes";; (--noninteractive) NONINTERACTIVE="yes";; (--verbose) DISPLAY_VERBOSE="yes";; (--help|-h) DISPLAY_HELP="yes";; @@ -172,23 +142,10 @@ main() remove_configure_option "--build-skip-test-run" remove_configure_option "--build-parallel=*" remove_configure_option "--build-use-local-src" - remove_configure_option "--hardware-optimized" remove_configure_option "--noninteractive" remove_configure_option "--verbose" remove_configure_option "--help" remove_configure_option "-h" - remove_configure_option "--hardware-aes" - remove_configure_option "--hardware-sha2" - remove_configure_option "--hardware-sha3" - remove_configure_option "--hardware-avx2" - remove_configure_option "--hardware-avx512" - remove_configure_option "--hardware-avx512ifma" - remove_configure_option "--hardware-avxifma" - remove_configure_option "--hardware-shani" - remove_configure_option "--hardware-sha512" - remove_configure_option "--hardware-sse41" - remove_configure_option "--hardware-aesni" - remove_configure_option "--hardware-vaes" CONFIGURE_OPTIONS_CMAKE=("${CONFIGURE_OPTIONS[@]}") msg_verbose "*** ARGUMENTS: ${CONFIGURE_OPTIONS_ORIGINAL[*]}" msg_verbose "*** SANITIZED: ${CONFIGURE_OPTIONS[*]}" @@ -231,6 +188,22 @@ main() msg_verbose "BUILD_PRESET value 'nix-gnu-release-shared'." BUILD_CONFIG="release" BUILD_LINK="dynamic" + elif [[ "${BUILD_PRESET}" == "nix-gnu-debug-static-native" ]]; then + msg_verbose "BUILD_PRESET value 'nix-gnu-debug-static-native'." + BUILD_CONFIG="debug" + BUILD_LINK="static" + elif [[ "${BUILD_PRESET}" == "nix-gnu-debug-shared-native" ]]; then + msg_verbose "BUILD_PRESET value 'nix-gnu-debug-shared-native'." + BUILD_CONFIG="debug" + BUILD_LINK="dynamic" + elif [[ "${BUILD_PRESET}" == "nix-gnu-release-static-native" ]]; then + msg_verbose "BUILD_PRESET value 'nix-gnu-release-static-native'." + BUILD_CONFIG="release" + BUILD_LINK="static" + elif [[ "${BUILD_PRESET}" == "nix-gnu-release-shared-native" ]]; then + msg_verbose "BUILD_PRESET value 'nix-gnu-release-shared-native'." + BUILD_CONFIG="release" + BUILD_LINK="dynamic" elif [[ "${BUILD_PRESET}" == "win-msvc-debug-static" ]]; then msg_verbose "BUILD_PRESET value 'win-msvc-debug-static'." BUILD_CONFIG="debug" @@ -471,138 +444,6 @@ main() msg_verbose "MACOSX_DEPLOYMENT_TARGET using defined value '${MACOSX_DEPLOYMENT_TARGET}'" fi - # HARDWARE_OPTIMIZED - if [[ "${HARDWARE_OPTIMIZED}" == "yes" ]]; then - ARCHTUNE="-march=native -mtune=native" - fi - - if [[ "${HARDWARE_SHA2}" == "yes" ]]; then - HARDWARE_AES="yes" - fi - - if [[ "${HARDWARE_SHA3}" == "yes" ]]; then - HARDWARE_SHA2="yes" - HARDWARE_AES="yes" - fi - - if [[ "${HARDWARE_AVX2}" == "yes" ]]; then - HARDWARE_AESNI="yes" - fi - - if [[ "${HARDWARE_AVX512}" == "yes" ]]; then - HARDWARE_AVX2="yes" - HARDWARE_AESNI="yes" - fi - - if [[ "${HARDWARE_AVX512IFMA}" == "yes" ]]; then - HARDWARE_AVX512="yes" - HARDWARE_AVX2="yes" - HARDWARE_SHANI="yes" - HARDWARE_AESNI="yes" - fi - - if [[ "${HARDWARE_AVXIFMA}" == "yes" ]]; then - HARDWARE_AVX2="yes" - HARDWARE_SHANI="yes" - HARDWARE_AESNI="yes" - fi - - if [[ "${HARDWARE_SHANI}" == "yes" ]]; then - HARDWARE_AESNI="yes" - fi - - # Platform options: arm64 - - if [[ "${HARDWARE_AES}" == "yes" ]]; then - HARDWARE_PLATFORM_ARM64="yes" - ARCHBASE="armv8-a" - ARCHSUFFIX="${ARCHSUFFIX}+aes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-aes=ON" ) - fi - - if [[ "${HARDWARE_SHA2}" == "yes" ]]; then - HARDWARE_PLATFORM_ARM64="yes" - ARCHBASE="armv8-a" - ARCHSUFFIX="${ARCHSUFFIX}+sha2" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-sha2=ON" ) - fi - - if [[ "${HARDWARE_SHA3}" == "yes" ]]; then - HARDWARE_PLATFORM_ARM64="yes" - ARCHBASE="armv8.2-a" - ARCHSUFFIX="${ARCHSUFFIX}+sha3" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-sha3=ON" ) - fi - - if [[ ${HARDWARE_PLATFORM_ARM64} == "yes" ]]; then - ARCHTUNE="-march=${ARCHBASE}${ARCHSUFFIX}" - fi - - # Platform options: x64 - - if [[ "${HARDWARE_AVX2}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-avx2=ON" ) - fi - - if [[ "${HARDWARE_AVX512}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-avx512=ON" ) - fi - - if [[ "${HARDWARE_AVX512IFMA}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-avx512ifma=ON" ) - fi - - if [[ "${HARDWARE_AVXIFMA}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-avxifma=ON" ) - fi - - if [[ "${HARDWARE_SHANI}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-shani=ON" ) - fi - - if [[ "${HARDWARE_SHA512}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-sha512=ON" ) - fi - - if [[ "${HARDWARE_SSE41}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-sse41=ON" ) - fi - - if [[ "${HARDWARE_AESNI}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-aesni=ON" ) - fi - - if [[ "${HARDWARE_VAES}" == "yes" ]]; then - HARDWARE_PLATFORM_X64="yes" - CONFIGURE_OPTIONS_CMAKE=( "${CONFIGURE_OPTIONS_CMAKE[@]}" "-Denable-vaes=ON" ) - fi - - HARDWARE_PLATFORM_COUNT=0 - if [[ ${HARDWARE_PLATFORM_ARM64} == "yes" ]]; then - HARDWARE_PLATFORM_COUNT=$((HARDWARE_PLATFORM_COUNT + 1)) - fi - if [[ ${HARDWARE_PLATFORM_X64} == "yes" ]]; then - HARDWARE_PLATFORM_COUNT=$((HARDWARE_PLATFORM_COUNT + 1)) - fi - - if [ ${HARDWARE_PLATFORM_COUNT} -gt 1 ]; then - msg_error "Hardware options spanning more than one platform have been specified." - exit 1 - fi - - if [[ "${HARDWARE_OPTIMIZED}" == "yes" ]] && - [ ${HARDWARE_PLATFORM_COUNT} -gt 0 ]; then - msg_error "Hardware optimization cannot be reliably rationalized with hardware platform options." - exit 1 - fi # Specify cmake build @@ -1153,27 +994,10 @@ help() msg "--build-parallel= Number of jobs to run simultaneously." msg " Default: supported platforms use nproc/sysctl" msg "--build-use-local-src Use existing sources in relevant paths." - msg "--hardware-optimized Inform compiler to apply applicable optimizations for the host hardware." msg "--noninteractive Disable any prompt using default." msg "--verbose Display verbose script output." msg "--help, -h Display usage, overriding script execution." msg "" - msg "Hardware configuration options for arm64:" - msg "--hardware-aes Use ARM AES and PMULL Extensions." - msg "--hardware-sha2 Use ARM SHA1/SHA256 Extensions (implies AES)." - msg "--hardware-sha3 Use ARM SHA3 Extensions for SHA512 (implies SHA1/SHA256 and AES)." - msg "" - msg "Hardware configuration options for x64:" - msg "--hardware-avx2 Use Intel AVX2 intrinsics (implies AES-NI)." - msg "--hardware-avx512 Use Intel AVX512 intrinsics (implies AVX2 and AES-NI)." - msg "--hardware-avx512ifma Use Intel AVX512 IFMA intrinsics (implies AVX512, SHA Extensions and AES-NI)." - msg "--hardware-avxifma Use Intel AVX IFMA intrinsics (implies AVX2, SHA Extensions and AES-NI)." - msg "--hardware-shani Use Intel SHA Extensions (implies AES-NI)." - msg "--hardware-sha512 Use Intel SHA512 Extensions (implies AVX2)." - msg "--hardware-sse41 Use SSE4.1 hardware instructions." - msg "--hardware-aesni Use Intel AES-NI and PCLMULQDQ intrinsics." - msg "--hardware-vaes Use Intel VAES and VPCLMULQDQ intrinsics (implies AES-NI and AVX2)." - msg "" msg "Recognized pass-through options:" msg "-Denable-shani= Add Intel SHA Extensions (implies AES-NI) via compilation options." msg " Default: OFF"