<!--
{
  "availability" : [
    "iOS: 12.0.0 -",
    "iPadOS: 12.0.0 -",
    "macCatalyst: 13.0.0 -",
    "macOS: 10.14.0 -",
    "tvOS: 12.0.0 -",
    "visionOS: 1.0.0 -",
    "watchOS: 6.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Network",
  "identifier" : "/documentation/Network/nw_establishment_report_t",
  "metadataVersion" : "0.1.0",
  "role" : "Type Alias",
  "symbol" : {
    "kind" : "Type Alias",
    "modules" : [
      "Network"
    ],
    "preciseIdentifier" : "c:@T@nw_establishment_report_t"
  },
  "title" : "nw_establishment_report_t"
}
-->

# nw_establishment_report_t

A report that provides metrics about how a connection was established.

```
typealias nw_establishment_report_t = any OS_nw_establishment_report
```

## Topics

### Inspecting Connection Attempts

[`nw_establishment_report_get_duration_milliseconds(_:)`](/documentation/Network/nw_establishment_report_get_duration_milliseconds(_:))

Checks the total duration of the successful connection establishment attempt, from the preparing state to the ready state.

[`nw_establishment_report_get_previous_attempt_count(_:)`](/documentation/Network/nw_establishment_report_get_previous_attempt_count(_:))

Checks the number of attempts made before the successful attempt, when the connection moved from the preparing state back to the waiting state.

[`nw_establishment_report_get_attempt_started_after_milliseconds(_:)`](/documentation/Network/nw_establishment_report_get_attempt_started_after_milliseconds(_:))

Accesses the time between the call to start and the beginning of the successful connection attempt, in milliseconds.

### Inspecting Resolution

[`nw_establishment_report_enumerate_resolution_reports(_:_:)`](/documentation/Network/nw_establishment_report_enumerate_resolution_reports(_:_:))

[`nw_report_resolution_report_enumerator_t`](/documentation/Network/nw_report_resolution_report_enumerator_t)

Iterates a list of resolution steps, as [`nw_resolution_report_t`](/documentation/Network/nw_resolution_report_t) objects, performed during connection establishment, in order from first resolved to last resolved.

[`nw_resolution_report_t`](/documentation/Network/nw_resolution_report_t)

A description of a single DNS resolution step.

[`nw_resolution_report_get_milliseconds(_:)`](/documentation/Network/nw_resolution_report_get_milliseconds(_:))

Accesses the duration of this resolution step, from when the query was issued to when the response was complete.

[`nw_resolution_report_get_source(_:)`](/documentation/Network/nw_resolution_report_get_source(_:))

Accesses the source of the DNS response.

[`nw_report_resolution_source_t`](/documentation/Network/nw_report_resolution_source_t)

Sources that may provide DNS responses.

[`nw_resolution_report_get_protocol(_:)`](/documentation/Network/nw_resolution_report_get_protocol(_:))

Accesses the transport protocol your connection used for DNS resolution.

[`nw_report_resolution_protocol_t`](/documentation/Network/nw_report_resolution_protocol_t)

A set of transport protocols connections use for DNS resolution.

[`nw_resolution_report_copy_successful_endpoint(_:)`](/documentation/Network/nw_resolution_report_copy_successful_endpoint(_:))

Accesses the resolved endpoint that led to the established connection.

[`nw_resolution_report_copy_preferred_endpoint(_:)`](/documentation/Network/nw_resolution_report_copy_preferred_endpoint(_:))

Accesses the resolved endpoint that the connection used for its first connection attempt.

[`nw_resolution_report_get_endpoint_count(_:)`](/documentation/Network/nw_resolution_report_get_endpoint_count(_:))

Accesses the number of endpoints resolved in this step.

[`nw_establishment_report_enumerate_resolutions(_:_:)`](/documentation/Network/nw_establishment_report_enumerate_resolutions(_:_:))

Iterates a list of resolution steps performed during connection establishment, in order from first resolved to last resolved.

[`nw_report_resolution_enumerator_t`](/documentation/Network/nw_report_resolution_enumerator_t)

A block used to enumerate resolution steps performed during connection establishment.

### Inspecting Protocol Handshakes

[`nw_establishment_report_enumerate_protocols(_:_:)`](/documentation/Network/nw_establishment_report_enumerate_protocols(_:_:))

Iterates a list of protocol handshakes in order from first completed to last completed.

[`nw_report_protocol_enumerator_t`](/documentation/Network/nw_report_protocol_enumerator_t)

A block used to enumerate protocol handshakes performed during connection establishment.

### Checking for Proxies

[`nw_establishment_report_get_proxy_configured(_:)`](/documentation/Network/nw_establishment_report_get_proxy_configured(_:))

Checks whether a proxy was configured on the connection.

[`nw_establishment_report_get_used_proxy(_:)`](/documentation/Network/nw_establishment_report_get_used_proxy(_:))

Checks whether the connection used a proxy.

[`nw_establishment_report_copy_proxy_endpoint(_:)`](/documentation/Network/nw_establishment_report_copy_proxy_endpoint(_:))

Accesses the endpoint of the proxy the connection used.


---

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)