Lines Matching +full:- +full:- +full:enable +full:- +full:ldap
1 <!--
4 SPDX-License-Identifier: curl
5 -->
29 - Build in the source tree.
31 $ cmake -B .
33 - Build in a separate directory (parallel to the curl source tree in this
36 $ cmake -B ../curl-build
40 CMake before version 3.13 does not support the `-B` option. In that case,
44 $ mkdir ../curl-build
45 $ cd ../curl-build
54 You can override CMake's default by using `-G <generator-name>`. For example
55 on Windows with multiple build systems if you have MinGW-w64 then you could use
56 `-G "MinGW Makefiles"`.
57 [List of generator names](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html).
69 ## Using `cmake-gui`
71 CMake also comes with a Qt based GUI called `cmake-gui`. To configure with
72 `cmake-gui`, you run `cmake-gui` and follow these steps:
78 as the source tree, but a parallel directory called curl-build or
91 $ cmake --build ../curl-build
97 is handled automatically by the library loader - on all modern systems.
114 CMake before version 3.13 does not support the `--build` option. In that
119 $ cd ../curl-build
130 $ cmake --install ../curl-build
134 CMake before version 3.15 does not support the `--install` option. In that
139 $ cd ../curl-build
144 - `BUILD_CURL_EXE`: Build curl executable. Default: `ON`
145 - `BUILD_EXAMPLES`: Build libcurl examples. Default: `ON`
146 - `BUILD_LIBCURL_DOCS`: Build libcurl man pages. Default: `ON`
147 - `BUILD_MISC_DOCS`: Build misc man pages (e.g. `curl-config` and `mk-ca-bun…
148 - `BUILD_SHARED_LIBS`: Build shared libraries. Default: `ON`
149 - `BUILD_STATIC_CURL`: Build curl executable with static libcurl. Default: `OF…
150 - `BUILD_STATIC_LIBS`: Build static libraries. Default: `OFF`
151 - `BUILD_TESTING`: Build tests. Default: `ON`
152 - `CURL_CLANG_TIDY`: Run the build through `clang-tidy`. Default: `OFF`
153 - `CURL_CLANG_TIDYFLAGS`: Custom options to pass to `clang-tidy`. Default: (empty)
154 - `CURL_DEFAULT_SSL_BACKEND`: Override default TLS backend in MultiSSL builds.
156 … `wolfssl`, `gnutls`, `mbedtls`, `openssl`, `secure-transport`, `schannel`, `bearssl`, `rustls`
157 - `CURL_ENABLE_EXPORT_TARGET`: Enable CMake export target. Default: `ON`
158 - `CURL_HIDDEN_SYMBOLS`: Hide libcurl internal symbols (=hide all symbols that a…
159 - `CURL_LIBCURL_SOVERSION`: Enable libcurl SOVERSION. Default: `ON` for supported p…
160 - `CURL_LIBCURL_VERSIONED_SYMBOLS`: Enable libcurl versioned symbols. Default: `OFF`
161 - `CURL_LIBCURL_VERSIONED_SYMBOLS_PREFIX`: Override default versioned symbol prefix. Default: `<TL…
162 - `CURL_LTO`: Enable compiler Link Time Optimizations. Default: `OFF`
163 - `CURL_STATIC_CRT`: Build libcurl with static CRT with MSVC (`/MT`). Defaul…
164 - `CURL_TARGET_WINDOWS_VERSION`: Minimum target Windows version as hex string.
165 - `CURL_TEST_BUNDLES`: Bundle `libtest` and `unittest` tests into single binar…
166 - `CURL_WERROR`: Turn compiler warnings into errors. Default: `OFF`
167 - `ENABLE_CURLDEBUG`: Enable TrackMemory debug feature. Default: =`ENABLE_DEB…
168 - `ENABLE_CURL_MANUAL`: Build the man page for curl and enable its `-M`/`--manu…
169 - `ENABLE_DEBUG`: Enable curl debug features (for developing curl itself)…
170 - `IMPORT_LIB_SUFFIX`: Import library suffix. Default: `_imp`
171 - `LIBCURL_OUTPUT_NAME`: Basename of the curl library. Default: `libcurl`
172 - `PICKY_COMPILER`: Enable picky compiler options. Default: `ON`
173 - `STATIC_LIB_SUFFIX`: Static library suffix. Default: (empty)
177 - `CURL_CA_BUNDLE`: Path to the CA bundle. Set `none` to disable or `auto` …
178 - `CURL_CA_EMBED`: Path to the CA bundle to embed in the curl tool. Defaul…
179 - `CURL_CA_FALLBACK`: Use built-in CA store of TLS backend. Default: `OFF`
180 - `CURL_CA_PATH`: Location of default CA path. Set `none` to disable or `…
181 - `CURL_CA_SEARCH_SAFE`: Enable safe CA bundle search (within the curl tool dire…
185 - `CURL_ENABLE_SSL`: Enable SSL support. Default: `ON`
186 - `CURL_WINDOWS_SSPI`: Enable SSPI on Windows. Default: =`CURL_USE_SCHANNEL`
187 - `ENABLE_IPV6`: Enable IPv6 support. Default: `ON` if target supports I…
188 - `ENABLE_THREADED_RESOLVER`: Enable threaded DNS lookup. Default: `ON` if c-ares is …
189 - `ENABLE_UNICODE`: Use the Unicode version of the Windows API functions. D…
190 - `ENABLE_UNIX_SOCKETS`: Enable Unix domain sockets support. Default: `ON`
191 - `USE_ECH`: Enable ECH support. Default: `OFF`
192 - `USE_HTTPSRR`: Enable HTTPS RR support. Default: `OFF`
193 - `USE_OPENSSL_QUIC`: Use OpenSSL and nghttp3 libraries for HTTP/3 support. D…
194 - `USE_SSLS_EXPORT`: Enable experimental SSL session import/export. Default:…
198 - `CURL_DISABLE_ALTSVC`: Disable alt-svc support. Default: `OFF`
199 - `CURL_DISABLE_AWS`: Disable **aws-sigv4**. Default: `OFF`
200 - `CURL_DISABLE_BASIC_AUTH`: Disable Basic authentication. Default: `OFF`
201 - `CURL_DISABLE_BEARER_AUTH`: Disable Bearer authentication. Default: `OFF`
202 - `CURL_DISABLE_BINDLOCAL`: Disable local binding support. Default: `OFF`
203 - `CURL_DISABLE_CA_SEARCH`: Disable unsafe CA bundle search in PATH on Windows. Def…
204 - `CURL_DISABLE_COOKIES`: Disable cookies support. Default: `OFF`
205 - `CURL_DISABLE_DICT`: Disable DICT. Default: `OFF`
206 - `CURL_DISABLE_DIGEST_AUTH`: Disable Digest authentication. Default: `OFF`
207 - `CURL_DISABLE_DOH`: Disable DNS-over-HTTPS. Default: `OFF`
208 - `CURL_DISABLE_FILE`: Disable FILE. Default: `OFF`
209 - `CURL_DISABLE_FORM_API`: Disable **form-api**. Default: =`CURL_DISABLE_MIME`
210 - `CURL_DISABLE_FTP`: Disable FTP. Default: `OFF`
211 - `CURL_DISABLE_GETOPTIONS`: Disable `curl_easy_options` API for existing options to…
212 - `CURL_DISABLE_GOPHER`: Disable Gopher. Default: `OFF`
213 - `CURL_DISABLE_HEADERS_API`: Disable **headers-api** support. Default: `OFF`
214 - `CURL_DISABLE_HSTS`: Disable HSTS support. Default: `OFF`
215 - `CURL_DISABLE_HTTP`: Disable HTTP. Default: `OFF`
216 - `CURL_DISABLE_HTTP_AUTH`: Disable all HTTP authentication methods. Default: `OFF`
217 - `CURL_DISABLE_IMAP`: Disable IMAP. Default: `OFF`
218 - `CURL_DISABLE_INSTALL`: Disable installation targets. Default: `OFF`
219 - `CURL_DISABLE_IPFS`: Disable IPFS. Default: `OFF`
220 - `CURL_DISABLE_KERBEROS_AUTH`: Disable Kerberos authentication. Default: `OFF`
221 - `CURL_DISABLE_LDAP`: Disable LDAP. Default: `OFF`
222 - `CURL_DISABLE_LDAPS`: Disable LDAPS. Default: =`CURL_DISABLE_LDAP`
223 - `CURL_DISABLE_LIBCURL_OPTION`: Disable `--libcurl` option from the curl tool. Default:…
224 - `CURL_DISABLE_MIME`: Disable MIME support. Default: `OFF`
225 - `CURL_DISABLE_MQTT`: Disable MQTT. Default: `OFF`
226 - `CURL_DISABLE_NEGOTIATE_AUTH`: Disable negotiate authentication. Default: `OFF`
227 - `CURL_DISABLE_NETRC`: Disable netrc parser. Default: `OFF`
228 - `CURL_DISABLE_NTLM`: Disable NTLM support. Default: `OFF`
229 - `CURL_DISABLE_OPENSSL_AUTO_LOAD_CONFIG`: Disable automatic loading of OpenSSL configuration. Def…
230 - `CURL_DISABLE_PARSEDATE`: Disable date parsing. Default: `OFF`
231 - `CURL_DISABLE_POP3`: Disable POP3. Default: `OFF`
232 - `CURL_DISABLE_PROGRESS_METER`: Disable built-in progress meter. Default: `OFF`
233 - `CURL_DISABLE_PROXY`: Disable proxy support. Default: `OFF`
234 - `CURL_DISABLE_RTSP`: Disable RTSP. Default: `OFF`
235 - `CURL_DISABLE_SHA512_256`: Disable SHA-512/256 hash algorithm. Default: `OFF`
236 - `CURL_DISABLE_SHUFFLE_DNS`: Disable shuffle DNS feature. Default: `OFF`
237 - `CURL_DISABLE_SMB`: Disable SMB. Default: `OFF`
238 - `CURL_DISABLE_SMTP`: Disable SMTP. Default: `OFF`
239 - `CURL_DISABLE_SOCKETPAIR`: Disable use of socketpair for curl_multi_poll. Default:…
240 - `CURL_DISABLE_SRP`: Disable TLS-SRP support. Default: `OFF`
241 - `CURL_DISABLE_TELNET`: Disable Telnet. Default: `OFF`
242 - `CURL_DISABLE_TFTP`: Disable TFTP. Default: `OFF`
243 - `CURL_DISABLE_VERBOSE_STRINGS`: Disable verbose strings. Default: `OFF`
244 - `CURL_DISABLE_WEBSOCKETS`: Disable WebSocket. Default: `OFF`
245 - `HTTP_ONLY`: Disable all protocols except HTTP (This overrides all `…
249 - `CI`: Assume running under CI if set.
250 - `CURL_BUILDINFO`: Print `buildinfo.txt` if set.
251 - `CURL_CI`: Assume running under CI if set.
255 - `CMAKE_BUILD_TYPE`: (see CMake)
256 - `CMAKE_DEBUG_POSTFIX`: Default: `-d`
257 - `CMAKE_IMPORT_LIBRARY_SUFFIX` (see CMake)
258 - `CMAKE_INSTALL_BINDIR` (see CMake)
259 - `CMAKE_INSTALL_INCLUDEDIR` (see CMake)
260 - `CMAKE_INSTALL_LIBDIR` (see CMake)
261 - `CMAKE_INSTALL_PREFIX` (see CMake)
262 - `CMAKE_STATIC_LIBRARY_SUFFIX` (see CMake)
263 - `CMAKE_UNITY_BUILD_BATCH_SIZE`: Set the number of sources in a "unity" unit. Default: `…
264 - `CMAKE_UNITY_BUILD`: Enable "unity" (aka jumbo) builds. Default: `OFF`
267 [variables](https://cmake.org/cmake/help/latest/manual/cmake-variables.7.html) and
272 - `CURL_BROTLI`: Use brotli (`ON`, `OFF` or `AUTO`). Default: `AUTO`
273 - `CURL_USE_BEARSSL`: Enable BearSSL for SSL/TLS. Default: `OFF`
274 - `CURL_USE_GNUTLS`: Enable GnuTLS for SSL/TLS. Default: `OFF`
275 - `CURL_USE_GSASL`: Use libgsasl. Default: `OFF`
276 - `CURL_USE_GSSAPI`: Use GSSAPI implementation. Default: `OFF`
277 - `CURL_USE_LIBPSL`: Use libpsl. Default: `ON`
278 - `CURL_USE_LIBSSH2`: Use libssh2. Default: `ON`
279 - `CURL_USE_LIBSSH`: Use libssh. Default: `OFF`
280 - `CURL_USE_LIBUV`: Use libuv for event-based tests. Default: `OFF`
281 - `CURL_USE_MBEDTLS`: Enable mbedTLS for SSL/TLS. Default: `OFF`
282 - `CURL_USE_OPENSSL`: Enable OpenSSL for SSL/TLS. Default: `ON` if no other T…
283 - `CURL_USE_PKGCONFIG`: Enable `pkg-config` to detect dependencies. Default: `O…
284 - `CURL_USE_RUSTLS`: Enable Rustls for SSL/TLS. Default: `OFF`
285 - `CURL_USE_SCHANNEL`: Enable Windows native SSL/TLS (Schannel). Default: `OFF`
286 - `CURL_USE_SECTRANSP`: Enable Apple OS native SSL/TLS (Secure Transport). Defa…
287 - `CURL_USE_WOLFSSH`: Use wolfSSH. Default: `OFF`
288 - `CURL_USE_WOLFSSL`: Enable wolfSSL for SSL/TLS. Default: `OFF`
289 - `CURL_ZLIB`: Use zlib (`ON`, `OFF` or `AUTO`). Default: `AUTO`
290 - `CURL_ZSTD`: Use zstd (`ON`, `OFF` or `AUTO`). Default: `AUTO`
291 - `ENABLE_ARES`: Enable c-ares support. Default: `OFF`
292 - `USE_APPLE_IDN`: Use Apple built-in IDN support. Default: `OFF`
293 - `USE_LIBIDN2`: Use libidn2 for IDN support. Default: `ON`
294 - `USE_LIBRTMP`: Enable librtmp from rtmpdump. Default: `OFF`
295 - `USE_MSH3`: Use msh3/msquic library for HTTP/3 support. Default: `O…
296 - `USE_NGHTTP2`: Use nghttp2 library. Default: `ON`
297 - `USE_NGTCP2`: Use ngtcp2 and nghttp3 libraries for HTTP/3 support. De…
298 - `USE_QUICHE`: Use quiche library for HTTP/3 support. Default: `OFF`
299 - `USE_WIN32_IDN`: Use WinIDN for IDN support. Default: `OFF`
300 - `USE_WIN32_LDAP`: Use Windows LDAP implementation. Default: `ON`
304 - `OPENSSL_ROOT_DIR`: Set this variable to the root installation of OpenSSL (…
305 - `OPENSSL_USE_STATIC_LIBS`: Look for static OpenSSL libraries.
306 - `ZLIB_INCLUDE_DIR`: The zlib include directory.
307 - `ZLIB_LIBRARY`: Path to `zlib` library.
311 - `CLANG_TIDY`: `clang-tidy` tool used with `CURL_CLANG_TIDY=ON`. Defau…
312 - `PERL_EXECUTABLE` Perl binary used throughout the build and tests.
313 - `AMISSL_INCLUDE_DIR`: The AmiSSL include directory.
314 - `AMISSL_STUBS_LIBRARY`: Path to `amisslstubs` library.
315 - `AMISSL_AUTO_LIBRARY`: Path to `amisslauto` library.
316 - `BEARSSL_INCLUDE_DIR`: The BearSSL include directory.
317 - `BEARSSL_LIBRARY`: Path to `bearssl` library.
318 - `BROTLI_INCLUDE_DIR`: The brotli include directory.
319 - `BROTLICOMMON_LIBRARY`: Path to `brotlicommon` library.
320 - `BROTLIDEC_LIBRARY`: Path to `brotlidec` library.
321 - `CARES_INCLUDE_DIR`: The c-ares include directory.
322 - `CARES_LIBRARY`: Path to `cares` library.
323 - `DL_LIBRARY`: Path to `dl` library. (for Rustls)
324 - `GSS_ROOT_DIR`: Set this variable to the root installation of GSS. (als…
325 - `LDAP_LIBRARY`: Name or full path to `ldap` library. Default: `ldap`
326 - `LDAP_LBER_LIBRARY`: Name or full path to `lber` library. Default: `lber`
327 - `LDAP_INCLUDE_DIR`: Path to LDAP include directory.
328 - `LIBGSASL_INCLUDE_DIR`: The libgsasl include directory.
329 - `LIBGSASL_LIBRARY`: Path to `libgsasl` library.
330 - `LIBIDN2_INCLUDE_DIR`: The libidn2 include directory.
331 - `LIBIDN2_LIBRARY`: Path to `libidn2` library.
332 - `LIBPSL_INCLUDE_DIR`: The libpsl include directory.
333 - `LIBPSL_LIBRARY`: Path to `libpsl` library.
334 - `LIBRTMP_INCLUDE_DIR`: The librtmp include directory.
335 - `LIBRTMP_LIBRARY`: Path to `librtmp` library.
336 - `LIBSSH_INCLUDE_DIR`: The libssh include directory.
337 - `LIBSSH_LIBRARY`: Path to `libssh` library.
338 - `LIBSSH2_INCLUDE_DIR`: The libssh2 include directory.
339 - `LIBSSH2_LIBRARY`: Path to `libssh2` library.
340 - `LIBUV_INCLUDE_DIR`: The libuv include directory.
341 - `LIBUV_LIBRARY`: Path to `libuv` library.
342 - `MATH_LIBRARY`: Path to `m` library. (for Rustls, wolfSSL)
343 - `MBEDTLS_INCLUDE_DIR`: The mbedTLS include directory.
344 - `MBEDTLS_LIBRARY`: Path to `mbedtls` library.
345 - `MBEDX509_LIBRARY`: Path to `mbedx509` library.
346 - `MBEDCRYPTO_LIBRARY`: Path to `mbedcrypto` library.
347 - `MSH3_INCLUDE_DIR`: The msh3 include directory.
348 - `MSH3_LIBRARY`: Path to `msh3` library.
349 - `NGHTTP2_INCLUDE_DIR`: The nghttp2 include directory.
350 - `NGHTTP2_LIBRARY`: Path to `nghttp2` library.
351 - `NGHTTP3_INCLUDE_DIR`: The nghttp3 include directory.
352 - `NGHTTP3_LIBRARY`: Path to `nghttp3` library.
353 - `NGTCP2_INCLUDE_DIR`: The ngtcp2 include directory.
354 - `NGTCP2_LIBRARY`: Path to `ngtcp2` library.
355 - `NETTLE_INCLUDE_DIR`: The nettle include directory.
356 - `NETTLE_LIBRARY`: Path to `nettle` library.
357 - `PTHREAD_LIBRARY`: Path to `pthread` library. (for Rustls)
358 - `QUICHE_INCLUDE_DIR`: The quiche include directory.
359 - `QUICHE_LIBRARY`: Path to `quiche` library.
360 - `RUSTLS_INCLUDE_DIR`: The Rustls include directory.
361 - `RUSTLS_LIBRARY`: Path to `rustls` library.
362 - `WATT_ROOT`: Set this variable to the root installation of Watt-32.
363 - `WOLFSSH_INCLUDE_DIR`: The wolfSSH include directory.
364 - `WOLFSSH_LIBRARY`: Path to `wolfssh` library.
365 - `WOLFSSL_INCLUDE_DIR`: The wolfSSL include directory.
366 - `WOLFSSL_LIBRARY`: Path to `wolfssl` library.
367 - `ZSTD_INCLUDE_DIR`: The zstd include directory.
368 - `ZSTD_LIBRARY`: Path to `zstd` library.
372 - `APXS`: Default: `apxs`
373 - `CADDY`: Default: `caddy`
374 - `HTTPD_NGHTTPX`: Default: `nghttpx`
375 - `HTTPD`: Default: `apache2`
376 - `TEST_NGHTTPX`: Default: `nghttpx`
377 - `VSFTPD`: Default: `vsftps`
389 You can also use `-G "NMake Makefiles"`, which is supported by all CMake
393 :-------------------------------- | :--------------------------------
394 `VC10` | `-G "Visual Studio 10 2010"`
395 `VC11` | `-G "Visual Studio 11 2012"`
396 `VC12` | `-G "Visual Studio 12 2013"`
397 `x64` | `-A x64`
398 `Win32` | `-A Win32`
412 …> msbuild "-property:Configuration=DLL Debug - DLL Windows SSPI - DLL WinIDN" Windows/VC12/curl-al…
416 …> cmake . -G "Visual Studio 12 2013" -A x64 -DCMAKE_BUILD_TYPE=Debug -DCURL_USE_SCHANNEL=ON -DUSE_…
435 :-------------------------------- | :--------------------------------
439 …C` | see CMake `-G` [options](https://cmake.org/cmake/help/latest/man…
440 `MACHINE`: `x64`, `x86` | `-A x64`, `-A Win32`
463 For example this command-line:
465 …> nmake -f Makefile.vc VC=17 MACHINE=x64 DEBUG=ON mode=dll SSL_PATH=C:\OpenSSL WITH_SSL=dll ENABLE…
469 …-G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=Debug -DBUILD_SHARED_LIBS=ON -DOPENSSL_ROOT_D…