htop - an interactive process viewer
Go to file
Benny Baumann 81543253cf Fix misaligned access inside taskstats structure
Reported by UB sanitizer (alongside several other messages):
linux/LinuxProcessList.c:782:25: runtime error: member access within misaligned address 0x614000000264 for type 'struct taskstats', which requires 8 byte alignment
0x614000000264: note: pointer points here
  64 01 03 00 0a 00 00 00  00 00 00 00 02 00 00 00  00 00 00 00 4b c8 2e 00  00 00 00 00 3e 45 3c fd
              ^

The issue doesn't cause trouble on x86, but any architecture with stricter memory alignment requirements may inadvertedly break.
2020-10-18 17:20:34 +02:00
.github/workflows Keep building on errors 2020-10-15 20:31:56 +02:00
darwin Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
dragonflybsd Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
freebsd Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
linux Fix misaligned access inside taskstats structure 2020-10-18 17:20:34 +02:00
openbsd Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
scripts Add script to run htop under valgrind 2020-09-17 22:06:36 +02:00
solaris Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
unsupported Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
zfs Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02: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 Keep building on errors 2020-10-15 20:45:39 +02:00
AUTHORS Initial import. 2006-03-04 18:16:49 +00:00
Action.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
Action.h Add key to pause process list updates 2020-10-12 13:04:00 +02:00
Affinity.c Update License consistently to GPLv2 as per COPYING file 2020-10-05 10:13:12 +02:00
Affinity.h Update License consistently to GPLv2 as per COPYING file 2020-10-05 10:13:12 +02:00
AffinityPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
AffinityPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
AvailableColumnsPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
AvailableColumnsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
AvailableMetersPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
AvailableMetersPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
BatteryMeter.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
BatteryMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
CONTRIBUTING.md Updates to project URLs in docs and embedded in source code 2020-08-22 15:47:11 +10:00
COPYING Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
CPUMeter.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
CPUMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
CRT.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
CRT.h Generalize Meter value colors for IO 2020-10-16 20:00:14 +02:00
CategoriesPanel.c Mark Object instances const 2020-10-07 13:01:53 +02:00
CategoriesPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ChangeLog Bump version, changelog for minor htop-3.0.2 release 2020-09-15 09:43:36 +10:00
CheckItem.c Mark Object pointer to _display function const 2020-10-10 11:25:19 +02:00
CheckItem.h Mark Object pointer to _display function const 2020-10-10 11:25:19 +02:00
ClockMeter.c Mark Object instances const 2020-10-07 13:01:53 +02:00
ClockMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ColorsPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
ColorsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
ColumnsPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
ColumnsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
CommandScreen.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
CommandScreen.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DateMeter.c Mark Object instances const 2020-10-07 13:01:53 +02:00
DateMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DateTimeMeter.c Mark Object instances const 2020-10-07 13:01:53 +02:00
DateTimeMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DiskIOMeter.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
DiskIOMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
DisplayOptionsPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
DisplayOptionsPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
EnvScreen.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
EnvScreen.h Mark Object instances const 2020-10-07 13:01:53 +02:00
FunctionBar.c Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
FunctionBar.h Add key to pause process list updates 2020-10-12 13:04:00 +02:00
Hashtable.c Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
Hashtable.h Update License consistently to GPLv2 as per COPYING file 2020-10-05 10:13:12 +02:00
Header.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
Header.h Mark Object instances const 2020-10-07 13:01:53 +02:00
HostnameMeter.c Mark Object instances const 2020-10-07 13:01:53 +02:00
HostnameMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
IncSet.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
IncSet.h Add key to pause process list updates 2020-10-12 13:04:00 +02:00
InfoScreen.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
InfoScreen.h Mark process argument of Process_isThread const 2020-10-09 10:18:40 +02:00
ListItem.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
ListItem.h Mark Object instances const 2020-10-07 13:01:53 +02:00
LoadAverageMeter.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
LoadAverageMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Macros.h Enclose CLAMP macro arguments in parentheses 2020-10-06 11:46:41 +02:00
MainPanel.c Add key to pause process list updates 2020-10-12 13:04:00 +02:00
MainPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Makefile.am Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
MemoryMeter.c Mark Object pointer to _display function const 2020-10-10 11:25:19 +02:00
MemoryMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Meter.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
Meter.h CPUMeter: avoid crashes and leaks in case the CPU count changes 2020-10-12 13:15:23 +02:00
MetersPanel.c Add key to pause process list updates 2020-10-12 13:04:00 +02:00
MetersPanel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
NEWS Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
NetworkIOMeter.c Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
NetworkIOMeter.h Add NetworkIOMeter 2020-10-16 20:00:14 +02:00
Object.c Mark Object classes and Object class fields const 2020-10-07 13:01:53 +02:00
Object.h Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
OpenFilesScreen.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
OpenFilesScreen.h OpenFilesScreen update 2020-10-10 11:26:43 +02:00
Panel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
Panel.h Mark Object instances const 2020-10-07 13:01:53 +02:00
Process.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
Process.h Refactor generating starttime string into Process class 2020-10-16 19:23:40 +02:00
ProcessList.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
ProcessList.h Mark Object classes and Object class fields const 2020-10-07 13:01:53 +02:00
README Update creation date to 2004 (thanks rubyFeedback) 2020-09-17 09:47:28 +02:00
README.md Add README.md for Github 2014-02-03 09:11:39 -02:00
RichString.c Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
RichString.h Merge branch 'update-license-and-copyright-info' 2020-10-06 10:27:38 +11:00
ScreenManager.c Add key to pause process list updates 2020-10-12 13:04:00 +02:00
ScreenManager.h Add key to pause process list updates 2020-10-12 13:04:00 +02:00
Settings.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
Settings.h Settings: do not save initial cpu count 2020-10-12 13:15:23 +02:00
SignalsPanel.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
SignalsPanel.h Update License consistently to GPLv2 as per COPYING file 2020-10-05 10:13:12 +02:00
SwapMeter.c Mark Object pointer to _display function const 2020-10-10 11:25:19 +02: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 Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
TasksMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
TraceScreen.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
TraceScreen.h Mark Object instances const 2020-10-07 13:01:53 +02:00
UptimeMeter.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
UptimeMeter.h Mark Object instances const 2020-10-07 13:01:53 +02:00
UsersTable.c Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
UsersTable.h Update License consistently to GPLv2 as per COPYING file 2020-10-05 10:13:12 +02:00
Vector.c Misc Vector updates 2020-10-16 19:47:34 +02:00
Vector.h Misc Vector updates 2020-10-16 19:47:34 +02:00
XUtils.c Release old memory on error 2020-10-17 20:54:14 +02:00
XUtils.h Combine XAlloc.[ch] into XUtils.[ch] 2020-10-17 20:54:14 +02:00
autogen.sh autotools: enable warnings and cleanup 2020-09-17 21:45:11 +02:00
configure.ac Automatically detect if backtrace(3) needs -lexecinfo 2020-10-16 10:58:14 +02:00
htop.1.in Add key to pause process list updates 2020-10-12 13:04:00 +02:00
htop.c Rename StringUtils.[ch] to XUtils.[ch] 2020-10-16 20:30:21 +02:00
htop.desktop Add danish translation to htop.desktop 2019-02-19 01:25:52 +01:00
htop.png Updated icon! 2014-04-09 14:47:58 -03: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

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)