[Abtlinux-svn] SF.net SVN: abtlinux: [71] docs/requirements/trunk
Status: Alpha
Brought to you by:
eschabell
From: <esc...@us...> - 2006-03-08 16:06:18
|
Revision: 71 Author: eschabell Date: 2006-03-08 08:05:44 -0800 (Wed, 08 Mar 2006) ViewCVS: http://svn.sourceforge.net/abtlinux/?rev=71&view=rev Log Message: ----------- Finished Fixing section scenarios. Regnerated pdf. Modified Paths: -------------- docs/requirements/trunk/abtlinux.pdf docs/requirements/trunk/abtlinux.tex docs/requirements/trunk/cases/verify-installed-package-deps-case.tex docs/requirements/trunk/scenarios/fix-package-scenario.tex docs/requirements/trunk/scenarios/log-package-install-scenario.tex docs/requirements/trunk/scenarios/purge-old-logs-scenario.tex docs/requirements/trunk/scenarios/purge-old-package-sources-scenario.tex docs/requirements/trunk/scenarios/verify-installed-package-deps-scenario.tex docs/requirements/trunk/scenarios/verify-installed-package-files-scenario.tex docs/requirements/trunk/scenarios/verify-installed-package-integrity-scenario.tex docs/requirements/trunk/scenarios/verify-installed-package-symlinks-scenario.tex docs/requirements/trunk/scenarios.tex Modified: docs/requirements/trunk/abtlinux.pdf =================================================================== (Binary files differ) Modified: docs/requirements/trunk/abtlinux.tex =================================================================== --- docs/requirements/trunk/abtlinux.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/abtlinux.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -3,7 +3,7 @@ \begin{document} -\title{ABout Time Linux \\ (TRUNK)} +\title{ABout Time Linux \\ (0.7)} \author{Eric D. Schabell \\ \url{er...@ab...}} Modified: docs/requirements/trunk/cases/verify-installed-package-deps-case.tex =================================================================== --- docs/requirements/trunk/cases/verify-installed-package-deps-case.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/cases/verify-installed-package-deps-case.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -11,13 +11,13 @@ \hline \textbf{Preconditions:} & Package to be verified has a valid description. \\ \hline -\textbf{Triggers:} & abt verify-libs $<$pkg$>$ \\ +\textbf{Triggers:} & abt verify-deps $<$pkg$>$ \\ \hline \textbf{Basic Course of Events:} & \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item User submits a verify libraries request. + \item User submits a verify dependencies request. \item Dependency engine used to determine given packages dependency tree. \item Installed files for each dependency are checked for existence. \item Installed symlinks for each dependency are checked for existence. @@ -30,7 +30,7 @@ \textbf{Exceptions:} & none. \\ \hline \textbf{Postconditions:} & -The installed libraries for given package have been verified, eventual discrepencies have been reported. \\ +The installed libraries for given package have been verified, eventual discrepancies have been reported. \\ \hline \end{tabularx} Modified: docs/requirements/trunk/scenarios/fix-package-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/fix-package-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/fix-package-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,24 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt fix fortune'}. + \begin{enumerate} + \item \textbf{abt verify-files fortune} + \item \textbf{abt verify-symlinks fortune} + \item \textbf{abt verify-integrity fortune} + \end{enumerate} + \item depEngine requested to determine dependencies downtree for fortune. + \item Each package in downtree list is checked with: + \begin{enumerate} + \item \textbf{abt verify-files DOWNTREE-PKG} + \item \textbf{abt verify-symlinks DOWNTREE-PKG} + \item \textbf{abt verify-integrity DOWNTREE-PKG} + \end{enumerate} + \item User supplied with overview of any broken dependencies. + \item User offered to rebuild broken package list. + \item After rebuild, report broken and fixed packages. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,7 +33,7 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item No package name is given, process entire installed packages log. \end{enumerate} \vspace{0.05em} \end{minipage} Modified: docs/requirements/trunk/scenarios/log-package-install-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/log-package-install-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/log-package-install-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -21,6 +21,7 @@ \vspace{0.05em} \begin{enumerate} \item Installed files listed in \url{/etc/abt/tracking.info} will not be included in install log. + \item Files that are installed as symlinks to another file are noted in the install log. \end{enumerate} \vspace{0.05em} \end{minipage} Modified: docs/requirements/trunk/scenarios/purge-old-logs-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/purge-old-logs-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/purge-old-logs-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,16 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt purge-logs'}. + \item User is queried if old caches should also be removed. + \item Install log is accessed from \url{/var/log/abt/installed.log}. + \item Each package in \url{/var/state/abt/install/} is checked against the installed log. + \item Any package found not installed will be removed. + \item If user specified old caches to be removed, same check is done on \url{/var/state/abt/cached/} entries. + \item Note removed packages sources in journal. + \item Report amount of freed disk space to user. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,14 +25,12 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item Installed packages log is unavailable, warn user. + \item Package descriptions are unavailable, warn user. + \item If unsure about a package log or cache, default is to leave it in place. \end{enumerate} \vspace{0.05em} \end{minipage} \\ \hline -\end{tabularx} - -\newpage - - +\end{tabularx} \ No newline at end of file Modified: docs/requirements/trunk/scenarios/purge-old-package-sources-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/purge-old-package-sources-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/purge-old-package-sources-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,14 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt purge-src'}. + \item Install log is accessed from \url{/var/log/abt/installed.log}. + \item Each package description is accessed for sources name that appears in the install log. + \item In source storage \url{/var/spool/abt/}, any package sources found not installed will be removed. + \item Note removed packages sources in journal. + \item Report amount of freed disk space to user. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,14 +23,12 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item Installed packages log is unavailable, warn user. + \item Package descriptions are unavailable, warn user. + \item If unsure about a package source, default is to remove it. \end{enumerate} \vspace{0.05em} \end{minipage} \\ \hline -\end{tabularx} - -\newpage - - +\end{tabularx} \ No newline at end of file Modified: docs/requirements/trunk/scenarios/verify-installed-package-deps-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/verify-installed-package-deps-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/verify-installed-package-deps-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,17 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt verify-deps fortune'}. + \item depEngine requested to determine dependencies downtree for fortune. + \item Each package in downtree list is checked with: + \begin{enumerate} + \item \textbf{abt verify-files DOWNTREE-PKG} + \item \textbf{abt verify-symlinks DOWNTREE-PKG} + \item \textbf{abt verify-integrity DOWNTREE-PKG} + \end{enumerate} + \item User supplied with overview of any broken dependencies. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,13 +26,11 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item depEngine unavailable, warn user. + \item Log actions to journal. \end{enumerate} \vspace{0.05em} \end{minipage} \\ \hline -\end{tabularx} - -\newpage - +\end{tabularx} \ No newline at end of file Modified: docs/requirements/trunk/scenarios/verify-installed-package-files-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/verify-installed-package-files-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/verify-installed-package-files-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,12 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt verify-files fortune'}. + \item Install log for \textbf{fortune} is accessed at \url{/var/state/abt/install/fortune/fortune-mod-9807.install}. + \item Each file is checked for exitance. + \item User supplied with overview of any missing files. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,13 +21,11 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item Install log unavailable, warn user. + \item No files fail the check, inform user. \end{enumerate} \vspace{0.05em} \end{minipage} \\ \hline -\end{tabularx} - -\newpage - +\end{tabularx} \ No newline at end of file Modified: docs/requirements/trunk/scenarios/verify-installed-package-integrity-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/verify-installed-package-integrity-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/verify-installed-package-integrity-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,13 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt verify-integrity fortune'}. + \item Install log for \textbf{fortune} is accessed at \url{/var/state/abt/install/fortune/fortune-mod-9807.install}. + \item Integrity log for \textbf{fortune} is accessed at \url{/var/state/abt/install/fortune/fortune-mod-9807.integrity}. + \item Each file is checked for integrity. + \item User supplied with overview of any files failing check. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,13 +22,12 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item Install log unavailable, warn user. + \item Integrity log unavailable, warn user. + \item No files fail the integrity check, inform user. \end{enumerate} \vspace{0.05em} \end{minipage} \\ \hline -\end{tabularx} - -\newpage - +\end{tabularx} \ No newline at end of file Modified: docs/requirements/trunk/scenarios/verify-installed-package-symlinks-scenario.tex =================================================================== --- docs/requirements/trunk/scenarios/verify-installed-package-symlinks-scenario.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios/verify-installed-package-symlinks-scenario.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -7,9 +7,12 @@ \textbf{Use Case Steps:} & \begin{minipage}{\linewidth} \vspace{0.05em} - \begin{enumerate} - \item Steps - \end{enumerate} + \begin{itemize} + \item User command \textbf{'abt verify-symlinks fortune'}. + \item Install log for \textbf{fortune} is accessed at \url{/var/state/abt/install/fortune/fortune-mod-9807.install}. + \item Each file marked as a symlink is checked for exitance as symlink. + \item User supplied with overview of any symlinked files failing check. + \end{itemize} \vspace{0.05em} \end{minipage} \\ @@ -18,13 +21,11 @@ \begin{minipage}{\linewidth} \vspace{0.05em} \begin{enumerate} - \item Steps + \item Install log unavailable, warn user. + \item No files fail the check, inform user. \end{enumerate} \vspace{0.05em} \end{minipage} \\ \hline -\end{tabularx} - -\newpage - +\end{tabularx} \ No newline at end of file Modified: docs/requirements/trunk/scenarios.tex =================================================================== --- docs/requirements/trunk/scenarios.tex 2006-03-08 15:22:44 UTC (rev 70) +++ docs/requirements/trunk/scenarios.tex 2006-03-08 16:05:44 UTC (rev 71) @@ -60,14 +60,13 @@ \subsection{Fixing} Scenarios dealing with fixing package problems are detailed here. -TODO: 6 scenarios \input{scenarios/purge-old-package-sources-scenario.tex} -%\input{scenarios/purge-old-logs-scenario.tex} -%\input{scenarios/verify-installed-package-files-scenario.tex} -%\input{scenarios/verify-installed-package-symlinks-scenario.tex} -%\input{scenarios/verify-installed-package-deps-scenario.tex} -%\input{scenarios/verify-installed-package-integrity-scenario.tex} -%\input{scenarios/fix-package-scenario.tex} +\input{scenarios/purge-old-logs-scenario.tex} +\input{scenarios/verify-installed-package-files-scenario.tex} +\input{scenarios/verify-installed-package-symlinks-scenario.tex} +\input{scenarios/verify-installed-package-deps-scenario.tex} +\input{scenarios/verify-installed-package-integrity-scenario.tex} +\input{scenarios/fix-package-scenario.tex} \subsection{Patching} This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |