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

FreeBSD Manual Pages

  
 
  

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

NAME
       CURLOPT_SSH_KNOWNHOSTS -	file name holding the SSH known	hosts

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	 curl_easy_setopt(CURL	*handle,  CURLOPT_SSH_KNOWNHOSTS, char
       *fname);

DESCRIPTION
       Pass a pointer to a zero	terminated string holding the file name	of the
       known_host  file	 to  use.  The known_hosts file	should use the OpenSSH
       file format as supported	by libssh2. If this file is specified, libcurl
       will  only  accept connections with hosts that are known	and present in
       that file, with a matching public key.  Use  CURLOPT_SSH_KEYFUNCTION(3)
       to alter	the default behavior on	host and key (mis)matching.

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

DEFAULT
       NULL

PROTOCOLS
       SFTP and	SCP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 curl_easy_setopt(curl,	CURLOPT_URL, "sftp://example.com/file");
	 curl_easy_setopt(curl,	CURLOPT_SSH_KNOWNHOSTS,
			  "/home/clarkkent/.ssh/known_hosts");
	 ret = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in	7.19.6

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_SSH_AUTH_TYPES(3), CURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3),

libcurl	7.54.1			 May 31, 2017	     CURLOPT_SSH_KNOWNHOSTS(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_SSH_KNOWNHOSTS&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help