acrnctl and acrnd¶
acrnctl tool helps users create, delete, launch, and stop a User
OS (UOS). The tool runs under the Service OS, and UOSs should be based
acrn-dm. The daemon for acrn-manager is acrnd.
You can see the available
acrnctl commands by running:
# acrnctl help
Use acrnctl [cmd] help for details
Here are some usage examples:
Add a VM¶
add command lets you add a VM by specifying a
script that will launch a UOS, for example
# acrnctl add launch_UOS.sh -U 1
Note that the launch script must only launch one UOS instance.
The VM name is important.
acrnctl searches VMs by their
names so duplicate VM names are not allowed. If the
launch script changes the VM name at launch time,
will not recognize it.
delete command with a VM name to delete that VM:
# acrnctl del vm1-14:59:30
list command to display VMs and their state:
# acrnctl list
If a VM is in a
stopped state, you can start it with the
# acrnctl start vm-yocto
stop command to stop one or more running VM:
# acrnctl stop vm-yocto vm1-14:59:30 vm-android
acrnd daemon process provides a way for launching or resuming a UOS
should the UOS shut down, either planned or unexpected. A UOS can ask
to set up a timer to make sure the UOS is running, even if the SOS is
suspended or stopped.
acrnd daemon stores pending UOS work to
and sets an RTC timer to wake up the SOS or bring the SOS back up again.
acrnd daemon is restarted, it restores the previously saved timer
list and launches the UOSs at the right time.
systemd service file (
acrnd.service) is installed by default that will
acrnd daemon when the Service OS comes up.
You can restart/stop acrnd service using
Build and Install¶
Source code for both
acrnd is in the
Change to that folder and run:
# make install