[Sysfence-commit] sysfence/dokprojektlic main.tex,1.4,1.5 speckonstrukcyjna.tex,1.1,1.2 specuzytkownika.tex,1.1,1.2 testowanie.tex,1.1,1.2

[mkoperto <mko...@us...>]

Update of /cvsroot/sysfence/sysfence/dokprojektlic
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv1255/sysfence/dokprojektlic

Modified Files:
	main.tex speckonstrukcyjna.tex specuzytkownika.tex 
	testowanie.tex 
Log Message:
+ mistake

Index: speckonstrukcyjna.tex
===================================================================
RCS file: /cvsroot/sysfence/sysfence/dokprojektlic/speckonstrukcyjna.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- speckonstrukcyjna.tex	26 May 2004 20:02:34 -0000	1.1
+++ speckonstrukcyjna.tex	29 May 2004 23:36:00 -0000	1.2
@@ -0,0 +1,10 @@
+\section{Specyfikacja konstrukcyjna}
+
+Program z za³o¿enia ma  
+
+\subsection{Podzia³ programu na modu³y}
+
+%modu³y + opis
+
+
+\subsection{}

Index: testowanie.tex
===================================================================
RCS file: /cvsroot/sysfence/sysfence/dokprojektlic/testowanie.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- testowanie.tex	26 May 2004 20:02:34 -0000	1.1
+++ testowanie.tex	29 May 2004 23:36:00 -0000	1.2
@@ -0,0 +1,19 @@
+\section{Testowanie}
+
+W celu u³atwienia uruchomienia i testowania aplikacji wprowadzili¶my
+dodatkow± opcjê kompilacji. Polecenie \texttt{make debug} 
+komiluje programpodczas swojej pracy wypisuje na standardowe wyj¶cie
+dodatkowe informacje. 
+
+Testowanie aplikacji podzielili¶my na $3$ g³ówne etapy; mianowicie na 
+testowanie:
+\begin{itemize}
+    \item czytania plików konfiguracyjnych i tworzenia regu³,
+    \item komunnikacji IPC,
+    \item obs³ugi sygna³ów.
+\end{itemize}
+Wszystkie b³êdy znalezione podczas testowania zosta³y usuniête.
+
+\subsection{Testowanie}
+\subsection{Testowanie komunikacji IPC}
+\subsection{Testowanie obs³ugi sygna³ów}

Index: specuzytkownika.tex
===================================================================
RCS file: /cvsroot/sysfence/sysfence/dokprojektlic/specuzytkownika.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- specuzytkownika.tex	26 May 2004 20:02:34 -0000	1.1
+++ specuzytkownika.tex	29 May 2004 23:36:00 -0000	1.2
@@ -0,0 +1,84 @@
+\section{Specyfikacja u¿ytkownika}
+
+\subsection{Kompilacja i uruchamianie programu}
+
+Kompilacja programu nastêpuje po wydaniu polecenia \texttt{make} w katalogu
+zawieraj±cym ¼ród³a.  Program uruchamiany jest poleceniem \texttt{sysfence} z 
+przynajmniej jednym argumentem wskazuj±cym na plik konfiguracyjny.  
+W przypadku gdy pliki konfiguracyjne
+nie zawieraj± b³êdów sk³adniowych program przechodzi
+do pracy jako demon.
+
+\subsection{Komunikacja z programem}
+
+Po uruchomieniu programu dla ka¿dej regu³y tworzony jest proces potomny.
+Proces rodzicielski odpowiedzialny jest za zbieranie informacji z systemu. 
+Informacje te udostêpniane s± procesom potomnym za pomoc± mechanizmów IPC.
+
+Ka¿dy proces otrzymuje swoj± nazwê. W przypadku procesu rodzicielskiego jest
+to \texttt{sffetch}, a w przypadku procesów potomnych \texttt{sfwatch}. Nazwy procesów
+dostêpne s± np. po wykonaniu polecenia
+\texttt{ps wxu} w kolumnie \texttt{COMMAND}. Podstawowe nazwy wzbogacane sa 
+o dodatkowe informacje:
+\begin{itemize}
+    \item \texttt{STOPPED} -- gdy proces zosta³ zatrzymany,
+    \item \texttt{EXEC} -- gdy proces potomny wykonuje polecenie pow³oki,
+    \item \texttt{'nazwa regu³y'} -- dla procesów potomnych.  
+\end{itemize}
+Informacje te umo¿liwiaj± okre¶lenie zadañ i stanów poszczególnych procesów.
+
+Komunikacja z procesmi odbywa siê za pomoc± sygna³ów. Przydatne sygna³y
+zamieszczone s± w tablicach~\ref{tab:s1} i~\ref{tab:s2}.   
+
+\begin{table}[ht]
+\centering
+\caption{Komunikacja z \texttt{sffetch}}
+\begin{tabular}{|c|p{8cm}|} \hline \label{tab:s1}
+\textbf{Sygna³} &  \multicolumn{1}{p{8cm}|}{\centering \textbf{Reakcja}} \\ \hline 
+\texttt{SIGUSR1} &  zatrzymuje proces \texttt{sffetch} i wszystkie 
+                    \texttt{sfwatch}\\ \hline
+\texttt{SIGCONT} &  wznawia wszystkie procesy\\ \hline
+\texttt{SIGTERM} &  poprawnie koñczy prace programu: wysy³a \texttt{SIGTERM} do wszystkich
+                    dzia³aj±cych procesów \texttt{sfwatch} oraz zwalnia wszystkie zasoby 
+                    (w szczególno¶ci IPC) \\ \hline
+\end{tabular} \end{table}
+ 
+\begin{table}[ht]
+\centering
+\caption{Komunikacja z \texttt{sffwatch}}
+\begin{tabular}{|c|p{8cm}|} \hline \label{tab:s2}
+\textbf{Sygna³} &  \multicolumn{1}{p{8cm}|}{\centering \textbf{Reakcja}} \\ \hline 
+\texttt{SIGUSR1} &  zatrzymuje monitorowanie regu³y \\ \hline
+\texttt{SIGCONT} &  wznawia monitorowanie regu³y\\ \hline
+\texttt{SIGTERM} &  poprawnie koñczy monitorowanie regu³y, pozosta³e
+                    regu³y s± nadal monitorowane\\ \hline
+\end{tabular} \end{table}
+
+Nie zaleca siê wysy³ania sygna³ów \texttt{SIGSTOP} i \texttt{SIGKILL} gdy¿ mog±
+spowodowaæ zak³ócenia w pracy pozosta³ych procesów aplikacji. 
+
+\subsection{Konfiguracja}
+
+Konfiguracja programu wczytywana jest z plików.  Ka¿dy plik mo¿e zwieraæ wiele regu³.
+Przyk³adowy plik \texttt{example.conf} z regu³ami dostêpny jest w katalogu \texttt{doc/}. 
+Poni¿ej zamieszczamy kilka przyk³adowych regu³.  
+\begin{verbatim}
+rule "" {
+    la1 >= 8.00
+} run once 'echo "SHOW FULL PROCESSLIST" | mysql | mail my...@em...'
+\end{verbatim}
+
+Parametrami monitorowanymi w wersji 0.12 programu s±:
+\begin{itemize}
+    \item \textbf{la1} -- obci±¿enie systemu w ostatniej minucie,
+    \item \textbf{la5} -- obci±¿enie systemu w ci±gu ostatnich $5$-ciu minut,
+    \item \textbf{la15} -- obci±¿enie systemu w ci±gu ostatnich $15$-stu minut,
+    \item \textbf{freemem} -- wolna pamiêæ RAM,
+    \item \textbf{usedswap} -- wykorzystana pamiêæ RAM,
+    \item \textbf{freeswap} -- wolna przestrzeñ wymiany (swap),
+    \item \textbf{useedswap} -- wykorzystana przesrzeñ wymiany (swap),
+    \item \textbf{freespace} -- wolna przesrzeñ dla systemu plików,
+    \item \textbf{usedspace} -- wykorzystana przestrzeñ dla systemu plików,
+    \item \textbf{availspace} -- dostêpne przestrzeñ dla systemu plików.   
+\end{itemize}
+

Index: main.tex
===================================================================
RCS file: /cvsroot/sysfence/sysfence/dokprojektlic/main.tex,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- main.tex	29 May 2004 17:53:36 -0000	1.4
+++ main.tex	29 May 2004 23:36:00 -0000	1.5
@@ -15,12 +15,15 @@
 % abstract
 \input{abstract}
 
+% table of contents
+\tableofcontents
+
 % tu dodawac rozdzialy:
 \input{wstep}
-%\input{specuzytkownika}
+\input{specuzytkownika}
 \input{wymagania}
 %\input{speckonstrukcyjna}
-%\input{testowanie}
+\input{testowanie}
 
 
 
@@ -31,7 +34,5 @@
 % bibliography
 %\input{bibliography}
 
-% table of contents
-\tableofcontents
 
 \end{document}