1curl-config(1) curl-config manual curl-config(1)
2
6 curl-config - Get information about a libcurl installation
7
9 curl-config [options]
10
12 curl-config displays information about the curl and libcurl installa‐
13 tion.
14
16 --ca Displays the built-in path to the CA cert bundle this libcurl
17 uses.
18 --cc Displays the compiler used to build libcurl.
20 --cflags
22 Set of compiler options (CFLAGS) to use when compiling files
23 that use libcurl. Currently that is only the include path to the
24 curl include files.
25 --checkfor [version]
27 Specify the oldest possible libcurl version string you want, and
28 this script will return 0 if the current installation is new
29 enough or it returns 1 and outputs a text saying that the cur‐
30 rent version is not new enough. (Added in 7.15.4)
31 --configure
33 Displays the arguments given to configure when building curl.
34 --feature
36 Lists what particular main features the installed libcurl was
37 built with. At the time of writing, this list may include SSL,
38 KRB4 or IPv6. Do not assume any particular order. The keywords
39 will be separated by newlines. There may be none, one, or sev‐
40 eral keywords in the list.
41 --help Displays the available options.
43 --libs Shows the complete set of libs and other linker options you will
45 need in order to link your application with libcurl.
46 --prefix
48 This is the prefix used when libcurl was installed. Libcurl is
49 then installed in $prefix/lib and its header files are installed
50 in $prefix/include and so on. The prefix is set with "configure
51 --prefix".
52 --protocols
54 Lists what particular protocols the installed libcurl was built
55 to support. At the time of writing, this list may include HTTP,
56 HTTPS, FTP, FTPS, FILE, TELNET, LDAP, DICT. Do not assume any
57 particular order. The protocols will be listed using uppercase
58 and are separated by newlines. There may be none, one, or sev‐
59 eral protocols in the list. (Added in 7.13.0)
60 --static-libs
62 Shows the complete set of libs and other linker options you will
63 need in order to link your application with libcurl statically.
64 Note that Fedora/RHEL libcurl packages do not provide any static
65 libraries, thus cannot be linked statically. (Added in 7.17.1)
66 --version
68 Outputs version information about the installed libcurl.
69 --vernum
71 Outputs version information about the installed libcurl, in
72 numerical mode. This outputs the version number, in hexadeci‐
73 mal, with 8 bits for each part; major, minor, patch. So that
74 libcurl 7.7.4 would appear as 070704 and libcurl 12.13.14 would
75 appear as 0c0d0e... Note that the initial zero might be omitted.
76 (This option was broken in the 7.15.0 release.)
77
79 What linker options do I need when I link with libcurl?
80 $ curl-config --libs
82 What compiler options do I need when I compile using libcurl functions?
84 $ curl-config --cflags
86 How do I know if libcurl was built with SSL support?
88 $ curl-config --feature | grep SSL
90 What's the installed libcurl version?
92 $ curl-config --version
94 How do I build a single file with a one-line command?
96 $ `curl-config --cc --cflags` -o example example.c `curl-config
98 --libs`
99
101 curl(1)
102Curl 7.17.1 25 Oct 2007 curl-config(1)