mirror of
https://github.com/apple/container.git
synced 2026-07-13 13:07:06 +00:00
c909cb3a27
- Closes #752. - Currently, there is no way to specify a custom MAC address for a container's network interface and the MAC address is auto-generated by the system. - Use Cases - **Network Testing**: Developers testing network-dependent applications that need predictable MAC addresses - **License Management**: Running containerized software with MAC-based license keys - **Network Automation**: Scripts and tools that expect specific MAC addresses for configuration - **Debugging**: Consistent MAC addresses across container restarts for easier troubleshooting
50 lines
2.1 KiB
Swift
50 lines
2.1 KiB
Swift
//===----------------------------------------------------------------------===//
|
|
// Copyright © 2025 Apple Inc. and the container project authors.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// https://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
import ContainerNetworkService
|
|
import ContainerSandboxService
|
|
import ContainerXPC
|
|
import Containerization
|
|
import ContainerizationError
|
|
import Logging
|
|
import Virtualization
|
|
import vmnet
|
|
|
|
/// Interface strategy for containers that use macOS's custom network feature.
|
|
@available(macOS 26, *)
|
|
struct NonisolatedInterfaceStrategy: InterfaceStrategy {
|
|
private let log: Logger
|
|
|
|
public init(log: Logger) {
|
|
self.log = log
|
|
}
|
|
|
|
public func toInterface(attachment: Attachment, interfaceIndex: Int, additionalData: XPCMessage?) throws -> Interface {
|
|
guard let additionalData else {
|
|
throw ContainerizationError(.invalidState, message: "network state does not contain custom network reference")
|
|
}
|
|
|
|
var status: vmnet_return_t = .VMNET_SUCCESS
|
|
guard let networkRef = vmnet_network_create_with_serialization(additionalData.underlying, &status) else {
|
|
throw ContainerizationError(.invalidState, message: "cannot deserialize custom network reference, status \(status)")
|
|
}
|
|
|
|
log.info("creating NATNetworkInterface with network reference")
|
|
let gateway = interfaceIndex == 0 ? attachment.gateway : nil
|
|
return NATNetworkInterface(address: attachment.address, gateway: gateway, reference: networkRef, macAddress: attachment.macAddress)
|
|
}
|
|
}
|