Apple-2-Tools/ample
1
0
Fork 0
mirror of https://github.com/ksherlock/ample.git synced 2024-06-01 16:41:35 +00:00
Code Issues Projects Releases Wiki Activity

Created Networking (markdown)

ksherlock 2023-05-01 10:18:09 -04:00
parent 7b87d2feae
commit 1a0229ce71
1 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
Networking.md Normal file

@ -0,0 +1,17 @@
Ample uses the [vmnet.framework](https://developer.apple.com/documentation/vmnet) for networking. Think of it as a virtual ethernet device, DHCP server, DNS server, and router. There are a few limitations to keep in mind:
* vmnet requires an unobtainable (app-store only?) entitlement. Or root access. Since Ample isn't in the app store, we need the second option. Specifically, there is a helper app (vmnet_helper) that runs as root. In Ample preferences, you will need to click the button to "fix the permissions" before it will work. (upgrading Ample wipes out the permissions so it needs to be done after every upgrade as well). "Fixing permissions" is essentially "sudo chown root vmnet_helper && sudo chmod +s vmnet_helper".
* DHCP is required. vmnet has packet filters in place to block most activity until a DHCP connection is established.
* On the MacOS side, vmnet is `bridge100` for wireshark, ifconfig, etc purposes.
* DHCP will assign an address in the 192.168.64.xx range, with 1921.68.64.1 as the gateway, DNS, DHCP server.
* Your macintosh can be accessed as 192.168.64.1. Other IP addresses usually work (eg, if your wifi is 192.168.1.234) but some software may not like that. VEDrive, for example, compares the UDP source IP Address so only 192.168.64.1 will work.
* vmnet re-uses parts of the Mac Internet Sharing (MIS). When both are in use, I have seen the DHCP server stop working for MIS. Turning MIS off and back on might resolve it.