xref: /original-bsd/usr.bin/du/du.1 (revision 6ab384a1)
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.7 (Berkeley) 07/24/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.Tw Ds
25.Tp Fl a
26Generate an entry for each file.
27.Tp Fl k
28By default,
29.Nm du
30displays the number of blocks as returned by the
31.Xr stat  2
32system call, i.e. 512-byte blocks.
33If the
34.Fl k
35flag is specified, the number displayed is the number of 1024-byte
36blocks with partial blocks rounded up.
37.Tp Fl s
38Generate only the grand total.
39If neither
40.Fl a
41or
42.Fl s
43are specified, an entry is generated for each directory only.
44.Tp Fl x
45Don't traverse any mount points.
46.Tp
47.Pp
48Files having multiple hard links are counted
49(and displayed) a single time per
50.Nm du
51execution.
52.Sh SEE ALSO
53.Xr df 1 ,
54.Xr quot 8
55.Sh HISTORY
56A
57.Nm du
58command appeared in Version 6 AT&T Unix.
59