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

FreeBSD Manual Pages

  
 
  

home | help
CURLINFO_PROTOCOL(3)	   Library Functions Manual	  CURLINFO_PROTOCOL(3)

NAME
       CURLINFO_PROTOCOL - get the protocol used in the	connection

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_getinfo(CURL *handle,	CURLINFO_PROTOCOL, long	*p);

DESCRIPTION
       This    option	 is    deprecated.   We	  strongly   recommend	 using
       CURLINFO_SCHEME(3) instead, because this	option cannot return all  pos-
       sible protocols.

       Pass  a	pointer	to a long to receive the version used in the last http
       connection. The returned	value is set to	one of these values:

       CURLPROTO_DICT, CURLPROTO_FILE, CURLPROTO_FTP, CURLPROTO_FTPS,
       CURLPROTO_GOPHER, CURLPROTO_HTTP, CURLPROTO_HTTPS, CURLPROTO_IMAP,
       CURLPROTO_IMAPS,	CURLPROTO_LDAP,	CURLPROTO_LDAPS, CURLPROTO_POP3,
       CURLPROTO_POP3S,	CURLPROTO_RTMP,	CURLPROTO_RTMPE, CURLPROTO_RTMPS,
       CURLPROTO_RTMPT,	CURLPROTO_RTMPTE, CURLPROTO_RTMPTS, CURLPROTO_RTSP,
       CURLPROTO_SCP, CURLPROTO_SFTP, CURLPROTO_SMB, CURLPROTO_SMBS, CURLPROTO_SMTP,
       CURLPROTO_SMTPS,	CURLPROTO_TELNET, CURLPROTO_TFTP, CURLPROTO_MQTT

PROTOCOLS
       This functionality affects all supported	protocols

EXAMPLE
       int main(void)
       {
	 CURL *curl = curl_easy_init();
	 if(curl) {
	   CURLcode res;
	   curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
	   res = curl_easy_perform(curl);
	   if(res == CURLE_OK) {
	     long protocol;
	     curl_easy_getinfo(curl, CURLINFO_PROTOCOL,	&protocol);
	   }
	   curl_easy_cleanup(curl);
	 }
       }

DEPRECATED
       Deprecated since	7.85.0.

AVAILABILITY
       Added in	curl 7.52.0

RETURN VALUE
       curl_easy_getinfo(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).

SEE ALSO
       CURLINFO_RESPONSE_CODE(3), curl_easy_getinfo(3),	curl_easy_setopt(3)

libcurl				  2025-06-03		  CURLINFO_PROTOCOL(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLINFO_PROTOCOL&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help