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 f348575edc top: tolerate loss of smp cpus, improve CPU_t management
Prior to this patch, top was able to handle any hotplugged
cpus *added* to the system in two distinct ways.

 1) Newly added cpus would be detected by sysinfo_refresh
    calling the library's cpuinfo function, which occurs
    at most every 5 minutes.

 2) The user could force a refresh using either the
    <Enter> or <Space> keys.

Unfortunately, the *loss* of a cpu would produce an early
exit due to a /proc/stat read failure.  Such a failure
can be produced in the following way:
  sudo echo 0 > /sys/devices/system/cpu/cpu??/online

This commit allows top to tolerate the loss of cpus.
It also provides for more efficient CPU_t management,
especially for massively parallel cpu environments.

Note: Changes to the cpu compliment can produce a single
cycle distortion of cpu percentages.  Such distortion is
most visible when each cpu is being displayed.  It can
be eliminated with a forced refresh via <Enter>/<Space>.
2012-02-08 20:57:51 +11:00
contrib contrib: minimal ps: define mips PAGE_SIZE 2011-12-18 22:25:11 +11:00
Documentation other: indent FAQ file 2012-01-08 21:57:35 +01:00
include use helpers from c.h 2012-01-24 08:55:05 +01:00
lib build-sys: use dist-xz 2012-01-08 23:02:17 +01:00
po build-sys: use Makevars --add-comments= to limit .pot comments 2011-12-20 17:30:52 +01:00
proc libprocps: open file should be closed, not freed 2012-02-06 17:37:11 +01:00
ps ps: include error.h 2012-01-24 08:55:05 +01:00
testsuite vmstat: slabinfo (-m option) test disabled if not readable 2012-01-14 00:04:46 +11:00
tools build-sys: use git version as package version 2012-01-08 21:35:07 +01:00
top top: tolerate loss of smp cpus, improve CPU_t management 2012-02-08 20:57:51 +11:00
.gitignore build-sys: use dist-xz 2012-01-08 23:02:17 +01:00
AUTHORS other: make AUTHORS file obsolete 2012-01-13 22:42:38 +01:00
autogen.sh top: provide extensive, generalized nls support 2011-12-22 23:48:04 +11:00
ChangeLog other: tell in ChangeLog where to see changes 2012-01-13 22:42:38 +01:00
configure.ac build-sys: use dist-xz 2012-01-08 23:02:17 +01:00
COPYING resync due to auto* 2002-09-27 13:26:07 +00:00
COPYING.LIB procps 010114 2002-02-01 22:47:29 +00:00
free.1 docs: fix free.1 groff syntax 2011-12-20 17:17:03 +01:00
free.c For free -b make the variable a long long 2012-01-05 09:46:39 +11:00
kill.1 docs: add long options to kill.1 2011-12-20 17:30:53 +01:00
Makefile.am watch needs a conditonal LDADD 2012-01-09 21:40:53 +11:00
NEWS Updated NEWS with new items for procps-ng 3.3.2 2012-01-06 16:48:09 +11:00
pgrep.1 docs: add to pgrep.1 count return value information 2012-01-25 09:17:49 +01:00
pgrep.c pgrep: fix potential null derefences [smatch scan] 2012-02-05 21:13:36 +01:00
pkill.1 procps 010114 2002-02-01 22:47:29 +00:00
pmap.1 docs: add exit values to pmap manual page 2011-12-20 17:30:54 +01:00
pmap.c pmap: ensure arg1 is not null, and set qualifers to match with usage [smatch scan] 2012-02-05 21:43:36 +01:00
pwdx.1 docs: mention long options in man pwdx.1 2011-12-20 17:17:01 +01:00
pwdx.c pwdx: free memory before exit 2012-02-05 20:44:39 +01:00
README name change: procps -> procps-ng 2011-06-04 20:50:12 +02:00
skill.1 dosc: add long options to skill.1 2011-12-20 17:30:53 +01:00
skill.c skill: ensure optarg is not null [smatch scan] 2012-02-05 20:54:58 +01:00
slabtop.1 docs: clarify slabtop sort criteria listing 2012-01-06 16:10:10 +11:00
slabtop.c slabtop: total slabs & caches header fix 2012-01-06 16:10:09 +11:00
snice.1 procps 010114 2002-02-01 22:47:29 +00:00
sysctl.8 sysctl -p has no space 2012-01-13 23:59:26 +11:00
sysctl.c sysctl: fix potential null derefence [smatch scan] 2012-02-05 21:02:34 +01: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: add preload paths to sysctl.conf.5 2012-01-06 16:12:22 +11:00
tload.1 docs: mention long options in man tload.1 2011-12-20 17:17:01 +01:00
tload.c tload: remove unnecessary goto 2012-01-21 23:29:02 +01:00
uptime.1 misc: trailing space/tab cleanup following rebase 2011-12-20 17:30:51 +01:00
uptime.c Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
vmstat.8 docs: mention long options in man vmstat.8 2011-12-20 17:17:03 +01:00
vmstat.c vmstat: open file should be closed, not freed 2012-02-05 23:15:54 +01:00
w.1 docs: mention long options in man w.1 2011-12-20 17:17:01 +01:00
w.c ps: unify cases and remove trailing dots in messages 2012-01-15 20:52:58 +01:00
watch.1 docs: add exit values to watch.1 2012-01-21 16:41:31 +01:00
watch.c watch: remove unreachable code 2012-02-05 20:48:33 +01:00

COMPATIBILITY

    This code is intended for use with Linux 2.2.xx, 2.4.xx,
    2.6.xx, and hopefully all future kernels. You should be
    running a system with libc 6, but libc 5 might work too.

INSTALLATION

    make
    make install

    Only the second ("make install") is needed if you just
    want to build and install procps-ng in the normal way.

    If you wish to test before installing, use the scripts
    named t, v, and p to ensure that the correct libproc
    (the new one) is used during your testing.

    You may set SKIP to avoid building or installing things.
    For example:

    make SKIP='/bin/kill /usr/share/man/man1/kill.1' install

    Use SHARED=0 to build procps-ng without shared libraries.
    This may be useful for installing in your home directory.

    make SHARED=0 DESTDIR=$HOME install

    Suppose you wanted to install stuff in strange places.
    You might do something like this:

    make usr/bin=/tmp/Q/i/ DESTDIR=/tmp/Q install="install -D" ldconfig=echo install

    If cross-compiling, you might need to set lib64 to
    either "lib" or "lib64". You might need to set m64 to
    -m64, -m32, or nothing at all. Some examples:

    make lib64=lib m64=-m32      # for a bi-arch gcc
    make lib64=lib64 CC=x86_64-gcc
    make lib64=lib CC=alpha-gcc

PACKAGING

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

    Send patches in regularly. Many patches made by vendors have been buggy,
    some quite severely so. Sending in a patch will at least get it reviewed,
    if not included. There is a procps-ng test suite that must be passed.
    Forward all 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 w/o need for an account.

    Do not change the user interface. Many of the programs are intended to be
    compatible with Solaris, FreeBSD, AIX, IRIX, Tru64, and the UNIX standard.
    Your nice new command options WILL BE BROKEN as needed to ensure that
    procps-ng remains compatible with the rest of the world. Sysadmins hate to
    deal with incompatible behavior. If you need a new option, ask for it.

    For normal packages, ensure that you do not add debugging flags
    to the CFLAGS variable. If debugging flags are present, the Makefile
    will avoid adding several optimizations that would interfere with gdb.

    There should be no need to modify the Makefile. You can set variables
    on the "make" command line or use "make -e" to pass variables from
    the environment.

BUG REPORTS

    Email to procps@freelists.org.