acrn-hypervisor

History

yuhong.tao@intel.com bd24e2de74 tools: acrnctl fix potential buffer overflow When run 'acrnctl add', acrnctl dryruns launch script to get vmname. Acrnctl assumes there are no more than 64 words in each line of the script, and creates a buffer to hold 64 pointers to these words. But we didn't check if the number of words exceed 64 limitation, which can lead to buffer overflow. This commit fixed this potential overflow problem. And also refine some confusing error messages in 'acrnctl add' Tracked-On: #2734 Acked-by: Yan Like <like.yan@intel.com> Signed-off-by: Tao Yuhong <yuhong.tao@intel.com> Reviewed-by: Yonghua Huang <yonghua.huang@intel.com>		2019-03-13 10:21:59 +08:00
..
Makefile	Makefile: undefine _FORTIFY_SOURCE prior using it	2019-02-28 11:56:45 +08:00
README.rst	tools: acrn-manager: change path of vm conf files	2018-12-13 09:09:41 +08:00
acrn_mngr.c	tools: acrn-manager: Replace pdebug with explicit err msg	2019-03-12 09:28:46 +08:00
acrn_mngr.h	tools: acrn-manager: Replace pdebug with explicit err msg	2019-03-12 09:28:46 +08:00
acrn_vm_ops.c	tools: acrn-manager: fix a race condition on updating VM state	2019-03-12 09:28:46 +08:00
acrnctl.c	tools: acrnctl fix potential buffer overflow	2019-03-13 10:21:59 +08:00
acrnctl.h	tools: acrn-manager: fix a race condition on updating VM state	2019-03-12 09:28:46 +08:00
acrnd.c	tools: acrnd: Fix launch UOS by timer list without fork()	2019-03-12 09:28:46 +08:00
acrnd.service	capture acrnd AaaG booting messages to journald	2018-11-08 15:14:15 +08:00

README.rst

.. _acrnctl:

acrnctl and acrnd
#################


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``. The daemon for acrn-manager is `acrnd`_.



Usage
*****

You can see the available ``acrnctl`` commands by running:

.. code-block:: none

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

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

.. _acrnd:

acrnd
*****

The ``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 ``acrnd``
to set up a timer to make sure the UOS is running, even if the SOS is
suspended or stopped.
The ``acrnd`` daemon stores pending UOS work to ``/usr/share/acrn/conf/timer_list``
and sets an RTC timer to wake up the SOS or bring the SOS back up again.
When ``acrnd`` daemon is restarted, it restores the previously saved timer
list and launches the UOSs at the right time.

A ``systemd`` service file (``acrnd.service``) is installed by default that will
start the ``acrnd`` daemon when the Service OS comes up.
You can restart/stop acrnd service using ``systemctl``

Build and Install
*****************

Source code for both ``acrnctl`` and ``acrnd`` is in the ``tools/acrn-manager`` folder.
Change to that folder and run:

.. code-block:: none

   # make
   # make install