| 12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182 |
- .\" generated by cd2nroff 0.1 from curl-config.md
- .TH curl-config 1 "2025-01-17" curl-config
- .SH NAME
- curl\-config \- Get information about a libcurl installation
- .SH SYNOPSIS
- \fBcurl\-config [options]\fP
- .SH DESCRIPTION
- \fBcurl\-config\fP
- displays information about the curl and libcurl installation.
- .SH OPTIONS
- .IP --ca
- Displays the built\-in path to the CA cert bundle this libcurl uses.
- .IP --cc
- Displays the compiler used to build libcurl.
- .IP --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.
- .IP "--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)
- .IP --configure
- Displays the arguments given to configure when building curl.
- .IP --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.
- .IP --help
- Displays the available options.
- .IP --libs
- Shows the complete set of libs and other linker options you need in order to
- link your application with libcurl.
- .IP --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".
- .IP --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)
- .IP --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)
- .IP --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)
- .IP --version
- Outputs version information about the installed libcurl.
- .IP --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.)
- .SH EXAMPLES
- What linker options do I need when I link with libcurl?
- .nf
- $ curl-config --libs
- .fi
- What compiler options do I need when I compile using libcurl functions?
- .nf
- $ curl-config --cflags
- .fi
- How do I know if libcurl was built with SSL support?
- .nf
- $ curl-config --feature | grep SSL
- .fi
- What\(aqs the installed libcurl version?
- .nf
- $ curl-config --version
- .fi
- How do I build a single file with a one\-line command?
- .nf
- $ `curl-config --cc --cflags` -o example source.c `curl-config --libs`
- .fi
- .SH SEE ALSO
- .BR curl (1)
|
