| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105 |
- .\" **************************************************************************
- .\" * _ _ ____ _
- .\" * 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 "25 Oct 2007" curl-config 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)
|
