Skip to content

Latest commit

 

History

History
107 lines (80 loc) · 4.23 KB

README.rst

File metadata and controls

107 lines (80 loc) · 4.23 KB

⚠️ LISA has moved from GitHub to GitLab and is now available at: https://gitlab.arm.com/tooling/lisa. Please update your clone URLs and note that the GitHub repository will not be used for any pull requests or issue management. ⚠️

⚠️ lisa_tests package have been removed from the main repository as they are unmaintained. ⚠️

Introduction CI status

The LISA project provides a toolkit that supports regression testing and interactive analysis of Linux kernel behavior. LISA stands for Linux Integrated/Interactive System Analysis. LISA's goal is to help Linux kernel developers to measure the impact of modifications in core parts of the kernel. The focus is on the scheduler (e.g. EAS), power management and thermal frameworks. However LISA is generic and can be used for other purposes too.

LISA has a host/target model. LISA itself runs on a host machine, and uses the devlib toolkit to interact with the target via SSH, ADB or telnet. LISA is flexible with regard to the target OS; its only expectation is a Linux kernel-based system. Android, GNU/Linux and busybox style systems have all been used.

LISA provides features to describe workloads (notably using rt-app) and run them on targets. It can collect trace files from the target OS (e.g. systrace and ftrace traces). These traces can then be parsed and analysed in order to examine detailed target behaviour during the workload's execution.

Some LISA features may require modifying the target OS. For example, in order to collect ftrace files the target kernel must have CONFIG_DYNAMIC_FTRACE enabled.

Once the setup has been done, LISA caters to different workflows.

Motivations

The main goals of LISA are:

  • Support study of existing behaviours (i.e. "how does PELT work?")
  • Support analysis of new code being developed (i.e. "what is the impact on existing code?")
  • Get insights on what's not working and possibly chase down why
  • Share reproducible experiments by means of a common language that:
    • is flexible enough to reproduce the same experiment on different targets
    • simplifies generation and execution of well defined workloads
    • enables kernel developers to easily post process data to produce statistics and plots

Documentation

You should find everything on https://tooling.sites.arm.com/lisa/latest/

How to reach us

Bug reports should be raised against the GitLab issue tracker.

External Links

  • Linux Integrated System Analysis (LISA) & Friends Slides and Video

    Note: the LISA classes referred by the slides are outdated, but all the other concepts and the overall architecture stays the same.

  • Some insights on what it takes to have reliable tests: Video

License

This project is licensed under Apache-2.0.

This project includes some third-party code under other open source licenses. For more information, see lisa/_assets/binaries/**/README.*.

Contributions / Pull Requests / Merge Requests

Contributions are accepted under Apache-2.0. Only submit contributions where you have authored all of the code. If you do this on work time make sure your employer is ok with this. Please ensure you read our Contributor Guide, especially the section on opening a merge requests, as you might accidentally open a merge request against your own fork.