curl-config(1)

1curl-config(1)                curl-config manual                curl-config(1)
2
3
4

NAME

6       curl-config - Get information about a libcurl installation
7

SYNOPSIS

9       curl-config [options]
10

DESCRIPTION

12       curl-config  displays  information about the curl and libcurl installa‐
13       tion.
14

OPTIONS

16       --ca   Displays the built-in path to the CA cert  bundle  this  libcurl
17              uses.
18
19       --cc   Displays the compiler used to build libcurl.
20
21       --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
26       --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
32       --configure
33              Displays the arguments given to configure when building curl.
34
35       --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
42       --help Displays the available options.
43
44       --libs Shows the complete set of libs and other linker options you will
45              need in order to link your application with libcurl.
46
47       --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
53       --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
61       --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              (Added in 7.17.1)
65
66       --version
67              Outputs version information about the installed libcurl.
68
69       --vernum
70              Outputs  version  information  about  the  installed libcurl, in
71              numerical mode.  This outputs the version number,  in  hexadeci‐
72              mal,  with  8  bits  for each part; major, minor, patch. So that
73              libcurl 7.7.4 would appear as 070704 and libcurl 12.13.14  would
74              appear as 0c0d0e... Note that the initial zero might be omitted.
75              (This option was broken in the 7.15.0 release.)
76

EXAMPLES

78       What linker options do I need when I link with libcurl?
79
80         $ curl-config --libs
81
82       What compiler options do I need when I compile using libcurl functions?
83
84         $ curl-config --cflags
85
86       How do I know if libcurl was built with SSL support?
87
88         $ curl-config --feature | grep SSL
89
90       What's the installed libcurl version?
91
92         $ curl-config --version
93
94       How do I build a single file with a one-line command?
95
96         $ `curl-config --cc --cflags --libs` -o example example.c
97
98

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLES

SEE ALSO