OC4VM Tools

OC4VM Tools

OC4VM - Guest Tools

The OpenCore boot disk contains some useful tools to provide information about the macOS guest. These tools are rarely needed but can be useful for diagnosing guest issues.

The OC4VM boot drive should be mounted at in the macOS guest:

/Volumes/OPENCORE

and the tools are found at:

/Volumes/OPENCORE/OC4VM/tools/guest

---

diskzero

The diskzero tool is used to recover unused disk space from the virtual drive. This is the first step and zeros out all free space on the main Data volume. (See diskshrink.)

Usage: diskzero.zsh

---

diskshrink

The diskshrink tool is used to recover unused disk space from the virtual drive. This is the second step and instriucts VMware to recover the zero filled space. (See diskzero.)

Usage: diskshrink.zsh

---

cloak/uncloak

The clock/unclock tool toggles macOS ability to see the VMM bit. When cloaked the VMM bit is off and macOS thinks it is running on a real Mac when used in conjuction with the spoof tool. Important system processes such as macOS installers and updaters still see the VMM bit which avoids bad updates. (See spoof.)

Usage: (un)cloak.zsh

---

cpuid

This program dumps the guests CPUID data which is used for debugging certain issues within the guest. The cpuid utility has many parameters but the recommended options are these:

Usage: cpuid -d -c0

---

sysinfo

Use this tool if you have spoofed a real Mac and want to check the details in the guest. It will show the settings and NVRAM variables that are set when imitation a real Mac such as serial number, ROM, MLB etc..

Usage: sysinfo.zsh

OC4VM - Host Tools

There are also tools located in the distribution package which are for use on the host machine to modify the VMware VMX file. The host tools are located in the folder:

<installation_path>/tools/<linux/macos/windows>

where there is a folder for each host operating system.

---

macguest

VMware Workstation does not allow the selection of the macOS Guest types in the user interface. This small program allows a VMX file to be opened and the version of macOS selected and written back to the file.

There are two separate versions one for Windows and another for Linux. This is not needed on VMware Fusion as the product allows selection of macOS guests directly.

The Windows version is a small executable created in PowerShell. Run macguest.exe program and select the VMX file to modify.

The Linux version provides a shell script to update the geustOS setting. It should be run from

<installation_path>/tools/linux

You can pass in a VMX file via the command parameters or select a file to work on from the menu.

Usage: macguest.sh [OPTIONS]

Options:
  -f, --file PATH    Specify VMX file path (bypasses file selector)
  -h, --help         Show this help message

Example:
  macguest.sh -f ~/VMs/macos.vmx

---

spoof

This tool allows the guest to mimic an iMac 2019 (iMac19,2). There are 2 versions command line tool available in tools/<host_os_name>:

• spoof.sh - Linux and macOS
• spoof.ps1 - Windows PowerShell

Usage: spoof.sh or spoof.ps1 path_to_vmx_file

The tool will show you the settings being set and write them to the specified VMX file. For more details see Spoofing A Real Mac.