Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curl-config(1)		     General Commands Manual		  curl-config(1)

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 in-
	    clude 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 $pre-
	    fix/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 ap-
	    pear 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  numeri-
	    cal  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)

curl-config			   2026-06-11			  curl-config(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=curl-config&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help