!!!NOTICE!!! !!!NOTICE!!! !!!NOTICE!!! !!!NOTICE!!! !!!NOTICE!!!! ! ! ! Revision 1.29 represents the end of life for lslk. I don't have time ! ! to support it. Please don't report bugs to me. I will politely ! ! decline to work on them. ! ! ! ! Vic Abell , July 11, 2001 ! ! ! !!!NOTICE!!! !!!NOTICE!!! !!!NOTICE!!! !!!NOTICE!!! !!!NOTICE!!!! lslk 1.29 -- lock file lister ********************************************************************* | The latest revision of lslk is always available via anonymous ftp | | from vic.cc.purdue.edu. Look in pub/tools/unix/lslk. | ********************************************************************* ******************************************************************** * IMPORTANT! This README file explains how the lslk tar file is * * assembled -- it's a "wrapper tar file. Please read the * * explanation of its naming and construction, immediately * * following the initial list of supported dialects. * ******************************************************************** Lslk version 1.29 lists information on files locked on these Unix Dialects: AIX 3.2.5, 4.1.4, and 4.2[.1] DEC OSF/1, Digital UNIX, Tru64 UNIX [2345].[01] and 3.2 Linux SCO OpenDesktop or OpenServer 3.0 and 5.[0245] Sequent PTX 2.1.9, 4.2.1, 4.3, and 4.4 Solaris 2.[345], 2.5.1, 2.6, 7, and 8 (excluding Veritas VxFS local files) SunOS 4.1.[34] Lslk is distributed as gzip'd and compressed tar archives in the files: pub/tools/unix/lslk/lslk.tar.gz and pub/tools/unix/lslk/lslk.tar.Z These files are links to the current distribution, whose name includes the revision number: pub/tools/unix/lslk__W.tar.gz and pub/tools/unix/lslk__W.tar.Z is the version number -- e.g., 1.29. The ``_W'' marks the tar file as a wrapper -- the source tar file is inside the wrapper. (A tar file with a ``.gz'' suffix is gzip'd; ``.Z'', compressed.) The wrapper method is used to join instruction and PGP certificate files with their source tar file. The PGP certificate file authenticates the source tar file. When the wrapper tar is gunzip'd or uncompressed, and its tar contents are extracted, three files are produced in the current directory where the extraction was performed: README.lslk_ contains instructions for the security-conscious on how to be sure that no one has tampered with the tar file. lslk_.tar is a tar file, containing the lslk sources. When extracted with tar it creates a subdirectory in the current directory where the extraction was performed, named lslk_. The lslk source files will be found in lslk_. lslk_.tar.asc is a PGP certificate, authenticating the lslk_.tar file. See the README.lslk_ file for more information on PGP authentication of lslk_.tar. If you've obtained this file and an lslk distribution from a mirror site, please be aware that THE LATEST VERSION OF LSLK IS AVAILABLE VIA ANONYMOUS FTP FROM VIC.CC.PURDUE.EDU (128.210.15.16) IN THE PUB/TOOLS/UNIX/LSLK DIRECTORY. (If you need a copy of gunzip, look for it at prep.ai.mit.edu in pub/gnu.) * The first revision of lslk (1.00) was issued January 10, 1996. * The June 7, 1996 revision (1.01) changed the output format to a single line per lock with dynamically sized columns. * The June 12, 1996 revision (1.02) added support for AIX 3.2.5 and 4.1.4. * The July 15, 1996 revision (1.03) added support for Solaris 2.5.1. * The July 26, 1996 revision (1.04) added support for Linux 1.3.68 and 1.3.83. * The August 19, 1996 revision (1.05): added support for Linux versions above 1.3; added support for Digit UNIX (nee DEC OSF/1) versions 2.0, 3.0, and 3.2. * The August 27, 1996 revision (1.06): corrected SunOS comments; added SCO Release 3.0 and 5.0 support; changed PID type cast to unsigned long; added sorting of output by PID. * The September 9, 1996 revision (1.07): added mandatory lock reporting for the SCO dialect. * The September 21, 1996 revision (1.08): was tested under AIX 4.2; corrected major device number reporting for SCO Release 5. * The October 29, 1996 revision (1.09): updated the SCO Configure stanza to use the full path for the nm command. * The March 31, 1997 revision (1.10): adds support for Solaris 2.6 Beta. * The April 8, 1997 revision (1.11): adds support for Sequent PTX 2.1.9, 4.2.1, 4.3, and 4.4 (PTX 2.1.9 lslk can't report locks held by NFS client processes.) * The June 12, 1997 revision (1.12): adds the -k option for specifying the path to the kernel name list file; adds kernel name list file auto-detection for Digital UNIX, Linux, and SCO; was tested under AIX 4.2.1 and Digital UNIX 4.0. * The October 22, 1997 revision (1.13): corrects a malloc pointer misuse in the Solaris dlock.c. * The January 9, 1998 revision (1.14): implements a /proc-based lslk for Linux; adds a size-available status flag to the internal lock structure (only used by the /proc-based Linux lslk); ignores AIX locks whose PID is zero. * The February 17, 1998 revision (1.15): enables correct compilation on an SCO system without NFS header files. * The March 27, 1998 revision (1.16): correctly selects the Digital UNIX system header file path. * The April 29, 1998 revision (1.17): adds support for Solaris 2.7. * The August 12, 1998 revision (1.18): corrects Digital UNIX AdvFS detection and updates the definition of its node structure. * The November 10, 1998 revision (1.19): adds support for Digitial Unix 5.0 Beta and SCO OpenServer 5.0.5. * The March 31, 1999 revision (1.20): adds support for a later release of DEC OSF/1, Digital UNIX, Tru64 UNIX 5.0. * The June 18, 1999 revision (1.21): adds support for new style AIX sysids (e.g., for AIX 4.3.x). * The June 25, 1999 revision (1.22): adds support for the latest Tur64 UNIX 5 Beta release. * The July 9, 1999 revision (1.23): adds support for 64 bit Solaris 7. * The July 13, 1999 revision (1.24): simplifies the 64 bit Solaris 7 port of revision 1.23; updates a Linux GlibC 2.0 readlink() compensation but that was fixed in GlibC 2.1. * The September 24, 1999 revision (1.25): only warns when the Solaris system lacks an lm_sysids table, because that's caused by the absence of a lock daemon. * The August 18, 2000 revision (1.26): adds support for Tru64 UNIX 5.1. * The Octover 22, 2000 revision (1.27): adds suport for Tru64 UNIX 5.x CFS files. * The January 8, 2001 revision (1.28): adds suport for Solaris 8. * The July 11, 2001 revision (1.29): adds Solaris enhancements; marks the end of life for lslk. See the CHANGELOG distribution file for more details on feature additions and bug fixes. The README distribution file gives background and installation information. The distribution files lslk.8 (nroff source) and lslk.man (nroff formatted output) contain the manual page for lslk; it is the only other documentation besides the source code (it's included). Binaries ======== I do not distribute lslk binaries. Binaries depend too closely on Unix dialect versions and should be constructed on the systems where they are to be run. Checksums ========= Security checksums -- both MD5 and sum(1) -- for lslk are contained in the README.lslk_ files in the wrapper tar files of pub/tools/unix/lslk. PGP Certificates ================ The lslk source tar and binary files are accompanied by PGP certificates in files that have an "asc" extension. The certificates are signed with my public key, which may be found in the file: pub/tools/unix/lslk/Victor_A_Abell.pgp My key is also available via public key servers and the URL: http://www-rcd.cc.purdue.edu/abe/ Vic Abell Purdue University Computing Center July 11, 2001