curl-config(1)

Hey bestie! Welcome to the curl-config(1) manual page from the curl-config manual—it's all about curl-config, the little script that gives you the 411 on your libcurl installation. 🌸

---

💖 NAME 💖

curl-config — get the 411 on a libcurl installation. Periodt. 💅

---

✨ SYNOPSIS ✨

curl-config [options]

That's the whole vibe. Just run it with some options and it'll give you what you need. ✨

---

🌸 DESCRIPTION 🌸

Okay so basically, curl-config displays all the info about your curl and libcurl installation. It's literally your bestie for figuring out what's what with your libcurl setup. 🦋

---

💅 OPTIONS 💅

• --ca — Displays the built-in path to the CA cert bundle that this libcurl uses. Like, where it keeps its trusty certs. 🔐
• --cc — Shows you the compiler that was used to build libcurl. Ngl, kinda iconic to know. 💻
• --cflags — Gives you the set of compiler options (CFLAGS) to use when compiling files that use libcurl. Currently that's only the include path to the curl include files. So like, just the include path, no cap. 🎀
• --checkfor [version] — You specify the oldest possible libcurl version string you want, and this script will return 0 if the current installation is new enough. Or it returns 1 and outputs a text saying that the current version is not new enough. (Added in 7.15.4) ⏳
• --configure — Displays the arguments that were given to configure when building curl. Like, the receipts of how it was built. 🧾
• --feature — Lists what particular main features the installed libcurl was built with. At the time of writing, this list may include SSL, KRB4 or IPv6. Do not assume any particular order. The keywords will be separated by newlines. There may be none, one, or several keywords in the list. So like, check the vibes, but don't expect a specific order. 🔍
• --help — Displays the available options. The classic "help me help you" move. 🆘
• --libs — Shows the complete set of libs and other linker options you will need in order to link your application with libcurl. It's giving linker realness. 🔗
• --prefix — This is the prefix used when libcurl was installed. Libcurl is then installed in $prefix/lib and its header files are installed in $prefix/include and so on. The prefix is set with "configure --prefix". So like, where everything lives. 🏠
• --protocols — Lists what particular protocols the installed libcurl was built to support. At the time of writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE, TELNET, LDAP, DICT. Do not assume any particular order. The protocols will be listed using uppercase and are separated by newlines. There may be none, one, or several protocols in the list. (Added in 7.13.0) 🌐
• --ssl-backends — Lists the SSL backends that were enabled when libcurl was built. It might be no, one or several names. If more than one name, they will appear comma-separated. (Added in 7.58.0) 🔒
• --static-libs — Shows the complete set of libs and other linker options you will need in order to link your application with libcurl statically. (Added in 7.17.1) 🗂️
• --version — Outputs version information about the installed libcurl. The classic "what version are we on" tea. ☕
• --vernum — Outputs version information about the installed libcurl, in numerical mode. This outputs the version number, in hexadecimal, with 8 bits for each part: major, minor, and patch. So that libcurl 7.7.4 would appear as 070704 and libcurl 12.13.14 would appear as 0c0d0e... Note that the initial zero might be omitted. (This option was broken in the 7.15.0 release.) 🔢

⚠️ Heads up: this option was broken in the 7.15.0 release. Just so you know. 💀

---

🦋 EXAMPLES 🦋

1. What linker options do I need when I link with libcurl? 💭

$ curl-config --libs

2. What compiler options do I need when I compile using libcurl functions? 🤔

$ curl-config --cflags

3. How do I know if libcurl was built with SSL support? 🔍

$ curl-config --feature | grep SSL

4. What's the installed libcurl version? 📦

$ curl-config --version

5. How do I build a single file with a one-line command? 🛠️

$ `curl-config --cc --cflags` -o example example.c `curl-config --libs`

---

🌈 SEE ALSO 🌈

Also check out curl(1)—the main character of the curl universe. 👑

---

This page is from the curl-config manual, Curl 7.17.1, dated 25 Oct 2007. Hope that helps, bestie! 💖✨