mirror of
https://github.com/clearlinux/psstop.git
synced 2026-08-18 21:36:01 +00:00
Auke Kok
f2e96c9511
This uses `ronn` to create a developer-maintained manual page. The output is pushed into git, such that a normal distribution compilation does not need to have `ronn` installed to do a full install. Developers will need to check in the psstop.1 file after modifying the psstop.1.md file
96 lines
2.5 KiB
Groff
96 lines
2.5 KiB
Groff
.\" generated with Ronn/v0.7.3
|
|
.\" http://github.com/rtomayko/ronn/tree/0.7.3
|
|
.
|
|
.TH "PSSTOP" "1" "March 2018" "" ""
|
|
.
|
|
.SH "NAME"
|
|
\fBpsstop\fR \- memory snapshot of the current processes based on /proc
|
|
.
|
|
.SH "SYNOPSIS"
|
|
\fB/usr/bin/psstop\fR
|
|
.
|
|
.SH "DESCRIPTION"
|
|
The Linux kernel exposes memory usage information about running processes in the \fBprocfs\fR filesystem\. This information can be retrieved by reading several files that can simply be read as ordinary text files and offer various different views of the usage of memory by processes\.
|
|
.
|
|
.P
|
|
Because memory consumption between applications and processes is often shared between threads, there are different ways to describe how much memory a specific thread or process is actually using\. Depending on what kind of memory consumption you want to know about, you may have to determine the right memory consumption metric\.
|
|
.
|
|
.P
|
|
The PSS (Proportional set size) usage of a process is a method to describe memory consumption by a process that accounts for it\'s proportion of shared memory consumption between itself and other processes that also cover shared memory resources\. These shared resources could be any type of shared memory that is shared between processes, like buffers or caches, or library code\.
|
|
.
|
|
.SH "SYNTAX"
|
|
\fBpsstop\fR is meant to be directly executed from the command line:
|
|
.
|
|
.IP "" 4
|
|
.
|
|
.nf
|
|
|
|
psstop
|
|
|
|
[\.\.\.]
|
|
|
|
0 Kb: (sd\-pam) (24051)
|
|
1122 Kb: tmux: server (31523)
|
|
4 Kb: bash (31524)
|
|
4 Kb: bash (31525)
|
|
4 Kb: vim (31684)
|
|
Total is 14958Kb (174 processes)
|
|
.
|
|
.fi
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "OPTIONS"
|
|
The following options are understood:
|
|
.
|
|
.TP
|
|
\fB\-c\fR:
|
|
.
|
|
.IP
|
|
Display the basename of the executable rather than the name of the process or thread\.
|
|
.
|
|
.TP
|
|
\fB\-p processname\fR:
|
|
.
|
|
.IP
|
|
Display the PSS usage of processes that match the provided process name\.
|
|
.
|
|
.TP
|
|
\fB\-h\fR:
|
|
.
|
|
.IP
|
|
Display the program\'s available options\.
|
|
.
|
|
.SH "EXIT STATUS"
|
|
On success, 0 is returned, a non\-zero failure code otherwise\.
|
|
.
|
|
.SH "FILES"
|
|
\fB/proc/*/smaps\fR
|
|
.
|
|
.SH "SEE ALSO"
|
|
.
|
|
.IP "\(bu" 4
|
|
ps(1)
|
|
.
|
|
.IP "\(bu" 4
|
|
free(1)
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBhttps://en\.wikipedia\.org/wiki/Proportional_set_size\fR
|
|
.
|
|
.IP "\(bu" 4
|
|
\fBprocfs(5)\fR
|
|
.
|
|
.IP "" 0
|
|
.
|
|
.SH "BUGS"
|
|
Please report bugs to: \fBdev@lists\.clearlinux\.org\fR
|
|
.
|
|
.SH "COPYRIGHT"
|
|
.
|
|
.IP "\(bu" 4
|
|
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 or later of the License
|
|
.
|
|
.IP "" 0
|
|
|