// // VPN.swift // TunnelKit // // Created by Davide De Rosa on 9/6/18. // Copyright (c) 2022 Davide De Rosa. All rights reserved. // // https://github.com/passepartoutvpn // // This file is part of TunnelKit. // // TunnelKit is free software: you can redistribute it and/or modify // it under the terms of the GNU General Public License as published by // the Free Software Foundation, either version 3 of the License, or // (at your option) any later version. // // TunnelKit is distributed in the hope that it will be useful, // but WITHOUT ANY WARRANTY; without even the implied warranty of // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the // GNU General Public License for more details. // // You should have received a copy of the GNU General Public License // along with TunnelKit. If not, see . // import Foundation /// Helps controlling a VPN without messing with underlying implementations. public protocol VPN { associatedtype Configuration associatedtype Extra /** Synchronizes with the current VPN state. */ func prepare() async /** Installs the VPN profile. - Parameter tunnelBundleIdentifier: The bundle identifier of the tunnel extension. - Parameter configuration: The configuration to install. - Parameter extra: Optional extra arguments. */ func install( _ tunnelBundleIdentifier: String, configuration: Configuration, extra: Extra? ) async throws /** Reconnects to the VPN with current configuration. - Parameter after: The reconnection delay. **/ func reconnect( after: DispatchTimeInterval ) async throws /** Reconnects to the VPN installing a new configuration. - Parameter tunnelBundleIdentifier: The bundle identifier of the tunnel extension. - Parameter configuration: The configuration to install. - Parameter extra: Optional extra arguments. - Parameter after: The reconnection delay. */ func reconnect( _ tunnelBundleIdentifier: String, configuration: Configuration, extra: Extra?, after: DispatchTimeInterval ) async throws /** Disconnects from the VPN. */ func disconnect() async /** Uninstalls the VPN profile. */ func uninstall() async } extension DispatchTimeInterval { /// Returns self in nanoseconds. public var nanoseconds: UInt64 { switch self { case .seconds(let sec): return UInt64(sec) * NSEC_PER_SEC case .milliseconds(let msec): return UInt64(msec) * NSEC_PER_MSEC case .microseconds(let usec): return UInt64(usec) * NSEC_PER_USEC case .nanoseconds(let nsec): return UInt64(nsec) case .never: return 0 @unknown default: return 0 } } }