FM / examples

/usr/share/doc/lsof/examples

Name	Size	Mode	Actions
00MANIFEST	1807	0644	edit dl rm
00README	2045	0644	edit dl rm
big_brother.perl5.gz	2078	0644	edit dl rm
count_pf.perl	1849	0755	edit dl rm
count_pf.perl5	2022	0755	edit dl rm
identd.perl5	3304	0755	edit dl rm
idrlogin.perl.gz	2222	0644	edit dl rm
idrlogin.perl5.gz	2270	0644	edit dl rm
list_fields.awk.gz	1764	0644	edit dl rm
list_fields.perl.gz	1751	0644	edit dl rm
list_NULf.perl5.gz	1836	0644	edit dl rm
shared.perl5.gz	3571	0644	edit dl rm
sort_res.perl5	3719	0755	edit dl rm
watch_a_file.perl	2235	0755	edit dl rm
xusers.awk	3975	0755	edit dl rm

Edit: /usr/share/doc/lsof/examples/00README (2045B)

Notes on Using the Scripts in This Subdirectory

The scripts in this subdirectory are examples of post-processing
lsof field output.  Some are contributed by lsof users and are
reproduced substantially as written by those users.  Since the
scripts are examples, they are not guaranteed to work on all UNIX
dialects.  Use them to learn about processing field output, don't
expect them to be ready for production, and expect to be required
to modify them to make them work.

If you want to do field output post-processing in a C program, take
a look at the test suite C library in ../tests/LTlib.c.  You may
be able to adapt it to your needs.

The scripts are written in AWK, Perl 4 (4.036), and Perl 5 (5.001e
through 5.006).  AWK scripts have a suffix of ``.awk''; Perl 4
(which will work under Perl 5) scripts have a ``.perl4'' suffix;
and Perl 5 scripts, ``.perl''.

Supply AWK scripts to your AWK interpreter with its -f option.  Supply
lsof field output via a pipe -- e.g.,

lsof -F | awk -f list_fields.awk

The Perl scripts use the Unix command interpreter line feature to
specify the location of Perl -- i.e., the first line begins with
``#!'' and the path to the Perl interpreter follows.  If your system
supports the command interpreter feature, but your Perl interpreters
have different paths to them, just change the interpreter lines in
the scripts.  These scripts assume:

Path to:	Is:
	=======		==

Perl 4		/usr/bin/perl

Perl 5		/usr/bin/perl

If your system doesn't support the command interpreter feature,
you'll have to supply the scripts to your Perl interpreter on its
command line -- e.g.,

lsof -F | /<path_to_your_perl_4> list_fields.perl

The Perl scripts attempt to establish a path to lsof, putting their
result in the $LSOF variable.  Assuming you'll run them from the
scripts subdirectory, they look there first, then in the directories
of the PATH environment variable.  If that proves unsuitable, modify
the &isexec() subroutine calls in the scripts to suit your lsof
location.

Vic Abell
April 4, 2002

cmd: