CURLOPT_CONNECT_TO(3) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

CURLOPT_CONNECT_TO(3)

/usr/local/bin/rman를 실행할 수 없습니다

CURLOPT_CONNECT_TO(3)      Library Functions Manual      CURLOPT_CONNECT_TO(3)

NAME
       CURLOPT_CONNECT_TO - connect to another host and port instead

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONNECT_TO,
                                 struct curl_slist *connect_to);

DESCRIPTION
       Pass  a  pointer to a linked list of strings with "connect to" informa‐
       tion to use for establishing network connections with this handle.  The
       linked  list  should be a fully valid list of struct curl_slist structs
       properly filled in. Use curl_slist_append(3) to  create  the  list  and
       curl_slist_free_all(3) to clean up an entire list.

       Each  single  string  should be written using the format HOST:PORT:CON‐
       NECT-TO-HOST:CONNECT-TO-PORT where HOST is the  host  of  the  request,
       PORT  is  the  port  of the request, CONNECT-TO-HOST is the hostname to
       connect to, and CONNECT-TO-PORT is the port to connect to.

       The first string that matches the request's host and port is used.

       Dotted  numerical  IP  addresses  are  supported  for  HOST  and   CON‐
       NECT-TO-HOST.   A numerical IPv6 address must be written within [brack‐
       ets].

       Any of the four values may be empty. When the HOST or  PORT  is  empty,
       the  host or port always match (the request's host or port is ignored).
       When CONNECT-TO-HOST or CONNECT-TO-PORT is empty, the "connect to" fea‐
       ture is disabled for the host or port, and the request's host  or  port
       are used to establish the network connection.

       This  option  is  suitable  to direct the request at a specific server,
       e.g. at a specific cluster node in a cluster of servers.

       The "connect to" host and port are only used to establish  the  network
       connection.  They  do  NOT  affect  the host and port that are used for
       TLS/SSL (e.g. SNI, certificate verification)  or  for  the  application
       protocols.

       In  contrast  to  CURLOPT_RESOLVE(3),  the option CURLOPT_CONNECT_TO(3)
       does not pre-populate the DNS cache and therefore it  does  not  affect
       future transfers of other easy handles that have been added to the same
       multi handle.

       The  "connect  to"  host  and port are ignored if they are equal to the
       host and the port in the request URL, because connecting  to  the  host
       and the port in the request URL is the default behavior.

       If  an  HTTP  proxy is used for a request having a special "connect to"
       host or port, and the "connect to" host or port differs  from  the  re‐
       quest's host and port, the HTTP proxy is automatically switched to tun‐
       nel mode for this specific request. This is necessary because it is not
       possible  to  connect to a specific host or port in normal (non-tunnel)
       mode.

       When this option is passed to  curl_easy_setopt(3),  libcurl  does  not
       copy  the  list so you must keep it around until you no longer use this
       handle for a transfer before you  call  curl_slist_free_all(3)  on  the
       list.

       Using  this  option multiple times makes the last set list override the
       previous ones. Set it to NULL to disable its use again.

DEFAULT
       NULL

PROTOCOLS
       This functionality affects all supported protocols

EXAMPLE
       int main(void)
       {
         CURL *curl;
         struct curl_slist *connect_to = NULL;
         connect_to = curl_slist_append(NULL, "example.com::server1.example.com:");

         curl = curl_easy_init();
         if(curl) {
           curl_easy_setopt(curl, CURLOPT_CONNECT_TO, connect_to);
           curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");

           curl_easy_perform(curl);

           /* always cleanup */
           curl_easy_cleanup(curl);
         }

         curl_slist_free_all(connect_to);
       }

AVAILABILITY
       Added in curl 7.49.0

RETURN VALUE
       curl_easy_setopt(3) returns a CURLcode indicating success or error.

       CURLE_OK (0) means everything was OK, non-zero means an error occurred,
       see libcurl-errors(3).


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

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   web/curl = Stability Uncommitted

SEE ALSO
       CURLOPT_FOLLOWLOCATION(3),   CURLOPT_HTTPPROXYTUNNEL(3),    CURLOPT_RE‐
       SOLVE(3), CURLOPT_URL(3)



NOTES
       Source  code  for open source software components in Oracle Solaris can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       https://curl.se/download/curl-8.17.0.tar.bz2

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

libcurl                           2025-12-01             CURLOPT_CONNECT_TO(3)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3