FreeBSD Manual Pages
CURLMOPT_NETWORK_CHANGED(3) Library Functions Manual CURLMOPT_NETWORK_CHANGED(3) NAME CURLMOPT_NETWORK_CHANGED - signal network changed SYNOPSIS #include <curl/curl.h> CURLMcode curl_multi_setopt(CURLM *handle, CURLMOPT_NETWORK_CHANGED, long value); DESCRIPTION Pass a long with a bitmask to tell libcurl how the multi handle should re- act. The following values in the mask are defined. All bits not mentioned are reserved for future extensions. This option can be set at any time and repeatedly. Each call only affects the currently cached connections and DNS information. Any connection cre- ated or DNS information added afterwards is cached the usual way again. Phrasing it another way: the option is not persisted but setting it serves as a "trigger" to clear the caches. The call affects only the connection and DNS cache of the multi handle it- self and not the ones owned by SHARE handles. CURLMNWC_CLEAR_ALL Clear everything. (Added in 8.20.0) CURLMNWC_CLEAR_CONNS No longer reuse any existing connection in the multi handle's con- nection cache. This closes all connections that are not in use. On- going transfers continue on the connections they operate on. CURLMNWC_CLEAR_DNS Clear the multi handle's DNS cache. Ongoing transfers keep using their already resolved addresses, but future name resolutions are performed again. DEFAULT 0, which has no effect. PROTOCOLS This functionality affects all supported protocols EXAMPLE int main(void) { CURLM *m = curl_multi_init(); /* do transfers on the multi handle */ /* do not reuse existing connections */ curl_multi_setopt(m, CURLMOPT_NETWORK_CHANGED, CURLMNWC_CLEAR_CONNS); } AVAILABILITY Added in curl 8.16.0 RETURN VALUE curl_multi_setopt(3) returns a CURLMcode indicating success or error. CURLM_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3). SEE ALSO CURLOPT_FORBID_REUSE(3), CURLOPT_FRESH_CONNECT(3) libcurl 2026-06-11 CURLMOPT_NETWORK_CHANGED(3)
NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLMOPT_NETWORK_CHANGED&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>