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
Sami Kerola 26f2deac52 docs: watch manual update about -e option behaviour change
Relates to: commit 7ac61b3fa1

Signed-off-by: Sami Kerola <sami.kerola@tomtom.com>
2012-01-06 00:18:07 +11:00
contrib contrib: minimal ps: define mips PAGE_SIZE 2011-12-18 22:25:11 +11:00
include Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
lib Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
po build-sys: use Makevars --add-comments= to limit .pot comments 2011-12-20 17:30:52 +01:00
proc build-sys: correct all Makefile.am files for LOCALEDIR, etc 2012-01-04 08:58:54 +11:00
ps ps: corrections to messages 2012-01-06 00:17:50 +11:00
testsuite Check for 0 repeat count and tests in free 2012-01-04 10:07:31 +11:00
top top: add PACKAGE and LOCALEDIR to ATEOJ_RPTSTD output 2012-01-05 09:56:05 +11:00
.gitignore Merge branch 'master' into nls 2011-12-26 09:11:27 +11:00
AUTHORS watch: support unicode 2011-12-19 21:57:09 +11:00
autogen.sh top: provide extensive, generalized nls support 2011-12-22 23:48:04 +11:00
BUGS name change: procps -> procps-ng 2011-06-04 20:50:12 +02:00
ChangeLog build-sys: take autotools in use again 2011-06-04 17:22:44 +02:00
CodingStyle diskstats and slabinfo 2003-06-08 17:28:06 +00:00
configure.ac Merge branch 'master' into nls 2011-12-26 09:11:27 +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
FAQ adapt redhat FAQ for procps-ng 2011-10-06 21:46:34 +02: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 free -c option uses strutils 2012-01-04 09:53:51 +11:00
NEWS Added news item for top search capability 2011-12-20 22:16:40 +11:00
pgrep.1 docs: mention long options in man pgrep.1 2011-12-20 17:17:02 +01:00
pgrep.c pgrep: correction to usage output 2012-01-06 00:17:44 +11: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 Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
pwdx.1 docs: mention long options in man pwdx.1 2011-12-20 17:17:01 +01:00
pwdx.c Changed the err and warns to macros 2012-01-03 18:48:43 +11: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 Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
slabtop.1 docs: small nroff fixes to man slabtop.1 2011-12-20 17:17:01 +01:00
slabtop.c Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
snice.1 procps 010114 2002-02-01 22:47:29 +00:00
sysctl.8 sysctl: implement --pattern option 2011-12-20 17:17:03 +01:00
sysctl.c Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
sysctl.conf misc 2004-08-18 02:22:13 +00:00
sysctl.conf.5 procps 010114 2002-02-01 22:47:29 +00:00
tload.1 docs: mention long options in man tload.1 2011-12-20 17:17:01 +01:00
tload.c Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
TODO name change: procps -> procps-ng 2011-06-04 20:50:12 +02: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 Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
w.1 docs: mention long options in man w.1 2011-12-20 17:17:01 +01:00
w.c Changed the err and warns to macros 2012-01-03 18:48:43 +11:00
watch.1 docs: watch manual update about -e option behaviour change 2012-01-06 00:18:07 +11:00
watch.c watch: correct differences option, eliminate duplicate help text 2012-01-05 10:07:08 +11: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.