LITMUS^RT Documentation

This page contains links to LITMUS^RT documentation, inluding basic installation and usage instructions, and in-depth tutorials such as creating a new scheduler plugin.

Getting Started

• The installation instructions cover how to compile and install the LITMUS^RT kernel on a standard Linux system.

• The LITMUS^RT tutorial provides basic instructions for getting started with using LITMUS^RT, including working with different scheduling plugins and configuring and launching real-time tasks.

• A guide for installing LITMUS^RT on Raspbian OS, contributed by Filip Marković.

User Documentation

• The LITMUS^RT manual provides additional details about how LITMUS^RT and its schedulers work. This page provides more detail about the topics covered in the basic tutorial. The manual also covers some of the following guides to some extent.

• The schedule tracing and visualization tutorial explains how to capture, evaluate, and visualize schedule traces using LITMUS^RT’s sched_trace facility.

• The overhead tracing and analysis tutorial documents how to measure and post-process kernel overheads using the Feather-Trace toolkit, which is part of LITMUS^RT.

• The reservations tutorial explains how to set up reservation-based scheduling and provision real-time tasks in reservations using LITMUS^RT’s reservation framework.

• The table-driven scheduling tutorial documents how to set up table-driven scheduling (also know as time partitioning or time-triggered scheduling) in LITMUS^RT’s reservation framework.

Developer Documentation

• The instructions for writing a new LITMUS^RT scheduler plugin provide a step-by-step guide for implementing a partitioned EDF (P-EDF) scheduler as a LITMUS^RT plugin. We recommend using these instructions as a starting point when implementing a new scheduler plugin.

• Instructions for linking against liblitmus.

• Chapter 3 of Björn Brandenburg’s PhD thesis explains the design and implementation of LITMUS^RT, and how to account for kernel overheads as encountered in LITMUS^RT and as measured by Feather-Trace.

• The old LITMUS^RT Wiki is largely unmaintained and outdated, but contains a few additional tutorials that may be useful when using LITMUS^RT.

---