htop - an interactive process viewer
Go to file
Nathan Scott b7836515e8 Harden the extraction of boot time for the Linux platform
There is a possible path - albeit theoretical really - through
the btime initialization code in Linux ProcessList_new(), when
String_startsWith() is always false, which can result in btime
not being initialized.

This commit refactors the code to remove that possibility.
2020-12-14 12:16:32 +11:00
.github/workflows GitHub CI: add macOS build 2020-12-08 16:07:45 +01:00
darwin Merge branch 'fix_mach_timebase' of benbe/htop 2020-12-13 20:02:38 +01:00
docs Fix a little typo (spelling) in the styleguide 2020-12-01 14:15:16 +11:00
dragonflybsd Cull the definitions of pageSize and pageSizeKB from CRT.c 2020-12-10 11:57:48 +11:00
freebsd Drop redundant sys/dirent.h include 2020-12-11 20:57:19 +01:00
iwyu Add sys/dirent.h to iwyu/htop.imp 2020-12-11 20:57:19 +01:00
linux Harden the extraction of boot time for the Linux platform 2020-12-14 12:16:32 +11:00
openbsd Cull the definitions of pageSize and pageSizeKB from CRT.c 2020-12-10 11:57:48 +11:00
scripts Track file descriptors in valgrind script 2020-11-25 22:09:39 +01:00
solaris Cull the definitions of pageSize and pageSizeKB from CRT.c 2020-12-10 11:57:48 +11:00
unsupported Move Process_fields from unsupported/Platform to unsupported/UnsupportedProcess 2020-12-13 17:58:16 +01:00
zfs Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +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
AUTHORS Update AUTHORS file with htop-dev team 2020-12-05 11:07:32 +01:00
Action.c Sort in paused mode after inverting sort order 2020-12-09 13:43:07 +01:00
Action.h Hide process selection on ESC 2020-11-28 19:49:38 +01:00
Affinity.c IWYU update (FreeBSD) 2020-11-19 23:51:50 +01:00
Affinity.h IWYU update (FreeBSD) 2020-11-19 23:51:50 +01:00
AffinityPanel.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
AffinityPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
AvailableColumnsPanel.c Allow to pass '/' for item search 2020-12-03 22:41:31 +01:00
AvailableColumnsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
AvailableMetersPanel.c Update even more snprintfs 2020-11-28 19:33:07 +01:00
AvailableMetersPanel.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
BatteryMeter.c Use size_t as len type for Meter_UpdateValues 2020-12-06 16:03:44 +01:00
BatteryMeter.h Mark Object instances const 2020-10-07 13:01:53 +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 Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
CPUMeter.h Show CPU temperature in CPU meter 2020-11-16 16:38:54 +01:00
CRT.c Cull the definitions of pageSize and pageSizeKB from CRT.c 2020-12-10 11:57:48 +11:00
CRT.h Cull the definitions of pageSize and pageSizeKB from CRT.c 2020-12-10 11:57:48 +11: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 Some minor additions to the changelog 2020-12-04 07:51:33 +01:00
ClockMeter.c Use size_t as len type for Meter_UpdateValues 2020-12-06 16:03:44 +01:00
ClockMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ColorsPanel.c IWYU update 2020-12-06 15:32:16 +01:00
ColorsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ColumnsPanel.c Allow to pass '/' for item search 2020-12-03 22:41:31 +01:00
ColumnsPanel.h Fix segmentation fault when column name is NULL. 2020-10-31 18:34:34 +01:00
CommandScreen.c Improving Command display/sort 2020-11-24 19:05:48 +01:00
CommandScreen.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
Compat.c Resolve conversion from ssize_t to int for readlink return value 2020-12-05 19:58:32 +01:00
Compat.h IWYU update 2020-12-06 15:32:16 +01:00
DateMeter.c Use size_t as len type for Meter_UpdateValues 2020-12-06 16:03:44 +01:00
DateMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DateTimeMeter.c Use size_t as len type for Meter_UpdateValues 2020-12-06 16:03:44 +01:00
DateTimeMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DiskIOMeter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
DiskIOMeter.h Convert personal copyright authorship to team 2020-12-04 13:55:55 +01:00
DisplayOptionsPanel.c IWYU update 2020-12-06 15:32:16 +01:00
DisplayOptionsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
EnvScreen.c Improving Command display/sort 2020-11-24 19:05:48 +01:00
EnvScreen.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
FunctionBar.c Embracing branches 2020-11-02 22:15:01 +01:00
FunctionBar.h Add key to pause process list updates 2020-10-12 13:04:00 +02:00
Hashtable.c IWYU update 2020-12-06 15:32:16 +01:00
Hashtable.h Implement Hashtable_clear to empty an existing Hashtable 2020-11-29 14:54:10 +01:00
Header.c Remove unused function Header_readMeterName 2020-12-06 16:03:25 +01:00
Header.h Remove unused function Header_readMeterName 2020-12-06 16:03:25 +01:00
HostnameMeter.c Use size_t as len type for Meter_UpdateValues 2020-12-06 16:03:44 +01:00
HostnameMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
IncSet.c Embracing branches 2020-11-02 22:15:01 +01:00
IncSet.h Spacing around operators 2020-11-02 22:15:01 +01:00
InfoScreen.c Common order for ESC/q/F10 2020-12-03 22:41:31 +01:00
InfoScreen.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
ListItem.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
ListItem.h Small ListItem update 2020-10-28 20:49:11 +01:00
LoadAverageMeter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
LoadAverageMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Macros.h Introduce spaceship comparison for Processes 2020-11-15 18:25:21 +01:00
MainPanel.c Minor code streamlining 2020-12-02 23:50:05 +01:00
MainPanel.h Spacing around operators 2020-11-02 22:15:01 +01:00
Makefile.am Update htop logo, provide .svg file as well 2020-12-05 13:46:34 +01:00
MemoryMeter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
MemoryMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Meter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
Meter.h Introduce METER_BUFFER_CHECK and METER_BUFFER_APPEND_CHR to cleanup writing to bar buffers 2020-12-06 16:03:44 +01:00
MetersPanel.c Make all required includes explicit 2020-10-18 20:09:05 +02:00
MetersPanel.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
NEWS Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
NetworkIOMeter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
NetworkIOMeter.h Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
Object.c Avoid calling Object_isA from inside Vector_isConsistent 2020-11-17 08:06:02 +01:00
Object.h Object: assert callbacks exists 2020-11-22 10:10:34 +01:00
OpenFilesScreen.c Improving Command display/sort 2020-11-24 19:05:48 +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 Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
Panel.h Hide process selection on ESC 2020-11-28 19:49:38 +01:00
Process.c Cull the definitions of pageSize and pageSizeKB from CRT.c 2020-12-10 11:57:48 +11:00
Process.h Use size_t as type for buffer length in Process 2020-12-06 16:03:44 +01:00
ProcessList.c Additional code simplification 2020-12-08 21:24:19 +01:00
ProcessList.h Implement sorting in tree mode 2020-12-02 23:50:05 +01:00
ProcessLocksScreen.c ProcessLocksScreen_draw: use Process_getCommand instead of raw comm 2020-11-25 12:43:30 +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 Add screen shot of htop to readme 2020-10-01 20:21:44 +13:00
README.md Add README.md for Github 2014-02-03 09:11:39 -02:00
RichString.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
RichString.h Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
ScreenManager.c Fix pause mode ("Z") in tree view 2020-12-09 13:28:15 +01:00
ScreenManager.h Drop unneeded parameters to the ScreenManager constructor 2020-11-26 23:55:53 +01:00
Settings.c Dynamically load libsensors at runtime 2020-12-02 21:03:24 +01:00
Settings.h IWYU update 2020-12-06 15:32:16 +01:00
SignalsPanel.c Update even more snprintfs 2020-11-28 19:33:07 +01:00
SignalsPanel.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
SwapMeter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
SwapMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
TESTPLAN Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
TasksMeter.c Split RichString_(append|appendn|write) into wide and ascii 2020-12-08 20:58:40 +01:00
TasksMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
TraceScreen.c Improving Command display/sort 2020-11-24 19:05:48 +01:00
TraceScreen.h Make all required includes explicit 2020-10-18 20:09:05 +02:00
UptimeMeter.c Use size_t as len type for Meter_UpdateValues 2020-12-06 16:03:44 +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 Avoid calling Object_isA from inside Vector_isConsistent 2020-11-17 08:06:02 +01:00
XUtils.c Use size_t as len type for xSnprintf 2020-12-06 16:03:44 +01:00
XUtils.h Use size_t as len type for xSnprintf 2020-12-06 16:03:44 +01:00
autogen.sh autotools: enable warnings and cleanup 2020-09-17 21:45:11 +02:00
configure.ac Correct timebase for non-x86 CPUs on Darwin 2020-12-13 11:47:34 +01:00
htop.1.in Remove superflous breaks around man page section heads 2020-12-14 11:03:46 +11:00
htop.c Set locale only once and do not override it later 2020-12-02 22:08:25 +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
test_spec.lua Remove trailing whitespaces 2020-08-21 10:37:33 +02:00

README.md

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.

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)