From e72a5365983dce89d8dea9beac2ea8099062ffd5 Mon Sep 17 00:00:00 2001 From: Fs Date: Sat, 6 Jan 2024 09:50:17 +0800 Subject: [PATCH] Parameter mapping documentation --- Mapping.md | 50 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 50 insertions(+) create mode 100644 Mapping.md diff --git a/Mapping.md b/Mapping.md new file mode 100644 index 0000000..f74a71e --- /dev/null +++ b/Mapping.md @@ -0,0 +1,50 @@ +# Parameter mapping + +## Parameter map for this CMake project and original Perl-based `Configure` + +| Perl `Configure` item | CMake parameter | Notes | +|-|-|-| +| `no-` | `-DOPENSSL_=0` | Use capitalized CIPHER name in CMake.
`OPENSSL_NO_` is set automatically. | +| `enable-`
`threads` / `sctp` / `386` | `-DOPENSSL_=1`| | +| `--prefix=` | `-DCMAKE_INSTALL_PREFIX=` | | +| `--openssldir=` | `-DOPENSSL_OPENSSLDIR=` | Relative to `CMAKE_INSTALL_PREFIX` | +| `--api=` | `-DOPENSSL_MIN_API_LEVEL=` | | +| `no-shared static` | `-DBUILD_SHARED_LIBS=OFF` | A series of shared library is built by default.
Building shared and static library in one go is not supported by now. | +| (os/platform) | (automatically detected) | See following OS / Platform mapping | +| `--cross-compile-prefix=` | `-DCMAKE_TOOLCHAIN_FILE=`
(A totally different design) | Typical CMake cross build method are used | + +## OS / Platform mapping + +| Host | Auto-detected platform name (as if passed to `Configure`) | Notes | +|-|-|-| +| Windows x86_64 MSVC with NASM or without ASM | `VC-WIN64A` | | +| Windows x86_64 MSVC with ASM without NASM | `VC-WIN64A-MASM` | | +| Windows x86 MSVC | `VC-WIN32` | | +| Windows x86_64 MinGW | `mingw64` | | +| Windows x86 MinGW | `mingw` | | +| Cygwin x86_64 | `Cygwin-x86_64` | | +| Cygwin x86 | `Cygwin-x86` | Deprecated? | +| macOS x86_64 | `darwin64-x86_64-cc` | | +| macOS arm64 | `darwin64-arm64-cc` | | +| iOS x86_64 | `iossimulator-xcrun` | Distinguishing simulator / actual machine is not done | +| iOS arm32 | `ios-xcrun` | | +| iOS arm64 | `ios64-xcrun` | | +| iOS (unknown architecture) | `iphoneos-cross` | Legacy | +| Android x86_64 | `android-x86_64` | | +| Android arm32 | `android-armeabi` | | +| Android x86 | `android-x86` | | +| Android arm64 | `android64-aarch64` | | +| Android (unknown architecture) | `android` | Legacy | +| Linux x86_64 Clang | `linux-x86_64-clang` | | +| Linux x86_64 (other compiler) | `linux-x86_64` | | +| Linux x86 Clang | `linux-x86-clang` | | +| Linux x86 (other compiler) | `linux-x86` | | +| Linux arm32 | `linux-armv4` | | +| Linux arm64 | `linux-aarch64` | | +| Linux (unknown architecture, sizeof pointer equals 8) | `linux-generic64` | | +| Linux (unknown architecture, sizeof pointer equals 4) | `linux-generic32` | | +| Any BSD x86_64 | `BSD-x86_64` | | +| Any BSD x86 | `BSD-x86-elf` | | +| Any BSD (unknown architecture, sizeof pointer equals 8) | `BSD-generic64` | | +| Any BSD (unknown architecture, sizeof pointer equals 4) | `BSD-generic32` | | +| Others | (unknown) | Will be added when supported |