Updated with Tizen:Base source codes
[external/procps.git] / packaging / FAQ
1 Why does "ps -aux" complain about a bogus '-'?
2
3 According to the POSIX and UNIX standards, the above command asks to display
4 all processes with a TTY (generally the commands users are running) plus all
5 processes owned by a user named "x". If that user doesn't exist, then ps will
6 assume you really meant "ps aux". The warning is given to gently break you of a
7 habit that will cause you trouble if a user named "x" were created.
8
9
10 Why don't I see SMP (per-CPU) stats in top?
11
12 You didn't enable it. Press '?' for built-in help or read the man page. Per-CPU
13 stats are disabled by default because they take up too much space. Some Linux
14 systems have hundreds of CPUs.
15
16
17 Why do long usernames get printed as numbers?
18
19 The UNIX and POSIX standards require that user names and group names be printed
20 as decimal integers when there is not enough room in the column. Truncating the
21 names, besides being a violation of the standard, would lead to confusion
22 between names like MichelleRichards and MichelleRichardson. The UNIX and POSIX
23 way to change column width is to rename the column:
24
25      ps -o pid,user=CumbersomeUserNames -o comm
26
27 The easy way is to directly specify the desired width:
28
29      ps -o pid,user:19,comm
30
31
32 Why is %CPU underreported for multi-threaded (Java, etc.) apps?
33
34 You need to upgrade to the 2.6.10 kernel at least. Older kernels do not provide
35 a reasonable way to get this information.
36
37
38 Why do ps and top show threads individually?
39
40 The 2.4.xx kernel does not provide proper support for grouping threads by
41 process. Hacks exist to group them anyway, but such hacks will falsely group
42 similar tasks and will fail to group tasks due to race conditions. The hacks
43 are also slow. As none of this is acceptable in a critical system tool, task
44 grouping is not currently available for the 2.4.xx kernel. The 2.6.xx kernel
45 allows for proper thread grouping and reporting. To take advantage of this,
46 your programs must use a threading library that features the CLONE_THREAD flag.
47 The NPTL pthreads provided by recent glibc releases use CLONE_THREAD.
48
49
50 What systems are supported?
51
52 Linux 2.4.xx and 2.6.xx are commonly tested and expected to work well. SMP is
53 well supported. Multi-node cluster views require a multi-node /proc filesystem;
54 without that you will see a single-node view.
55
56
57 Where to I send bug reports?
58
59 You may use the Debian bug tracking system or send your report to
60 procps-feedback@lists.sf.net (no subscription required) instead.
61
62
63 Why are there so many procps projects?
64
65 The original maintainer seems to have had little time for procps. Whatever his
66 reasons, the project didn't get maintained. Starting in 1997, Albert Cahalan
67 wrote a new ps program for the package. For the next few years, Albert quietly
68 helped the Debian package maintainer fix bugs. In 2001, Rik van Riel decided to
69 do something about what appeared to be the lack of a maintainer. He picked up
70 the buggy old code in Red Hat's CVS and started adding patches. Meanwhile,
71 other people have patched procps in a great many ways. In 2002, Albert moved
72 procps to this site. This was done to ensure that years of testing and bug
73 fixes would not be lost. The major version number was changed to 3, partly to
74 avoid confusing users and partly because the top program has been redone.
75
76
77 Why does ps get signal 17?
78
79 No ps release has ever had this problem. Most likely your system has been
80 broken into. You might want to install a more recent version of the OS. If
81 you'd rather take your chances, simply upgrade procps. 
82