Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CURL.SetOptionDNSCacheTimeout

Sets the DNS Cache Timeout in seconds.

Component Version macOS Windows Linux Server iOS SDK
CURL 2.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "CURL.SetOptionDNSCacheTimeout"; curl; Value )   More

Parameters

Parameter Description Example
curl The CURL session handle. $curl
Value The new timeout in seconds. 60

Result

Returns "OK" on success.

Description

Sets the DNS Cache Timeout in seconds.
Name resolves will be kept in memory for this number of seconds. Set to zero to completely disable caching, or set to -1 to make the cached entries remain forever. By default, libcurl caches this info for 60 seconds.

The name resolve functions of various libc implementations don't re-read name server information unless explicitly told so (for example, by calling res_init(3)). This may cause libcurl to keep using the older server even if DHCP has updated the server info, and this may look like a DNS cache issue to the casual libcurl-app user.

See also DNS_CACHE_TIMEOUT option in CURL manual.

See also

Created 18th August 2014, last changed 18th August 2014


CURL.SetOptionCustomRequest - CURL.SetOptionDNSInterface