.../lsof_<version>/tests

This sub-directory contains support for lsof's test suite. Find

more information about the test suite in the 00TESTS file of the

lsof distribution, which should be in in the parent of this

subdirectory.

These tests can be activated from .. with:

$ make test

They can be activated from this directory with:

$ make

$ make test

$ make all

These tests are all written in C, so individual tests may be

activated by executing them directly -- e.g.,

$ ./LTlock

It may sometimes be necessary to use execution-time options

alter test behavior. (Some tests will suggest that when they

encounter certain kinds of errors.) See the 00FAQ and 00TEST files

in .. for more information.

These tests check lsof field output, not lsof text output. There

are no tests for lsof text output.

Here is a brief description of the files in this subdirectory:

00README this file

Add2TestDB a script to add the identity of the current

test to TestDB

CkTestDB a script to check the identity of this

dialect against the TestDB file

config.cc a file prepared by ../Configure that contains

the name (and possibly the path) to the C

compiler for the programs of this sub-directory

config.cflags a file prepared by ../Configure that contains

C compiler flags for the programs of this

sub-directory

config.libs a file prepared by ../Configure that contains

library load specifications -- i.e, make(1)

LDFLAGS

config.xobj a file prepared by ../Configure that contains

paths to any extra object files (*.o) needed

by the C programs in this directory

LsofTest.h lsof test definitions for C programs

LTbasic.c C source to basic lsof tests

LTbigf.c C source to a program that tests large file

sizes and offsets on dialects that support

file sizes > 32 bits

LTdnlc.c C source to a program that tests the

effectiveness of assembling path names from

the kernel's Dynamic Name Lookup Cache

(DNLC)

LTlib.c a support library in C

LTlock.c C source to a program that tests lock reporting

LTnfs C source to a program that tests for open NFS

files

LTnlink.c C source to a program that tests lsof's

reporting of open file link counts

LTsock.c C source to program that tests the finding

of IPv4 sockets

LTszoff.c C source to a program that tests file sizes

and offsets -- see LTbigf.c for a large

file (size > 32 bits) test

LTunix.c C source to a program that tests the finding

of UNIX domain sockets

Makefile the make(1) control file

The Makefile clean rule will not remove

config.* files, but the spotless rule will.

One the spotless rule has been used,

../Configure must be re-run.

TestDB a data base of dialects where the test

suite has been validated

Vic Abell

April 11, 2002