From 6c21a3613b998d094074c2f23e4c9cb91273d52d Mon Sep 17 00:00:00 2001 From: Sami Kerola Date: Sun, 8 Jan 2012 00:05:05 +0100 Subject: [PATCH] other: indent FAQ file Signed-off-by: Sami Kerola --- Documentation/FAQ | 128 +++++++++++++++++++++++----------------------- 1 file changed, 63 insertions(+), 65 deletions(-) diff --git a/Documentation/FAQ b/Documentation/FAQ index c68bf7bc..dc6a0790 100644 --- a/Documentation/FAQ +++ b/Documentation/FAQ @@ -1,99 +1,97 @@ Why does "ps -aux" complain about a bogus '-'? -According to the POSIX and UNIX standards, the above command asks to display -all processes with a TTY (generally the commands users are running) plus all -processes owned by a user named "x". If that user doesn't exist, then ps will -assume you really meant "ps aux". The warning is given to gently break you of a -habit that will cause you trouble if a user named "x" were created. - + According to the POSIX and UNIX standards, the above command asks to + display all processes with a TTY (generally the commands users are + running) plus all processes owned by a user named "x". If that user + doesn't exist, then ps will assume you really meant "ps aux". The + warning is given to gently break you of a habit that will cause you + trouble if a user named "x" were created. Why don't I see SMP (per-CPU) stats in top? -You didn't enable it. Press '?' for built-in help or read the man page. Per-CPU -stats are disabled by default because they take up too much space. Some Linux -systems have hundreds of CPUs. - + You didn't enable it. Press '?' for built-in help or read the man + page. Per-CPU stats are disabled by default because they take up too + much space. Some Linux systems have hundreds of CPUs. Why do long usernames get printed as numbers? -The UNIX and POSIX standards require that user names and group names be printed -as decimal integers when there is not enough room in the column. Truncating the -names, besides being a violation of the standard, would lead to confusion -between names like MichelleRichards and MichelleRichardson. The UNIX and POSIX -way to change column width is to rename the column: + The UNIX and POSIX standards require that user names and group names + be printed as decimal integers when there is not enough room in the + column. Truncating the names, besides being a violation of the + standard, would lead to confusion between names like MichelleRichards + and MichelleRichardson. The UNIX and POSIX way to change column + width is to rename the column: - ps -o pid,user=CumbersomeUserNames -o comm + ps -o pid,user=CumbersomeUserNames -o comm -The easy way is to directly specify the desired width: - - ps -o pid,user:19,comm + The easy way is to directly specify the desired width: + ps -o pid,user:19,comm Why is %CPU underreported for multi-threaded (Java, etc.) apps? -You need to upgrade to the 2.6.10 kernel at least. Older kernels do not provide -a reasonable way to get this information. - + You need to upgrade to the 2.6.10 kernel at least. Older kernels do + not provide a reasonable way to get this information. Why do ps and top show threads individually? -The 2.4.xx kernel does not provide proper support for grouping threads by -process. Hacks exist to group them anyway, but such hacks will falsely group -similar tasks and will fail to group tasks due to race conditions. The hacks -are also slow. As none of this is acceptable in a critical system tool, task -grouping is not currently available for the 2.4.xx kernel. The 2.6.xx kernel -allows for proper thread grouping and reporting. To take advantage of this, -your programs must use a threading library that features the CLONE_THREAD flag. -The NPTL pthreads provided by recent glibc releases use CLONE_THREAD. - + The 2.4.xx kernel does not provide proper support for grouping + threads by process. Hacks exist to group them anyway, but such hacks + will falsely group similar tasks and will fail to group tasks due to + race conditions. The hacks are also slow. As none of this is + acceptable in a critical system tool, task grouping is not currently + available for the 2.4.xx kernel. The 2.6.xx kernel allows for proper + thread grouping and reporting. To take advantage of this, your + programs must use a threading library that features the CLONE_THREAD + flag. The NPTL pthreads provided by recent glibc releases use + CLONE_THREAD. What systems are supported? -Linux 2.4.xx and 2.6.xx are commonly tested and expected to work well. SMP is -well supported. Multi-node cluster views require a multi-node /proc filesystem; -without that you will see a single-node view. - + Linux 2.4.xx and 2.6.xx are commonly tested and expected to work + well. SMP is well supported. Multi-node cluster views require a + multi-node /proc filesystem; without that you will see a single-node + view. Where to I send bug reports? -You may use the Debian bug tracking system or send your report to -procps@freelists.org (no subscription required) instead. - + You may use the Debian bug tracking system or send your report to + procps@freelists.org (no subscription required) instead. Why are there so many procps projects? -The original maintainer seems to have had little time for procps. Whatever his -reasons, the project didn't get maintained. Starting in 1997, Albert Cahalan -wrote a new ps program for the package. For the next few years, Albert quietly -helped the Debian package maintainer fix bugs. In 2001, Rik van Riel decided to -do something about what appeared to be the lack of a maintainer. He picked up -the buggy old code in Red Hat's CVS and started adding patches. Meanwhile, -other people have patched procps in a great many ways. + The original maintainer seems to have had little time for procps. + Whatever his reasons, the project didn't get maintained. Starting in + 1997, Albert Cahalan wrote a new ps program for the package. For the + next few years, Albert quietly helped the Debian package maintainer + fix bugs. In 2001, Rik van Riel decided to do something about what + appeared to be the lack of a maintainer. He picked up the buggy old + code in Red Hat's CVS and started adding patches. Meanwhile, other + people have patched procps in a great many ways. -In 2002, Albert moved procps to http://procps.sourceforge.net. This was done to -ensure that years of testing and bug fixes would not be lost. The major version -number was changed to 3, partly to avoid confusing users and partly because the -top program had been redone. - -After development essentially stopped on sourceforge.net, in 2011 the project -found a new home at http://gitorious.org/procps. This represents the Debian, -Fedora and openSUSE fork of procps. To avoid confusion and potential name -clashes the package is now known as procps-ng (next generation), the version -number was raised to 3.3.0 and the library soname changed to libproc-ng-3.3.0. + In 2002, Albert moved procps to http://procps.sourceforge.net. This + was done to ensure that years of testing and bug fixes would not be + lost. The major version number was changed to 3, partly to avoid + confusing users and partly because the top program had been redone. + After development essentially stopped on sourceforge.net, in 2011 the + project found a new home at http://gitorious.org/procps. This + represents the Debian, Fedora and openSUSE fork of procps. To avoid + confusion and potential name clashes the package is now known as + procps-ng (next generation), the version number was raised to 3.3.0 + and the library soname changed to libproc-ng-3.3.0. What is being done to procps-ng at its new home? -All programs are in the process of being modernized, both in terms of coding -style and supporting documentation. Autotools have been integrated and the -library API has been expanded with many new fields supported such as control -groups, supplementary groups, etc. The top program has been rewritten offering -many new capabilities while providing performance improvements up to 300%. - + All programs are in the process of being modernized, both in terms of + coding style and supporting documentation. Autotools have been + integrated and the library API has been expanded with many new fields + supported such as control groups, supplementary groups, etc. The top + program has been rewritten offering many new capabilities while + providing performance improvements up to 300%. Why does ps get signal 17? -No ps release has ever had this problem. Most likely your system has been -broken into. You might want to install a more recent version of the OS. If -you'd rather take your chances, simply upgrade procps. - + No ps release has ever had this problem. Most likely your system has + been broken into. You might want to install a more recent version of + the OS. If you'd rather take your chances, simply upgrade procps.