Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

CURLOPT_LOCALPORTRANGE (3)

Name

CURLOPT_LOCALPORTRANGE - number of additional local ports to try

Synopsis

#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOCALPORTRANGE,
long range);

Description

CURLOPT_LOCALPORTRANGE(3)  curl_easy_setopt options  CURLOPT_LOCALPORTRANGE(3)



NAME
       CURLOPT_LOCALPORTRANGE - number of additional local ports to try

SYNOPSIS
       #include <curl/curl.h>

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_LOCALPORTRANGE,
                                 long range);

DESCRIPTION
       Pass  a long. The range argument is the number of attempts libcurl will
       make to find a working local port number. It starts with the given CUR-
       LOPT_LOCALPORT(3)  and  adds  one to the number for each retry. Setting
       this option to 1 or below will make libcurl do only  one  try  for  the
       exact  port  number.  Port  numbers by nature are scarce resources that
       will be busy at times so setting this value to something too low  might
       cause unnecessary connection setup failures.

DEFAULT
       1

PROTOCOLS
       All

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl) {
         curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/foo.bin");
         curl_easy_setopt(curl, CURLOPT_LOCALPORT, 49152L);
         /* and try 20 more ports following that */
         curl_easy_setopt(curl, CURLOPT_LOCALPORTRANGE, 20L);
         ret = curl_easy_perform(curl);
         curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in 7.15.2

RETURN VALUE
       Returns  CURLE_OK  if the option is supported, and CURLE_UNKNOWN_OPTION
       if not.


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       CURLOPT_LOCALPORT(3), CURLOPT_INTERFACE(3),



NOTES
       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-
       chive/curl-7_64_0.zip

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



libcurl 7.37.0                    19 Jun 2014        CURLOPT_LOCALPORTRANGE(3)