mirror of
https://github.com/xzeldon/htop.git
synced 2024-12-25 15:25:45 +00:00
new screenshot
This commit is contained in:
parent
36260b5814
commit
fc016ae780
68
README
68
README
@ -8,7 +8,7 @@
|
|||||||
[![Packaging status](https://repology.org/badge/tiny-repos/htop.svg)](https://repology.org/project/htop/versions)
|
[![Packaging status](https://repology.org/badge/tiny-repos/htop.svg)](https://repology.org/project/htop/versions)
|
||||||
[![License: GPL v2+](https://img.shields.io/badge/License-GPL%20v2+-blue.svg)](COPYING?raw=true)
|
[![License: GPL v2+](https://img.shields.io/badge/License-GPL%20v2+-blue.svg)](COPYING?raw=true)
|
||||||
|
|
||||||
![Screenshot of htop](docs/images/screenshot.png?raw=true)
|
![Screenshot of htop](https://i.imgur.com/dCSsvSv.png)
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
|
|
||||||
@ -30,21 +30,25 @@ For more information and details visit [htop.dev](https://htop.dev).
|
|||||||
## Build instructions
|
## Build instructions
|
||||||
|
|
||||||
### Prerequisite
|
### Prerequisite
|
||||||
|
|
||||||
List of build-time dependencies:
|
List of build-time dependencies:
|
||||||
|
|
||||||
* standard GNU autotools-based C toolchain
|
* standard GNU autotools-based C toolchain
|
||||||
- C99 compliant compiler
|
* C99 compliant compiler
|
||||||
- `autoconf`
|
* `autoconf`
|
||||||
- `autotools`
|
* `autotools`
|
||||||
* `ncurses`
|
* `ncurses`
|
||||||
|
|
||||||
**Note about `ncurses`:**
|
**Note about `ncurses`:**
|
||||||
> `htop` requires `ncurses` 6.0. Be aware the appropriate package is sometimes still called libncurses5 (on Debian/Ubuntu). Also `ncurses` usually comes in two flavours:
|
> `htop` requires `ncurses` 6.0. Be aware the appropriate package is sometimes still called libncurses5 (on Debian/Ubuntu). Also `ncurses` usually comes in two flavours:
|
||||||
|
>
|
||||||
>* With Unicode support.
|
>* With Unicode support.
|
||||||
>* Without Unicode support.
|
>* Without Unicode support.
|
||||||
>
|
>
|
||||||
> This is also something that is reflected in the package name on Debian/Ubuntu (via the additional 'w' - 'w'ide character support).
|
> This is also something that is reflected in the package name on Debian/Ubuntu (via the additional 'w' - 'w'ide character support).
|
||||||
|
|
||||||
List of additional build-time dependencies (based on feature flags):
|
List of additional build-time dependencies (based on feature flags):
|
||||||
|
|
||||||
* `sensors`
|
* `sensors`
|
||||||
* `hwloc`
|
* `hwloc`
|
||||||
* `libcap` (v2.21 or later)
|
* `libcap` (v2.21 or later)
|
||||||
@ -53,32 +57,39 @@ List of additional build-time dependencies (based on feature flags):
|
|||||||
Install these and other required packages for C development from your package manager.
|
Install these and other required packages for C development from your package manager.
|
||||||
|
|
||||||
**Debian/Ubuntu**
|
**Debian/Ubuntu**
|
||||||
|
|
||||||
~~~ shell
|
~~~ shell
|
||||||
sudo apt install libncursesw5-dev autotools-dev autoconf build-essential
|
sudo apt install libncursesw5-dev autotools-dev autoconf build-essential
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
**Fedora/RHEL**
|
**Fedora/RHEL**
|
||||||
|
|
||||||
~~~ shell
|
~~~ shell
|
||||||
sudo dnf install ncurses-devel automake autoconf gcc
|
sudo dnf install ncurses-devel automake autoconf gcc
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
**Archlinux/Manjaro**
|
**Archlinux/Manjaro**
|
||||||
|
|
||||||
~~~ shell
|
~~~ shell
|
||||||
sudo pacman -S ncurses automake autoconf gcc
|
sudo pacman -S ncurses automake autoconf gcc
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
**macOS**
|
**macOS**
|
||||||
|
|
||||||
~~~ shell
|
~~~ shell
|
||||||
brew install ncurses automake autoconf gcc
|
brew install ncurses automake autoconf gcc
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
### Compile from source:
|
### Compile from source
|
||||||
|
|
||||||
To compile from source, download from the Git repository (`git clone` or downloads from [GitHub releases](https://github.com/htop-dev/htop/releases/)), then run:
|
To compile from source, download from the Git repository (`git clone` or downloads from [GitHub releases](https://github.com/htop-dev/htop/releases/)), then run:
|
||||||
|
|
||||||
~~~ shell
|
~~~ shell
|
||||||
./autogen.sh && ./configure && make
|
./autogen.sh && ./configure && make
|
||||||
~~~
|
~~~
|
||||||
|
|
||||||
### Install
|
### Install
|
||||||
|
|
||||||
To install on the local system run `make install`. By default `make install` installs into `/usr/local`. To change this path use `./configure --prefix=/some/path`.
|
To install on the local system run `make install`. By default `make install` installs into `/usr/local`. To change this path use `./configure --prefix=/some/path`.
|
||||||
|
|
||||||
### Build Options
|
### Build Options
|
||||||
@ -89,65 +100,68 @@ To install on the local system run `make install`. By default `make install` ins
|
|||||||
|
|
||||||
* `--enable-unicode`:
|
* `--enable-unicode`:
|
||||||
enable Unicode support
|
enable Unicode support
|
||||||
- dependency: *libncursesw*
|
* dependency: *libncursesw*
|
||||||
- default: *yes*
|
* default: *yes*
|
||||||
* `--enable-affinity`:
|
* `--enable-affinity`:
|
||||||
enable `sched_setaffinity(2)` and `sched_getaffinity(2)` for affinity support; conflicts with hwloc
|
enable `sched_setaffinity(2)` and `sched_getaffinity(2)` for affinity support; conflicts with hwloc
|
||||||
- default: *check*
|
* default: *check*
|
||||||
* `--enable-hwloc`:
|
* `--enable-hwloc`:
|
||||||
enable hwloc support for CPU affinity; disables affinity support
|
enable hwloc support for CPU affinity; disables affinity support
|
||||||
- dependency: *libhwloc*
|
* dependency: *libhwloc*
|
||||||
- default: *no*
|
* default: *no*
|
||||||
* `--enable-static`:
|
* `--enable-static`:
|
||||||
build a static htop binary; hwloc and delay accounting are not supported
|
build a static htop binary; hwloc and delay accounting are not supported
|
||||||
- default: *no*
|
* default: *no*
|
||||||
* `--enable-debug`:
|
* `--enable-debug`:
|
||||||
Enable asserts and internal sanity checks; implies a performance penalty
|
Enable asserts and internal sanity checks; implies a performance penalty
|
||||||
- default: *no*
|
* default: *no*
|
||||||
|
|
||||||
#### Performance Co-Pilot
|
#### Performance Co-Pilot
|
||||||
|
|
||||||
* `--enable-pcp`:
|
* `--enable-pcp`:
|
||||||
enable Performance Co-Pilot support via a new pcp-htop utility
|
enable Performance Co-Pilot support via a new pcp-htop utility
|
||||||
- dependency: *libpcp*
|
* dependency: *libpcp*
|
||||||
- default: *no*
|
* default: *no*
|
||||||
|
|
||||||
#### Linux
|
#### Linux
|
||||||
|
|
||||||
* `--enable-sensors`:
|
* `--enable-sensors`:
|
||||||
enable libsensors(3) support for reading temperature data
|
enable libsensors(3) support for reading temperature data
|
||||||
- dependencies: *libsensors-dev*(build-time), at runtime *libsensors* is loaded via `dlopen(3)` if available
|
* dependencies: *libsensors-dev*(build-time), at runtime *libsensors* is loaded via `dlopen(3)` if available
|
||||||
- default: *check*
|
* default: *check*
|
||||||
* `--enable-capabilities`:
|
* `--enable-capabilities`:
|
||||||
enable Linux capabilities support
|
enable Linux capabilities support
|
||||||
- dependency: *libcap*
|
* dependency: *libcap*
|
||||||
- default: *check*
|
* default: *check*
|
||||||
* `--with-proc`:
|
* `--with-proc`:
|
||||||
location of a Linux-compatible proc filesystem
|
location of a Linux-compatible proc filesystem
|
||||||
- default: */proc*
|
* default: */proc*
|
||||||
* `--enable-openvz`:
|
* `--enable-openvz`:
|
||||||
enable OpenVZ support
|
enable OpenVZ support
|
||||||
- default: *no*
|
* default: *no*
|
||||||
* `--enable-vserver`:
|
* `--enable-vserver`:
|
||||||
enable VServer support
|
enable VServer support
|
||||||
- default: *no*
|
* default: *no*
|
||||||
* `--enable-ancient-vserver`:
|
* `--enable-ancient-vserver`:
|
||||||
enable ancient VServer support (implies `--enable-vserver`)
|
enable ancient VServer support (implies `--enable-vserver`)
|
||||||
- default: *no*
|
* default: *no*
|
||||||
* `--enable-delayacct`:
|
* `--enable-delayacct`:
|
||||||
enable Linux delay accounting support
|
enable Linux delay accounting support
|
||||||
- dependencies: *pkg-config*(build-time), *libnl-3* and *libnl-genl-3*
|
* dependencies: *pkg-config*(build-time), *libnl-3* and *libnl-genl-3*
|
||||||
- default: *check*
|
* default: *check*
|
||||||
|
|
||||||
|
## Runtime dependencies
|
||||||
|
|
||||||
## Runtime dependencies:
|
|
||||||
`htop` has a set of fixed minimum runtime dependencies, which is kept as minimal as possible:
|
`htop` has a set of fixed minimum runtime dependencies, which is kept as minimal as possible:
|
||||||
|
|
||||||
* `ncurses` libraries for terminal handling (wide character support).
|
* `ncurses` libraries for terminal handling (wide character support).
|
||||||
|
|
||||||
### Runtime optional dependencies:
|
### Runtime optional dependencies
|
||||||
|
|
||||||
`htop` has a set of fixed optional dependencies, depending on build/configure option used:
|
`htop` has a set of fixed optional dependencies, depending on build/configure option used:
|
||||||
|
|
||||||
#### Linux
|
#### Linux
|
||||||
|
|
||||||
* `libdl`, if not building a static binary, is always required when support for optional dependencies (i.e. `libsensors`, `libsystemd`) is present.
|
* `libdl`, if not building a static binary, is always required when support for optional dependencies (i.e. `libsensors`, `libsystemd`) is present.
|
||||||
* `libcap`, user-space interfaces to POSIX 1003.1e capabilities, is always required when `--enable-capabilities` was used to configure `htop`.
|
* `libcap`, user-space interfaces to POSIX 1003.1e capabilities, is always required when `--enable-capabilities` was used to configure `htop`.
|
||||||
* `libsensors`, readout of temperatures and CPU speeds, is optional even when `--enable-sensors` was used to configure `htop`.
|
* `libsensors`, readout of temperatures and CPU speeds, is optional even when `--enable-sensors` was used to configure `htop`.
|
||||||
@ -156,11 +170,13 @@ To install on the local system run `make install`. By default `make install` ins
|
|||||||
`htop` checks for the availability of the actual runtime libraries as `htop` runs.
|
`htop` checks for the availability of the actual runtime libraries as `htop` runs.
|
||||||
|
|
||||||
#### BSD
|
#### BSD
|
||||||
|
|
||||||
On most BSD systems `kvm` is a requirement to read kernel information.
|
On most BSD systems `kvm` is a requirement to read kernel information.
|
||||||
|
|
||||||
More information on required and optional dependencies can be found in [configure.ac](configure.ac).
|
More information on required and optional dependencies can be found in [configure.ac](configure.ac).
|
||||||
|
|
||||||
## Usage
|
## Usage
|
||||||
|
|
||||||
See the manual page (`man htop`) or the help menu (**F1** or **h** inside `htop`) for a list of supported key commands.
|
See the manual page (`man htop`) or the help menu (**F1** or **h** inside `htop`) for a list of supported key commands.
|
||||||
|
|
||||||
## Support
|
## Support
|
||||||
|
Loading…
Reference in New Issue
Block a user