VZMacAuxiliaryStorage
An object that contains information the boot loader needs for booting macOS as a guest operating system.
Declaration
class VZMacAuxiliaryStorageMentioned in
Overview
The Mac auxiliary storage contains data used by the boot loader and the guest operating system. It’s necessary to boot a macOS guest OS.
When creating a new VM, use init(creatingStorageAt:hardwareModel:options:) to create a default initialized auxiliary storage.
The hardware model you use when creating the new auxiliary storage depends on the restore image that you’ll use for installation. From the restore image, use mostFeaturefulSupportedConfiguration to get a supported configuration. A configuration has a VZMacHardwareModel associated with it.
After initializing the new auxiliary storage, set it on VZMacPlatformConfiguration.auxiliaryStorage.
The hardware model in VZMacPlatformConfiguration.hardwareModel must be identical to the one used to create the empty auxiliary storage., otherwise the behavior isn’t defined.
When installing macOS, the VZMacOSInstaller lays out data on the auxiliary storage. After installation, the macOS guest uses the auxiliary storage for every subsequent boot.
When moving or performing a backup of a VM, you must move or copy the file containing the auxiliary storage along with the main disk image.
To boot a VM created with VZMacOSInstaller, use init(contentsOfURL:) to set up the auxiliary storage from the existing file used during installation.
When using an existing file, the hardware model of the VZMacPlatformConfiguration.hardwareModel must match the hardware model used when creating the original file.
Topics
Creating the auxiliary storage
init(contentsOfURL:)init(url:)init(creatingStorageAt:hardwareModel:options:)VZMacAuxiliaryStorage.InitializationOptions