acrn-hypervisor

History

yuhong.tao@intel.com 53ecd932ad Tools: acrn-manager: add definitions of message sturcts We define messages into three types, accroding to which component is responsible to handle it: 1. message handled by sos lifecycle service, from vm manager; 2. message handled by vm manager, from sos lifecycle service&dm; 3. message handled by dm, from vm manager. Reviewed-by: Kaige Fu <kaige.fu@intel.com> Reviewed-by: Geoffroy Van Cutsem <geoffroy.vancutsem@intel.com> Reviewed-by: Kevin Tian <kevin.tian@intel.com> Reviewed-by: Wang, Yu <yu1.wang@intel.com> signed-off-by: Yan Like <like.yan@intel.com> Signed-off-by: Tao Yuhong <yuhong.tao@intel.com>		2018-05-31 11:25:47 +08:00
..
Makefile	Tools: acrn-manager: add lib with IPC helpers	2018-05-31 11:25:47 +08:00
README.rst	doc: fix tools docs formatting and clarity	2018-05-30 10:36:31 -07:00
acrn_mngr.c	Tools: acrn-manager: add lib with IPC helpers	2018-05-31 11:25:47 +08:00
acrn_mngr.h	Tools: acrn-manager: add definitions of message sturcts	2018-05-31 11:25:47 +08:00
acrnctl.c	tools: acrnctl: Properly null-terminate cmd_out and buf	2018-05-29 14:13:20 +08:00

README.rst

.. _acrnctl:

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:

.. code-block:: none

   # acrnctl help
   support:
     list
     start
     stop
     del
     add
   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``:

.. code-block:: none

   # 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.

Delete VMs
==========

Use the ``delete`` command with a VM name to delete that VM:

.. code-block:: none

   # acrnctl del vm1-14:59:30

List VMs
========

Use the ``list`` command to display VMs and their state:

.. code-block:: none

   # 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:

.. code-block:: none

   # acrnctl start vm-yocto

Stop VM
=======

Use the ``stop`` command to stop one or more running VM:

.. code-block:: none

   # 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:

.. code-block:: none

   # make
   # make install