htop - an interactive process viewer
Go to file
Christian Göttsche 53bcc5cbff ci: drop hwloc from clang-analyzer build
The hwloc header generates lots of warnings:

  In file included from Action.c:10:
  In file included from ./Action.h:15:
  In file included from ./Header.h:10:
  In file included from ./Meter.h:18:
  In file included from ./ProcessList.h:25:
  In file included from /usr/include/hwloc.h:2371:
  /usr/include/hwloc/helper.h:481:5: warning: Value stored to 'state' is never read [deadcode.DeadStores]
      state = 3;
      ^       ~
  1 warning generated.
2021-03-19 22:07:47 +01:00
.github/workflows ci: drop hwloc from clang-analyzer build 2021-03-19 22:07:47 +01:00
darwin MemoryMeter: show shared memory before cached 2021-03-17 16:32:16 +01:00
docs Fix a little typo (spelling) in the styleguide 2020-12-01 14:15:16 +11:00
dragonflybsd MemoryMeter: show shared memory before cached 2021-03-17 16:32:16 +01:00
freebsd Merge branch 'shared_before_cached' of cgzones/htop 2021-03-19 09:49:36 +01:00
generic Ensure buffer for gethostname(2) is properly terminated 2021-03-04 23:42:24 +01:00
iwyu Add sys/dirent.h to iwyu/htop.imp 2020-12-11 20:57:19 +01:00
linux Merge branch 'shared_before_cached' of cgzones/htop 2021-03-19 09:49:36 +01:00
openbsd MemoryMeter: show shared memory before cached 2021-03-17 16:32:16 +01:00
scripts Track file descriptors in valgrind script 2020-11-25 22:09:39 +01:00
solaris MemoryMeter: show shared memory before cached 2021-03-17 16:32:16 +01:00
unsupported Separate display from sampling in SysArch and Hostname Meters 2021-03-04 13:40:11 +11:00
zfs Save text buffer in Meter 2021-03-04 23:57:45 +01:00
.editorconfig Add trim_trailing_whitespace to editorconfig 2019-10-31 11:39:57 -05:00
.gitignore Add conf*/ and callgrind.out.* to list of ignored files 2020-10-11 14:21:59 +02:00
.travis.yml travis CI: drop macOS and Linux builds 2020-12-08 16:07:45 +01:00
Action.c Action: merge conditions 2021-03-17 17:53:23 +01:00
Action.h Use MainPanel type in State struct 2021-02-05 14:12:49 +01:00
Affinity.c Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
Affinity.h Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
AffinityPanel.c Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
AffinityPanel.h Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
AUTHORS Update AUTHORS file with htop-dev team 2020-12-05 11:07:32 +01:00
autogen.sh autotools: enable warnings and cleanup 2020-09-17 21:45:11 +02:00
AvailableColumnsPanel.c Rework enum ProcessField 2020-12-19 21:13:32 +01:00
AvailableColumnsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
AvailableMetersPanel.c Separate data-update and drawing of header 2021-03-04 23:57:45 +01:00
AvailableMetersPanel.h Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
BatteryMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
BatteryMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
CategoriesPanel.c Allow to pass '/' for item search 2020-12-03 22:41:31 +01:00
CategoriesPanel.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
ChangeLog Include note in changelog regarding removal of the setuid feature 2021-02-17 17:14:06 +01:00
ClockMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
ClockMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ColorsPanel.c Rework drawing of FunctionBar 2020-12-20 17:01:50 +01:00
ColorsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ColumnsPanel.c Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
ColumnsPanel.h Fix segmentation fault when column name is NULL. 2020-10-31 18:34:34 +01:00
CommandScreen.c Make Infoscreens the correct height 2021-01-11 12:53:07 +01:00
CommandScreen.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
Compat.c Support clock_gettime() on OSX El Capitan and earlier 2020-12-18 22:43:21 +01:00
Compat.h Support clock_gettime() on OSX El Capitan and earlier 2020-12-18 22:43:21 +01:00
configure.ac Merge pull request #436 from cgzones/freebsd 2021-03-18 14:03:51 +02:00
CONTRIBUTING.md Documentation on the repository style guide 2020-10-31 11:11:40 +01:00
COPYING Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
CPUMeter.c Merge branch 'richstring_memset' of cgzones/htop 2021-03-19 09:58:04 +01:00
CPUMeter.h Show CPU temperature in CPU meter 2020-11-16 16:38:54 +01:00
CRT.c Linux: individually show shared memory 2021-03-15 22:34:14 +01:00
CRT.h Linux: individually show shared memory 2021-03-15 22:34:14 +01:00
DateMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
DateMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DateTimeMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
DateTimeMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DiskIOMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
DiskIOMeter.h Switch DiskIO Meter to using uint32_t and uint64_t 2021-03-02 12:09:29 +11:00
DisplayOptionsPanel.c Merge pull request #436 from cgzones/freebsd 2021-03-18 14:03:51 +02:00
DisplayOptionsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
EnvScreen.c Refactor to remove no-op calls 2021-02-17 15:59:50 +01:00
EnvScreen.h EnvScreen: mark local class functions static 2020-12-21 22:34:50 +01:00
FunctionBar.c Rework drawing of FunctionBar 2020-12-20 17:01:50 +01:00
FunctionBar.h Add key to pause process list updates 2020-10-12 13:04:00 +02:00
Hashtable.c Hashtable: use appropriate return type for nextPrime 2021-01-12 16:37:43 +01:00
Hashtable.h Hashtable: widen size from int to size_t 2021-01-06 16:59:28 +01:00
Header.c Separate data-update and drawing of header 2021-03-04 23:57:45 +01:00
Header.h Separate data-update and drawing of header 2021-03-04 23:57:45 +01:00
HostnameMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
HostnameMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
htop.1.in Document PERCENT_NORM_CPU and mention Irix / Solaris modes (top lingo) 2021-03-03 10:46:49 +01:00
htop.c Settings: check if writing configuration file was successful 2021-03-12 16:56:06 +01:00
htop.desktop Add danish translation to htop.desktop 2019-02-19 01:25:52 +01:00
htop.png Update htop logo, provide .svg file as well 2020-12-05 13:46:34 +01:00
htop.svg Update htop logo, provide .svg file as well 2020-12-05 13:46:34 +01:00
IncSet.c Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
IncSet.h Refactor setting filter and use safe strncpy 2021-01-11 20:12:34 +01:00
InfoScreen.c InfoScreen/ProcessList: do not access Vector internals 2021-03-12 16:46:55 +01:00
InfoScreen.h InfoScreen: drop unused member 2020-12-21 22:34:50 +01:00
ListItem.c RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
ListItem.h Small ListItem update 2020-10-28 20:49:11 +01:00
LoadAverageMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
LoadAverageMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Macros.h Add compiler hints on memory allocating utility functions 2021-01-11 21:08:58 +01:00
MainPanel.c Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
MainPanel.h Avoid function cast by refactoring callback prototype 2021-01-06 16:42:45 +01:00
Makefile.am Move generic (shared) code into its own sub-directory 2021-03-04 13:40:59 +11:00
MemoryMeter.c MemoryMeter: show shared memory before cached 2021-03-17 16:32:16 +01:00
MemoryMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Meter.c RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
Meter.h Save text buffer in Meter 2021-03-04 23:57:45 +01:00
MetersPanel.c Mark several non-modified pointer variables const 2021-01-11 23:47:00 +01:00
MetersPanel.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
NetworkIOMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
NetworkIOMeter.h Switch NetworkIO Meter to using uint32_t and uint64_t 2021-03-02 12:14:44 +11:00
NEWS Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
Object.c Allow meters in text mode to span empty neighbors to the right 2021-01-23 15:20:47 +01:00
Object.h Object: always include stdbool.h 2021-03-12 16:38:36 +01:00
OpenFilesScreen.c Make Infoscreens the correct height 2021-01-11 12:53:07 +01:00
OpenFilesScreen.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
OptionItem.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
OptionItem.h Add support to change numeric options in settings screen 2020-11-25 20:46:27 +01:00
Panel.c RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
Panel.h Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
Process.c RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
Process.h Linux: silence UBSAN implicit conversions 2021-01-30 14:21:26 +01:00
ProcessList.c RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
ProcessList.h Linux: individually show shared memory 2021-03-15 22:34:14 +01:00
ProcessLocksScreen.c Make Infoscreens the correct height 2021-01-11 12:53:07 +01:00
ProcessLocksScreen.h IWYU update (Linux) 2020-11-19 23:51:50 +01:00
ProvideCurses.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
README Remove setuid support 2021-02-17 15:59:50 +01:00
README.md Add README.md for Github 2014-02-03 09:11:39 -02:00
RichString.c RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
RichString.h RichString: do not unnecessarily clean whole buffer 2021-03-17 15:54:17 +01:00
ScreenManager.c Separate data-update and drawing of header 2021-03-04 23:57:45 +01:00
ScreenManager.h Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
Settings.c Merge pull request #436 from cgzones/freebsd 2021-03-18 14:03:51 +02:00
Settings.h Merge pull request #436 from cgzones/freebsd 2021-03-18 14:03:51 +02:00
SignalsPanel.c Panel_new: reorder arguments 2021-01-04 23:12:43 +01:00
SignalsPanel.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
SwapMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
SwapMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
SysArchMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
SysArchMeter.h [#480] SysArchMeter to view kernel/arch info 2021-01-31 20:08:09 +01:00
TasksMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
TasksMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
test_spec.lua Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
TESTPLAN Small update to test plan 2021-02-13 14:04:15 +01:00
TraceScreen.c Use ATTR_UNUSED instead of void casting 2021-03-02 22:03:20 +01:00
TraceScreen.h Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
UptimeMeter.c Save text buffer in Meter 2021-03-04 23:57:45 +01:00
UptimeMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
UsersTable.c Hashtable: use dynamic growth and use primes as size 2020-11-17 02:01:02 +01:00
UsersTable.h Update License consistently to GPLv2 as per COPYING file 2020-10-05 10:13:12 +02:00
Vector.c Avoid calling Object_isA from inside Vector_isConsistent 2020-11-17 08:06:02 +01:00
Vector.h InfoScreen/ProcessList: do not access Vector internals 2021-03-12 16:46:55 +01:00
XUtils.c Mark several non-modified pointer variables const 2021-01-11 20:12:34 +01:00
XUtils.h Add compiler hints on memory allocating utility functions 2021-01-11 21:08:58 +01:00

htop

CI Coverity Scan Build Status Mailing List IRC #htop Github Release Download

Screenshot of htop

Introduction

htop is a cross-platform interactive process viewer.

htop allows scrolling the list of processes vertically and horizontally to see their full command lines and related information like memory and CPU consumption.

The information displayed is configurable through a graphical setup and can be sorted and filtered interactively.

Tasks related to processes (e.g. killing and renicing) can be done without entering their PIDs.

Running htop requires ncurses libraries (typically named libncursesw*).

For more information and details on how to contribute to htop visit htop.dev.

Build instructions

This program is distributed as a standard GNU autotools-based package.

Compiling htop requires the header files for ncurses (libncursesw*-dev). Install these and other required packages for C development from your package manager.

Then, when compiling from a release tarball, run:

./configure && make

Alternatively, for compiling sources downloaded from the Git repository (git clone or downloads from Github releases), install the header files for ncurses (libncursesw*-dev) and other required development packages from your distribution's package manager. Then run:

./autogen.sh && ./configure && make

By default make install will install into /usr/local, for changing the path use ./configure --prefix=/some/path.

Build Options

htop has several build-time options to enable/disable additional features.

Generic

  • --enable-unicode: enable Unicode support dependency: libncursesw default: yes
  • --enable-hwloc: enable hwloc support for CPU affinity; disables Linux affinity dependency: libhwloc default: no
  • --enable-static: build a static htop binary; hwloc and delay accounting are not supported default: no
  • --enable-debug: Enable asserts and internal sanity checks; implies a performance penalty default: no

Linux

  • --enable-sensors: enable libsensors(3) support for reading temperature data dependencies: libsensors-dev(build-time), at runtime libsensors is loaded via dlopen(3) if available default: check
  • --enable-capabilities: enable Linux capabilities support dependency: libcap default: check
  • --with-proc: location of a Linux-compatible proc filesystem default: /proc
  • --enable-openvz: enable OpenVZ support default: no
  • --enable-vserver: enable VServer support default: no
  • --enable-ancient-vserver: enable ancient VServer support (implies --enable-vserver) default: no
  • --enable-linux-affinity: enable Linux sched_setaffinity(2) and sched_getaffinity(2) for affinity support; conflicts with hwloc default: check
  • --enable-delayacct: enable Linux delay accounting support dependencies: pkg-config(build-time), libnl-3 and libnl-genl-3 default: check

Usage

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

Support

If you have trouble running htop please consult your Operating System / Linux distribution documentation for getting support and filing bugs.

Bugs, development feedback

We have a development mailing list. Feel free to subscribe for release announcements or asking questions on the development of htop.

You can also join our IRC channel #htop on freenode and talk to the developers there.

If you have found an issue with the source of htop, please check whether this has already been reported in our Github issue tracker. If not, please file a new issue describing the problem you have found, the location in the source code you are referring to and a possible fix.

History

htop was invented, developed and maintained by Hisham Muhammad from 2004 to 2019. His legacy repository has been archived to preserve the history.

In 2020 a team took over the development amicably and continues to maintain htop collaboratively.

License

GNU General Public License, version 2 (GPL-2.0)