DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_LOCALPORT(3)




CURLOPT_LOCALPORT(3)curl_easy_setopt options CURLOPT_LOCALPORT(3)


NAME

     CURLOPT_LOCALPORT - set local port number to use for socket


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL  *handle,  CURLOPT_LOCALPORT,
     long port);


DESCRIPTION

     Pass a long. This sets the local port number of  the  socket
     used  for  the  connection.  This can be used in combination
     with CURLOPT_INTERFACE(3) and you  are  recommended  to  use
     CURLOPT_LOCALPORTRANGE(3)  as  well when this option is set.
     Valid port numbers are 1 - 65535.


DEFAULT

     0, disabled - use whatever the system thinks is fine


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, 8080L);
       /* 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


SEE ALSO

     CURLOPT_LOCALPORTRANGE(3), CURLOPT_INTERFACE(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html