tests/00README

   1
   2                 .../lsof_<version>/tests
   3
   4 This sub-directory contains support for lsof's test suite.  Find
   5 more information about the test suite in the 00TESTS file of the
   6 lsof distribution, which should be in in the parent of this
   7 subdirectory.
   8
   9 These tests can be activated from .. with:
  10
  11     $ make test
  12
  13 They can be activated from this directory with:
  14
  15     $ make
  16     $ make test
  17     $ make all
  18
  19 These tests are all written in C, so individual tests may be
  20 activated by executing them directly -- e.g.,
  21
  22     $ ./LTlock
  23
  24 It may sometimes be necessary to use execution-time options
  25 alter test behavior.  (Some tests will suggest that when they
  26 encounter certain kinds of errors.)  See the 00FAQ and 00TEST files
  27 in .. for more information.
  28
  29 These tests check lsof field output, not lsof text output.  There
  30 are no tests for lsof text output.
  31
  32 Here is a brief description of the files in this subdirectory:
  33
  34     00README            this file
  35
  36     Add2TestDB          a script to add the identity of the current
  37                         test to TestDB
  38
  39     CkTestDB            a script to check the identity of this
  40                         dialect against the TestDB file
  41
  42     config.cc           a file prepared by ../Configure that contains
  43                         the name (and possibly the path) to the C
  44                         compiler for the programs of this sub-directory
  45
  46     config.cflags       a file prepared by ../Configure that contains
  47                         C compiler flags for the programs of this
  48                         sub-directory
  49
  50     config.libs         a file prepared by ../Configure that contains
  51                         library load specifications -- i.e, make(1)
  52                         LDFLAGS
  53
  54     config.xobj         a file prepared by ../Configure that contains
  55                         paths to any extra object files (*.o) needed
  56                         by the C programs in this directory
  57
  58     LsofTest.h          lsof test definitions for C programs
  59
  60     LTbasic.c           C source to basic lsof tests
  61
  62     LTbigf.c            C source to a program that tests large file
  63                         sizes and offsets on dialects that support
  64                         file sizes > 32 bits
  65
  66     LTdnlc.c            C source to a program that tests the
  67                         effectiveness of assembling path names from
  68                         the kernel's Dynamic Name Lookup Cache
  69                         (DNLC)
  70
  71     LTlib.c             a support library in C
  72
  73     LTlock.c            C source to a program that tests lock reporting
  74
  75     LTnfs               C source to a program that tests for open NFS
  76                         files
  77
  78     LTnlink.c           C source to a program that tests lsof's
  79                         reporting of open file link counts
  80
  81     LTsock.c            C source to program that tests the finding
  82                         of IPv4 sockets
  83
  84     LTszoff.c           C source to a program that tests file sizes
  85                         and offsets  -- see LTbigf.c for a large
  86                         file (size > 32 bits) test
  87
  88     LTunix.c            C source to a program that tests the finding
  89                         of UNIX domain sockets
  90
  91     Makefile            the make(1) control file
  92
  93                         The Makefile clean rule will not remove
  94                         config.* files, but the spotless rule will.
  95                         One the spotless rule has been used,
  96                         ../Configure must be re-run.
  97
  98     TestDB              a data base of dialects where the test
  99                         suite has been validated
 100
 101 Vic Abell
 102 April 11, 2002