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.
Go to file
Jim Warner dedaf6e1a8 top: disable tty scrollback buffer to improve SIGWINCH
A scrollback buffer used in several terminal emulators
could be a real inconvenience to a user following some
resize operations. Extra keystroke(s) would frequently
be required in order to properly render top's display.

After much sleuthing we unearthed two terminfo strings
which have the effect of disabling/restoring that darn
scrollback buffer. They were well hidden under a title
of strings 'to start/end programs using cup'. In turn,
'cup' deals with a tty's cursor addressing capability.

We don't care what you call them or what they refer to
so long as they get the job done. And these really do!
Be advised, however, that there are some side effects,
several of which can even be considered as beneficial:

. enter_ca_mode/smcup/ti disables scrollback buffering
( and that's good, it's what we had always hoped for )

. exit_ca_mode/rmcup/te restores the scrollback buffer
( but also restores screen contents existing pre-top )
( which is different from former program end results )
( where that last rendered screen was left untouched )

. the above screen replacement would impact ^Z suspend
( thus we keep the scrollback buffer disabled during )
( the suspend/resume sequence so that the users will )
( have a visual clue that top is suspended not ended )

If a terminal does not support these terminfo strings,
we will revert to top's former behavior at program end
where we position the cursor at screen bottom and then
output a single newline character. This will prevent a
shell prompt from embedding within top's final screen.

This commit's approach has been tested under a variety
of emulators and window managers, many of which linked
with libvte and others that employed their own scheme.
Examples are: gnome_terminal; kde konsole; lxterminal;
terminator; terminology; urxvt; xfce4-terminal; xterm.

I do now believe that the whole SIGWINCH deal is done!

(everything is perfectly justified plus right margins)
(are completely filled, but of course it must be luck)

Reference(s):
http://www.freelists.org/post/procps/top-won-the-sigwinch-war
http://www.freelists.org/post/procps/top-won-the-sigwinch-war,4

Signed-off-by: Jim Warner <james.warner@comcast.net>
2013-02-05 22:11:22 +11:00
contrib docs: clarification to license headers in files 2012-03-03 18:41:11 +11:00
Documentation docs: mention linux 3.xx kernels are expected to work 2012-06-02 15:13:18 +10:00
include build-sys: add fileutils.h to dist package 2012-04-18 10:26:20 +02:00
lib lib/fileutils: fix compiler warnings 2012-11-06 22:28:30 +11:00
misc build-sys: rename the 'tools' subdirectory to 'misc' 2012-03-02 21:25:38 +11:00
po build-sys: use Makevars --add-comments= to limit .pot comments 2011-12-20 17:30:52 +01:00
proc Expose freeproc for libproc 2013-01-01 13:13:44 +11:00
ps Merge commit 'refs/merge-requests/6' of git://gitorious.org/procps/procps into merge-requests/6 2013-01-24 21:51:13 +11:00
testsuite test for previous commit 2012-12-26 23:21:44 +11:00
top top: disable tty scrollback buffer to improve SIGWINCH 2013-02-05 22:11:22 +11:00
.gitignore Added pmap -X and -XX tests 2012-12-24 10:05:24 +11:00
AUTHORS other: make AUTHORS file obsolete 2012-01-13 22:42:38 +01:00
autogen.sh Fix a remaining util-linux word in autogen 2012-02-26 08:39:16 +11:00
ChangeLog other: tell in ChangeLog where to see changes 2012-01-13 22:42:38 +01:00
configure.ac build sys: add configure option for impact of SIGWINCH 2013-01-30 10:53:49 +11:00
COPYING license: update FSF addresses 2012-03-04 08:04:24 +11:00
COPYING.LIB license: update FSF addresses 2012-03-04 08:04:24 +11:00
free.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
free.c Show sizes > 4G correctly in bytes on 32-bit machines. 2012-06-27 06:47:38 +10:00
kill.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
Makefile.am fix sysctl.conf inclusion in dist tarballs 2012-10-31 22:42:03 +11:00
NEWS Expose freeproc for libproc 2013-01-01 13:13:44 +11:00
pgrep.1 Add -c count option to pkill 2012-11-21 22:11:17 +11:00
pgrep.c Add -c count option to pkill 2012-11-21 22:11:17 +11:00
pkill.1 procps 010114 2002-02-01 22:47:29 +00:00
pmap.1 Two new options for pmap, -X and -XX 2012-09-27 22:08:04 +10:00
pmap.c pmap: empty output or crashes on ppc/s390 caused by wrong pidlist type 2013-02-05 22:10:18 +11:00
pwdx.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
pwdx.c Fix pwdx argument parsing 2012-06-14 22:33:49 +10:00
README docs: add how to contribute to README 2012-03-03 18:28:52 +11:00
skill.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
skill.c skill: fix compiler warnings 2012-11-06 22:28:30 +11:00
slabtop.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
slabtop.c all: check stdout and stderr status at exit 2012-03-23 15:57:53 +01:00
snice.1 procps 010114 2002-02-01 22:47:29 +00:00
sysctl.8 sysctl.8: format fix in synopsis 2013-01-01 13:16:33 +11:00
sysctl.c sysctl: fix compiler warnings 2012-11-06 22:30:01 +11:00
sysctl.conf docs: remove tcp_default_win_scale from sysctl.conf sample 2012-01-24 22:34:12 +01:00
sysctl.conf.5 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
tload.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
tload.c all: check stdout and stderr status at exit 2012-03-23 15:57:53 +01:00
uptime.1 uptime: add since option 2012-12-26 23:14:09 +11:00
uptime.c uptime: add since option 2012-12-26 23:14:09 +11:00
vmstat.8 Minor fix with vmstat manpage for r column 2012-05-30 21:41:17 +10:00
vmstat.c vmstat: fix compiler warnings 2012-11-06 22:30:02 +11:00
w.1 Add -i option to w 2012-05-29 22:20:36 +10:00
w.c w: do not truncate command when width is not known 2012-07-15 12:49:22 +02:00
watch.1 docs: fix manual page warnings 2012-04-16 12:55:53 +02:00
watch.c watch: fix compiler warnings 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>