00README
1
2 .../lsof_<version>/tests
3
4This sub-directory contains support for lsof's test suite. Find
5more information about the test suite in the 00TESTS file of the
6lsof distribution, which should be in in the parent of this
7subdirectory.
8
9These tests can be activated from .. with:
10
11 $ make test
12
13They can be activated from this directory with:
14
15 $ make
16 $ make test
17 $ make all
18
19These tests are all written in C, so individual tests may be
20activated by executing them directly -- e.g.,
21
22 $ ./LTlock
23
24It may sometimes be necessary to use execution-time options
25alter test behavior. (Some tests will suggest that when they
26encounter certain kinds of errors.) See the 00FAQ and 00TEST files
27in .. for more information.
28
29These tests check lsof field output, not lsof text output. There
30are no tests for lsof text output.
31
32Here 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
101Vic Abell
102April 11, 2002
103