-
Couldn't load subscription status.
- Fork 21
feat: Allow specifying vmnet network UUID to disable DHCP (on vmnet.h… #141
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
base: master
Are you sure you want to change the base?
Changes from all commits
88d975d
073e511
3c61140
b5df0fe
c305142
9750c51
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -12,27 +12,29 @@ Unlike `vde_vmnet`, `socket_vmnet` does not depend on VDE. | |
| <!-- START doctoc generated TOC please keep comment here to allow auto update --> | ||
| <!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE --> | ||
|
|
||
| - [Install](#install) | ||
| - [From binary](#from-binary) | ||
| - [From source](#from-source) | ||
| - [From Homebrew](#from-homebrew) | ||
| - [From MacPorts](#from-macports) | ||
| - [Usage](#usage) | ||
| - [QEMU](#qemu) | ||
| - [Lima](#lima) | ||
| - [Advanced usage](#advanced-usage) | ||
| - [Multi VM](#multi-vm) | ||
| - [Bridged mode](#bridged-mode) | ||
| - [FAQs](#faqs) | ||
| - [Why does `socket_vmnet` require root?](#why-does-socket_vmnet-require-root) | ||
| - [Is it possible to run `socket_vmnet` with SETUID?](#is-it-possible-to-run-socket_vmnet-with-setuid) | ||
| - [How is socket_vmnet related to vde_vmnet?](#how-is-socket_vmnet-related-to-vde_vmnet) | ||
| - [How is socket_vmnet related to QEMU-builtin vmnet support?](#how-is-socket_vmnet-related-to-qemu-builtin-vmnet-support) | ||
| - [How to use static IP addresses?](#how-to-use-static-ip-addresses) | ||
| - [How to reserve DHCP addresses?](#how-to-reserve-dhcp-addresses) | ||
| - [IP address is not assigned](#ip-address-is-not-assigned) | ||
| - [Links](#links) | ||
| - [Troubleshooting](#troubleshooting) | ||
| - [socket_vmnet: vmnet.framework support for rootless and VDE-less QEMU](#socket_vmnet-vmnetframework-support-for-rootless-and-vde-less-qemu) | ||
| - [Install](#install) | ||
| - [From binary](#from-binary) | ||
| - [From source](#from-source) | ||
| - [From Homebrew](#from-homebrew) | ||
| - [From MacPorts](#from-macports) | ||
| - [Usage](#usage) | ||
| - [QEMU](#qemu) | ||
| - [Lima](#lima) | ||
| - [Advanced usage](#advanced-usage) | ||
| - [Multi VM](#multi-vm) | ||
| - [Bridged mode](#bridged-mode) | ||
| - [FAQs](#faqs) | ||
| - [Why does `socket_vmnet` require root?](#why-does-socket_vmnet-require-root) | ||
| - [Is it possible to run `socket_vmnet` with SETUID?](#is-it-possible-to-run-socket_vmnet-with-setuid) | ||
| - [How is socket_vmnet related to vde_vmnet?](#how-is-socket_vmnet-related-to-vde_vmnet) | ||
| - [How is socket_vmnet related to QEMU-builtin vmnet support?](#how-is-socket_vmnet-related-to-qemu-builtin-vmnet-support) | ||
| - [How to use static IP addresses?](#how-to-use-static-ip-addresses) | ||
| - [How to reserve DHCP addresses?](#how-to-reserve-dhcp-addresses) | ||
| - [IP address is not assigned](#ip-address-is-not-assigned) | ||
| - [How to setup a vmnet host network without DHCP?](#how-to-setup-a-vmnet-host-network-without-dhcp) | ||
| - [Links](#links) | ||
| - [Troubleshooting](#troubleshooting) | ||
pallotron marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The new toc looks wrong. This was not part of the top before: And the rest of the options are over indented now. You should should be only: Maybe the instructions for running doctor are not correct, or you are running a different version? Lets separate the README.md change to another PR. We ned to find how to update the README.md without adding unwanted changes. |
||
| <!-- END doctoc generated TOC please keep comment here to allow auto update --> | ||
|
|
||
|
|
@@ -430,6 +432,17 @@ sudo /usr/libexec/ApplicationFirewall/socketfilterfw --add /usr/libexec/bootpd | |
| /usr/libexec/ApplicationFirewall/socketfilterfw --unblock /usr/libexec/bootpd | ||
| ``` | ||
|
|
||
| ### How to setup a vmnet host network without DHCP? | ||
|
|
||
| You may need to disable the vmnet framework's DHCP to: | ||
|
|
||
| - Create a host network where all VMs have static IPs. | ||
| - Run a custom DHCP server on one VM to assign IPs to others on the same network. | ||
|
|
||
| To disable the macOS DHCP you must use `--vmnet-mode=host` and provide a `--vmnet-network-idenfitier` UUID. | ||
| You **_must not_** provide `--vmnet-gateway`. That is the signal to Apple's vmnet.framework to enable MacOS DHCP. | ||
pallotron marked this conversation as resolved.
Show resolved
Hide resolved
|
||
| You can use `--vmnet-network-idenfitier=random` to get a random UUID assigned. | ||
pallotron marked this conversation as resolved.
Show resolved
Hide resolved
|
||
|
|
||
| ## Links | ||
|
|
||
| - https://developer.apple.com/documentation/vmnet | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -48,6 +48,12 @@ static void print_usage(const char *argv0) { | |
| "specified\n"); | ||
| printf("--vmnet-interface-id=UUID vmnet interface ID (default: " | ||
| "random)\n"); | ||
| printf("--vmnet-network-identifier=UUID vmnet network identifier (UUID string, \"random\", " | ||
| "or \"\")\n" | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. What is the meaning of empty string? There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. it was suggested in here but I had to abandon that PR because I messed it up :D (I am learning There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. The current code has this behavior: Good:
Bad:
|
||
| " When vmnet mode is \"host\" and --vmnet-gateway is " | ||
| "not set, the internal DHCP will be disabled.\n" | ||
| " (default: \"\")\n"); | ||
|
|
||
| printf("--vmnet-nat66-prefix=PREFIX:: The IPv6 prefix to use with " | ||
| "shared mode.\n"); | ||
| printf(" The prefix must be a ULA i.e. " | ||
|
|
@@ -72,6 +78,7 @@ enum { | |
| CLI_OPT_VMNET_MASK, | ||
| CLI_OPT_VMNET_INTERFACE_ID, | ||
| CLI_OPT_VMNET_NAT66_PREFIX, | ||
| CLI_OPT_VMNET_NETWORK_IDENTIFIER, | ||
| }; | ||
|
|
||
| struct cli_options *cli_options_parse(int argc, char *argv[]) { | ||
|
|
@@ -82,18 +89,19 @@ struct cli_options *cli_options_parse(int argc, char *argv[]) { | |
| } | ||
|
|
||
| const struct option longopts[] = { | ||
| {"socket-group", required_argument, NULL, CLI_OPT_SOCKET_GROUP }, | ||
| {"vmnet-mode", required_argument, NULL, CLI_OPT_VMNET_MODE }, | ||
| {"vmnet-interface", required_argument, NULL, CLI_OPT_VMNET_INTERFACE }, | ||
| {"vmnet-gateway", required_argument, NULL, CLI_OPT_VMNET_GATEWAY }, | ||
| {"vmnet-dhcp-end", required_argument, NULL, CLI_OPT_VMNET_DHCP_END }, | ||
| {"vmnet-mask", required_argument, NULL, CLI_OPT_VMNET_MASK }, | ||
| {"vmnet-interface-id", required_argument, NULL, CLI_OPT_VMNET_INTERFACE_ID}, | ||
| {"vmnet-nat66-prefix", required_argument, NULL, CLI_OPT_VMNET_NAT66_PREFIX}, | ||
| {"pidfile", required_argument, NULL, 'p' }, | ||
| {"help", no_argument, NULL, 'h' }, | ||
| {"version", no_argument, NULL, 'v' }, | ||
| {0, 0, 0, 0 }, | ||
| {"socket-group", required_argument, NULL, CLI_OPT_SOCKET_GROUP }, | ||
| {"vmnet-mode", required_argument, NULL, CLI_OPT_VMNET_MODE }, | ||
| {"vmnet-interface", required_argument, NULL, CLI_OPT_VMNET_INTERFACE }, | ||
| {"vmnet-gateway", required_argument, NULL, CLI_OPT_VMNET_GATEWAY }, | ||
| {"vmnet-dhcp-end", required_argument, NULL, CLI_OPT_VMNET_DHCP_END }, | ||
| {"vmnet-mask", required_argument, NULL, CLI_OPT_VMNET_MASK }, | ||
| {"vmnet-interface-id", required_argument, NULL, CLI_OPT_VMNET_INTERFACE_ID }, | ||
| {"vmnet-nat66-prefix", required_argument, NULL, CLI_OPT_VMNET_NAT66_PREFIX }, | ||
| {"vmnet-network-identifier", required_argument, NULL, CLI_OPT_VMNET_NETWORK_IDENTIFIER}, | ||
| {"pidfile", required_argument, NULL, 'p' }, | ||
| {"help", no_argument, NULL, 'h' }, | ||
| {"version", no_argument, NULL, 'v' }, | ||
| {0, 0, 0, 0 }, | ||
| }; | ||
| int opt = 0; | ||
| while ((opt = getopt_long(argc, argv, "hvp:", longopts, NULL)) != -1) { | ||
|
|
@@ -134,6 +142,16 @@ struct cli_options *cli_options_parse(int argc, char *argv[]) { | |
| case CLI_OPT_VMNET_NAT66_PREFIX: | ||
| res->vmnet_nat66_prefix = strdup(optarg); | ||
| break; | ||
| case CLI_OPT_VMNET_NETWORK_IDENTIFIER: | ||
| if (strcmp(optarg, "random") == 0) { | ||
| uuid_generate_random(res->vmnet_network_identifier); | ||
| } else if (strcmp(optarg, "") == 0) { | ||
| uuid_clear(res->vmnet_network_identifier); | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. This looks like invalid value, fail instead of trying to make it work. If this option is set, the user must provide a valid uuid. |
||
| } else if (uuid_parse(optarg, res->vmnet_network_identifier) < 0) { | ||
| ERRORF("Failed to parse UUID \"%s\"", optarg); | ||
| goto error; | ||
| } | ||
| break; | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Lets replace the section with: case CLI_OPT_VMNET_NETWORK_IDENTIFIER:
if (uuid_parse(optarg, res->vmnet_network_identifier) < 0) {
ERRORF("Failed to parse UUID \"%s\"", optarg);
goto error;
}
break; |
||
| case 'p': | ||
| res->pidfile = strdup(optarg); | ||
| break; | ||
|
|
@@ -191,7 +209,7 @@ struct cli_options *cli_options_parse(int argc, char *argv[]) { | |
| goto error; | ||
| } | ||
| if (res->vmnet_gateway == NULL) { | ||
| if (res->vmnet_mode != VMNET_BRIDGED_MODE) { | ||
| if (res->vmnet_mode != VMNET_BRIDGED_MODE && res->vmnet_mode != VMNET_HOST_MODE) { | ||
| WARN("--vmnet-gateway=IP should be explicitly specified to " | ||
| "avoid conflicting with other applications"); | ||
| } | ||
|
|
||
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -230,10 +230,23 @@ static interface_ref start(struct state *state, struct cli_options *cliopt) { | |
| INFOF("Using network interface \"%s\"", cliopt->vmnet_interface); | ||
| xpc_dictionary_set_string(dict, vmnet_shared_interface_name_key, cliopt->vmnet_interface); | ||
| } | ||
| if (cliopt->vmnet_gateway != NULL) { | ||
| xpc_dictionary_set_string(dict, vmnet_start_address_key, cliopt->vmnet_gateway); | ||
| xpc_dictionary_set_string(dict, vmnet_end_address_key, cliopt->vmnet_dhcp_end); | ||
| xpc_dictionary_set_string(dict, vmnet_subnet_mask_key, cliopt->vmnet_mask); | ||
|
|
||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. It will be better to keep the block setting the gateway address as is. vmnet docs do not mention that you must not use gateway address and network identifier together, and the purpose of the new flag is not to disable DHCP, but to expose additional vment option, that can be used to disable DHCP. |
||
| // no dhcp | ||
| if (cliopt->vmnet_mode == VMNET_HOST_MODE && cliopt->vmnet_gateway == NULL) { | ||
| if (!uuid_is_null(cliopt->vmnet_network_identifier)) { | ||
| xpc_dictionary_set_uuid(dict, vmnet_network_identifier_key, cliopt->vmnet_network_identifier); | ||
| uuid_string_t uuid_str; | ||
| uuid_unparse(cliopt->vmnet_network_identifier, uuid_str); | ||
| INFOF("Using network identifier \"%s\" and no vmnet gateway -> NO DHCP will be enabled on " | ||
| "this vmnet", | ||
| uuid_str); | ||
| } | ||
|
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Based on vmnet.h, vmnet_network_identifier_key can only be used in VMNET_HOST_MODE, but vment_start_address_key, vment_end_addres_key, and vment_subnet_mask are not mentioned. It makes sense that they should not be used together, since these are all DHCP options, and vmnet_network_identifier_key disables DHCP, but did you try vment_start_address_key together with the DHCP options? What is the outcome? Can this be useful to someone? If using both options can have some value, we should limit this option only when the DHCP option are not specified. If using both options is not useful, we should document this here to explain this limit. The vment.h header also mentions these options: All of these can be used only in vmnet_network_identifier_key is specified, so we if we provide this option, we should also provide the additional options. I know this may not be related to your use case of testing pre server, but socket_vment can be used or other purposes. |
||
| } else { | ||
| if (cliopt->vmnet_gateway != NULL) { | ||
| xpc_dictionary_set_string(dict, vmnet_start_address_key, cliopt->vmnet_gateway); | ||
| xpc_dictionary_set_string(dict, vmnet_end_address_key, cliopt->vmnet_dhcp_end); | ||
| xpc_dictionary_set_string(dict, vmnet_subnet_mask_key, cliopt->vmnet_mask); | ||
| } | ||
| } | ||
|
|
||
| xpc_dictionary_set_uuid(dict, vmnet_interface_id_key, cliopt->vmnet_interface_id); | ||
|
|
||
Uh oh!
There was an error while loading. Please reload this page.