View | Details | Raw Unified | Return to bug 162438
Collapse All | Expand All

(-)b/usr.bin/du/du.1 (-45 / +51 lines)
Lines 28-34 Link Here
28 
.\"	@(#)du.1	8.2 (Berkeley) 4/1/94
 28 
.\"	@(#)du.1	8.2 (Berkeley) 4/1/94
29 
.\" $FreeBSD$
 29 
.\" $FreeBSD$
30 
.\"
 30 
.\"
31 
.Dd November 6, 2008
 31 
.Dd November 10, 2011
32 
.Dt DU 1
 32 
.Dt DU 1
33 
.Os
 33 
.Os
34 
.Sh NAME
 34 
.Sh NAME
Lines 36-50 Link Here
36 
.Nd display disk usage statistics
 36 
.Nd display disk usage statistics
37 
.Sh SYNOPSIS
 37 
.Sh SYNOPSIS
38 
.Nm
 38 
.Nm
39 
.Op Fl A
 39 
.Op Fl Achklmnx
40 
.Op Fl H | L | P
 40 
.Op Fl H | L | P
41 
.Op Fl a | s | d Ar depth | Fl t Ar threshold
 41 
.Op Fl a | s | d Ar depth
42 
.Op Fl c
 42 
.Op Fl B Ar blocksize
43 
.Op Fl l
44 
.Op Fl h | k | m | B Ar blocksize
45 
.Op Fl n
46 
.Op Fl x
47 
.Op Fl I Ar mask
 43 
.Op Fl I Ar mask
44 
.Op Fl t Ar threshold
48 
.Op Ar
 45 
.Op Ar
49 
.Sh DESCRIPTION
 46 
.Sh DESCRIPTION
50 
The
 47 
The
Lines 61-71 The options are as follows: Link Here
61 
Display the apparent size instead of the disk usage.
 58 
Display the apparent size instead of the disk usage.
62 
This can be helpful when operating on compressed volumes or sparse files.
 59 
This can be helpful when operating on compressed volumes or sparse files.
63 
.It Fl B Ar blocksize
 60 
.It Fl B Ar blocksize
64 
Calculate block counts in
 61 
Calculate block count in
65 
.Ar blocksize
 62 
.Ar blocksize
66 
byte blocks.
 63 
byte blocks.
67 
This is different from the
 64 
This is different from the
68 
.Fl k, m
 65 
.Fl h, k
66 
and
67 
.Fl  m
69 
options or setting
 68 
options or setting
70 
.Ev BLOCKSIZE
 69 
.Ev BLOCKSIZE
71 
and gives an estimate of how much space the examined file hierarchy would
 70 
and gives an estimate of how much space the examined file hierarchy would
Lines 79-98 is rounded up to the next multiple of 512. Link Here
79 
.It Fl H
 78 
.It Fl H
80 
Symbolic links on the command line are followed, symbolic links in file
 79 
Symbolic links on the command line are followed, symbolic links in file
81 
hierarchies are not followed.
 80 
hierarchies are not followed.
82 
.It Fl L
83 
Symbolic links on the command line and in file hierarchies are followed.
84 
.It Fl I Ar mask
 81 
.It Fl I Ar mask
85 
Ignore files and directories matching the specified
 82 
Ignore files and directories matching the specified
86 
.Ar mask .
 83 
.Ar mask .
84 
.It Fl L
85 
Symbolic links on the command line and in file hierarchies are followed.
87 
.It Fl P
 86 
.It Fl P
88 
No symbolic links are followed.
 87 
No symbolic links are followed.
89 
This is the default.
 88 
This is the default.
90 
.It Fl a
 89 
.It Fl a
91 
Display an entry for each file in a file hierarchy.
 90 
Display an entry for each file in a file hierarchy.
91 
.It Fl c
92 
Display a grand total.
93 
.It Fl d Ar depth
94 
Display an entry for all files and directories
95 
.Ar depth
96 
directories deep.
92 
.It Fl h
 97 
.It Fl h
93 
"Human-readable" output.
 98 
"Human-readable" output.
94 
Use unit suffixes: Byte, Kilobyte, Megabyte,
 99 
Use unit suffixes: Byte, Kilobyte, Megabyte,
95 
Gigabyte, Terabyte and Petabyte.
 100 
Gigabyte, Terabyte and Petabyte.
101 
.It Fl k
102 
Display block count in 1024-byte (1-Kbyte) blocks.
103 
.It Fl l
104 
If a file has multiple hard links, count its size many times.
105 
The default behavior of
106 
.Nm
107 
is to count files with multiple hard links only once.
108 
When the
109 
.Fl l
110 
option is specified, the hard link checks are disabled, and these files
111 
are counted (and displayed) as many times as they are found.
112 
.It Fl m
113 
Display block count in 1048576-byte (1-Mbyte) blocks.
114 
.It Fl n
115 
Ignore files and directories with user
116 
.Dq nodump
117 
flag
118 
.Pq Dv UF_NODUMP
119 
set.
96 
.It Fl r
 120 
.It Fl r
97 
Generate messages about directories that cannot be read, files
 121 
Generate messages about directories that cannot be read, files
98 
that cannot be opened, and so on.
 122 
that cannot be opened, and so on.
Lines 111-141 If Link Here
111 
is negative, display only entries for which size is less than the absolute
 135 
is negative, display only entries for which size is less than the absolute
112 
value of
 136 
value of
113 
.Ar threshold .
 137 
.Ar threshold .
114 
.It Fl d Ar depth
115 
Display an entry for all files and directories
116 
.Ar depth
117 
directories deep.
118 
.It Fl c
119 
Display a grand total.
120 
.It Fl k
121 
Display block counts in 1024-byte (1-Kbyte) blocks.
122 
.It Fl l
123 
If a file has multiple hard links, count its size many times.
124 
The default behavior of
125 
.Nm
126 
is to count files with multiple hard links only once.
127 
When the
128 
.Fl l
129 
option is specified, the hard link checks are disabled, and these files
130 
are counted (and displayed) as many times as they are found.
131 
.It Fl m
132 
Display block counts in 1048576-byte (1-Mbyte) blocks.
133 
.It Fl n
134 
Ignore files and directories with user
135 
.Dq nodump
136 
flag
137 
.Pq Dv UF_NODUMP
138 
set.
139 
.It Fl x
 138 
.It Fl x
140 
File system mount points are not traversed.
 139 
File system mount points are not traversed.
141 
.El
 140 
.El
Lines 152-177 If either the Link Here
152 
.Fl H
 151 
.Fl H
153 
or
 152 
or
154 
.Fl L
 153 
.Fl L
155 
options are specified, storage used by any symbolic links which are
 154 
option is specified, storage used by any symbolic links which are
156 
followed is not counted or displayed.
 155 
followed is not counted (or displayed).
156 
.Pp
157 
The
158 
.Fl h, k
159 
and
160 
.Fl m
161 
options all override each other; the last one specified determines
162 
the block count used.
157 
.Sh ENVIRONMENT
 163 
.Sh ENVIRONMENT
158 
.Bl -tag -width BLOCKSIZE
 164 
.Bl -tag -width BLOCKSIZE
159 
.It Ev BLOCKSIZE
 165 
.It Ev BLOCKSIZE
160 
If the environment variable
 166 
If the environment variable
161 
.Ev BLOCKSIZE
 167 
.Ev BLOCKSIZE
162 
is set, and the
 168 
is set, and the
163 
.Fl k, m
 169 
.Fl h, k
164 
or
 170 
or
165 
.Fl h
 171 
.Fl m
166 
options are not specified, the block counts will be displayed in units of
 172 
options are not specified, the block count will be displayed in units of
167 
that block size.
 173 
that block size.
168 
If
 174 
If
169 
.Ev BLOCKSIZE
 175 
.Ev BLOCKSIZE
170 
is not set, and the
 176 
is not set, and the
171 
.Fl k, m
 177 
.Fl h, k
172 
or
 178 
or
173 
.Fl h
 179 
.Fl m
174 
options are not specified, the block counts will be displayed in 512-byte
 180 
options are not specified, the block count will be displayed in 512-byte
175 
blocks.
 181 
blocks.
176 
.El
 182 
.El
177 
.Sh SEE ALSO
 183 
.Sh SEE ALSO

Return to bug 162438