Jim Warner 081fe506f3 top: add a flexible 'Inspect' capability
This commit introduces an extremely powerful, flexible
brand new capability.  Now, users can pause the normal
iterative display and inspect the contents of any file
or output from any script, command, or even pipelines.

It's invoked via the 'Y' interactive command which, in
turn, is supported with simple user supplied additions
as new entries in the top personal configuration file.

A separate new 'Inspect' window supports scrolling and
searching, similar to the main top display.  Except it
extends existing 'L'/'&' (locate/locate-next) commands
so that an out-of-view match automatically adjusts the
horizontal position bringing such data into view.  And
it provides for multiple successive same line matches.

Also, the basic 'more/less' navigation keys are active
in this new 'Inspect' window, to ease user transition.

There are no program changes required when entries are
added to or deleted from the rcfile.  And there are no
known limits to the complexity of a script, command or
pipeline, other than the unidirectional nature imposed
by the 'popen' function call which top cannot violate.

Since it's impossible to predict exactly what contents
will be generated, top treats all output as raw binary
data.  Any control characters display in '^C' notation
while all other unprintable characters show as '<AB>'.

The biggest problem encountered was with the find/next
capability since that strstr guy was really diminished
given the possibility that numerous 'strings' could be
encountered *within* many of top's raw, binary 'rows'.

Oh, and another problem was in maintaining the perfect
left & right text justification of this commit message
along with all of the commit summaries.  Some of those
summaries (like this very one) are of course, slightly
shorter, to make room for the 'man document' addition.

Enjoy!

Signed-off-by: Jim Warner <james.warner@comcast.net>
2012-11-27 22:08:02 +11:00
2012-11-06 22:28:30 +11:00
2012-11-06 22:30:02 +11:00
2012-05-29 22:20:36 +10:00
2012-01-13 22:42:38 +01:00
2012-03-04 08:04:24 +11:00
2012-03-04 08:04:24 +11:00
2012-04-16 12:55:53 +02:00
2012-04-16 12:55:53 +02:00
2012-11-06 23:01:08 +11:00
2012-11-21 22:11:17 +11:00
2012-11-21 22:11:17 +11:00
2002-02-01 22:47:29 +00:00
2012-09-27 22:08:04 +10:00
2012-11-06 22:30:01 +11:00
2012-04-16 12:55:53 +02:00
2012-06-14 22:33:49 +10:00
2012-03-03 18:28:52 +11:00
2012-04-16 12:55:53 +02:00
2012-11-06 22:28:30 +11:00
2012-04-16 12:55:53 +02:00
2002-02-01 22:47:29 +00:00
2012-05-07 09:01:10 +02:00
2012-11-06 22:30:01 +11:00
2012-04-16 12:55:53 +02:00
2012-04-16 12:55:53 +02:00
2012-04-16 12:55:53 +02:00
2012-11-06 22:30:02 +11:00
w.1
2012-05-29 22:20:36 +10:00
2012-04-16 12:55:53 +02:00
2012-11-06 22:30:02 +11:00

COMPATIBILITY

    This code is intended for use with Linux 2.6.xx, 3.x and
    hopefully all future kernels.

INSTALLATION

    If you are using git version of the project you need extra step.

    ./autogen.sh

    After that, and everyone using .tar.xz version of procps-ng, can
    do normal build.  Read './configure --help' to select options for
    your needs.

    ./configure
    make
    make install

    If you have DejaGNU installed you can run optional test suite.

    make check

HOW TO CONTRIBUTE

    See Documentation/BUGS file.

PACKAGING

    If you are a downstream maintainer (packager) for a Linux
    distribution, please avoid causing troubles.  This section
    applies to you.

    Avoid maintaining distribution specific patches.  Send your
    patches to upstream, where they are at least reviewed, if not
    included.

    Please forward bug reports. If your bug database is public and
    busy enough to bother with, please make this known.  Follow
    Debian's lead in making the bug database easy to comment on via
    email without need for an account.

    For normal packages, ensure that you do not add debugging flags
    to the CFLAGS variable.

UPSTREAM & BUG REPORTS

    procps-ng <procps@freelists.org>
Description
Command line and full screen utilities for browsing procfs, a "pseudo" file system dynamically generated by Linux to provide information about the status of entries in its process table.
Readme 15 MiB
Languages
C 97.2%
Makefile 1%
Shell 0.9%
M4 0.9%