oracular (1) curl-config.1.gz

NAME

       curl-config - Get information about a libcurl installation

SYNOPSIS

       curl-config [options]

DESCRIPTION

       curl-config displays information about the 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 compiling files that use libcurl. Currently that is
              only the include path to the curl include files.

       --checkfor [version]
              Specify the oldest possible libcurl version string you want, and this  script  returns  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 given to configure when building curl.

       --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 are
              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 need in order to link your application
              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
              writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE, TELNET, LDAP, DICT and many more.  Do
              not  assume  any  particular  order. The protocols are 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 appear comma-separated.  (Added in 7.58.0)

       --static-libs
              Shows the complete set of libs and other linker options you need in order to link your application
              with libcurl statically. (Added in 7.17.1)

       --version
              Outputs version information about the installed libcurl.

       --vernum
              Outputs version information about the installed  libcurl,  in  numerical  mode.   This  shows  the
              version  number, in hexadecimal, using 8 bits for each part: major, minor, and patch numbers. This
              makes libcurl 7.7.4 appear as 070704 and libcurl  12.13.14  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` -o example source.c `curl-config --libs`

SEE ALSO

       curl(1)