Subversion Repositories planix.SVN

Rev

Rev 2 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
2 - 1 
.TH DU 1
2 
.SH NAME
3 
du \- disk usage
4 
.SH SYNOPSIS
5 
.B du
6 
[
7 
.B -aefhnqstu
8 
] [
9 
.B -b
10 
.I size
11 
] [
12 
.B -p
13 
.I SI-prefix
14 
] [
15 
.I file ...
16 
]
17 
.SH DESCRIPTION
18 
.I Du
19 
gives the number of Kbytes allocated to data blocks
20 
of named
21 
.I files
22 
and, recursively, of files in named directories.
23 
It assumes storage is quantized in units of 1024 bytes (Kbytes) by default.
24 
Other values can be set by the
25 
.B -b
26 
option;
27 
.I size
28 
is the number of bytes, optionally suffixed
29 
.B k
30 
to specify multiplication by 1024.
31 
If
32 
.I file
33 
is missing,
34 
the current directory is used.
35 
The count for a directory includes the counts of the
36 
contained files and directories.
37 
.PP
38 
The
39 
.B -a
40 
option prints the number of blocks
41 
for every file in a directory.
42 
Normally counts are printed only for contained directories.
43 
.PP
44 
The
45 
.B -f
46 
option suppresses the printing of warning messages.
47 
.PP
48 
The
49 
.B -n
50 
option prints the size in bytes and the name of each file; it sets
51 
.BR -a .
52 
.PP
53 
The
54 
.B -t
55 
option prints, in the format of
56 
.B du
57 
.BR -n ,
58 
the modified time of
59 
each file rather than the size.
60 
If the options
61 
.B -tu
62 
are specified then the accessed time is printed.
63 
.PP
64 
The
65 
.B -q
66 
option prints, in the format of
67 
.B du
68 
.BR -n ,
69 
the QID path of
70 
each file rather than the size.
71 
.PP
72 
The
73 
.B -s
74 
option causes
75 
.I du
76 
to descend the hierarchy as always, but to print only a summary line
77 
for each
78 
.IR file .
79 
.PP
80 
The
81 
.B -e
82 
option causes
83 
.I du
84 
to print values (sizes, times or QID paths)
85 
in `scientific notation' via
86 
.IR print (2)'s
87 
.BR %g .
88 
.PP
89 
The
90 
.B -h
91 
option causes
92 
.I du
93 
to print values (sizes, times or QID paths)
94 
in scientific notation,
95 
scaled to less than 1024, and with a suitable SI prefix
96 
(e.g.,
97 
.L G
98 
for binary gigabytes).
99 
.PP
100 
The
101 
.B -p
102 
option causes
103 
.I du
104 
to print values (sizes, times or QID paths)
105 
in units of
106 
.IR SI-prefix .
107 
Case is ignored when looking up
108 
.IR SI-prefix .
109 
An empty
110 
.IR SI-prefix
111 
corresponds to a scale factor of 1 (e.g., print sizes in bytes).
112 
.\" .PP
113 
.\" The
114 
.\" .B -r
115 
.\" option causes
116 
.\" .I du
117 
.\" to read and discard every byte of every file encountered.
118 
.SH EXAMPLES
119 
Print the size of
120 
.L /tmp
121 
in fractional binary gigabytes:
122 
.IP
123 
.EX
124 
% du -sepg /tmp
125 
\&.6960154	/tmp
126 
.EE
127 
.LP
128 
Print the size of
129 
.L /tmp
130 
in bytes and in scientific notation:
131 
.IP
132 
.EX
133 
% du -sep '' /tmp
134 
7.473408e+08	/tmp
135 
.EE
136 
.SH SOURCE
137 
.B /sys/src/cmd/du.c