DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_PORT(3)




CURLOPT_PORT(3)     curl_easy_setopt options      CURLOPT_PORT(3)


NAME

     CURLOPT_PORT - set remote port number to work with


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle,  CURLOPT_PORT,  long
     number);


DESCRIPTION

     This option sets number to be the remote port number to con-
     nect  to,  instead  of  the  one specified in the URL or the
     default port for the used protocol.

     Usually, you just let the URL decide which port to  use  but
     this allows the application to override that.

     While this option accepts a 'long', a port number is usually
     a 16 bit number and therefore using a port number over 65535
     will cause a run-time error.


DEFAULT

     By default this is 0 which makes it not used.


PROTOCOLS

     Used for all protocols that speak to a port number.


EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "http://example.com/foo.bin");
       curl_easy_setopt(curl, CURLOPT_PORT, 8080L);
       ret = curl_easy_perform(curl);
       curl_easy_cleanup(curl);
     }


AVAILABILITY

     Always


RETURN VALUE

     Returns CURLE_OK


SEE ALSO

     CURLOPT_STDERR(3), CURLOPT_DEBUGFUNCTION(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html