tunnelkit/Sources/TunnelKitCore/IPv4Settings.swift

//
//  IPv4Settings.swift
//  TunnelKit
//
//  Created by Davide De Rosa on 5/19/19.
//  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 <http://www.gnu.org/licenses/>.
//

import Foundation

/// Encapsulates the IPv4 settings for the tunnel.
public struct IPv4Settings: Codable, Equatable, CustomStringConvertible {
    
    /// Represents an IPv4 route in the routing table.
    public struct Route: Codable, Hashable, CustomStringConvertible {
        
        /// The destination host or subnet.
        public let destination: String
        
        /// The address mask.
        public let mask: String
        
        /// The address of the gateway (falls back to global gateway).
        public let gateway: String?
        
        public init(_ destination: String, _ mask: String?, _ gateway: String?) {
            self.destination = destination
            self.mask = mask ?? "255.255.255.255"
            self.gateway = gateway
        }
        
        // MARK: CustomStringConvertible
        
        public var description: String {
            "{\(destination.maskedDescription)/\(mask) \(gateway?.maskedDescription ?? "*")}"
        }
    }
    
    /// The address.
    public let address: String
    
    /// The address mask.
    public let addressMask: String
    
    /// The address of the default gateway.
    public let defaultGateway: String
    
    /// The additional routes.
    @available(*, deprecated, message: "Store routes separately")
    public let routes: [Route]
    
    public init(address: String, addressMask: String, defaultGateway: String) {
        self.address = address
        self.addressMask = addressMask
        self.defaultGateway = defaultGateway
        self.routes = []
    }

    @available(*, deprecated, message: "Store routes separately")
    public init(address: String, addressMask: String, defaultGateway: String, routes: [Route]) {
        self.address = address
        self.addressMask = addressMask
        self.defaultGateway = defaultGateway
        self.routes = routes
    }
    
    // MARK: CustomStringConvertible
    
    public var description: String {
        "addr \(address.maskedDescription) netmask \(addressMask) gw \(defaultGateway.maskedDescription)"
    }
}