curl-config(1)          curl-config manual         curl-config(1)



NAME
       curl-config - Get information about a libcurl installation

SYNOPSIS
       curl-config [options]

DESCRIPTION
       curl-config displays information about a previous curl and
       libcurl installation.

OPTIONS
       --ca   Displays  the  built-in  path to the CA cert bundle
              this libcurl uses.

       --cc   Displays the compiler used to build libcurl.

       --cflags
              Set of compiler options (CFLAGS) to use  when  com-
              piling  files  that  use libcurl. Currently that is
              only thw include path to the curl include files.

       --checkfor [version]
              Specify the oldest possible libcurl version  string
              you want, and this script will return 0 if the cur-
              rent 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)

       --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.

       --help Displays the available options.

       --libs Shows  the  complete  set  of libs and other linker
              options you will need in order to link your  appli-
              cation with libcurl.

       --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".

       --protocols
              Lists   what  particular  protocols  the  installed
              libcurl was built to support. At the time of  writ-
              ing,  this list may include HTTP, HTTPS, FTP, FTPS,
              FILE, TELNET, LDAP, DICT. Do not assume any partic-
              ular  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)

       --version
              Outputs version  information  about  the  installed
              libcurl.

       --vernum
              Outputs  version  information  about  the installed
              libcurl, in numerical mode.  This outputs the  ver-
              sion  number,  in hexadecimal, with 8 bits for each
              part; major, minor, 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.)

EXAMPLES
       What linker options do I need when I link with libcurl?

         $ curl-config --libs

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

         $ curl-config --cflags

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

         $ curl-config --feature | grep SSL

       What's the installed libcurl version?

         $ curl-config --version

       How do I build a single file with a one-line command?

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


SEE ALSO
       curl(1)



Curl 7.15.4                25 Jan 2004             curl-config(1)