summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMark Wong <markwkm@gmail.com>2008-08-28 18:06:15 -0700
committerMark Wong <markwkm@gmail.com>2008-08-28 18:06:15 -0700
commit8cbe8ef71fe67fde37a5492faccae85e905bfa51 (patch)
tree1a50c3567f13d7ec8d912089d6ef792e4f4b3fbc
parent5c1459f29690c1fc4e5a061400725bed1776b4c2 (diff)
Updated the README, TODO, and FAQ.
-rw-r--r--FAQ44
-rw-r--r--README37
-rw-r--r--TODO2
3 files changed, 18 insertions, 65 deletions
diff --git a/FAQ b/FAQ
index 25d368a..32583bc 100644
--- a/FAQ
+++ b/FAQ
@@ -1,5 +1,5 @@
pg_top
- Version 3.6.1
+ Version 3.7.0
Mark Wong
@@ -22,7 +22,8 @@
2. Where do I get the latest version of pg_top?
- If you have mercurial, you can download the latest version from SourceForge:
+ If you have mercurial, you can download the latest version from
+ SourceForge:
hg clone http://ptop.sourceforge.net/cgi-bin/hgwebdir.cgi/pg_top
@@ -116,24 +117,9 @@
files. See the previous question.
- MACOSX PROBLEMS
-
-15. I tried to configure top on my Mac OSX system and I got an error
- claiming "macosx not supported". What up?
-
- Since I don't have full time root access to a Mac OSX system I cannot
- provide effective support for the platform. MacOSX uses Mach, and it
- is very difficult to extract accurate system and process information
- from the system. It takes a lot of trial and error, along with root
- access. I have included the most up-to-date version of the macosx
- module in the distribution, but I do not claim that it works. If you
- want to try to use it, you can configure with "./configure
- --with-module=macosx".
-
-
SUNOS PROBLEMS
-16. I tried compiling top under SunOS version 4.1.x and it got compile
+15. I tried compiling top under SunOS version 4.1.x and it got compile
time errors or run time errors. Is there a patch?
If you try compiling top in a "System V environment" under SunOS
@@ -152,12 +138,12 @@
/usr/ucb is not on your path before attempting to compile top under
Solaris.
-17. Is there somewhere I can get a pre-compiled package?
+16. Is there somewhere I can get a pre-compiled package?
Yes. Although I don't provide pre-compiled binaries, you can get a
Sun-style package from www.sunfreeware.com.
-18. Under Solaris 2, when I type "make", the system says "language
+17. Under Solaris 2, when I type "make", the system says "language
optional software package not installed." What's going on?
You tried to compile with /usr/ucb/cc. Make sure /usr/ucb is not on
@@ -165,7 +151,7 @@
your system. You need a compiler to make top. Either Sun's C compiler
or the Gnu C compiler will work fine.
-19. Under Solaris 2, when I run top as root it only shows root processes,
+18. Under Solaris 2, when I run top as root it only shows root processes,
or it only shows processes with a PID less than 1000. It refuses to
show anything else. What do I do?
@@ -174,7 +160,7 @@
source-level compatability mode. You do not want that. Make sure that
/usr/ucb is not on your path and try compiling top again.
-20. Under Solaris 2, I compiled top using what I am sure is the correct
+19. Under Solaris 2, I compiled top using what I am sure is the correct
compiler but when I try to run it it complains about missing dynamic
libraries. What is wrong?
@@ -182,7 +168,7 @@
you do, make sure that /usr/ucblib is not on the path anywhere. Then
try compiling top again.
-21. Under Solaris 2, when I try to run top it complains that it can't
+20. Under Solaris 2, when I try to run top it complains that it can't
open the library "libucb.so.1". So I changed the LIBS line in
m_sunos5.c to include -R/usr/ucblib to make sure that the dynamic
linker will look there when top runs. I figured this was just an
@@ -193,7 +179,7 @@
Solaris 2. You probably compiled top with /usr/ucb/cc instead of the
real C compiler. See FAQ 22 for more details.
-22. On my 64-bit system some processes show up with incorrect information
+21. On my 64-bit system some processes show up with incorrect information
(such as zero memory).
If you are running a 64-bit system, then you will want to make a
@@ -205,7 +191,7 @@
compile with that configuration on a 64-bit system. You must
configure and compile on the same system.
-23. Can I install both 32-bit and 64-bit binaries on a central file
+22. Can I install both 32-bit and 64-bit binaries on a central file
server and have machines which mount it automatically use the correct
one?
@@ -221,7 +207,7 @@
determine the kernel type and run the top "binary" out of the correct
subdirectory.
-24. This version of top show less available swap space than previous
+23. This version of top show less available swap space than previous
versions. Why does it no longer match the output of the swap summary
produced with "swap -s"?
@@ -239,7 +225,7 @@
SVR4-DERIVED PROBLEMS
-25. When I run top on my SVR4-derived operating system, it displays all
+24. When I run top on my SVR4-derived operating system, it displays all
the system information at the top but does not display any process
information (or only displays process information for my own
processes). Yet when I run it as root, everything works fine. What's
@@ -253,7 +239,7 @@
SVR42 PROBLEMS
-26. The memory display doesn't work right. Why?
+25. The memory display doesn't work right. Why?
This is a known bug with the svr42 module. The problem has been
traced down to a potential bug in the "mem" driver. The author of the
@@ -262,7 +248,7 @@
STILL STUCK
-27. I'm still stuck. To whom do I report problems with top?
+26. I'm still stuck. To whom do I report problems with top?
The most common problems are caused by top's sensitivity to internal
kernel data structures. So make sure that you are using the right
diff --git a/README b/README
index 1f8123f..97455cc 100644
--- a/README
+++ b/README
@@ -1,13 +1,10 @@
pg_top
- Version 3.6.1
+ Version 3.7.0
Mark Wong
and a cast of ... a few
-If you do not want to read this entire file, then at least read
-the section at the end entitled "KNOWN PROBLEMS".
-
If you are having any problems getting pg_top to work, please read the
file "FAQ" *before* contacting me. Thank you.
@@ -51,38 +48,6 @@ If you have mercurial, you can download the source code from SourceForge:
hg clone http://ptop.sourceforge.net/cgi-bin/hgwebdir.cgi/pg_top
-KNOWN PROBLEMS:
-
-Gnu CC
-
-(This section left in because it's probably still valid.)
-
-Compiling via Gnu CC continued to be the source of most of the
-questions I receive. By far the most common mistake made by those
-attempting to compile top with Gnu CC is out of date include files.
-When the operating system is upgraded, the include files that are part
-of the gcc package MUST also be updated. Gcc maintains its own
-include files. Even a minor OS upgrade can involve changes to some of
-the kernel's internal data structures, which are defined in include
-files in "sys". pg_top is very sensitive to these changes. If you are
-compiling with gcc and experience any sort of strange problems, please
-make sure the include files you are using are up to date BEFORE
-sending me a bug report. Look in the gcc source distribution for the
-shell script "fixincludes".
-
-MacOS X
-
-(Selena is working on this.)
-
-Since I don't have full time root access to a MacOS X system I cannot
-provide effective support for the platform. MacOS X uses Mach, and it
-is very difficult to extract accurate system and process information
-from the system. It takes a lot of trial and error, along with root
-access. I have included the most up-to-date version of the macosx module
-in the distribution, but I do not claim that it works. If you want to
-try to use it, you can configure with "./configure --with-module=macosx".
-
-
GRATITUDE
Selena Deckelmann & Gabrielle Roth, and the beer & free wi-fi at County Cork
diff --git a/TODO b/TODO
index c0fd98a..612035a 100644
--- a/TODO
+++ b/TODO
@@ -5,6 +5,8 @@
remotely, as opposed to running pg_top locally in order to access the
operating systems process table.
+ Linux is done, more operating systems to go...
+
* Display status in the executor using pstack/dtract/gstack.
* Display elapsed time of currently running query.