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

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 ver-
	      sion 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  up-
	      percase  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  nu-
	      merical  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			  2025-06-03			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+14.3.quarterly>

home | help