From 7e5883bbd6e699d1fcee0814c5a172d6348bd63c Mon Sep 17 00:00:00 2001
From: Manuel Traut <manut@linutronix.de>
Date: Thu, 27 Jan 2011 00:52:19 +0100
Subject: convert the rest to the new buildsys format

Signed-off-by: Manuel Traut <manut@linutronix.de>
---
 .../rt-specialties/handout_rt-specialties_de.tex   | 45 ++++++++++------------
 1 file changed, 21 insertions(+), 24 deletions(-)

(limited to 'realtime/rt-specialties/handout_rt-specialties_de.tex')

diff --git a/realtime/rt-specialties/handout_rt-specialties_de.tex b/realtime/rt-specialties/handout_rt-specialties_de.tex
index 33dc9b6..54771ca 100644
--- a/realtime/rt-specialties/handout_rt-specialties_de.tex
+++ b/realtime/rt-specialties/handout_rt-specialties_de.tex
@@ -1,13 +1,8 @@
-\documentclass{lxarticle}
-\usepackage{german}
-\usepackage[utf8]{inputenc}
-\usepackage{lxheaders}
-\usepackage{lxextras}
+\input{confighandout}
+\subsection{RT\_PREEMPT}
 
-\begin{document}
-
-\section*{Anwendung des Preempt RT Patches}
-\subsection*{Besorgen und Anwenden des Patches}
+\subsubsection{Anwendung des Preempt RT Patches}
+\paragraph{Besorgen und Anwenden des Patches}
 Preempt RT wird als Patch gegen den Mainline Linux Kernel gepflegt.
 Unter:\newline
 http://www.kernel.org/pub/linux/kernel/projects/rt sind die aktuellsten Patche
@@ -39,7 +34,7 @@ cd linux-2.6.29.5-rt21
 ketchup -f --no-gpg 2.6.29.5-rt21
 \end{lstlisting}
 
-\subsection*{Konfigurieren und Übersetzen eines Preempt RT Kernels}
+\paragraph{Konfigurieren und Übersetzen eines Preempt RT Kernels}
 Die Konfiguration und das Übersetzen machen keinen Unterschied zu Linux ohne
 Preempt RT Patch:
 \begin{lstlisting}
@@ -83,8 +78,9 @@ make O=../build modules
 make O=../build install
 make O=../build modules_install
 \end{lstlisting}
-\section*{Testen eines Preempt RT Systems}
-\subsection*{RT Tests}
+
+\subsubsection{Testen eines Preempt RT Systems}
+\paragraph{RT Tests}
 Die RT Tests sind eine Sammlung von Programmen, zur Validierung der
 Eigenschaften von Echtzeitsystemen. Die RT Tests umfassen folgende Tools:
 \begin{itemize}
@@ -104,7 +100,7 @@ git-clone git://git.kernel.org/pub/scm/linux/kernel\
 cd rt-tests
 make
 \end{lstlisting}
-\subsection*{Cyclictest}
+\subparagraph{Cyclictest}
 Cyclictest ist die wohl meistgenutzte Testsoftware auf Preempt RT Systemen. Mit
 Cyclictest kann eine bestimmte Anzahl von Timertasks mit einem definierten
 Interval aufgesetzt werden. Für diese Tasks wird kontinuierlich die Abweichung
@@ -128,7 +124,7 @@ T: 1 ( 2122) P:79 I:2500 C: 1007 Min: 47 Act: 76 Avg: 77 Max: 130
 T: 2 ( 2123) P:78 I:3000 C:  841 Min: 54 Act: 76 Avg: 82 Max: 136
 T: 3 ( 2124) P:77 I:3500 C:  723 Min: 67 Act: 95 Avg: 96 Max: 177
 \end{lstlisting}
-\subsection*{Lastszenarien}
+\paragraph{Lastszenarien}
 Um eine Aussage über das Echtzeitverhaltens treffen zu können, interessiert in
 der Hauptsache das Verhalten in Worst-Case Szenarien (hohe CPU Last, hohe
 Interruptlast). Ein ausgezeichnetes Werkzeug, um CPU Last zu erzeugen, ist
@@ -142,7 +138,7 @@ Rechner erzeugen. Ein Floodping schickt eine große Anzahl von ICMP Paketen in
 kurzer Zeit. Dies erzeugt eine hohe Anzahl von Netzwerkinterrupts. Um Floodpings
 zu generieren muß das Programm ping mit Rootrechten und mit der Option -f
 ausgeführt werden.
-\subsection*{Pitfall}
+\subparagraph{Pitfall}
 Ein sehr häufig gemeldetes Phänomen bei Testläufen von Cyclictest mit einem
 Floodping als Lastszenario, sind extrem große Ausreißer in der Größenordnung von
 50ms. Dies ist auf ein ''Feature'' aktueller Preempt RT Kernel zurückzuführen.
@@ -166,8 +162,8 @@ Zum Deaktivieren dieser Funktion muß Folgendes getan werden:
 \begin{lstlisting}
 echo -1 > /proc/sys/kernel/sched_rt_runtime_us
 \end{lstlisting}
-\section*{Erstellen einer Realtime Task für Preempt RT}
-\subsection*{Schedulingklassen / Prioritäten}
+\subsubsection{Erstellen einer Realtime Task für Preempt RT}
+\paragraph{Schedulingklassen / Prioritäten}
 Eine Realtime Applikation auf Preempt RT ist eine POSIX Realtime Applikation.
 POSIX sieht für Echtzeitapplikationen folgende Schedulingstrategien vor:
 \begin{itemize}
@@ -176,7 +172,7 @@ POSIX sieht für Echtzeitapplikationen folgende Schedulingstrategien vor:
 \end{itemize}
 Echtzeitpriorität bekommt eine Applikation nur dann, wenn dies explizit
 gewünscht wird. Hierzu ist die Funktion sched\_setscheduler() vorgesehen.
-\subsection*{Beispiel einer Echtzeitapplikation}
+\paragraph{Beispiel einer Echtzeitapplikation}
 Das folgende Beispiel zeigt eine einfache POSIX Realtimeapplikation:
 \begin{lstlisting}
 /*
@@ -239,8 +235,8 @@ undeterministisches Zeitverhalten verursachen
 Eine Ausgezeichnete Einführung zum Erstellen von Echtzeitapplikationen und zur
 Verwendung von Preempt RT findet sich unter:\newline
 http://rt.wiki.kernel.org
-\subsection*{Tracing / Latenzen aufspüren}
-\subsubsection*{FTrace}
+\paragraph{Tracing / Latenzen aufspüren}
+\subparagraph{FTrace}
 Ein hervorragendes Werkzeug, um kernelseitige Codepfade aufzuspüren, die lange
 Latenzzeiten verursachen, ist Ftrace. Ftrace wird über DebugFS, einem virtuellen
 Dateisystem, gesteuert und platziert dort auch seine Ausgaben. Die einfachste
@@ -248,7 +244,7 @@ Methode, FTrace zu verwenden ist Cyclictest. Cyclictest biete bereits einige
 Optionen, um FTrace zu steuern. Die Option -f schällt Cyclictests Ftrace
 Support an, -b <max\_latency> veranlaßt Cyclictest, bei Überschreiten einer
 maximalen Latenzzeit, abzubrechen und einen Trace zu triggern.
-\subsubsection*{Kerneloptionen für FTrace}
+\subparagraph{Kerneloptionen für FTrace}
 Um FTrace verwenden zu können, müssen beim Konfigurieren des Kernels einige
 unter dem Menupunkt ''Kernel hacking-->Tracers'' einige Optionen aktiviert werden:
 \begin{itemize}
@@ -257,7 +253,7 @@ unter dem Menupunkt ''Kernel hacking-->Tracers'' einige Optionen aktiviert werde
 Tracetyp kann cyclictest über die Commandline mitgegeben werden, siehe
 cyclictest -h. Default ist der Event Tracer)
 \end{itemize}
-\subsubsection*{Beispiel eines Traces}
+\subparagraph{Beispiel eines Traces}
 Das Erstellen eines Traces mit cyclictest läßt sich am Besten mit einem Beispiel
 erläutern:
 \begin{lstlisting}
@@ -292,7 +288,7 @@ IRQ-129-772   [000] 4154503386.851234: timer_interrupt<-ret_from
 [...]
 \end{lstlisting}
 
-\subsection*{Kontrollfragen}
+\paragraph{Kontrollfragen}
 \begin{itemize}
 \item Welche Optionen sollten beim Übersetzen eines Preempt RT Kernels
 mindestens gesetzt sein?
@@ -302,4 +298,5 @@ als Lastszenario? Wie kann dieser umgangen werden?
 \item Welche 3 Schritte sind notwendig, um das deterministische Zeitverhalten
 einer Applikation zu garantieren?
 \end{itemize}
-\end{document}
+
+\input{tailhandout}
-- 
cgit v1.2.3

