Notes for the distribution of lsof version 4

********************************************************************

| The latest release of lsof is always available via anonymous ftp |

| from lsof.itap.purdue.edu. Look in pub/tools/unix/lsof. |

********************************************************************

Contents

Dialects Supported

How Lsof Works

Lsof Output

Getting Started Quickly

Limiting, Filtering, and Selecting Lsof Output

Parsing Lsof Output with Another Program

Repeat Mode

Distribution Restrictions

Cautions

Distribution Contents

Warranty

Bug Reports

The lsof-l Mailing List

Version 3 Release Notes

3.0, May 24, 1994

...

3.88, February 17, 1997

What's New in Version 4

Version 4 Release Notes

4.0, February 24, 1997

4.01, March 3, 1997

4.02, March 21, 1997

4.03, April 7, 1997

4.04, April 17, 1997

4.04 supplement, April 18, 1997

4.05, April 24, 1997

4.06, April 30, 1997

4.07, May 12, 1997

4.08, May 23, 1997

4.09, June 1, 1997

4.10, June 8, 1997

4.11, June 12, 1997

4.12, June 24, 1997

4.13, July 9, 1997

4.14, July 22, 1997

4.15, August 15, 1997

4.16, September 25, 1997

4.17, October 14, 1997

4.18, October 25, 1997

4.19, October 30, 1997

4.20, November 11, 1997

4.21, December 1, 1997

4.22, December 15, 1997

4.23, January 16, 1998

4.24, January 28, 1998

4.25, February 7, 1998

4.26, February 17, 1998

4.27, March 6, 1998

4.28, March 10, 1998

4.29, March 26, 1998

4.30, April 9, 1998

4.31, April 21, 1998

4.32, May 13, 1998

4.33, May 22, 1998

4.34, June 26, 1998

4.35, July 17, 1998

4.36, August 4, 1998

4.37, September 15, 1998

4.38, November 25, 1998

4.39, December 29, 1998

4.40, January 25, 1999

4.41, February 27, 1999

4.42, March 30, 1999

4.43, May 11, 1999

4.44, June 24, 1999

4.45, July 30, 1999

4.46, October 23, 1999

4.47, November 29, 1999

4.48, January 14, 2000

4.49, April 3, 2000

4.50, June 29, 2000

4.51, August 21, 2000

4.52, November 8, 2000

4.53, December 6, 2000

4.54, January 19, 2001

4.55, February 15, 2001

4.56, May 3, 2001

4.57, July 19, 2001

4.58, September 13, 2001

4.59, October 20, 2001

4.60, November 9, 2001

4.61, January 22, 2002

4.62, March 7, 2002

4.63, April 23, 2002

4.64, June 26, 2002

4.65, October 10, 2002

4.66, December 22, 2002

4.67, March 27, 2003

4.68, June 18, 2003

4.69, October 16, 2003

4.70, January 16, 2004

4.71, March 11, 2004

4.72, July 13, 2004

4.73, October 21, 2004

4.74, January 17, 2005

4.75, May 16, 2005

4.76, August 30, 2005

4.77, April 10, 2006

4.78, April 24, 2007

4.79, April 15, 2008

4.80, May 12, 2008

4.81, October 21, 2008

4.82, March 25, 2009

4.83, January 18, 2010

4.84, July 29, 2010

4.85, September 27, 2011

Dialects Supported

==================

Lsof (for LiSt Open Files) lists files opened by processes on

selected Unix systems. Version 4 is a source reorganization of

version 3, itself a major revision of version 2. Version 4 has

been tested on:

AIX 5.3

Apple Darwin 9 and Mac OS X 10.[56]

FreeBSD 4.9 and 6.4 for x86-based systems

FreeBSD 8.[02] and 9.0 for AMD64-based systems

Linux 2.1.72 and above for x86-based systems

Solaris 9, 10 and 11

(The pub/tools/unix/lsof/contrib directory on lsof.itap.purdue.edu

contains information on other ports.)

If your favorite Unix dialect is not in the list, or if your version

of it is more recent than the ones listed, please contact me at

<[email protected]>.

Version 3 of lsof was tested on:

AIX 3.2.5, 4.1[.[1234]], and 4.2

BSDI BSD/OS 2.0, 2.0.1, and 2.1 for x86-based systems

DC/OSx 1.1 for Pyramid systems

Digital UNIX (DEC OSF/1) 2.0, 3.0, 3.2, and 4.0

EP/IX 2.1.1 for the CDC 4680

FreeBSD 1.1.5.1, 2.0, 2.0.5, 2.1, 2.1.5 for x86-based

systems

HP-UX 8.x, 9.x, 10.01, 10.10, and 10.20

IRIX 5.2, 5.3, 6.0, 6.0.1, and 6.[124]

Linux through 2.0.27 for x86-based systems

NetBSD 1.0, 1.1, and 1.2 for x86 and SPARC-based

systems

NEXTSTEP 2.1 and 3.[0123]

OpenBSD 1.2 and 2.0 for x86-based systems

Reliant UNIX 5.43 for Pyramid systems

RISC/os 4.52 for MIPS R2000-based systems

SCO OpenServer Release 1.1, 3.0, and 5.0.x for x86-based

systems

SCO UnixWare 2.1 and 2.1.1 for x86-based systems

Sequent PTX 2.1.[1569], 4.0.[23], 4.1.[024], 4.2[.1],

and 4.3

Solaris 2.[12345], 2.5.1, and 2.6-Beta

SunOS 4.1.x

Ultrix 4.2, 4.3, 4.4, and 4.5

Version 3 and its predecessor, version 2, may be found at:

ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/OLD

How Lsof Works

==============

Using available kernel data access methods -- getproc(), getuser(),

kvm_*(), nlist(), pstat(), read(), readx(), /proc -- lsof reads

process table entries, task table entries, user areas and file

pointers to reach the underlying structures that describe files

opened by processes.

Lsof interprets most file node structures -- advfsnodes, autonodes,

cnodes, cdrnodes, devnodes, fifonodes, gnodes, hsnodes, inodes,

mfsnodes, pcnodes, procnodes, rnodes, snodes, specnodes, s5inodes,

tmpnodes. It understands NFS connections. It recognizes FIFOs,

multiplexed files, Unix and Internet sockets. It knows about

streams. It understands /proc file systems for some dialects. On

many dialects it recognizes execution text and library references.

It knows about AFS on some Unix dialects.

Lsof Output

===========

The lsof output describes:

* the identification number of the process (PID) that has opened

the file;

* the process group identification number (PGID) of the process

(optional);

* the process identification number of the parent process (PPID)

(optional);

* the command the process is executing;

* the owner of the process;

* for all files in use by the process, including the executing

text file and the shared libraries it is using:

* the file descriptor number of the file, if applicable;

* the file's access mode;

* the file's lock status;

* the file's device numbers;

* the file's inode number;

* the file's size or offset;

* the name of the file system containing the file;

* any available components of the file's path name;

* the names of the file's stream components;

* the file's local and remote network addresses;

* the TLI network (typically UDP) state of the file;

* the TCP state, read queue length, and write queue length

of the file;

* the file's TCP window read and write lengths (Solaris

only);

* other file or dialect-specific values.

Getting Started Quickly

=======================

If you want to get started using lsof quickly, or see some examples

of how lsof can be used, consult the 00QUICKSTART file of the lsof

distribution.

The 00QUICKSTART file won't help you build or install lsof, but it

will cut through the density of the lsof man page, giving you more

readily an idea of what you can do with lsof.

For information on building and installing lsof, consult the 00README

file of the lsof distribution.

Limiting, Filtering, and Selecting Lsof Output

==============================================

Lsof accepts options to limit, filter, and select its output.

These are the possible criteria:

* Process ID (PID) number -- to list the open files for a given

process;

* Process Group ID (PGID) -- to list the open files for all

the processes of a given process group;

* User ID number or login name -- to list the open files for

all the processes of a given user;

* Internet address -- to list the open files using a given

Internet address (host name), protocol, or port (number or

name); or to list all open Internet files;

* command name;

* file descriptor name or number;

* list all open NFS files;

* list all open Unix domain socket files;

* list all uses of a specific file;

* list all open files on a file system.

Selection options are normally ORed -- i.e., an open file meeting

any of the criteria is listed. The selection options may be ANDed

so that an open file will be listed only if it meets all the

criteria.

In the absence of any selection criteria, lsof lists files open to

all processes.

Parsing Lsof Output with Another Program

========================================

The lsof -F option directs it to produce "field" output that can

easily be parsed by another program. The lsof distribution contains

sample awk, perl 4, and perl 5 scripts in its scripts subdirectory

that show how to post-process field output.

Repeat Mode

===========

Lsof can be directed to produce output, delay for a specified time,

then repeat the output, cycling until stopped by an interrupt or

quit signal. This mode is useful for monitoring the status of some

file operation -- e.g., an ftp transfer or a tape backup operation.

Repeat mode is more efficient when combined with lsof's selection

options, since they limit lsof overhead.

It's possible to use lsof's field output options to supply repeat

mode output to another process for its manipulation. The scripts

subdirectory of the lsof distribution has sample Perl scripts

showing how to consume lsof repeat mode output from a pipe.

Distribution Restrictions

=========================

Lsof may be used and distributed freely, subject to these limitations:

1. Neither the author nor Purdue University is responsible for

any consequences of the use of this software.

2. The origin of this software must not be misrepresented, either

by explicit claim or by omission. Credit to the author and

Purdue University must appear in documentation and sources.

3. Altered versions must be plainly marked as such, and must not

be misrepresented as being the original software.

4. This notice may not be removed from or altered in the lsof source

files.

Cautions

========

Lsof is a tool that is closely tied to the Unix operating system

version. It uses header files that describe kernel structures and

reads kernel structures that typically change from OS version to

OS version.

DON'T TRY TO USE AN LSOF BINARY, COMPILED FOR ONE UNIX OS VERSION,

ON ANOTHER.

On some Unix dialects, notably SunOS and Solaris, lsof versions

may be even more restricted by architecture type. An lsof binary,

compiled for SunOS 4.1.3 on a sun4c machine, for example, won't

work on a sun4m machine.

AN LSOF BINARY, COMPILED FOR ONE SOLARIS 1.X ARCHITECTURE, ISN'T

GUARANTEED TO WORK ON A DIFFERENT SOLARIS 1.X ARCHITECTURE.

Distribution Contents

=====================

The lsof distribution is checked for completeness when it is

constructed and by the Inventory script when you run the Configure

script. (See The Inventory Script section of the 00README file of

this distribution.)

Lsof is organized in these parts:

* The main lsof directory, containing common sources,

configuration and setup scripts and three subdirectories:

dialects/, lib/, and scripts/.

Lsof is compiled in the main lsof directory after configuration.

The selected dialect sources are copied or linked from the

specified subdirectory. (Symbolic linking is the standard

method.)

Common lsof definitions may be found in lsof.h; common

function prototypes, proto.h; and common storage, store.c.

* The dialects/ subdirectory contains subdirectories with

sources specific to UNIX dialect implementations -- e.g.,

the dialects/sun/ subdirectory contains sources for the

SunOS (Solaris 1.x) and Solaris (2.x) implementations of

lsof. The dialects subdirectories also contain Makefiles

and scripts for assisting dialect source configuration.

Dialect configuration definitions may be found in dlsof.h;

other dialect definitions, dlsof.h; dialect prototypes,

dproto.h; and dialect storage, dstore.c.

* The lib/ subdirectory contains sources for common lsof

functions. Not all dialects use the functions -- some have

their own versions of them. The lib/ functions are enabled

and customized with #define's in the dialect machine.h header

files.

* The scripts/ subdirectory contains sample scripts for

processing lsof field (-F) output. The scripts are written

in AWK, Perl 4, and Perl 5.

The 00PORTING file of the lsof distribution has more information

on lsof components, configuration, and construction.

Warranty

========

Lsof is provided as-is without any warranty of any kind, either

expressed or implied, including, but not limited to, the implied

warranties of merchantability and fitness for a particular purpose.

The entire risk as to the quality and performance of lsof is with

you. Should lsof prove defective, you assume the cost of all

necessary servicing, repair, or correction.

Bug Reports

===========

Now that the obligatory disclaimer is out of the way, let me hasten

to add that I accept lsof bug reports and try hard to respond to

them. I will also consider and discuss requests for new features,

ports to new dialects, or ports to new OS versions.

PLEASE DON'T SEND A BUG REPORT ABOUT LSOF TO THE UNIX DIALECT

VENDOR.

At worst such a bug report will confuse the vendor; at best, the

vendor will forward the bug report to me.

Please send all bug reports, requests, etc. to me via email at

<[email protected]>.

The lsof-l Mailing List

=======================

Information about lsof, including notices about the availability

of new revisions, may be found in mailings of the lsof-l listserv.

For more information about it, including instructions on how to

subscribe, read the 00LSOF-L file of the lsof distribution.

Version 3 Release Notes

=======================

See 00DIST in the last lsof 3 revision 3.88, for its complete

set of release notes. Lsof revision 3.88 may be found at:

ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/OLD

3.0 May 24, 1994

This is the first official release of lsof 3.

...

3.88 February 17, 1997

+======================================+

| This is the last version 3 revision. |

+======================================+

Added documentation files -- 00.README.FIRST[_<version>]

and 00RELEASE.SUMMARY_<version> -- to the distribution.

What's new in Version 4

=======================

The main goal of version 4 was to eliminate the confusing common/

fragment source file technique. Changing the version number also

provided an opportunity to restart the numbering, which at 3.88

had risen to a large value.

The sources that appeared in the dialects/common subdirectory of

version 3 in fragment files have been incorporated into the version

4 liblsof.a library as *.c files. This results in significant

changes to many source files, scripts, and Makefiles of all dialect

versions. It allows elimination of some source files -- ddev.c,

dfile.c, dmnt.c -- for dialects now obtaining functions from

liblsof.a that formerly came from making dialect source files by

combining fragment files.

The version 4 liblsof.a sources are stored in the lib/ subdirectory

of the main lsof directory. The liblsof.a functions are activated

and conditioned in their source files by values #define'd in the

dialect dlsof.h and machine.h header files.

Dialects that provide a private version of a library function refrain

from #define'ing the symbol that would activate the library function

code.

Version 4 Release Notes

=======================

4.0 February 24, 1997

+====================================+

| This is the first lsof 4 revision. |

+====================================+

Reorganized sources: eliminated code fragment files

and created a library in their place. Modified or

deleted many dialect source and header files.

Changed documentation accordingly.

Added a warning to sgi/Makefile and 00FAQ that advises

against using the IRIX C compiler -n32 option when

compiling lsof. Thanks go to Peter Ilieve

<[email protected]> for bringing this to my attention.

Dropped IRIX 5.2 in mid-stream, because my 5.2 test

system was upgraded to 5.3.

4.01 March 3, 1997

Added TFS support for Pyramid dialects.

Added test to Configure and to the IRIX dnode.c

for the different cnode struct that appears in

<cachefs/cachefs_fs.h> on the 6.2 IMPACT distribution.

Heddy Boubaker <[email protected]>

alerted me to the cnode change and helped test this

lsof adjustment.

Shut down the lsof child process before doing a -r

sleep(). A comment from Dan Mercer <[email protected]>

prompted this.

4.02 March 21, 1997

Based on a report from Pasi Kaara <[email protected]>,

disabled HP-UX CCIT support in lsof for HP-UX

versions 10 and above. Pasi's report also led to

changes in the HP-UX machine.h to support use of

gcc to compile lsof for HP-UX 10.20 and warnings

against using `cc -Aa` or `gcc -ansi` to compile

lsof under HP-UX 10.x.

With help from Richard Allen <[email protected]> taught

HP-UX 10.x lsof to name file systems better by

using the virtual file system device number. Elias

Halldor Agustsson <[email protected]> provided a test

system.

Changed NEXTSTEP and UNIXWARE Makefiles to use

safer quoting when generating version.h. The change

was suggested by Bob Farmer <[email protected]>.

Added SHELL=/bin/sh string to all Makefiles.

Added support for Linux 2.1.28 on a test system,

kindly provided by Jonathan Sergent <[email protected]>.

Configure tests the Linux 2.1.x's C library lseek()

function for proper handling of kernel offsets.

If lseek() appears suspect, Configure activates

the use of a private lseek() function. Changed

the private nlist() function to nlist_private()

and taught it to use the query_module() syscall in

place of the deprecated get_kernel_syms() one.

Added rudimentary AX.25 support for Pierfrancesco

Caci <[email protected]> who helped test it.

Updated the old get_kernel_syms() code to recognize

and skip module name entries.

Prompted by Marty Leisner <[email protected]>,

eased the requirement that service name lookup for

the -i option be accompanied by a protocol name. The

name is not needed if both TCP and UDP names yield the

same port number.

Added xusers.awk script from Dan Mercer <[email protected]>

to the distribution scripts/ subdirectory.

Changed Configure script to use LSOF_VERS for all

UNIX dialect version numbers and to pass LSOF_VERS

to the dialect Mksrc functions. Also added the

ability for a dialect stanza to declare a different

dialect Makefile source. Modified dialect Mksrc

files -- e.g., linux and sun -- accordingly.

Added support for BSD/OS 3.0 with help from Jim

Reid <[email protected]>. Terry Kennedy

<[email protected]> kindly provided a test

system. During the port corrected a bug that

prevented proper handling of revoked files.

4.03 April 7, 1997

At the suggestion of Dan Mercer <[email protected]>,

made HP-UX building of lsof aware of differences

between the HP-UX bundled and unbundled C compilers.

Added the ability for the lsof builder to define the

default warning message issuance state. By default the

issuance of warning messages is disabled; defining

WARNINGSTATE in machine.h disables it. The Customize

script was updated to handle WARNINGSTATE. Dan Mercer

suggested this.

Eliminated compiler complaint about improperly cast

get_Nl_value() argument in ncache_load() in lib/rnch.c.

Corrected zeromem() argument error in SCO dproc.c.

Sped up parent directory cache lookup slightly.

Updated for PTX 4.4, including additional VxFS (EFS)

file system support.

4.04 April 17, 1997

At the suggestion of Bela Lubkin <[email protected]>

changed device cache handling to be more tolerant

of a device cache file whose [cm]times are older

than the ones on /dev or /devices. The change

required adding information to Solaris device cache

file clone lines, so the first time lsof 4.04 is

run under Solaris it will complain about a bad

cached clone device in a previous device cache

file, then regenerate it.

Added boot file path detection for SCO OSR 5 and

above, based on information supplied by Bela.

Fixed two bugs in DEC OSF/1 lsof -- an error in

reporting locks and a missing continue statement

in readdev() after a failure to open a directory.

Jan Ole Suhr <[email protected]>

reported the second bug and supplied a fix.

Fixed XFS problems with IRIX 6.2 by abandoning the

idea that SGI will distribute XFS header files and

defining an lsof-private xfs_inode structure. John

Paul Morrison <[email protected]>

helped develop and test the 5.3 definition. John

R. Vanderpool <[email protected]> helped

develop and test the 6.2 definition.

Remove obsolete comments about common/*.frag files.

Updated Linux lsof for Linux version 2.1.35.

4.04 April 18, 1997

Supplement Regenerated the 4.04 distribution to correct a non-

device-cache #define misplacement in the Solaris and

SunOS dlsof.h. Alexandre Oliva <[email protected]>

reported the problem.

4.05 April 24, 1997

Corrected an error in 00DCACHE.

Made sure SCO /etc/ps/booted.systems is closed.

Based on an observation by Bela Lubkin <[email protected]>

that the lsof child had needless file descriptors

open, closed all but the open pipes between the

lsof parent and child.

Decommissioned CDC EP/IX support; I no longer have a

test system.

Based on a suggestion from Patrick Connor

<[email protected]>, added -xansi to CFLAGS

for IRIX 5.3 and 6.[234].

Also at Patrick's suggestion changed Configure to

propagate exact SunOS 4.1.x version to the main

and library Makefiles. This allowed the sunos413

and sunos413cc Configure abbreviations to be

shortened to sunos and sunoscc.

Updated obsolete argument uses (-H changed to -n)

in count_pf.perl* and watch_a_file.perl scripts.

Adjusted Solaris 2.6 lsof for Beta_Update with tips

from Casper Dik <[email protected]>.

Fixed a Solaris 2.4 TCP address reporting bug.

4.06 April 30, 1997

Added a step to the Makefile clean rules that does

a make clean in the lib subdirectory; suggested by

Casper Dik <[email protected]>. (Configure's

-clean argument already did this.)

Fixed an incorrect awk argument in the sunos*)

Configure stanza, reported by Alexandre Oliva

<[email protected]>.

Added CD9660 (aka ISO) file system support to

FreeBSD, NetBSD, and OpenBSD with mods and help

from Kenneth Stailey <[email protected]>.

(BSDI already had CD9660 support.) While at it,

added file descriptor system support to BSDI and

FreeBSD.

Added /kern file system support to OpenBSD. The

support wasn't extended to BSDI, FreeBSD, or NetBSD,

because it requires Kenneth Stailey's changes to

/sys/miscfs/kernfs/kernfs.h.

Updated IRIX 6.3 support after getting access to

a test system, provided by John Paul Morrison

<[email protected]>. Improved

the handling of IRIX 5.1 and greater FIFOs.

4.07 May 12, 1997

Based on AIX problem reports from David Capshaw

<[email protected]>, changed the aix*

Configure script stanza to avoid -bnolibpath for

gcc (which the GNU loader doesn't grok) and AIX

below 4.1.4 (where -bnolibpath hasn't been tested

or is known to be unimplemented), and to refuse to

use gcc for compiling lsof in AIX versions below

4.1 (because of possible structure alignment

problems). Updated 00FAQ appropriately.

Added OpenBSD support for EXT2FS. This support

has yet to be tested.

Tested lsof under OpenBSD 2.1.

Activated /kern file system support for NetBSD when

Configure senses that /sys/miscfs/kernfs/kernfs.h

defines the kern_target structure. This support

has not been tested under NetBSD, although it has

been tested under OpenBSD.

Made some simple changes to the BSDI machine.h,

suggested by Jeffrey C. Honig <[email protected]>.

Improved handling of alternate dialect Configure

abbreviations -- aix and aixgcc, hpux and hpuxgcc,

solaris and solariscc, and sunos and sunoscc.

4.08 May 23, 1997

Cleaned up dialect Makefile's, staring with a suggestion

from Christopher Schanzle <[email protected]>.

Improved Configure's -clean processing.

Corrected bugs in Solaris lock reporting.

Changed NetBSD Configure stanza to put -I/usr/include

before -I/sys.

4.09 June 1, 1997

Adjusted for latest FreeBSD 3.0 release. This

required adding a new kernel name cache module for

reading BSD-form hashed kernel name cache entries,

rnmh.c, to the lsof library, and adding a #define

to each machine.h to select it.

Activated rnmh.c for BSDI 2.1, BSDI 3.0, NetBSD

1.2, and OpenBSD 2.1.

4.10 June 8, 1997

Adjusted for Linux 2.1.x (x > 35) kernels with

hashed task structure pointers. Marty Leisner

<[email protected]> and Jonathan Sergent

<[email protected]> tested the adjustment.

Replaced readdev() stat() calls with lstat() to

reduce device table and cache entries with the same

device number and inode values. Added code to

remove all remaining duplicates. This fixes a

Linux problem reported by Jonathan Sergent and

makes device node name output predictable.

Corrected a bug in UnixWare stream file handling

that prevented searching for the stream file by

its associated character device name.

Added Pyramid code to determine Reliant UNIX clone

major device number differently from that of DC/OSx.

4.11 June 12, 1997

Changed Configure to sense that the PTX inp_[fl]addr

members of the inpcb structure of <netinet/in_pcb.h>

have a struct type and set HASINADDRSTR for use in

PTX dnode.c and dsock.c tests.

Changed PTX version 4.1.4 tests to use 4.1.3 instead.

Carson Wilson <[email protected]> reported the need

to do this and tested the change.

Fixed a block device table indexing bug in lib/rdev.c,

reported by Carson Wilson. The same bug was squashed

in pyramid/ddev.c.

Added code to the Pyramid Reliant UNIX kread()

function to compensate for an address boundary

error in the kernel's /dev/kmem driver.

Verified that lsof compiles and works under AIX

4.2.1. Added an AIX test for the presence of NFS

header files, defined HAS_NFS and adjusted AIX

dialect sources accordingly.

Based on a suggestion from Gaylord Holder

<[email protected]>, added DEC OSF/1 code to

auto-detect the booted file, whence kernel symbol

addresses are obtained.

4.12 June 24, 1997

Corrected a device number sign extension problem

in the reading and writing of device cache file.

The problem was reported by Bela Lubkin <[email protected]>

and he suggested a fix.

Fixed an SCO stream device lookup problem. The

report and solution came from Bela Lubkin

Enhanced the Configure script to enable cross-

configuration of lsof, based on suggestions from

Marty Leisner <[email protected]>. A new

documentation file, 00XCONFIG, describes the process.

Made Pyramid OBJFS support conditional on the

presence of supporting header files. Corrected

the Pyramid MkKernOpts script so it generates the

necessary -D's for the Nile/Jolt architecture.

Richard Coley <[email protected]> helped.

Added another IRIX xfs_inode variant for 6.2, 32

bits, no XFS rollup patch.

Tested under UnixWare 2.1.2.

4.13 July 9, 1997

Taught Pyramid lsof to grok ttyfs vnodes with help

from Richard Coley <[email protected]>. Fixed some

minor bugs in Pyramid FIFO reporting. Eliminated

use of the Pyramid UCB compatibility library at

Richard's suggestion.

Eliminated reporting of "strange" inode numbers

for SCO OSR 3.2v5.0.x HPPS files with help from

Bela Lubkin <[email protected]>

Modified port to service name lookup to use a small

number of getservbyport() calls before reading the

entire map with getservent(). Changed port reporting

to represent a zero as `*' to be consistent with

other prt number reporting tools like netstat.

Casper Dik <[email protected]> suggested these

changes -- the getserv*() one to improve performance

for large NIS service name maps.

Changed all readdev() functions to make the absence

of block devices a warning instead of a fatal error

after Brian Redman <[email protected]> reported his IRIX

6.4 system had no block devices. (It really did

have block devices, but readdev()'s lstat() use

caused it to miss them in a directory symbolically

linked from /dev/dsk->/hw/disk.) Fixed Brian's

real problem by changing the IRIX readdev() to use

stat() on /dev nodes if a Configure test shows /hw

is readable. Extended the potential to do the same

to all readdev() functions.

For consistency and convenience changed some

Configure abbreviations and dialect subdirectory

names: "decosf" abbreviation and "osf" dialect

subdirectory name to "du"; "netbsd" dialect

subdirectory name to "n+obsd"; "next3" abbreviation

and "next" dialect subdirectory name to "ns"; "sco"

abbreviation and dialect subdirectory name to "osr";

"sgi" dialect subdirectory name to "irix"; and

"unixware" abbreviation and dialect subdirectory

name to "uw".

Added #if/#endif clauses to the AIX rmdupdev()

function to avoid clone processing for AIX versions

less than 4.1.4. The problem was reported by Toralf

Foerster <[email protected]>, who

supplied corrective code.

Added support for new style NetBSD inode with i_ffs

and i_e2fs union members.

Improved Configure and 00FAQ information on Digital

UNIX configuration subdirectory with suggestions

from Brad Krebs <[email protected]>.

4.14 July 22, 1997

Reorganized the Solaris handling of the inode

structure header file, ufs_inode.h, to eliminate

VxFS structure definition conflicts for Solaris

2.4, based on information from Greg Earle

<[email protected]>.

Cleaned up some typos and confusion in Configure's

help output, based on comments from Bela Lubkin

<[email protected]>

Added a 00DIALECTS file, containing UNIX dialect

version numbers, that can be used by Configure and

the man page.

4.15 August 15, 1997

Aligned `Configure -help` output better. Removed

Configure's 2.6 Beta test adjustments.

Added improved Solaris VxFS configuration and

handling, based on information from Greg Earle

<[email protected]>.

Added socket state -- TCO or TPI -- for socket

files at the suggestion of Ian Fitchet

<[email protected]>.

4.16 September 25, 1997

Added reporting of TCP/TPI queue lengths and window

sizes ala netstat to NAME column. Added -T option

to select or de-select TCP/TPI info reporting.

(Window sizes are only reported for Solaris.)

Fixed anomalies along the way in SIZE/OFF processing

for some dialects.

Fixed service name argument processor to allow

minus signs as part of the name. Consequently this

disallows names with embedded minus signs from

being specified as the start of a range.

Added 00FAQ entries explaining why lsof won't find

a file being edited with vi, why window sizes aren't

reported for all dialects, and what the "no more

information" message means.

Forced Pyramid CC to be /usr/ccs/bin/cc to avoid

accidental use of the BSD variant in /usr/ucb/cc.

Added support for Linux glibc2, including a Configure

test; cross-Configure support (00XCONFIG); and much

unfortunate and risky sleight-of-hand in lsof Linux

dialect header and source files, forced upon lsof

by incompatibilities between Linux kernel and glibc2

header files.

Included in scripts/identd.perl5 a Perl 5 implementation

of an identd server, using lsof, provided by Kapil

Chowksey <[email protected]>.

Updated IRIX 6.4 xfs_inode guess.

4.17 October 14, 1997

Added -V option for verbose search result reporting.

Verbose reports are prepared for failure to locate

file names, command names, Internet addresses or

files, login names, NFS files, PIDs, PGIDs, and UIDs.

Augmented Linux NFS file test to cope with kernels

whose NFS code is in a loadable module. Need for

the test was pointed out by Jonathan Sergent

<[email protected]>. The change

required that Linux have private dmnt.c source,

Completed a Linux 2.1.57 port on a system provided

by Jonathan Sergent.

4.18 October 25, 1997

Eliminated memory leaks in alloc_lfile(), lkup_port(),

and NEXTSTEP's process_text() function.

Added recognition of OpenBSD 2.2 in Configure,

supplied by Kenneth Stailey <[email protected]>.

Consolidated print_file() functions to use the one

in lib/prtf.c. Made it configurable and changed

it to size print columns dynamically.

!!! WARNING !!!

WITH DYNAMICALLY SIZED PRINT COLUMNS LSOF 4.18

PRODUCES OUTPUT SIGNIFICANTLY DIFFERENT FROM THAT

OF PREVIOUS REVISIONS. LINES ARE GENERALLY SHORTER

AND THERE IS GENERALLY LESS BLANK SPACE BETWEEN

COLUMNS AND THE ITEMS IN THEM. THERE ARE NO LONGER

ANY SPACES BETWEEN DEVICE NUMBER ELEMENTS, ONLY

COMMAS.

!!! WARNING !!!

Added special types and print specification modifiers

for file size and offset to handle UNIX dialects

with 64 bit sizes and offsets. Paul Eggert

<[email protected]> reported the need for this

addition.

With Paul Eggert's help picked lint from the lsof

library, the main level lsof sources, and the Sun

dialect sources.

Added documentation, including the file 00LSOF-L,

about the lsof-l LISTSERV.