aboutsummaryrefslogtreecommitdiffstats
path: root/htop.1
diff options
context:
space:
mode:
authorDaniel Lange <DLange@git.local>2020-08-27 07:48:10 +0200
committerDaniel Lange <DLange@git.local>2020-08-27 07:48:10 +0200
commitf3147ea2d1598914c2db53e8cfb34c8ff81e2ff4 (patch)
tree3ee82b2af2ab3d38b6e4b07f3994516aac72f742 /htop.1
parentdf568a576f7b44ac5a2b9b7222c7f39d9932f626 (diff)
downloaddebian_htop-f3147ea2d1598914c2db53e8cfb34c8ff81e2ff4.tar.gz
debian_htop-f3147ea2d1598914c2db53e8cfb34c8ff81e2ff4.tar.bz2
debian_htop-f3147ea2d1598914c2db53e8cfb34c8ff81e2ff4.zip
New upstream version 3.0.0upstream/3.0.0
Diffstat (limited to 'htop.1')
-rw-r--r--htop.1419
1 files changed, 0 insertions, 419 deletions
diff --git a/htop.1 b/htop.1
deleted file mode 100644
index c9189e2..0000000
--- a/htop.1
+++ /dev/null
@@ -1,419 +0,0 @@
-.TH "HTOP" "1" "2015" "htop 2.2.0" "Utils"
-.SH "NAME"
-htop \- interactive process viewer
-.SH "SYNOPSIS"
-.LP
-.B htop [\fI\-dChustv\fR]
-.SH "DESCRIPTION"
-.LP
-Htop is a free (GPL) ncurses-based process viewer for Linux.
-.LP
-It is similar to top, but allows you to scroll vertically and horizontally,
-so you can see all the processes running on the system, along with their full
-command lines, as well as viewing them as a process tree, selecting multiple
-processes and acting on them all at once.
-.LP
-Tasks related to processes (killing, renicing) can be done without
-entering their PIDs.
-.br
-.SH "COMMAND-LINE OPTIONS"
-.LP
-Mandatory arguments to long options are mandatory for short options too.
-.LP
-.TP
-\fB\-d \-\-delay=DELAY\fR
-Delay between updates, in tenths of seconds
-.TP
-\fB\-C \-\-no-color \-\-no-colour\fR
-Start htop in monochrome mode
-.TP
-\fB\-h \-\-help
-Display a help message and exit
-.TP
-\fB\-p \-\-pid=PID,PID...\fR
-Show only the given PIDs
-.TP
-\fB\-s \-\-sort\-key COLUMN\fR
-Sort by this column (use \-\-sort\-key help for a column list)
-.TP
-\fB\-u \-\-user=USERNAME\fR
-Show only the processes of a given user
-.TP
-\fB\-v \-\-version
-Output version information and exit
-.TP
-\fB\-t \-\-tree
-Show processes in tree view
-.PP
-.br
-.SH "INTERACTIVE COMMANDS"
-.LP
-The following commands are supported while in htop:
-.LP
-.TP 5
-.B Up, Alt-k
-Select (highlight) the previous process in the process list. Scroll the list
-if necessary.
-.TP
-.B Down, Alt-j
-Select (highlight) the next process in the process list. Scroll the list if
-necessary.
-.TP
-.B Left, Alt-h
-Scroll the process list left.
-.TP
-.B Right, Alt-l
-Scroll the process list right.
-.TP
-.B PgUp, PgDn
-Scroll the process list up or down one window.
-.TP
-.B Home
-Scroll to the top of the process list and select the first process.
-.TP
-.B End
-Scroll to the bottom of the process list and select the last process.
-.TP
-.B Ctrl-A, ^
-Scroll left to the beginning of the process entry (i.e. beginning of line).
-.TP
-.B Ctrl-E, $
-Scroll right to the end of the process entry (i.e. end of line).
-.TP
-.B Space
-Tag or untag a process. Commands that can operate on multiple processes,
-like "kill", will then apply over the list of tagged processes, instead
-of the currently highlighted one.
-.TP
-.B U
-Untag all processes (remove all tags added with the Space key).
-.TP
-.B s
-Trace process system calls: if strace(1) is installed, pressing this key
-will attach it to the currently selected process, presenting a live
-update of system calls issued by the process.
-.TP
-.B l
-Display open files for a process: if lsof(1) is installed, pressing this key
-will display the list of file descriptors opened by the process.
-.TP
-.B F1, h, ?
-Go to the help screen
-.TP
-.B F2, S
-Go to the setup screen, where you can configure the meters displayed at the top
-of the screen, set various display options, choose among color schemes, and
-select which columns are displayed, in which order.
-.TP
-.B F3, /
-Incrementally search the command lines of all the displayed processes. The
-currently selected (highlighted) command will update as you type. While in
-search mode, pressing F3 will cycle through matching occurrences.
-.TP
-.B F4, \\\\
-Incremental process filtering: type in part of a process command line and
-only processes whose names match will be shown. To cancel filtering,
-enter the Filter option again and press Esc.
-.TP
-.B F5, t
-Tree view: organize processes by parenthood, and layout the relations
-between them as a tree. Toggling the key will switch between tree and
-your previously selected sort view. Selecting a sort view will exit
-tree view.
-.TP
-.B F6
-On sorted view, select a field for sorting, also accessible through < and >.
-The current sort field is indicated by a highlight in the header.
-On tree view, expand or collapse the current subtree. A "+" indicator in the
-tree node indicates that it is collapsed.
-.TP
-.B F7, ]
-Increase the selected process's priority (subtract from 'nice' value).
-This can only be done by the superuser.
-.TP
-.B F8, [
-Decrease the selected process's priority (add to 'nice' value)
-.TP
-.B F9, k
-"Kill" process: sends a signal which is selected in a menu, to one or a group
-of processes. If processes were tagged, sends the signal to all tagged processes.
-If none is tagged, sends to the currently selected process.
-.TP
-.B F10, q
-Quit
-.TP
-.B I
-Invert the sort order: if sort order is increasing, switch to decreasing, and
-vice-versa.
-.TP
-.B +, \-
-When in tree view mode, expand or collapse subtree. When a subtree is collapsed
-a "+" sign shows to the left of the process name.
-.TP
-.B a (on multiprocessor machines)
-Set CPU affinity: mark which CPUs a process is allowed to use.
-.TP
-.B u
-Show only processes owned by a specified user.
-.TP
-.B M
-Sort by memory usage (top compatibility key).
-.TP
-.B P
-Sort by processor usage (top compatibility key).
-.TP
-.B T
-Sort by time (top compatibility key).
-.TP
-.B F
-"Follow" process: if the sort order causes the currently selected process
-to move in the list, make the selection bar follow it. This is useful for
-monitoring a process: this way, you can keep a process always visible on
-screen. When a movement key is used, "follow" loses effect.
-.TP
-.B K
-Hide kernel threads: prevent the threads belonging the kernel to be
-displayed in the process list. (This is a toggle key.)
-.TP
-.B H
-Hide user threads: on systems that represent them differently than ordinary
-processes (such as recent NPTL-based systems), this can hide threads from
-userspace processes in the process list. (This is a toggle key.)
-.TP
-.B p
-Show full paths to running programs, where applicable. (This is a toggle key.)
-.TP
-.B Ctrl-L
-Refresh: redraw screen and recalculate values.
-.TP
-.B Numbers
-PID search: type in process ID and the selection highlight will be moved to it.
-.PD
-
-.SH "COLUMNS"
-.LP
-The following columns can display data about each process. A value of '\-' in
-all the rows indicates that a column is unsupported on your system, or
-currently unimplemented in htop. The names below are the ones used in the
-"Available Columns" section of the setup screen. If a different name is
-shown in htop's main screen, it is shown below in parenthesis.
-.LP
-.TP 5
-.B Command
-The full command line of the process (i.e. program name and arguments).
-.TP
-.B PID
-The process ID.
-.TP
-.B STATE (S)
-The state of the process:
- \fBS\fR for sleeping (idle)
- \fBR\fR for running
- \fBD\fR for disk sleep (uninterruptible)
- \fBZ\fR for zombie (waiting for parent to read its exit status)
- \fBT\fR for traced or suspended (e.g by SIGTSTP)
- \fBW\fR for paging
-.TP
-.B PPID
-The parent process ID.
-.TP
-.B PGRP
-The process's group ID.
-.TP
-.B SESSION (SID)
-The process's session ID.
-.TP
-.B TTY_NR (TTY)
-The controlling terminal of the process.
-.TP
-.B TPGID
-The process ID of the foreground process group of the controlling terminal.
-.TP
-.B MINFLT
-The number of page faults happening in the main memory.
-.TP
-.B CMINFLT
-The number of minor faults for the process's waited-for children (see MINFLT above).
-.TP
-.B MAJFLT
-The number of page faults happening out of the main memory.
-.TP
-.B CMAJFLT
-The number of major faults for the process's waited-for children (see MAJFLT above).
-.TP
-.B UTIME (UTIME+)
-The user CPU time, which is the amount of time the process has spent executing
-on the CPU in user mode (i.e. everything but system calls), measured in clock
-ticks.
-.TP
-.B STIME (STIME+)
-The system CPU time, which is the amount of time the kernel has spent
-executing system calls on behalf of the process, measured in clock ticks.
-.TP
-.B CUTIME (CUTIME+)
-The children's user CPU time, which is the amount of time the process's
-waited-for children have spent executing in user mode (see UTIME above).
-.TP
-.B CSTIME (CSTIME+)
-The children's system CPU time, which is the amount of time the kernel has spent
-executing system calls on behalf of all the process's waited-for children (see
-STIME above).
-.TP
-.B PRIORITY (PRI)
-The kernel's internal priority for the process, usually just its nice value
-plus twenty. Different for real-time processes.
-.TP
-.B NICE (NI)
-The nice value of a process, from 19 (low priority) to -20 (high priority). A
-high value means the process is being nice, letting others have a higher
-relative priority. The usual OS permission restrictions for adjusting priority apply.
-.TP
-.B STARTTIME (START)
-The time the process was started.
-.TP
-.B PROCESSOR (CPU)
-The ID of the CPU the process last executed on.
-.TP
-.B M_SIZE (VIRT)
-The size of the virtual memory of the process.
-.TP
-.B M_RESIDENT (RES)
-The resident set size (text + data + stack) of the process (i.e. the size of the
-process's used physical memory).
-.TP
-.B M_SHARE (SHR)
-The size of the process's shared pages.
-.TP
-.B M_TRS (CODE)
-The text resident set size of the process (i.e. the size of the process's
-executable instructions).
-.TP
-.B M_DRS (DATA)
-The data resident set size (data + stack) of the process (i.e. the size of anything
-except the process's executable instructions).
-.TP
-.B M_LRS (LIB)
-The library size of the process.
-.TP
-.B M_DT (DIRTY)
-The size of the dirty pages of the process.
-.TP
-.B ST_UID (UID)
-The user ID of the process owner.
-.TP
-.B PERCENT_CPU (CPU%)
-The percentage of the CPU time that the process is currently using.
-.TP
-.B PERCENT_MEM (MEM%)
-The percentage of memory the process is currently using (based on the process's
-resident memory size, see M_RESIDENT above).
-.TP
-.B USER
-The username of the process owner, or the user ID if the name can't be
-determined.
-.TP
-.B TIME (TIME+)
-The time, measured in clock ticks that the process has spent in user and system
-time (see UTIME, STIME above).
-.TP
-.B NLWP
-The number of threads in the process.
-.TP
-.B TGID
-The thread group ID.
-.TP
-.B CTID
-OpenVZ container ID, a.k.a virtual environment ID.
-.TP
-.B VPID
-OpenVZ process ID.
-.TP
-.B VXID
-VServer process ID.
-.TP
-.B RCHAR (RD_CHAR)
-The number of bytes the process has read.
-.TP
-.B WCHAR (WR_CHAR)
-The number of bytes the process has written.
-.TP
-.B SYSCR (RD_SYSC)
-The number of read(2) syscalls for the process.
-.TP
-.B SYSCW (WR_SYSC)
-The number of write(2) syscalls for the process.
-.TP
-.B RBYTES (IO_RBYTES)
-Bytes of read(2) I/O for the process.
-.TP
-.B WBYTES (IO_WBYTES)
-Bytes of write(2) I/O for the process.
-.TP
-.B CNCLWB (IO_CANCEL)
-Bytes of cancelled write(2) I/O.
-.TP
-.B IO_READ_RATE (DISK READ)
-The I/O rate of read(2) in bytes per second, for the process.
-.TP
-.B IO_WRITE_RATE (DISK WRITE)
-The I/O rate of write(2) in bytes per second, for the process.
-.TP
-.B IO_RATE (DISK R/W)
-The I/O rate, IO_READ_RATE + IO_WRITE_RATE (see above).
-.TP
-.B CGROUP
-Which cgroup the process is in.
-.TP
-.B OOM
-OOM killer score.
-.TP
-.B IO_PRIORITY (IO)
-The I/O scheduling class followed by the priority if the class supports it:
- \fBR\fR for Realtime
- \fBB\fR for Best-effort
- \fBid\fR for Idle
-.TP
-.B PERCENT_CPU_DELAY (CPUD%)
-The percentage of time spent waiting for a CPU (while runnable). Requires CAP_NET_ADMIN.
-.TP
-.B PERCENT_IO_DELAY (IOD%)
-The percentage of time spent waiting for the completion of synchronous block I/O. Requires CAP_NET_ADMIN.
-.TP
-.B PERCENT_SWAP_DELAY (SWAPD%)
-The percentage of time spent swapping in pages. Requires CAP_NET_ADMIN.
-.TP
-.B All other flags
-Currently unsupported (always displays '-').
-
-.SH "CONFIG FILE"
-.LP
-By default htop reads its configuration from the XDG-compliant path
-~/.config/htop/htoprc -- the configuration file is overwritten by htop's
-in-program Setup configuration, so it should not be hand-edited. If no
-user configuration exists htop tries to read the system-wide configuration
-from ${prefix}/etc/htoprc and as a last resort, falls back to its
-hard coded defaults.
-.LP
-You may override the location of the configuration file using the $HTOPRC
-environment variable (so you can have multiple configurations for different
-machines that share the same home directory, for example).
-
-.SH "MEMORY SIZES"
-.LP
-Memory sizes in htop are displayed as they are in tools from the GNU Coreutils
-(when ran with the --human-readable option). This means that sizes are printed
-in powers of 1024. (e.g., 1023M = 1072693248 Bytes)
-.LP
-The decision to use this convention was made in order to conserve screen space
-and make memory size representations consistent throughout htop.
-
-.SH "SEE ALSO"
-proc(5), top(1), free(1), ps(1), uptime(1), limits.conf(5)
-
-.SH "AUTHORS"
-.LP
-htop is developed by Hisham Muhammad <hisham@gobolinux.org>.
-.LP
-This man page was written by Bartosz Fenski <fenio@o2.pl> for the Debian
-GNU/Linux distribution (but it may be used by others). It was updated by Hisham
-Muhammad, and later by Vincent Launchbury, who wrote the 'Columns' section.

© 2014-2024 Faster IT GmbH | imprint | privacy policy