xref: /original-bsd/usr.bin/du/du.1 (revision 92ab646d)
1.\" Copyright (c) 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)du.1	6.6 (Berkeley) 06/30/90
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
19.Nm Du
20utility displays the block usage of files in the current directory
21or for the entire tree of a given pathname.
22.Pp
23The options are as follows:
24.Tp Fl a
25Generate an entry for each file.
26.Tp Fl k
27By default,
28.Nm du
29displays the number of blocks as returned by the
30.Xr stat  2
31system call, i.e. 512-byte blocks.
32If the
33.Fl k
34flag is specified, the number displayed is the number of 1024-byte
35blocks with partial blocks rounded up.
36.Tp Fl s
37Generate only the grand total.
38If neither
39.Fl a
40or
41.Fl s
42are specified, an entry is generated for each directory only.
43.Tp Fl x
44Don't traverse any mount points.
45.Tp
46.Pp
47Files having multiple hard links are counted
48(and displayed) a single time per
49.Nm du
50execution.
51.Sh SEE ALSO
52.Xr df 1 ,
53.Xr quot 8
54.Sh HISTORY
55A
56.Nm du
57command appeared in Version 6 AT&T Unix.
58