feat: add VZVmnetNetworkDeviceAttachment support (macOS 26.0)
#205
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
norio-nomura
changed the title
VmnetNetworkDeviceAttachment support (macOS 26.0)VZVmnetNetworkDeviceAttachment support (macOS 26.0)
norio-nomura
force-pushed
the
feat-add-vmnet-network-device-attachment
branch
2 times, most recently
from
6617c8f to
6a1f741
Compare
norio-nomura
added a commit
to norio-nomura/lima
that referenced
this pull request
Nov 22, 2025
Based on `VMNET_SHARED_MODE`, and `VMNET_HOST_MODE` ```yaml networks: - vzShared: true - vzHost: true ``` But, to sharing network between multiple VMs, `VZVmnetNetworkDeviceAttachment` requires VMs are launched by same process. It depends on Code-Hex/vz#205 Signed-off-by: Norio Nomura <[email protected]>
AkihiroSuda
reviewed
Nov 22, 2025
| const ( | ||
| HostMode VmnetMode = C.VMNET_HOST_MODE | ||
| SharedMode VmnetMode = C.VMNET_SHARED_MODE | ||
| // Deprecated: BridgedMode is not supported by NewVmnetNetworkConfiguration |
Collaborator
There was a problem hiding this comment.
Do you know why not supported?
Contributor
Author
There was a problem hiding this comment.
I don't know. It's documented on:
https://developer.apple.com/documentation/vmnet/vmnet_network_configuration_create(_:_:)?language=objc
Parameters
mode
Shared mode or host-only mode.
|
This can be used by multiple processes like this:
|
`VZVmnetNetworkDeviceAttachment` does not require the `com.apple.vm.networking` entitlement nor root privileges. `HostMode` and `SharedMode` are supported. In order for multiple VMs to communicate with each other in SharedMode, they must be started in the same process and the same `VmnetNetwork` must be passed to `NewVmnetNetworkDeviceAttachment()` to create an attachment. Add: - `VmnetReturn`: - `ErrVmnetSuccess` - ... - `VmnetMode`: - `HostMode` - `SharedMode` - `BridgedMode`(definition only since not supported. marked as deprecated) - `VmnetNetworkConfiguration`: `NewVmnetNetworkConfiguration()`, The use of the instance method group is still unknown. Setting subnet seems to trigger disabling DHCP, etc. - `VmnetNetwork`: `NewVmnetNetwork()`, some APIs which using `xpc_object_t` are not implemented. - `VmnetNetworkDeviceAttachment`: `NewVmnetNetworkDeviceAttachment()` see: https://developer.apple.com/documentation/virtualization/vzvmnetnetworkdeviceattachment?language=objc change `MACAddress.EthernetAddress()` to `MACAddress.ethernetAddress()` to avoid export C type from Go Signed-off-by: Norio Nomura <[email protected]>
Add: - `TestVmnetSharedModeAllowsCommunicationBetweenMultipleVMs()` - `Container.DetectIPv4()` Move `Container.exec()` from `shared_directory_arm64_test.go` to `virtualization_test.go` Signed-off-by: Norio Nomura <[email protected]>
Signed-off-by: Norio Nomura <[email protected]>
norio-nomura
force-pushed
the
feat-add-vmnet-network-device-attachment
branch
from
5a7a116 to
72cc1d4
Compare
Contributor
Author
In this procedure, I confirmed that VMs launched from multiple processes can share networks with each other. 👍🏻 |
Signed-off-by: Norio Nomura <[email protected]> Stop using CFTypeRef Signed-off-by: Norio Nomura <[email protected]>
change `VmnetNetworkConfiguration.SetIPv4Subnet()` Signed-off-by: Norio Nomura <[email protected]>
norio-nomura
force-pushed
the
feat-add-vmnet-network-device-attachment
branch
from
72cc1d4 to
9506cbd
Compare
Contributor
Author
Added unit test and |
Contributor
Author
I'll try this added xpc package with lima to make it work. Until then, it's a draft. |
norio-nomura
force-pushed
the
feat-add-vmnet-network-device-attachment
branch
5 times, most recently
from
7bf24c1 to
007c2a5
Compare
norio-nomura
added a commit
to norio-nomura/lima
that referenced
this pull request
Dec 3, 2025
Based on `VMNET_SHARED_MODE`, and `VMNET_HOST_MODE` ```yaml networks: - vzShared: true - vzHost: true ``` But, to sharing network between multiple VMs, `VZVmnetNetworkDeviceAttachment` requires VMs are launched by same process. It depends on Code-Hex/vz#205 Signed-off-by: Norio Nomura <[email protected]>
norio-nomura
force-pushed
the
feat-add-vmnet-network-device-attachment
branch
from
007c2a5 to
aba95bd
Compare
- Add `TestVmnetNetworkShareModeSharingOverXpc` to `vmnet_test.go` `TestVmnetNetworkShareModeSharingOverXpc` tests sharing `VmnetNetwork` in `SharedMode` over XPC communication. This test registers test executable as an Mach service and launches it using `launchctl`. The launched Mach service provides `VmnetNetwork` serialization to clients upon request, after booting a VM using the provided `VmnetNetwork` to ensure the network is functional on the server side. The client boots VM using the provided `VmnetNetwork` serialization. This test uses `pkg/xpc` package to implement XPC communication. - Add `pkg/xpc` package that providing `<xpc/xpc.h>` APIs to support implementing Mach service server and client Signed-off-by: Norio Nomura <[email protected]>
norio-nomura
force-pushed
the
feat-add-vmnet-network-device-attachment
branch
from
aba95bd to
ba619f5
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
feat: add
VZVmnetNetworkDeviceAttachmentsupport (macOS 26.0)VmnetNetworkDeviceAttachmentdoes not require thecom.apple.vm.networkingentitlement nor root privileges.HostModeandSharedModeare supported.In order for multiple VMs to communicate with each other in SharedMode, they must be started in the same process and the same
VmnetNetworkmust be passed toNewVmnetNetworkDeviceAttachment()to create an attachment.Add:
VmnetReturn:ErrVmnetSuccessVmnetMode:HostModeSharedModeBridgedMode(definition only since not supported. marked as deprecated)VmnetNetworkConfiguration:NewVmnetNetworkConfiguration(),The use of the instance method group is still unknown. Setting subnet seems to trigger disabling DHCP, etc.
VmnetNetwork:NewVmnetNetwork(), some APIs which usingxpc_object_tare not implemented.VmnetNetworkDeviceAttachment:NewVmnetNetworkDeviceAttachment()see: https://developer.apple.com/documentation/virtualization/vzvmnetnetworkdeviceattachment?language=objc
Which issue(s) this PR fixes:
Mentioned in #198 (comment)