curl/docs
Viktor Szakats d169ad68fa
gssapi: add support for Apple GSS Framework
Add support for the native GSS Framework on Apple targets, which is
Apple's fork of Heimdal. This option allows to drop Apple's deprecated
MIT Kerberos compatibility shim "mit-krb5/1.7-prerelease".

Source code uses different headers, other than that no source changes
are necessary.

You can enable by configuring with:
autotools: `--enable-gssapi-apple`
CMake: `-DCURL_USE_GSSAPI=ON -DCURL_GSS_FLAVOR=Apple`

These options are experimental, and may receive breaking updates till
the GSS backend selection logic settles, for Apple and also for the GNU
and MIT implementation.

Version string:
```
curl 8.21.0-DEV (aarch64-apple-darwin25.4.0) libcurl/8.21.0-DEV
  OpenSSL/3.6.2 zlib/1.2.12 AppleIDN AppleGSS OpenLDAP/2.4.28/Apple
```

Also:
- drop in-source deprecation warning suppressions when using AppleGSS.
- GHA/macos: enable Apple GSS in CI jobs.

Supported by:
iOS 5.0+, iPadOS 5.0+, Mac Catalyst 13.0+, macOS 10.14+, visionOS 1.0+

Ref: https://developer.apple.com/documentation/gss
Ref: #19109

Closes #22052
2026-07-04 01:21:57 +02:00
..
cmdline-opts tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
examples build: always use local inet_pton()/inet_ntop() implementations 2026-06-27 01:24:39 +02:00
internals CREDENTIALS.md: remove comment about emtpy user/pass 2026-06-29 11:17:00 +02:00
libcurl cd2nroff: stricter checks for asterisks for italics 2026-07-04 00:32:58 +02:00
tests tidy-up: miscellaneous 2026-06-09 11:07:55 +02:00
.gitignore
ALTSVC.md
BINDINGS.md tidy-up: miscellaneous 2026-06-05 16:57:38 +02:00
BUG-BOUNTY.md BUG-BOUNTY.md: minor rephrase to say there is no bug bounty 2026-03-10 17:34:08 +01:00
BUGS.md docs: avoid using the word 'magic' 2026-03-03 15:32:13 +01:00
CIPHERS-TLS12.md
CIPHERS.md tidy-up: miscellaneous 2026-05-27 16:53:57 +02:00
CMakeLists.txt build: stop building and installing runtests.1 and testcurl.1 2026-04-28 09:07:27 +02:00
CODE_OF_CONDUCT.md
CODE_REVIEW.md tidy-up: miscellaneous 2026-06-09 11:07:55 +02:00
CONTRIBUTE.md tidy-up: miscellaneous 2026-05-27 16:53:57 +02:00
curl-config.md
CURL-DISABLE.md lib: make SMB support opt-in 2026-03-22 11:55:39 +01:00
CURLDOWN.md tidy-up: sort TLS backends, distros, alphabetically 2026-05-11 11:57:25 +02:00
DEPRECATE.md DEPRECATE.md: fix copy-and-paste mistaken subtitles 2026-03-26 11:06:25 +01:00
DISTROS.md
EARLY-RELEASE.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
ECH.md tidy-up: sort TLS backends, distros, alphabetically 2026-05-11 11:57:25 +02:00
EXPERIMENTAL.md build: say Quiche support is experimental, where missing 2026-06-01 22:33:57 +02:00
FAQ.md tidy-up: make 'CA' uppercase, where missing 2026-06-22 21:04:45 +02:00
FEATURES.md
GOVERNANCE.md docs: avoid starting sentences with However, 2026-03-07 23:49:11 +01:00
HELP-US.md
HISTORY.md tidy-up: miscellaneous 2026-05-20 00:50:43 +02:00
HSTS.md hsts: accept 10K entries in the list 2026-04-02 10:22:35 +02:00
HTTP-COOKIES.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
HTTP3.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
HTTPSRR.md docs: tidy-up scheme references 2026-05-19 16:55:45 +02:00
INFRASTRUCTURE.md INFRASTRUCTURE.md: fix typo 2026-07-01 09:04:30 -07:00
INSTALL
INSTALL-CMAKE.md gssapi: add support for Apple GSS Framework 2026-07-04 01:21:57 +02:00
INSTALL.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
INTERNALS.md INTERNALS.md: document minimum nghttp3 and ngtcp2 versions 2026-06-17 14:37:54 +02:00
IPFS.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
KNOWN_BUGS.md KNOWN_BUGS.md: drop outdated CMake issues 2026-06-19 18:25:54 +02:00
KNOWN_RISKS.md progress: count amount of data "delivered" to application 2026-03-21 23:21:55 +01:00
MAIL-ETIQUETTE.md badwords: avoid 'simply' 2026-03-10 19:34:06 +01:00
Makefile.am creds: hold credentials 2026-05-12 16:05:15 +02:00
MANUAL.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
mk-ca-bundle.md stop using the word 'just' 2026-03-03 15:30:22 +01:00
options-in-versions HTTP/3: add proxy CONNECT and MASQUE CONNECT-UDP support (ngtcp2 QUIC) 2026-05-27 08:49:53 +02:00
README.md
RELEASE-PROCEDURE.md tidy-up: docs, comments, typos, whitespace 2026-06-26 11:36:09 +02:00
ROADMAP.md
runtests.md runtests: drop orphaned, no-op -k option 2026-06-19 14:46:49 +02:00
RUSTLS.md tidy-up: miscellaneous 2026-05-27 16:53:57 +02:00
SECURITY-ADVISORY.md SECURITY-ADVISORY.md: expand 2026-06-11 10:09:06 +02:00
SPONSORS.md
SSL-PROBLEMS.md
SSLCERTS.md SSLCERTS: document 8.19.0 default Native CA builds (Windows) 2026-05-16 11:55:59 +02:00
testcurl.md
THANKS THANKS: remove duplicate, fix typo 2026-07-03 17:49:03 +02:00
THANKS-filter tidy-up: miscellaneous 2026-05-16 01:56:17 +02:00
TheArtOfHttpScripting.md tidy-up: make 'CA' uppercase, where missing 2026-06-22 21:04:45 +02:00
TODO.md TODO: drop all SMB ideas 2026-07-01 22:42:29 +02:00
URL-SYNTAX.md URL-SYNTAX: document more URL parsing details 2026-06-02 11:13:50 +02:00
VERIFY.md docs/VERIFY: expand with more things we do 2026-06-18 12:55:22 +02:00
VERSIONS.md VERSIONS: 8.21.0 release 2026-06-24 07:52:50 +02:00
VULN-DISCLOSURE-POLICY.md VULN-DISCLOSURE-POLICY.md: issues that should be found by tests are LOW 2026-06-26 22:46:31 +02:00
wcurl.md spacecheck: check long lines and repeat spaces, fix fallouts 2026-03-25 11:02:08 +01:00

curl logo

Documentation

You find a mix of various documentation in this directory and subdirectories, using several different formats. Some of them are not ideal for reading directly in your browser.

If you would rather see the rendered version of the documentation, check out the curl website's documentation section for general curl stuff or the libcurl section for libcurl related documentation.