aboutsummaryrefslogtreecommitdiff
path: root/swu.1
blob: f38dd6066798ad4f5cffcf3d69d659935e60b6d0 (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
104
105
106
107
108
109
.\" This file is part of swu -*- nroff -*-
.\" Copyright (C) 2016, 2019 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 "July 31, 2019" "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]...
.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).
.\" The MANCGI variable is set by man.cgi script on Ulysses.
.\" The download.inc file contains the default DOWNLOAD section
.\" for man-based doc pages.
.if "\V[MANCGI]"WEBDOC" \{\
.       ds package swu
.       ds version 1.0
.       so download.inc
\}
.SH AUTHORS
Sergey Poznyakoff
.SH "BUG REPORTS"
Report bugs to <gray@gnu.org.ua>.
.SH COPYRIGHT
Copyright \(co 2016, 2019 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.