2004-12-24 17:02:23 +08:00
|
|
|
.\" **************************************************************************
|
|
|
|
.\" * _ _ ____ _
|
|
|
|
.\" * Project ___| | | | _ \| |
|
|
|
|
.\" * / __| | | | |_) | |
|
|
|
|
.\" * | (__| |_| | _ <| |___
|
|
|
|
.\" * \___|\___/|_| \_\_____|
|
|
|
|
.\" *
|
2020-04-27 05:59:22 +08:00
|
|
|
.\" * Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al.
|
2004-12-24 17:02:23 +08:00
|
|
|
.\" *
|
|
|
|
.\" * This software is licensed as described in the file COPYING, which
|
|
|
|
.\" * you should have received as part of this distribution. The terms
|
2020-11-04 21:02:01 +08:00
|
|
|
.\" * are also available at https://curl.se/docs/copyright.html.
|
2004-12-24 17:02:23 +08:00
|
|
|
.\" *
|
|
|
|
.\" * 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
|
2022-05-17 17:16:50 +08:00
|
|
|
.\" *
|
2004-12-24 17:02:23 +08:00
|
|
|
.\" **************************************************************************
|
2001-04-18 21:16:34 +08:00
|
|
|
.\"
|
2007-10-26 06:30:35 +08:00
|
|
|
.TH curl-config 1 "25 Oct 2007" "Curl 7.17.1" "curl-config manual"
|
2001-04-18 21:16:34 +08:00
|
|
|
.SH NAME
|
|
|
|
curl-config \- Get information about a libcurl installation
|
|
|
|
.SH SYNOPSIS
|
|
|
|
.B curl-config [options]
|
|
|
|
.SH DESCRIPTION
|
|
|
|
.B curl-config
|
2008-12-22 21:07:13 +08:00
|
|
|
displays information about the curl and libcurl installation.
|
2001-04-18 21:16:34 +08:00
|
|
|
.SH OPTIONS
|
2002-10-08 21:30:15 +08:00
|
|
|
.IP "--ca"
|
|
|
|
Displays the built-in path to the CA cert bundle this libcurl uses.
|
2002-01-21 22:57:07 +08:00
|
|
|
.IP "--cc"
|
|
|
|
Displays the compiler used to build libcurl.
|
2001-04-18 21:16:34 +08:00
|
|
|
.IP "--cflags"
|
2001-08-16 21:11:29 +08:00
|
|
|
Set of compiler options (CFLAGS) to use when compiling files that use
|
2008-12-22 21:07:13 +08:00
|
|
|
libcurl. Currently that is only the include path to the curl include files.
|
2006-05-03 06:48:22 +08:00
|
|
|
.IP "--checkfor [version]"
|
2010-02-15 03:40:18 +08:00
|
|
|
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
|
2006-05-03 06:48:22 +08:00
|
|
|
enough. (Added in 7.15.4)
|
2009-11-15 03:23:26 +08:00
|
|
|
.IP "--configure"
|
|
|
|
Displays the arguments given to configure when building curl.
|
2001-04-18 21:16:34 +08:00
|
|
|
.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
|
2008-12-22 21:07:13 +08:00
|
|
|
none, one, or several keywords in the list.
|
2001-04-18 21:16:34 +08:00
|
|
|
.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
|
2001-04-19 19:19:54 +08:00
|
|
|
in $prefix/lib and its header files are installed in $prefix/include and so
|
2001-04-18 21:16:34 +08:00
|
|
|
on. The prefix is set with "configure --prefix".
|
2004-12-24 17:02:23 +08:00
|
|
|
.IP "--protocols"
|
|
|
|
Lists what particular protocols the installed libcurl was built to support. At
|
2006-01-17 06:14:37 +08:00
|
|
|
the time of writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE,
|
2022-09-09 21:11:13 +08:00
|
|
|
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)
|
2017-11-30 15:57:36 +08:00
|
|
|
.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)
|
2007-10-26 06:30:35 +08:00
|
|
|
.IP "--static-libs"
|
|
|
|
Shows the complete set of libs and other linker options you will need in order
|
2007-10-26 15:46:02 +08:00
|
|
|
to link your application with libcurl statically. (Added in 7.17.1)
|
2001-04-18 21:16:34 +08:00
|
|
|
.IP "--version"
|
|
|
|
Outputs version information about the installed libcurl.
|
2001-05-28 22:58:07 +08:00
|
|
|
.IP "--vernum"
|
|
|
|
Outputs version information about the installed libcurl, in numerical mode.
|
2020-04-24 22:23:22 +08:00
|
|
|
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
|
2004-12-12 02:38:47 +08:00
|
|
|
12.13.14 would appear as 0c0d0e... Note that the initial zero might be
|
2005-10-28 20:59:37 +08:00
|
|
|
omitted. (This option was broken in the 7.15.0 release.)
|
2001-04-20 22:45:15 +08:00
|
|
|
.SH "EXAMPLES"
|
2001-08-16 21:11:29 +08:00
|
|
|
What linker options do I need when I link with libcurl?
|
2022-09-21 05:30:19 +08:00
|
|
|
.nf
|
2002-01-21 22:57:07 +08:00
|
|
|
$ curl-config --libs
|
2022-09-21 05:30:19 +08:00
|
|
|
.fi
|
2001-08-16 21:11:29 +08:00
|
|
|
What compiler options do I need when I compile using libcurl functions?
|
2022-09-21 05:30:19 +08:00
|
|
|
.nf
|
2002-01-21 22:57:07 +08:00
|
|
|
$ curl-config --cflags
|
2022-09-21 05:30:19 +08:00
|
|
|
.fi
|
2001-04-20 22:45:15 +08:00
|
|
|
How do I know if libcurl was built with SSL support?
|
2022-09-21 05:30:19 +08:00
|
|
|
.nf
|
2002-01-21 22:57:07 +08:00
|
|
|
$ curl-config --feature | grep SSL
|
2022-09-21 05:30:19 +08:00
|
|
|
.fi
|
2001-04-20 22:45:15 +08:00
|
|
|
What's the installed libcurl version?
|
2022-09-21 05:30:19 +08:00
|
|
|
.nf
|
2002-01-21 22:57:07 +08:00
|
|
|
$ curl-config --version
|
2022-09-21 05:30:19 +08:00
|
|
|
.fi
|
2002-01-21 22:57:07 +08:00
|
|
|
How do I build a single file with a one-line command?
|
2022-09-21 05:30:19 +08:00
|
|
|
.nf
|
2012-05-20 21:38:54 +08:00
|
|
|
$ `curl-config --cc --cflags` -o example example.c `curl-config --libs`
|
2022-09-21 05:30:19 +08:00
|
|
|
.fi
|
2001-04-18 21:16:34 +08:00
|
|
|
.SH "SEE ALSO"
|
|
|
|
.BR curl (1)
|