xref: /original-bsd/usr.bin/du/du.1 (revision 2d1a7683)
1.\" Copyright (c) 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)du.1	6.9 (Berkeley) 04/24/91
7.\"
8.Dd
9.Dt DU 1
10.Os BSD 4.4
11.Sh NAME
12.Nm du
13.Nd display disk usage statistics
14.Sh SYNOPSIS
15.Nm du
16.Op Fl aksx
17.Op Ar pathname ...
18.Sh DESCRIPTION
19The
20.Nm du
21utility displays the file system block usage for each file argument
22or for each directory in the file hierarchy rooted in each directory
23argument.
24By default, the block usage of the hierarchy rooted in the current
25directory is displayed.
26.Pp
27The options are as follows:
28.Bl -tag -width Ds
29.It Fl a
30Generate an entry for each file.
31.It Fl k
32By default,
33.Nm du
34displays the number of blocks as returned by the
35.Xr stat  2
36system call, i.e. 512-byte blocks.
37If the
38.Fl k
39flag is specified, the number displayed is the number of 1024-byte
40blocks with partial blocks rounded up.
41.It Fl s
42Generate only the grand total.
43.It Fl x
44Don't traverse any mount points.
45.El
46.Pp
47Files having multiple hard links are counted (and displayed) a single
48time per
49.Nm du
50execution.
51.Sh SEE ALSO
52.Xr df 1 ,
53.Xr quot 8
54.Sh HISTORY
55A
56.Nm
57command appeared in
58.At v6 .
59