summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
Diffstat (limited to 'README')
-rw-r--r--README52
1 files changed, 42 insertions, 10 deletions
diff --git a/README b/README
index 992978fc..24e1a6c5 100644
--- a/README
+++ b/README
@@ -45,6 +45,18 @@ Then install the latest Glances version:
$ sudo pip install glances
+### From PPA (Ubuntu/Mint)
+
+Thanks to Arnaud Hartmann, a PPA is available for the stable branch.
+
+To install it on your Ubuntu system:
+
+ $ sudo add-apt-repository ppa:arnaud-hartmann/glances-stable
+ $ sudo apt-get update
+ $ sudo apt-get install glances
+
+The PPA is available for Ubuntu version 9.10 to 12.04.
+
### From source
Get the latest version:
@@ -94,23 +106,23 @@ When Glances is running, you can press:
* 'd' Disable or enable the disk IO stats
* 'f' Disable or enable the file system stats
* 'l' Disable or enable the logs
-* 'm' to sort the processes list by process size
+* 'm' to sort the processes list by process MEM
* 'n' Disable or enable the network interfaces stats
+* 'p' to sort by process name
* 'q' Exit
### Header
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/header.png)
-The header shows the Glances version, the host name and the operating
-system name, version and architecture.
+The header shows the host name and the operating system name, version and architecture.
### CPU
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/cpu.png)
The CPU states are shown as a percentage and for the configured refresh
-time.
+time. The total CPU usage is displayed on the first line.
If user|kernel|nice CPU is < 50%, then status is set to "OK".
@@ -129,7 +141,8 @@ average sum of the number of processes waiting in the run-queue plus the
number currently executing over 1, 5, and 15 minute time periods."
Glances gets the number of CPU cores to adapt the alerts. With Glances,
-alerts on average load are only set on 5 and 15 mins.
+alerts on average load are only set on 5 and 15 mins. The first line
+also display the number of CPU core.
If average load is < O.7*Core, then status is set to "OK".
@@ -143,7 +156,7 @@ If average load is > 5*Core, then status is set to "CRITICAL".
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/mem.png)
-Glances uses tree columns: memory (RAM), swap and "real".
+Glances uses tree columns: memory (RAM), "real" and swap.
Real used memory is: used - cache.
@@ -217,6 +230,25 @@ sorted by CPU of memory consumption.
The number of processes in the list is adapted to the screen size.
+* VIRT: Virtual memory size (in byte)
+* REST: Amount of resident memory (in byte)
+* CPU%: % of CPU used by the process
+* MEM%: % of MEM used by the process
+* PID: Process ID
+* USER: Process user ID
+* NI: Nice level of the process
+* S: Process status
+
+ R - Running
+ D - Sleeping (may not be interrupted)
+ S - Sleeping (may be interrupted)
+ T - Traced or stopped
+ Z - Zombie or "hung" process
+
+* TIME+: Cumulative CPU time used
+* NAME: Process name or command line
+
+
### Logs
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/logs.png)
@@ -237,7 +269,7 @@ There is one line per alert with the following information:
![screenshot](https://github.com/nicolargo/glances/raw/master/doc/footer.png)
-Glances displays a caption and the current time/date.
+Glances displays the current time/date and access to the embeded help screen.
## Localisation
@@ -251,6 +283,6 @@ i18n_espanol_generate.sh
You are welcome to contribute to this software.
-* Packaging for Debian, Ubuntu, BSD...
-* Check the needed Python library in the configure.ac
-* Add file system stats when the python-statgrab is corrected
+* Code optimization
+* Port to FreeBSD and Mac OS X
+* Documentation for HTML and CVS export option