mirror of
https://github.com/curl/curl.git
synced 2026-06-09 11:24:17 +03:00
55c045c863
New multi option CURLMOPT_NETWORK_CHANGED with a long bitmask value: - CURLM_NWCOPT_CLEAR_CONNS: do not reuse existing connections, close all idle connections. - CURLM_NWCOPT_CLEAR_DNS: clear the multi's DNS cache. All other bits reserved for future extensions. Fixes #17225 Reported-by: ウさん Closes #17613
80 lines
1.9 KiB
Markdown
80 lines
1.9 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Title: CURLMOPT_NETWORK_CHANGED
|
|
Section: 3
|
|
Source: libcurl
|
|
See-also:
|
|
- CURLOPT_FRESH_CONNECT (3)
|
|
- CURLOPT_FORBID_REUSE (3)
|
|
Protocol:
|
|
- All
|
|
Added-in: 8.16.0
|
|
---
|
|
|
|
# NAME
|
|
|
|
CURLMOPT_NETWORK_CHANGED - signal network changed
|
|
|
|
# SYNOPSIS
|
|
|
|
~~~c
|
|
#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 react. 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 created 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
|
|
itself and not the ones owned by SHARE handles.
|
|
|
|
## CURLM_NWCOPT_CLEAR_CONNS
|
|
|
|
No longer reuse any existing connection in the multi handle's
|
|
connection cache. This closes all connections that are not in use.
|
|
Ongoing transfers continue on the connections they operate on.
|
|
|
|
## CURLM_NWCOPT_CLEAR_DNS
|
|
|
|
Clear the multi handle's DNS cache.
|
|
|
|
# DEFAULT
|
|
|
|
0, which has no effect.
|
|
|
|
# %PROTOCOLS%
|
|
|
|
# EXAMPLE
|
|
|
|
~~~c
|
|
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, CURLM_NWCOPT_CLEAR_CONNS);
|
|
}
|
|
~~~
|
|
|
|
# %AVAILABILITY%
|
|
|
|
# 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).
|