Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_FTPPORT(3)	   curl_easy_setopt options	    CURLOPT_FTPPORT(3)

NAME
       CURLOPT_FTPPORT - make FTP transfer active

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_setopt(CURL *handle, CURLOPT_FTPPORT,	char *spec);

DESCRIPTION
       Pass  a	pointer	to a zero terminated string as parameter. It specifies
       that the	FTP transfer will be made actively and the given  string  will
       be used to get the IP address to	use for	the FTP	PORT instruction.

       The  PORT  instruction tells the	remote server to connect to our	speci-
       fied IP address.	The string may be a plain IP address, a	host  name,  a
       network interface name (under Unix) or just a '-' symbol	to let the li-
       brary use your system's default IP address. Default FTP operations  are
       passive,	and thus won't use PORT.

       The address can be followed by a	':' to specify a port, optionally fol-
       lowed by	a '-' to specify a port	range.	If the port  specified	is  0,
       the operating system will pick a	free port.  If a range is provided and
       all  ports  in  the  range  are	not  available,	 libcurl  will	report
       CURLE_FTP_PORT_FAILED  for the handle.  Invalid port/range settings are
       ignored.	 IPv6 addresses	followed by a port or portrange	have to	be  in
       brackets.  IPv6 addresses without port/range specifier can be in	brack-
       ets.

       Examples	with specified ports:

	 eth0:0
	 192.168.1.2:32000-33000
	 curl.se:32123
	 [::1]:1234-4567

       You disable PORT	again and go back to using the passive version by set-
       ting this option	to NULL.

       The  application	 does not have to keep the string around after setting
       this option.

DEFAULT
       NULL

PROTOCOLS
       FTP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 curl_easy_setopt(curl,	CURLOPT_URL, "ftp://example.com/old-server/file.txt");
	 curl_easy_setopt(curl,	CURLOPT_FTPPORT, "-");
	 ret = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }

AVAILABILITY
       Port range support was added in 7.19.5

RETURN VALUE
       Returns CURLE_OK	if the option is  supported,  CURLE_UNKNOWN_OPTION  if
       not, or CURLE_OUT_OF_MEMORY if there was	insufficient heap space.

SEE ALSO
       CURLOPT_FTP_USE_EPRT(3),	CURLOPT_FTP_USE_EPSV(3),

libcurl	7.54.1			 May 30, 2017		    CURLOPT_FTPPORT(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_FTPPORT&sektion=3&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help