Return to curl-config.1 CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / curl / docs

Annotation of embedaddon/curl/docs/curl-config.1, revision 1.1.1.1

1.1       misho       1: .\" **************************************************************************
                      2: .\" *                                  _   _ ____  _
                      3: .\" *  Project                     ___| | | |  _ \| |
                      4: .\" *                             / __| | | | |_) | |
                      5: .\" *                            | (__| |_| |  _ <| |___
                      6: .\" *                             \___|\___/|_| \_\_____|
                      7: .\" *
                      8: .\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al.
                      9: .\" *
                     10: .\" * This software is licensed as described in the file COPYING, which
                     11: .\" * you should have received as part of this distribution. The terms
                     12: .\" * are also available at https://curl.haxx.se/docs/copyright.html.
                     13: .\" *
                     14: .\" * You may opt to use, copy, modify, merge, publish, distribute and/or sell
                     15: .\" * copies of the Software, and permit persons to whom the Software is
                     16: .\" * furnished to do so, under the terms of the COPYING file.
                     17: .\" *
                     18: .\" * This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
                     19: .\" * KIND, either express or implied.
                     20: .\" *
                     21: .\" **************************************************************************
                     22: .\"
                     23: .TH curl-config 1 "April 26, 2020" "Curl 7.70.0" "curl-config manual"
                     24: 
                     25: .SH NAME
                     26: curl-config \- Get information about a libcurl installation
                     27: .SH SYNOPSIS
                     28: .B curl-config [options]
                     29: .SH DESCRIPTION
                     30: .B curl-config
                     31: displays information about the curl and libcurl installation.
                     32: .SH OPTIONS
                     33: .IP "--ca"
                     34: Displays the built-in path to the CA cert bundle this libcurl uses.
                     35: .IP "--cc"
                     36: Displays the compiler used to build libcurl.
                     37: .IP "--cflags"
                     38: Set of compiler options (CFLAGS) to use when compiling files that use
                     39: libcurl. Currently that is only the include path to the curl include files.
                     40: .IP "--checkfor [version]"
                     41: Specify the oldest possible libcurl version string you want, and this
                     42: script will return 0 if the current installation is new enough or it
                     43: returns 1 and outputs a text saying that the current version is not new
                     44: enough. (Added in 7.15.4)
                     45: .IP "--configure"
                     46: Displays the arguments given to configure when building curl.
                     47: .IP "--feature"
                     48: Lists what particular main features the installed libcurl was built with. At
                     49: the time of writing, this list may include SSL, KRB4 or IPv6. Do not assume
                     50: any particular order. The keywords will be separated by newlines. There may be
                     51: none, one, or several keywords in the list.
                     52: .IP "--help"
                     53: Displays the available options.
                     54: .IP "--libs"
                     55: Shows the complete set of libs and other linker options you will need in order
                     56: to link your application with libcurl.
                     57: .IP "--prefix"
                     58: This is the prefix used when libcurl was installed. Libcurl is then installed
                     59: in $prefix/lib and its header files are installed in $prefix/include and so
                     60: on. The prefix is set with "configure --prefix".
                     61: .IP "--protocols"
                     62: Lists what particular protocols the installed libcurl was built to support. At
                     63: the time of writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE,
                     64: TELNET, LDAP, DICT. Do not assume any particular order. The protocols will
                     65: be listed using uppercase and are separated by newlines. There may be none,
                     66: one, or several protocols in the list. (Added in 7.13.0)
                     67: .IP "--ssl-backends"
                     68: Lists the SSL backends that were enabled when libcurl was built. It might be
                     69: no, one or several names. If more than one name, they will appear
                     70: comma-separated. (Added in 7.58.0)
                     71: .IP "--static-libs"
                     72: Shows the complete set of libs and other linker options you will need in order
                     73: to link your application with libcurl statically. (Added in 7.17.1)
                     74: .IP "--version"
                     75: Outputs version information about the installed libcurl.
                     76: .IP "--vernum"
                     77: Outputs version information about the installed libcurl, in numerical mode.
                     78: This outputs the version number, in hexadecimal, with 8 bits for each part:
                     79: major, minor, and patch. So that libcurl 7.7.4 would appear as 070704 and libcurl
                     80: 12.13.14 would appear as 0c0d0e... Note that the initial zero might be
                     81: omitted. (This option was broken in the 7.15.0 release.)
                     82: .SH "EXAMPLES"
                     83: What linker options do I need when I link with libcurl?
                     84: 
                     85:   $ curl-config --libs
                     86: 
                     87: What compiler options do I need when I compile using libcurl functions?
                     88: 
                     89:   $ curl-config --cflags
                     90: 
                     91: How do I know if libcurl was built with SSL support?
                     92: 
                     93:   $ curl-config --feature | grep SSL
                     94: 
                     95: What's the installed libcurl version?
                     96: 
                     97:   $ curl-config --version
                     98: 
                     99: How do I build a single file with a one-line command?
                    100: 
                    101:   $ `curl-config --cc --cflags` -o example example.c `curl-config --libs`
                    102: .SH "SEE ALSO"
                    103: .BR curl (1)