00README   [plain text]



		.../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