112 lines
2.2 KiB
ReStructuredText
112 lines
2.2 KiB
ReStructuredText
====================================================
|
|
tmux-mem-cpu-load
|
|
====================================================
|
|
----------------------------------------------------
|
|
CPU, RAM memory, and load monitor for use with tmux_
|
|
----------------------------------------------------
|
|
|
|
|
|
|
|
Description
|
|
===========
|
|
|
|
|
|
A simple, lightweight program provided for system monitoring in the *status*
|
|
line of **tmux**.
|
|
|
|
The memory monitor displays the used and available memory.
|
|
|
|
The CPU usage monitor outputs a percent CPU usage over all processors. It also
|
|
displays a textual bar graph of the current percent usage.
|
|
|
|
The system load average is also displayed.
|
|
|
|
Example output::
|
|
|
|
2885/7987MB [||||| ] 51.2% 2.11 2.35 2.44
|
|
|
|
^ ^ ^ ^ ^ ^ ^
|
|
| | | | | | |
|
|
1 2 3 4 5 6 7
|
|
|
|
1. Currently used memory.
|
|
2. Available memory.
|
|
3. CPU usage bar graph.
|
|
4. CPU usage percentage.
|
|
5. Load average for the past minute.
|
|
6. Load average for the past 5 minutes.
|
|
7. Load average for the past 15 minutes.
|
|
|
|
|
|
Installation
|
|
============
|
|
|
|
|
|
Dependencies
|
|
------------
|
|
|
|
Currently only tested on Linux. Mac OSX is known not to work. Patches or
|
|
hardware are welcome.
|
|
|
|
Building
|
|
~~~~~~~~
|
|
|
|
* >= CMake_ -2.6
|
|
* C++ compiler (e.g. gcc/g++)
|
|
|
|
|
|
Download
|
|
--------
|
|
|
|
There are links to the source code at the `project homepage`_.
|
|
|
|
|
|
Build
|
|
-----
|
|
|
|
::
|
|
|
|
cd <source dir>
|
|
cmake .
|
|
make
|
|
|
|
|
|
Install
|
|
-------
|
|
|
|
::
|
|
|
|
su -
|
|
make install
|
|
logout
|
|
|
|
|
|
|
|
Configuring tmux_
|
|
=======================
|
|
|
|
|
|
Edit ``$HOME/.tmux.conf`` to display the program's output in *status-left* or
|
|
*status-right*. For example::
|
|
|
|
set -g status-interval 2
|
|
set -g status-left "#S #[fg=green,bg=black,bright]#(tmux-mem-cpu-load 2)#[default]"
|
|
|
|
Note that the first argument to `tmux-mem-cpu-load` should be the same number
|
|
of seconds that *status-interval* is set at.
|
|
|
|
An optional second argument is the number of bars in the bar graph, which
|
|
defaults to 10. This can, for instance, be set to the number of cores in a
|
|
multi-core system.
|
|
|
|
|
|
Author
|
|
======
|
|
|
|
Matt McCormick (thewtex) <matt@mmmccormick.com>
|
|
|
|
|
|
.. _tmux: http://tmux.sourceforge.net/
|
|
.. _CMake: http://www.cmake.org
|
|
.. _`project homepage`: http://github.com/thewtex/tmux-mem-cpu-load
|