combox-paper

notes and other things concerning combox
git clone git://git.ricketyspace.net/combox-paper.git
Log | Files | Refs

commit 8d23218a585947d638c3409d20169d00b66ceb24
parent 983e290fd95deeaea10160462c5c28b4589ac2eb
Author: Siddharth Ravikumar <sravik@bgsu.edu>
Date:   Sat, 27 Feb 2016 23:47:16 -0500

Chapter 4: fixed refs, labels.

Diffstat:
report/bib/combox.bib | 3+--
report/chapters/3-arch-d.tex | 2+-
report/chapters/4-testing.tex | 46+++++++++++++++++++++++-----------------------
report/combox-report.pdf | 0
4 files changed, 25 insertions(+), 26 deletions(-)

diff --git 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 @@ -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 @@ -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 Binary files differ.