slight restructuring of the thesis, part of formulating the contents

thesis/bachelor.tex

@@ -77,10 +77,10 @@ plainpages=false,pdfpagelabels=true]{hyperref}
 % and \include for large latex compilation workloads (like a chapter) to get faster builds.
 \include{content/10_introduction}
 \include{content/20_state}
-\include{content/30_design}
-\include{content/40_implementation}
-\include{content/50_evaluation}
-\include{content/60_futurework}
+\include{content/30_performance}
+\include{content/40_design}
+\include{content/50_implementation}
+\include{content/60_evaluation}
 \include{content/70_conclusion}
 
 \appendix

thesis/content/00_title.tex

@@ -1,5 +1,3 @@
-\selectlanguage{british}
-
 \begin{singlespace}
 
     \subject{{\LARGE Bachelorarbeit}}

thesis/content/01_disclaimer.tex

@@ -1,13 +1,13 @@
-\selectlanguage{ngerman}
+\section*{\vfill{} \thispagestyle{empty} Statement of Authorship}
 
-\section*{\vfill{} \thispagestyle{empty}
-Selbständigkeitserklärung}
+I hereby declare that I am the sole author of this master thesis and that I have not used any
+sources other than those listed in the bibliography and identified as references. I further
+declare that I have not submitted this thesis at any other institution in order to obtain a
+degree.
 
-Hiermit erkläre ich, dass ich diese Arbeit selbstständig erstellt
-und keine anderen als die angegebenen Hilfsmittel benutzt habe.
 \bigskip{}
 
-\noindent Dresden, den \today % \printdate % if you defined date earlier
+\noindent Dresden, \today % \printdate % if you defined date earlier
 \vspace{2.5cm}
 
 \noindent Anatol Constantin Fürst \cleardoublepage{}

thesis/content/20_state.tex

@@ -1,4 +1,4 @@
-\chapter{Technical Background on Intel DSA}
+\chapter{Technical Background}
 \label{sec:state}
 
 % Hier werden zwei wesentliche Aufgaben erledigt:
@@ -44,7 +44,7 @@ To be able to optimally utilize the Hardware, knowledge of its workings is requi
 \begin{figure}[H]
     \centering
     \includegraphics[width=0.9\textwidth]{images/dsa-internal-block-diagram.png}
-    \caption{\\ \gls{dsa} Internal Archtiecture Block Diagramm \\ Taken from Figure 1a of \cite{intel:analysis}}
+    \caption{\\ \acrshort{dsa} Internal Archtiecture Block Diagramm \\ Taken from Figure 1a of \cite{intel:analysis}}
     \label{fig:dsa-internal-block}
 \end{figure}
 
@@ -67,7 +67,7 @@ The completion of a descriptor may be signaled through a completion record and i
 \begin{figure}[H]
     \centering
     \includegraphics[width=0.5\textwidth]{images/dsa-software-architecture.png}
-    \caption{\\ \gls{dsa} Software View Block Diagramm \\ Taken from Figure 1a of \cite{intel:analysis}}
+    \caption{\\ \acrshort{dsa} Software View Block Diagramm \\ Taken from Figure 1a of \cite{intel:analysis}}
     \label{fig:dsa-software-arch}
 \end{figure}
 
@@ -102,14 +102,6 @@ Setup Requirements:
     \item just explain the basics (no code) and refer to dml documentation
 \end{itemize}
 
-\section{Microbenchmarks}
-
-\begin{itemize}
-    \item submit cost analysis: best method and for a subset the point at which submit cost < time savings
-    \item effect of mt-submit, low because \gls{dsa:swq} implicitly synchronized, bandwidth is shared
-    \item copy strategy and performance analysis from ddr to HBM
-\end{itemize}
-
 \cleardoublepage
 
 %%% Local Variables:

thesis/content/30_design.tex

@@ -1,48 +0,0 @@
-\chapter{Design}
-\label{sec:design}
-
-% Ist das zentrale Kapitel der Arbeit. Hier werden das Ziel sowie die
-% eigenen Ideen, Wertungen, Entwurfsentscheidungen vorgebracht. Es kann
-% sich lohnen, verschiedene Möglichkeiten durchzuspielen und dann
-% explizit zu begründen, warum man sich für eine bestimmte entschieden
-% hat. Dieses Kapitel sollte - zumindest in Stichworten - schon bei den
-% ersten Festlegungen eines Entwurfs skizziert werden.
-% Es wird sich aber in einer normal verlaufenden
-% Arbeit dauernd etwas daran ändern. Das Kapitel darf nicht zu
-% detailliert werden, sonst langweilt sich der Leser. Es ist sehr
-% wichtig, das richtige Abstraktionsniveau zu finden. Beim Verfassen
-% sollte man auf die Wiederverwendbarkeit des Textes achten.
-
-% Plant man eine Veröffentlichung aus der Arbeit zu machen, können von
-% diesem Kapitel Teile genommen werden. Das Kapitel wird in der Regel
-% wohl mindestens 8 Seiten haben, mehr als 20 können ein Hinweis darauf
-% sein, daß das Abstraktionsniveau verfehlt wurde.
-
-
-\section{Detailed Task Description}
-
-\begin{itemize}
-    \item give slightly more detailed task Description
-    \item perspective of "what problems have to be solved"
-    \item not "what is querry driven prefetching"
-\end{itemize}
-
-\section{Applicability of Accelerator}
-
-\begin{itemize}
-    \item back-reference to the Microbenchmarks and conclusion on possible gains
-    \item explain chosen configuration and libraries for the situation
-\end{itemize}
-
-\section{Design Choices}
-
-\begin{itemize}
-    \item explain the design choices made to solve the problems
-    \item this should go into theoretical details - no code
-\end{itemize}
-
-\cleardoublepage
-
-%%% Local Variables:
-%%% TeX-master: "diplom"
-%%% End:

thesis/content/40_implementation.tex

@@ -1,29 +0,0 @@
-\chapter{Implementation}
-\label{sec:implementation}
-
-% Hier greift man einige wenige, interessante Gesichtspunkte der
-% Implementierung heraus. Das Kapitel darf nicht mit Dokumentation oder
-% gar Programmkommentaren verwechselt werden. Es kann vorkommen, daß
-% sehr viele Gesichtspunkte aufgegriffen werden müssen, ist aber nicht
-% sehr häufig. Zweck dieses Kapitels ist einerseits, glaubhaft zu
-% machen, daß man es bei der Arbeit nicht mit einem "Papiertiger"
-% sondern einem real existierenden System zu tun hat. Es ist sicherlich
-% auch ein sehr wichtiger Text für jemanden, der die Arbeit später
-% fortsetzt. Der dritte Gesichtspunkt dabei ist, einem Leser einen etwas
-% tieferen Einblick in die Technik zu geben, mit der man sich hier
-% beschäftigt. Schöne Bespiele sind "War Stories", also Dinge mit denen
-% man besonders zu kämpfen hatte, oder eine konkrete, beispielhafte
-% Verfeinerung einer der in Kapitel 3 vorgestellten Ideen. Auch hier
-% gilt, mehr als 20 Seiten liest keiner, aber das ist hierbei nicht so
-% schlimm, weil man die Lektüre ja einfach abbrechen kann, ohne den
-% Faden zu verlieren. Vollständige Quellprogramme haben in einer Arbeit
-% nichts zu suchen, auch nicht im Anhang, sondern gehören auf Rechner,
-% auf denen man sie sich ansehen kann.
-
-\ldots implementation \ldots
-
-\cleardoublepage
-
-%%% Local Variables:
-%%% TeX-master: "diplom"
-%%% End:

thesis/content/50_evaluation.tex

@@ -1,19 +0,0 @@
-\chapter{Evaluation}
-\label{sec:evaluation}
-
-% Zu jeder Arbeit in unserem Bereich gehört eine Leistungsbewertung. Aus
-% diesem Kapitel sollte hervorgehen, welche Methoden angewandt worden,
-% die Leistungsfähigkeit zu bewerten und welche Ergebnisse dabei erzielt
-% wurden. Wichtig ist es, dem Leser nicht nur ein paar Zahlen
-% hinzustellen, sondern auch eine Diskussion der Ergebnisse
-% vorzunehmen. Es wird empfohlen zunächst die eigenen Erwartungen
-% bezüglich der Ergebnisse zu erläutern und anschließend eventuell
-% festgestellte Abweichungen zu erklären.
-
-\ldots evaluation \ldots
-
-\cleardoublepage
-
-%%% Local Variables:
-%%% TeX-master: "diplom"
-%%% End:

thesis/content/60_futurework.tex

@@ -1,10 +0,0 @@
-\chapter{Future Work}
-\label{sec:futurework}
-
-\ldots future work \ldots
-
-\cleardoublepage
-
-%%% Local Variables:
-%%% TeX-master: "diplom"
-%%% End:

thesis/content/70_conclusion.tex

@@ -14,7 +14,7 @@
 % Tips geben. Aber man sollte nicht um jeden Preis Fragen, die gar nicht
 % da sind, mit Gewalt aufbringen und dem Leser suggerieren, wie
 % weitsichtig man doch ist. Dieses Kapitel muß kurz sein, damit es
-% gelesen wird.
+% gelesen wird. Sollte auch "Future Work" beinhalten.
 
 \ldots conclusion \ldots
 

thesis/own.bib

@@ -8,7 +8,7 @@
 
 @ONLINE{intel:xeonbrief,
     author = {Intel},
-    title = {New Intel® Xeon® Platform Includes Built-In Accelerators for Encryption, Compression, and Data Movement},
+    title = {{New Intel® Xeon® Platform Includes Built-In Accelerators for Encryption, Compression, and Data Movement}},
     date = {2022-12},
     url = {https://www.intel.com/content/dam/www/central-libraries/us/en/documents/2022-12/storage-engines-4th-gen-xeon-brief.pdf},
     urldate = {2023-11-15}
@@ -36,7 +36,7 @@
     title = {{Intel IDXD User Space Application}},
     publisher = {GitHub},
     journal = {GitHub repository},
-    howpublished = {\url{https://github.com/intel/idxd-driver}},
+    howpublished = {\url{https://github.com/intel/idxd-config}},
     urldate = {2024-01-07}
 }
 

thesis/own.gls

@@ -49,29 +49,35 @@
 
 \newglossaryentry{pcie-dmr}{
     name={DMR},
-    name={PCIe Deferrable Memory Write Request},
+    long={PCIe Deferrable Memory Write Request},
     first={PCIe Deferrable Memory Write Request (DMR)},
     description={... desc ...}
 }
 
 \newglossaryentry{dsa:engine}{
     name={Engine},
+    long={\gls{dsa} Engine},
+    first={Engine},
     description={... desc ...}
 }
 
 \newglossaryentry{dsa:group}{
     name={Group},
+    long={\gls{dsa} Group},
+    first={Group},
     description={... desc ...}
 }
 
 \newglossaryentry{x86:enqcmd}{
     name={ENQCMD},
+    long={x86 Instruction ENQCMD},
     first={x86 Instruction ENQCMD},
     description={... desc ...}
 }
 
 \newglossaryentry{x86:movdir64b}{
     name={MOVDIR64B},
+    long={x86 Instruction MOVDIR64B},
     first={x86 Instruction MOVDIR64B},
     description={... desc ...}
 }

thesis/preamble/style.tex

@@ -84,3 +84,5 @@
 
 % Additionally page number always on the bottom
 % \fancyfoot[EC,OC]{\thepage}
+
+\glstoctrue