summaryrefslogtreecommitdiffabout
path: root/swu.1
blob: d60f4783653b8053909c5c9b4080e8c6d86e280a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
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.