htop - an interactive process viewer
Go to file
Christian Göttsche edf1b10d2c Read CPU frequency from sysfs by default
Use the more portable sysfs node /sys/devices/system/cpu/cpuX/cpufreq/scaling_cur_freq
to get the CPU frequency.
In case of an error fall back to /proc/cpuinfo .

Also use a fixed width of 4 for the frequency to avoid position jumps
in case the frequency moves in the range 900-1100 MHz.
2020-09-24 20:11:28 +02:00
.github/workflows Convert hwlock CI run to a full featured one 2020-08-28 13:10:41 +02:00
darwin Update CPU freq display to use NAN on error 2020-09-24 18:06:36 +02:00
dragonflybsd Update CPU freq display to use NAN on error 2020-09-24 18:06:36 +02:00
freebsd Update CPU freq display to use NAN on error 2020-09-24 18:06:36 +02:00
linux Read CPU frequency from sysfs by default 2020-09-24 20:11:28 +02:00
openbsd Update CPU freq display to use NAN on error 2020-09-24 18:06:36 +02:00
solaris Update CPU freq display to use NAN on error 2020-09-24 18:06:36 +02:00
unsupported Update CPU freq display to use NAN on error 2020-09-24 18:06:36 +02:00
zfs Refactor __attribute__ usage 2020-09-18 12:28:40 +02:00
.editorconfig Add `trim_trailing_whitespace` to editorconfig 2019-10-31 11:39:57 -05:00
.gitignore Axe automated header generation. 2020-09-03 11:58:58 -05:00
.travis.yml Fail travis CI on compiler warnings 2020-09-18 12:28:40 +02:00
AUTHORS Initial import. 2006-03-04 18:16:49 +00:00
Action.c show selected command wrapped in a separate window 2020-09-24 19:22:25 +02:00
Action.h Use strict function prototypes 2020-09-18 12:28:40 +02:00
Affinity.c Avoid checking of undefined macros 2020-09-18 12:28:40 +02:00
Affinity.h Merge identical ifdefs in Affinity.h 2020-09-12 19:21:27 -03:00
AffinityPanel.c Avoid arithmetic on booleans 2020-09-23 19:09:11 +02:00
AffinityPanel.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
AvailableColumnsPanel.c Call character checking function with unsigned char 2020-09-17 22:03:24 +02:00
AvailableColumnsPanel.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
AvailableMetersPanel.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
AvailableMetersPanel.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
BatteryMeter.c Update battery API to use NAN on error 2020-09-24 18:06:36 +02:00
BatteryMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05: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 Read CPU frequency from sysfs by default 2020-09-24 20:11:28 +02:00
CPUMeter.h Consolidate repeated macro definitions into one header 2020-09-09 16:56:04 +10:00
CRT.c Mark noreturn functions 2020-09-18 12:28:40 +02:00
CRT.h Avoid checking of undefined macros 2020-09-18 12:28:40 +02:00
CategoriesPanel.c Call character checking function with unsigned char 2020-09-17 22:03:24 +02:00
CategoriesPanel.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
ChangeLog Bump version, changelog for minor htop-3.0.2 release 2020-09-15 09:43:36 +10:00
CheckItem.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
CheckItem.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
ClockMeter.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
ClockMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
ColorsPanel.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
ColorsPanel.h Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
ColumnsPanel.c Call character checking function with unsigned char 2020-09-17 22:03:24 +02:00
ColumnsPanel.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
CommandScreen.c show selected command wrapped in a separate window 2020-09-24 19:22:25 +02:00
CommandScreen.h show selected command wrapped in a separate window 2020-09-24 19:22:25 +02:00
DisplayOptionsPanel.c Revert the vim_mode setting for now, needs a rethink 2020-09-15 09:33:58 +10:00
DisplayOptionsPanel.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
EnvScreen.c Consolidate repeated macro definitions into one header 2020-09-09 16:56:04 +10:00
EnvScreen.h Remove superfluous 'extern's from function declarations. 2020-09-03 11:59:26 -05:00
FunctionBar.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
FunctionBar.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
Hashtable.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
Hashtable.h Remove superfluous 'extern's from function declarations. 2020-09-03 11:59:26 -05:00
Header.c Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
Header.h Consolidate repeated macro definitions into one header 2020-09-09 16:56:04 +10:00
HostnameMeter.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
HostnameMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
IncSet.c Call character checking function with unsigned char 2020-09-17 22:03:24 +02:00
IncSet.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
InfoScreen.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
InfoScreen.h Add format attribute 2020-09-18 12:28:40 +02:00
ListItem.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
ListItem.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
LoadAverageMeter.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
LoadAverageMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
Macros.h Refactor __attribute__ usage 2020-09-18 12:28:40 +02:00
MainPanel.c Call character checking function with unsigned char 2020-09-17 22:03:24 +02:00
MainPanel.h Use strict function prototypes 2020-09-18 12:28:40 +02:00
Makefile.am show selected command wrapped in a separate window 2020-09-24 19:22:25 +02:00
MemoryMeter.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
MemoryMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
Meter.c Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
Meter.h Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
MetersPanel.c Free movingBar memory on exit 2020-09-17 22:04:11 +02:00
MetersPanel.h Free movingBar memory on exit 2020-09-17 22:04:11 +02:00
NEWS Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
Object.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
Object.h Consolidate repeated macro definitions into one header 2020-09-09 16:56:04 +10:00
OpenFilesScreen.c Check for fdopen failure in OpenFilesScreen_getProcessData 2020-09-17 21:43:53 +02:00
OpenFilesScreen.h Further, minor cleanups to headers post-MakeHeaders 2020-09-08 17:33:50 +10:00
Panel.c Call character checking function with unsigned char 2020-09-17 22:03:24 +02:00
Panel.h Drop unused variable 2020-09-18 12:22:18 +02:00
Process.c Update IO rate display to use NAN on error 2020-09-24 18:06:36 +02:00
Process.h Drop dead process fields 2020-09-24 17:48:38 +02:00
ProcessList.c Switch variable/field naming from WhiteList to MatchList 2020-09-09 19:38:15 +10:00
ProcessList.h Switch variable/field naming from WhiteList to MatchList 2020-09-09 19:38:15 +10: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 Avoid checking of undefined macros 2020-09-18 12:28:40 +02:00
RichString.h Avoid checking of undefined macros 2020-09-18 12:28:40 +02:00
ScreenManager.c Revert the vim_mode setting for now, needs a rethink 2020-09-15 09:33:58 +10:00
ScreenManager.h Remove some unused #includes 2020-09-12 23:32:31 -03:00
Settings.c Reorder check to avoid crash on invalid process field setting 2020-09-17 21:46:22 +02:00
Settings.h Revert the vim_mode setting for now, needs a rethink 2020-09-15 09:33:58 +10:00
SignalsPanel.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
SignalsPanel.h Use strict function prototypes 2020-09-18 12:28:40 +02:00
StringUtils.c Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
StringUtils.h Remove superfluous 'extern's from function declarations. 2020-09-03 11:59:26 -05:00
SwapMeter.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
SwapMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
TESTPLAN Remove trailing whitespaces 2020-08-21 10:37:33 +02:00
TasksMeter.c Consolidate repeated macro definitions into one header 2020-09-09 16:56:04 +10:00
TasksMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
TraceScreen.c Avoid hardcoding of buffer size 2020-09-17 21:43:05 +02:00
TraceScreen.h Remove superfluous 'extern's from function declarations. 2020-09-03 11:59:26 -05:00
UptimeMeter.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
UptimeMeter.h Axe automated header generation. 2020-09-03 11:58:58 -05:00
UsersTable.c Axe automated header generation. 2020-09-03 11:58:58 -05:00
UsersTable.h Use strict function prototypes 2020-09-18 12:28:40 +02:00
Vector.c Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
Vector.h Clean up some code duplication in the header files 2020-09-12 19:20:44 -03:00
XAlloc.c Refactor __attribute__ usage 2020-09-18 12:28:40 +02:00
XAlloc.h Mark noreturn functions 2020-09-18 12:28:40 +02:00
autogen.sh autotools: enable warnings and cleanup 2020-09-17 21:45:11 +02:00
configure.ac Add -Wfloat-equal to default build flags 2020-09-24 18:06:36 +02:00
htop.1.in show selected command wrapped in a separate window 2020-09-24 19:22:25 +02:00
htop.c Add DeepCode inline suppression 2020-09-24 20:04:47 +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)