| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
CURL.NetworkChanged
Signal network changed.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| CURL | 15.5 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "CURL.NetworkChanged"; curl; ClearConns; ClearDNS ) More
Parameters
| Parameter | Description | Example |
|---|---|---|
| curl | The CURL session handle. | $curl |
| ClearConns | Pass 1 to clear connections or 0 to skip. 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. |
1 |
| ClearDNS | Pass 1 to clear caches. Clear the multi handle's DNS cache. |
1 |
Result
Returns OK or error.
Description
Signal network changed.Informs CURL about a network change, so it can discard connections or DNS cache entries.
This method can be caled 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.
The call affects only the connection and DNS cache of the multi handle itself and not the ones owned by SHARE handles.
ClearConns: 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.
ClearDNS: Clear the multi handle's DNS cache.
Release notes
- Version 15.5
- Added CURL.NetworkChanged function.
Blog Entries
This function is free to use.
Created 17th September 2025, last changed 17th September 2025
