na een hoop ruzie met latex is er nu een checklist!
[tt2015.git] / a2 / 1cases.tex
index e418a81..b3ea384 100644 (file)
@@ -1,18 +1,65 @@
+
+\pagebreak
+\begin{table}
 \subsection{Preflight checklist}
 
 Before actual certification is commenced we perform a manual test using a 
 checklist.
 If any of the checks fail we immediately reject the product.
-
-\begin{enumerate}
-       \item Is the product complete?
-       \item Does the product come with a manual or quick start guide?
-       \item Is it possible to get the product in a usable state?
-       \item Can we use the product to initiate a connection in a corruption
-       free environment?
-\end{enumerate}
-
-\textbf{DIT MOET VERANDERD WORDEN, HET PRODUCT ZOU AFGEKEURD WORDEN!}
+The checklist is given in the table below.
+
+\begin{tabularx}{\linewidth}{| l | X|}
+       \hline
+Check 1 & Get the SUT in a workable state. \\\hline
+Course of action & \begin{enumerate}
+       \item Import the VirtualBox image into VirtualBox.
+       \item Boot the vm.
+       \item Verify the SUT booted succesfully and the network module(s) are loaded.
+\end{enumerate} \\\hline
+Passed & \textit{Yes/No} \\\hline \hline
+Check 2 & Verify the SUT is complete. \\\hline
+Course of action & \begin{enumerate}
+       \item Use the course of action for \emph{Check 1} in order to boot the SUT.
+       \item Verify the loopback device exists using \emph{ifconfig}
+       \item Verify the \emph{echo-server} is present on the system.
+       \item Verify \emph{Scrappy} is present on the system.
+       \item Verify all scripts used for testing are present on the system.
+\end{enumerate} \\\hline
+Passed & \textit{Yes/No} \\\hline \hline
+Check 3 & Initialize the testing environment. \\\hline
+Course of action & \begin{enumerate}
+       \item Boot the SUT (see \emph{Check 1}).
+       \item Setup iptables by executing \emph{./scripts/setup/iptables.sh}
+       \item Setup ... by executing \emph{./scripts/setup/...}
+\end{enumerate} \\\hline
+Passed & \textit{Yes/No} \\\hline
+\end{tabularx}
+\end{table}
+
+\begin{table}
+\begin{tabularx}{\linewidth}{| l | X |}
+\hline
+Check 4 & Test the tool environment. \\\hline
+Course of action & \begin{enumerate}
+       \item Boot and initialize the SUT (see \emph{Check 4})
+       \item Execute the \emph{./scripts/tests/case0-helloworld.sh} script.
+       \item Execute the command \emph{cat logs/case0.log}.
+       \item Verify the console displays a success message.
+\end{enumerate} \\\hline
+Passed & \textit{Yes/No} \\\hline \hline
+Check 5 & All test inputs and scripts are present. \\\hline
+Course of action & \begin{enumerate}
+       \item Boot the SUT (see \emph{Check 1})
+       \item Execute the command \emph{ls scripts/tests}
+       \item Verify that there is a file named case$X$ for each test case $X$
+       \item Use \emph{ls packets}
+       \item Verify that there is a file named \emph{single.pcap} and \emph{multi.pcap}.
+\end{enumerate} \\\hline
+Passed & \textit{Yes/No} \\\hline
+\end{tabularx}
+\end{table}
+
+\newpage
 
 \subsection{Testing of SUT}
 
@@ -34,51 +81,56 @@ a feasible test suite the tests are divided into equivalence partitions. Below
 these partitions are given.
 
 \begin{enumerate}
-       \item Single valid request.
-       \item Single invalid request with.
-       \begin{enumerate}
-               \item Corrupted checksum.
-               \item Corrupted payload with.
+       \item \emph{Number of packets} in request\footnotemark
+               \footnotetext{A request is considered establishing a connection 
+               (handshake) and any n number of payloadpackts}
                \begin{enumerate}
-                       \item Oven number of bits flipped.
-                       \item Odd number of bits flipped.
+                       \item 0 payload packets
+                       \item 1 payload packet
+                       \item n=small payload packets
+                       \item n=big payload packets
                \end{enumerate}
-               \item Corrupted source address.
-               \item Corrupted destination address.
-       \end{enumerate}
-       \item Multiple valid requests received in order.
-       \item Multiple valid requests received out of order.
-       \item Mixed valid and invalid requests with.
-       \begin{enumerate}
-               \item Missing packets.
-               \item Corrupted checksum.
-               \item Corrupted payload with.
+       \item Correct or Incorrect \emph{source port}
+       \item Correct or Incorrect \emph{Destination port}
+       \item Bits flipped in \emph{Payload}
                \begin{enumerate}
-                       \item Oven number of bits flipped.
-                       \item Odd number of bits flipped.
+                       \item Correct payload
+                       \item Payload with even number of bits flipped
+                       \item Payload with odd number of bits flipped
                \end{enumerate}
-               \item Corrupted source address.
-               \item Corrupted destination address.
-       \end{enumerate}
+       \item Correct or Incorrect \emph{checksum}
+       \item Packets received in or out of order, or missing packets
 \end{enumerate}
 
-Above enumeration results in a total of $14$ test cases.
-
-\vspace{3mm}
-\textbf{Hier daadwerkelijke test cases tabel}
-\vspace{3mm}
-
-To reduce the number of tests that need to be executed when testing the SUT and
-to construct a feasible test suite these tests are combined according
-to Table~(\textbf{referentie naar decision table}). 
-
-\vspace{3mm}
-\textbf{Hier daadwerkelijke decision tabel}
-\vspace{3mm}
+\textbf{hier iets over waarom deze partities relevant zijn! Waarom odd en 
+even number of bits flipped bijv interessant?}
+\bigskip
+
+Partitions 2 to 6 are tested using pairwise testing to keep the number of test
+cases feasible. The pairs are then all *except some where it does not make sense
+to do so) tested with the different request sizes of partition 1.
+
+This is expressed in Table~\ref{table:testpairs}.
+
+\begin{table}
+\begin{tabular} {p{2cm} | l | p{2cm} | l | p{1cm} || c | c | p{1.3cm} | p{1.3cm}}
+\textbf{Payload}       & \textbf{checksum}  & \textbf{destination port} & \textbf{order}         & \textbf{source port} & \textbf{payload 0} & \textbf{payload 1} & \textbf{payload small} & \textbf{payload big} \\  \hline \hline
+Correct               & Correct   & Correct          & In order       & Correct     & \cmark & \cmark & \cmark & \cmark \\  \hline
+Correct               & Incorrect & Incorrect        & Missing packet & Incorrect   & \xmark & \xmark & \cmark & \cmark \\  \hline
+odd\# of bits flipped  & Correct   & Incorrect        & Out of order   & Incorrect   & \xmark & \xmark & \cmark & \cmark \\  \hline
+odd\# of bits flipped  & Incorrect & Correct          & Missing packet & Correct     & \xmark & \xmark & \cmark & \cmark \\  \hline
+even\# of bits flipped & Correct   & Incorrect        & Missing packet & Correct     & \xmark & \xmark & \cmark & \cmark \\  \hline
+even\# of bits flipped & Incorrect & Correct          & Out of order   & Incorrect   & \xmark & \xmark & \cmark & \cmark \\  \hline
+odd\# of bits flipped  & Incorrect & Incorrect        & In order       & Incorrect   & \cmark & \cmark & \cmark & \cmark \\  \hline
+even\# of bits flipped & Incorrect & Incorrect        & In order       & Incorrect   & \cmark & \cmark & \cmark & \cmark \\  \hline
+Correct               & Incorrect & Incorrect        & Out of order   & Correct     & \xmark & \xmark & \cmark & \cmark \\  
+\end{tabular}
+\caption{Combinations of test cases}
+\label{table:testpairs}
+\end{table}
 
 \subsection{Quality, completeness and coverage of tests}
 
-\subsubsection{Quality}
 The network packets used in testing are constructed from prerecorded, known to
 be correct, network traffic. These packets are then modified with well used and 
 field tested tools. Due to this the chance of errors in the test cases is quite
@@ -88,22 +140,72 @@ Therefore detected defects should only indicate there is a high chance that
 there is a fault in the SUT and can not result directly in the conclusion that
 there actually is one. 
 
-\subsubsection{Coverage}
+\bigskip
+
 Due to the nature of black-box testing coverage of the code in the 
 implementation of the SUT is unknown. However completeness of the tests over 
 the specification of the SUT can be assessed. 
 
-\subsubsection{Completeness}
+\bigskip
+
 Due to the clear and exhaustive specification of TCP the completeness of the 
 test suite can be clearly assessed. 
 
 As always, $100\%$ completeness is not feasible, therefore test cases are
 carefully selected to cover the most interesting parts of the TCP specification
-to ensure a test suite which covers at least \textbf{percentage}\% of the 
-specification.
+to ensure a test suite.
 
 To further decrease the number of tests needed test cases are divided into
 equivalence partitions and the combination of cases as described in 
-Table~(\textbf{referentie naar decision table}) ensures that all partitions are
+Table~\ref{table:testpairs} ensures that all partitions are
 covered and the number of individual tests is still feasible. 
 
+
+%
+% wat ik ook probeer ik krijg de eerste collum
+% zijn tekst niet verticaal gecentered
+%
+\begin{table}
+
+
+\subsection{Test cases}
+
+\begin{tabularx}{\linewidth}{| l | X|}
+\hline
+Nr & 1 \\\hline
+Title & Single valid request. \\\hline
+Input & Pcap file with prerecorded valid packets. \\\hline
+Expected output & Pcap file with valid response to request. \\\hline
+Course of action & \begin{enumerate}
+       \item Execute \emph{./scripts/tests/case1-single-valid.sh}
+       \item Load \emph{output/case1.pcap} with ...
+\end{enumerate} \\\hline
+Valid trace & \begin{enumerate}
+       \item \textbf{Hier packets benoemen?}
+\end{enumerate} \\\hline
+\end{tabularx}
+
+\begin{tabularx}{\linewidth}{| l | X|}
+       \hline
+       Nr & 2 \\\hline
+       Title & Single request with corrupted checksum. \\\hline
+       Input & Pcap file used as \emph{test-case 1} input. \\\hline
+       Expected output & No response from SUT, logs with rejected packets. \\\hline
+       Course of action & \begin{enumerate}
+               \item Load input pcap file into ....
+               \item Corrupt checksum of loaded packets.
+               \item Save resulting packets as pcap file.
+               \item Load new pcap file into ...
+               \item Replay new pcap file.
+               \item Record SUT response using...
+               \item Extract log with rejected packets.
+               \item Save recorded packets as a pcap file.
+               \item Analyze packets in resulting file.
+       \end{enumerate} \\\hline
+       Valid trace & \begin{enumerate}
+               \item \textbf{Aangeven welke packets corrupted zijn?}
+       \end{enumerate} \\\hline
+\end{tabularx}
+\end{table}
+
+\newpage