memwatch.1

.\" Manpage for memwatch
.TH MEMWATCH 1 "MAY 2016" Linux "User Manuals"
.SH NAME
memwatch \- Shows memory usage statistics in real time.
.SH SYNOPSIS
.B memwatch
.RI [ options ]
.SH DESCRIPTION
The main window displays the general statistics on the use of memory.
.TP
Data gather from /proc/meminfo.
.TP
The displayed keys for physical ram (Memory [unit size]):
.TP
\fBTotal\fR
Total usable ram.
.TP
\fBFree\fR
Unused memory.
.TP
\fBUsed\fR
Used memory (calculated as Total - Free - Buff - Cache).
.TP
\fBBuff\fR
Memory used by kernel buffers.
.TP
\fBCache\fR
Memory used by the page cache and slabs.
.TP
\fBAvail\fR
An estimate of how much memory is available for starting new applications, without swapping.
.TP
The displayed keys for swap (Swap [unit size]):
.TP
\fBTotal\fR
Total amount of swap space available.
.TP
\fBFree\fR
Unused swap space.
.TP
\fBUsed\fR
Used swap space.
.TP
Window of Process list prints processes, sorted by memory usage.
.TP
Data gather from /proc/PID/status and /proc/PID/cmdline.
.TP
\fBPID\fR
Process ID.
.TP
\fBOWNER\fR
Process owner.
.TP
\fBRES\fR
The size of use physical memory.
.TP
\fBSHR\fR
The size of the process's shared pages.
.TP
\fBVIRT\fR
The total amount of virtual memory used by the task.
.TP
\fBSWAP\fR
The size of the process's address space in swap.
.TP
\fBS\fR
Process status. Zombie processes are not displayed, since do not consume memory.
The status of the task which can be one of:
  \fBD\fR - uninterruptible sleep.
  \fBR\fR - running.
  \fBS\fR - sleeping.
  \fBT\fR - stopped by job control signal.
  \fBt\fR - stopped by debugger during trace.
.TP
\fBCommand\fR
The full command line of the process. Program name and arguments.
.TP
Process information window shows additional information.
.TP
Data gather from /proc/PID/status and /proc/PID/cmdline.
.TP
\fBVirtual, Peak\fR
Current virtual and peak vertual memory usage.
.TP
\fBResident, Peak\fR
Current physical and peak physical memory usage.
.TP
\fBShared\fR
The size of the process's shared pages.
.TP
\fBSwap\fR
The size of the process's address space in swap.
.TP
\fBData\fR
Size of data segments.
.TP
\fBStack\fR
Size of stack segments.
.TP
\fBText\fR
Size of text segments.
.TP
\fBLibrary\fR
Shared library code size.
.SH OPTIONS
.TP
\fB-d\fR, \fB\-\-delay\fR \fIseconds\fR
Set data update interval. Minimum value is 0.1, maximum is 60.
.TP
\fB-S\fR, \fB\-\-si\fR
Print sizes in powers of 1000 instead of 1024. In the International System of Units (SI) the prefix kilo means 1000.
.TP
\fB\-b\fR, \fB\-\-bytes\fR
Display the amount of memory in bytes.
.TP
\fB\-k\fR, \fB\-\-kilo\fR
Display the amount of memory in kilobytes.
.TP
\fB\-m\fR, \fB\-\-mega\fR
Display the amount of memory in megabytes.
.TP
\fB\-g\fR, \fB\-\-giga\fR
Display the amount of memory in gigabytes.
.TP
\fB\-t\fR, \fB\-\-tera\fR
Display the amount of memory in terabytes.
.TP
\fB\-h\fR, \fB\-\-human\fR
Display the amount of memory in human readable format.
.TP
\fB\-l\fR, \fB\-\-list\fR
Display a list of processes.
.TP
\fB-p\fR, \fB\-\-pid\fR \fIPID\fR
Show only processes with specified PID.
.TP
\fB\-V\fR, \fB\-\-version\fR
Prints version.
.TP
\fB\-\-help\fR
Prints help message.
.SH INTERACTIVE COMMANDS
.LP
The following commands are supported while in memwatch:
.LP
Global hotkeys:
.TP
.B b
Display the amount of memory in bytes.
.TP
.B k
Display the amount of memory in kilobytes.
.TP
.B m
Display the amount of memory in megabytes.
.TP
.B g
Display the amount of memory in gigabytes.
.TP
.B t
Display the amount of memory in terabytes.
.TP
.B h
Display the amount of memory in human readable format.
.TP
.B s
Toggle power size (1000 or 1024).
.TP
.B l
Switch between the main window and a list of processes.
.TP
.B F1, ?
Print help.
.TP
.B q
Exit memwatch.
.LP
Process list hotkeys:
.TP
.B Arrows
Scroll process list.
.TP
.B Home
Go to the begining of the process list.
.TP
.B End
Go to the end of the process list.
.TP
.B 1
Sort by RSS field.
.TP
.B 2
Sort by SHR field.
.TP
.B 3
Sort by VIRT field.
.TP
.B 4
Sort by SWAP field.
.TP
.B r
Switch the sort order.
.TP
.B Enter
Show information by selected process.
.TP
.B /
Look for a process by name.
.LP
Process information hotkeys:
.TP
.B Enter
Back to process list.
.SH AUTHOR
Pavel Balaev (pascal@unixdev.ru)