<!--
{
  "availability" : [
    "macOS: 10.5.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "SystemConfiguration",
  "identifier" : "/documentation/SystemConfiguration/SCNetworkInterfaceForceConfigurationRefresh(_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "System Configuration"
    ],
    "preciseIdentifier" : "c:@F@SCNetworkInterfaceForceConfigurationRefresh"
  },
  "title" : "SCNetworkInterfaceForceConfigurationRefresh(_:)"
}
-->

# SCNetworkInterfaceForceConfigurationRefresh(_:)

Sends a notification to interested network configuration agents to immediately retry their configuration.

```
func SCNetworkInterfaceForceConfigurationRefresh(_ interface: SCNetworkInterface) -> Bool
```

## Parameters

`interface`

The desired network interface.

## Return Value

`TRUE` if the notification was sent; otherwise, `FALSE`.

## Discussion

Calling this function causes the DHCP client to contact the DHCP server immediately rather than waiting until its timeout has expired. The caller uses this function to inform the system that the network infrastructure or configuration has changed.

Note that this function requires root privilege; alternatively, you can pass in an interface that is derived from a sequence of calls to:

- [`SCPreferencesCreateWithAuthorization(_:_:_:_:)`](/documentation/SystemConfiguration/SCPreferencesCreateWithAuthorization(_:_:_:_:))
- The appropriate `SCNetworkSetCopy...` function, such as [`SCNetworkSetCopyServices(_:)`](/documentation/SystemConfiguration/SCNetworkSetCopyServices(_:))
- [`SCNetworkServiceGetInterface(_:)`](/documentation/SystemConfiguration/SCNetworkServiceGetInterface(_:))

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)