From ae5c6554d5c5d38f45820171fc069030b16b54f4 Mon Sep 17 00:00:00 2001 From: Guruprasad Aphale Date: Tue, 18 May 2010 16:59:51 -0400 Subject: Updated the scons section and added -h option. Also included publication section --- index.html | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 58 insertions(+), 13 deletions(-) diff --git a/index.html b/index.html index 6961509..bb6c026 100644 --- a/index.html +++ b/index.html @@ -63,8 +63,8 @@

Please refer to the download and installation sections for details.

-

Earlier versions based on Linux  2.6.24 and Linux 2.6.20, - which supported additional scheduling policies, are discussed on separate pages dedicated to the LITMUSRT 2008 and LITMUSRT 2007 series respectively. +

Earlier versions (2008.1 &mdash 2008.3),based on Linux  2.6.24 and (2007.1 — 2007.3), based on Linux 2.6.20 + ,support additional scheduling policies, are discussed on separate pages dedicated to the LITMUSRT 2008 and LITMUSRT 2007 series respectively.

The first version of LITMUSRT, which was implemented in Spring 2006, @@ -76,9 +76,9 @@

Support

- The LITMUSRT development effort is being supported by grants from - AT&T, IBM, and Northrop Grumman Corps.; the National Science Foundation (grants CNS 0834270 and CNS 0834132); the U.S. - Army Research Office (grant W911NF-09-1-0535); and the Air Force Office of Scientific Research (grant FA 9550-09-1-0549). + The LITMUSRT development effort is being supported by grants from, SUN Corp., + Intel Corp., IBM Corp., The National Science Foundation (grant CCR 0615197), and The U.S. + Army Research Office (grant W911NF-06-1-0425).

@@ -97,18 +97,17 @@
  • Björn B. Brandenburg (current maintainer)
    • -
  • Andrea Bastoni (University of Rome "Tor Vergata") +
  • Andrea Bastoni (Visiting researcher from University of Rome "Tor Vergata")

    • - Additional collaborators contributed to the previous LITMUSRT 2008 and the LITMUSRT 2007 versions. + (Additional collaborators for LITMUSRT 2008 series and LITMUSRT 2007 series contributed to earlier versions of LITMUSRT.)

    Publications

    -
    - +

    1. B. Brandenburg and J. Anderson, @@ -331,7 +330,7 @@ Technology and Applications Symposium, pp. 342-353, April 2008. model, a scheduler plugin infrastructure, and some scheduler plugins, as well as a user-space library that provides the LITMUSRT real-time API. Note that the current implementation only works on the - Intel x86-32 and x86-64 architectures. + Intel x86-32 and sparc64 architectures.

      Patching the Kernel

      @@ -380,14 +379,60 @@ make modules depends on the LITMUSRT kernel kernel and provides its own build system (based on scons). In order to compile liblitmus, you need to adjust the variable LITMUS_KERNEL in the SConstruct file to point to your - copy of the kernel. + copy of the kernel. Users should not update the SConstruct file manually anymore. Instead, a .config file can be created with appropriate variables. The required variables can be listed using scons -h command. This command lists the variables required for building the liblitmus2010 library.
      + Sample output of scons -h is as shown below.

      +

      + 

       
+scons -h
+scons: Reading SConscript files ...
+scons: done reading SConscript files.
+
+=============================================
+liblitmus --- The LITMUS^RT Userspace Library
+
+There are a number of user-configurable build
+variables. These can either be set on the
+command line (e.g., scons ARCH=x86) or read
+from a local configuration file (.config).
+
+Run 'scons --dump-config' to see the final
+build configuration.
+
+Build Variables
+---------------
+
+LITMUS_KERNEL: Where to find the LITMUS^RT kernel. ( /path/to/LITMUS_KERNEL )
+    default: ../litmus2010
+    actual: ../litmus2010
+
+PYTHON_HEADERS: Where to find Python headers. ( /path/to/PYTHON_HEADERS )
+    default: /usr/include/python2.5
+    actual: /usr/include/python2.5
+
+ARCH: Target architecture. (x86_64|sparc64|x86|i686)
+    default: x86_64
+    actual: x86_64
+
+WSS: Working set size for pm analysis
+    default: 3072
+    actual: 3072
+
+Use scons -H for help about command-line options.
+
      + +

      + To summarize, the liblitmus can be obtained and + compiled with the following commands: +

      + 
       
 cd $DIR
 wget http://www.cs.unc.edu/~anderson/litmus-rt/download/2010.1/liblitmus-2010.1.tgz
 tar xzf liblitmus-2010.1.tgz
 cd liblitmus 
-# change LITMUS_KERNEL in SConstruct to point to the kernel source
+
+# set LITMUS_KERNEL in .config to point to the kernel source and compile
 scons

      @@ -447,7 +492,7 @@ scons Only root can change the active policy, and only when there are no real-time tasks present.

      - If you do not have the dialog utility installed, then you can still used setsched by passing the desired scheduling policy as a commandline parameter, e.g. type setsched PFAIR to activate the PFAIR plugin. + If you do not have the dialog utility installed, then you can still use setsched by passing the desired scheduling policy as a commandline parameter, e.g. type setsched PFAIR to activate the PFAIR plugin.

      Writing Real-Time Tasks

      -- cgit v1.2.2