diff options
Diffstat (limited to 'swu.1')
-rw-r--r-- | swu.1 | 103 |
1 files changed, 103 insertions, 0 deletions
@@ -0,0 +1,103 @@ +.\" This file is part of swu -*- nroff -*- +.\" Copyright (C) 2016 Sergey Poznyakoff +.\" +.\" Swu 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; either version 3, or (at your option) +.\" any later version. +.\" +.\" Swu is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with swu. If not, see <http://www.gnu.org/licenses/>. +.TH SWU 1 "March 12, 2016" "SWU" "User Commands" +.SH NAME +swu \- summarize swap usage +.SH SYNOPSIS +\fBswu\fR +[\fB\-acHhnprstv\fR] +[\fB\-\-all\fR] +[\fB\-\-help\fR] +[\fB\-\-human-readable\fR] +[\fB\-\-si\fR] +[\fB\-\-name\fR] +[\fB\-\-pid\fR] +[\fB\-\-reverse\fR] +[\fB\-\-size\fR] +[\fB\-\-total\fR] +[\fB\-\-verbose\fR] +[\fIPROGRAM\fR]... +.sp +\fBswu \-\-help\fR +.SH DESCRIPTION +Displays the amount of swap space used by each +.I PROGRAM +argument. Without arguments, displays information about programs that +use non-zero amount of swap space. With \fB\-a\fR (\fB\-\-all\fR) +option, displays information about all programs, including those that +use no swap space. +.PP +The output consists of three columns: PID, swap space used, and +program name. By default, it is sorted by the used swap space in +ascending order. +.SH OPTIONS +.TP +.BR \-a ", " \-\-all +Print all entries, including those with zero size. +.TP +.B \-\-help +Produce help output. +.TP +.BR \-h ", " \-\-human\-readable +Print sizes in human readable format (e.g., 1K 234M 2G). +.TP +.BR \-H ", " \-\-si +Likewise, but use powers of 1000 not 1024. +.TP +.BR \-n ", " \-\-name +Sort output by name. +.TP +.BR \-p ", " \-\-pid +Sort output by PID. +.TP +.BR \-r ", " \-\-reverse +Reverse sorting order. +.TP +.BR \-s ", " \-\-size +Sort output by size (default). +.TP +.BR \-c ", " \-t ", " \-\-total +Produce grand total. +.TP +.BR \-v ", " \-\-verbose +Produce additional diagnostics. +.SH BUGS +The program is Linux-specific. +.PP +The produced grand total (see the \fB\-t\fR option) can differ +somewhat from what is reported by +.BR free (1). +.SH AUTHORS +Sergey Poznyakoff +.SH "BUG REPORTS" +Report bugs to <gray@gnu.org.ua>. +.SH COPYRIGHT +Copyright \(co 2016 Sergey Poznyakoff +.br +.na +License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html> +.br +.ad +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.\" Local variables: +.\" eval: (add-hook 'write-file-hooks 'time-stamp) +.\" time-stamp-start: ".TH [A-Z_][A-Z0-9_.\\-]* [0-9] \"" +.\" time-stamp-format: "%:B %:d, %:y" +.\" time-stamp-end: "\"" +.\" time-stamp-line-limit: 20 +.\" end: + |