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 42fe8a9f39 build-sys: rename the 'tools' subdirectory to 'misc'
The newer tools/ subdirectory shares a common prefix
with the previously existing top/ subdirectory and
thereby hinders shell command completion.

There was already a minor conflict between testsuite/
and top/.  This patch renames the tools/ subdirecory
to avoid an even greater conflict.

Signed-off-by: Jim Warner <james.warner@comcast.net>
2012-03-02 21:25:38 +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 strutils: reindent the file 2012-02-11 21:42:39 +01: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 libprocps: remove linux 2.7.0 check 2012-02-11 21:44:29 +01:00
ps ps: include error.h 2012-01-24 08:55:05 +01:00
testsuite tests: fix dejagnu pwdx and vmstat checks 2012-02-11 21:42:21 +01:00
top top: relocate a prototype to prevent compiler warning 2012-02-28 08:45:44 +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 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: rename the 'tools' subdirectory to 'misc' 2012-03-02 21:25:38 +11: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 pkill: remove -v match inversion option 2012-02-11 21:43:13 +01:00
pgrep.c pkill: remove -v match inversion option 2012-02-11 21:43:13 +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: fix argument parsing regression 2012-02-11 21:42:35 +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 watch: inform about optional argument for -d switch 2012-02-11 21:43:28 +01:00
watch.c watch: inform about optional argument for -d switch 2012-02-11 21:43:28 +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.