summaryrefslogtreecommitdiffstats
path: root/report
diff options
context:
space:
mode:
Diffstat (limited to 'report')
-rw-r--r--report/bib/combox.bib3
-rw-r--r--report/chapters/3-arch-d.tex2
-rw-r--r--report/chapters/4-testing.tex46
-rw-r--r--report/combox-report.pdfbin385316 -> 385316 bytes
4 files changed, 25 insertions, 26 deletions
diff --git a/report/bib/combox.bib b/report/bib/combox.bib
index d16b7e7..dc5c803 100644
--- a/report/bib/combox.bib
+++ b/report/bib/combox.bib
@@ -210,8 +210,7 @@ title = "Python Packaging User Guide",
url = "https://packaging.python.org/en/latest/"
}
-% 5
-
+% 4
@techreport{dijkstra69,
title = "Software Engineering Techniques",
author = "J.N. Buxton and B. Randell",
diff --git a/report/chapters/3-arch-d.tex b/report/chapters/3-arch-d.tex
index 4a0e33d..8350f63 100644
--- a/report/chapters/3-arch-d.tex
+++ b/report/chapters/3-arch-d.tex
@@ -386,7 +386,7 @@ compatible on \emph{all} of the three major computing platforms in
2014-2016\footnote{GNU/Linux, OS X and, Windows}.
As we were nearing the \verb+0.1.0+ release, combox was tested on OS X
-(See chapter \ref{ch:5}) and OS X specific issues that were found
+(See chapter \ref{ch:4}) and OS X specific issues that were found
eventually were eventually fixed. The initial \verb+0.1.0+ release was
compatible with GNU/Linux and OS X.
diff --git a/report/chapters/4-testing.tex b/report/chapters/4-testing.tex
index e6376f1..f25a75e 100644
--- a/report/chapters/4-testing.tex
+++ b/report/chapters/4-testing.tex
@@ -1,9 +1,9 @@
-\chapter{Testing}\label{ch:5}
+\chapter{Testing}\label{ch:4}
\epigraph{Testing shows the presence, not the absence of
bugs.}{\textit{Dijkstra}\cite{dijkstra69}}
-\section{Unit testing}\label{sec:5-unit-testing}
+\section{Unit testing}\label{sec:4-unit-testing}
The \verb+nose+\cite{pylib:nose} testing framework was used to
write unit tests for the functions and classes part of the
@@ -66,7 +66,7 @@ Unit tests failed to reveal bugs \#4, \#5 \#6 \#7 \#5 \#10
\#11\cite{combox-issue-tracker}; these bugs were found when manually
testing combox.
-\section{Manual testing}\label{sec:5-manual-testing}
+\section{Manual testing}\label{sec:4-manual-testing}
The unit tests for the \verb+combox.events+ module test the
correctness of the \verb+ComboxDirMonitor+ and \verb+NodeDirMonitor+
@@ -118,7 +118,7 @@ client was used to automatically sync files from the Dropbox directory
to the Dropbox' server; \verb+rclone+\cite{program:rclone} was used to
sync files from Google Drive directory to Google Drive' server.
-\subsubsection{Issues found}\label{ch-5-2gnus-issues}
+\subsubsection{Issues found}\label{ch-4-2gnus-issues}
\begin{itemize}
\item Some editors, especially on POSIX complaint systems, create
@@ -260,7 +260,7 @@ Google Drive directory to Google Drive's server on GNU/Linux.
directory; this broke combox. This issue was fixed on
2015-08-25\cite{git:bug-four-fix}. This issue is not got to do with
the nature of the setup but it is related to the Dropbox's behavior
- elaborated in section \ref{ch-5-2gnus-issues}.
+ elaborated in section \ref{ch-4-2gnus-issues}.
\item The official Google Drive client when it pulls an updated
version of the file from Google Drive' server, instead directly
updating the respective file on the computer, it deletes the older
@@ -463,14 +463,14 @@ change in \verb+ComboxDirMonitor+ directly affected the performance of
combox and therefore the results that were got from stress testing on
\verb+2015-11-08+ would no longer be valid. Stress testing was again
done on \verb+2016-01-16+; the results of this stress test are in
-sections \ref{5-st-424} to \ref{5-st-10800}, section \ref{5-st-tu}
+sections \ref{4-st-424} to \ref{4-st-10800}, section \ref{4-st-tu}
gives information about the tools used for stress testing, section
-\ref{5-st-o} contains the observations and comparisons between this
+\ref{4-st-o} contains the observations and comparisons between this
stress test and the one done on \verb+2015-11-08+, lastly section
-\ref{5-st-if} reveals the issues that were found with combox by virtue
+\ref{4-st-if} reveals the issues that were found with combox by virtue
of doing the stress tests.
-\subsection{flac dump (27 files - 424.798190MiB)}\label{5-st-424}
+\subsection{flac dump (27 files - 424.798190MiB)}\label{4-st-424}
\begin{center}
\begin{tabular}{ll}
@@ -495,7 +495,7 @@ avg. time to split and encrypt a file & 352.583370 ms\\
28.337963000000002ms.
\end{itemize}
-\subsection{20MiB - 90MiB dump (27 files - 1620.000000MiB)}\label{5-st-1620}
+\subsection{20MiB - 90MiB dump (27 files - 1620.000000MiB)}\label{4-st-1620}
\begin{center}
\begin{tabular}{ll}
@@ -520,7 +520,7 @@ avg. time to split and encrypt a file & 2670.596556ms\\
25.52536999999984ms.
\end{itemize}
-\subsection{20MiB - 90MiB dump (99 files - 5940.000000MiB)}\label{5-st-5940}
+\subsection{20MiB - 90MiB dump (99 files - 5940.000000MiB)}\label{4-st-5940}
\begin{center}
\begin{tabular}{ll}
@@ -545,7 +545,7 @@ avg. time to split and encrypt a file & 2979.647586ms\\
206.20906100000002ms.
\end{itemize}
-\subsection{20MiB - 90MiB dump (180 files - 10800.000000MiB)}\label{5-st-10800}
+\subsection{20MiB - 90MiB dump (180 files - 10800.000000MiB)}\label{4-st-10800}
\begin{center}
\begin{tabular}{ll}
@@ -570,7 +570,7 @@ avg. time to split and encrypt a file & 3423.087539ms\\
399.87623299999996ms.
\end{itemize}
-\subsection{Tools used}\label{5-st-tu}
+\subsection{Tools used}\label{4-st-tu}
The \verb+dump+ script\cite{program:dump} was used to dump files to
the combox directory between one second intervals; a night of Emacs
@@ -581,32 +581,32 @@ for a given dump\cite{program:dumps.el}; lastly \verb+org-mode+ was
used to document all data gathered during stress
testing\cite{doc:benchmarks.org}.
-\subsection{Observations}\label{5-st-o}
+\subsection{Observations}\label{4-st-o}
\begin{figure}[h]
\centering
\input{graphs/tot-time.tex}
\caption{time to process all files}
-\label{fig:5-st-tt}
+\label{fig:4-st-tt}
\end{figure}
\begin{figure}[h]
\centering
\input{graphs/avg-time-sae.tex}
\caption{avg. time to split and encrypt}
-\label{fig:5-st-atsae}
+\label{fig:4-st-atsae}
\end{figure}
\begin{itemize}
-\item Figure \ref{fig:5-st-tt} shows the time it takes combox to
+\item Figure \ref{fig:4-st-tt} shows the time it takes combox to
process files for a given file dump\footnote{A ``file dump'' here
means a bunch of files copied to the combox directory between 1
sec intervals.}. As can be observed from the graph, the total time
taken to process all the files tends almost linearly increase with
the increase in the size of the file dump\footnote{The ``size of the
file dump'' is the total size of all files in a given file dump.}.
-\item Figure \ref{fig:5-st-atsae} show the average time it takes
+\item Figure \ref{fig:4-st-atsae} show the average time it takes
combox to split and encrypt a file for a given file dump. There is a
steep increase in the average time from the \verb+424.798190MiB+
dump and the \verb+1620.000000MiB+ dump, after which the average
@@ -619,18 +619,18 @@ testing\cite{doc:benchmarks.org}.
\centering
\input{graphs/tot-time-diff.tex}
\caption{time to process all files - difference between 2015 and 2016}
-\label{fig:5-st-tt-diff}
+\label{fig:4-st-tt-diff}
\end{figure}
\begin{figure}[h]
\centering
\input{graphs/avg-time-sae-diff.tex}
\caption{avg. time to split and encrypt - difference between 2015 and 2016}
-\label{fig:5-st-atsae-diff}
+\label{fig:4-st-atsae-diff}
\end{figure}
\begin{itemize}
-\item Figure \ref{fig:5-st-tt-diff} shows the graphs for the total
+\item Figure \ref{fig:4-st-tt-diff} shows the graphs for the total
amount of time taken to process all files for a given file dump in
the \verb+2016-01-16+ and \verb+2015-11-8+ stress test. The amount
of time needed to process all fills seems to be reduced for the
@@ -638,7 +638,7 @@ testing\cite{doc:benchmarks.org}.
stress test results and it seems to be slightly higher for the
\verb+10800.000000MiB+ file dump when compared to the \verb+2015+
stress test.
-\item Similarly, figure \ref{fig:5-st-atsae-diff} shows the graphs for
+\item Similarly, figure \ref{fig:4-st-atsae-diff} shows the graphs for
the average time to split and encrypt for a given file dump in the
\verb+2016-01-16+ and the \verb+2015-11-8+ stress test. The average
time taken seems to able almost the same for the
@@ -648,7 +648,7 @@ testing\cite{doc:benchmarks.org}.
when compared to the \verb+2015+ stress test.
\end{itemize}
-\subsection{Issues found}\label{5-st-if}
+\subsection{Issues found}\label{4-st-if}
\begin{itemize}
\item Initially when combox was stress tested with huge files, combox
diff --git a/report/combox-report.pdf b/report/combox-report.pdf
index 5661195..d4ff24d 100644
--- a/report/combox-report.pdf
+++ b/report/combox-report.pdf
Binary files differ