4a743f
[![build status](https://gitlab.com/ci/projects/2142/status.png?ref=master)](https://gitlab.com/ci/projects/2142?ref=master)
4a743f
procps
4a743f
======
4a743f
4a743f
procps is a set of command line and full-screen utilities that provide
4a743f
information out of the pseudo-filesystem most commonly located at /proc.
4a743f
This filesystem provides a simple interface to the kernel data structures.
4a743f
The programs of procps generally concentrate on the structures that describe
4a743f
the processess running on the system.
4a743f
4a743f
The following programs are found in procps:
4a743f
* *free* - Report the amount of free and used memory in the system
4a743f
* *kill* - Send a signal to a process based on PID
4a743f
* *pgrep* - List processes based on name or other attributes
4a743f
* *pkill* - Send a signal to a process based on name or other attributes
4a743f
* *pmap* - Report memory map of a process
4a743f
* *ps* - Report information of processes
4a743f
* *pwdx* - Report current directory of a process
4a743f
* *skill* - Obsolete version of pgrep/pkill
4a743f
* *slabtop* - Display kernel slab cache information in real time
4a743f
* *snice* - Renice a process
4a743f
* *sysctl* - Read or Write kernel parameters at run-time
4a743f
* *tload* - Graphical representation of system load average
4a743f
* *top* - Dynamic real-time view of running processes
4a743f
* *uptime* - Display how long the system has been running
4a743f
* *vmstat* - Report virtual memory statistics
4a743f
* *w* - Report logged in users and what they are doing
4a743f
* *watch* - Execute a program periodically, showing output fullscreen
4a743f
4a743f
## Reporting Bugs
4a743f
There are a few ways of reporting bugs or feature requests:
4a743f
4a743f
1. Your distributions bug reporter. If you are using a distribution your first
4a743f
port of call is their bug tracker. This is because each distribution has their
4a743f
own patches and way of dealing with bugs. Also bug reporting often does not need
4a743f
any subscription to websites.
4a743f
2. GitLab Issues - To the left of this page is the issue tracker. You can report
4a743f
bugs here.
4a743f
3. Email list - We have an email list (see below) where you can report bugs.
4a743f
The problem with this method is bug reports often get lost and cannot be
4a743f
tracked. This is especially a big problem when its something that will take
4a743f
time to resolve.
4a743f
4a743f
If you need to report bugs, there is more details on the
4a743f
[Bug Reporting](https://gitlab.com/procps-ng/procps/blob/master/Documentation/bugs.md)
4a743f
page.
4a743f
4a743f
## Email List
4a743f
The email list for the developers and users of procps is found at
4a743f
http://www.freelists.org/archive/procps/
4a743f
This email list discusses the development of procps and is used by distributions
4a743f
to also forward or discuss bugs.