/usr/share/doc/samhain/manual.html/testsuite.html

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
<HTML
><HEAD
><TITLE
>The testsuite</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
REL="HOME"
TITLE="The Samhain Host Integrity Monitoring System"
HREF="index.html"><LINK
REL="UP"
TITLE="Compiling and installing"
HREF="installation.html"><LINK
REL="PREVIOUS"
TITLE="Files and directory layout"
HREF="layout.html"><LINK
REL="NEXT"
TITLE="General usage notes"
HREF="usage.html"><LINK
REL="STYLESHEET"
TYPE="text/css"
HREF="./docbook.css"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><!--#if expr="! ($HTTP_USER_AGENT = /MSIE/)"--><!--#include virtual="/resources/ssi/header.html"--><!--#endif --><DIV
CLASS="NAVHEADER"
><TABLE
SUMMARY="Header navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TH
COLSPAN="3"
ALIGN="center"
>The Samhain Host Integrity Monitoring System</TH
></TR
><TR
><TD
WIDTH="10%"
ALIGN="left"
VALIGN="bottom"
><A
HREF="layout.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="80%"
ALIGN="center"
VALIGN="bottom"
>Chapter 2. Compiling and installing</TD
><TD
WIDTH="10%"
ALIGN="right"
VALIGN="bottom"
><A
HREF="usage.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
></TABLE
><HR
ALIGN="LEFT"
WIDTH="100%"></DIV
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="TESTSUITE"
>2.11. The testsuite</A
></H1
><P
><SPAN
CLASS="APPLICATION"
>Samhain</SPAN
> comes with a suite of 
verification/regression tests located in the 
<TT
CLASS="FILENAME"
>test/</TT
> subdirectory of the source tree.</P
><P
>The driver script is <TT
CLASS="FILENAME"
>test/test.sh</TT
>. Calling it without
arguments will provide some usage information. The script should be called
as:</P
><PRE
CLASS="PROGRAMLISTING"
>test.sh [options] &lt;test_number&gt;</PRE
><P
>The driver script is <TT
CLASS="FILENAME"
>test/test.sh</TT
>. Calling it without
arguments will provide some usage information. The script should be called
as:</P
><PRE
CLASS="SCREEN"
><SAMP
CLASS="PROMPT"
>bash$ </SAMP
><KBD
CLASS="USERINPUT"
>test/test.sh [options] &lt;test_number&gt;</KBD
></PRE
><P
>The possible tests are:</P
><PRE
CLASS="PROGRAMLISTING"
>  1  -- Compile with many different options
  2  -- Hash function            
  3  -- Standalone init/check
  4  -- Microstealth init/check
  5  -- External program call    
  6  -- Controlling the daemon (signal handling)
  7  -- GnuPG signed files / prelude log
  8  -- Suidcheck
 10  -- Test client/server init/check      
 11  -- Test full client/server init/check 
 12  -- Test full client/server w/gpg      
 13  -- Test full client/server w/mysql    (only with --really-all)
 14  -- Test full client/server w/postgres (only with --really-all)
 all -- All tests (non-applicable tests will be skipped)</PRE
><P
>The recognized options are as follows:</P
><P
></P
><OL
TYPE="1"
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>-q|--quiet</I
></SPAN
>
      No output; success/failure is reported vi exit status only.
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>-v|--verbose</I
></SPAN
>
      Report additional information.
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>-s|--stoponerr</I
></SPAN
>
      Stop when a test fails.
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>--no-cleanup</I
></SPAN
>
      Don't clean up generated test data (useful to investigate
      the reason for a failure).
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>--srcdir=...</I
></SPAN
>
      Tell the script the location of the source tree (not necessary
      if run from the top source directory).
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>--color=always|never|auto</I
></SPAN
>
      Whether to use colour for output. Default is 'auto' (no colour
      if stdout is not a terminal).
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>--really-all</I
></SPAN
>
      This option enable additional test that are not run usually (see below).
    </P
></LI
></OL
><DIV
CLASS="NOTE"
><P
></P
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/note.gif"
HSPACE="5"
ALT="Note"></TD
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
><B
>The --really-all option</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>  This option enables the following additional tests: </P
><P
></P
><OL
TYPE="1"
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>smatch</I
></SPAN
>
      As part of the compile test suite (test 1), the 
      <SPAN
CLASS="APPLICATION"
>smatch</SPAN
> checker
      will be used (see smatch.sourceforge.net). Requires a appropriate
      setup (patched <SPAN
CLASS="APPLICATION"
>gcc</SPAN
> in 
      <TT
CLASS="FILENAME"
>/usr/local/gcc-smatch/bin/</TT
>,
      smatch scripts in <TT
CLASS="FILENAME"
>../sm_scripts</TT
>.
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>prelude logging</I
></SPAN
>
      Logging to <SPAN
CLASS="APPLICATION"
>prelude</SPAN
> will be tested
      as part of test 7. Requires prelude-manager, and requires that
      samhain is already registered as analyzer. This test is designed
      such that it should not interfere with an eventually 
      running instance of prelude-manager.
    </P
></LI
><LI
><P
>      <SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>mysql/postgresql logging</I
></SPAN
>
      Logging to <SPAN
CLASS="APPLICATION"
>mysql</SPAN
> and/or 
      <SPAN
CLASS="APPLICATION"
>postgresql</SPAN
>will be tested
      with tests 13/14. Requires a running database with an existing 
      default setup (database/user/password = samhain/samhain/samhain,
      table = log). 
    </P
></LI
></OL
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="WARNING"
><P
></P
><TABLE
CLASS="WARNING"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="./stylesheet-images/warning.gif"
HSPACE="5"
ALT="Warning"></TD
><TH
ALIGN="LEFT"
VALIGN="MIDDLE"
><B
>CAVEAT</B
></TH
></TR
><TR
><TD
>&nbsp;</TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
>  The database tests (13/14) with --really-all will modify (i.e. log to)
  the database. These are the only tests that are not confined to the
  directory where the test is run.
  </P
></TD
></TR
></TABLE
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><HR
ALIGN="LEFT"
WIDTH="100%"><TABLE
SUMMARY="Footer navigation table"
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="layout.html"
ACCESSKEY="P"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
ACCESSKEY="H"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="usage.html"
ACCESSKEY="N"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Files and directory layout</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="installation.html"
ACCESSKEY="U"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>General usage notes</TD
></TR
></TABLE
></DIV
><!--#if expr="! ($HTTP_USER_AGENT = /MSIE/)"--><!--#include virtual="/resources/ssi/footer.html"--><!--#endif --></BODY
></HTML
>
samhain 3.1.0-7build1 / usr / share / doc / samhain / manual.html / testsuite.html
