summaryrefslogtreecommitdiff
path: root/sys/man/1/du
blob: c7ecc71e65d2e8c0779e3dc70a10a9bbdfc99b7f (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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
.TH DU 1
.SH NAME
du \- disk usage
.SH SYNOPSIS
.B du
[
.B -aefhnqstu
] [
.B -b
.I size
] [
.B -p
.I SI-prefix
] [
.I file ...
]
.SH DESCRIPTION
.I Du
gives the number of Kbytes allocated to data blocks
of named
.I files
and, recursively, of files in named directories.
It assumes storage is quantized in units of 1024 bytes (Kbytes) by default.
Other values can be set by the
.B -b
option;
.I size
is the number of bytes, optionally suffixed
.B k
to specify multiplication by 1024.
If
.I file
is missing,
the current directory is used.
The count for a directory includes the counts of the
contained files and directories.
.PP
The
.B -a
option prints the number of blocks
for every file in a directory.
Normally counts are printed only for contained directories.
.PP
The
.B -f
option suppresses the printing of warning messages.
.PP
The
.B -n
option prints the size in bytes and the name of each file; it sets
.BR -a .
.PP
The
.B -t
option prints, in the format of
.B du
.BR -n ,
the modified time of
each file rather than the size.
If the options
.B -tu
are specified then the accessed time is printed.
.PP
The
.B -q
option prints, in the format of
.B du
.BR -n ,
the QID path of
each file rather than the size.
.PP
The
.B -s
option causes
.I du
to descend the hierarchy as always, but to print only a summary line
for each
.IR file .
.PP
The
.B -e
option causes
.I du
to print values (sizes, times or QID paths)
in `scientific notation' via
.IR print (2)'s
.BR %g .
.PP
The
.B -h
option causes
.I du
to print values (sizes, times or QID paths)
in scientific notation,
scaled to less than 1024, and with a suitable SI prefix
(e.g.,
.L G
for binary gigabytes).
.PP
The
.B -p
option causes
.I du
to print values (sizes, times or QID paths)
in units of
.IR SI-prefix .
Case is ignored when looking up
.IR SI-prefix .
An empty
.IR SI-prefix
corresponds to a scale factor of 1 (e.g., print sizes in bytes).
.\" .PP
.\" The
.\" .B -r
.\" option causes
.\" .I du
.\" to read and discard every byte of every file encountered.
.SH EXAMPLES
Print the size of
.L /tmp
in fractional binary gigabytes:
.IP
.EX
% du -sepg /tmp
\&.6960154	/tmp
.EE
.LP
Print the size of
.L /tmp
in bytes and in scientific notation:
.IP
.EX
% du -sep '' /tmp
7.473408e+08	/tmp
.EE
.SH SOURCE
.B /sys/src/cmd/du.c