aboutsummaryrefslogtreecommitdiff
path: root/swu.1
diff options
context:
space:
mode:
Diffstat (limited to 'swu.1')
-rw-r--r--swu.1103
1 files changed, 103 insertions, 0 deletions
diff --git a/swu.1 b/swu.1
new file mode 100644
index 0000000..d60f478
--- /dev/null
+++ b/swu.1
@@ -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:
+

Return to:

Send suggestions and report system problems to the System administrator.