165 lines
6.6 KiB
Groff
165 lines
6.6 KiB
Groff
.\" generated by cd2nroff 0.1 from curl-config.md
|
|
.TH curl-config 1 "January 26 2024" 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 will return 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 will be 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 will 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 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)
|
|
.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 will appear
|
|
comma\-separated. (Added in 7.58.0)
|
|
.IP --static-libs
|
|
Shows the complete set of libs and other linker options you will 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)
|
|
.\" generated by cd2nroff 0.1 from curl-config.md
|
|
.TH curl-config 1 "January 26 2024" 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 will return 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 will be 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 will 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 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)
|
|
.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 will appear
|
|
comma\-separated. (Added in 7.58.0)
|
|
.IP --static-libs
|
|
Shows the complete set of libs and other linker options you will 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)
|