1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443
|
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftNIO open source project
//
// Copyright (c) 2020-2021 Apple Inc. and the SwiftNIO project authors
// Licensed under Apache License v2.0
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftNIO project authors
//
// SPDX-License-Identifier: Apache-2.0
//
//===----------------------------------------------------------------------===//
#if os(Windows)
import ucrt
import let WinSDK.IPPROTO_IP
import let WinSDK.IPPROTO_IPV6
import let WinSDK.IPPROTO_TCP
import let WinSDK.IP_ADD_MEMBERSHIP
import let WinSDK.IP_DROP_MEMBERSHIP
import let WinSDK.IP_HDRINCL
import let WinSDK.IP_MULTICAST_IF
import let WinSDK.IP_MULTICAST_LOOP
import let WinSDK.IP_MULTICAST_TTL
import let WinSDK.IPV6_JOIN_GROUP
import let WinSDK.IPV6_LEAVE_GROUP
import let WinSDK.IPV6_MULTICAST_HOPS
import let WinSDK.IPV6_MULTICAST_IF
import let WinSDK.IPV6_MULTICAST_LOOP
import let WinSDK.IPV6_V6ONLY
import let WinSDK.AF_INET
import let WinSDK.AF_INET6
import let WinSDK.AF_UNIX
import let WinSDK.PF_INET
import let WinSDK.PF_INET6
import let WinSDK.PF_UNIX
import let WinSDK.SO_ERROR
import let WinSDK.SO_KEEPALIVE
import let WinSDK.SO_LINGER
import let WinSDK.SO_RCVBUF
import let WinSDK.SO_RCVTIMEO
import let WinSDK.SO_REUSEADDR
import let WinSDK.SOL_SOCKET
import let WinSDK.TCP_NODELAY
import struct WinSDK.SOCKET
import func WinSDK.inet_ntop
import func WinSDK.inet_pton
import func WinSDK.GetLastError
import func WinSDK.WSAGetLastError
internal typealias socklen_t = ucrt.size_t
#elseif os(Linux) || os(Android)
#if canImport(Glibc)
import Glibc
#elseif canImport(Musl)
import Musl
#endif
import CNIOLinux
#if os(Android)
private let sysInet_ntop: @convention(c) (CInt, UnsafeRawPointer, UnsafeMutablePointer<CChar>, socklen_t) -> UnsafePointer<CChar>? = inet_ntop
private let sysInet_pton: @convention(c) (CInt, UnsafePointer<CChar>, UnsafeMutableRawPointer) -> CInt = inet_pton
#else
private let sysInet_ntop: @convention(c) (CInt, UnsafeRawPointer?, UnsafeMutablePointer<CChar>?, socklen_t) -> UnsafePointer<CChar>? = inet_ntop
private let sysInet_pton: @convention(c) (CInt, UnsafePointer<CChar>?, UnsafeMutableRawPointer?) -> CInt = inet_pton
#endif
#elseif canImport(Darwin)
import Darwin
private let sysInet_ntop: @convention(c) (CInt, UnsafeRawPointer?, UnsafeMutablePointer<CChar>?, socklen_t) -> UnsafePointer<CChar>? = inet_ntop
private let sysInet_pton: @convention(c) (CInt, UnsafePointer<CChar>?, UnsafeMutableRawPointer?) -> CInt = inet_pton
#else
#error("The BSD Socket module was unable to identify your C library.")
#endif
#if os(Android)
let IFF_BROADCAST: CUnsignedInt = numericCast(SwiftGlibc.IFF_BROADCAST.rawValue)
let IFF_POINTOPOINT: CUnsignedInt = numericCast(SwiftGlibc.IFF_POINTOPOINT.rawValue)
let IFF_MULTICAST: CUnsignedInt = numericCast(SwiftGlibc.IFF_MULTICAST.rawValue)
#if arch(arm)
let SO_RCVTIMEO = SO_RCVTIMEO_OLD
let SO_TIMESTAMP = SO_TIMESTAMP_OLD
#endif
#elseif os(Linux)
// Work around SO_TIMESTAMP/SO_RCVTIMEO being awkwardly defined in glibc.
let SO_TIMESTAMP = CNIOLinux_SO_TIMESTAMP
let SO_RCVTIMEO = CNIOLinux_SO_RCVTIMEO
#endif
public enum NIOBSDSocket {
#if os(Windows)
public typealias Handle = SOCKET
#else
public typealias Handle = CInt
#endif
}
extension NIOBSDSocket {
/// Specifies the addressing scheme that the socket can use.
public struct AddressFamily: RawRepresentable, Sendable {
public typealias RawValue = CInt
public var rawValue: RawValue
public init(rawValue: RawValue) {
self.rawValue = rawValue
}
}
}
extension NIOBSDSocket.AddressFamily: Equatable {
}
extension NIOBSDSocket.AddressFamily: Hashable {
}
extension NIOBSDSocket {
/// Specifies the type of protocol that the socket can use.
public struct ProtocolFamily: RawRepresentable, Sendable {
public typealias RawValue = CInt
public var rawValue: RawValue
public init(rawValue: RawValue) {
self.rawValue = rawValue
}
}
}
extension NIOBSDSocket.ProtocolFamily: Equatable {
}
extension NIOBSDSocket.ProtocolFamily: Hashable {
}
extension NIOBSDSocket {
/// Defines socket option levels.
public struct OptionLevel: RawRepresentable, Sendable {
public typealias RawValue = CInt
public var rawValue: RawValue
public init(rawValue: RawValue) {
self.rawValue = rawValue
}
}
}
extension NIOBSDSocket.OptionLevel: Equatable {
}
extension NIOBSDSocket.OptionLevel: Hashable {
}
extension NIOBSDSocket {
/// Defines configuration option names.
public struct Option: RawRepresentable, Sendable {
public typealias RawValue = CInt
public var rawValue: RawValue
public init(rawValue: RawValue) {
self.rawValue = rawValue
}
}
}
extension NIOBSDSocket.Option: Equatable {
}
extension NIOBSDSocket.Option: Hashable {
}
// Address Family
extension NIOBSDSocket.AddressFamily {
/// Address for IP version 4.
public static let inet: NIOBSDSocket.AddressFamily =
NIOBSDSocket.AddressFamily(rawValue: AF_INET)
/// Address for IP version 6.
public static let inet6: NIOBSDSocket.AddressFamily =
NIOBSDSocket.AddressFamily(rawValue: AF_INET6)
/// Unix local to host address.
public static let unix: NIOBSDSocket.AddressFamily =
NIOBSDSocket.AddressFamily(rawValue: AF_UNIX)
}
// Protocol Family
extension NIOBSDSocket.ProtocolFamily {
/// IP network 4 protocol.
public static let inet: NIOBSDSocket.ProtocolFamily =
NIOBSDSocket.ProtocolFamily(rawValue: PF_INET)
/// IP network 6 protocol.
public static let inet6: NIOBSDSocket.ProtocolFamily =
NIOBSDSocket.ProtocolFamily(rawValue: PF_INET6)
/// UNIX local to the host.
public static let unix: NIOBSDSocket.ProtocolFamily =
NIOBSDSocket.ProtocolFamily(rawValue: PF_UNIX)
}
#if !os(Windows)
extension NIOBSDSocket.ProtocolFamily {
/// UNIX local to the host, alias for `PF_UNIX` (`.unix`)
public static let local: NIOBSDSocket.ProtocolFamily =
NIOBSDSocket.ProtocolFamily(rawValue: PF_LOCAL)
}
#endif
// Option Level
extension NIOBSDSocket.OptionLevel {
/// Socket options that apply only to IP sockets.
#if os(Linux) || os(Android)
public static let ip: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: CInt(IPPROTO_IP))
#else
public static let ip: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: IPPROTO_IP)
#endif
/// Socket options that apply only to IPv6 sockets.
#if os(Linux) || os(Android)
public static let ipv6: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: CInt(IPPROTO_IPV6))
#elseif os(Windows)
public static let ipv6: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: IPPROTO_IPV6.rawValue)
#else
public static let ipv6: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: IPPROTO_IPV6)
#endif
/// Socket options that apply only to TCP sockets.
#if os(Linux) || os(Android)
public static let tcp: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: CInt(IPPROTO_TCP))
#elseif os(Windows)
public static let tcp: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: IPPROTO_TCP.rawValue)
#else
public static let tcp: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: IPPROTO_TCP)
#endif
/// Socket options that apply to MPTCP sockets.
///
/// These only work on Linux currently.
public static let mptcp = NIOBSDSocket.OptionLevel(rawValue: 284)
/// Socket options that apply to all sockets.
public static let socket: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: SOL_SOCKET)
/// Socket options that apply only to UDP sockets.
#if os(Linux) || os(Android)
public static let udp: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: CInt(IPPROTO_UDP))
#else
public static let udp: NIOBSDSocket.OptionLevel =
NIOBSDSocket.OptionLevel(rawValue: IPPROTO_UDP)
#endif
}
// IPv4 Options
extension NIOBSDSocket.Option {
/// Add a multicast group membership.
public static let ip_add_membership: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IP_ADD_MEMBERSHIP)
/// Drop a multicast group membership.
public static let ip_drop_membership: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IP_DROP_MEMBERSHIP)
/// Set the interface for outgoing multicast packets.
public static let ip_multicast_if: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IP_MULTICAST_IF)
/// Control multicast loopback.
public static let ip_multicast_loop: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IP_MULTICAST_LOOP)
/// Control multicast time-to-live.
public static let ip_multicast_ttl: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IP_MULTICAST_TTL)
/// The IPv4 layer generates an IP header when sending a packet
/// unless the ``ip_hdrincl`` socket option is enabled on the socket.
/// When it is enabled, the packet must contain an IP header. For
/// receiving, the IP header is always included in the packet.
public static let ip_hdrincl: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IP_HDRINCL)
}
// IPv6 Options
extension NIOBSDSocket.Option {
/// Add an IPv6 group membership.
public static let ipv6_join_group: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IPV6_JOIN_GROUP)
/// Drop an IPv6 group membership.
public static let ipv6_leave_group: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IPV6_LEAVE_GROUP)
/// Specify the maximum number of router hops for an IPv6 packet.
public static let ipv6_multicast_hops: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IPV6_MULTICAST_HOPS)
/// Set the interface for outgoing multicast packets.
public static let ipv6_multicast_if: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IPV6_MULTICAST_IF)
/// Control multicast loopback.
public static let ipv6_multicast_loop: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IPV6_MULTICAST_LOOP)
/// Indicates if a socket created for the `AF_INET6` address family is
/// restricted to IPv6 only.
public static let ipv6_v6only: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: IPV6_V6ONLY)
}
// TCP Options
extension NIOBSDSocket.Option {
/// Disables the Nagle algorithm for send coalescing.
public static let tcp_nodelay: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: TCP_NODELAY)
}
#if os(Linux) || os(FreeBSD) || os(Android)
extension NIOBSDSocket.Option {
/// Get information about the TCP connection.
public static let tcp_info: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: TCP_INFO)
}
#endif
#if canImport(Darwin)
extension NIOBSDSocket.Option {
/// Get information about the TCP connection.
public static let tcp_connection_info: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: TCP_CONNECTION_INFO)
}
#endif
#if os(Linux)
extension NIOBSDSocket.Option {
// Note: UDP_SEGMENT and UDP_GRO are not available on all Linux platforms so values are
// hardcoded.
/// Use UDP segmentation offload (UDP_SEGMENT, or 'GSO'). Only available on Linux.
public static let udp_segment = NIOBSDSocket.Option(rawValue: 103)
/// Use UDP generic receive offload (GRO). Only available on Linux.
public static let udp_gro = NIOBSDSocket.Option(rawValue: 104)
}
#endif
// MPTCP options
//
// These values are hardcoded as they're fairly new, and not available in all
// header files yet.
extension NIOBSDSocket.Option {
/// Get info about an MPTCP connection
public static let mptcp_info = NIOBSDSocket.Option(rawValue: 1)
}
// Socket Options
extension NIOBSDSocket.Option {
/// Get the error status and clear.
public static let so_error = Self(rawValue: SO_ERROR)
/// Use keep-alives.
public static let so_keepalive = Self(rawValue: SO_KEEPALIVE)
/// Linger on close if unsent data is present.
public static let so_linger = Self(rawValue: SO_LINGER)
/// Specifies the total per-socket buffer space reserved for receives.
public static let so_rcvbuf = Self(rawValue: SO_RCVBUF)
/// Specifies the receive timeout.
public static let so_rcvtimeo = Self(rawValue: SO_RCVTIMEO)
/// Allows the socket to be bound to an address that is already in use.
public static let so_reuseaddr = Self(rawValue: SO_REUSEADDR)
/// Allows the socket to send broadcast messages.
public static let so_broadcast = Self(rawValue: SO_BROADCAST)
}
#if !os(Windows)
extension NIOBSDSocket.Option {
/// Indicate when to generate timestamps.
public static let so_timestamp: NIOBSDSocket.Option =
NIOBSDSocket.Option(rawValue: SO_TIMESTAMP)
}
#endif
extension NIOBSDSocket {
// Sadly this was defined on BSDSocket, and we need it for SocketAddress.
@inline(never)
internal static func inet_pton(addressFamily: NIOBSDSocket.AddressFamily, addressDescription: UnsafePointer<CChar>, address: UnsafeMutableRawPointer) throws {
#if os(Windows)
// TODO(compnerd) use `InetPtonW` to ensure that we handle unicode properly
switch WinSDK.inet_pton(addressFamily.rawValue, addressDescription, address) {
case 0: throw IOError(errnoCode: EINVAL, reason: "inet_pton")
case 1: return
default: throw IOError(winsock: WSAGetLastError(), reason: "inet_pton")
}
#else
switch sysInet_pton(CInt(addressFamily.rawValue), addressDescription, address) {
case 0: throw IOError(errnoCode: EINVAL, reason: #function)
case 1: return
default: throw IOError(errnoCode: errno, reason: #function)
}
#endif
}
@discardableResult
@inline(never)
internal static func inet_ntop(addressFamily: NIOBSDSocket.AddressFamily, addressBytes: UnsafeRawPointer, addressDescription: UnsafeMutablePointer<CChar>, addressDescriptionLength: socklen_t) throws -> UnsafePointer<CChar> {
#if os(Windows)
// TODO(compnerd) use `InetNtopW` to ensure that we handle unicode properly
guard let result = WinSDK.inet_ntop(addressFamily.rawValue, addressBytes,
addressDescription,
Int(addressDescriptionLength)) else {
throw IOError(windows: GetLastError(), reason: "inet_ntop")
}
return result
#else
switch sysInet_ntop(CInt(addressFamily.rawValue), addressBytes, addressDescription, addressDescriptionLength) {
case .none: throw IOError(errnoCode: errno, reason: #function)
case .some(let ptr): return ptr
}
#endif
}
}
|