htop - an interactive process viewer
Go to file
Hisham Muhammad 93f091c47e BUGFIX: Fix display of CPU count for threaded processes.
When user threads are hidden, process now shows the
sum of processor usage for all processors. When user
threads are displayed, each thread shows its own
processor usage, including the root thread.
(thanks to Bert Wesarg for the report)
Also, add option to display thread colors differently.
2008-03-08 23:39:48 +00:00
plpa-1.1 Embed PLPA (Portable Linux Processor Affinity) in order to support 2008-03-05 09:46:47 +00:00
scripts Fix GCC 4.3 issues: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416852 2007-08-10 05:59:36 +00:00
AUTHORS Initial import. 2006-03-04 18:16:49 +00:00
AffinityPanel.c Adding affinity panel 2007-12-17 05:50:00 +00:00
AffinityPanel.h Adding affinity panel 2007-12-17 05:50:00 +00:00
AvailableColumnsPanel.c Rename ListBox'es to Panel's, matching dit. 2006-05-30 13:52:12 +00:00
AvailableColumnsPanel.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
AvailableMetersPanel.c Updates for new version of the MakeHeader.py script. 2006-06-06 20:41:01 +00:00
AvailableMetersPanel.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
COPYING Initial import. 2006-03-04 18:16:49 +00:00
CPUMeter.c IO-wait time now counts as idle time, which is a more 2007-11-09 00:40:59 +00:00
CPUMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
CRT.c BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
CRT.h BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
CategoriesPanel.c Make clicks on leftmost panel in the Setup screen change setup pages, 2008-03-05 06:54:30 +00:00
CategoriesPanel.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
ChangeLog BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
CheckItem.c Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
CheckItem.h Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
ClockMeter.c Updates for new version of the MakeHeader.py script. 2006-06-06 20:41:01 +00:00
ClockMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
ColorsPanel.c Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
ColorsPanel.h Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
ColumnsPanel.c --sort-key flag in the command-line, overriding the 2006-08-04 20:54:37 +00:00
ColumnsPanel.h --sort-key flag in the command-line, overriding the 2006-08-04 20:54:37 +00:00
DebugMemory.c Assign creation of the allocation log file to a separate #define. 2006-11-08 20:40:10 +00:00
DebugMemory.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
DisplayOptionsPanel.c BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
DisplayOptionsPanel.h Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
FunctionBar.c Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
FunctionBar.h Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
Hashtable.c Switch to unsigned keys in hash, according to issue #1688290 2007-04-05 19:53:23 +00:00
Hashtable.h Fix GCC 4.3 issues: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416852 2007-08-10 05:59:36 +00:00
Header.c Avoid crashing when using many meters (thanks to David Cho for the report) 2007-11-26 22:06:25 +00:00
Header.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
INSTALL Initial import. 2006-03-04 18:16:49 +00:00
ListItem.c Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
ListItem.h Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
LoadAverageMeter.c Perform RichString operations by hand. 2006-07-12 01:16:03 +00:00
LoadAverageMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
Makefile.am Embed PLPA (Portable Linux Processor Affinity) in order to support 2008-03-05 09:46:47 +00:00
MemoryMeter.c Perform RichString operations by hand. 2006-07-12 01:16:03 +00:00
MemoryMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
Meter.c Perform RichString operations by hand. 2006-07-12 01:16:03 +00:00
Meter.h Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
MetersPanel.c Rename ListBox'es to Panel's, matching dit. 2006-05-30 13:52:12 +00:00
MetersPanel.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
NEWS Initial import. 2006-03-04 18:16:49 +00:00
Object.c Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
Object.h Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
Panel.c Make clicks on leftmost panel in the Setup screen change setup pages, 2008-03-05 06:54:30 +00:00
Panel.h Make clicks on leftmost panel in the Setup screen change setup pages, 2008-03-05 06:54:30 +00:00
Process.c BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
Process.h Embed PLPA (Portable Linux Processor Affinity) in order to support 2008-03-05 09:46:47 +00:00
ProcessList.c BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
ProcessList.h BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
README Minor update to the README file. 2006-07-11 06:20:33 +00:00
RichString.c IO-wait time now counts as idle time, which is a more 2007-11-09 00:40:59 +00:00
RichString.h IO-wait time now counts as idle time, which is a more 2007-11-09 00:40:59 +00:00
ScreenManager.c Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
ScreenManager.h Fix GCC 4.3 issues: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416852 2007-08-10 05:59:36 +00:00
Settings.c BUGFIX: Fix display of CPU count for threaded processes. 2008-03-08 23:39:48 +00:00
Settings.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
SignalItem.c Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
SignalItem.h Performance improvement hackathon: improve process comparison routines, 2006-07-11 06:13:32 +00:00
SignalsPanel.c Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
SignalsPanel.h Improve construction of tree view, properly nesting threads. 2007-11-08 23:23:01 +00:00
String.c --sort-key flag in the command-line, overriding the 2006-08-04 20:54:37 +00:00
String.h Fix GCC 4.3 issues: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416852 2007-08-10 05:59:36 +00:00
SwapMeter.c Perform RichString operations by hand. 2006-07-12 01:16:03 +00:00
SwapMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
TODO Add reminder on a bug 2007-08-10 06:31:31 +00:00
TasksMeter.c Perform RichString operations by hand. 2006-07-12 01:16:03 +00:00
TasksMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
TraceScreen.c Fix bug 1538463. 2006-08-24 21:28:29 +00:00
TraceScreen.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
UptimeMeter.c A fix for long uptimes, sent my Marc Cahalan 2006-08-30 04:37:20 +00:00
UptimeMeter.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
UsersTable.c Switch to unsigned keys in hash, according to issue #1688290 2007-04-05 19:53:23 +00:00
UsersTable.h Fix GCC 4.3 issues: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416852 2007-08-10 05:59:36 +00:00
Vector.c Add debugging sanity checks. 2006-11-12 21:52:14 +00:00
Vector.h Fix GCC 4.3 issues: http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=416852 2007-08-10 05:59:36 +00:00
autogen.sh Display error message when strace is not available. 2006-06-03 23:14:09 +00:00
configure.ac Embed PLPA (Portable Linux Processor Affinity) in order to support 2008-03-05 09:46:47 +00:00
debug.h Regenerated all headers. 2006-06-06 20:28:42 +00:00
htop.1 Getting things ready for a release 2007-11-23 17:56:29 +00:00
htop.c Make sure help screen is properly filled. 2008-03-08 23:30:35 +00:00
htop.desktop Getting things ready for a release 2007-11-23 17:56:29 +00:00
htop.h Time keeps passing by 2008-03-05 06:51:32 +00:00
htop.png Initial import. 2006-03-04 18:16:49 +00:00

README

htop
by Hisham Muhammad <loderunner@users.sourceforge.net>

May, 2004 - July, 2006

Introduction
~~~~~~~~~~~~

This is htop, an interactive process viewer.
It requires ncurses. It is tested with Linux 2.6,
but is also reported to work (and was originally developed)
with the 2.4 series.

Note that, while, htop is Linux specific -- it is based
on the Linux /proc filesystem -- it is also reported to work
with FreeBSD systems featuring a Linux-compatible /proc.

This software has evolved considerably during the last months,
and is reasonably complete, but there is still room for
improvement. Read the TODO file to see what's known to be missing.

Comparison between 'htop' and 'top'
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 * In 'htop' you can scroll the list vertically and horizontally
   to see all processes and full command lines.
 * In 'top' you are subject to a delay for each unassigned
   key you press (especially annoying when multi-key escape
   sequences are triggered by accident).
 * 'htop' starts faster ('top' seems to collect data for a while
   before displaying anything).
 * In 'htop' you don't need to type the process number to
   kill a process, in 'top' you do.
 * In 'htop' you don't need to type the process number or
   the priority value to renice a process, in 'top' you do.
 * In 'htop' you can kill multiple processes at once.
 * 'top' is older, hence, more tested.

Compilation instructions
~~~~~~~~~~~~~~~~~~~~~~~~

This program is distributed as a standard autotools-based package.
See the INSTALL file for detailed instructions, but you are
probably used to the common "configure/make/make install" routine.

See the manual page (man htop) or the on-line help ('F1' or 'h'
inside htop) for a list of supported key commands.

if not all keys work check your curses configuration.