ffc65b3827
If using a setting from a different development version with an
unsupported process field, first dereferencing Process_fields[id] yields
to a crash:
=================================================================
==19530==ERROR: AddressSanitizer: global-buffer-overflow on address 0x000000612800 at pc 0x000000521d1a bp 0x7ffec47a5ff0 sp 0x7ffec47a5fe8
READ of size 8 at 0x000000612800 thread T0
#0 0x521d19 in readFields .htop/Settings.c:107:40
#1 0x51d117 in Settings_read .htop/Settings.c:141:10
#2 0x51c0c4 in Settings_new .htop/Settings.c:382:12
#3 0x4eafe2 in main .htop/htop.c:220:25
#4 0x7fa450570cc9 in __libc_start_main csu/../csu/libc-start.c:308:16
#5 0x427a59 in _start (.htop/htop+0x427a59)
0x000000612800 is located 0 bytes to the right of global variable 'Process_fields' defined in 'linux/LinuxProcess.c:24:18' (0x6118a0) of size 3936
SUMMARY: AddressSanitizer: global-buffer-overflow .htop/Settings.c:107:40 in readFields
Shadow bytes around the buggy address:
0x0000800ba4b0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0000800ba4c0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0000800ba4d0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0000800ba4e0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
0x0000800ba4f0: 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00
=>0x0000800ba500:[f9]f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9
0x0000800ba510: f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9
0x0000800ba520: f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9
0x0000800ba530: f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9
0x0000800ba540: f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9
0x0000800ba550: f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9 f9
Shadow byte legend (one shadow byte represents 8 application bytes):
Addressable: 00
Partially addressable: 01 02 03 04 05 06 07
Heap left redzone: fa
Freed heap region: fd
Stack left redzone: f1
Stack mid redzone: f2
Stack right redzone: f3
Stack after return: f5
Stack use after scope: f8
Global redzone: f9
Global init order: f6
Poisoned by user: f7
Container overflow: fc
Array cookie: ac
Intra object redzone: bb
ASan internal: fe
Left alloca redzone: ca
Right alloca redzone: cb
Shadow gap: cc
==19530==ABORTING
|
||
|---|---|---|
| .github/workflows | ||
| darwin | ||
| dragonflybsd | ||
| freebsd | ||
| linux | ||
| openbsd | ||
| solaris | ||
| unsupported | ||
| zfs | ||
| .editorconfig | ||
| .gitignore | ||
| .travis.yml | ||
| AUTHORS | ||
| Action.c | ||
| Action.h | ||
| Affinity.c | ||
| Affinity.h | ||
| AffinityPanel.c | ||
| AffinityPanel.h | ||
| AvailableColumnsPanel.c | ||
| AvailableColumnsPanel.h | ||
| AvailableMetersPanel.c | ||
| AvailableMetersPanel.h | ||
| BatteryMeter.c | ||
| BatteryMeter.h | ||
| CONTRIBUTING.md | ||
| COPYING | ||
| CPUMeter.c | ||
| CPUMeter.h | ||
| CRT.c | ||
| CRT.h | ||
| CategoriesPanel.c | ||
| CategoriesPanel.h | ||
| ChangeLog | ||
| CheckItem.c | ||
| CheckItem.h | ||
| ClockMeter.c | ||
| ClockMeter.h | ||
| ColorsPanel.c | ||
| ColorsPanel.h | ||
| ColumnsPanel.c | ||
| ColumnsPanel.h | ||
| DisplayOptionsPanel.c | ||
| DisplayOptionsPanel.h | ||
| EnvScreen.c | ||
| EnvScreen.h | ||
| FunctionBar.c | ||
| FunctionBar.h | ||
| Hashtable.c | ||
| Hashtable.h | ||
| Header.c | ||
| Header.h | ||
| HostnameMeter.c | ||
| HostnameMeter.h | ||
| IncSet.c | ||
| IncSet.h | ||
| InfoScreen.c | ||
| InfoScreen.h | ||
| ListItem.c | ||
| ListItem.h | ||
| LoadAverageMeter.c | ||
| LoadAverageMeter.h | ||
| Macros.h | ||
| MainPanel.c | ||
| MainPanel.h | ||
| Makefile.am | ||
| MemoryMeter.c | ||
| MemoryMeter.h | ||
| Meter.c | ||
| Meter.h | ||
| MetersPanel.c | ||
| MetersPanel.h | ||
| NEWS | ||
| Object.c | ||
| Object.h | ||
| OpenFilesScreen.c | ||
| OpenFilesScreen.h | ||
| Panel.c | ||
| Panel.h | ||
| Process.c | ||
| Process.h | ||
| ProcessList.c | ||
| ProcessList.h | ||
| README | ||
| README.md | ||
| RichString.c | ||
| RichString.h | ||
| ScreenManager.c | ||
| ScreenManager.h | ||
| Settings.c | ||
| Settings.h | ||
| SignalsPanel.c | ||
| SignalsPanel.h | ||
| StringUtils.c | ||
| StringUtils.h | ||
| SwapMeter.c | ||
| SwapMeter.h | ||
| TESTPLAN | ||
| TasksMeter.c | ||
| TasksMeter.h | ||
| TraceScreen.c | ||
| TraceScreen.h | ||
| UptimeMeter.c | ||
| UptimeMeter.h | ||
| UsersTable.c | ||
| UsersTable.h | ||
| Vector.c | ||
| Vector.h | ||
| XAlloc.c | ||
| XAlloc.h | ||
| autogen.sh | ||
| configure.ac | ||
| htop.1.in | ||
| htop.c | ||
| htop.desktop | ||
| htop.png | ||
| test_spec.lua | ||
README.md
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)