mirror of
https://github.com/projectacrn/acrn-hypervisor.git
synced 2025-06-29 16:58:10 +00:00
Project ACRN hypervisor
b1d2f8d931
In this module, the following functions are implemented: For uart channel of service VM, implement handlers for sync command, system shutdown request command, acked poweroff command, vm poweroff timeout command. The uart channel commands of service VM and related actions are described below: Command Actions --------------------------------------------------------------- sync Send acked sync command to uart in user VM ---------------------------------------------------------------- system shutdown If this request is valid, send request poweroff command to each connected user VM through uart, Enable message reseding. ---------------------------------------------------------------- acked poweroff Remove uart of user VM from command connection list, stop message polling, if connection list is empty, will wait for user VM status through check ACRN DM process instance, if all user VMs are shutdown, then shutdown service VM --------------------------------------------------------- ACK timeout If it is timeout of receiving poweroff ACK, the action is similar to acked poweroff. Ohterwise, just disable message reseding. --------------------------------------------------------- For uart channel of user VM, implement handlers for acked sync command, poweroff command, acked system shutdown request command, ACK timeout command. The uart channel commands of user VM and related actions are described below: Command Actions -------------------------------------------------------- acked sync Print log message -------------------------------------------------------- poweroff Disconnect uart channel, exit message polling, close unix domain socket, shutdown user VM -------------------------------------------------------- user VM shutdown Exit message polling, close unix domain socket, shutdown user VM -------------------------------------------------------- acked system Print log message shutdown request ------------------------------------------------------- ACK timeout Disconnect uart channel, exit message polling, close unix domain socket --------------------------------------------------------- For socket server in each VM, implement handler for system shutdown request. In user VM, forward this command to service VM through uart. In service VM, send poweroff command to each connected user VM through uart. Implement handler for user VM shutdown request in socket server of service VM, send user VM shutdown command to user VM which is specified in the user VM shutdown request message. v1-->v2: Add comments in c file and head file. v2-->v3: Update commit message about allow s5 command and update some log message. v3-->v4: Guest shutdown support. v4-->v5: Update command name. v5-->v6: Move uart channel operations into uart channel module. v6-->v7: Set resend requirement for some commands. Add ACK receiving timeout handler for user VM. v7-->v8: Update message reseding enable, this interface will be called before sending message. v8-->v9: Use strlen to calculate the length of string, this will be the parameter of send_message_by_uart. Tracked-On: #6652 Signed-off-by: Xiangyang Wu <xiangyang.wu@intel.com> Reviewed-by: fei1.li@intel.com |
||
|---|---|---|
| .github/ISSUE_TEMPLATE | ||
| devicemodel | ||
| doc | ||
| hypervisor | ||
| misc | ||
| .checkpatch.conf | ||
| .clang-format | ||
| .deb.conf | ||
| .gitignore | ||
| CODE_OF_CONDUCT.rst | ||
| CODEOWNERS | ||
| CONTRIBUTING.rst | ||
| LICENSE | ||
| Makefile | ||
| paths.make | ||
| README.rst | ||
| VERSION | ||
Project ACRN Embedded Hypervisor ################################ .. raw:: html <img src="doc/images/ACRN_Logo_PrimaryLockup_COLOR-300x300-1.png" height="175px" align="right"> The open source project ACRN defines a device hypervisor reference stack and an architecture for running multiple software subsystems, managed securely, on a consolidated system by means of a virtual machine manager. It also defines a reference framework implementation for virtual device emulation, called the "ACRN Device Model". The ACRN Hypervisor is a Type 1 reference hypervisor stack, running directly on the bare-metal hardware, and is suitable for a variety of IoT and embedded device solutions. The ACRN hypervisor addresses the gap that currently exists between datacenter hypervisors, and hard partitioning hypervisors. The ACRN hypervisor architecture partitions the system into different functional domains, with carefully selected guest OS sharing optimizations for IoT and embedded devices. .. start_include_here Community Support ***************** The Project ACRN Developer Community includes developers from member organizations and the general community all joining in the development of software within the project. Members contribute and discuss ideas, submit bugs and bug fixes. They also help those in need through the community's forums such as mailing lists and IRC channels. Anyone can join the developer community and the community is always willing to help its members and the User Community to get the most out of Project ACRN. Welcome to the project ARCN community! We're now holding monthly Technical Community Meetings and encourage you to call in and learn more about the project. Meeting information is on the `TCM Meeting page`_ in our `ACRN wiki <https://wiki.projectacrn.org/>`_. .. _TCM Meeting page: https://github.com/projectacrn/acrn-hypervisor/wiki/ACRN-Committee-and-Working-Group-Meetings#technical-community-meetings Resources ********* Here's a quick summary of resources to find your way around the Project ACRN support systems: * **Project ACRN Website**: The https://projectacrn.org website is the central source of information about the project. On this site, you'll find background and current information about the project as well as relevant links to project material. For a quick start, refer to the `Introduction`_ and `Getting Started Guide`_. * **Source Code in GitHub**: Project ACRN source code is maintained on a public GitHub repository at https://github.com/projectacrn/acrn-hypervisor. You'll find information about getting access to the repository and how to contribute to the project in this `Contribution Guide`_ document. * **Documentation**: Project technical documentation is developed along with the project's code, and can be found at https://projectacrn.github.io. Additional documentation is maintained in the `Project ACRN GitHub wiki`_. * **Issue Reporting and Tracking**: Requirements and Issue tracking is done in the Github issues system: https://github.com/projectacrn/acrn-hypervisor/issues. You can browse through the reported issues and submit issues of your own. * **Reporting a Potential Security Vulnerability**: If you have discovered potential security vulnerability in ACRN, please send an e-mail to acrn-security@lists.projectacrn.org. It is important to include the following details: - The projects and versions affected - Detailed description of the vulnerability - Information on known exploits * **Mailing List**: The `Project ACRN Development mailing list`_ is perhaps the most convenient way to track developer discussions and to ask your own support questions to the project ACRN community. There are also specific `ACRN mailing list subgroups`_ for builds, users, and Technical Steering Committee notes, for example. You can read through the message archives to follow past posts and discussions, a good thing to do to discover more about the project. .. _Introduction: https://projectacrn.github.io/latest/introduction/ .. _Getting Started Guide: https://projectacrn.github.io/latest/getting-started/ .. _Contribution Guide: https://projectacrn.github.io/latest/contribute.html .. _Project ACRN GitHub wiki: https://github.com/projectacrn/acrn-hypervisor/wiki .. _PGP Key: https://www.intel.com/content/www/us/en/security-center/pgp-public-key.html .. _vulnerability handling guidelines: https://www.intel.com/content/www/us/en/security-center/vulnerability-handling-guidelines.html .. _Project ACRN Development mailing list: https://lists.projectacrn.org/g/acrn-dev .. _ACRN mailing list subgroups: https://lists.projectacrn.org/g/main/subgroups