htop - an interactive process viewer
Go to file
Hisham Muhammad 88c3758051 Now, when you disable a filter (F4 → Esc), it will go back to unfiltered mode
but the current process will remain selected (so you can filter, choose and
then go back to unfiltered mode to see the children of that process).

Inspired by feedback at http://www.reddit.com/r/linux/comments/23wpc7/announcing_htop_103_with_new_features_bugfixes/ch1paos
2014-04-25 16:05:25 -03:00
m4 Remove generated files from version history 2011-08-26 20:52:35 +00:00
scripts Possible to regenerate headers outside of srcdir 2014-01-17 09:33:52 +01:00
AUTHORS Initial import. 2006-03-04 18:16:49 +00:00
Affinity.c Fix order of calloc arguments. 2014-01-16 18:51:16 -02:00
Affinity.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
AffinityPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
AffinityPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
AvailableColumnsPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
AvailableColumnsPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
AvailableMetersPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
AvailableMetersPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
BatteryMeter.c More sanity checks. 2014-04-24 19:54:06 -03:00
BatteryMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
COPYING Resolve license incompatibility issues, 2010-02-24 21:13:45 +00:00
CPUMeter.c Make blue text more readable. Closes #55. 2014-04-24 13:15:52 -03:00
CPUMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
CRT.c Make blue text more readable. Closes #55. 2014-04-24 13:15:52 -03:00
CRT.h Make blue text more readable. Closes #55. 2014-04-24 13:15:52 -03:00
CategoriesPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
CategoriesPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
ChangeLog Support pagefaults stats. Closes #45. 2014-04-24 19:40:47 -03:00
CheckItem.c alignment improvements 2014-02-27 16:35:22 -03:00
CheckItem.h alignment improvements 2014-02-27 16:35:22 -03:00
ClockMeter.c Use reentrant version to silence warnings. 2014-04-21 18:59:30 -03:00
ClockMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
ColorsPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
ColorsPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
ColumnsPanel.c Performance improvements due to conditional parsing of IO data depending on selected fields. 2013-05-24 22:46:01 +00:00
ColumnsPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
DisplayOptionsPanel.c Make CPU meter optionally account guest time in its percentages 2013-12-18 02:58:34 +00:00
DisplayOptionsPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
FunctionBar.c Improve discoverability of the expand/collapse feature. 2014-04-09 18:02:50 -03:00
FunctionBar.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
Hashtable.c Fix order of calloc arguments. 2014-01-16 18:51:16 -02:00
Hashtable.h major header cleanup 2011-12-26 21:35:57 +00:00
Header.c Restrict size of read. 2014-04-21 19:18:08 -03:00
Header.h alignment improvements 2014-02-27 16:35:22 -03:00
HostnameMeter.c BUGFIX: Fix crash when adding meters and toggling detailed CPU time. 2014-01-16 01:40:47 -02:00
HostnameMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
INSTALL Initial import. 2006-03-04 18:16:49 +00:00
IOPriority.c Add IO priority support ('i' key) 2012-10-04 23:59:45 +00:00
IOPriority.h Add IO priority support ('i' key) 2012-10-04 23:59:45 +00:00
IOPriorityPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
IOPriorityPanel.h Add IO priority support ('i' key) 2012-10-04 23:59:45 +00:00
IncSet.c Fix out-of-bounds write. 2014-04-24 19:48:34 -03:00
IncSet.h Add corresponding .h file. 2014-04-24 19:50:03 -03:00
ListItem.c Fix crash when pressing 'u'. Thanks to Quentin Carbonneaux. 2012-12-12 13:03:52 +00:00
ListItem.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
LoadAverageMeter.c BUGFIX: Fix crash when adding meters and toggling detailed CPU time. 2014-01-16 01:40:47 -02:00
LoadAverageMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
Makefile.am Possible to regenerate headers outside of srcdir 2014-01-17 09:33:52 +01:00
MemoryMeter.c Make blue text more readable. Closes #55. 2014-04-24 13:15:52 -03:00
MemoryMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
Meter.c Remove useless assignment. 2014-04-21 18:59:52 -03:00
Meter.h alignment improvements 2014-02-27 16:35:22 -03:00
MetersPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
MetersPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
NEWS cleanup old stuff 2011-11-21 02:58:34 +00:00
Object.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
Object.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
OpenFilesScreen.c Let's see if this assert makes static analyzers happier. 2014-04-24 12:16:51 -03:00
OpenFilesScreen.h Add .h file ref previous commit 2014-04-22 18:48:15 -03:00
Panel.c alignment improvements 2014-02-27 16:35:22 -03:00
Panel.h alignment improvements 2014-02-27 16:35:22 -03:00
Process.c Support pagefaults stats. Closes #45. 2014-04-24 19:40:47 -03:00
Process.h Support pagefaults stats. Closes #45. 2014-04-24 19:40:47 -03:00
ProcessList.c Support pagefaults stats. Closes #45. 2014-04-24 19:40:47 -03:00
ProcessList.h alignment improvements 2014-02-27 16:35:22 -03:00
README a nicer look 2014-04-05 19:56:35 -03:00
README.md Add README.md for Github 2014-02-03 09:11:39 -02:00
RichString.c alignment improvements 2014-02-27 16:35:22 -03:00
RichString.h Add extra checks in configure.ac for different locations of (n)curses.h 2013-02-26 17:10:11 +00:00
ScreenManager.c Don't end up killing init if process selected to be killed terminates before the user selects a signal. Closes #3606072. 2013-02-26 20:24:27 +00:00
ScreenManager.h major header cleanup 2011-12-26 21:35:57 +00:00
Settings.c Improve function prototype, helping analysis. 2014-04-24 19:50:33 -03:00
Settings.h alignment improvements 2014-02-27 16:35:22 -03:00
SignalsPanel.c Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
SignalsPanel.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
String.c Test realloc failure to make cppcheck happy 2014-04-21 18:23:34 -03:00
String.h There was a bug in my implementaion. No reason not to use the glibc version. 2014-01-14 00:21:37 -02:00
SwapMeter.c change swap to M for consistency. Closes #63. 2014-04-24 19:03:07 -03:00
SwapMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
TasksMeter.c BUGFIX: Fix crash when adding meters and toggling detailed CPU time. 2014-01-16 01:40:47 -02:00
TasksMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
TraceScreen.c safer code, test for return of fcntl 2014-04-22 20:35:44 -03:00
TraceScreen.h search and filter for the strace and lsof screens! 2012-11-10 00:31:37 +00:00
UptimeMeter.c BUGFIX: Fix crash when adding meters and toggling detailed CPU time. 2014-01-16 01:40:47 -02:00
UptimeMeter.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
UsersTable.c major header cleanup 2011-12-26 21:35:57 +00:00
UsersTable.h major header cleanup 2011-12-26 21:35:57 +00:00
Vector.c shorten scope of variable. 2014-04-21 19:01:15 -03:00
Vector.h Changes in object model: separate class objects to store vtable. Also, nicer UTF-8 display of big numbers. 2012-12-05 15:12:20 +00:00
autogen.sh This seems necessary. 2010-11-24 18:43:02 +00:00
configure.ac Preparing release 1.0.3. 2014-04-24 19:54:35 -03:00
htop.1.in Improve discoverability of the expand/collapse feature. 2014-04-09 18:02:50 -03:00
htop.c Now, when you disable a filter (F4 → Esc), it will go back to unfiltered mode 2014-04-25 16:05:25 -03:00
htop.desktop * corrections to the desktop entry file 2009-02-18 00:06:18 +00:00
htop.h Improve discoverability of the expand/collapse feature. 2014-04-09 18:02:50 -03:00
htop.png Updated icon! 2014-04-09 14:47:58 -03:00

README.md

htop

by Hisham Muhammad hisham@gobolinux.org

May, 2004 - January, 2014

Note

Alert Mac users, click here! The htop version you are using is a 5-year old fork -- help bring htop 1.x to the Mac!

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 is, however, unsupported. Contact the packager for your system when reporting problems on platforms other than Linux.

This software has evolved considerably during the last years, 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.

When fetching the code from the development repository, you need to run the ./autogen.sh script, which in turn requires autotools to be installed.

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.