acrnctl¶
Description¶
The 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
on acrn-dm
.
Usage¶
You can see the available acrnctl
commands by running:
# acrnctl help
support:
list
start
stop
del
add
pause
continue
suspend
resume
reset
Use acrnctl [cmd] help for details
Here are some usage examples:
Add a VM¶
The add
command lets you add a VM by specifying a
script that will launch a UOS, for example launch_UOS.sh
:
# acrnctl add launch_UOS.sh -U 1
vm1-14:59:30 added
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, acrnctl
will not recognize it.
List VMs¶
Use the list
command to display VMs and their state:
# acrnctl list
vm1-14:59:30 untracked
vm-yocto stopped
vm-android stopped
Start VM¶
If a VM is in a stopped
state, you can start it with the start
command:
# acrnctl start vm-yocto
Stop VM¶
Use the stop
command to stop one or more running VM:
# acrnctl stop vm-yocto vm1-14:59:30 vm-android
Build and Install¶
Source code for acrnctl
is in the tools/acrn-manager
folder.
Change to that folder and run:
# make
# make install