Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019

libcurl-env (3)


libcurl-env - environment variables libcurl understands


Please see following description for synopsis


libcurl environment variables                                   libcurl-env(3)

       libcurl-env - environment variables libcurl understands

       libcurl  reads  and  understands a set of environment variables that if
       set will control and change behaviors. This is the full list  of  vari-
       ables  to set and description of what they do. Also note that curl, the
       command line tool, supports a set of additional  environment  variables
       independently of this.

              When  libcurl  is  given  a  URL  to use in a transfer, it first
              extracts the "scheme" part from the URL and checks if there is a
              given  proxy set for that in its corresponding environment vari-
              able.  A  URL  like  "http://example.com"  will  hence  use  the
              "http_proxy" variable, while a URL like "ftp://example.com" will
              use the "ftp_proxy" variable.

              These proxy variables are also checked for  in  their  uppercase
              versions,  except the "http_proxy" one which is only used lower-
              case. Note also that some systems actually have a case  insensi-
              tive  handling  of  environment  variables  and  then  of course
              "HTTP_PROXY" will still work...

              This is a setting to set proxy for all  URLs,  independently  of
              what  scheme  is being used. Note that the scheme specific vari-
              ables will override this one if set.

              When libcurl is built to support multiple SSL backends, it  will
              select  a specific backend at first use. If no selection is done
              by the program using libcurl, this variable's selection will  be
              used. It should be set to the full SSL backend name to use (case

       HOME   When the netrc feature is used (CURLOPT_NETRC(3)), this variable
              is  checked as the primary way to find the "current" home direc-
              tory in which the .netrc file is likely to exist.

              User name to use when invoking the  ntlm-wb  tool,  if  NTLMUSER
              wasn't set.

              This  has  the  same  functionality  as  the  CURLOPT_NOPROXY(3)
              option: it gives libcurl a comma-separated  list  of  host  name
              patterns for which libcurl should not use a proxy.

              User name to use when invoking the ntlm-wb tool.

              When  set and libcurl runs with a SSL backend that supports this
              feature, libcurl will save SSL secrets into the given file name.
              Using  those  SSL  secrets,  other tools (such as Wireshark) can
              decrypt the SSL communication and analyze/view the traffic.

              When libcurl runs with the NSS backends for TLS  features,  this
              variable  is  used  to  find  the directory for NSS PKI database
              instead of the built-in.

       USER   User name to use when invoking the ntlm-wb tool, if NTLMUSER and
              LOGNAME weren't set.

Debug Variables
       There's  a  set  of  variables  only recognized and used if libcurl was
       built "debug enabled", which should never be true for a library used in

              Debug-only variable.

              Debug-only variable.

              Debug-only  variable.  Used  to  set  a fixed faked value to use
              instead of a proper random number so that functions  in  libcurl
              that are otherwise getting random outputs can be tested for what
              they generate.

              Debug-only variable. Used for debugging the lib/ldap implementa-

              Debug-only variable. Used to set to a debug-version of the ntlm-
              wb executable.

              Debug-only  variable.  Used  for  debugging  the  lib/openldap.c

       See attributes(7) for descriptions of the following attributes:

       |Availability   | web/curl         |
       |Stability      | Uncommitted      |
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source    was    downloaded    from    https://github.com/curl/curl/ar-

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.

libcurl 7.58.0                  20 January 2018                 libcurl-env(3)