107 lines
4.4 KiB
Groff
107 lines
4.4 KiB
Groff
|
.\" **************************************************************************
|
||
|
|
.\" * _ _ ____ _
|
||
|
|
.\" * Project ___| | | | _ \| |
|
||
|
|
.\" * / __| | | | |_) | |
|
||
|
|
.\" * | (__| |_| | _ <| |___
|
||
|
|
.\" * \___|\___/|_| \_\_____|
|
||
|
|
.\" *
|
||
|
|
.\" * Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
||
|
|
.\" *
|
||
|
|
.\" * This software is licensed as described in the file COPYING, which
|
||
|
|
.\" * you should have received as part of this distribution. The terms
|
||
|
|
.\" * are also available at https://curl.se/docs/copyright.html.
|
||
|
|
.\" *
|
||
|
|
.\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
|
||
|
|
.\" * copies of the Software, and permit persons to whom the Software is
|
||
|
|
.\" * furnished to do so, under the terms of the COPYING file.
|
||
|
|
.\" *
|
||
|
|
.\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
|
||
|
|
.\" * KIND, either express or implied.
|
||
|
|
.\" *
|
||
|
|
.\" * SPDX-License-Identifier: curl
|
||
|
|
.\" *
|
||
|
|
.\" **************************************************************************
|
||
|
|
.\"
|
||
|
|
.TH curl-config 1 "April 26, 2023" "url-config 8.3.0" curl-config
|
||
|
|
|
||
|
|
.SH NAME
|
||
|
|
curl-config \- Get information about a libcurl installation
|
||
|
|
.SH SYNOPSIS
|
||
|
|
.B curl-config [options]
|
||
|
|
.SH DESCRIPTION
|
||
|
|
.B curl-config
|
||
|
|
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 outputs the version number, in hexadecimal, with 8 bits for each part:
|
||
|
|
major, minor, and patch. So that libcurl 7.7.4 would appear as 070704 and libcurl
|
||
|
|
12.13.14 would 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's 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 example.c `curl-config --libs`
|
||
|
|
.fi
|
||
|
|
.SH "SEE ALSO"
|
||
|
|
.BR curl (1)
|