diff options
author | Lorry <lorry@roadtrain.codethink.co.uk> | 2012-09-18 15:30:56 +0100 |
---|---|---|
committer | Lorry <lorry@roadtrain.codethink.co.uk> | 2012-09-18 15:30:56 +0100 |
commit | e2467c77a44e22bda35287308b4b9fa920e41511 (patch) | |
tree | e1710a1276ae52d5c3aa0270d9ab2553c19a5307 | |
download | lsof-e2467c77a44e22bda35287308b4b9fa920e41511.tar.gz |
Tarball conversion
-rw-r--r-- | 00.README.FIRST_4.83 | 29 | ||||
-rw-r--r-- | README.lsof_4.83 | 128 | ||||
-rw-r--r-- | RELEASE.SUMMARY_4.83 | 345 | ||||
-rw-r--r-- | lsof_4.83_src.tar | bin | 0 -> 4244480 bytes | |||
-rw-r--r-- | lsof_4.83_src.tar.sig | bin | 0 -> 152 bytes |
5 files changed, 502 insertions, 0 deletions
diff --git a/00.README.FIRST_4.83 b/00.README.FIRST_4.83 new file mode 100644 index 0000000..e29daa7 --- /dev/null +++ b/00.README.FIRST_4.83 @@ -0,0 +1,29 @@ +A tour of the lsof_4.83 distribution: + + 00.README.FIRST_4.83 is this file. + + README.lsof_4.83 contains distribution and security information. + + RELEASE.SUMMARY_4.83 contains a summary of the lsof 4.83 + distribution. + + lsof_4.83_src.tar is the lsof 4.83 source tar archive. + + lsof_4.83_src.tar.sig is a detached GPG certificate for + lsof_4.83_src.tar. + +I suggest you follow these steps: + +1. Read 00.README.FIRST_4.83. + +2. Read README.lsof_4.83 and follow its instructions to verify + the authenticity of lsof_4.83_src.tar. + +3. Unpack lsof_4.83_src.tar -- use `tar xf lsof_4.83_src.tar`. + That will produce an lsof_4.83_src sub-directory. + +4. Change to the lsof_4.83_src sub-directory and read its + 00.README.FIRST file. + +Vic Abell <abe@purdue.edu> +Mon Jan 18 14:11:46 EST 2010 diff --git a/README.lsof_4.83 b/README.lsof_4.83 new file mode 100644 index 0000000..ef3b568 --- /dev/null +++ b/README.lsof_4.83 @@ -0,0 +1,128 @@ + + Information About This Lsof Distribution + + +What You Have +============= + +If you got this far without being confused, then you are probably +familiar with the construction of the lsof distribution or you have +read RELEASE.SUMMARY_4.83. If either is the case, please skip to +the Inventory section. If you haven't read RELEASE.SUMMARY_4.83, +I suggest you do it now, because it explains how the lsof distribution +is constructed and other useful things about lsof, including a +summary of changes for the past few lsof revisions. + +Even though you may have thought you were getting lsof.tar.bz2, +lsof.tar.gz or lsof.tar.Z with ftp, you really got lsof_4.83.tar.bz2, +lsof_4.83.tar.gz or lsof_4.83.tar.Z. That's because the triplet of +lsof.tar.* files are symbolic links to their longer-named counterparts. + +The bzip2'd, gzip'd or compressed tar files with lsof_, followed by a +number, are wrapper archives, designed to package the lsof source +archive, this file, other documentation files, and a GPG authentication +certificate together. + +The number, 4.83, is the lsof revision number. When you bunzip2'd, +gunzip'd or uncompressed lsof_4.83.tar.* and used tar to unpack +lsof_4.83.tar, you got: 00.README.FIRST_4.83, describing the contents +of lsof_4.83; README.lsof_4.83; lsof_4.83_src.tar; and +lsof_4.83_src.tar.sig. All are identified with the revision number. +You're reading README.lsof_4.83. lsof_4.83_src.tar.sig is a GPG +certificate that authenticates the lsof source archive, +lsof_4.83_src.tar. + +After you read the Inventory and Security sections, and hopefully +after you check the GPG certificate, unpack the lsof_4.83_src.tar +source archive and you will get a sub-directory, named lsof_4.83_src, +that contains the lsof 4.83 source distribution. + + +Inventory +========= + +Once you have unpacked lsof_4.83_src.tar.tar, you can check +lsof_4.83_src for completeness by changing to that sub-directory +and running the Inventory script. The lsof_4.83_src/Configure +script runs the Inventory script, too. The Configure script also +calls a customization script, called Customize. You can direct +Configure to avoid calling Inventory and Customize with the -n +option. + +See the Distribution Contents section of the 00DIST file and The +Inventory Script section of the 00README file for more information +on the contents of the lsof distribution, and the Configure, +Customize and Inventory scripts. The 00DIST and 00README files +will be found in the lsof_4.83_src sub-directory you just created. + + +Security +======== + +The md5 checksum for lsof_4.83_src.tar is: + + MD5 (lsof_4.83_src.tar) = d04045ba24b0e3632678989155b2786f + +A good source for an MD5 checksum computation tool is the OpenSSL +project whose work may be found at: + + www.openssl.org + +You can use the openssl "dgst" operator to compute an MD5 checksum -- +e.g., + + $ openssl dgst -md5 lsof_4.83_src + +The old-style sum(1) checksum for lsof_4.83_src.tar (Please read +the next paragraph if you don't get this value.) is: + + 64937 8290 lsof_4.83/lsof_4.83_src.tar + +If your dialect's sum(1) program defaults to the new style algorithm +(e.g., Solaris), you may have to use its -r option (or use the +Solaris /usr/ucb/sum). If your Unix dialect doesn't have a sum(1) +program (e.g., FreeBSD, or NetBSD), use its cksum(1) program with +the -o1 option to get an old-style checksum. You may also need to +ignore the block count, depending on the block size used on your +your system (i.e., 512 or 1,024). The sum(1) that produced the +above checksum considers block size to be 512; in contrast the BSD +cksum(1) programs' -o1 option considers block size to be 1,024. + +lsof_4.83_src.tar.sig is a GPG certificate file, using my public +key. My key may be available on some public key servers under the +names: + + Victor A. Abell <abe@cc.purdue.edu> + or + Victor A. Abell <abe@purdue.edu> + +You will also find it at: + + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/Victor_A_Abell.gpg + +Get my key and install it in your public key ring. + +Once my key is installed, use this command to check the certificate +of lsof_4.83_src.tar: + + gpg --verify lsof_4.83_src.tar.sig lsof_4.83_src.tar + +If the certificate check isn't good, lsof_4.83_src.tar is suspect. +Report the problem to me via e-mail at <abe@purdue.edu>. + +If you don't have GPG, you can compare the md5 checksum of +lsof_4.83_src.tar to the value listed in this file. However, that +is a less reliable authentication method, since it can't detect +changes to both lsof_4.83_src.tar and the md5 checksum value listed +in this tile. + +Other Security +============== + +Signature information for the distribution file that contains +this file may be found in the CHECKSUMS file that is located +where the distribution file was found. + + +Victor A. Abell <abe@purdue.edu> +Mon Jan 18 14:11:45 EST 2010 diff --git a/RELEASE.SUMMARY_4.83 b/RELEASE.SUMMARY_4.83 new file mode 100644 index 0000000..b72f072 --- /dev/null +++ b/RELEASE.SUMMARY_4.83 @@ -0,0 +1,345 @@ + lsof (LiSt Open Files) version 4 + (revision 4.83) + + + ******************************************************************** + | The latest release of lsof is always available via anonymous ftp | + | from lsof.itap.purdue.edu. Look in pub/tools/unix/lsof. | + ******************************************************************** + +****************************************************************************** +| CHECK THE PATCHES/ SUBDIRECTORY FOR FIXES TO THE LATEST LSOF DISTRIBUTION. | +****************************************************************************** + + ************************************************************************** + | AVOID USING PRE-BUILT LSOF BINARIES: SEE THE "PRE-BUILT LSOF BINARIES" | + | SECTION IN 00README FOR AN EXPLANATION. | + ************************************************************************** + + ********************************************************************** + | READ 00LSOF-L FOR INFORMATION ON THE LSOF-L LISTSERV MAILING LIST. | + ********************************************************************** + + ********************************************************************* + | CHECK 00FAQ BEFORE REPORTING BUGS TO <abe@purdue.edu>. | + | 00FAQ ALSO AT: ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/FAQ | + ********************************************************************* + + ******************************************************************** + | IMPORTANT! This README file explains how the lsof tar archive | + | is assembled -- it's a "wrapper" tar archive. Please read the | + | explanation of its naming and construction, immediately | + | following the initial list of supported dialects. | + ******************************************************************** + + +Lsof version 4 lists open files for running UNIX processes. It is a +descendent of ofiles, fstat, and lsof versions 1, 2, and 3. It has +been tested recently on these UNIX dialects. + + AIX 5.3 + Apple Darwin 9 (Mac OS X 10.5) + FreeBSD 4.9 for x86-based systems + FreeBSD 7.[012], 8.0 and 9.0 for AMD64-based systems + Linux 2.1.72 and above for x86-based systems + Solaris 9, 10 and 11 + +Lsof 4 may work on other versions of these dialects, but hasn't been +tested there recently. Lsof versions 2 and 3 are still available and +may provide older dialect version support. See the notes on them in +this file. + +The pub/tools/unix/lsof/contrib directory on lsof.itap.purdue.edu also +contains information on other ports. + +Version 4 of lsof is distributed as bzip2'd, gzip'd and compressed tar +archives in the files: + + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/lsof.tar.bz2 + and + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/lsof.tar.gz + and + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/lsof.tar.Z + +These files are links to the current distribution, whose name includes +the revision number: + + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof_<rev>.tar.bz2 + and + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof_<rev>.tar.gz + and + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof_<rev>.tar.Z + +<rev> is the revision number -- e.g., 4.83. These archives are called +wrappers, because the lsof source tar archive, its GPG certificate +(lsof_<rev>_src.tar.sig), and some documentation files are wrapped +together inside them. (The GPG certificate authenticates the source +tar archive.) A tar archive with: a ``.bz2'' suffix has been +compressed with bzip2; ``.gz'', with gzip; and ``.Z'', with compress. + +When the wrapper tar is gunzip'd or uncompressed, and its tar archive +contents are extracted, an lsof_4.83 subdirectory is created in the +directory where the extraction was performed. The lsof_4.83 +subdirectory contains these files: + + 00.README.FIRST contains introductory distribution + information. + + README.lsof_4.83 contains instructions for the + security-conscious on how to be + sure that no one has tampered with + the distribution. + + RELEASE_SUMMARY_4.83 is this file. + + lsof_4.83_src.tar is a tar archive, containing the + lsof sources. When extracted with + tar it creates a subdirectory named + lsof_4.83_src in the directory + where the extraction was performed. + The lsof source files will be found + in lsof_4.83_src. + + lsof_4.83_src.tar.sig is a GPG certificate, authenticating + the lsof_4.83_src.tar archive. See the + README.lsof_4.83 file for more + information on GPG authentication of + lsof_4.83_src.tar. + +If you've obtained this file and an lsof distribution from a mirror +site, please be aware that THE LATEST VERSION OF LSOF IS AVAILABLE VIA +ANONYMOUS FTP FROM LSOF.ITAP.PURDUE.EDU IN THE PUB/TOOLS/UNIX/LSOF +DIRECTORY. + +Patches to lsof distributions may be found in the patches/ sub- +directory where you found lsof.tar.bz2, lsof.tar.gz or lsof.tar.Z. +If there are any patches to the current distribution, they will be +found in the patches/4.83/ branch. + +(If you need a copy of gunzip, look for it at prep.ai.mit.edu in +pub/gnu/gzip*.) + +* The March 25, 2009 revision (4.82): corrects an over-zealous test that + causes lsof to produce no ouput when the HASSECURITY and HASNOSOCKSECURITTY + have been specified at lsof build time; corrects Solaris 10 and above + <sys/utsname.h> include/compilation problem and eliminates other Solaris + 10 compilation warnings; supports FreeBSD 7.1-PRELEASE; incorporates + changes to Darwin lsof, supplied by Apple; enables FreeBSD use of the + ${MAKE} variable; improves Solaris VxFS library location test; updates + Solaris 10 ZFS support to ZFS pool version 10; updates interpretation of + Solaris 10 device numbers; adds rudimentary Solaris 10 sharedfs support; + fixes a bug in Solaris 10 zone handling; adapts to changes in FreeBSD + 8.0-CURRENT device number computation; selects correct Solaris VxFS library + when configuring for gcc; adapts to loss of FreeBSD KAME IPv6 accommodations; + adapts to FreeBSD 7.2. + +* The January 18, 2010 revision (4.83): converts Solaris 10 and above ZFS + support to use the CTF library, libctf; fixes a typo with the + LINUX_HASSELUNIX Configure variable; accepts LSOF_RANLIB from the + environment; enables Solaris 10 compilation after a recent PC file system + patch; ported to Solaris 11; adjusts to disappearance of <nfs/rpcv2.h> from + FreeBSD 8.0-BETA; improves Solaris node type lookup; supports FreeBSD + 9.0-CURRENT; extends a FreeBSD 9 fix to FreeBSD 6 and above; added Linux + test for __UCLIBC__. + + +Read the 00.README.FIRST in the lsof distribution first. + +Read the 00DIST distribution file for more details on feature additions +and bug fixes. + +The 00README distribution file has build instructions, dialect +descriptions, special feature discussions, and installation hints. + +The 00FAQ file contains a list of frequently asked questions and their +answers. + +The 00DCACHE file explains device cache file path formation. + +The 00PORTING file contains information on porting lsof to other UNIX +dialects. + +The 00QUICKSTART file gives a quick introduction to using lsof. + +The distribution files lsof.8 (nroff source) and lsof.man (nroff +formatted output) contain the manual page for lsof; it is the only +other documentation besides the source code (it's included). + + +Version 4 Binaries +================== + +Version 4 binaries for some revisions, dialects, and platforms may be +found in pub/tools/unix/lsof/binaries. Check the README files for +exact descriptions. Check the dialect-specific Makefiles for +installation instructions. CHECKSUMS and GPG certificates are provided +for authentication. + +Please think very carefully before you decide to use a pre-built binary +instead of making your own from the sources. Here are some points to +consider: + +1. Lsof must run setgid or setuid. Are you willing to trust that + power to a binary you didn't construct yourself? + +2. Lsof binaries may be generated on a system whose configuration + header files differ from yours. Under Digital UNIX (DEC OSF/1), for + example, lsof includes header files from the machine's configuration + directory, /sys/<name>. Are you willing to gamble that your + configuration directory's header files match the ones used to + compile lsof? + +3. Lsof is often configured with specific options that are determined + from the configuration of the system on which it is configured -- + e.g., Solaris patch level, dynamic loader libraries, etc. Are you + sure that the lsof binary you retrieve will have been configured for + your system? If you get a binary that is misconfigured for you, it + may not work at all. + +If you haven't already guessed, I believe firmly that you should +retrieve sources and build your own binary. If you still want to use +the distribution binaries, please authenticate what you retrieved with +the GPG certificates; please compare checksums, too. + + +Version 4 Checksums +=================== + +Security checksums -- both MD5 and sum(1) -- for revisions of lsof +version 4 are contained in the README.lsof_<rev> files in the wrapper +tar archives of pub/tools/unix/lsof. + +The CHECKSUMS file, found with the distribution archives, contains +information on validating the archives with external MD5 checksums and +external GPG certificates. + + +GPG Certificates +================ + +The lsof wrapper tar archive includes a GPG certificate file in its +contained lsof_4.71_src.tar.sig file. + +Binary files have detached GPG certificates that may be found in their +directories with ".sig" extensions. + +The certificates are signed with my GPG public key, which may be found +in the file: + + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/Victor_A_Abell.gpg + +My key may also be available at some public key servers, + +There is also authentication information in the CHECKSUMS file (a link +to CHECKSUMS_<rev>), found with the lsof distribution files. CHECKSUMS +contains external MD5 checksums for the distribution files and +information on using the external GPG certificates, found with the lsof +distribution files. + + +Old Dialect Support +=================== + +Remnants of source code and binaries for dialects for which lsof once +provided support may be obtained by request. Send the request to +abe@purdue.edu. + +Dialects no longer supported include: + + CDC EP/IX + MIPS RISC/os + Motorola V/88 + Pyramid DC/OSx + Pyramid Reliant UNIX + Sequent DYNIX + SGI IRIX + SunOS 4.1.x + Ultrix + +Generally I drop support for a dialect when I no longer have access to +a test system. + + +Lsof Version 2 +============== + +The version 3 predecessor, revision 36 of version 2, is also available +upon request. Send the request to abe@purdue.edu. + +I recommend you avoid lsof version 2. It's out of date and I no +longer provide support for it. (Versions 3 and 4 support more +dialects, and have many enhancements, bug fixes, and improvements.) +Version 2 was tested on the following UNIX dialects: + + AIX 3.2.[1234] for the IBM RISC/System 6000 + DEC OSF/1 1.[23] and 2.0 for the DEC Alpha + EP/IX 1.4.3 and 2.1.1 for the CDC 4680 + ETAV 1.17 for the ETA-10P* + FreeBSD 1.0e for x86-based systems + HP-UX [789].x for HP systems + IRIX 4.0.5 and 5.1.1 for SGI systems + NEXTSTEP 2.1, 3.0, 3.1 for NeXT systems + Sequent Dynix 3.0.12 for Sequent Symmetry systems + SunOS 4.1.[123] for Sun 3 and 4 systems + SunOS 5.[13] (Solaris 2.[13]) for Sun 4 systems + Ultrix 2.2 and 4.2 for DEC systems + +(If you need a copy of gunzip, look for it at prep.ai.mit.edu in +pub/gnu.) + + +Version 2 Checksums +=================== + +MD5: + (OLD/lsof236tar.gz) = f8a1ab3971ea2f6a3ea16752f84409e8 + +sum(1): + 39996 106 OLD/lsof236tar.gz + +The file OLD/lsof236tar.gz.asc is a detached PGP certificate that may +be used to authenticate OLD/lsof236tar.gz with my PGP public key. You +may find my PGP public key at: + + ftp://lsof.itap.purdue.edu/pub/tools/unix/lsof/OLD/Victor_A_Abell.pgp + + +Lsof Version 3 +============== + +The last revision of lsof version 3, 3.88, may obtained by request. +Send the request to abe@purdue.edu. + +I recommend version 4 over version 3. It is the version I actively +support. + +Lsof version 3 was tested on these UNIX dialects: + + 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 2.0.3[01] and 2.1.57 for x86-based systems + NetBSD 1.0, 1.1, and 1.2 for x86 and SPARC-based + systems + NEXTSTEP 2.1 and 3.[0123] for NEXTSTEP architectures + 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 1.1, 3.0, and 5.0.[024] 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 + + +Vic Abell <abe@purdue.edu> +January 18, 2010 diff --git a/lsof_4.83_src.tar b/lsof_4.83_src.tar Binary files differnew file mode 100644 index 0000000..25b9143 --- /dev/null +++ b/lsof_4.83_src.tar diff --git a/lsof_4.83_src.tar.sig b/lsof_4.83_src.tar.sig Binary files differnew file mode 100644 index 0000000..90b7cbf --- /dev/null +++ b/lsof_4.83_src.tar.sig |