crossed the Rubicon, and no, it wasn't fun

This commit is contained in:
albert 2002-10-06 21:34:17 +00:00
parent 97bf45a12b
commit 118854162d
12 changed files with 28 additions and 38 deletions

View File

@ -8,10 +8,10 @@ Michael K. Johnson <johnsonm@redhat.com>
Michael Shields <mjshield@nyx.cs.du.edu> Michael Shields <mjshield@nyx.cs.du.edu>
Charles Blake <cblake@bbn.com> Charles Blake <cblake@bbn.com>
David Mossberger-Tang David Mossberger-Tang
Albert Cahalan <acahalan@cs.uml.edu> Albert Cahalan <albert@users.sf.net>
skill/kill/snice: skill/kill/snice:
Albert Cahalan <acahalan@cs.uml.edu> Albert Cahalan <albert@users.sf.net>
tload: tload:
Branko Lankester Branko Lankester

32
BUGS
View File

@ -9,16 +9,21 @@ documentation!
Where to send Where to send
============= =============
Send comments, bug reports, patches, etc., to acahalan@cs.uml.edu Send comments, bug reports, patches, etc., to albert@users.sf.net
What to send What to send
============ ============
It is much more useful to me if a program really crases to recompile it It is much more useful to me if a program really crashes to recompile it
with make "CC=gcc -ggdb -O", run it with "gdb prog" and "run" and send with make "CC=gcc -ggdb -O", run it with "gdb prog" and "run" and send
me a stack trace ('bt' command). That said, any bug report is still me a stack trace ('bt' command). That said, any bug report is still
better than none. better than none.
strace and ltrace output are very helpful:
strace -o output-file ps --blah
bzip2 output-file
It might be nice to get rid of miscellaneous compiler warnings, but It might be nice to get rid of miscellaneous compiler warnings, but
don't bend over backwards to do it. don't bend over backwards to do it.
@ -33,29 +38,20 @@ code was compiled.
A macro is provide in libproc/version.h to construct the code from its A macro is provide in libproc/version.h to construct the code from its
components, e.g. components, e.g.
if (linux_version_code < LINUX_VERSION(1,1,30)) if (linux_version_code < LINUX_VERSION(2,5,41))
/* tty field is only a minor */ /* blah blah blah */
A startup call to set_linux_version may also be necessary. A startup call to set_linux_version may also be necessary.
Of course, if a bug is due to a change in kernel file formats, it would Of course, if a bug is due to a change in kernel file formats, it would
be best to first try to generalize the parsing, since the code is then be best to first try to generalize the parsing, since the code is then
more resilient against future change. more resilient against future change.
If you send me patches which are specific to *compiling* on a particular
version of Linux include a "#if LINUX_VERSION_CODE > 1*0x10000+3*0x100+54"
markup of the patch so that the package may be compiled with older
kernels as well as the "latest and greatest". LINUX_VERSION_CODE is
#define'd in <linux/version.h>.
Note that you should not make patches specific to *compiling* on a
particular version of Linux unless there is nothing else you can do.
Also unified diffs (diff -u) are my preference, context diffs (diff -c ) Also unified diffs (diff -u) are my preference, context diffs (diff -c )
are kind of usable, and standard diffs (diff) are more useless than a are kind of usable, and standard diffs (diff) are more useless than a
generic text description of what you did. Just use generic text description of what you did. Just use
diff -u oldfile newfile diff -Naurd oldfile newfile
or or
diff -Naur old-procps-dir new-procps-dir diff -Naurd old-procps-dir new-procps-dir
to create your diffs and you will make me happy. Also make sure to to create your diffs and you will make me happy. Also make sure to
include a description of what the diff is for or I'm likely to ignore include a description of what the diff is for or I'm likely to ignore
it because of general lack of time... it because of general lack of time...
@ -63,12 +59,8 @@ it because of general lack of time...
Code Structure Code Structure
============== ==============
My ultimate goal for this package is to be compilable with any kernel
headers and to be able to run under any kernel's /proc. (Don't bother
telling me that I'm not especially close to my ultimate goal... who
is? :-)
Anyhow, another goal is to encapsulate *all* parsing dependent on /proc A goal is to encapsulate *all* parsing dependent on /proc
file formats into the libproc library. If the API is general enough file formats into the libproc library. If the API is general enough
it can hopefully stabilize and then /proc changes might only require it can hopefully stabilize and then /proc changes might only require
updating libproc.so. Beyond that having the set of utilities be simple updating libproc.so. Beyond that having the set of utilities be simple

2
free.1
View File

@ -41,5 +41,5 @@ The \fB\-V\fP displays version information.
.SH AUTHORS .SH AUTHORS
Written by Brian Edmonds. Written by Brian Edmonds.
Send bug reports to <acahalan@cs.uml.edu> Send bug reports to <albert@users.sf.net>

4
kill.1
View File

@ -90,8 +90,8 @@ top(1) skill(1) kill(2) renice(1) nice(1)
This command meets appropriate standards. The -L flag is Linux-specific. This command meets appropriate standards. The -L flag is Linux-specific.
.SH AUTHOR .SH AUTHOR
Albert Cahalan <acahalan@cs.uml.edu> wrote kill in 1999 to replace the Albert Cahalan <albert@users.sf.net> wrote kill in 1999 to replace the
version that was not standards compliant. Michael K. Johnson version that was not standards compliant. Michael K. Johnson
<johnsonm@redhat.com> is the current maintainer of the procps collection. <johnsonm@redhat.com> is the current maintainer of the procps collection.
Please send bug reports to <acahalan@cs.uml.edu> Please send bug reports to <albert@users.sf.net>

View File

@ -7,7 +7,7 @@ Description: Procps is a library which parses the textual /proc filesystem
Keywords: procps /proc libproc Keywords: procps /proc libproc
ps uptime tload free w top vmstat watch skill snice kill pgrep pkill ps uptime tload free w top vmstat watch skill snice kill pgrep pkill
Author: Michael K. Johnson, Charles Blake, Albert Cahalan, many others. Author: Michael K. Johnson, Charles Blake, Albert Cahalan, many others.
Maintained-by: various <acahalan@cs.uml.edu> Maintained-by: various <albert@users.sf.net>
Primary-site: http://procps.sf.net/ Primary-site: http://procps.sf.net/
185kB procps-3.0.0.tar.gz 185kB procps-3.0.0.tar.gz
Alternate-site: http://www.debian.org/Packages/unstable/base/procps.html Alternate-site: http://www.debian.org/Packages/unstable/base/procps.html

View File

@ -112,8 +112,6 @@ top(1) kill(1) renice(1) nice(1)
No standards apply. No standards apply.
.SH AUTHOR .SH AUTHOR
Albert Cahalan <acahalan@cs.uml.edu> wrote skill and snice in 1999 as a Albert Cahalan <albert@users.sf.net> wrote skill and snice in 1999 as a
replacement for a non-free version. Michael K. Johnson <johnsonm@redhat.com> replacement for a non-free version, and is the current maintainer of the
is the current maintainer of the procps collection. procps collection. Please send bug reports to <albert@users.sf.net>
Please send bug reports to <acahalan@cs.uml.edu>

View File

@ -47,4 +47,4 @@ and update the display.
Branko Lankester, David Engel <david@ods.com>, and Branko Lankester, David Engel <david@ods.com>, and
Michael K. Johnson <johnsonm@redhat.com>. Michael K. Johnson <johnsonm@redhat.com>.
Please send bug reports to <acahalan@cs.uml.edu> Please send bug reports to <albert@users.sf.net>

4
top.1
View File

@ -1902,7 +1902,7 @@ them ol' bug-bytes (sic-sic)!
Bugs? What bugs? But, if ever there were, then... Bugs? What bugs? But, if ever there were, then...
Please send bug reports to: Please send bug reports to:
Albert D\. Cahalan, <acahalan@cs.uml.edu> Albert D\. Cahalan, <albert@users.sf.net>
[ thanks Albert, heaven forbid author should be bothered ] [ thanks Albert, heaven forbid author should be bothered ]
@ -1934,7 +1934,7 @@ This entirely new and enhanced replacement was written by:
With invaluable help from: With invaluable help from:
Craig Small, <csmall@small.dropbear.id.au> Craig Small, <csmall@small.dropbear.id.au>
Albert D\. Cahalan, <acahalan@cs.uml.edu> Albert D\. Cahalan, <albert@users.sf.net>
.ig .ig
.rj 2 .rj 2

2
top.c
View File

@ -15,7 +15,7 @@
*/ */
/* For their contributions to this program, the author wishes to thank: /* For their contributions to this program, the author wishes to thank:
* Craig Small, <csmall@small.dropbear.id.au> * Craig Small, <csmall@small.dropbear.id.au>
* Albert D. Cahalan, <acahalan@cs.uml.edu> * Albert D. Cahalan, <albert@users.sf.net>
*/ */
#include <sys/ioctl.h> #include <sys/ioctl.h>
#include <sys/resource.h> #include <sys/resource.h>

2
top.h
View File

@ -15,7 +15,7 @@
*/ */
/* For their contributions to this program, the author wishes to thank: /* For their contributions to this program, the author wishes to thank:
* Craig Small, <csmall@small.dropbear.id.au> * Craig Small, <csmall@small.dropbear.id.au>
* Albert D. Cahalan, <acahalan@cs.uml.edu> * Albert D. Cahalan, <albert@users.sf.net>
*/ */
#ifndef _Itop #ifndef _Itop
#define _Itop #define _Itop

View File

@ -26,7 +26,7 @@ This is the same information contained in the header line displayed by
was written by Larry Greenfield <greenfie@gauss.rutgers.edu> and was written by Larry Greenfield <greenfie@gauss.rutgers.edu> and
Michael K. Johnson <johnsonm@sunsite.unc.edu>. Michael K. Johnson <johnsonm@sunsite.unc.edu>.
Please send bug reports to <acahalan@cs.uml.edu> Please send bug reports to <albert@users.sf.net>
.SH "SEE ALSO" .SH "SEE ALSO"
.BR ps (1), .BR ps (1),
.BR top (1), .BR top (1),

2
w.1
View File

@ -81,4 +81,4 @@ was re-written almost entirely by Charles Blake, based on the version by Larry
Greenfield <greenfie@gauss.rutgers.edu> and Michael K. Johnson Greenfield <greenfie@gauss.rutgers.edu> and Michael K. Johnson
<johnsonm@redhat.com>. <johnsonm@redhat.com>.
Please send bug reports to <acahalan@cs.uml.edu> Please send bug reports to <albert@users.sf.net>